Debian Codegraph @

texmf-dist/doc/texlive/texlive-en/texlive-en.html

raw
1 <!DOCTYPE html>
2 <html lang="en-US" xml:lang="en-US" >
3 <head>
4 <title>The TeX Live Guide—2026 </title>
5 <meta charset="utf-8" />
6 <meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)" />
7 <meta name="viewport" content="width=device-width,initial-scale=1" />
8 <link rel="stylesheet" type="text/css" href="texlive-en.css" />
9 <meta name="src" content="texlive-en.tex" />
10 <link rel="stylesheet" type="text/css" href="texlive-en.css" >
11 <link rel="stylesheet" type="text/css" href="tex-live.css" >
12 </head><body
13 >
14 <div class="maketitle">
15
16
17
18
19
20 <h1 class="titleHead">The TeX Live Guide—2026 </h1>
21 <div class="author" ><span
22 class="ec-lmr-12x-x-120">Karl Berry, editor</span>
23 <br /> <a
24 href="https://tug.org/texlive/" class="url" ><span
25 class="ec-lmtt-12x-x-120">https://tug.org/texlive/</span></a> </div><br />
26 <div class="date" ><span
27 class="ec-lmr-12x-x-120">21 February 2026</span></div>
28 </div>
29
30 <h3 class="likesectionHead"><a
31 id="x1-1000"></a>Contents</h3>
32 <div class="tableofcontents">
33 <span class="sectionToc" >1 <a
34 href="#x1-20001" id="QQ2-1-2">Introduction</a></span>
35 <br /> <span class="subsectionToc" >1.1 <a
36 href="#x1-30001.1" id="QQ2-1-3">TeX Live</a></span>
37 <br /> <span class="subsectionToc" >1.2 <a
38 href="#x1-40001.2" id="QQ2-1-4">Operating system support</a></span>
39 <br /> <span class="subsectionToc" >1.3 <a
40 href="#x1-50001.3" id="QQ2-1-5">Basic installation of TeX Live</a></span>
41 <br /> <span class="subsectionToc" >1.4 <a
42 href="#x1-60001.4" id="QQ2-1-6">Security considerations</a></span>
43 <br /> <span class="subsectionToc" >1.5 <a
44 href="#x1-70001.5" id="QQ2-1-7">Getting help</a></span>
45 <br /> <span class="sectionToc" >2 <a
46 href="#x1-80002" id="QQ2-1-8">Overview of TeX Live</a></span>
47 <br /> <span class="subsectionToc" >2.1 <a
48 href="#x1-90002.1" id="QQ2-1-9">Top level TeX Live directories</a></span>
49 <br /> <span class="subsectionToc" >2.2 <a
50 href="#x1-100002.2" id="QQ2-1-10">The predefined texmf trees</a></span>
51 <br /> <span class="subsectionToc" >2.3 <a
52 href="#x1-110002.3" id="QQ2-1-11">Extensions to TeX</a></span>
53 <br /> <span class="subsectionToc" >2.4 <a
54 href="#x1-120002.4" id="QQ2-1-12">Other notable programs in TeX Live</a></span>
55 <br /> <span class="sectionToc" >3 <a
56 href="#x1-130003" id="QQ2-1-13">Installation</a></span>
57 <br /> <span class="subsectionToc" >3.1 <a
58 href="#x1-140003.1" id="QQ2-1-14">Starting the installer</a></span>
59 <br /> <span class="subsubsectionToc" >3.1.1 <a
60 href="#x1-150003.1.1" id="QQ2-1-16">Unix</a></span>
61 <br /> <span class="subsubsectionToc" >3.1.2 <a
62 href="#x1-160003.1.2" id="QQ2-1-17">macOS</a></span>
63 <br /> <span class="subsubsectionToc" >3.1.3 <a
64 href="#x1-170003.1.3" id="QQ2-1-18">Windows</a></span>
65 <br /> <span class="subsubsectionToc" >3.1.4 <a
66 href="#x1-180003.1.4" id="QQ2-1-22">Cygwin</a></span>
67 <br /> <span class="subsubsectionToc" >3.1.5 <a
68 href="#x1-190003.1.5" id="QQ2-1-23">The text installer</a></span>
69 <br /> <span class="subsubsectionToc" >3.1.6 <a
70 href="#x1-200003.1.6" id="QQ2-1-24">The graphical installer</a></span>
71 <br /> <span class="subsectionToc" >3.2 <a
72 href="#x1-210003.2" id="QQ2-1-25">Running the installer</a></span>
73 <br /> <span class="subsubsectionToc" >3.2.1 <a
74 href="#x1-220003.2.1" id="QQ2-1-26">Binary systems menu (Unix only)</a></span>
75 <br /> <span class="subsubsectionToc" >3.2.2 <a
76 href="#x1-230003.2.2" id="QQ2-1-28">Selecting what is to be installed</a></span>
77 <br /> <span class="subsubsectionToc" >3.2.3 <a
78 href="#x1-240003.2.3" id="QQ2-1-31">Directories</a></span>
79 <br /> <span class="subsubsectionToc" >3.2.4 <a
80 href="#x1-250003.2.4" id="QQ2-1-32">Options</a></span>
81 <br /> <span class="subsectionToc" >3.3 <a
82 href="#x1-260003.3" id="QQ2-1-34">Command-line install-tl options</a></span>
83 <br /> <span class="subsubsectionToc" >3.3.1 <a
84 href="#x1-270003.3.1" id="QQ2-1-35">The <span
85 class="ec-lmtt-12">-repository </span>option</a></span>
86 <br /> <span class="subsectionToc" >3.4 <a
87 href="#x1-280003.4" id="QQ2-1-36">Post-install actions</a></span>
88
89
90 <br /> <span class="subsubsectionToc" >3.4.1 <a
91 href="#x1-290003.4.1" id="QQ2-1-37">Environment variables for Unix</a></span>
92 <br /> <span class="subsubsectionToc" >3.4.2 <a
93 href="#x1-300003.4.2" id="QQ2-1-38">Environment variables: Global configuration</a></span>
94 <br /> <span class="subsubsectionToc" >3.4.3 <a
95 href="#x1-310003.4.3" id="QQ2-1-39">Internet updates after DVD or ISO installation</a></span>
96 <br /> <span class="subsubsectionToc" >3.4.4 <a
97 href="#x1-320003.4.4" id="QQ2-1-40">System font configuration for XeTeX and LuaTeX</a></span>
98 <br /> <span class="subsubsectionToc" >3.4.5 <a
99 href="#x1-330003.4.5" id="QQ2-1-41">ConTeXt LMTX and MKIV</a></span>
100 <br /> <span class="subsubsectionToc" >3.4.6 <a
101 href="#x1-340003.4.6" id="QQ2-1-42">Integrating local and personal macros</a></span>
102 <br /> <span class="subsubsectionToc" >3.4.7 <a
103 href="#x1-350003.4.7" id="QQ2-1-43">Integrating third-party fonts</a></span>
104 <br /> <span class="subsectionToc" >3.5 <a
105 href="#x1-360003.5" id="QQ2-1-44">Testing the installation</a></span>
106 <br /> <span class="subsectionToc" >3.6 <a
107 href="#x1-370003.6" id="QQ2-1-45">Uninstalling TeX Live</a></span>
108 <br /> <span class="subsectionToc" >3.7 <a
109 href="#x1-380003.7" id="QQ2-1-46">Links for additional downloadable software</a></span>
110 <br /> <span class="sectionToc" >4 <a
111 href="#x1-390004" id="QQ2-1-47">Specialized installations</a></span>
112 <br /> <span class="subsectionToc" >4.1 <a
113 href="#x1-400004.1" id="QQ2-1-48">Shared-user (or cross-machine) installations</a></span>
114 <br /> <span class="subsectionToc" >4.2 <a
115 href="#x1-410004.2" id="QQ2-1-49">Portable (USB) installations</a></span>
116 <br /> <span class="sectionToc" >5 <a
117 href="#x1-420005" id="QQ2-1-50"><span
118 class="ec-lmss-12">tlmgr</span>: Managing your installation</a></span>
119 <br /> <span class="subsectionToc" >5.1 <a
120 href="#x1-430005.1" id="QQ2-1-54">GUI interfaces for <span
121 class="ec-lmss-12">tlmgr</span></a></span>
122 <br /> <span class="subsectionToc" >5.2 <a
123 href="#x1-440005.2" id="QQ2-1-55">Sample <span
124 class="ec-lmss-12">tlmgr </span>command-line invocations</a></span>
125 <br /> <span class="sectionToc" >6 <a
126 href="#x1-450006" id="QQ2-1-56">Notes on Windows</a></span>
127 <br /> <span class="subsectionToc" >6.1 <a
128 href="#x1-460006.1" id="QQ2-1-57">Windows-specific features</a></span>
129 <br /> <span class="subsectionToc" >6.2 <a
130 href="#x1-470006.2" id="QQ2-1-58">Additional software included on Windows</a></span>
131 <br /> <span class="subsectionToc" >6.3 <a
132 href="#x1-480006.3" id="QQ2-1-59">Using external Perl, Tcl/Tk and Ghostscript installations</a></span>
133 <br /> <span class="subsectionToc" >6.4 <a
134 href="#x1-490006.4" id="QQ2-1-60">User Profile is Home</a></span>
135 <br /> <span class="subsectionToc" >6.5 <a
136 href="#x1-500006.5" id="QQ2-1-61">The Windows registry</a></span>
137 <br /> <span class="subsectionToc" >6.6 <a
138 href="#x1-510006.6" id="QQ2-1-62">Windows permissions</a></span>
139 <br /> <span class="subsectionToc" >6.7 <a
140 href="#x1-520006.7" id="QQ2-1-63">Increasing maximum memory on Windows and Cygwin</a></span>
141 <br /> <span class="sectionToc" >7 <a
142 href="#x1-530007" id="QQ2-1-64">A user’s guide to Web2C</a></span>
143 <br /> <span class="subsectionToc" >7.1 <a
144 href="#x1-540007.1" id="QQ2-1-65">Kpathsea path searching</a></span>
145 <br /> <span class="subsubsectionToc" >7.1.1 <a
146 href="#x1-550007.1.1" id="QQ2-1-66">Path sources</a></span>
147 <br /> <span class="subsubsectionToc" >7.1.2 <a
148 href="#x1-560007.1.2" id="QQ2-1-67">Config files</a></span>
149 <br /> <span class="subsubsectionToc" >7.1.3 <a
150 href="#x1-570007.1.3" id="QQ2-1-68">Path expansion</a></span>
151 <br /> <span class="subsubsectionToc" >7.1.4 <a
152 href="#x1-580007.1.4" id="QQ2-1-69">Default expansion</a></span>
153 <br /> <span class="subsubsectionToc" >7.1.5 <a
154 href="#x1-590007.1.5" id="QQ2-1-70">Brace expansion</a></span>
155 <br /> <span class="subsubsectionToc" >7.1.6 <a
156 href="#x1-600007.1.6" id="QQ2-1-71">Subdirectory expansion</a></span>
157 <br /> <span class="subsubsectionToc" >7.1.7 <a
158 href="#x1-610007.1.7" id="QQ2-1-72">Summary of special characters in <span
159 class="ec-lmtt-12">texmf.cnf </span>files</a></span>
160 <br /> <span class="subsectionToc" >7.2 <a
161 href="#x1-620007.2" id="QQ2-1-73">Filename databases</a></span>
162 <br /> <span class="subsubsectionToc" >7.2.1 <a
163 href="#x1-630007.2.1" id="QQ2-1-74">The filename database</a></span>
164 <br /> <span class="subsubsectionToc" >7.2.2 <a
165 href="#x1-640007.2.2" id="QQ2-1-75">kpsewhich: Standalone path searching</a></span>
166 <br /> <span class="subsubsectionToc" >7.2.3 <a
167 href="#x1-650007.2.3" id="QQ2-1-76">Examples of use</a></span>
168 <br /> <span class="subsubsectionToc" >7.2.4 <a
169 href="#x1-660007.2.4" id="QQ2-1-77">Debugging actions</a></span>
170 <br /> <span class="subsectionToc" >7.3 <a
171 href="#x1-670007.3" id="QQ2-1-79">Runtime options</a></span>
172 <br /> <span class="subsectionToc" >7.4 <a
173 href="#x1-680007.4" id="QQ2-1-80"><span
174 class="ec-lmtt-12">$TEXMFDOTDIR</span></a></span>
175 <br /> <span class="sectionToc" >8 <a
176 href="#x1-690008" id="QQ2-1-81">Acknowledgements</a></span>
177 <br /> <span class="sectionToc" >9 <a
178 href="#x1-700009" id="QQ2-1-82">Release history</a></span>
179 <br /> <span class="subsectionToc" >9.1 <a
180 href="#x1-710009.1" id="QQ2-1-83">Past</a></span>
181 <br /> <span class="subsubsectionToc" >9.1.1 <a
182 href="#x1-720009.1.1" id="QQ2-1-84">2003</a></span>
183 <br /> <span class="subsubsectionToc" >9.1.2 <a
184 href="#x1-730009.1.2" id="QQ2-1-85">2004</a></span>
185 <br /> <span class="subsubsectionToc" >9.1.3 <a
186 href="#x1-740009.1.3" id="QQ2-1-86">2005</a></span>
187 <br /> <span class="subsubsectionToc" >9.1.4 <a
188 href="#x1-750009.1.4" id="QQ2-1-87">2006–2007</a></span>
189
190
191 <br /> <span class="subsubsectionToc" >9.1.5 <a
192 href="#x1-760009.1.5" id="QQ2-1-88">2008</a></span>
193 <br /> <span class="subsubsectionToc" >9.1.6 <a
194 href="#x1-770009.1.6" id="QQ2-1-89">2009</a></span>
195 <br /> <span class="subsubsectionToc" >9.1.7 <a
196 href="#x1-780009.1.7" id="QQ2-1-90">2010</a></span>
197 <br /> <span class="subsubsectionToc" >9.1.8 <a
198 href="#x1-790009.1.8" id="QQ2-1-91">2011</a></span>
199 <br /> <span class="subsubsectionToc" >9.1.9 <a
200 href="#x1-800009.1.9" id="QQ2-1-92">2012</a></span>
201 <br /> <span class="subsubsectionToc" >9.1.10 <a
202 href="#x1-810009.1.10" id="QQ2-1-93">2013</a></span>
203 <br /> <span class="subsubsectionToc" >9.1.11 <a
204 href="#x1-820009.1.11" id="QQ2-1-94">2014</a></span>
205 <br /> <span class="subsubsectionToc" >9.1.12 <a
206 href="#x1-830009.1.12" id="QQ2-1-95">2015</a></span>
207 <br /> <span class="subsubsectionToc" >9.1.13 <a
208 href="#x1-840009.1.13" id="QQ2-1-96">2016</a></span>
209 <br /> <span class="subsubsectionToc" >9.1.14 <a
210 href="#x1-850009.1.14" id="QQ2-1-97">2017</a></span>
211 <br /> <span class="subsubsectionToc" >9.1.15 <a
212 href="#x1-860009.1.15" id="QQ2-1-98">2018</a></span>
213 <br /> <span class="subsubsectionToc" >9.1.16 <a
214 href="#x1-870009.1.16" id="QQ2-1-99">2019</a></span>
215 <br /> <span class="subsubsectionToc" >9.1.17 <a
216 href="#x1-880009.1.17" id="QQ2-1-100">2020</a></span>
217 <br /> <span class="subsubsectionToc" >9.1.18 <a
218 href="#x1-890009.1.18" id="QQ2-1-101">2021</a></span>
219 <br /> <span class="subsubsectionToc" >9.1.19 <a
220 href="#x1-900009.1.19" id="QQ2-1-102">2022</a></span>
221 <br /> <span class="subsubsectionToc" >9.1.20 <a
222 href="#x1-910009.1.20" id="QQ2-1-103">2023</a></span>
223 <br /> <span class="subsubsectionToc" >9.1.21 <a
224 href="#x1-920009.1.21" id="QQ2-1-104">2024</a></span>
225 <br /> <span class="subsubsectionToc" >9.1.22 <a
226 href="#x1-930009.1.22" id="QQ2-1-105">2025</a></span>
227 <br /> <span class="subsectionToc" >9.2 <a
228 href="#x1-940009.2" id="QQ2-1-106">Present: 2026</a></span>
229 <br /> <span class="subsectionToc" >9.3 <a
230 href="#x1-950009.3" id="QQ2-1-107">Future</a></span>
231 </div>
232
233 <h3 class="sectionHead"><span class="titlemark">1 </span> <a
234 id="x1-20001"></a>Introduction</h3>
235
236 <h4 class="subsectionHead"><span class="titlemark">1.1 </span> <a
237 id="x1-30001.1"></a>TeX Live</h4>
238 <!--l. 37--><p class="noindent" >This document describes the main features of the TeX Live software distribution — TeX and
239 related programs for GNU/Linux and other Unix flavors, macOS, and Windows systems.
240 You may have acquired TeX Live by downloading, or on a DVD, or in some other
241 way.
242 </p><!--l. 42--><p class="indent" > TeX Live includes executables for TeX, LaTeX2e, ConTeXt, Metafont, MetaPost,
243 BibTeX and many other programs; an extensive collection of macros, fonts and
244 documentation; and support for typesetting in many different scripts from around the
245 world.
246 </p><!--l. 47--><p class="indent" > For a brief summary of the major changes in this edition of TeX Live, see the end of the
247 document, section <a
248 href="#x1-700009">9<!--tex4ht:ref: sec:history --></a> (p. <a
249 href="#x1-700009">96<!--tex4ht:ref: sec:history --></a>).
250 </p><!--l. 52--><p class="indent" > <a id="platforms"></a>
251 </p>
252
253
254 <h4 class="subsectionHead"><span class="titlemark">1.2 </span> <a
255 id="x1-40001.2"></a>Operating system support</h4>
256 <!--l. 56--><p class="noindent" >TeX Live contains binaries for many Unix-based platforms, including GNU/Linux, macOS,
257 and Cygwin. The included sources can be compiled on platforms for which we do not provide
258 binaries.
259 </p><!--l. 60--><p class="indent" > As to Windows: Windows 10 and later are supported. Windows 7 and Vista <span
260 class="ec-lmri-12">may </span>still
261 mostly work, but TeX Live will no longer even install on Windows XP or earlier. TeX Live
262 includes 64-bit executables for Windows.
263
264 </p>
265 <h4 class="subsectionHead"><span class="titlemark">1.3 </span> <a
266 id="x1-50001.3"></a>Basic installation of TeX Live</h4>
267 <!--l. 69--><p class="noindent" >You can install TeX Live either from DVD (or an ISO image) or over the Internet (
268 <a
269 href="https://tug.org/texlive/acquire.html" class="url" ><span
270 class="ec-lmtt-12">https://tug.org/texlive/acquire.html</span></a>). The net installer itself is small, and downloads
271 everything requested from the Internet.
272 </p><!--l. 73--><p class="indent" > You can prepare a runnable installation on, e.g., a USB stick (see section <a
273 href="#x1-410004.2">4.2<!--tex4ht:ref: sec:portable-tl --></a>). Installation
274 is described in detail in later sections (p. <a
275 href="#x1-130003">14<!--tex4ht:ref: sec:install --></a>), but here is a quick start:
276 </p>
277 <ul class="itemize1">
278 <li class="itemize">
279 <!--l. 79--><p class="noindent" >For Unix, the installation script is <span
280 class="ec-lmtt-12">install-tl</span>; on Windows, one should instead
281 invoke <span
282 class="ec-lmtt-12">install-tl-windows</span>. The installer will operate in a graphical mode given
283 the option <span
284 class="ec-lmtt-12">-gui </span>(default for Windows), or a text mode given the option <span
285 class="ec-lmtt-12">-gui=text</span>
286 (default for everything else).
287 </p></li>
288 <li class="itemize">
289 <!--l. 85--><p class="noindent" >One of the installed items is the ‘TeX Live Manager’ program, named <span
290 class="ec-lmss-12">tlmgr</span>. Like
291 the installer, it can be used in both GUI mode and in text mode. You can use it
292 to install and uninstall packages and do various configuration tasks.
293 </p>
294 </li></ul>
295 <!--l. 93--><p class="indent" > <a id="security"></a>
296 </p>
297 <h4 class="subsectionHead"><span class="titlemark">1.4 </span> <a
298 id="x1-60001.4"></a>Security considerations</h4>
299 <!--l. 97--><p class="noindent" >To the best of our knowledge, the core TeX programs themselves are (and always have been)
300 extremely robust. However, the contributed programs in TeX Live may not reach the
301 same level, despite everyone’s best efforts. As always, you should be careful when
302 running programs on untrusted input; to improve safety, use a new subdirectory or
303 chroot.
304 </p><!--l. 103--><p class="indent" > This need for care is especially urgent on Windows, since in general Windows finds
305 programs in the current directory before anything else, regardless of the search path. This
306 opens up a wide variety of possible attacks. We have closed many holes, but undoubtedly some
307 remain, especially with third-party programs. Thus, we recommend checking for suspicious
308
309
310 files in the current directory, especially executables (binaries or scripts). Ordinarily they should
311 not be present, and definitely should not normally be created by merely processing a
312 document.
313 </p><!--l. 112--><p class="indent" > Finally, TeX (and its companion programs) are able to write files when processing
314 documents, a feature that can also be abused in a wide variety of ways. Again, processing
315 unknown documents in a new subdirectory is the safest bet.
316 </p><!--l. 117--><p class="indent" > Another aspect of security is ensuring that downloaded material has not been changed from
317 what was created. The <span
318 class="ec-lmss-12">tlmgr </span>program (section <a
319 href="#x1-420005">5<!--tex4ht:ref: sec:tlmgr --></a>) will automatically perform cryptographic
320 verification on downloads if the <span
321 class="ec-lmss-12">gpg </span>(GNU Privacy Guard) program is available. It is not
322 distributed as part of TeX Live, but see <a
323 href="https://texlive.info/tlgpg/" class="url" ><span
324 class="ec-lmtt-12">https://texlive.info/tlgpg/</span></a> for information
325 about <span
326 class="ec-lmss-12">gpg </span>if need be.
327
328 </p>
329 <h4 class="subsectionHead"><span class="titlemark">1.5 </span> <a
330 id="x1-70001.5"></a>Getting help</h4>
331 <!--l. 128--><p class="noindent" >The TeX community is active and friendly, and most serious questions end up getting
332 answered. However, the support is informal, done by volunteers and casual users, so it’s
333 especially important that you do your homework before asking. (If you prefer guaranteed
334 commercial support, you can forgo TeX Live completely and purchase a vendor’s system;
335 <a
336 href="https://tug.org/interest.html#vendors" class="url" ><span
337 class="ec-lmtt-12">https://tug.org/interest.html#vendors</span></a> has a list.)
338 </p><!--l. 135--><p class="indent" > Here is a list of resources, approximately in the order we recommend using them:
339 </p><!--l. 138--><p class="indent" >
340 </p><dl class="description"><dt class="description"><a
341 id="x1-7001x1.5"></a>
342 <span
343 class="ec-lmbx-12">Getting started</span> </dt><dd
344 class="description">
345 <!--l. 139--><p class="noindent" >If you are new to TeX, the web page <a
346 href="https://tug.org/begin.html" class="url" ><span
347 class="ec-lmtt-12">https://tug.org/begin.html</span></a> gives a
348 brief introduction to the system.
349 </p></dd><dt class="description"><a
350 id="x1-7002x1.5"></a>
351 <span
352 class="ec-lmbx-12">CTAN</span> </dt><dd
353 class="description">
354 <!--l. 142--><p class="noindent" >If you are looking for a particular package, font, program, etc., CTAN is the
355 place to start looking. It is a huge collection of all TeX-related items. The catalog
356 entries also tell you whether a package is available for TeX Live or MiKTeX. See
357 <a
358 href="https://ctan.org" class="url" ><span
359 class="ec-lmtt-12">https://ctan.org</span></a>.
360 </p></dd><dt class="description"><a
361 id="x1-7003x1.5"></a>
362 <span
363 class="ec-lmbx-12">TeX FAQ</span> </dt><dd
364 class="description">
365 <!--l. 147--><p class="noindent" >The TeX FAQ is a compendium of answers to all sorts of questions, from
366 the most basic to the most arcane. It is available on the Internet through
367 <a
368 href="https://texfaq.org" class="url" ><span
369 class="ec-lmtt-12">https://texfaq.org</span></a>.
370 </p></dd><dt class="description"><a
371 id="x1-7004x1.5"></a>
372 <span
373 class="ec-lmbx-12">TeX Web Resources</span> </dt><dd
374 class="description">
375 <!--l. 151--><p class="noindent" >The web page <a
376 href="https://tug.org/interest.html" class="url" ><span
377 class="ec-lmtt-12">https://tug.org/interest.html</span></a> has many TeX-related links, in
378 particular for numerous books, manuals, and articles on all aspects of the system.
379 </p></dd><dt class="description"><a
380 id="x1-7005x1.5"></a>
381 <span
382 class="ec-lmbx-12">support sites</span> </dt><dd
383 class="description">
384 <!--l. 156--><p class="noindent" >A general web search
385 never hurts. Principal support sites for TeX include the LaTeX community site at
386
387
388 <a
389 href="https://latex.org" class="url" ><span
390 class="ec-lmtt-12">https://latex.org</span></a>, the q&#x0026;a site <a
391 href="https://tex.stackexchange.com" class="url" ><span
392 class="ec-lmtt-12">https://tex.stackexchange.com</span></a>, and
393 the mailing list <a
394 href="https://lists.tug.org/texhax" class="url" ><span
395 class="ec-lmtt-12">https://lists.tug.org/texhax</span></a>. Their archives have years of
396 past questions and answers for your searching pleasure.
397 </p></dd><dt class="description"><a
398 id="x1-7006x1.5"></a>
399 <span
400 class="ec-lmbx-12">asking questions</span> </dt><dd
401 class="description">
402 <!--l. 163--><p class="noindent" >If you cannot find an answer, you can post to <a
403 href="http://latex.org/" class="url" ><span
404 class="ec-lmtt-12">http://latex.org/</span></a> and
405 <a
406 href="https://tex.stackexchange.com/" class="url" ><span
407 class="ec-lmtt-12">https://tex.stackexchange.com/</span></a> through their web interfaces, to <a
408 href="mailto:[email protected]" ><span class="path"><span
409 class="ec-lmtt-12">texhax@</span>
410 <span
411 class="ec-lmtt-12">tug.org</span></span></a> through email (it’s not necessary to subscribe in order to post). But before
412 you post anywhere, please read this FAQ entry, to maximize your chances of getting
413 a useful answer: <a
414 href="https://texfaq.org/FAQ-askquestion" class="url" ><span
415 class="ec-lmtt-12">https://texfaq.org/FAQ-askquestion</span></a>.
416 </p></dd><dt class="description"><a
417 id="x1-7007x1.5"></a>
418 <span
419 class="ec-lmbx-12">TeX Live support</span> </dt><dd
420 class="description">
421 <!--l. 170--><p class="noindent" >If you want to report a bug or have suggestions or comments on the TeX Live
422 distribution, installation, or documentation, the mailing list is <a
423 href="mailto:[email protected]" ><span class="path"><span
424 class="ec-lmtt-12">tex-live@tug.</span>
425 <span
426 class="ec-lmtt-12">org</span></span></a>. However, if your question is about how to use a particular program included in
427 TeX Live, please write to that program’s maintainer or mailing list. Often running
428 a program with the <span
429 class="ec-lmtt-12">--help </span>option will provide a bug reporting address.
430 </p>
431 </dd></dl>
432 <!--l. 180--><p class="indent" > The other side of the coin is helping others who have questions. All the above
433 resources are open to anyone, so feel free to join, start reading, and help out where you
434 can.
435
436 </p>
437 <h3 class="sectionHead"><span class="titlemark">2 </span> <a
438 id="x1-80002"></a>Overview of TeX Live</h3>
439
440 <h4 class="subsectionHead"><span class="titlemark">2.1 </span> <a
441 id="x1-90002.1"></a>Top level TeX Live directories</h4>
442 <!--l. 193--><p class="noindent" >Here is a brief listing and description of the top level directories in a TeX Live installation.
443 </p><!--l. 196--><p class="noindent" >
444 </p><dl class="list1"><dt class="list">
445 <span
446 class="ec-lmtt-12">bin</span> </dt><dd
447 class="list">
448 <!--l. 197--><p class="noindent" >The TeX system programs, arranged by platform.
449 </p></dd><dt class="list">
450 <span
451 class="ec-lmtt-12">readme-*.dir</span> </dt><dd
452 class="list">
453 <!--l. 199--><p class="noindent" >Quick overview and useful links for TeX Live, in various languages, in both HTML
454 and plain text.
455 </p></dd><dt class="list">
456 <span
457 class="ec-lmtt-12">source</span> </dt><dd
458 class="list">
459 <!--l. 202--><p class="noindent" >The source to all included programs, including the main Web2C-based TeX
460 distributions.
461
462
463 </p></dd><dt class="list">
464 <span
465 class="ec-lmtt-12">texmf-dist</span> </dt><dd
466 class="list">
467 <!--l. 205--><p class="noindent" >The principal tree; see <span
468 class="ec-lmtt-12">TEXMFDIST </span>below.
469 </p></dd><dt class="list">
470 <span
471 class="ec-lmtt-12">tlpkg</span> </dt><dd
472 class="list">
473 <!--l. 207--><p class="noindent" >Scripts, programs and data for managing the installation, and special support for
474 Windows.</p></dd></dl>
475 <!--l. 211--><p class="indent" > For documentation, the comprehensive links in the top-level file <a
476 href="../../../../doc.html" >doc.html</a> may be helpful.
477 The documentation for nearly everything (packages, formats, fonts, program manuals, man
478 pages, Info files) is in <span
479 class="ec-lmtt-12">texmf-dist/doc</span>. You can use the <span
480 class="ec-lmss-12">texdoc </span>program to find documentation
481 wherever it is located.
482 </p><!--l. 217--><p class="indent" > This TeX Live documentation itself is in <span
483 class="ec-lmtt-12">texmf-dist/doc/texlive</span>, available in several
484 languages:
485 </p>
486 <ul class="itemize1">
487 <li class="itemize">
488 <!--l. 221--><p class="noindent" >Czech/Slovak: <a
489 href="../../../../texmf-dist/doc/texlive/texlive-cz" >texmf-dist/doc/texlive/texlive-cz</a>
490 </p></li>
491 <li class="itemize">
492 <!--l. 222--><p class="noindent" >German: <a
493 href="../../../../texmf-dist/doc/texlive/texlive-de" >texmf-dist/doc/texlive/texlive-de</a>
494 </p></li>
495 <li class="itemize">
496 <!--l. 223--><p class="noindent" >English: <a
497 href="../../../../texmf-dist/doc/texlive/texlive-en" >texmf-dist/doc/texlive/texlive-en</a>
498 </p></li>
499 <li class="itemize">
500 <!--l. 224--><p class="noindent" >French: <a
501 href="../../../../texmf-dist/doc/texlive/texlive-fr" >texmf-dist/doc/texlive/texlive-fr</a>
502 </p></li>
503 <li class="itemize">
504 <!--l. 225--><p class="noindent" >Italian: <a
505 href="../../../../texmf-dist/doc/texlive/texlive-it" >texmf-dist/doc/texlive/texlive-it</a>
506 </p></li>
507 <li class="itemize">
508 <!--l. 226--><p class="noindent" >Japanese: <a
509 href="../../../../texmf-dist/doc/texlive/texlive-ja" >texmf-dist/doc/texlive/texlive-ja</a>
510 </p></li>
511 <li class="itemize">
512 <!--l. 227--><p class="noindent" >Polish: <a
513 href="../../../../texmf-dist/doc/texlive/texlive-pl" >texmf-dist/doc/texlive/texlive-pl</a>
514 </p></li>
515 <li class="itemize">
516 <!--l. 228--><p class="noindent" >Russian: <a
517 href="../../../../texmf-dist/doc/texlive/texlive-ru" >texmf-dist/doc/texlive/texlive-ru</a>
518 </p></li>
519 <li class="itemize">
520 <!--l. 229--><p class="noindent" >Serbian: <a
521 href="../../../../texmf-dist/doc/texlive/texlive-sr" >texmf-dist/doc/texlive/texlive-sr</a>
522 </p></li>
523 <li class="itemize">
524 <!--l. 230--><p class="noindent" >Spanish: <a
525 href="../../../../texmf-dist/doc/texlive/texlive-es" >texmf-dist/doc/texlive/texlive-es</a>
526 </p></li>
527
528
529 <li class="itemize">
530 <!--l. 231--><p class="noindent" >Simplified Chinese: <a
531 href="../../../../texmf-dist/doc/texlive/texlive-zh-cn" >texmf-dist/doc/texlive/texlive-zh-cn</a></p></li></ul>
532
533 <h4 class="subsectionHead"><span class="titlemark">2.2 </span> <a
534 id="x1-100002.2"></a>The predefined texmf trees</h4>
535 <!--l. 237--><p class="noindent" >This section lists the predefined variables specifying the texmf trees used by the system, and
536 their intended purpose, and the default layout of TeX Live. The command <span
537 class="ec-lmtt-12">tlmgr</span><span
538 class="ec-lmtt-12"> conf </span>shows
539 the values of these variables, so that you can easily find out how they map to particular
540 directories in your installation.
541 </p><!--l. 243--><p class="indent" > All of the trees, including the personal ones, should follow the TeX Directory Structure
542 (TDS, <a
543 href="https://tug.org/tds" class="url" ><span
544 class="ec-lmtt-12">https://tug.org/tds</span></a>), with all its myriad subdirectories, or files may not be
545 found. Section <a
546 href="#x1-340003.4.6">3.4.6<!--tex4ht:ref: sec:local-personal-macros --></a> (p. <a
547 href="#x1-340003.4.6">49<!--tex4ht:ref: sec:local-personal-macros --></a>) describes this in more detail. The order here is the reverse
548 order in which the trees are searched, that is, later trees in the list override earlier
549 ones.
550 </p><!--l. 251--><p class="noindent" >
551 </p><dl class="list1"><dt class="list">
552 <span
553 class="ec-lmtt-12">TEXMFDIST</span> </dt><dd
554 class="list">
555 <!--l. 252--><p class="noindent" >The tree which holds nearly all
556 of the files in the original distribution—configuration files, scripts, packages, fonts,
557 etc. (The main exceptions are the per-platform executables, which are stored in a
558 sibling directory <span
559 class="ec-lmtt-12">bin/</span>.)
560 </p></dd><dt class="list">
561 <span
562 class="ec-lmtt-12">TEXMFSYSVAR</span> </dt><dd
563 class="list">
564 <!--l. 256--><p class="noindent" >The (site-wide) tree used by <span class="obeylines-h"><code class="verb">texconfig-sys</code></span>, <span class="obeylines-h"><code class="verb">updmap-sys</code></span>, <span class="obeylines-h"><code class="verb">fmtutil-sys</code></span>, and
565 <span class="obeylines-h"><code class="verb">tlmgr</code></span>, to store (cached) runtime data such as format files and generated map files.
566 </p></dd><dt class="list">
567 <span
568 class="ec-lmtt-12">TEXMFSYSCONFIG</span> </dt><dd
569 class="list">
570 <!--l. 259--><p class="noindent" >The (site-wide) tree used by <span class="obeylines-h"><code class="verb">texconfig-sys</code></span>, <span class="obeylines-h"><code class="verb">updmap-sys</code></span>, and <span class="obeylines-h"><code class="verb">fmtutil-sys</code></span> to
571 store modified configuration data.
572 </p></dd><dt class="list">
573 <span
574 class="ec-lmtt-12">TEXMFLOCAL</span> </dt><dd
575 class="list">
576 <!--l. 262--><p class="noindent" >The tree which administrators can use for system-wide installation of additional
577 or updated macros, fonts, etc.
578 </p></dd><dt class="list">
579 <span
580 class="ec-lmtt-12">TEXMFHOME</span> </dt><dd
581 class="list">
582 <!--l. 264--><p class="noindent" >The tree which users can use for their own individual installations of additional
583 or updated macros, fonts, etc. For each user, this variable points to their own
584 individual directory.
585 </p></dd><dt class="list">
586 <span
587 class="ec-lmtt-12">TEXMFVAR</span> </dt><dd
588 class="list">
589 <!--l. 268--><p class="noindent" >The (personal) tree used by <span class="obeylines-h"><code class="verb">texconfig</code></span>, <span class="obeylines-h"><code class="verb">updmap-user</code></span> and <span class="obeylines-h"><code class="verb">fmtutil-user</code></span> to store
590 (cached) runtime data such as format files and generated map files.
591 </p></dd><dt class="list">
592 <span
593 class="ec-lmtt-12">TEXMFCONFIG</span> </dt><dd
594 class="list">
595 <!--l. 271--><p class="noindent" >The (personal) tree used by the utilities <span class="obeylines-h"><code class="verb">texconfig</code></span>, <span class="obeylines-h"><code class="verb">updmap-user</code></span>, and
596
597
598 <span class="obeylines-h"><code class="verb">fmtutil-user</code></span> to store modified configuration data.
599 </p></dd><dt class="list">
600 <span
601 class="ec-lmtt-12">TEXMFCACHE</span> </dt><dd
602 class="list">
603 <!--l. 274--><p class="noindent" >The tree(s) used by ConTeXt MkIV and LuaLaTeX to store (cached) runtime
604 data; defaults to <span
605 class="ec-lmtt-12">TEXMFSYSVAR</span>, or (if that’s not writable), <span
606 class="ec-lmtt-12">TEXMFVAR</span>.</p></dd></dl>
607 <!--l. 279--><p class="noindent" >The default layout is:
608 </p><dl class="description"><dt class="description"><a
609 id="x1-10001x2.2"></a>
610 <span
611 class="ec-lmbx-12">system-wide root</span> </dt><dd
612 class="description">
613 <!--l. 282--><p class="noindent" >can span multiple TeX Live releases (<span
614 class="ec-lmtt-12">/usr/local/texlive </span>by default on Unix):
615 </p><dl class="list2"><dt class="list">
616 <span
617 class="ec-lmtt-12">2025</span> </dt><dd
618 class="list">
619 <!--l. 285--><p class="noindent" >A previous release.
620 </p></dd><dt class="list">
621 <span
622 class="ec-lmtt-12">2026</span> </dt><dd
623 class="list">
624 <!--l. 286--><p class="noindent" >The current release.
625 </p><dl class="list3"><dt class="list">
626 <span
627 class="ec-lmtt-12">bin</span> </dt><dd
628 class="list">
629 <!--l. 288--><p class="noindent" > 
630 </p><dl class="list4"><dt class="list">
631 <span
632 class="ec-lmtt-12">i386-linux</span> </dt><dd
633 class="list">
634 <!--l. 290--><p class="noindent" >GNU/Linux binaries (32-bit)
635 </p></dd><dt class="list">
636 <span
637 class="ec-lmtt-12">...</span> </dt><dd
638 class="list">
639 <!--l. 291--><p class="noindent" >
640 </p></dd><dt class="list">
641 <span
642 class="ec-lmtt-12">universal-darwin</span> </dt><dd
643 class="list">
644 <!--l. 292--><p class="noindent" >macOS binaries
645 </p></dd><dt class="list">
646 <span
647 class="ec-lmtt-12">x86_64-linux</span> </dt><dd
648 class="list">
649 <!--l. 293--><p class="noindent" >GNU/Linux binaries (64-bit)
650 </p></dd><dt class="list">
651 <span
652 class="ec-lmtt-12">windows</span> </dt><dd
653 class="list">
654 <!--l. 294--><p class="noindent" >Windows binaries (64-bit)</p></dd></dl>
655 </dd><dt class="list">
656 <span
657 class="ec-lmtt-12">texmf-dist</span><span
658 class="ec-lmtt-12"> </span><span
659 class="ec-lmtt-12"> </span> </dt><dd
660 class="list">
661 <!--l. 296--><p class="noindent" ><span
662 class="ec-lmtt-12">TEXMFDIST </span>and <span
663 class="ec-lmtt-12">TEXMFMAIN</span>
664 </p></dd><dt class="list">
665 <span
666 class="ec-lmtt-12">texmf-var </span><span
667 class="ec-lmtt-12"> </span><span
668 class="ec-lmtt-12"> </span> </dt><dd
669 class="list">
670 <!--l. 297--><p class="noindent" ><span
671 class="ec-lmtt-12">TEXMFSYSVAR</span>, <span
672 class="ec-lmtt-12">TEXMFCACHE</span>
673 </p></dd><dt class="list">
674 <span
675 class="ec-lmtt-12">texmf-config</span> </dt><dd
676 class="list">
677 <!--l. 298--><p class="noindent" ><span
678 class="ec-lmtt-12">TEXMFSYSCONFIG</span></p></dd></dl>
679 </dd><dt class="list">
680 <span
681 class="ec-lmtt-12">texmf-local</span> </dt><dd
682 class="list">
683 <!--l. 300--><p class="noindent" ><span
684 class="ec-lmtt-12">TEXMFLOCAL</span>, intended to be retained from release to release.</p></dd></dl>
685 </dd><dt class="description"><a
686 id="x1-10002x2.2"></a>
687
688
689 <span
690 class="ec-lmbx-12">user’s home directory</span> </dt><dd
691 class="description">
692 <!--l. 303--><p class="noindent" >(<span
693 class="ec-lmtt-12">$HOME </span>or <span
694 class="ec-lmtt-12">%USERPROFILE%</span>)
695 </p><dl class="list2"><dt class="list">
696 <span
697 class="ec-lmtt-12">.texlive2025</span> </dt><dd
698 class="list">
699 <!--l. 306--><p class="noindent" >Privately generated and configuration data for a previous release.
700 </p></dd><dt class="list">
701 <span
702 class="ec-lmtt-12">.texlive2026</span> </dt><dd
703 class="list">
704 <!--l. 308--><p class="noindent" >Privately generated and configuration data for the current release.
705 </p><dl class="list3"><dt class="list">
706 <span
707 class="ec-lmtt-12">texmf-var</span><span
708 class="ec-lmtt-12"> </span><span
709 class="ec-lmtt-12"> </span><span
710 class="ec-lmtt-12"> </span> </dt><dd
711 class="list">
712 <!--l. 311--><p class="noindent" ><span
713 class="ec-lmtt-12">TEXMFVAR</span>, <span
714 class="ec-lmtt-12">TEXMFCACHE</span>
715 </p></dd><dt class="list">
716 <span
717 class="ec-lmtt-12">texmf-config</span> </dt><dd
718 class="list">
719 <!--l. 312--><p class="noindent" ><span
720 class="ec-lmtt-12">TEXMFCONFIG</span></p></dd></dl>
721 </dd><dt class="list">
722 <span
723 class="ec-lmtt-12">texmf</span> </dt><dd
724 class="list">
725 <!--l. 314--><p class="noindent" ><span
726 class="ec-lmtt-12">TEXMFHOME </span>Personal macros, etc.</p></dd></dl>
727 </dd></dl>
728
729 <h4 class="subsectionHead"><span class="titlemark">2.3 </span> <a
730 id="x1-110002.3"></a>Extensions to TeX</h4>
731 <!--l. 322--><p class="noindent" >Knuth’s original TeX itself is frozen, apart from rare bug fixes. It is present in TeX Live as the
732 program <span
733 class="ec-lmss-12">tex</span>, and will remain so for the foreseeable future. TeX Live also contains several
734 extended versions of TeX (also known as TeX engines), all derived from the original
735 program.
736 </p><!--l. 327--><p class="indent" >
737 </p><dl class="description"><dt class="description"><a
738 id="x1-11001x2.3"></a>
739 <span
740 class="ec-lmbx-12">e-TeX</span> </dt><dd
741 class="description">
742 <!--l. 329--><p class="noindent" >adds a set of new primitives (related to macro expansion, character scanning,
743 classes of marks, additional debugging features, and more) and the TeX--XE T
744 extensions for bidirectional typesetting. In default mode, e-TeX is 100% compatible
745 with ordinary TeX. See <a
746 href="../../../../texmf-dist/doc/etex/base/etex_man.pdf" >texmf-dist/doc/etex/base/etex_man.pdf</a>.
747 </p></dd><dt class="description"><a
748 id="x1-11002x2.3"></a>
749 <span
750 class="ec-lmbx-12">pdfTeX</span> </dt><dd
751 class="description">
752 <!--l. 336--><p class="noindent" >builds on the e-TeX extensions, adding support for writing PDF output as
753 well as DVI, and many non-output-related extensions. This is the program
754 invoked for many common formats, e.g., <span
755 class="ec-lmss-12">etex</span>, <span
756 class="ec-lmss-12">latex</span>, <span
757 class="ec-lmss-12">pdflatex</span>. Its web site is
758 <a
759 href="https://pdftex.org/" class="url" ><span
760 class="ec-lmtt-12">https://pdftex.org/</span></a>. See <a
761 href="../../../../texmf-dist/doc/pdftex/manual/pdftex-a.pdf" >texmf-dist/doc/pdftex/manual/pdftex-a.pdf</a> for
762 the manual, and <a
763 href="../../../../texmf-dist/doc/pdftex/samplepdftex/samplepdf.tex" >texmf-dist/doc/pdftex/samplepdftex/samplepdf.tex</a> for example
764 usage of some of its features.
765 </p></dd><dt class="description"><a
766 id="x1-11003x2.3"></a>
767 <span
768 class="ec-lmbx-12">LuaTeX</span> </dt><dd
769 class="description">
770 <!--l. 345--><p class="noindent" >adds support for Unicode input and OpenType/TrueType- and system fonts. It
771 also incorporates MetaPost as a library for fast generation of graphics. Most of
772 all, it includes a Lua interpreter (<a
773 href="https://lua.org/" class="url" ><span
774 class="ec-lmtt-12">https://lua.org/</span></a>), enabling solutions for
775
776
777 many thorny TeX problems. When called as <span
778 class="ec-lmtt-12">texlua</span>, it functions as a standalone
779 Lua interpreter. Its web site is <a
780 href="https://www.luatex.org/" class="url" ><span
781 class="ec-lmtt-12">https://www.luatex.org/</span></a>, and the reference
782 manual is <a
783 href="../../../../texmf-dist/doc/luatex/base/luatex.pdf" >texmf-dist/doc/luatex/base/luatex.pdf</a>.
784 </p></dd><dt class="description"><a
785 id="x1-11004x2.3"></a>
786 <span
787 class="ec-lmbx-12">LuaMetaTeX</span> </dt><dd
788 class="description">
789 <!--l. 353--><p class="noindent" >is a descendant of LuaTeX, and is the default engine for ConTeXt. Most features are
790 implemented in Lua to enable maximum flexibility, including all font handling and
791 backend output. See <a
792 href="https://ctan.org/pkg/context" class="url" ><span
793 class="ec-lmtt-12">https://ctan.org/pkg/context</span></a>; the reference manual is
794 <a
795 href="../../../../texmf-dist/doc/luametatex/base/luametatex.pdf" >texmf-dist/doc/luametatex/base/luametatex.pdf</a>.
796 </p></dd><dt class="description"><a
797 id="x1-11005x2.3"></a>
798 <span
799 class="ec-lmbx-12">XeTeX</span> </dt><dd
800 class="description">
801 <!--l. 359--><p class="noindent" >adds support for Unicode input and OpenType/TrueType- and system fonts,
802 implemented using standard third-party libraries. See <a
803 href="https://tug.org/xetex" class="url" ><span
804 class="ec-lmtt-12">https://tug.org/xetex</span></a>.
805 </p></dd><dt class="description"><a
806 id="x1-11006x2.3"></a>
807 <span
808 class="ec-lmbx-12">HiTeX</span> </dt><dd
809 class="description">
810 <!--l. 363--><p class="noindent" >outputs its own HINT format, designed for mobile devices. See
811 <a
812 href="https://ctan.org/pkg/hitex" class="url" ><span
813 class="ec-lmtt-12">https://ctan.org/pkg/hitex</span></a>.
814 </p></dd><dt class="description"><a
815 id="x1-11007x2.3"></a>
816 <span
817 class="ec-lmbx-12">(e)(u)pTeX</span> </dt><dd
818 class="description">
819 <!--l. 366--><p class="noindent" >provide native support for Japanese typesetting requirements; pTeX is the basic
820 engine, while the ‘e-’ variants add e-TeX functionality and ‘u-’ add Unicode
821 support.
822 </p></dd><dt class="description"><a
823 id="x1-11008x2.3"></a>
824 <span
825 class="ec-lmbx-12">Omega</span><span
826 class="ec-lmbx-12"> (Omega)</span> </dt><dd
827 class="description">
828 <!--l. 370--><p class="noindent" >is the original engine supporting Unicode, written in the 1990s. supports working
829 with almost all the world’s scripts simultaneously. It also supports so-called
830 ‘Omega Translation Processes’ (OTPs), for performing complex transformations
831 on arbitrary input. Omega is no longer included in TeX Live as a separate program;
832 only Aleph is provided:
833 </p></dd><dt class="description"><a
834 id="x1-11009x2.3"></a>
835 <span
836 class="ec-lmbx-12">Aleph</span> </dt><dd
837 class="description">
838 <!--l. 377--><p class="noindent" >combines the Omega and e-TeX extensions. See <a
839 href="../../../../texmf-dist/doc/aleph/base" >texmf-dist/doc/aleph/base</a>.
840 </p>
841 </dd></dl>
842 <!--l. 382--><p class="indent" > For more information about the capabilities and histories of the different engines
843 and the formats built with them, see the article “Overview of TeX engines and
844 formats”, <a
845 href="https://tug.org/TUGboat/tb46-3/tb144berry-engines-formats.pdf" class="url" ><span
846 class="ec-lmtt-12">https://tug.org/TUGboat/tb46-3/tb144berry-engines-formats.pdf</span></a>.
847 For a brief comparison of engines vs. formats vs. packages, see the web page
848 <a
849 href="https://tug.org/levels" class="url" ><span
850 class="ec-lmtt-12">https://tug.org/levels</span></a>.
851
852 </p>
853 <h4 class="subsectionHead"><span class="titlemark">2.4 </span> <a
854 id="x1-120002.4"></a>Other notable programs in TeX Live</h4>
855 <!--l. 391--><p class="noindent" >Here are a few other commonly-used programs included in TeX Live:
856 </p><!--l. 393--><p class="indent" >
857
858
859 </p><dl class="list1"><dt class="list">
860 <span
861 class="ec-lmss-12">bibtex, biber</span> </dt><dd
862 class="list">
863 <!--l. 395--><p class="noindent" >bibliography support.
864 </p></dd><dt class="list">
865 <span
866 class="ec-lmss-12">makeindex, upmendex, xindex, xindy</span> </dt><dd
867 class="list">
868 <!--l. 397--><p class="noindent" >index support.
869 </p></dd><dt class="list">
870 <span
871 class="ec-lmss-12">dvips</span> </dt><dd
872 class="list">
873 <!--l. 399--><p class="noindent" >convert DVI to PostScript.
874 </p></dd><dt class="list">
875 <span
876 class="ec-lmss-12">dvipdfmx</span> </dt><dd
877 class="list">
878 <!--l. 401--><p class="noindent" >convert DVI to PDF, an alternative approach to pdfTeX (mentioned above).
879 </p></dd><dt class="list">
880 <span
881 class="ec-lmss-12">xdvi</span> </dt><dd
882 class="list">
883 <!--l. 404--><p class="noindent" >DVI previewer for the X Window System.
884 </p></dd><dt class="list">
885 <span
886 class="ec-lmss-12">dviconcat, dviselect</span> </dt><dd
887 class="list">
888 <!--l. 406--><p class="noindent" >cut and paste pages from DVI files.
889 </p></dd><dt class="list">
890 <span
891 class="ec-lmss-12">psselect, psnup, </span><span
892 class="ec-lmss-12">…</span> </dt><dd
893 class="list">
894 <!--l. 409--><p class="noindent" >PostScript utilities.
895 </p></dd><dt class="list">
896 <span
897 class="ec-lmss-12">pdfjam, pdfjoin, </span><span
898 class="ec-lmss-12">…</span> </dt><dd
899 class="list">
900 <!--l. 411--><p class="noindent" >PDF utilities.
901 </p></dd><dt class="list">
902 <span
903 class="ec-lmss-12">context, mtxrun</span> </dt><dd
904 class="list">
905 <!--l. 413--><p class="noindent" >ConTeXt and PDF processor.
906 </p></dd><dt class="list">
907 <span
908 class="ec-lmss-12">htlatex, </span><span
909 class="ec-lmss-12">…</span> </dt><dd
910 class="list">
911 <!--l. 415--><p class="noindent" ><span
912 class="ec-lmss-12">tex4ht</span>: (L<span
913 class="ec-lmr-8">A</span>)TeX to HTML (and XML and DocX and more) converter.
914 </p>
915 </dd></dl>
916 <!--l. 421--><p class="indent" > <a id="installation"></a>
917 </p>
918 <h3 class="sectionHead"><span class="titlemark">3 </span> <a
919 id="x1-130003"></a>Installation</h3>
920
921 <h4 class="subsectionHead"><span class="titlemark">3.1 </span> <a
922 id="x1-140003.1"></a>Starting the installer</h4>
923 <!--l. 428--><p class="noindent" >To begin, the most common method is to download the TeX Live net installer. See
924 <a
925 href="https://tug.org/texlive/acquire.html" class="url" ><span
926 class="ec-lmtt-12">https://tug.org/texlive/acquire.html</span></a> for more information and other methods of getting
927 the software.
928 </p><!--l. 432--><p class="indent" >
929
930
931 </p><dl class="description"><dt class="description"><a
932 id="x1-14001x3.1"></a>
933 <span
934 class="ec-lmbx-12">Net installer, .zip or .tar.gz:</span> </dt><dd
935 class="description">
936 <!--l. 433--><p class="noindent" >Download the archive from CTAN, under <span
937 class="ec-lmtt-12">systems/texlive/tlnet</span>; the url
938 <a
939 href="https://mirror.ctan.org/systems/texlive/tlnet" class="url" ><span
940 class="ec-lmtt-12">https://mirror.ctan.org/systems/texlive/tlnet</span></a> should redirect to a nearby,
941 up-to-date, mirror. You can retrieve either <span
942 class="ec-lmtt-12">install-tl.zip </span>which can be used
943 under Unix and Windows, or the considerably smaller <span
944 class="ec-lmtt-12">install-unx.tar.gz </span>for
945 Unix only. After unpacking, <span
946 class="ec-lmtt-12">install-tl </span>and <span
947 class="ec-lmtt-12">install-tl-windows.bat </span>will be
948 in the subdirectory <span
949 class="ec-lmtt-12">install-tl-yyyymmdd</span>, where yyyymmdd represents the date
950 when the installer was generated.
951 </p></dd><dt class="description"><a
952 id="x1-14002x3.1"></a>
953 <span
954 class="ec-lmbx-12">Net installer, Windows .exe:</span> </dt><dd
955 class="description">
956 <!--l. 444--><p class="noindent" >Download from CTAN as above, and double-click. This starts up a first-stage
957 installer and unpacker; see figure <a
958 href="#x1-14004r1">1<!--tex4ht:ref: fig:nsis --></a>. It gives two choices: ‘Install’ and ‘Unpack
959 only’.
960 </p></dd><dt class="description"><a
961 id="x1-14003x3.1"></a>
962 <span
963 class="ec-lmbx-12">DVD</span><span
964 class="ec-lmbx-12"> or ISO</span><span
965 class="ec-lmbx-12"> image</span> </dt><dd
966 class="description">
967 <!--l. 449--><p class="noindent" >The unpacking will already be done, so you just run <span
968 class="ec-lmtt-12">install-tl </span>as described
969 below.
970 </p>
971 </dd></dl>
972 <figure class="figure">
973
974
975
976 <a
977 id="x1-14004r1"></a>
978
979
980 <!--l. 456--><p class="noindent" ><img
981 src="../texlive-common/nsis_installer.png" alt="First stage of Windows .exe installer"
982 />
983 </p>
984 <figcaption class="caption" ><span class="id">Figure 1: </span><span
985 class="content">First stage of Windows <span
986 class="ec-lmtt-12">.exe </span>installer. Pressing the Install button will give you
987 the window displayed in figure <a
988 href="#x1-17062r3">3<!--tex4ht:ref: fig:basic-w32 --></a>.</span></figcaption><!--tex4ht:label?: x1-14004r1 -->
989
990
991 </figure>
992 <!--l. 461--><p class="indent" > If you need to download through proxies, use a <span
993 class="ec-lmtt-12">~/.wgetrc </span>file or environment variables with the proxy
994 settings for Wget (<a
995 href="https://www.gnu.org/software/wget/manual/html_node/Proxies.html" class="url" ><span
996 class="ec-lmtt-12">https://www.gnu.org/software/wget/manual/html_node/Proxies.html</span></a>),
997 or the equivalent for whatever download program you are using. This does not matter if you
998 are installing from the DVD or ISO image.
999 </p><!--l. 467--><p class="indent" > By default, the installer uses compression and download programs as found in <span
1000 class="ec-lmtt-12">PATH</span>.
1001 (Exception: on Windows, the tar.exe shipped with TL is always used, regardless of any
1002 setting.) If you get errors during download or unpacking, such as <span
1003 class="ec-lmtt-12">tar:</span><span
1004 class="ec-lmtt-12"> Skipping to next</span>
1005 <span
1006 class="ec-lmtt-12">file header</span>, you can try setting the environment variable <span
1007 class="ec-lmtt-12">TEXLIVE_PREFER_OWN </span>to <span
1008 class="ec-lmtt-12">1 </span>to use
1009 TeX Live-provided programs instead. You can also explicitly specify the programs and/or
1010 options to use with other environment variables. The <span
1011 class="ec-lmtt-12">tlmgr </span>documentation gives the details:
1012 <a
1013 href="https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES" class="url" ><span
1014 class="ec-lmtt-12">https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES</span></a>.
1015 </p><!--l. 477--><p class="indent" > The following sections explain installer start-up in more detail.
1016
1017 </p>
1018 <h5 class="subsubsectionHead"><span class="titlemark">3.1.1 </span> <a
1019 id="x1-150003.1.1"></a>Unix</h5>
1020 <!--l. 481--><p class="noindent" >Below, <span
1021 class="ec-lmtt-12">&#x003E; </span>denotes the shell prompt; user input is <span
1022 class="ec-lmtk-10x-x-120">bold</span>. The <span
1023 class="ec-lmtt-12">install-tl </span>program is a
1024 Perl script. The simplest way to start it on a Unix-compatible system is as follows:
1025 </p><div class="alltt">
1026
1027 <div class="obeylines-v">
1028 <br /><span
1029 class="ec-lmtt-12">&#x003E;</span><span
1030 class="ec-lmtt-12"> </span><span
1031 class="ec-lmtk-10x-x-120">perl</span><span
1032 class="ec-lmtk-10x-x-120"> /path/to/installer/install-tl</span>
1033 </div>
1034 </div> (Or you can invoke <span
1035 class="ec-lmtk-10x-x-120">/path/to/installer/install-tl </span>if it stayed executable, or <span
1036 class="ec-lmtt-12">cd </span>to the
1037 directory first, etc.; we won’t repeat all the variations.) You may have to enlarge your terminal
1038 window so that it shows the full text installer screen (figure <a
1039 href="#x1-17061r2">2<!--tex4ht:ref: fig:text-main --></a>).
1040 <!--l. 494--><p class="indent" > To install in GUI mode (figure <a
1041 href="#x1-17063r4">4<!--tex4ht:ref: fig:advanced-lnx --></a>), you’ll need to have Tcl/Tk installed. Given that, you
1042 can run: </p><div class="alltt">
1043
1044 <div class="obeylines-v">
1045 <br /><span
1046 class="ec-lmtt-12">&#x003E;</span><span
1047 class="ec-lmtt-12"> </span><span
1048 class="ec-lmtk-10x-x-120">perl</span><span
1049 class="ec-lmtk-10x-x-120"> install-tl</span><span
1050 class="ec-lmtk-10x-x-120"> -gui</span>
1051 </div>
1052 </div>
1053 <!--l. 500--><p class="indent" > The old <span
1054 class="ec-lmtt-12">-wizard </span>and <span
1055 class="ec-lmtt-12">-perltk</span>/<span
1056 class="ec-lmtt-12">-expert </span>options now do the same thing as <span
1057 class="ec-lmtt-12">-gui</span>. For a
1058 complete listing of the various options: </p><div class="alltt">
1059
1060 <div class="obeylines-v">
1061 <br /><span
1062 class="ec-lmtt-12">&#x003E;</span><span
1063 class="ec-lmtt-12"> </span><span
1064 class="ec-lmtk-10x-x-120">perl</span><span
1065 class="ec-lmtk-10x-x-120"> install-tl</span><span
1066 class="ec-lmtk-10x-x-120"> -help</span>
1067 </div>
1068 </div>
1069 <!--l. 507--><p class="indent" > <span
1070 class="ec-lmbx-12">About Unix permissions: </span>Your <span
1071 class="ec-lmtt-12">umask </span>at the time of installation will be respected by
1072 the TeX Live installer. Therefore, if you want your installation to be usable by users other
1073 than you, make sure your setting is sufficiently permissive, for instance, <span
1074 class="ec-lmtt-12">umask 002</span>. For more
1075 information about <span
1076 class="ec-lmtt-12">umask</span>, consult your system documentation.
1077
1078
1079 </p><!--l. 514--><p class="indent" > <span
1080 class="ec-lmbx-12">Special considerations for Cygwin: </span>Unlike other Unix-compatible systems, Cygwin
1081 does not by default include all of the prerequisite programs needed by the TeX Live installer.
1082 See section <a
1083 href="#x1-180003.1.4">3.1.4<!--tex4ht:ref: sec:cygwin --></a> for the packages which you need to install first.
1084
1085 </p>
1086 <h5 class="subsubsectionHead"><span class="titlemark">3.1.2 </span> <a
1087 id="x1-160003.1.2"></a>macOS</h5>
1088 <!--l. 523--><p class="noindent" >A separate distribution is prepared for macOS, named MacTeX (<a
1089 href="https://tug.org/mactex" class="url" ><span
1090 class="ec-lmtt-12">https://tug.org/mactex</span></a>).
1091 We recommend using the native MacTeX installer instead of the TeX Live installer on
1092 macOS, because the native installer makes a few Mac-specific adjustments, in particular to
1093 allow easily switching between different TeX Live releases on Macs, using the so-called
1094 TeXDist data structure.
1095 </p><!--l. 530--><p class="indent" > MacTeX is a superset of TeX Live, and the main TeX trees and binaries are
1096 precisely the same. It adds a few extra folders with Mac-specific documentation and
1097 applications.
1098
1099 </p>
1100 <h5 class="subsubsectionHead"><span class="titlemark">3.1.3 </span> <a
1101 id="x1-170003.1.3"></a>Windows</h5>
1102 <!--l. 537--><p class="noindent" >If you are using the unpacked downloaded zip file, or the DVD installer failed to start
1103 automatically, double-click <span
1104 class="ec-lmtt-12">install-tl-windows.bat</span>.
1105 </p><!--l. 541--><p class="indent" > You can also start the installer from the command-prompt. Below, <span
1106 class="ec-lmtt-12">&#x003E; </span>denotes the prompt;
1107 user input is <span
1108 class="ec-lmtk-10x-x-120">bold</span>. If you are in the installer directory, run just: </p><div class="alltt">
1109
1110 <div class="obeylines-v">
1111 <br /><span
1112 class="ec-lmtt-12">&#x003E;</span><span
1113 class="ec-lmtt-12"> </span><span
1114 class="ec-lmtk-10x-x-120">install-tl-windows</span></div>
1115 </div>
1116 <!--l. 548--><p class="indent" > Or you can invoke it with an absolute location, such as: </p><div class="alltt">
1117
1118 <div class="obeylines-v">
1119 <br /><span
1120 class="ec-lmtt-12">&#x003E;</span><span
1121 class="ec-lmtt-12"> </span><span
1122 class="ec-lmtk-10x-x-120">C:</span><span
1123 class="ec-lmtt-12">\</span><span
1124 class="ec-lmtk-10x-x-120">tltemp</span><span
1125 class="ec-lmtt-12">\</span><span
1126 class="ec-lmtk-10x-x-120">install-tl-windows</span>
1127 </div>
1128 </div> Figure <a
1129 href="#x1-17062r3">3<!--tex4ht:ref: fig:basic-w32 --></a> displays the initial basic screen of the GUI installer, which is the default for
1130 Windows.
1131 <!--l. 555--><p class="indent" > To install in text mode, use: </p><div class="alltt">
1132
1133 <div class="obeylines-v">
1134 <br /><span
1135 class="ec-lmtt-12">&#x003E;</span><span
1136 class="ec-lmtt-12"> </span><span
1137 class="ec-lmtk-10x-x-120">install-tl-windows</span><span
1138 class="ec-lmtk-10x-x-120"> -no-gui</span>
1139 </div>
1140 </div>
1141 <!--l. 560--><p class="indent" > For a complete listing of the various options: </p><div class="alltt">
1142
1143
1144
1145 <div class="obeylines-v">
1146 <br /><span
1147 class="ec-lmtt-12">&#x003E;</span><span
1148 class="ec-lmtt-12"> </span><span
1149 class="ec-lmtk-10x-x-120">install-tl-windows</span><span
1150 class="ec-lmtk-10x-x-120"> -help</span>
1151 </div>
1152 </div>
1153 <!--l. 565--><p class="indent" > Add a <span
1154 class="ec-lmtt-12">.bat </span>extension to the invocations if the same directory also contains
1155 <span
1156 class="ec-lmtt-12">install-tl-windows.exe</span>. This will not normally be the case, unless you’ve mirrored the
1157 <span
1158 class="ec-lmtt-12">tlnet </span>directory locally.
1159 </p><!--l. 570--><p class="indent" > Non-ASCII characters in the path for the TeX Live installation must be
1160 avoided. This may be a problem particularly under Windows 11, where users are
1161 forced to create a Microsoft network account upon installation of Windows. See
1162 <a
1163 href="https://tug.org/texlive/windows.html\#nonascii" class="url" ><span
1164 class="ec-lmtt-12">https://tug.org/texlive/windows.html\#nonascii</span></a> for some workarounds.
1165 </p>
1166 <figure class="figure">
1167
1168
1169
1170 <a
1171 id="x1-17061r2"></a>
1172
1173
1174 <pre class="fancyvrb" id="fancyvrb1"><a
1175 id="x1-17002r1"></a><span
1176 class="ec-lmtt-10">Installing</span><span
1177 class="ec-lmtt-10"> TeX</span><span
1178 class="ec-lmtt-10"> Live</span><span
1179 class="ec-lmtt-10"> 2026</span><span
1180 class="ec-lmtt-10"> from:</span><span
1181 class="ec-lmtt-10"> ...</span>
1182 <a
1183 id="x1-17004r2"></a><span
1184 class="ec-lmtt-10">Platform:</span><span
1185 class="ec-lmtt-10"> x86_64-linux</span><span
1186 class="ec-lmtt-10"> =&#x003E;</span><span
1187 class="ec-lmtt-10"> ’GNU/Linux</span><span
1188 class="ec-lmtt-10"> on</span><span
1189 class="ec-lmtt-10"> x86_64’</span>
1190 <a
1191 id="x1-17006r3"></a><span
1192 class="ec-lmtt-10">Distribution:</span><span
1193 class="ec-lmtt-10"> inst</span><span
1194 class="ec-lmtt-10"> (compressed)</span>
1195 <a
1196 id="x1-17008r4"></a><span
1197 class="ec-lmtt-10">Directory</span><span
1198 class="ec-lmtt-10"> for</span><span
1199 class="ec-lmtt-10"> temporary</span><span
1200 class="ec-lmtt-10"> files:</span><span
1201 class="ec-lmtt-10"> /tmp</span>
1202 <a
1203 id="x1-17010r5"></a><span
1204 class="ec-lmtt-10">...</span>
1205 <a
1206 id="x1-17012r6"></a><span
1207 class="ec-lmtt-10"> Detected</span><span
1208 class="ec-lmtt-10"> platform:</span><span
1209 class="ec-lmtt-10"> GNU/Linux</span><span
1210 class="ec-lmtt-10"> on</span><span
1211 class="ec-lmtt-10"> Intel</span><span
1212 class="ec-lmtt-10"> x86_64</span>
1213 <a
1214 id="x1-17014r7"></a>
1215 <a
1216 id="x1-17016r8"></a><span
1217 class="ec-lmtt-10"> &#x003C;B&#x003E;</span><span
1218 class="ec-lmtt-10"> binary</span><span
1219 class="ec-lmtt-10"> platforms:</span><span
1220 class="ec-lmtt-10"> 1</span><span
1221 class="ec-lmtt-10"> out</span><span
1222 class="ec-lmtt-10"> of</span><span
1223 class="ec-lmtt-10"> 15</span>
1224 <a
1225 id="x1-17018r9"></a>
1226 <a
1227 id="x1-17020r10"></a><span
1228 class="ec-lmtt-10"> &#x003C;S&#x003E;</span><span
1229 class="ec-lmtt-10"> set</span><span
1230 class="ec-lmtt-10"> installation</span><span
1231 class="ec-lmtt-10"> scheme:</span><span
1232 class="ec-lmtt-10"> scheme-full</span>
1233 <a
1234 id="x1-17022r11"></a>
1235 <a
1236 id="x1-17024r12"></a><span
1237 class="ec-lmtt-10"> &#x003C;C&#x003E;</span><span
1238 class="ec-lmtt-10"> customizing</span><span
1239 class="ec-lmtt-10"> installation</span><span
1240 class="ec-lmtt-10"> collections</span>
1241 <a
1242 id="x1-17026r13"></a><span
1243 class="ec-lmtt-10"> </span><span
1244 class="ec-lmtt-10"> </span><span
1245 class="ec-lmtt-10"> </span><span
1246 class="ec-lmtt-10"> </span><span
1247 class="ec-lmtt-10"> 40</span><span
1248 class="ec-lmtt-10"> collections</span><span
1249 class="ec-lmtt-10"> out</span><span
1250 class="ec-lmtt-10"> of</span><span
1251 class="ec-lmtt-10"> 41,</span><span
1252 class="ec-lmtt-10"> disk</span><span
1253 class="ec-lmtt-10"> space</span><span
1254 class="ec-lmtt-10"> required:</span><span
1255 class="ec-lmtt-10"> 9402</span><span
1256 class="ec-lmtt-10"> MB</span><span
1257 class="ec-lmtt-10"> (free:</span><span
1258 class="ec-lmtt-10"> 138718</span><span
1259 class="ec-lmtt-10"> MB)</span>
1260 <a
1261 id="x1-17028r14"></a>
1262 <a
1263 id="x1-17030r15"></a><span
1264 class="ec-lmtt-10"> &#x003C;D&#x003E;</span><span
1265 class="ec-lmtt-10"> directories:</span>
1266 <a
1267 id="x1-17032r16"></a><span
1268 class="ec-lmtt-10"> </span><span
1269 class="ec-lmtt-10"> </span><span
1270 class="ec-lmtt-10"> TEXDIR</span><span
1271 class="ec-lmtt-10"> (the</span><span
1272 class="ec-lmtt-10"> main</span><span
1273 class="ec-lmtt-10"> TeX</span><span
1274 class="ec-lmtt-10"> directory):</span>
1275 <a
1276 id="x1-17034r17"></a><span
1277 class="ec-lmtt-10"> </span><span
1278 class="ec-lmtt-10"> </span><span
1279 class="ec-lmtt-10"> </span><span
1280 class="ec-lmtt-10"> </span><span
1281 class="ec-lmtt-10"> /usr/local/texlive/2026</span>
1282 <a
1283 id="x1-17036r18"></a><span
1284 class="ec-lmtt-10"> </span><span
1285 class="ec-lmtt-10"> </span><span
1286 class="ec-lmtt-10"> ...</span>
1287 <a
1288 id="x1-17038r19"></a>
1289 <a
1290 id="x1-17040r20"></a><span
1291 class="ec-lmtt-10"> &#x003C;O&#x003E;</span><span
1292 class="ec-lmtt-10"> options:</span>
1293 <a
1294 id="x1-17042r21"></a><span
1295 class="ec-lmtt-10"> </span><span
1296 class="ec-lmtt-10"> </span><span
1297 class="ec-lmtt-10"> [</span><span
1298 class="ec-lmtt-10"> ]</span><span
1299 class="ec-lmtt-10"> use</span><span
1300 class="ec-lmtt-10"> letter</span><span
1301 class="ec-lmtt-10"> size</span><span
1302 class="ec-lmtt-10"> instead</span><span
1303 class="ec-lmtt-10"> of</span><span
1304 class="ec-lmtt-10"> A4</span><span
1305 class="ec-lmtt-10"> by</span><span
1306 class="ec-lmtt-10"> default</span>
1307 <a
1308 id="x1-17044r22"></a><span
1309 class="ec-lmtt-10"> </span><span
1310 class="ec-lmtt-10"> </span><span
1311 class="ec-lmtt-10"> ...</span>
1312 <a
1313 id="x1-17046r23"></a>
1314 <a
1315 id="x1-17048r24"></a><span
1316 class="ec-lmtt-10"> &#x003C;V&#x003E;</span><span
1317 class="ec-lmtt-10"> set</span><span
1318 class="ec-lmtt-10"> up</span><span
1319 class="ec-lmtt-10"> for</span><span
1320 class="ec-lmtt-10"> portable</span><span
1321 class="ec-lmtt-10"> installation</span>
1322 <a
1323 id="x1-17050r25"></a>
1324 <a
1325 id="x1-17052r26"></a><span
1326 class="ec-lmtt-10">Actions:</span>
1327 <a
1328 id="x1-17054r27"></a><span
1329 class="ec-lmtt-10"> &#x003C;I&#x003E;</span><span
1330 class="ec-lmtt-10"> start</span><span
1331 class="ec-lmtt-10"> installation</span><span
1332 class="ec-lmtt-10"> to</span><span
1333 class="ec-lmtt-10"> hard</span><span
1334 class="ec-lmtt-10"> disk</span>
1335 <a
1336 id="x1-17056r28"></a><span
1337 class="ec-lmtt-10"> &#x003C;P&#x003E;</span><span
1338 class="ec-lmtt-10"> save</span><span
1339 class="ec-lmtt-10"> installation</span><span
1340 class="ec-lmtt-10"> profile</span><span
1341 class="ec-lmtt-10"> to</span><span
1342 class="ec-lmtt-10"> ’texlive.profile’</span><span
1343 class="ec-lmtt-10"> and</span><span
1344 class="ec-lmtt-10"> exit</span>
1345 <a
1346 id="x1-17058r29"></a><span
1347 class="ec-lmtt-10"> &#x003C;H&#x003E;</span><span
1348 class="ec-lmtt-10"> help</span>
1349 <a
1350 id="x1-17060r30"></a><span
1351 class="ec-lmtt-10"> &#x003C;Q&#x003E;</span><span
1352 class="ec-lmtt-10"> quit</span></pre>
1353 <figcaption class="caption" ><span class="id">Figure 2: </span><span
1354 class="content">Main text installer screen (GNU/Linux)</span></figcaption><!--tex4ht:label?: x1-17061r2 -->
1355
1356
1357 </figure>
1358 <figure class="figure">
1359
1360
1361
1362 <a
1363 id="x1-17062r3"></a>
1364
1365
1366 <!--l. 615--><p class="noindent" ><img
1367 src="../texlive-common/basic-w32.png" alt="Basic installer screen (Windows)"
1368 />
1369 </p>
1370 <figcaption class="caption" ><span class="id">Figure 3: </span><span
1371 class="content">Basic installer screen (Windows); the Advanced button will result in something
1372 like figure <a
1373 href="#x1-17063r4">4<!--tex4ht:ref: fig:advanced-lnx --></a></span></figcaption><!--tex4ht:label?: x1-17062r3 -->
1374
1375
1376 </figure>
1377 <figure class="figure">
1378
1379
1380
1381 <a
1382 id="x1-17063r4"></a>
1383
1384
1385 <!--l. 621--><p class="noindent" ><img
1386 src="../texlive-common/advanced-lnx.png" alt="Advanced installer screen (GNU/Linux)"
1387 />
1388 </p>
1389 <figcaption class="caption" ><span class="id">Figure 4: </span><span
1390 class="content">Advanced GUI installer screen (GNU/Linux)</span></figcaption><!--tex4ht:label?: x1-17063r4 -->
1391
1392
1393 </figure>
1394 <!--l. 627--><p class="indent" > <a id="cygwin"></a>
1395 </p>
1396 <h5 class="subsubsectionHead"><span class="titlemark">3.1.4 </span> <a
1397 id="x1-180003.1.4"></a>Cygwin</h5>
1398 <!--l. 631--><p class="noindent" >Before beginning the installation, use Cygwin’s <span
1399 class="ec-lmtt-12">setup.exe </span>program to install the <span
1400 class="ec-lmtt-12">perl </span>and
1401 either <span
1402 class="ec-lmtt-12">curl </span>or <span
1403 class="ec-lmtt-12">wget </span>packages if you have not already done so. The following additional
1404 packages are recommended: </p>
1405 <ul class="itemize1">
1406 <li class="itemize">
1407 <!--l. 636--><p class="noindent" ><span
1408 class="ec-lmtt-12">fontconfig </span>[needed by XeTeX and LuaTeX]
1409 </p></li>
1410 <li class="itemize">
1411 <!--l. 637--><p class="noindent" ><span
1412 class="ec-lmtt-12">ghostscript </span>[needed by various utilities]
1413 </p></li>
1414 <li class="itemize">
1415 <!--l. 638--><p class="noindent" ><span
1416 class="ec-lmtt-12">libXaw7 </span>[needed by <span
1417 class="ec-lmtt-12">xdvi</span>]
1418 </p></li>
1419 <li class="itemize">
1420 <!--l. 639--><p class="noindent" ><span
1421 class="ec-lmtt-12">ncurses </span>[provides the <span
1422 class="ec-lmtt-12">clear </span>command used by the installer]</p></li></ul>
1423
1424 <h5 class="subsubsectionHead"><span class="titlemark">3.1.5 </span> <a
1425 id="x1-190003.1.5"></a>The text installer</h5>
1426 <!--l. 645--><p class="noindent" >Figure <a
1427 href="#x1-17061r2">2<!--tex4ht:ref: fig:text-main --></a> displays the main text mode screen under Unix. The text installer is the default on
1428 Unix.
1429 </p><!--l. 648--><p class="indent" > This is only a command-line installer; there is no cursor support at all. For instance, you
1430 cannot tab around checkboxes or input fields. You just type something (case-sensitive) at the
1431 prompt and press the Enter key, and then the entire terminal screen will be rewritten, with
1432 adjusted content.
1433 </p><!--l. 654--><p class="indent" > The text installer interface is this primitive in order to make it run on as many platforms
1434 as possible, even with a minimal Perl.
1435
1436 </p>
1437 <h5 class="subsubsectionHead"><span class="titlemark">3.1.6 </span> <a
1438 id="x1-200003.1.6"></a>The graphical installer</h5>
1439 <!--l. 660--><p class="noindent" >The default graphical installer starts out simple, with just a few options; see figure <a
1440 href="#x1-17062r3">3<!--tex4ht:ref: fig:basic-w32 --></a>. It can
1441 be started with </p><div class="alltt">
1442
1443 <div class="obeylines-v">
1444 <br /><span
1445 class="ec-lmtt-12">&#x003E;</span><span
1446 class="ec-lmtt-12"> </span><span
1447 class="ec-lmtk-10x-x-120">install-tl</span><span
1448 class="ec-lmtk-10x-x-120"> -gui</span>
1449
1450
1451 </div>
1452 </div> The Advanced button gives access to most of the options of the text installer; see
1453 figure <a
1454 href="#x1-17063r4">4<!--tex4ht:ref: fig:advanced-lnx --></a>.
1455 <!--l. 668--><p class="indent" > The <span
1456 class="ec-lmtt-12">perltk</span>/<span
1457 class="ec-lmtt-12">expert </span>and <span
1458 class="ec-lmtt-12">wizard </span>GUI options now invoke the regular graphical
1459 installer.
1460
1461 </p>
1462 <h4 class="subsectionHead"><span class="titlemark">3.2 </span> <a
1463 id="x1-210003.2"></a>Running the installer</h4>
1464 <!--l. 674--><p class="noindent" >The installer is intended to be mostly self-explanatory, but following are a few notes about the
1465 various options and submenus.
1466
1467 </p>
1468 <h5 class="subsubsectionHead"><span class="titlemark">3.2.1 </span> <a
1469 id="x1-220003.2.1"></a>Binary systems menu (Unix only)</h5>
1470 <figure class="figure">
1471
1472
1473
1474 <a
1475 id="x1-22035r5"></a>
1476
1477
1478 <pre class="fancyvrb" id="fancyvrb2"><a
1479 id="x1-22002r1"></a><span
1480 class="ec-lmtt-10">Available</span><span
1481 class="ec-lmtt-10"> platforms:</span>
1482 <a
1483 id="x1-22004r2"></a><span
1484 class="ec-lmtt-10">===============================================================================</span>
1485 <a
1486 id="x1-22006r3"></a><span
1487 class="ec-lmtt-10"> </span><span
1488 class="ec-lmtt-10"> </span><span
1489 class="ec-lmtt-10"> a</span><span
1490 class="ec-lmtt-10"> [</span><span
1491 class="ec-lmtt-10"> ]</span><span
1492 class="ec-lmtt-10"> Cygwin</span><span
1493 class="ec-lmtt-10"> on</span><span
1494 class="ec-lmtt-10"> x86_64</span><span
1495 class="ec-lmtt-10"> (x86_64-cygwin)</span>
1496 <a
1497 id="x1-22008r4"></a><span
1498 class="ec-lmtt-10"> </span><span
1499 class="ec-lmtt-10"> </span><span
1500 class="ec-lmtt-10"> b</span><span
1501 class="ec-lmtt-10"> [</span><span
1502 class="ec-lmtt-10"> ]</span><span
1503 class="ec-lmtt-10"> macOS</span><span
1504 class="ec-lmtt-10"> current</span><span
1505 class="ec-lmtt-10"> (11-)</span><span
1506 class="ec-lmtt-10"> on</span><span
1507 class="ec-lmtt-10"> ARM/x86_64</span><span
1508 class="ec-lmtt-10"> (universal-darwin)</span>
1509 <a
1510 id="x1-22010r5"></a><span
1511 class="ec-lmtt-10"> </span><span
1512 class="ec-lmtt-10"> </span><span
1513 class="ec-lmtt-10"> c</span><span
1514 class="ec-lmtt-10"> [</span><span
1515 class="ec-lmtt-10"> ]</span><span
1516 class="ec-lmtt-10"> MacOSX</span><span
1517 class="ec-lmtt-10"> legacy</span><span
1518 class="ec-lmtt-10"> (10.6-)</span><span
1519 class="ec-lmtt-10"> on</span><span
1520 class="ec-lmtt-10"> x86_64</span><span
1521 class="ec-lmtt-10"> (x86_64-darwinlegacy)</span>
1522 <a
1523 id="x1-22012r6"></a><span
1524 class="ec-lmtt-10"> </span><span
1525 class="ec-lmtt-10"> </span><span
1526 class="ec-lmtt-10"> d</span><span
1527 class="ec-lmtt-10"> [</span><span
1528 class="ec-lmtt-10"> ]</span><span
1529 class="ec-lmtt-10"> FreeBSD</span><span
1530 class="ec-lmtt-10"> on</span><span
1531 class="ec-lmtt-10"> x86_64</span><span
1532 class="ec-lmtt-10"> (amd64-freebsd)</span>
1533 <a
1534 id="x1-22014r7"></a><span
1535 class="ec-lmtt-10"> </span><span
1536 class="ec-lmtt-10"> </span><span
1537 class="ec-lmtt-10"> e</span><span
1538 class="ec-lmtt-10"> [</span><span
1539 class="ec-lmtt-10"> ]</span><span
1540 class="ec-lmtt-10"> FreeBSD</span><span
1541 class="ec-lmtt-10"> on</span><span
1542 class="ec-lmtt-10"> Intel</span><span
1543 class="ec-lmtt-10"> x86</span><span
1544 class="ec-lmtt-10"> (i386-freebsd)</span>
1545 <a
1546 id="x1-22016r8"></a><span
1547 class="ec-lmtt-10"> </span><span
1548 class="ec-lmtt-10"> </span><span
1549 class="ec-lmtt-10"> f</span><span
1550 class="ec-lmtt-10"> [</span><span
1551 class="ec-lmtt-10"> ]</span><span
1552 class="ec-lmtt-10"> GNU/Linux</span><span
1553 class="ec-lmtt-10"> on</span><span
1554 class="ec-lmtt-10"> ARM64</span><span
1555 class="ec-lmtt-10"> (aarch64-linux)</span>
1556 <a
1557 id="x1-22018r9"></a><span
1558 class="ec-lmtt-10"> </span><span
1559 class="ec-lmtt-10"> </span><span
1560 class="ec-lmtt-10"> g</span><span
1561 class="ec-lmtt-10"> [</span><span
1562 class="ec-lmtt-10"> ]</span><span
1563 class="ec-lmtt-10"> GNU/Linux</span><span
1564 class="ec-lmtt-10"> on</span><span
1565 class="ec-lmtt-10"> RPi(32-bit)</span><span
1566 class="ec-lmtt-10"> and</span><span
1567 class="ec-lmtt-10"> ARMv7</span><span
1568 class="ec-lmtt-10"> (armhf-linux)</span>
1569 <a
1570 id="x1-22020r10"></a><span
1571 class="ec-lmtt-10"> </span><span
1572 class="ec-lmtt-10"> </span><span
1573 class="ec-lmtt-10"> h</span><span
1574 class="ec-lmtt-10"> [</span><span
1575 class="ec-lmtt-10"> ]</span><span
1576 class="ec-lmtt-10"> GNU/Linux</span><span
1577 class="ec-lmtt-10"> on</span><span
1578 class="ec-lmtt-10"> Intel</span><span
1579 class="ec-lmtt-10"> x86</span><span
1580 class="ec-lmtt-10"> (i386-linux)</span>
1581 <a
1582 id="x1-22022r11"></a><span
1583 class="ec-lmtt-10"> </span><span
1584 class="ec-lmtt-10"> </span><span
1585 class="ec-lmtt-10"> i</span><span
1586 class="ec-lmtt-10"> [X]</span><span
1587 class="ec-lmtt-10"> GNU/Linux</span><span
1588 class="ec-lmtt-10"> on</span><span
1589 class="ec-lmtt-10"> x86_64</span><span
1590 class="ec-lmtt-10"> (x86_64-linux)</span>
1591 <a
1592 id="x1-22024r12"></a><span
1593 class="ec-lmtt-10"> </span><span
1594 class="ec-lmtt-10"> </span><span
1595 class="ec-lmtt-10"> j</span><span
1596 class="ec-lmtt-10"> [</span><span
1597 class="ec-lmtt-10"> ]</span><span
1598 class="ec-lmtt-10"> GNU/Linux</span><span
1599 class="ec-lmtt-10"> on</span><span
1600 class="ec-lmtt-10"> x86_64</span><span
1601 class="ec-lmtt-10"> with</span><span
1602 class="ec-lmtt-10"> musl</span><span
1603 class="ec-lmtt-10"> (x86_64-linuxmusl)</span>
1604 <a
1605 id="x1-22026r13"></a><span
1606 class="ec-lmtt-10"> </span><span
1607 class="ec-lmtt-10"> </span><span
1608 class="ec-lmtt-10"> k</span><span
1609 class="ec-lmtt-10"> [</span><span
1610 class="ec-lmtt-10"> ]</span><span
1611 class="ec-lmtt-10"> NetBSD</span><span
1612 class="ec-lmtt-10"> on</span><span
1613 class="ec-lmtt-10"> x86_64</span><span
1614 class="ec-lmtt-10"> (amd64-netbsd)</span>
1615 <a
1616 id="x1-22028r14"></a><span
1617 class="ec-lmtt-10"> </span><span
1618 class="ec-lmtt-10"> </span><span
1619 class="ec-lmtt-10"> l</span><span
1620 class="ec-lmtt-10"> [</span><span
1621 class="ec-lmtt-10"> ]</span><span
1622 class="ec-lmtt-10"> NetBSD</span><span
1623 class="ec-lmtt-10"> on</span><span
1624 class="ec-lmtt-10"> Intel</span><span
1625 class="ec-lmtt-10"> x86</span><span
1626 class="ec-lmtt-10"> (i386-netbsd)</span>
1627 <a
1628 id="x1-22030r15"></a><span
1629 class="ec-lmtt-10"> </span><span
1630 class="ec-lmtt-10"> </span><span
1631 class="ec-lmtt-10"> m</span><span
1632 class="ec-lmtt-10"> [</span><span
1633 class="ec-lmtt-10"> ]</span><span
1634 class="ec-lmtt-10"> Solaris</span><span
1635 class="ec-lmtt-10"> on</span><span
1636 class="ec-lmtt-10"> Intel</span><span
1637 class="ec-lmtt-10"> x86</span><span
1638 class="ec-lmtt-10"> (i386-solaris)</span>
1639 <a
1640 id="x1-22032r16"></a><span
1641 class="ec-lmtt-10"> </span><span
1642 class="ec-lmtt-10"> </span><span
1643 class="ec-lmtt-10"> o</span><span
1644 class="ec-lmtt-10"> [</span><span
1645 class="ec-lmtt-10"> ]</span><span
1646 class="ec-lmtt-10"> Solaris</span><span
1647 class="ec-lmtt-10"> on</span><span
1648 class="ec-lmtt-10"> x86_64</span><span
1649 class="ec-lmtt-10"> (x86_64-solaris)</span>
1650 <a
1651 id="x1-22034r17"></a><span
1652 class="ec-lmtt-10"> </span><span
1653 class="ec-lmtt-10"> </span><span
1654 class="ec-lmtt-10"> p</span><span
1655 class="ec-lmtt-10"> [</span><span
1656 class="ec-lmtt-10"> ]</span><span
1657 class="ec-lmtt-10"> Windows</span><span
1658 class="ec-lmtt-10"> (64-bit)</span><span
1659 class="ec-lmtt-10"> (windows)</span></pre>
1660 <figcaption class="caption" ><span class="id">Figure 5: </span><span
1661 class="content">Binaries menu</span></figcaption><!--tex4ht:label?: x1-22035r5 -->
1662
1663
1664 </figure>
1665 <!--l. 704--><p class="indent" > Figure <a
1666 href="#x1-22035r5">5<!--tex4ht:ref: fig:bin-text --></a> displays the text mode binaries menu. By default, only the binaries for your
1667 current platform will be installed. From this menu, you can select installation of binaries for
1668 other platforms as well. This can be useful if you are sharing a TeX tree across a network of
1669 heterogeneous machines, or for a dual-boot system.
1670
1671 </p>
1672 <h5 class="subsubsectionHead"><span class="titlemark">3.2.2 </span> <a
1673 id="x1-230003.2.2"></a>Selecting what is to be installed</h5>
1674 <figure class="figure">
1675
1676
1677
1678 <a
1679 id="x1-23027r6"></a>
1680
1681
1682 <pre class="fancyvrb" id="fancyvrb3"><a
1683 id="x1-23002r1"></a><span
1684 class="ec-lmtt-10">Select</span><span
1685 class="ec-lmtt-10"> scheme:</span>
1686 <a
1687 id="x1-23004r2"></a><span
1688 class="ec-lmtt-10">===============================================================================</span>
1689 <a
1690 id="x1-23006r3"></a><span
1691 class="ec-lmtt-10"> a</span><span
1692 class="ec-lmtt-10"> [X]</span><span
1693 class="ec-lmtt-10"> full</span><span
1694 class="ec-lmtt-10"> scheme</span><span
1695 class="ec-lmtt-10"> (everything)</span>
1696 <a
1697 id="x1-23008r4"></a><span
1698 class="ec-lmtt-10"> b</span><span
1699 class="ec-lmtt-10"> [</span><span
1700 class="ec-lmtt-10"> ]</span><span
1701 class="ec-lmtt-10"> medium</span><span
1702 class="ec-lmtt-10"> scheme</span><span
1703 class="ec-lmtt-10"> (small</span><span
1704 class="ec-lmtt-10"> +</span><span
1705 class="ec-lmtt-10"> more</span><span
1706 class="ec-lmtt-10"> packages</span><span
1707 class="ec-lmtt-10"> and</span><span
1708 class="ec-lmtt-10"> languages)</span>
1709 <a
1710 id="x1-23010r5"></a><span
1711 class="ec-lmtt-10"> c</span><span
1712 class="ec-lmtt-10"> [</span><span
1713 class="ec-lmtt-10"> ]</span><span
1714 class="ec-lmtt-10"> small</span><span
1715 class="ec-lmtt-10"> scheme</span><span
1716 class="ec-lmtt-10"> (basic</span><span
1717 class="ec-lmtt-10"> +</span><span
1718 class="ec-lmtt-10"> xetex,</span><span
1719 class="ec-lmtt-10"> metapost,</span><span
1720 class="ec-lmtt-10"> a</span><span
1721 class="ec-lmtt-10"> few</span><span
1722 class="ec-lmtt-10"> languages)</span>
1723 <a
1724 id="x1-23012r6"></a><span
1725 class="ec-lmtt-10"> d</span><span
1726 class="ec-lmtt-10"> [</span><span
1727 class="ec-lmtt-10"> ]</span><span
1728 class="ec-lmtt-10"> basic</span><span
1729 class="ec-lmtt-10"> scheme</span><span
1730 class="ec-lmtt-10"> (plain</span><span
1731 class="ec-lmtt-10"> and</span><span
1732 class="ec-lmtt-10"> latex)</span>
1733 <a
1734 id="x1-23014r7"></a><span
1735 class="ec-lmtt-10"> e</span><span
1736 class="ec-lmtt-10"> [</span><span
1737 class="ec-lmtt-10"> ]</span><span
1738 class="ec-lmtt-10"> minimal</span><span
1739 class="ec-lmtt-10"> scheme</span><span
1740 class="ec-lmtt-10"> (plain</span><span
1741 class="ec-lmtt-10"> only)</span>
1742 <a
1743 id="x1-23016r8"></a><span
1744 class="ec-lmtt-10"> f</span><span
1745 class="ec-lmtt-10"> [</span><span
1746 class="ec-lmtt-10"> ]</span><span
1747 class="ec-lmtt-10"> infrastructure-only</span><span
1748 class="ec-lmtt-10"> scheme</span><span
1749 class="ec-lmtt-10"> (no</span><span
1750 class="ec-lmtt-10"> TeX</span><span
1751 class="ec-lmtt-10"> at</span><span
1752 class="ec-lmtt-10"> all)</span>
1753 <a
1754 id="x1-23018r9"></a><span
1755 class="ec-lmtt-10"> g</span><span
1756 class="ec-lmtt-10"> [</span><span
1757 class="ec-lmtt-10"> ]</span><span
1758 class="ec-lmtt-10"> book</span><span
1759 class="ec-lmtt-10"> publishing</span><span
1760 class="ec-lmtt-10"> scheme</span><span
1761 class="ec-lmtt-10"> (core</span><span
1762 class="ec-lmtt-10"> LaTeX</span><span
1763 class="ec-lmtt-10"> and</span><span
1764 class="ec-lmtt-10"> add-ons)</span>
1765 <a
1766 id="x1-23020r10"></a><span
1767 class="ec-lmtt-10"> h</span><span
1768 class="ec-lmtt-10"> [</span><span
1769 class="ec-lmtt-10"> ]</span><span
1770 class="ec-lmtt-10"> ConTeXt</span><span
1771 class="ec-lmtt-10"> scheme</span>
1772 <a
1773 id="x1-23022r11"></a><span
1774 class="ec-lmtt-10"> i</span><span
1775 class="ec-lmtt-10"> [</span><span
1776 class="ec-lmtt-10"> ]</span><span
1777 class="ec-lmtt-10"> GUST</span><span
1778 class="ec-lmtt-10"> TeX</span><span
1779 class="ec-lmtt-10"> Live</span><span
1780 class="ec-lmtt-10"> scheme</span>
1781 <a
1782 id="x1-23024r12"></a><span
1783 class="ec-lmtt-10"> j</span><span
1784 class="ec-lmtt-10"> [</span><span
1785 class="ec-lmtt-10"> ]</span><span
1786 class="ec-lmtt-10"> teTeX</span><span
1787 class="ec-lmtt-10"> scheme</span><span
1788 class="ec-lmtt-10"> (more</span><span
1789 class="ec-lmtt-10"> than</span><span
1790 class="ec-lmtt-10"> medium,</span><span
1791 class="ec-lmtt-10"> but</span><span
1792 class="ec-lmtt-10"> nowhere</span><span
1793 class="ec-lmtt-10"> near</span><span
1794 class="ec-lmtt-10"> full)</span>
1795 <a
1796 id="x1-23026r13"></a><span
1797 class="ec-lmtt-10"> k</span><span
1798 class="ec-lmtt-10"> [</span><span
1799 class="ec-lmtt-10"> ]</span><span
1800 class="ec-lmtt-10"> custom</span><span
1801 class="ec-lmtt-10"> selection</span><span
1802 class="ec-lmtt-10"> of</span><span
1803 class="ec-lmtt-10"> collections</span></pre>
1804 <figcaption class="caption" ><span class="id">Figure 6: </span><span
1805 class="content">Scheme menu</span></figcaption><!--tex4ht:label?: x1-23027r6 -->
1806
1807
1808 </figure>
1809 <!--l. 734--><p class="indent" > Figure <a
1810 href="#x1-23027r6">6<!--tex4ht:ref: fig:scheme-text --></a> displays the TeX Live scheme menu; from here, you choose a “scheme”,
1811 which is an overall set of packages and collections. The default <span
1812 class="ec-lmtt-12">full </span>scheme installs
1813 everything available. This is recommended, but you can also choose the <span
1814 class="ec-lmtt-12">basic </span>scheme for
1815 just plain and LaTeX, <span
1816 class="ec-lmtt-12">small </span>for a few more programs (equivalent to the so-called
1817 BasicTeX installation of MacTeX), <span
1818 class="ec-lmtt-12">minimal </span>for testing purposes, and <span
1819 class="ec-lmtt-12">medium </span>or <span
1820 class="ec-lmtt-12">teTeX </span>to
1821 get something in between. There are also various specialized and country-specific
1822 schemes.
1823 </p>
1824 <figure class="figure">
1825
1826
1827
1828 <a
1829 id="x1-23028r7"></a>
1830
1831
1832 <!--l. 746--><p class="noindent" ><img
1833 src="../texlive-common/stdcoll.png" alt="Collections menu"
1834 />
1835 </p>
1836 <figcaption class="caption" ><span class="id">Figure 7: </span><span
1837 class="content">Collections menu</span></figcaption><!--tex4ht:label?: x1-23028r7 -->
1838
1839
1840 </figure>
1841 <!--l. 750--><p class="indent" > You can refine your scheme selection with the ‘collections’ menu (figure <a
1842 href="#x1-23028r7">7<!--tex4ht:ref: fig:collections-gui --></a>, shown in
1843 GUI mode for a change).
1844 </p><!--l. 753--><p class="indent" > Collections are one level more detailed than schemes — in essence, a scheme consists of
1845 several collections, a collection consists of one or more packages, and a package (the lowest
1846 level grouping in TeX Live) contains the actual TeX macro files, font files, and so
1847 on.
1848 </p><!--l. 758--><p class="indent" > If you want more control than the collection menus provide, you can use the TeX
1849 Live Manager (<span
1850 class="ec-lmss-12">tlmgr</span>) program after installation (see section <a
1851 href="#x1-420005">5<!--tex4ht:ref: sec:tlmgr --></a>); using that, you can control
1852 the installation at the package level.
1853
1854 </p>
1855 <h5 class="subsubsectionHead"><span class="titlemark">3.2.3 </span> <a
1856 id="x1-240003.2.3"></a>Directories</h5>
1857 <!--l. 766--><p class="noindent" >The default layout is described in section <a
1858 href="#x1-100002.2">2.2<!--tex4ht:ref: sec:texmftrees --></a>, p. <a
1859 href="#x1-100002.2">10<!--tex4ht:ref: sec:texmftrees --></a>. The default installation directory is
1860 <span
1861 class="ec-lmtt-12">/usr/local/texlive/2026 </span>on Unix and <span class="obeylines-h"><code class="verb">C:\texlive\2026</code></span> on Windows. This arrangement
1862 enables having many parallel TeX Live installations, such as one for each release (typically by
1863 year, as here), and you can switch between them merely by altering your search
1864 path.
1865 </p><!--l. 774--><p class="indent" > That installation directory can be overridden by setting the so-called <span
1866 class="ec-lmtt-12">TEXDIR </span>in the
1867 installer. The GUI screen for this and other options is shown in figure <a
1868 href="#x1-17063r4">4<!--tex4ht:ref: fig:advanced-lnx --></a>. The most common
1869 reasons to change it are either lacking enough disk space in that partition (the full TeX
1870 Live needs several gigabytes), or lacking write permission for the default location (you don’t
1871 have to be root or administrator to install TeX Live, but you do need write access to the
1872 target directory).
1873 </p><!--l. 782--><p class="indent" > On Windows, you normally do not need to be an administrator to create <span class="obeylines-h"><code class="verb">C:\texlive\2026</code></span>
1874 (or, more generally, <span class="obeylines-h"><code class="verb">%SystemDrive%\texlive\2026</code></span>).
1875 </p><!--l. 786--><p class="indent" > The installation directories can also be changed by setting a variety of environment
1876 variables before running the installer (most likely, <span
1877 class="ec-lmtt-12">TEXLIVE_INSTALL_PREFIX </span>or
1878 <span
1879 class="ec-lmtt-12">TEXLIVE_INSTALL_TEXDIR</span>); see the documentation from <span class="obeylines-h"><code class="verb">install-tl --help</code></span> (available online
1880 at <a
1881 href="https://tug.org/texlive/doc/install-tl.html" class="url" ><span
1882 class="ec-lmtt-12">https://tug.org/texlive/doc/install-tl.html</span></a>) for the full list and more
1883 details.
1884 </p><!--l. 794--><p class="indent" > A reasonable alternative destination is a directory under your home, especially if you will
1885 be the sole user. Use ‘<span class="obeylines-h"><code class="verb">~</code></span>’ to indicate this, as in ‘<span class="obeylines-h"><code class="verb">~/texlive/2026</code></span>’.
1886 </p><!--l. 798--><p class="indent" > But do not use your home directory on Windows if the name of your home or ‘userprofile’
1887 contains non-ASCII characters. We are looking into possible solutions, but cannot promise
1888 anything at this point. See also <a
1889 href="https://tug.org/texlive/windows.html\#nonascii" class="url" ><span
1890 class="ec-lmtt-12">https://tug.org/texlive/windows.html\#nonascii</span></a>.
1891 </p><!--l. 803--><p class="indent" > We recommend including the year in the name, to enable keeping different releases of TeX
1892 Live side by side. (You may wish to also maintain a version-independent name, such as
1893 <span
1894 class="ec-lmtt-12">/usr/local/texlive-cur</span>, via a symbolic link, which you can then repoint after testing the
1895 new release.)
1896 </p><!--l. 808--><p class="indent" > Changing <span
1897 class="ec-lmtt-12">TEXDIR </span>in the installer will also change <span
1898 class="ec-lmtt-12">TEXMFLOCAL</span>, <span
1899 class="ec-lmtt-12">TEXMFSYSVAR </span>and
1900 <span
1901 class="ec-lmtt-12">TEXMFSYSCONFIG</span>.
1902 </p><!--l. 812--><p class="indent" > <span
1903 class="ec-lmtt-12">TEXMFHOME </span>is the recommended location for personal macro files or packages. The default
1904 value is <span class="obeylines-h"><code class="verb">~/texmf</code></span> (<span class="obeylines-h"><code class="verb">~/Library/texmf</code></span> on Macs). In contrast to <span
1905 class="ec-lmtt-12">TEXDIR</span>, here a <span class="obeylines-h"><code class="verb">~</code></span> is preserved in
1906
1907
1908 the newly-written configuration files, since it usefully refers to the home directory of the user
1909 running TeX. It expands to <span
1910 class="ec-lmtt-12">$HOME </span>on Unix and <span class="obeylines-h"><code class="verb">%USERPROFILE%</code></span> on Windows. Special
1911 redundant note: <span
1912 class="ec-lmtt-12">TEXMFHOME</span>, like all trees, must be organized according to the TDS, or files
1913 may not be found.
1914 </p><!--l. 821--><p class="indent" > <span
1915 class="ec-lmtt-12">TEXMFVAR </span>is the location for storing most cached runtime data specific to each user.
1916 <span
1917 class="ec-lmtt-12">TEXMFCACHE </span>is the variable name used for that purpose by LuaLaTeX and ConTeXt MkIV
1918 (see section <a
1919 href="#x1-330003.4.5">3.4.5<!--tex4ht:ref: sec:context --></a>, p. <a
1920 href="#x1-330003.4.5">48<!--tex4ht:ref: sec:context --></a>); its default value is <span
1921 class="ec-lmtt-12">TEXMFSYSVAR</span>, or (if that’s not writable),
1922 <span
1923 class="ec-lmtt-12">TEXMFVAR</span>.
1924
1925 </p>
1926 <h5 class="subsubsectionHead"><span class="titlemark">3.2.4 </span> <a
1927 id="x1-250003.2.4"></a>Options</h5>
1928 <figure class="figure">
1929
1930
1931
1932 <a
1933 id="x1-25025r8"></a>
1934
1935
1936 <pre class="fancyvrb" id="fancyvrb4"><a
1937 id="x1-25002r1"></a><span
1938 class="ec-lmtt-10">Options</span><span
1939 class="ec-lmtt-10"> customization:</span>
1940 <a
1941 id="x1-25004r2"></a><span
1942 class="ec-lmtt-10">===============================================================================</span>
1943 <a
1944 id="x1-25006r3"></a><span
1945 class="ec-lmtt-10"> &#x003C;P&#x003E;</span><span
1946 class="ec-lmtt-10"> use</span><span
1947 class="ec-lmtt-10"> letter</span><span
1948 class="ec-lmtt-10"> size</span><span
1949 class="ec-lmtt-10"> instead</span><span
1950 class="ec-lmtt-10"> of</span><span
1951 class="ec-lmtt-10"> A4</span><span
1952 class="ec-lmtt-10"> by</span><span
1953 class="ec-lmtt-10"> default:</span><span
1954 class="ec-lmtt-10"> [</span><span
1955 class="ec-lmtt-10"> ]</span>
1956 <a
1957 id="x1-25008r4"></a><span
1958 class="ec-lmtt-10"> &#x003C;E&#x003E;</span><span
1959 class="ec-lmtt-10"> execution</span><span
1960 class="ec-lmtt-10"> of</span><span
1961 class="ec-lmtt-10"> restricted</span><span
1962 class="ec-lmtt-10"> list</span><span
1963 class="ec-lmtt-10"> of</span><span
1964 class="ec-lmtt-10"> programs:</span><span
1965 class="ec-lmtt-10"> [X]</span>
1966 <a
1967 id="x1-25010r5"></a><span
1968 class="ec-lmtt-10"> &#x003C;F&#x003E;</span><span
1969 class="ec-lmtt-10"> create</span><span
1970 class="ec-lmtt-10"> all</span><span
1971 class="ec-lmtt-10"> format</span><span
1972 class="ec-lmtt-10"> files:</span><span
1973 class="ec-lmtt-10"> </span><span
1974 class="ec-lmtt-10"> </span><span
1975 class="ec-lmtt-10"> </span><span
1976 class="ec-lmtt-10"> </span><span
1977 class="ec-lmtt-10"> </span><span
1978 class="ec-lmtt-10"> </span><span
1979 class="ec-lmtt-10"> </span><span
1980 class="ec-lmtt-10"> </span><span
1981 class="ec-lmtt-10"> </span><span
1982 class="ec-lmtt-10"> </span><span
1983 class="ec-lmtt-10"> </span><span
1984 class="ec-lmtt-10"> </span><span
1985 class="ec-lmtt-10"> </span><span
1986 class="ec-lmtt-10"> </span><span
1987 class="ec-lmtt-10"> </span><span
1988 class="ec-lmtt-10"> </span><span
1989 class="ec-lmtt-10"> </span><span
1990 class="ec-lmtt-10"> [X]</span>
1991 <a
1992 id="x1-25012r6"></a><span
1993 class="ec-lmtt-10"> &#x003C;D&#x003E;</span><span
1994 class="ec-lmtt-10"> install</span><span
1995 class="ec-lmtt-10"> font/macro</span><span
1996 class="ec-lmtt-10"> doc</span><span
1997 class="ec-lmtt-10"> tree:</span><span
1998 class="ec-lmtt-10"> </span><span
1999 class="ec-lmtt-10"> </span><span
2000 class="ec-lmtt-10"> </span><span
2001 class="ec-lmtt-10"> </span><span
2002 class="ec-lmtt-10"> </span><span
2003 class="ec-lmtt-10"> </span><span
2004 class="ec-lmtt-10"> </span><span
2005 class="ec-lmtt-10"> </span><span
2006 class="ec-lmtt-10"> </span><span
2007 class="ec-lmtt-10"> </span><span
2008 class="ec-lmtt-10"> </span><span
2009 class="ec-lmtt-10"> </span><span
2010 class="ec-lmtt-10"> </span><span
2011 class="ec-lmtt-10"> [X]</span>
2012 <a
2013 id="x1-25014r7"></a><span
2014 class="ec-lmtt-10"> &#x003C;S&#x003E;</span><span
2015 class="ec-lmtt-10"> install</span><span
2016 class="ec-lmtt-10"> font/macro</span><span
2017 class="ec-lmtt-10"> source</span><span
2018 class="ec-lmtt-10"> tree:</span><span
2019 class="ec-lmtt-10"> </span><span
2020 class="ec-lmtt-10"> </span><span
2021 class="ec-lmtt-10"> </span><span
2022 class="ec-lmtt-10"> </span><span
2023 class="ec-lmtt-10"> </span><span
2024 class="ec-lmtt-10"> </span><span
2025 class="ec-lmtt-10"> </span><span
2026 class="ec-lmtt-10"> </span><span
2027 class="ec-lmtt-10"> </span><span
2028 class="ec-lmtt-10"> </span><span
2029 class="ec-lmtt-10"> [X]</span>
2030 <a
2031 id="x1-25016r8"></a><span
2032 class="ec-lmtt-10"> &#x003C;L&#x003E;</span><span
2033 class="ec-lmtt-10"> create</span><span
2034 class="ec-lmtt-10"> symlinks</span><span
2035 class="ec-lmtt-10"> in</span><span
2036 class="ec-lmtt-10"> standard</span><span
2037 class="ec-lmtt-10"> directories:</span><span
2038 class="ec-lmtt-10"> </span><span
2039 class="ec-lmtt-10"> [</span><span
2040 class="ec-lmtt-10"> ]</span>
2041 <a
2042 id="x1-25018r9"></a><span
2043 class="ec-lmtt-10"> </span><span
2044 class="ec-lmtt-10"> </span><span
2045 class="ec-lmtt-10"> </span><span
2046 class="ec-lmtt-10"> </span><span
2047 class="ec-lmtt-10"> </span><span
2048 class="ec-lmtt-10"> </span><span
2049 class="ec-lmtt-10"> </span><span
2050 class="ec-lmtt-10"> </span><span
2051 class="ec-lmtt-10"> </span><span
2052 class="ec-lmtt-10"> </span><span
2053 class="ec-lmtt-10"> </span><span
2054 class="ec-lmtt-10"> binaries</span><span
2055 class="ec-lmtt-10"> to:</span>
2056 <a
2057 id="x1-25020r10"></a><span
2058 class="ec-lmtt-10"> </span><span
2059 class="ec-lmtt-10"> </span><span
2060 class="ec-lmtt-10"> </span><span
2061 class="ec-lmtt-10"> </span><span
2062 class="ec-lmtt-10"> </span><span
2063 class="ec-lmtt-10"> </span><span
2064 class="ec-lmtt-10"> </span><span
2065 class="ec-lmtt-10"> </span><span
2066 class="ec-lmtt-10"> </span><span
2067 class="ec-lmtt-10"> </span><span
2068 class="ec-lmtt-10"> </span><span
2069 class="ec-lmtt-10"> manpages</span><span
2070 class="ec-lmtt-10"> to:</span>
2071 <a
2072 id="x1-25022r11"></a><span
2073 class="ec-lmtt-10"> </span><span
2074 class="ec-lmtt-10"> </span><span
2075 class="ec-lmtt-10"> </span><span
2076 class="ec-lmtt-10"> </span><span
2077 class="ec-lmtt-10"> </span><span
2078 class="ec-lmtt-10"> </span><span
2079 class="ec-lmtt-10"> </span><span
2080 class="ec-lmtt-10"> </span><span
2081 class="ec-lmtt-10"> </span><span
2082 class="ec-lmtt-10"> </span><span
2083 class="ec-lmtt-10"> </span><span
2084 class="ec-lmtt-10"> </span><span
2085 class="ec-lmtt-10"> </span><span
2086 class="ec-lmtt-10"> </span><span
2087 class="ec-lmtt-10"> </span><span
2088 class="ec-lmtt-10"> info</span><span
2089 class="ec-lmtt-10"> to:</span>
2090 <a
2091 id="x1-25024r12"></a><span
2092 class="ec-lmtt-10"> &#x003C;Y&#x003E;</span><span
2093 class="ec-lmtt-10"> after</span><span
2094 class="ec-lmtt-10"> install,</span><span
2095 class="ec-lmtt-10"> set</span><span
2096 class="ec-lmtt-10"> CTAN</span><span
2097 class="ec-lmtt-10"> as</span><span
2098 class="ec-lmtt-10"> source</span><span
2099 class="ec-lmtt-10"> for</span><span
2100 class="ec-lmtt-10"> package</span><span
2101 class="ec-lmtt-10"> updates:</span><span
2102 class="ec-lmtt-10"> [X]</span></pre>
2103 <figcaption class="caption" ><span class="id">Figure 8: </span><span
2104 class="content">Options menu (Unix)</span></figcaption><!--tex4ht:label?: x1-25025r8 -->
2105
2106
2107 </figure>
2108 <!--l. 851--><p class="indent" > Figure <a
2109 href="#x1-25025r8">8<!--tex4ht:ref: fig:options-text --></a> shows the text mode options menu. More info on each:
2110 </p><dl class="description"><dt class="description"><a
2111 id="x1-25026x3.2.4"></a>
2112 <span
2113 class="ec-lmbx-12">use letter size instead of A4 by default:</span> </dt><dd
2114 class="description">
2115 <!--l. 855--><p class="noindent" >The default paper size selection. Of course, individual documents can and should
2116 specify a specific paper size, if desired.
2117 </p></dd><dt class="description"><a
2118 id="x1-25027x3.2.4"></a>
2119 <span
2120 class="ec-lmbx-12">execution of restricted list of programs:</span> </dt><dd
2121 class="description">
2122 <!--l. 859--><p class="noindent" >As of TeX Live 2010, execution of a few external programs is allowed by default.
2123 The (very short) list of allowed programs is given in the <span
2124 class="ec-lmtt-12">texmf.cnf</span>. See the 2010
2125 news (section <a
2126 href="#x1-780009.1.7">9.1.7<!--tex4ht:ref: sec:2010news --></a>) for more details.
2127 </p></dd><dt class="description"><a
2128 id="x1-25028x3.2.4"></a>
2129 <span
2130 class="ec-lmbx-12">create all format files:</span> </dt><dd
2131 class="description">
2132 <!--l. 864--><p class="noindent" >We recommend leaving this option checked, to avoid unnecessary problems when
2133 creating formats dynamically. See the <span
2134 class="ec-lmss-12">fmtutil </span>documentation for more details.
2135 </p></dd><dt class="description"><a
2136 id="x1-25029x3.2.4"></a>
2137 <span
2138 class="ec-lmbx-12">install font/macro </span><span
2139 class="ec-lmbx-12">…</span><span
2140 class="ec-lmbx-12"> tree:</span> </dt><dd
2141 class="description">
2142 <!--l. 868--><p class="noindent" >Download/install the documentation and source files included in most packages.
2143 Unchecking is not recommended.
2144 </p></dd><dt class="description"><a
2145 id="x1-25030x3.2.4"></a>
2146 <span
2147 class="ec-lmbx-12">create symlinks in standard directories:</span> </dt><dd
2148 class="description">
2149 <!--l. 872--><p class="noindent" >This option (Unix only) bypasses the need to change environment variables.
2150 Without this option, TeX Live directories usually have to be added to <span
2151 class="ec-lmtt-12">PATH</span>,
2152 <span
2153 class="ec-lmtt-12">MANPATH </span>and <span
2154 class="ec-lmtt-12">INFOPATH</span>. You will need write permissions to the target directories.
2155 This option is intended for accessing the TeX system through directories that are
2156 already known to users, such as <span
2157 class="ec-lmtt-12">/usr/local/bin</span>, which don’t already contain any
2158 TeX files. Do not overwrite existing files on your system with this option, e.g., by
2159 specifying system directories. The safest and recommended approach is to leave
2160 the option unchecked.
2161 </p></dd><dt class="description"><a
2162 id="x1-25031x3.2.4"></a>
2163 <span
2164 class="ec-lmbx-12">after install, set CTAN as source for package updates:</span> </dt><dd
2165 class="description">
2166 <!--l. 883--><p class="noindent" >When installing from a DVD or ISO image, this option is enabled by default, since
2167 usually one wants to take any subsequent package updates from the CTAN area
2168 that is updated throughout the year. The only likely reason to disable it is if you
2169 install only a subset from the DVD and plan to augment the installation later. In
2170 any case, the package repository for the installer, and for updates after installation,
2171 can be set independently as needed; see section <a
2172 href="#x1-270003.3.1">3.3.1<!--tex4ht:ref: sec:location --></a> and section <a
2173 href="#x1-310003.4.3">3.4.3<!--tex4ht:ref: sec:dvd-install-net-updates --></a>.</p></dd></dl>
2174 <!--l. 894--><p class="noindent" >Windows-specific options, as displayed in the advanced GUI interface:
2175 </p><dl class="description"><dt class="description"><a
2176 id="x1-25032x3.2.4"></a>
2177 <span
2178 class="ec-lmbx-12">adjust searchpath</span> </dt><dd
2179 class="description">
2180 <!--l. 897--><p class="noindent" >This ensures that all programs will see the TeX Live binary directory on their
2181 search path.
2182 </p></dd><dt class="description"><a
2183 id="x1-25033x3.2.4"></a>
2184 <span
2185 class="ec-lmbx-12">add menu shortcuts</span> </dt><dd
2186 class="description">
2187 <!--l. 900--><p class="noindent" >If set, there will be a TeX Live submenu of the Start menu. There is a third
2188 option ‘Launcher entry’ besides ‘TeX Live menu’ and ‘No shortcuts’. This option
2189
2190
2191 is described in section <a
2192 href="#x1-400004.1">4.1<!--tex4ht:ref: sec:sharedinstall --></a>.
2193 </p></dd><dt class="description"><a
2194 id="x1-25034x3.2.4"></a>
2195 <span
2196 class="ec-lmbx-12">File associations</span> </dt><dd
2197 class="description">
2198 <!--l. 905--><p class="noindent" >The options are ‘Only new’ (create file associations, but do not overwrite existing
2199 ones), ‘All’ and ‘None’.
2200 </p></dd><dt class="description"><a
2201 id="x1-25035x3.2.4"></a>
2202 <span
2203 class="ec-lmbx-12">install TeXworks front end</span> </dt><dd
2204 class="description">
2205 <!--l. 909--><p class="noindent" ></p></dd></dl>
2206 <!--l. 911--><p class="noindent" >When all the settings are to your liking, you can type ‘I’ in the text interface, or press the ‘Install’
2207 button in the GUI, to start the installation process. When it is done, skip to section <a
2208 href="#x1-280003.4">3.4<!--tex4ht:ref: sec:postinstall --></a> to
2209 read what else needs to be done, if anything.
2210
2211 </p>
2212 <h4 class="subsectionHead"><span class="titlemark">3.3 </span> <a
2213 id="x1-260003.3"></a>Command-line install-tl options</h4>
2214 <!--l. 920--><p class="noindent" >Type </p><div class="alltt">
2215
2216 <div class="obeylines-v">
2217 <br /><span
2218 class="ec-lmtt-12">&#x003E;</span><span
2219 class="ec-lmtt-12"> </span><span
2220 class="ec-lmtk-10x-x-120">install-tl</span><span
2221 class="ec-lmtk-10x-x-120"> -help</span>
2222 </div>
2223 </div> for a listing of command-line options. Either <span class="obeylines-h"><code class="verb">-</code></span> or <span class="obeylines-h"><code class="verb">--</code></span> can be used to introduce option names.
2224 These are the most common ones:
2225 <!--l. 927--><p class="noindent" >
2226 </p><dl class="list1"><dt class="list">
2227 <span
2228 class="ec-lmtt-12">-gui</span> </dt><dd
2229 class="list">
2230 <!--l. 928--><p class="noindent" >Use the GUI installer if possible. This requires Tcl/Tk version 8.5 or higher.
2231 This was distributed with older macOS; for Big Sur and later, you’ll need to
2232 install Tcl/Tk yourself, if you don’t choose to use the MacTeX installer. Tcl/Tk
2233 is distributed with TeX Live on Windows. The legacy options <span
2234 class="ec-lmtt-12">-gui=perltk </span>and
2235 <span
2236 class="ec-lmtt-12">-gui=wizard </span>are still available but invoke the same GUI interface; if Tcl/Tk is not
2237 available, installation continues in text mode.
2238 </p></dd><dt class="list">
2239 <span
2240 class="ec-lmtt-12">-no-gui</span> </dt><dd
2241 class="list">
2242 <!--l. 937--><p class="noindent" >Force using the text mode installer.
2243 </p></dd><dt class="list">
2244 <span
2245 class="ec-lmtt-12">-lang </span><span
2246 class="ec-lmro-12">LL</span> </dt><dd
2247 class="list">
2248 <!--l. 939--><p class="noindent" >Specify the installer interface language as a standard (usually two-letter) code.
2249 The installer tries to automatically determine the right language but if it fails,
2250 or if the right language is not available, then it uses English as a fallback. Run
2251 <span class="obeylines-h"><code class="verb">install-tl --help</code></span> to get the list of available languages.
2252 </p></dd><dt class="list">
2253 <span
2254 class="ec-lmtt-12">-portable</span> </dt><dd
2255 class="list">
2256 <!--l. 946--><p class="noindent" >Install for portable use on, e.g., a USB stick. Also selectable from within the text
2257 installer with the <span
2258 class="ec-lmtt-12">V </span>command, and from the GUI installer. See section <a
2259 href="#x1-410004.2">4.2<!--tex4ht:ref: sec:portable-tl --></a>.
2260
2261
2262 </p></dd><dt class="list">
2263 <span
2264 class="ec-lmtt-12">-profile </span><span
2265 class="ec-lmro-12">file</span> </dt><dd
2266 class="list">
2267 <!--l. 951--><p class="noindent" >Load the installation profile <span
2268 class="ec-lmro-12">file </span>and do the installation with no user interaction.
2269 The installer always writes a file <span
2270 class="ec-lmtt-12">texlive.profile </span>to the <span
2271 class="ec-lmtt-12">tlpkg </span>subdirectory of
2272 your installation. That file can be given as the argument to redo the exact same
2273 installation on a different system, for example. Alternatively, you can use a custom
2274 profile, most easily created by starting from a generated one and changing values,
2275 or an empty file, which will take all the defaults.
2276 </p></dd><dt class="list">
2277 <span
2278 class="ec-lmtt-12">-repository </span><span
2279 class="ec-lmro-12">url-or-directory</span> </dt><dd
2280 class="list">
2281 <!--l. 960--><p class="noindent" >Specify package repository from which to install; see following.
2282 </p><!--l. 963--><p class="noindent" ><a id="opt-in-place"></a>
2283 </p></dd><dt class="list">
2284 <span
2285 class="ec-lmtt-12">-in-place</span> </dt><dd
2286 class="list">
2287 <!--l. 964--><p class="noindent" >(Documented only for completeness: Do not use this unless you know what
2288 you are doing.) If you already have an rsync, svn, or other copy of TeX Live
2289 (see <a
2290 href="https://tug.org/texlive/acquire-mirror.html" class="url" ><span
2291 class="ec-lmtt-12">https://tug.org/texlive/acquire-mirror.html</span></a>) then this option will
2292 use what you’ve got, as-is, and do only the necessary post-install actions. Be
2293 warned that the file <span
2294 class="ec-lmtt-12">tlpkg/texlive.tlpdb </span>may be overwritten; saving it is your
2295 responsibility. Also, package removal has to be done manually. This option cannot
2296 be toggled via the installer interface.</p></dd></dl>
2297
2298 <h5 class="subsubsectionHead"><span class="titlemark">3.3.1 </span> <a
2299 id="x1-270003.3.1"></a>The <span
2300 class="ec-lmtt-12">-repository </span>option</h5>
2301 <!--l. 979--><p class="noindent" >The default network package repository is a CTAN mirror chosen automatically via
2302 <a
2303 href="https://mirror.ctan.org" class="url" ><span
2304 class="ec-lmtt-12">https://mirror.ctan.org</span></a>.
2305 </p><!--l. 982--><p class="indent" > If you want to override that, the location value can be a url starting with <span
2306 class="ec-lmtt-12">ftp:</span>,
2307 <span
2308 class="ec-lmtt-12">http:</span>, <span
2309 class="ec-lmtt-12">https:</span>, <span
2310 class="ec-lmtt-12">file:/</span>, or a plain directory path. (When giving an <span
2311 class="ec-lmtt-12">http:</span>, <span
2312 class="ec-lmtt-12">https:</span>
2313 or <span
2314 class="ec-lmtt-12">ftp:</span> location, trailing ‘<span
2315 class="ec-lmtt-12">/</span>’ characters and/or a trailing ‘<span
2316 class="ec-lmtt-12">/tlpkg</span>’ component are
2317 ignored.)
2318 </p><!--l. 989--><p class="indent" > For example, you could choose a particular CTAN mirror with something like:
2319 <a
2320 href="http://ctan.example.org/tex-archive/systems/texlive/tlnet/" class="url" ><span
2321 class="ec-lmtt-12">http://ctan.example.org/tex-archive/systems/texlive/tlnet/</span></a>, substituting a real
2322 hostname and its particular top-level CTAN path for <span class="obeylines-h"><code class="verb">ctan.example.org/tex-archive</code></span>. The
2323 list of CTAN mirrors is maintained at <a
2324 href="https://ctan.org/mirrors" class="url" ><span
2325 class="ec-lmtt-12">https://ctan.org/mirrors</span></a>.
2326 </p><!--l. 995--><p class="indent" > If the given argument is local (either a path or a <span
2327 class="ec-lmtt-12">file:/ </span>url), compressed files in an
2328 <span
2329 class="ec-lmtt-12">archive </span>subdirectory of the repository path are used (even if uncompressed files are available
2330 as well).
2331 </p><!--l. 999--><p class="indent" > <a id="postinstall"></a>
2332 </p>
2333 <h4 class="subsectionHead"><span class="titlemark">3.4 </span> <a
2334 id="x1-280003.4"></a>Post-install actions</h4>
2335 <!--l. 1003--><p class="noindent" >Some post-installation may be required.
2336
2337
2338
2339 </p>
2340 <h5 class="subsubsectionHead"><span class="titlemark">3.4.1 </span> <a
2341 id="x1-290003.4.1"></a>Environment variables for Unix</h5>
2342 <!--l. 1008--><p class="noindent" >If you elected to create symlinks in standard directories (described in section <a
2343 href="#x1-250003.2.4">3.2.4<!--tex4ht:ref: sec:options --></a>), then there
2344 is no need to edit environment variables. Otherwise, on Unix systems, the directory of the
2345 binaries for your platform must be added to the search path. (On Windows, the installer takes
2346 care of this.)
2347 </p><!--l. 1014--><p class="indent" > Each supported platform has its own subdirectory under <span
2348 class="ec-lmtt-12">TEXDIR/bin</span>. See figure <a
2349 href="#x1-22035r5">5<!--tex4ht:ref: fig:bin-text --></a> for the
2350 list of subdirectories and corresponding platforms.
2351 </p><!--l. 1018--><p class="indent" > Optionally, you can also add the documentation man and Info directories to their
2352 respective search paths, if you want the system tools to find them. The man pages might be
2353 found automatically after the addition to <span
2354 class="ec-lmtt-12">PATH</span>.
2355 </p><!--l. 1023--><p class="indent" > For Bourne-compatible shells such as <span
2356 class="ec-lmss-12">bash</span>, and using Intel x86 GNU/Linux and the TeX
2357 Live default directory setup as an example, the file to edit might be <span
2358 class="ec-lmtt-12">$HOME/.profile </span>(or
2359 another file sourced by <span
2360 class="ec-lmtt-12">.profile</span>), and the lines to add would look like this:
2361 </p><!--l. 1028--><p class="indent" >
2362 </p>
2363 <pre class="fancyvrb" id="fancyvrb5"><a
2364 id="x1-29002r1"></a><span
2365 class="ec-lmtt-10x-x-109">PATH=/usr/local/texlive/2026/bin/x86_64-linux:$PATH;</span><span
2366 class="ec-lmtt-10x-x-109"> export</span><span
2367 class="ec-lmtt-10x-x-109"> PATH</span>
2368 <a
2369 id="x1-29004r2"></a><span
2370 class="ec-lmtt-10x-x-109">MANPATH=/usr/local/texlive/2026/texmf-dist/doc/man:$MANPATH;</span><span
2371 class="ec-lmtt-10x-x-109"> export</span><span
2372 class="ec-lmtt-10x-x-109"> MANPATH</span>
2373 <a
2374 id="x1-29006r3"></a><span
2375 class="ec-lmtt-10x-x-109">INFOPATH=/usr/local/texlive/2026/texmf-dist/doc/info:$INFOPATH;</span><span
2376 class="ec-lmtt-10x-x-109"> export</span><span
2377 class="ec-lmtt-10x-x-109"> INFOPATH</span></pre>
2378 <!--l. 1034--><p class="indent" > For csh or tcsh, the file to edit is typically <span
2379 class="ec-lmtt-12">$HOME/.cshrc</span>, and the lines to add might look
2380 like:
2381 </p><!--l. 1037--><p class="indent" >
2382 </p>
2383 <pre class="fancyvrb" id="fancyvrb6"><a
2384 id="x1-29008r1"></a><span
2385 class="ec-lmtt-10x-x-109">setenv</span><span
2386 class="ec-lmtt-10x-x-109"> PATH</span><span
2387 class="ec-lmtt-10x-x-109"> /usr/local/texlive/2026/bin/x86_64-linux:$PATH</span>
2388 <a
2389 id="x1-29010r2"></a><span
2390 class="ec-lmtt-10x-x-109">setenv</span><span
2391 class="ec-lmtt-10x-x-109"> MANPATH</span><span
2392 class="ec-lmtt-10x-x-109"> /usr/local/texlive/2026/texmf-dist/doc/man:$MANPATH</span>
2393 <a
2394 id="x1-29012r3"></a><span
2395 class="ec-lmtt-10x-x-109">setenv</span><span
2396 class="ec-lmtt-10x-x-109"> INFOPATH</span><span
2397 class="ec-lmtt-10x-x-109"> /usr/local/texlive/2026/texmf-dist/doc/info:$INFOPATH</span></pre>
2398 <!--l. 1043--><p class="indent" > If you’re not on an <span
2399 class="ec-lmtt-12">x86_64-linux </span>platform, use the appropriate platform name; similarly,
2400 if you didn’t install in the default directory, change the directory name. The TeX Live installer
2401 reports the full lines to use at the end of installation.
2402 </p><!--l. 1048--><p class="indent" > If you already have <span
2403 class="ec-lmtt-12">PATH </span>settings somewhere in your startup files, merge in the TeX
2404 Live directories as you see fit.
2405
2406 </p>
2407 <h5 class="subsubsectionHead"><span class="titlemark">3.4.2 </span> <a
2408 id="x1-300003.4.2"></a>Environment variables: Global configuration</h5>
2409 <!--l. 1055--><p class="noindent" >If you want to make these changes globally, or for a user newly added to the system, then you
2410 are on your own; there is just too much variation between systems in how and where these
2411 things are configured.
2412 </p><!--l. 1059--><p class="indent" > Our two hints are: 1) you may want to check for a file <span
2413 class="ec-lmtt-12">/etc/manpath.config </span>and, if
2414 present, add lines such as
2415 </p><!--l. 1062--><p class="indent" >
2416 </p>
2417 <pre class="fancyvrb" id="fancyvrb7"><a
2418 id="x1-30002r1"></a><span
2419 class="ec-lmtt-10x-x-109">MANPATH_MAP</span><span
2420 class="ec-lmtt-10x-x-109"> /usr/local/texlive/2026/bin/x86_64-linux</span><span
2421 class="ec-lmtt-10x-x-109"> \</span>
2422 <a
2423 id="x1-30004r2"></a><span
2424 class="ec-lmtt-10x-x-109"> </span><span
2425 class="ec-lmtt-10x-x-109"> </span><span
2426 class="ec-lmtt-10x-x-109"> </span><span
2427 class="ec-lmtt-10x-x-109"> </span><span
2428 class="ec-lmtt-10x-x-109"> </span><span
2429 class="ec-lmtt-10x-x-109"> </span><span
2430 class="ec-lmtt-10x-x-109"> </span><span
2431 class="ec-lmtt-10x-x-109"> </span><span
2432 class="ec-lmtt-10x-x-109"> </span><span
2433 class="ec-lmtt-10x-x-109"> </span><span
2434 class="ec-lmtt-10x-x-109"> </span><span
2435 class="ec-lmtt-10x-x-109"> /usr/local/texlive/2026/texmf-dist/doc/man</span></pre>
2436 <!--l. 1067--><p class="indent" > And 2) check for a file <span
2437 class="ec-lmtt-12">/etc/environment </span>which may define the search path and other
2438 default environment variables.
2439 </p><!--l. 1070--><p class="indent" > In each (Unix) binary directory, we also create a symbolic link named <span
2440 class="ec-lmtt-12">man </span>to the directory
2441 <span
2442 class="ec-lmtt-12">texmf-dist/doc/man</span>. Some <span
2443 class="ec-lmtt-12">man </span>programs, such as the standard macOS <span
2444 class="ec-lmtt-12">man</span>, will
2445 automatically find that, obviating the need for any man page setup.
2446
2447
2448 </p><!--l. 1075--><p class="indent" > <a id="tlisoinstall"></a>
2449 </p>
2450 <h5 class="subsubsectionHead"><span class="titlemark">3.4.3 </span> <a
2451 id="x1-310003.4.3"></a>Internet updates after DVD or ISO installation</h5>
2452 <!--l. 1079--><p class="noindent" >If you installed TeX Live from DVD (see <a
2453 href="https://tug.org/dvd" class="url" ><span
2454 class="ec-lmtt-12">https://tug.org/dvd</span></a>) or an ISO image and
2455 then wish to get updates from the Internet, you need to run this command—<span
2456 class="ec-lmri-12">after </span>you’ve
2457 updated your search path (as described in the previous section):
2458 </p>
2459 <div class="alltt">
2460
2461 <div class="obeylines-v">
2462 <br /><span
2463 class="ec-lmtt-12">&#x003E;</span><span
2464 class="ec-lmtt-12"> ...</span><span
2465 class="ec-lmtt-12"> update</span><span
2466 class="ec-lmtt-12"> PATH</span><span
2467 class="ec-lmtt-12"> ...</span>
2468 <br /><span
2469 class="ec-lmtt-12">&#x003E;</span><span
2470 class="ec-lmtt-12"> </span><span
2471 class="ec-lmtk-10x-x-120">tlmgr</span><span
2472 class="ec-lmtk-10x-x-120"> option</span><span
2473 class="ec-lmtk-10x-x-120"> repository</span><span
2474 class="ec-lmtk-10x-x-120"> https://mirror.ctan.org/systems/texlive/tlnet</span>
2475 </div>
2476 </div>
2477 <!--l. 1089--><p class="indent" > This tells <span
2478 class="ec-lmss-12">tlmgr </span>to use a nearby CTAN mirror for future updates. This is done by default
2479 when installing from DVD, via the option described in section <a
2480 href="#x1-250003.2.4">3.2.4<!--tex4ht:ref: sec:options --></a>.
2481 </p><!--l. 1093--><p class="indent" > If there are problems with the automatic mirror selection, you can specify a particular
2482 CTAN mirror from the list at <a
2483 href="https://ctan.org/mirrors" class="url" ><span
2484 class="ec-lmtt-12">https://ctan.org/mirrors</span></a>. Use the exact path to the
2485 <span
2486 class="ec-lmtt-12">tlnet </span>subdir on that mirror, as shown above.
2487 </p><!--l. 1099--><p class="indent" > <a id="xetexfontconfig"></a> <a id="sysfontconfig"></a>
2488 </p>
2489 <h5 class="subsubsectionHead"><span class="titlemark">3.4.4 </span> <a
2490 id="x1-320003.4.4"></a>System font configuration for XeTeX and LuaTeX</h5>
2491 <!--l. 1104--><p class="noindent" >XeTeX and LuaTeX can use any font installed on the system, not just those in the
2492 TeX trees. Such system fonts (not part of TeX Live) are usually accessed by giving the
2493 font name, e.g., ‘<span
2494 class="ec-lmtt-12">Liberation Serif</span>’, although the system filename can also be
2495 used.
2496 </p><!--l. 1109--><p class="indent" > A related issue is making the fonts from the TeX Live distribution available as system
2497 fonts, which will in turn make them available by font name.
2498 </p><!--l. 1112--><p class="indent" > For LuaTeX: for access by font name, nothing special need be done. All fonts in TeX
2499 Live should be equally accessible by either font name or filename to LuaTeX, via the <span
2500 class="ec-lmss-12">luaotfload</span>
2501 package, which supports both LaTeX and plain TeX. The <span
2502 class="ec-lmss-12">luaotfload </span>font name index may
2503 need to be rebuilt for new fonts; this is triggered automatically when trying to load a font
2504 which isn’t known yet.
2505 </p><!--l. 1119--><p class="indent" > For XeTeX: on Windows, fonts shipped with TeX Live are automatically made available
2506 (by running the <span
2507 class="ec-lmss-12">fc-cache </span>program provided for Windows as part of TeX Live). For the Mac,
2508 you’ll need to consult other documentation. For Unix systems other than macOS, the
2509 procedure is the following.
2510 </p><!--l. 1125--><p class="indent" > When the <span
2511 class="ec-lmss-12">xetex </span>package is installed (either at initial installation or later), the necessary
2512 configuration file is created in <span
2513 class="ec-lmtt-12">TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf</span>. To
2514 make the TeX Live fonts available as system fonts,
2515 </p><ol class="enumerate1" >
2516
2517
2518 <li
2519 class="enumerate" id="x1-32002x1">
2520 <!--l. 1130--><p class="noindent" >Copy that <span
2521 class="ec-lmtt-12">texlive-fontconfig.conf </span>file to (typically)
2522 <span
2523 class="ec-lmtt-12">/etc/fonts/conf.d/09-texlive.conf</span>.
2524 </p></li>
2525 <li
2526 class="enumerate" id="x1-32004x2">
2527 <!--l. 1132--><p class="noindent" >Run <span
2528 class="ec-lmtk-10x-x-120">fc-cache -fsv</span>.</p></li></ol>
2529 <!--l. 1135--><p class="indent" > If you do not have sufficient privileges to carry out the steps above, or if you want to make
2530 the TeX Live fonts available to only one user, you can do the following:
2531 </p><ol class="enumerate1" >
2532 <li
2533 class="enumerate" id="x1-32006x1">
2534 <!--l. 1139--><p class="noindent" >Copy the <span
2535 class="ec-lmtt-12">texlive-fontconfig.conf </span>file to (typically)
2536 <span
2537 class="ec-lmtt-12">~/.fonts.conf.d/09-texlive.conf</span>, where <span
2538 class="ec-lmtt-12">~ </span>is your home directory.
2539 </p></li>
2540 <li
2541 class="enumerate" id="x1-32008x2">
2542 <!--l. 1142--><p class="noindent" >Run <span
2543 class="ec-lmtk-10x-x-120">fc-cache -fv</span>.</p></li></ol>
2544 <!--l. 1145--><p class="indent" > You can run <span
2545 class="ec-lmtt-12">fc-list </span>to see the names of the available system fonts. The incantation
2546 <span
2547 class="ec-lmtt-12">fc-list : family style file spacing </span>(all those arguments are literal strings) shows some
2548 generally interesting information.
2549
2550 </p>
2551 <h5 class="subsubsectionHead"><span class="titlemark">3.4.5 </span> <a
2552 id="x1-330003.4.5"></a>ConTeXt LMTX and MKIV</h5>
2553 <!--l. 1155--><p class="noindent" >Both the ‘old’ ConTeXt (Mark IV or MkIV) and the ‘new’ ConTeXt (LMTX or MkXL) should
2554 run out of the box after TeX Live installation, and should need no special attention as long as
2555 you stick to using <span class="obeylines-h"><code class="verb">tlmgr</code></span> for updates.
2556 </p><!--l. 1160--><p class="indent" > ConTeXt does not use the Kpathsea library or the system <span
2557 class="ec-lmtt-12">ls-R </span>files; instead, ConTeXt
2558 maintains a per-user filename database for all known trees. Running <span
2559 class="ec-lmtt-12">mktexlsr </span>won’t update
2560 these databases directly, but ConTeXt will automatically rebuild them the next time it
2561 runs. (The TeX Live-specific files <span
2562 class="ec-lmtt-12">cont-sys.mkiv </span>and <span
2563 class="ec-lmtt-12">cont-sys.mkxl </span>implement
2564 this.)
2565 </p><!--l. 1167--><p class="indent" > If you ever want to manually rebuild these databases, run either or both of:
2566 </p>
2567 <pre class="fancyvrb" id="fancyvrb8"><a
2568 id="x1-33002r1"></a><span
2569 class="ec-lmtt-10x-x-109">mtxrun</span><span
2570 class="ec-lmtt-10x-x-109"> --generate</span><span
2571 class="ec-lmtt-10x-x-109"> </span><span
2572 class="ec-lmtt-10x-x-109"> </span><span
2573 class="ec-lmtt-10x-x-109"> </span><span
2574 class="ec-lmtt-10x-x-109"> </span><span
2575 class="ec-lmtt-10x-x-109"> </span><span
2576 class="ec-lmtt-10x-x-109"> </span><span
2577 class="ec-lmtt-10x-x-109"> </span><span
2578 class="ec-lmtt-10x-x-109"> </span><span
2579 class="ec-lmtt-10x-x-109"> </span><span
2580 class="ec-lmtt-10x-x-109"> </span><span
2581 class="ec-lmtt-10x-x-109"> #</span><span
2582 class="ec-lmtt-10x-x-109"> LMTX</span>
2583 <a
2584 id="x1-33004r2"></a><span
2585 class="ec-lmtt-10x-x-109">mtxrun</span><span
2586 class="ec-lmtt-10x-x-109"> --luatex</span><span
2587 class="ec-lmtt-10x-x-109"> --generate</span><span
2588 class="ec-lmtt-10x-x-109"> </span><span
2589 class="ec-lmtt-10x-x-109"> #</span><span
2590 class="ec-lmtt-10x-x-109"> MkIV</span></pre>
2591 <!--l. 1172--><p class="noindent" >The resulting files are stored under <span
2592 class="ec-lmtt-12">TEXMFCACHE</span>, whose default value in TeX Live is
2593 <span class="obeylines-h"><code class="verb">TEXMFSYSVAR;TEXMFVAR</code></span>.
2594 </p><!--l. 1175--><p class="indent" > ConTeXt will read from all paths mentioned in <span class="obeylines-h"><code class="verb">TEXMFCACHE</code></span>, and write to the first path
2595 that is writable. While reading, the last found match will take precedence in the case of
2596 duplicated cache data.
2597 </p><!--l. 1179--><p class="indent" > For more information, see <a
2598 href="https://wiki.contextgarden.net/LMTX" class="url" ><span
2599 class="ec-lmtt-12">https://wiki.contextgarden.net/LMTX</span></a><br
2600 class="newline" />and <a
2601 href="https://wiki.contextgarden.net/Running_Mark_IV" class="url" ><span
2602 class="ec-lmtt-12">https://wiki.contextgarden.net/Running_Mark_IV</span></a>.
2603
2604
2605
2606 </p>
2607 <h5 class="subsubsectionHead"><span class="titlemark">3.4.6 </span> <a
2608 id="x1-340003.4.6"></a>Integrating local and personal macros</h5>
2609 <!--l. 1186--><p class="noindent" >This is already mentioned implicitly in section <a
2610 href="#x1-100002.2">2.2<!--tex4ht:ref: sec:texmftrees --></a>: <span
2611 class="ec-lmtt-12">TEXMFLOCAL </span>(by default,
2612 <span
2613 class="ec-lmtt-12">/usr/local/texlive/texmf-local </span>or <span class="obeylines-h"><code class="verb">%SystemDrive%\texlive\texmf-local</code></span> on Windows)
2614 is intended for system-wide local fonts and macros; and <span
2615 class="ec-lmtt-12">TEXMFHOME </span>(by default, <span
2616 class="ec-lmtt-12">$HOME/texmf</span>
2617 or <span class="obeylines-h"><code class="verb">%USERPROFILE%\texmf</code></span>), is for personal fonts and macros. These directories are intended to
2618 stick around from release to release, and have their content seen automatically by a new TeX
2619 Live release. Therefore, it is best to refrain from changing the definition of <span
2620 class="ec-lmtt-12">TEXMFLOCAL </span>to be
2621 too far away from the main TeX Live directory, or you will need to manually change future
2622 releases.
2623 </p><!--l. 1199--><p class="indent" > For both trees, files should be placed in their proper TeX Directory Structure (TDS)
2624 subdirectories; see <a
2625 href="https://tug.org/tds" class="url" ><span
2626 class="ec-lmtt-12">https://tug.org/tds</span></a> or consult <span
2627 class="ec-lmtt-12">texmf-dist/web2c/texmf.cnf</span>. For
2628 instance, a LaTeX class file or package should be placed in <span
2629 class="ec-lmtt-12">TEXMFLOCAL/tex/latex </span>or
2630 <span
2631 class="ec-lmtt-12">TEXMFHOME/tex/latex</span>, or a subdirectory thereof.
2632 </p><!--l. 1205--><p class="indent" > <span
2633 class="ec-lmtt-12">TEXMFLOCAL </span>requires an up-to-date filename database, or files will not be found. You can
2634 update it with the command <span
2635 class="ec-lmss-12">mktexlsr </span>or use the ‘Update filename database’ button on the
2636 ‘Actions’ tab of the TeX Live Manager GUI.
2637 </p><!--l. 1210--><p class="indent" > By default, each of these variables is defined to be a single directory, as shown. This is not
2638 a hard-and-fast requirement. If you need to easily switch back and forth between different
2639 versions of large packages, for example, you can maintain multiple trees for your own purposes.
2640 This is done by setting <span
2641 class="ec-lmtt-12">TEXMFHOME </span>to the list of directories, within braces, separated by
2642 commas:
2643
2644
2645 </p>
2646 <pre class="verbatim" id="verbatim-1">
2647 <pre class="fancyvrb" id="fancyvrb9"><a
2648 id="x1-34002r1"></a>  TEXMFHOME = {/my/dir1,/mydir2,/a/third/dir}</pre>
2649 </pre>
2650 <!--l. 1219--><p class="nopar" >
2651 </p><!--l. 1221--><p class="indent" > Section <a
2652 href="#x1-590007.1.5">7.1.5<!--tex4ht:ref: sec:brace-expansion --></a> describes brace expansion further.
2653
2654 </p>
2655 <h5 class="subsubsectionHead"><span class="titlemark">3.4.7 </span> <a
2656 id="x1-350003.4.7"></a>Integrating third-party fonts</h5>
2657 <!--l. 1226--><p class="noindent" >This is unfortunately a messy topic for TeX and pdfTeX. Forget about it unless you want to
2658 delve into many details of the TeX installation. Many fonts are included in TeX Live already,
2659 so take a look if you like; the web pages under <a
2660 href="https://tug.org/FontCatalogue" class="url" ><span
2661 class="ec-lmtt-12">https://tug.org/FontCatalogue</span></a> display
2662 nearly all of the text fonts included in the main TeX distributions, categorized in various
2663 ways.
2664 </p><!--l. 1233--><p class="indent" > If you do want to install your own fonts, see <a
2665 href="https://tug.org/fonts/fontinstall.html" class="url" ><span
2666 class="ec-lmtt-12">https://tug.org/fonts/fontinstall.html</span></a>
2667 for our best effort at describing the procedure.
2668 </p><!--l. 1237--><p class="indent" > Also consider using XeTeX or LuaTeX (see section <a
2669 href="#x1-110002.3">2.3<!--tex4ht:ref: sec:tex-extensions --></a>), which let you use operating
2670 system fonts without any installation in TeX. (But beware that using system fonts usually
2671 makes your document sources unusable by anyone in a different environment.)
2672
2673 </p>
2674 <h4 class="subsectionHead"><span class="titlemark">3.5 </span> <a
2675 id="x1-360003.5"></a>Testing the installation</h4>
2676 <!--l. 1246--><p class="noindent" >After installing TeX Live, you naturally want to test it out, so you can start creating beautiful
2677 documents and/or fonts.
2678 </p><!--l. 1249--><p class="indent" > One thing you may immediately be looking for is a front-end with which to edit files. TeX
2679 Live installs TeXworks (<a
2680 href="https://tug.org/texworks" class="url" ><span
2681 class="ec-lmtt-12">https://tug.org/texworks</span></a>) on Windows (only), and
2682 MacTeX installs TeXShop (<a
2683 href="https://pages.uoregon.edu/koch/texshop" class="url" ><span
2684 class="ec-lmtt-12">https://pages.uoregon.edu/koch/texshop</span></a>). On other Unix
2685 systems, it’s left up to you to choose an editor. There are many choices available, some of
2686 which are listed in the next section; see also <a
2687 href="https://tug.org/interest.html#editors" class="url" ><span
2688 class="ec-lmtt-12">https://tug.org/interest.html#editors</span></a>.
2689 Any plain text editor will work; something TeX-specific is not required.
2690 </p><!--l. 1258--><p class="indent" > The rest of this section gives some basic procedures for testing that the new system
2691 is functional. We give Unix commands here; under macOS and Windows, you’re
2692 more likely to run the tests through a graphical interface, but the principles are the
2693 same.
2694 </p><!--l. 1263--><p class="indent" >
2695 </p><ol class="enumerate1" >
2696 <li
2697 class="enumerate" id="x1-36002x1">
2698 <!--l. 1265--><p class="noindent" >Make sure that you can run the <span
2699 class="ec-lmss-12">tex </span>program in the first place: </p><div class="alltt">
2700
2701 <div class="obeylines-v">
2702 <br /><span
2703 class="ec-lmtt-12">&#x003E;</span><span
2704 class="ec-lmtt-12"> </span><span
2705 class="ec-lmtk-10x-x-120">tex</span><span
2706 class="ec-lmtk-10x-x-120"> --version</span>
2707
2708
2709 <br /><span
2710 class="ec-lmtt-12">TeX</span><span
2711 class="ec-lmtt-12"> 3.14159265</span><span
2712 class="ec-lmtt-12"> (TeX</span><span
2713 class="ec-lmtt-12"> Live</span><span
2714 class="ec-lmtt-12"> ...)</span>
2715 <br /><span
2716 class="ec-lmtt-12">Copyright</span><span
2717 class="ec-lmtt-12"> ...</span><span
2718 class="ec-lmtt-12"> D.E.</span><span
2719 class="ec-lmtt-12"> Knuth.</span>
2720 <br /><span
2721 class="ec-lmtt-12">...</span></div>
2722 </div> If this comes back with ‘command not found’ instead of version and copyright
2723 information, or with an older version, most likely you don’t have the correct
2724 <span
2725 class="ec-lmtt-12">bin </span>subdirectory in your <span
2726 class="ec-lmtt-12">PATH</span>. See the environment-setting information on
2727 p. <a
2728 href="#x1-290003.4.1">46<!--tex4ht:ref: sec:env --></a>.
2729 </li>
2730 <li
2731 class="enumerate" id="x1-36004x2">
2732 <!--l. 1278--><p class="noindent" >Process a basic LaTeX file, generating PDF: </p><div class="alltt">
2733
2734 <div class="obeylines-v">
2735 <br /><span
2736 class="ec-lmtt-12">&#x003E;</span><span
2737 class="ec-lmtt-12"> </span><span
2738 class="ec-lmtk-10x-x-120">pdflatex</span><span
2739 class="ec-lmtk-10x-x-120"> sample2e.tex</span>
2740 <br /><span
2741 class="ec-lmtt-12">This</span><span
2742 class="ec-lmtt-12"> is</span><span
2743 class="ec-lmtt-12"> pdfTeX</span><span
2744 class="ec-lmtt-12"> 3.14...</span>
2745 <br /><span
2746 class="ec-lmtt-12">...</span>
2747 <br /><span
2748 class="ec-lmtt-12">Output</span><span
2749 class="ec-lmtt-12"> written</span><span
2750 class="ec-lmtt-12"> on</span><span
2751 class="ec-lmtt-12"> sample2e.pdf</span><span
2752 class="ec-lmtt-12"> (3</span><span
2753 class="ec-lmtt-12"> pages,</span><span
2754 class="ec-lmtt-12"> 142120</span><span
2755 class="ec-lmtt-12"> bytes).</span>
2756 <br /><span
2757 class="ec-lmtt-12">Transcript</span><span
2758 class="ec-lmtt-12"> written</span><span
2759 class="ec-lmtt-12"> on</span><span
2760 class="ec-lmtt-12"> sample2e.log.</span>
2761 </div>
2762 </div> If this fails to find <span
2763 class="ec-lmtt-12">sample2e.tex </span>or other files, you may have interference from old
2764 environment variables or configuration files; we recommend unsetting all TeX-related
2765 environment variables for a start. (For a deep analysis, you can ask TeX to report
2766 on exactly what it is searching for, and finding; see “Debugging actions” on
2767 page <a
2768 href="#x1-660007.2.4">87<!--tex4ht:ref: sec:debugging --></a>.)
2769 </li>
2770 <li
2771 class="enumerate" id="x1-36006x3">
2772 <!--l. 1293--><p class="noindent" >Preview the PDF file, for example: </p><div class="alltt">
2773
2774 <div class="obeylines-v">
2775 <br /><span
2776 class="ec-lmtt-12">&#x003E;</span><span
2777 class="ec-lmtt-12"> </span><span
2778 class="ec-lmtk-10x-x-120">xpdf</span><span
2779 class="ec-lmtk-10x-x-120"> sample2e.pdf</span>
2780 </div>
2781 </div> You should see a new window with a nice document explaining some of the basics of
2782 LaTeX. (It’s well worth reading, by the way, if you’re new to TeX.)
2783 <!--l. 1301--><p class="noindent" >Of course there are many other PDF viewers; on Unix systems, <span
2784 class="ec-lmss-12">evince </span>and
2785 <span
2786 class="ec-lmss-12">okular </span>are commonly used. For Windows, we recommend trying Sumatra PDF (
2787 <a
2788 href="https://www.sumatrapdfreader.org/free-pdf-reader.html" class="url" ><span
2789 class="ec-lmtt-12">https://www.sumatrapdfreader.org/free-pdf-reader.html</span></a>). No PDF
2790 viewers are included in TeX Live, so you must install whatever you want to use
2791 separately.
2792 </p></li>
2793 <li
2794 class="enumerate" id="x1-36008x4">
2795 <!--l. 1308--><p class="noindent" >Of course you can still generate TeX’s original DVI format: </p><div class="alltt">
2796
2797 <div class="obeylines-v">
2798
2799
2800 <br /><span
2801 class="ec-lmtt-12">&#x003E;</span><span
2802 class="ec-lmtt-12"> </span><span
2803 class="ec-lmtk-10x-x-120">latex</span><span
2804 class="ec-lmtk-10x-x-120"> sample2e.tex</span>
2805 </div>
2806 </div>
2807 </li>
2808 <li
2809 class="enumerate" id="x1-36010x5">
2810 <!--l. 1313--><p class="noindent" >And preview the DVI online: </p><div class="alltt">
2811
2812 <div class="obeylines-v">
2813 <br /><span
2814 class="ec-lmtt-12">&#x003E;</span><span
2815 class="ec-lmtt-12"> </span><span
2816 class="ec-lmtk-10x-x-120">xdvi</span><span
2817 class="ec-lmtk-10x-x-120"> sample2e.dvi</span><span
2818 class="ec-lmtt-12"> </span><span
2819 class="ec-lmtt-12"> </span><span
2820 class="ec-lmtt-12"> </span><span
2821 class="ec-lmtt-12"> #</span><span
2822 class="ec-lmtt-12"> Unix</span>
2823 <br /><span
2824 class="ec-lmtt-12">&#x003E;</span><span
2825 class="ec-lmtt-12"> </span><span
2826 class="ec-lmtk-10x-x-120">dviout</span><span
2827 class="ec-lmtk-10x-x-120"> sample2e.dvi</span><span
2828 class="ec-lmtt-12"> </span><span
2829 class="ec-lmtt-12"> #</span><span
2830 class="ec-lmtt-12"> Windows</span>
2831 </div>
2832 </div> You do have to be running under X for <span
2833 class="ec-lmss-12">xdvi </span>to work; if you’re not, or your
2834 <span
2835 class="ec-lmtt-12">DISPLAY </span>environment variable is set incorrectly, you’ll get an error ‘<span
2836 class="ec-lmtt-12">Can’t open</span>
2837 <span
2838 class="ec-lmtt-12">display</span>’.
2839 </li>
2840 <li
2841 class="enumerate" id="x1-36012x6">
2842 <!--l. 1322--><p class="noindent" >To create a PostScript file from the DVI: </p><div class="alltt">
2843
2844 <div class="obeylines-v">
2845 <br /><span
2846 class="ec-lmtt-12">&#x003E;</span><span
2847 class="ec-lmtt-12"> </span><span
2848 class="ec-lmtk-10x-x-120">dvips</span><span
2849 class="ec-lmtk-10x-x-120"> sample2e.dvi</span><span
2850 class="ec-lmtk-10x-x-120"> -o</span><span
2851 class="ec-lmtk-10x-x-120"> sample2e.ps</span>
2852 </div>
2853 </div>
2854 </li>
2855 <li
2856 class="enumerate" id="x1-36014x7">
2857 <!--l. 1327--><p class="noindent" >Or to create PDF from the DVI, an alternate path to using pdfTeX (or XeTeX or
2858 LuaTeX) which can be useful sometimes: </p><div class="alltt">
2859
2860 <div class="obeylines-v">
2861 <br /><span
2862 class="ec-lmtt-12">&#x003E;</span><span
2863 class="ec-lmtt-12"> </span><span
2864 class="ec-lmtk-10x-x-120">dvipdfmx</span><span
2865 class="ec-lmtk-10x-x-120"> sample2e.dvi</span><span
2866 class="ec-lmtk-10x-x-120"> -o</span><span
2867 class="ec-lmtk-10x-x-120"> sample2e.pdf</span>
2868 </div>
2869 </div>
2870 </li>
2871 <li
2872 class="enumerate" id="x1-36016x8">
2873 <!--l. 1333--><p class="noindent" >Other standard test files you may find useful in addition to <span
2874 class="ec-lmtt-12">sample2e.tex</span>:
2875 </p><!--l. 1336--><p class="noindent" >
2876 </p><dl class="list2"><dt class="list">
2877 <span
2878 class="ec-lmtt-12">small2e.tex</span> </dt><dd
2879 class="list">
2880 <!--l. 1337--><p class="noindent" >A simpler document than <span
2881 class="ec-lmtt-12">sample2e</span>, to reduce the input size if you’re having
2882 troubles.
2883 </p></dd><dt class="list">
2884 <span
2885 class="ec-lmtt-12">testpage.tex</span> </dt><dd
2886 class="list">
2887 <!--l. 1339--><p class="noindent" >Test if your printer introduces any offsets.
2888 </p></dd><dt class="list">
2889
2890
2891 <span
2892 class="ec-lmtt-12">nfssfont.tex</span> </dt><dd
2893 class="list">
2894 <!--l. 1340--><p class="noindent" >For printing font tables and tests.
2895 </p></dd><dt class="list">
2896 <span
2897 class="ec-lmtt-12">testfont.tex</span> </dt><dd
2898 class="list">
2899 <!--l. 1341--><p class="noindent" >Also for font tables, but using plain TeX.
2900 </p></dd><dt class="list">
2901 <span
2902 class="ec-lmtt-12">story.tex</span> </dt><dd
2903 class="list">
2904 <!--l. 1342--><p class="noindent" >The most canonical (plain) TeX test file of all. You must type ‘<span
2905 class="ec-lmtt-12">\bye</span>’ to the <span
2906 class="ec-lmtt-12">*</span>
2907 prompt after ‘<span
2908 class="ec-lmtt-12">tex story.tex</span>’.</p></dd></dl>
2909 </li>
2910 <li
2911 class="enumerate" id="x1-36018x9">
2912 <!--l. 1347--><p class="noindent" >If you have installed the <span
2913 class="ec-lmtt-12">xetex </span>package, you can test its access to system fonts as
2914 follows: </p><div class="alltt">
2915
2916 <div class="obeylines-v">
2917 <br /><span
2918 class="ec-lmtt-12">&#x003E;</span><span
2919 class="ec-lmtt-12"> </span><span
2920 class="ec-lmtk-10x-x-120">xetex</span><span
2921 class="ec-lmtk-10x-x-120"> opentype-info.tex</span>
2922 <br /><span
2923 class="ec-lmtt-12">This</span><span
2924 class="ec-lmtt-12"> is</span><span
2925 class="ec-lmtt-12"> XeTeX,</span><span
2926 class="ec-lmtt-12"> Version</span><span
2927 class="ec-lmtt-12"> 3.14</span><span
2928 class="ec-lmtt-12">…</span>
2929 <br /><span
2930 class="ec-lmtt-12">...</span>
2931 <br /><span
2932 class="ec-lmtt-12">Output</span><span
2933 class="ec-lmtt-12"> written</span><span
2934 class="ec-lmtt-12"> on</span><span
2935 class="ec-lmtt-12"> opentype-info.pdf</span><span
2936 class="ec-lmtt-12"> (1</span><span
2937 class="ec-lmtt-12"> page).</span>
2938 <br /><span
2939 class="ec-lmtt-12">Transcript</span><span
2940 class="ec-lmtt-12"> written</span><span
2941 class="ec-lmtt-12"> on</span><span
2942 class="ec-lmtt-12"> opentype-info.log.</span>
2943 </div>
2944 </div>
2945 <!--l. 1357--><p class="noindent" >If you get an error message saying “Invalid fontname ‘Latin Modern Roman/ICU’…”,
2946 then you need to configure your system so that the fonts shipped with TeX Live can be
2947 found. See section <a
2948 href="#x1-320003.4.4">3.4.4<!--tex4ht:ref: sec:font-conf-sys --></a>.
2949 </p>
2950 </li></ol>
2951 <!--l. 1364--><p class="indent" > <a id="uninstall"></a>
2952 </p>
2953 <h4 class="subsectionHead"><span class="titlemark">3.6 </span> <a
2954 id="x1-370003.6"></a>Uninstalling TeX Live</h4>
2955 <!--l. 1368--><p class="noindent" >To uninstall TeX Live (after a successful installation; for Windows, see below):
2956 </p>
2957 <div class="alltt">
2958
2959 <div class="obeylines-v">
2960 <br /><span
2961 class="ec-lmtt-12">&#x003E;</span><span
2962 class="ec-lmtt-12"> </span><span
2963 class="ec-lmtk-10x-x-120">tlmgr</span><span
2964 class="ec-lmtk-10x-x-120"> uninstall</span><span
2965 class="ec-lmtk-10x-x-120"> --all</span>
2966 </div>
2967 </div>
2968 <!--l. 1375--><p class="indent" > You will be asked for confirmation, else nothing will be done. (Without <span
2969 class="ec-lmtt-12">--all</span>, the
2970 <span
2971 class="ec-lmtt-12">uninstall </span>action is used to remove individual packages.)
2972 </p><!--l. 1379--><p class="indent" > This does not remove user-specific directories, namely (see also section <a
2973 href="#x1-100002.2">2.2<!--tex4ht:ref: sec:texmftrees --></a>):
2974 </p><!--l. 1382--><p class="noindent" >
2975
2976
2977 </p><dl class="list1"><dt class="list">
2978 <span
2979 class="ec-lmtt-12">TEXMFCONFIG</span> </dt><dd
2980 class="list">
2981 <!--l. 1383--><p class="noindent" >This is intended for user configuration changes. If you want to preserve them, be
2982 sure you know how to recreate them before removing.
2983 </p></dd><dt class="list">
2984 <span
2985 class="ec-lmtt-12">TEXMFVAR</span> </dt><dd
2986 class="list">
2987 <!--l. 1387--><p class="noindent" >This is intended to store automatically-generated runtime data, such as local format
2988 files. Unless you’ve used it for other purposes, it should be safe to remove.
2989 </p></dd><dt class="list">
2990 <span
2991 class="ec-lmtt-12">TEXMFHOME</span> </dt><dd
2992 class="list">
2993 <!--l. 1391--><p class="noindent" >Contains only files you yourself installed, typically those not available in the
2994 distributions. Unless you are completely stopping using TeX, or want to start over
2995 from scratch, you probably don’t want to remove this.
2996 </p>
2997 </dd></dl>
2998 <!--l. 1398--><p class="noindent" >You can find the directory paths for these variables by running <span
2999 class="ec-lmtt-12">kpsewhich -var-value=</span><span
3000 class="ec-lmro-12">var</span>.
3001 </p><!--l. 1401--><p class="indent" > This <span
3002 class="ec-lmss-12">tlmgr </span>uninstallation also does not undo post-install actions, such as <span
3003 class="ec-lmtt-12">PATH </span>changes in
3004 your shell initialization files and system access to the fonts in TeX Live (see section <a
3005 href="#x1-280003.4">3.4<!--tex4ht:ref: sec:postinstall --></a>). You
3006 must manually reverse such actions, if desired.
3007 </p><!--l. 1407--><p class="indent" > On Windows, uninstallation can be done through the GUI; see section <a
3008 href="#x1-460006.1">6.1<!--tex4ht:ref: sec:winfeatures --></a>.
3009
3010 </p>
3011 <h4 class="subsectionHead"><span class="titlemark">3.7 </span> <a
3012 id="x1-380003.7"></a>Links for additional downloadable software</h4>
3013 <!--l. 1413--><p class="noindent" >If you are new to TeX, or otherwise need help with actually writing TeX or LaTeX
3014 documents, please visit <a
3015 href="https://tug.org/begin.html" class="url" ><span
3016 class="ec-lmtt-12">https://tug.org/begin.html</span></a> for some introductory
3017 resources.
3018 </p><!--l. 1417--><p class="indent" > Links for some other tools you may consider installing:
3019 </p><dl class="description"><dt class="description"><a
3020 id="x1-38001x3.7"></a>
3021 <span
3022 class="ec-lmbx-12">Ghostscript</span> </dt><dd
3023 class="description">
3024 <!--l. 1419--><p class="noindent" ><a
3025 href="https://ghostscript.com/" class="url" ><span
3026 class="ec-lmtt-12">https://ghostscript.com/</span></a>, a free PostScript and PDF interpreter.
3027 </p></dd><dt class="description"><a
3028 id="x1-38002x3.7"></a>
3029 <span
3030 class="ec-lmbx-12">Perl</span> </dt><dd
3031 class="description">
3032 <!--l. 1421--><p class="noindent" ><a
3033 href="https://perl.org/" class="url" ><span
3034 class="ec-lmtt-12">https://perl.org/</span></a> with supplementary packages from CPAN,
3035 <a
3036 href="https://cpan.org/" class="url" ><span
3037 class="ec-lmtt-12">https://cpan.org/</span></a>.
3038 </p></dd><dt class="description"><a
3039 id="x1-38003x3.7"></a>
3040 <span
3041 class="ec-lmbx-12">ImageMagick</span> </dt><dd
3042 class="description">
3043 <!--l. 1423--><p class="noindent" ><a
3044 href="https://imagemagick.org" class="url" ><span
3045 class="ec-lmtt-12">https://imagemagick.org</span></a>, for graphics processing and conversion.
3046 </p></dd><dt class="description"><a
3047 id="x1-38004x3.7"></a>
3048 <span
3049 class="ec-lmbx-12">NetPBM</span> </dt><dd
3050 class="description">
3051 <!--l. 1425--><p class="noindent" ><a
3052 href="http://netpbm.sourceforge.net" class="url" ><span
3053 class="ec-lmtt-12">http://netpbm.sourceforge.net</span></a>, also for graphics.
3054 </p></dd><dt class="description"><a
3055 id="x1-38005x3.7"></a>
3056 <span
3057 class="ec-lmbx-12">TeX-oriented editors</span> </dt><dd
3058 class="description">
3059 <!--l. 1427--><p class="noindent" >There is a wide choice, and it is a matter of the user’s taste. Here is a selection in
3060 alphabetical order (a few here are for Windows only). </p>
3061
3062
3063 <ul class="itemize1">
3064 <li class="itemize">
3065 <!--l. 1431--><p class="noindent" ><span
3066 class="ec-lmss-12">GNU Emacs </span>is available for all major platforms; see
3067 <a
3068 href="https://www.gnu.org/software/emacs" class="url" ><span
3069 class="ec-lmtt-12">https://www.gnu.org/software/emacs</span></a>.
3070 </p></li>
3071 <li class="itemize">
3072 <!--l. 1433--><p class="noindent" ><span
3073 class="ec-lmss-12">AUCTeX </span>runs under Emacs; it’s available through Emacs’ package manager
3074 <span
3075 class="ec-lmss-12">ELPA</span>. Sources are also available from CTAN. The AUCTeX home page is
3076 <a
3077 href="https://www.gnu.org/software/auctex" class="url" ><span
3078 class="ec-lmtt-12">https://www.gnu.org/software/auctex</span></a>.
3079 </p></li>
3080 <li class="itemize">
3081 <!--l. 1437--><p class="noindent" ><span
3082 class="ec-lmss-12">SciTE </span>is available from <a
3083 href="https://www.scintilla.org/SciTE.html" class="url" ><span
3084 class="ec-lmtt-12">https://www.scintilla.org/SciTE.html</span></a>.
3085 </p></li>
3086 <li class="itemize">
3087 <!--l. 1439--><p class="noindent" ><span
3088 class="ec-lmss-12">Texmaker </span>is free software, available from
3089 <a
3090 href="https://www.xm1math.net/texmaker" class="url" ><span
3091 class="ec-lmtt-12">https://www.xm1math.net/texmaker</span></a>.
3092 </p></li>
3093 <li class="itemize">
3094 <!--l. 1441--><p class="noindent" ><span
3095 class="ec-lmss-12">TeXstudio </span>started as a fork of <span
3096 class="ec-lmss-12">Texmaker </span>and given additional features; available
3097 from <a
3098 href="https://texstudio.org/" class="url" ><span
3099 class="ec-lmtt-12">https://texstudio.org/</span></a>.
3100 </p></li>
3101 <li class="itemize">
3102 <!--l. 1444--><p class="noindent" ><span
3103 class="ec-lmss-12">TeXnicCenter </span>is free software, available from
3104 <a
3105 href="https://www.texniccenter.org" class="url" ><span
3106 class="ec-lmtt-12">https://www.texniccenter.org</span></a>.
3107 </p></li>
3108 <li class="itemize">
3109 <!--l. 1446--><p class="noindent" ><span
3110 class="ec-lmss-12">TeXworks </span>is free software, available from <a
3111 href="https://tug.org/texworks" class="url" ><span
3112 class="ec-lmtt-12">https://tug.org/texworks</span></a> and
3113 installed as part of TeX Live for Windows (only).
3114 </p></li>
3115 <li class="itemize">
3116 <!--l. 1449--><p class="noindent" ><span
3117 class="ec-lmss-12">Vim </span>is free software, available from <a
3118 href="https://www.vim.org" class="url" ><span
3119 class="ec-lmtt-12">https://www.vim.org</span></a>.
3120 </p></li>
3121 <li class="itemize">
3122 <!--l. 1451--><p class="noindent" ><span
3123 class="ec-lmss-12">WinEdt </span>is shareware available though <a
3124 href="https://tug.org/winedt" class="url" ><span
3125 class="ec-lmtt-12">https://tug.org/winedt</span></a> or
3126 <a
3127 href="https://www.winedt.com" class="url" ><span
3128 class="ec-lmtt-12">https://www.winedt.com</span></a>.
3129 </p></li>
3130 <li class="itemize">
3131 <!--l. 1453--><p class="noindent" ><span
3132 class="ec-lmss-12">WinShell </span>is available from <a
3133 href="https://www.winshell.de" class="url" ><span
3134 class="ec-lmtt-12">https://www.winshell.de</span></a>.</p></li></ul>
3135 </dd></dl>
3136 <!--l. 1456--><p class="noindent" >For a much longer list of packages and programs, see <a
3137 href="https://tug.org/interest.html" class="url" ><span
3138 class="ec-lmtt-12">https://tug.org/interest.html</span></a>.
3139
3140 </p>
3141 <h3 class="sectionHead"><span class="titlemark">4 </span> <a
3142 id="x1-390004"></a>Specialized installations</h3>
3143 <!--l. 1462--><p class="noindent" >The previous sections described the basic installation process. Here we turn to some
3144
3145
3146 specialized cases.
3147 </p><!--l. 1465--><p class="indent" > <a id="tlsharedinstall"></a>
3148 </p>
3149 <h4 class="subsectionHead"><span class="titlemark">4.1 </span> <a
3150 id="x1-400004.1"></a>Shared-user (or cross-machine) installations</h4>
3151 <!--l. 1469--><p class="noindent" >TeX Live has been designed to be shared between different systems on a network. With a
3152 standard directory layout, no hard paths are configured: the locations for files needed
3153 by TeX Live programs are found relative to the programs. You can see this in the
3154 principal configuration file <span
3155 class="ec-lmtt-12">$TEXMFDIST/web2c/texmf.cnf</span>, which contains lines such
3156 as
3157 </p>
3158 <pre class="fancyvrb" id="fancyvrb10"><a
3159 id="x1-40002r1"></a><span
3160 class="ec-lmtt-10x-x-109">TEXMFROOT</span><span
3161 class="ec-lmtt-10x-x-109"> =</span><span
3162 class="ec-lmtt-10x-x-109"> $SELFAUTOPARENT</span>
3163 <a
3164 id="x1-40004r2"></a><span
3165 class="ec-lmtt-10x-x-109">...</span>
3166 <a
3167 id="x1-40006r3"></a><span
3168 class="ec-lmtt-10x-x-109">TEXMFDIST</span><span
3169 class="ec-lmtt-10x-x-109"> =</span><span
3170 class="ec-lmtt-10x-x-109"> $TEXMFROOT/texmf-dist</span>
3171 <a
3172 id="x1-40008r4"></a><span
3173 class="ec-lmtt-10x-x-109">...</span>
3174 <a
3175 id="x1-40010r5"></a><span
3176 class="ec-lmtt-10x-x-109">TEXMFLOCAL</span><span
3177 class="ec-lmtt-10x-x-109"> =</span><span
3178 class="ec-lmtt-10x-x-109"> $SELFAUTOGRANDPARENT/texmf-local</span></pre>
3179 <!--l. 1482--><p class="noindent" >This means that adding the directory for TeX Live executables for their platform to their search
3180 path is sufficient to get a working setup.
3181 </p><!--l. 1485--><p class="indent" > By the same token, you can also install TeX Live locally and then move the entire
3182 hierarchy afterwards to a network location.
3183 </p><!--l. 1488--><p class="indent" > For Windows, TeX Live includes a launcher <span
3184 class="ec-lmtt-12">tlaunch</span>. Its main window contains menu
3185 entries and buttons for various TeX-related programs and documentation, customizable
3186 via an <span
3187 class="ec-lmtt-12">ini </span>file. On first use, it replicates the usual Windows-specific post-install,
3188 <span
3189 class="ec-lmri-12">i.e.</span>, search path modification and file associations, but only for the current user.
3190 Therefore, workstations with access to TeX Live on the local network only need a
3191 menu shortcut for the launcher. See the <span
3192 class="ec-lmtt-12">tlaunch </span>manual (<span
3193 class="ec-lmtt-12">texdoc tlaunch</span>, or
3194 <a
3195 href="https://ctan.org/pkg/tlaunch" class="url" ><span
3196 class="ec-lmtt-12">https://ctan.org/pkg/tlaunch</span></a>).
3197 </p><!--l. 1499--><p class="indent" > <a id="tlportable"></a>
3198 </p>
3199 <h4 class="subsectionHead"><span class="titlemark">4.2 </span> <a
3200 id="x1-410004.2"></a>Portable (USB) installations</h4>
3201 <!--l. 1503--><p class="noindent" >The <span
3202 class="ec-lmtt-12">-portable </span>installer option (or <span
3203 class="ec-lmtt-12">V </span>command in the text installer or corresponding GUI
3204 option) creates a completely self-contained TeX Live installation under a common root and
3205 forgoes system integration. You can create such an installation directly on a USB stick, or copy
3206 it to a USB stick afterwards.
3207 </p><!--l. 1509--><p class="indent" > Technically, the portable installation is made self-contained by setting the default values of
3208 <span
3209 class="ec-lmtt-12">TEXMFHOME</span>, <span
3210 class="ec-lmtt-12">TEXMFVAR</span>, and <span
3211 class="ec-lmtt-12">TEXMFCONFIG </span>to be the same as <span
3212 class="ec-lmtt-12">TEXMFLOCAL</span>, <span
3213 class="ec-lmtt-12">TEXMFSYSVAR</span>, and
3214 <span
3215 class="ec-lmtt-12">TEXMFSYSCONFIG </span>respectively; thus, per-user configuration and caches will not be
3216 created.
3217 </p><!--l. 1515--><p class="indent" > To run TeX using this portable installation, you need to add the appropriate binary
3218 directory to the search path during your terminal session, as usual.
3219 </p><!--l. 1519--><p class="indent" > On Windows, you can double-click <span
3220 class="ec-lmtt-12">tl-tray-menu </span>at the root of the installation and create
3221 a temporary ‘tray menu’ offering a choice of a few common tasks, as shown in this
3222 screenshot:
3223 </p><!--l. 1524--><p class="indent" > <img
3224 src="../texlive-common/tray-menu.png" alt="Windows tray menu"
3225 />
3226 </p><!--l. 1527--><p class="noindent" >The ‘More…’ entry explains how you can customize this menu.
3227 </p><!--l. 1530--><p class="indent" > <a id="tlmgr"></a>
3228
3229
3230 </p>
3231 <h3 class="sectionHead"><span class="titlemark">5 </span> <a
3232 id="x1-420005"></a><span
3233 class="ec-lmss-12">tlmgr</span>: Managing your installation</h3>
3234 <figure class="figure">
3235
3236
3237
3238 <a
3239 id="x1-42001r9"></a>
3240
3241
3242 <!--l. 1536--><p class="noindent" ><img
3243 src="../texlive-common/tlshell-linux.png" alt="tlshell GUI, showing the Actions menu (GNU/Linux)"
3244 />
3245 </p>
3246 <figcaption class="caption" ><span class="id">Figure 9: </span><span
3247 class="content"><span
3248 class="ec-lmss-12">tlshell </span>GUI, showing the Actions menu (GNU/Linux)</span></figcaption><!--tex4ht:label?: x1-42001r9 -->
3249
3250
3251 </figure>
3252 <figure class="figure">
3253
3254
3255
3256 <a
3257 id="x1-42002r10"></a>
3258
3259
3260 <!--l. 1543--><p class="noindent" ><img
3261 src="../texlive-common/tlcockpit-packages.png" alt="tlcockpit GUI for tlmgr"
3262 />
3263 </p>
3264 <figcaption class="caption" ><span class="id">Figure 10: </span><span
3265 class="content"><span
3266 class="ec-lmss-12">tlcockpit </span>GUI for <span
3267 class="ec-lmss-12">tlmgr</span></span></figcaption><!--tex4ht:label?: x1-42002r10 -->
3268
3269
3270 </figure>
3271 <figure class="figure">
3272
3273
3274
3275 <a
3276 id="x1-42003r11"></a>
3277
3278
3279 <!--l. 1550--><p class="noindent" ><img
3280 src="../texlive-common/tlmgr-gui.png" alt="Legacy tlmgr GUI mode: main window, after ‘Load’"
3281 />
3282 </p>
3283 <figcaption class="caption" ><span class="id">Figure 11: </span><span
3284 class="content">Legacy <span
3285 class="ec-lmss-12">tlmgr </span>GUI mode: main window, after ‘Load’</span></figcaption><!--tex4ht:label?: x1-42003r11 -->
3286
3287
3288 </figure>
3289 <!--l. 1555--><p class="indent" > TeX Live includes a program named <span
3290 class="ec-lmss-12">tlmgr </span>for managing TeX Live after the initial
3291 installation. Its capabilities include:
3292 </p>
3293 <ul class="itemize1">
3294 <li class="itemize">
3295 <!--l. 1559--><p class="noindent" >installing, updating, backing up, restoring, and uninstalling individual packages,
3296 optionally taking dependencies into account;
3297 </p></li>
3298 <li class="itemize">
3299 <!--l. 1561--><p class="noindent" >searching for and listing packages and their descriptions;
3300 </p></li>
3301 <li class="itemize">
3302 <!--l. 1562--><p class="noindent" >listing, adding, and removing platforms;
3303 </p></li>
3304 <li class="itemize">
3305 <!--l. 1563--><p class="noindent" >changing installation options such as paper size and source location (see
3306 section <a
3307 href="#x1-270003.3.1">3.3.1<!--tex4ht:ref: sec:location --></a>).</p></li></ul>
3308 <!--l. 1567--><p class="indent" > <span
3309 class="ec-lmss-12">tlmgr</span>’s functionality completely subsumes the <span
3310 class="ec-lmss-12">texconfig </span>program. We still distribute and
3311 maintain <span
3312 class="ec-lmss-12">texconfig </span>for the sake of anyone used to its interface, but we recommend using <span
3313 class="ec-lmss-12">tlmgr</span>
3314 nowadays.
3315
3316 </p>
3317 <h4 class="subsectionHead"><span class="titlemark">5.1 </span> <a
3318 id="x1-430005.1"></a>GUI interfaces for <span
3319 class="ec-lmss-12">tlmgr</span></h4>
3320 <!--l. 1574--><p class="noindent" >TeX Live contains several GUI front-ends for <span
3321 class="ec-lmss-12">tlmgr</span>. Two notable ones: (1) Figure <a
3322 href="#x1-42001r9">9<!--tex4ht:ref: fig:tlshell --></a> shows
3323 <span
3324 class="ec-lmss-12">tlshell</span>, which is written in Tcl/Tk and runs out of the box under Windows; (2) Figure <a
3325 href="#x1-42002r10">10<!--tex4ht:ref: fig:tlcockpit --></a>
3326 shows <span
3327 class="ec-lmss-12">tlcockpit</span>, which requires Java version 8 or higher and JavaFX. Both are separate
3328 packages.
3329 </p><!--l. 1580--><p class="indent" > <span
3330 class="ec-lmss-12">tlmgr </span>also has a native GUI mode (shown in figure <a
3331 href="#x1-42003r11">11<!--tex4ht:ref: fig:tlmgr-gui --></a>), which is started with:
3332 </p><div class="alltt">
3333
3334 <div class="obeylines-v">
3335 <br /><span
3336 class="ec-lmtt-12">&#x003E;</span><span
3337 class="ec-lmtt-12"> </span><span
3338 class="ec-lmtk-10x-x-120">tlmgr</span><span
3339 class="ec-lmtk-10x-x-120"> -gui</span>
3340 </div>
3341 </div> However, this GUI extension requires Perl/Tk, which module is no longer included in TeX
3342 Live’s Perl distribution for Windows.
3343
3344 <h4 class="subsectionHead"><span class="titlemark">5.2 </span> <a
3345 id="x1-440005.2"></a>Sample <span
3346 class="ec-lmss-12">tlmgr </span>command-line invocations</h4>
3347 <!--l. 1590--><p class="noindent" >After the initial installation, you can update your system to the latest versions available with:
3348 </p><div class="alltt">
3349
3350
3351
3352 <div class="obeylines-v">
3353 <br /><span
3354 class="ec-lmtt-12">&#x003E;</span><span
3355 class="ec-lmtt-12"> </span><span
3356 class="ec-lmtk-10x-x-120">tlmgr</span><span
3357 class="ec-lmtk-10x-x-120"> update</span><span
3358 class="ec-lmtk-10x-x-120"> -all</span>
3359 </div>
3360 </div> If this makes you nervous, first try <div class="alltt">
3361
3362 <div class="obeylines-v">
3363 <br /><span
3364 class="ec-lmtt-12">&#x003E;</span><span
3365 class="ec-lmtt-12"> </span><span
3366 class="ec-lmtk-10x-x-120">tlmgr</span><span
3367 class="ec-lmtk-10x-x-120"> update</span><span
3368 class="ec-lmtk-10x-x-120"> -all</span><span
3369 class="ec-lmtk-10x-x-120"> -dry-run</span>
3370 </div>
3371 </div> or (less verbose): <div class="alltt">
3372
3373 <div class="obeylines-v">
3374 <br /><span
3375 class="ec-lmtt-12">&#x003E;</span><span
3376 class="ec-lmtt-12"> </span><span
3377 class="ec-lmtk-10x-x-120">tlmgr</span><span
3378 class="ec-lmtk-10x-x-120"> update</span><span
3379 class="ec-lmtk-10x-x-120"> -list</span>
3380 </div>
3381 </div>
3382 <!--l. 1604--><p class="indent" > This more complex example adds a collection, for the engine XeTeX, from a local
3383 directory:
3384 </p>
3385 <div class="alltt">
3386
3387 <div class="obeylines-v">
3388 <br /><span
3389 class="ec-lmtt-12">&#x003E;</span><span
3390 class="ec-lmtt-12"> </span><span
3391 class="ec-lmtk-10x-x-120">tlmgr</span><span
3392 class="ec-lmtk-10x-x-120"> -repository</span><span
3393 class="ec-lmtk-10x-x-120"> /local/mirror/tlnet</span><span
3394 class="ec-lmtk-10x-x-120"> install</span><span
3395 class="ec-lmtk-10x-x-120"> collection-xetex</span>
3396 </div>
3397 </div> It generates the following output (abridged):
3398 <pre class="fancyvrb" id="fancyvrb11"><a
3399 id="x1-44002r1"></a><span
3400 class="ec-lmtt-10">install:</span><span
3401 class="ec-lmtt-10"> collection-xetex</span>
3402 <a
3403 id="x1-44004r2"></a><span
3404 class="ec-lmtt-10">install:</span><span
3405 class="ec-lmtt-10"> arabxetex</span>
3406 <a
3407 id="x1-44006r3"></a><span
3408 class="ec-lmtt-10">...</span>
3409 <a
3410 id="x1-44008r4"></a><span
3411 class="ec-lmtt-10">install:</span><span
3412 class="ec-lmtt-10"> xetex</span>
3413 <a
3414 id="x1-44010r5"></a><span
3415 class="ec-lmtt-10">install:</span><span
3416 class="ec-lmtt-10"> xetexconfig</span>
3417 <a
3418 id="x1-44012r6"></a><span
3419 class="ec-lmtt-10">install:</span><span
3420 class="ec-lmtt-10"> xetex.i386-linux</span>
3421 <a
3422 id="x1-44014r7"></a><span
3423 class="ec-lmtt-10">running</span><span
3424 class="ec-lmtt-10"> post</span><span
3425 class="ec-lmtt-10"> install</span><span
3426 class="ec-lmtt-10"> action</span><span
3427 class="ec-lmtt-10"> for</span><span
3428 class="ec-lmtt-10"> xetex</span>
3429 <a
3430 id="x1-44016r8"></a><span
3431 class="ec-lmtt-10">install:</span><span
3432 class="ec-lmtt-10"> xetex-def</span>
3433 <a
3434 id="x1-44018r9"></a><span
3435 class="ec-lmtt-10">...</span>
3436 <a
3437 id="x1-44020r10"></a><span
3438 class="ec-lmtt-10">running</span><span
3439 class="ec-lmtt-10"> mktexlsr</span>
3440 <a
3441 id="x1-44022r11"></a><span
3442 class="ec-lmtt-10">mktexlsr:</span><span
3443 class="ec-lmtt-10"> Updating</span><span
3444 class="ec-lmtt-10"> /usr/local/texlive/2026/texmf-dist/ls-R...</span>
3445 <a
3446 id="x1-44024r12"></a><span
3447 class="ec-lmtt-10">...</span>
3448 <a
3449 id="x1-44026r13"></a><span
3450 class="ec-lmtt-10">running</span><span
3451 class="ec-lmtt-10"> fmtutil-sys</span><span
3452 class="ec-lmtt-10"> --missing</span>
3453 <a
3454 id="x1-44028r14"></a><span
3455 class="ec-lmtt-10">...</span>
3456 <a
3457 id="x1-44030r15"></a><span
3458 class="ec-lmtt-10">Transcript</span><span
3459 class="ec-lmtt-10"> written</span><span
3460 class="ec-lmtt-10"> on</span><span
3461 class="ec-lmtt-10"> xelatex.log.</span>
3462 <a
3463 id="x1-44032r16"></a><span
3464 class="ec-lmtt-10">fmtutil:</span><span
3465 class="ec-lmtt-10"> /usr/local/texlive/2026/texmf-var/web2c/xetex/xelatex.fmt</span><span
3466 class="ec-lmtt-10"> installed.</span></pre>
3467 <!--l. 1630--><p class="indent" > As you can see, <span
3468 class="ec-lmss-12">tlmgr </span>installs dependencies, and takes care of any necessary post-install
3469 actions, including updating the filename database and (re)generating formats. In the above, we
3470 generated new formats for XeTeX.
3471 </p><!--l. 1635--><p class="indent" > To describe a package (or collection or scheme): </p><div class="alltt">
3472
3473 <div class="obeylines-v">
3474 <br /><span
3475 class="ec-lmtt-12">&#x003E;</span><span
3476 class="ec-lmtt-12"> </span><span
3477 class="ec-lmtk-10x-x-120">tlmgr</span><span
3478 class="ec-lmtk-10x-x-120"> show</span><span
3479 class="ec-lmtk-10x-x-120"> collection-latexextra</span>
3480 </div>
3481 </div> which produces output like this:
3482 <pre class="fancyvrb" id="fancyvrb12"><a
3483 id="x1-44034r1"></a><span
3484 class="ec-lmtt-10">package:</span><span
3485 class="ec-lmtt-10"> </span><span
3486 class="ec-lmtt-10"> </span><span
3487 class="ec-lmtt-10"> </span><span
3488 class="ec-lmtt-10"> collection-latexextra</span>
3489 <a
3490 id="x1-44036r2"></a><span
3491 class="ec-lmtt-10">category:</span><span
3492 class="ec-lmtt-10"> </span><span
3493 class="ec-lmtt-10"> </span><span
3494 class="ec-lmtt-10"> Collection</span>
3495 <a
3496 id="x1-44038r3"></a><span
3497 class="ec-lmtt-10">shortdesc:</span><span
3498 class="ec-lmtt-10"> </span><span
3499 class="ec-lmtt-10"> LaTeX</span><span
3500 class="ec-lmtt-10"> supplementary</span><span
3501 class="ec-lmtt-10"> packages</span>
3502 <a
3503 id="x1-44040r4"></a><span
3504 class="ec-lmtt-10">longdesc:</span><span
3505 class="ec-lmtt-10"> </span><span
3506 class="ec-lmtt-10"> </span><span
3507 class="ec-lmtt-10"> A</span><span
3508 class="ec-lmtt-10"> very</span><span
3509 class="ec-lmtt-10"> large</span><span
3510 class="ec-lmtt-10"> collection</span><span
3511 class="ec-lmtt-10"> of</span><span
3512 class="ec-lmtt-10"> add-on</span><span
3513 class="ec-lmtt-10"> packages</span><span
3514 class="ec-lmtt-10"> for</span><span
3515 class="ec-lmtt-10"> LaTeX.</span>
3516 <a
3517 id="x1-44042r5"></a><span
3518 class="ec-lmtt-10">installed:</span><span
3519 class="ec-lmtt-10"> </span><span
3520 class="ec-lmtt-10"> Yes</span>
3521 <a
3522 id="x1-44044r6"></a><span
3523 class="ec-lmtt-10">revision:</span><span
3524 class="ec-lmtt-10"> </span><span
3525 class="ec-lmtt-10"> </span><span
3526 class="ec-lmtt-10"> 46963</span>
3527 <a
3528 id="x1-44046r7"></a><span
3529 class="ec-lmtt-10">sizes:</span><span
3530 class="ec-lmtt-10"> </span><span
3531 class="ec-lmtt-10"> </span><span
3532 class="ec-lmtt-10"> </span><span
3533 class="ec-lmtt-10"> </span><span
3534 class="ec-lmtt-10"> </span><span
3535 class="ec-lmtt-10"> 657941k</span></pre>
3536 <!--l. 1650--><p class="indent" > Last and most important, for full documentation see <a
3537 href="https://tug.org/texlive/tlmgr.html" class="url" ><span
3538 class="ec-lmtt-12">https://tug.org/texlive/tlmgr.html</span></a>,
3539 or: </p><div class="alltt">
3540
3541 <div class="obeylines-v">
3542 <br /><span
3543 class="ec-lmtt-12">&#x003E;</span><span
3544 class="ec-lmtt-12"> </span><span
3545 class="ec-lmtk-10x-x-120">tlmgr</span><span
3546 class="ec-lmtk-10x-x-120"> -help</span>
3547 </div>
3548 </div>
3549
3550
3551
3552 <h3 class="sectionHead"><span class="titlemark">6 </span> <a
3553 id="x1-450006"></a>Notes on Windows</h3>
3554
3555 <h4 class="subsectionHead"><span class="titlemark">6.1 </span> <a
3556 id="x1-460006.1"></a>Windows-specific features</h4>
3557 <!--l. 1663--><p class="noindent" >Under Windows, the installer does some extra things:
3558 </p><dl class="description"><dt class="description"><a
3559 id="x1-46001x6.1"></a>
3560 <span
3561 class="ec-lmbx-12">Menus and shortcuts.</span> </dt><dd
3562 class="description">
3563 <!--l. 1665--><p class="noindent" >A new ‘TeX Live’ submenu of the Start menu is installed. This contains entries for
3564 some GUI programs, such as <span
3565 class="ec-lmss-12">tlshell </span>(a GUI for <span
3566 class="ec-lmss-12">tlmgr</span>) and <span
3567 class="ec-lmss-12">dviout</span>, and some entries
3568 for documentation.
3569 </p></dd><dt class="description"><a
3570 id="x1-46002x6.1"></a>
3571 <span
3572 class="ec-lmbx-12">File associations.</span> </dt><dd
3573 class="description">
3574 <!--l. 1670--><p class="noindent" >If enabled, <span
3575 class="ec-lmss-12">TeXworks </span>and <span
3576 class="ec-lmss-12">Dviout </span>become either the default program for their
3577 respective filetypes, or get an entry in the ‘Open with’ right-click menus of those
3578 filetypes. However, higher-priority ‘User Choice’ file associations, which can only
3579 be specified interactively, can get in the way.
3580 </p></dd><dt class="description"><a
3581 id="x1-46003x6.1"></a>
3582 <span
3583 class="ec-lmbx-12">PostScript support.</span> </dt><dd
3584 class="description">
3585 <!--l. 1677--><p class="noindent" >For PostScript files, a PSviewer filetype now converts PostScript to a temporary
3586 PDF, which is then displayed by the default PDF viewer.
3587 </p></dd><dt class="description"><a
3588 id="x1-46004x6.1"></a>
3589 <span
3590 class="ec-lmbx-12">Automatic path adjustment.</span> </dt><dd
3591 class="description">
3592 <!--l. 1681--><p class="noindent" >No manual configuration steps are required.
3593 </p></dd><dt class="description"><a
3594 id="x1-46005x6.1"></a>
3595 <span
3596 class="ec-lmbx-12">Uninstaller.</span> </dt><dd
3597 class="description">
3598 <!--l. 1683--><p class="noindent" >The installer creates an entry for TeX Live, either under ‘Add/Remove Programs’
3599 (admin installation) or under the TeX Live menu (single-user installation).
3600 </p></dd><dt class="description"><a
3601 id="x1-46006x6.1"></a>
3602 <span
3603 class="ec-lmbx-12">Write-protect.</span> </dt><dd
3604 class="description">
3605 <!--l. 1687--><p class="noindent" >For an admin installation, the TeX Live directories are write-protected, at least if
3606 TeX Live is installed on a normal NTFS-formatted non-removable disk.</p></dd></dl>
3607 <!--l. 1692--><p class="indent" > Also, have a look at <span
3608 class="ec-lmtt-12">tlaunch</span>, described in section <a
3609 href="#x1-400004.1">4.1<!--tex4ht:ref: sec:sharedinstall --></a>, for a different approach.
3610
3611 </p>
3612 <h4 class="subsectionHead"><span class="titlemark">6.2 </span> <a
3613 id="x1-470006.2"></a>Additional software included on Windows</h4>
3614 <!--l. 1697--><p class="noindent" >To be complete, a TeX Live installation needs support programs that are not commonly found
3615 on a Windows machine. TeX Live provides the missing pieces. These programs are all installed
3616 as part of TeX Live only on Windows.
3617 </p><!--l. 1701--><p class="indent" >
3618 </p><dl class="description"><dt class="description"><a
3619 id="x1-47001x6.2"></a>
3620 <span
3621 class="ec-lmbx-12">Perl, Tcl/Tk and Ghostscript.</span> </dt><dd
3622 class="description">
3623
3624
3625 <!--l. 1702--><p class="noindent" >Because of the importance of Perl and Ghostscript, and because the installer and
3626 tlshell GUIs are written in Tcl/Tk, TeX Live includes ‘hidden’ copies of these
3627 programs. TeX Live programs that need them know where to find them, but they
3628 don’t betray their presence through environment variables or registry settings.
3629 They aren’t full-scale installations (except for Ghostscript), and shouldn’t interfere
3630 with any system installations of Perl, Tcl/Tk or Ghostscript. See subsection <a
3631 href="#x1-480006.3">6.3<!--tex4ht:ref: sec:externalwndws --></a>
3632 how to tell TeX Live that you want to use your own external installations for
3633 contributed scripts within TeX Live.
3634 </p></dd><dt class="description"><a
3635 id="x1-47002x6.2"></a>
3636 <span
3637 class="ec-lmbx-12">dviout.</span> </dt><dd
3638 class="description">
3639 <!--l. 1713--><p class="noindent" >Also installed is <span
3640 class="ec-lmss-12">dviout</span>, a DVI viewer. At first, when you preview files with <span
3641 class="ec-lmss-12">dviout</span>,
3642 it will create fonts, because screen fonts were not installed. After a while, you will
3643 have created most of the fonts you use, and you will rarely see the font-creation
3644 window. More information can be found in the (highly recommended) on-line help.
3645 </p></dd><dt class="description"><a
3646 id="x1-47003x6.2"></a>
3647 <span
3648 class="ec-lmbx-12">TeXworks.</span> </dt><dd
3649 class="description">
3650 <!--l. 1720--><p class="noindent" >TeXworks is a TeX-oriented editor with an integrated PDF viewer.
3651 </p></dd><dt class="description"><a
3652 id="x1-47004x6.2"></a>
3653 <span
3654 class="ec-lmbx-12">Command-line tools.</span> </dt><dd
3655 class="description">
3656 <!--l. 1723--><p class="noindent" >A number of Windows ports of common Unix command-line programs are installed
3657 along with the usual TeX Live binaries. These include <span
3658 class="ec-lmss-12">gzip</span>, <span
3659 class="ec-lmss-12">zip</span>, <span
3660 class="ec-lmss-12">unzip</span>, and the
3661 utilities from the <span
3662 class="ec-lmss-12">poppler </span>suite (<span
3663 class="ec-lmss-12">pdfinfo</span>, <span
3664 class="ec-lmss-12">pdffonts</span>, …).
3665 </p></dd><dt class="description"><a
3666 id="x1-47005x6.2"></a>
3667 <span
3668 class="ec-lmbx-12">fc-list, fc-cache, </span><span
3669 class="ec-lmbx-12">…</span> </dt><dd
3670 class="description">
3671 <!--l. 1729--><p class="noindent" >The tools from the <span
3672 class="ec-lmss-12">fontconfig </span>library allow XeTeX to find system fonts on Windows.
3673 You can use <span
3674 class="ec-lmss-12">fc-list </span>to determine the font names to pass to XeTeX’s extended <span
3675 class="ec-lmtt-12">\font</span>
3676 command. If necessary, run <span
3677 class="ec-lmss-12">fc-cache </span>first to update font information.
3678 </p>
3679 </dd></dl>
3680
3681 <h4 class="subsectionHead"><span class="titlemark">6.3 </span> <a
3682 id="x1-480006.3"></a>Using external Perl, Tcl/Tk and Ghostscript installations</h4>
3683 <!--l. 1741--><p class="noindent" >Normally, TeX Live will use its built-in Perl, Tcl/Tk and Ghostscript also for contributed
3684 scripts within TeX Live. If you wish to use your own external versions, then you can configure
3685 that in the <span
3686 class="ec-lmtt-12">texmf.cnf </span>file <span
3687 class="ec-lmri-12">in the root of the installation</span>.
3688 </p><!--l. 1746--><p class="indent" > For Perl, you need to add a line
3689
3690
3691 </p>
3692 <pre class="verbatim" id="verbatim-2">
3693 <pre class="fancyvrb" id="fancyvrb13"><a
3694 id="x1-48002r1"></a>TEXLIVE_WINDOWS_TRY_EXTERNAL_PERL = 1</pre>
3695 </pre>
3696 <!--l. 1749--><p class="nopar" >TeX Live (specifically, <span
3697 class="ec-lmtt-12">bin/windows/runscript.tlu</span>) will then search for <span
3698 class="ec-lmtt-12">perl.exe </span>on the
3699 search path, except for scripts which belong to the TeX Live infrastructure. This is the most
3700 likely setting of the three to be useful; although the TeX Live Perl includes many additional
3701 modules, it cannot support all third-party scripts.
3702 </p><!--l. 1756--><p class="indent" > Similarly, for Tcl/Tk you need a line
3703
3704
3705 </p>
3706 <pre class="verbatim" id="verbatim-3">
3707 <pre class="fancyvrb" id="fancyvrb14"><a
3708 id="x1-48004r1"></a>TEXLIVE_WINDOWS_TRY_EXTERNAL_TCL = 1</pre>
3709 </pre>
3710 <!--l. 1759--><p class="nopar" >TeX Live will then search for <span
3711 class="ec-lmtt-12">tclkit.exe</span>, <span
3712 class="ec-lmtt-12">wish.exe</span>, <span
3713 class="ec-lmtt-12">wish85.exe</span>, <span
3714 class="ec-lmtt-12">wish86.exe </span>and
3715 <span
3716 class="ec-lmtt-12">wish87.exe </span>on the searchpath.
3717 </p><!--l. 1764--><p class="indent" > Ghostscript is handled differently, in that you need to specify the filename or the full path
3718 of your command-line Ghostscript: </p><div class="alltt">
3719
3720 <div class="obeylines-v">
3721 <br /><span
3722 class="ec-lmtt-12">TEXLIVE_WINDOWS_EXTERNAL_GS</span><span
3723 class="ec-lmtt-12"> =</span><span
3724 class="ec-lmtt-12"> </span><span
3725 class="ec-lmro-12">path</span><span
3726 class="ec-lmro-12"> of</span><span
3727 class="ec-lmro-12"> command-line</span><span
3728 class="ec-lmro-12"> ghostscript</span>
3729 </div>
3730 </div> Another difference is that the Ghostscript shipped with TeX Live is complete, with only
3731 documentation and printer drivers omitted. So it’s unlikely you’ll have any need to override
3732 it.
3733 <!--l. 1773--><p class="indent" > See also section <a
3734 href="#x1-560007.1.2">7.1.2<!--tex4ht:ref: sec:configfiles --></a> about <span
3735 class="ec-lmtt-12">texmf.cnf</span>.
3736
3737 </p>
3738 <h4 class="subsectionHead"><span class="titlemark">6.4 </span> <a
3739 id="x1-490006.4"></a>User Profile is Home</h4>
3740 <!--l. 1779--><p class="noindent" >The Windows counterpart of a Unix home directory is the <span class="obeylines-h"><code class="verb">%USERPROFILE%</code></span> directory. Under
3741 Windows Vista and later it is <span class="obeylines-h"><code class="verb">C:\Users\&#x003C;username&#x003E;</code></span>. In the <span
3742 class="ec-lmtt-12">texmf.cnf </span>file, and Kpathsea in
3743 general, <span class="obeylines-h"><code class="verb">~</code></span> will expand appropriately on both Windows and Unix.
3744
3745 </p>
3746 <h4 class="subsectionHead"><span class="titlemark">6.5 </span> <a
3747 id="x1-500006.5"></a>The Windows registry</h4>
3748 <!--l. 1789--><p class="noindent" >Windows stores nearly all configuration data in its registry. The registry contains a set of
3749 hierarchically organized keys, with several root keys. The most important ones for
3750 installation programs are <span class="path"><span
3751 class="ec-lmtt-12">HKEY_CURRENT_USER</span></span> and <span class="path"><span
3752 class="ec-lmtt-12">HKEY_LOCAL_MACHINE</span></span>, <span class="path"><span
3753 class="ec-lmtt-12">HKCU</span></span> and <span class="path"><span
3754 class="ec-lmtt-12">HKLM</span></span> in short. The <span class="path"><span
3755 class="ec-lmtt-12">HKCU</span></span> part of the registry is in the user’s home
3756 directory (see section <a
3757 href="#x1-490006.4">6.4<!--tex4ht:ref: sec:winhome --></a>). <span class="path"><span
3758 class="ec-lmtt-12">HKLM</span></span> is normally in a subdirectory of the Windows
3759 directory.
3760 </p><!--l. 1797--><p class="indent" > In some cases, system information could be obtained from environment variables
3761 but for other information, for example the location of shortcuts, it is necessary to
3762 consult the registry. Setting environment variables permanently also requires registry
3763 access.
3764
3765 </p>
3766 <h4 class="subsectionHead"><span class="titlemark">6.6 </span> <a
3767 id="x1-510006.6"></a>Windows permissions</h4>
3768 <!--l. 1806--><p class="noindent" >In later versions of Windows, a distinction is made between regular users and administrators,
3769 where only the latter have free access to almost the entire operating system. We have made an
3770
3771
3772 effort to make TeX Live installable without administrative privileges.
3773 </p><!--l. 1811--><p class="indent" > If the installer is started with administrative permissions, there is an option to install for
3774 all users. If this option is chosen, shortcuts are created for all users, and the system search
3775 path is modified. Otherwise, shortcuts and menu entries are created for the current user, and
3776 the user search path is modified.
3777 </p><!--l. 1817--><p class="indent" > Regardless of administrator status, the default root of TeX Live proposed by the installer is
3778 always under <span class="obeylines-h"><code class="verb">%SystemDrive%</code></span>. The installer always tests whether the root is writable for the
3779 current user.
3780 </p><!--l. 1821--><p class="indent" > A problem may arise if the user is not an administrator and TeX already exists in the
3781 search path. Since the effective search path consists of the system search path followed by the
3782 user search path, the new TeX Live would never get precedence. As a workaround, the
3783 installer creates a shortcut to the command-prompt in which the new TeX Live binary
3784 directory is prepended to the local search path. The new TeX Live will be always usable
3785 from within such a command-prompt. The shortcut for TeXworks, if installed, also
3786 prepends TeX Live to the search path, so it should also be immune to this path
3787 problem.
3788 </p><!--l. 1831--><p class="indent" > You should be aware that even if you are logged in as administrator, you need to explicitly
3789 ask for administrator privileges. In fact, there is not much point in logging in as administrator.
3790 Instead, right-clicking on the program or shortcut that you want to run usually gives you a
3791 choice ‘Run as administrator’.
3792
3793 </p>
3794 <h4 class="subsectionHead"><span class="titlemark">6.7 </span> <a
3795 id="x1-520006.7"></a>Increasing maximum memory on Windows and Cygwin</h4>
3796 <!--l. 1841--><p class="noindent" >Windows and Cygwin (see section <a
3797 href="#x1-180003.1.4">3.1.4<!--tex4ht:ref: sec:cygwin --></a> for Cygwin installation specifics) users may find that
3798 they run out of memory when running some of the programs shipped with TeX Live. For
3799 example, <span
3800 class="ec-lmss-12">asy </span>might run out of memory if you try to allocate an array of 25,000,000 reals, and
3801 LuaTeX might run out of memory if you try to process a document with a lot of big
3802 fonts.
3803 </p><!--l. 1848--><p class="indent" > For Cygwin, you can increase the amount of available memory by following the instructions
3804 in the Cygwin User’s Guide (<a
3805 href="https://cygwin.com/cygwin-ug-net/setup-maxmem.html" class="url" ><span
3806 class="ec-lmtt-12">https://cygwin.com/cygwin-ug-net/setup-maxmem.html</span></a>).
3807 </p><!--l. 1852--><p class="indent" > For Windows, you have to create a file, say <span
3808 class="ec-lmtt-12">moremem.reg</span>, with these four lines:
3809 </p><!--l. 1855--><p class="indent" >
3810 </p>
3811 <pre class="fancyvrb" id="fancyvrb15"><a
3812 id="x1-52002r1"></a><span
3813 class="ec-lmtt-10x-x-109">Windows</span><span
3814 class="ec-lmtt-10x-x-109"> Registry</span><span
3815 class="ec-lmtt-10x-x-109"> Editor</span><span
3816 class="ec-lmtt-10x-x-109"> Version</span><span
3817 class="ec-lmtt-10x-x-109"> 5.00</span>
3818 <a
3819 id="x1-52004r2"></a>
3820 <a
3821 id="x1-52006r3"></a><span
3822 class="ec-lmtt-10x-x-109">[HKEY_LOCAL_MACHINE\Software\Cygwin]</span>
3823 <a
3824 id="x1-52008r4"></a><span
3825 class="ec-lmtt-10x-x-109">&#x0022;heap_chunk_in_mb&#x0022;=dword:ffffff00</span></pre>
3826 <!--l. 1862--><p class="noindent" >and then execute the command <span
3827 class="ec-lmtt-12">regedit /s moremem.reg </span>as administrator. (If
3828 you want to change memory only for the current user instead of system-wide, use
3829 <span
3830 class="ec-lmtt-12">HKEY_CURRENT_USER</span>.)
3831
3832 </p>
3833 <h3 class="sectionHead"><span class="titlemark">7 </span> <a
3834 id="x1-530007"></a>A user’s guide to Web2C</h3>
3835 <!--l. 1869--><p class="noindent" >Web2C is an integrated collection of TeX-related programs: TeX itself, Metafont, MetaPost,
3836
3837
3838 BibTeX, etc. It is the heart of TeX Live. The home page for Web2C, with the current manual
3839 and more, is <a
3840 href="https://tug.org/web2c" class="url" ><span
3841 class="ec-lmtt-12">https://tug.org/web2c</span></a>.
3842 </p><!--l. 1874--><p class="indent" > A bit of history: The original implementation was by Tomas Rokicki who, in
3843 1987, developed a first TeX-to-C system based on change files under Unix, which
3844 were primarily the original work of Howard Trickey and Pavel Curtis. Tim Morgan
3845 became the maintainer of the system, and during this period the name changed to
3846 Web-to-C. In 1990, Karl Berry took over the work, assisted by dozens of additional
3847 contributors, and in 1997 he handed the baton to Olaf Weber, who returned it to Karl in
3848 2006.
3849 </p><!--l. 1883--><p class="indent" > The Web2C system runs on Unix, Windows, macOS, and other operating systems. It uses
3850 Knuth’s original sources for TeX and other basic programs written in the <span
3851 class="ec-lmtt-12">WEB </span>literate
3852 programming system and translates them into C source code. The core TeX programs handled
3853 in this way are:
3854 </p><!--l. 1889--><p class="indent" >
3855 </p><dl class="list1"><dt class="list">
3856 <span
3857 class="ec-lmss-12">bibtex</span> </dt><dd
3858 class="list">
3859 <!--l. 1890--><p class="noindent" >Maintaining bibliographies.
3860 </p></dd><dt class="list">
3861 <span
3862 class="ec-lmss-12">dvicopy</span> </dt><dd
3863 class="list">
3864 <!--l. 1891--><p class="noindent" >Expands virtual font references in DVI files.
3865 </p></dd><dt class="list">
3866 <span
3867 class="ec-lmss-12">dvitomp</span> </dt><dd
3868 class="list">
3869 <!--l. 1892--><p class="noindent" >DVI to MPX (MetaPost pictures).
3870 </p></dd><dt class="list">
3871 <span
3872 class="ec-lmss-12">dvitype</span> </dt><dd
3873 class="list">
3874 <!--l. 1893--><p class="noindent" >DVI to human-readable text.
3875 </p></dd><dt class="list">
3876 <span
3877 class="ec-lmss-12">gftodvi</span> </dt><dd
3878 class="list">
3879 <!--l. 1894--><p class="noindent" >Generic font proofsheets.
3880 </p></dd><dt class="list">
3881 <span
3882 class="ec-lmss-12">gftopk</span> </dt><dd
3883 class="list">
3884 <!--l. 1895--><p class="noindent" >Generic to packed fonts.
3885 </p></dd><dt class="list">
3886 <span
3887 class="ec-lmss-12">gftype</span> </dt><dd
3888 class="list">
3889 <!--l. 1896--><p class="noindent" >GF to human-readable text.
3890 </p></dd><dt class="list">
3891 <span
3892 class="ec-lmss-12">mf </span> </dt><dd
3893 class="list">
3894 <!--l. 1897--><p class="noindent" >Creating typeface families.
3895 </p></dd><dt class="list">
3896 <span
3897 class="ec-lmss-12">mft</span> </dt><dd
3898 class="list">
3899 <!--l. 1898--><p class="noindent" >Prettyprinting Metafont source.
3900 </p></dd><dt class="list">
3901 <span
3902 class="ec-lmss-12">mpost</span> </dt><dd
3903 class="list">
3904 <!--l. 1899--><p class="noindent" >Creating technical diagrams.
3905 </p></dd><dt class="list">
3906 <span
3907 class="ec-lmss-12">patgen</span> </dt><dd
3908 class="list">
3909
3910
3911 <!--l. 1900--><p class="noindent" >Creating hyphenation patterns.
3912 </p></dd><dt class="list">
3913 <span
3914 class="ec-lmss-12">pktogf</span> </dt><dd
3915 class="list">
3916 <!--l. 1901--><p class="noindent" >Packed to generic fonts.
3917 </p></dd><dt class="list">
3918 <span
3919 class="ec-lmss-12">pktype</span> </dt><dd
3920 class="list">
3921 <!--l. 1902--><p class="noindent" >PK to human-readable text.
3922 </p></dd><dt class="list">
3923 <span
3924 class="ec-lmss-12">pltotf</span> </dt><dd
3925 class="list">
3926 <!--l. 1903--><p class="noindent" >Plain text property list to TFM.
3927 </p></dd><dt class="list">
3928 <span
3929 class="ec-lmss-12">pooltype</span> </dt><dd
3930 class="list">
3931 <!--l. 1904--><p class="noindent" >Display <span
3932 class="ec-lmtt-12">WEB </span>pool files.
3933 </p></dd><dt class="list">
3934 <span
3935 class="ec-lmss-12">tangle</span> </dt><dd
3936 class="list">
3937 <!--l. 1905--><p class="noindent" ><span
3938 class="ec-lmtt-12">WEB </span>to Pascal.
3939 </p></dd><dt class="list">
3940 <span
3941 class="ec-lmss-12">tex </span> </dt><dd
3942 class="list">
3943 <!--l. 1906--><p class="noindent" >Typesetting.
3944 </p></dd><dt class="list">
3945 <span
3946 class="ec-lmss-12">tftopl</span> </dt><dd
3947 class="list">
3948 <!--l. 1907--><p class="noindent" >TFM to plain text property list.
3949 </p></dd><dt class="list">
3950 <span
3951 class="ec-lmss-12">vftovp</span> </dt><dd
3952 class="list">
3953 <!--l. 1908--><p class="noindent" >Virtual font to virtual property list.
3954 </p></dd><dt class="list">
3955 <span
3956 class="ec-lmss-12">vptovf</span> </dt><dd
3957 class="list">
3958 <!--l. 1909--><p class="noindent" >Virtual property list to virtual font.
3959 </p></dd><dt class="list">
3960 <span
3961 class="ec-lmss-12">weave</span> </dt><dd
3962 class="list">
3963 <!--l. 1910--><p class="noindent" ><span
3964 class="ec-lmtt-12">WEB </span>to TeX.</p></dd></dl>
3965 <!--l. 1913--><p class="noindent" >The precise functions and syntax of these programs are described in the documentation of
3966 the individual packages and of Web2C itself. However, knowing a few principles
3967 governing the whole family of programs will help you take advantage of your Web2C
3968 installation.
3969 </p><!--l. 1918--><p class="indent" > All programs honor these standard GNU options:
3970 </p><dl class="list1"><dt class="list">
3971 <span
3972 class="ec-lmtt-12">--help</span> </dt><dd
3973 class="list">
3974 <!--l. 1920--><p class="noindent" >print basic usage summary.
3975 </p></dd><dt class="list">
3976 <span
3977 class="ec-lmtt-12">--version</span> </dt><dd
3978 class="list">
3979 <!--l. 1921--><p class="noindent" >print version information, then exit.</p></dd></dl>
3980 <!--l. 1924--><p class="indent" > And most also honor:
3981 </p><dl class="list1"><dt class="list">
3982 <span
3983 class="ec-lmtt-12">--verbose</span> </dt><dd
3984 class="list">
3985 <!--l. 1926--><p class="noindent" >print detailed progress report.</p></dd></dl>
3986
3987
3988 <!--l. 1929--><p class="indent" > For locating files the Web2C programs use the path searching library Kpathsea (
3989 <a
3990 href="https://tug.org/kpathsea" class="url" ><span
3991 class="ec-lmtt-12">https://tug.org/kpathsea</span></a>). This library uses a combination of environment variables and
3992 configuration files to optimize searching the (huge) collection of TeX files. Web2C can look at
3993 many directory trees simultaneously, which is useful in maintaining TeX’s standard
3994 distribution and local and personal extensions in distinct trees. To speed up file searches, the
3995 root of each tree has a file <span
3996 class="ec-lmtt-12">ls-R</span>, containing an entry showing the name and relative pathname
3997 for all files under that root.
3998
3999 </p>
4000 <h4 class="subsectionHead"><span class="titlemark">7.1 </span> <a
4001 id="x1-540007.1"></a>Kpathsea path searching</h4>
4002 <!--l. 1943--><p class="noindent" >Let us first describe the generic path searching mechanism of the Kpathsea library.
4003 </p><!--l. 1946--><p class="indent" > We call a <span
4004 class="ec-lmri-12">search path </span>a colon- or semicolon-separated list of <span
4005 class="ec-lmri-12">path elements</span>, which are
4006 basically directory names. A search path can come from (a combination of) many sources. To
4007 look up a file ‘<span
4008 class="ec-lmtt-12">my-file</span>’ along a path ‘<span
4009 class="ec-lmtt-12">.:/dir</span>’, Kpathsea checks each element of the path in
4010 turn: first <span
4011 class="ec-lmtt-12">./my-file</span>, then <span
4012 class="ec-lmtt-12">/dir/my-file</span>, returning the first match (or possibly all
4013 matches).
4014 </p><!--l. 1954--><p class="indent" > In order to adapt optimally to all operating systems’ conventions, on non-Unix
4015 systems Kpathsea can use filename separators different from colon (‘<span
4016 class="ec-lmtt-12">:</span>’) and slash
4017 (‘<span
4018 class="ec-lmtt-12">/</span>’).
4019 </p><!--l. 1958--><p class="indent" > To check a particular path element <span
4020 class="ec-lmro-12">p</span>, Kpathsea first checks if a prebuilt database (see
4021 “Filename database” on page <a
4022 href="#x1-620007.2">82<!--tex4ht:ref: sec:filename-database --></a>) applies to <span
4023 class="ec-lmro-12">p</span>, i.e., if the database is in a directory that is
4024 a prefix of <span
4025 class="ec-lmro-12">p</span>. If so, the path specification is matched against the contents of the
4026 database.
4027 </p><!--l. 1964--><p class="indent" > Although the simplest and most common path element is a directory name, Kpathsea
4028 supports additional features in search paths: layered default values, environment variable
4029 names, config file values, users’ home directories, and recursive subdirectory searching. Thus,
4030 we say that Kpathsea <span
4031 class="ec-lmri-12">expands </span>a path element, meaning it transforms all the specifications into
4032 basic directory name or names. This is described in the following sections in the same order as
4033 it takes place.
4034 </p><!--l. 1973--><p class="indent" > Note that if the filename being searched for is absolute or explicitly relative, i.e., starts
4035 with ‘<span
4036 class="ec-lmtt-12">/</span>’ or ‘<span
4037 class="ec-lmtt-12">./</span>’ or ‘<span
4038 class="ec-lmtt-12">../</span>’, Kpathsea simply checks if that file exists.
4039
4040 </p>
4041 <h5 class="subsubsectionHead"><span class="titlemark">7.1.1 </span> <a
4042 id="x1-550007.1.1"></a>Path sources</h5>
4043 <!--l. 1990--><p class="noindent" >A search path can come from many sources. In the order in which Kpathsea uses
4044 them:
4045 </p><!--l. 1993--><p class="indent" >
4046 </p><ol class="enumerate1" >
4047 <li
4048 class="enumerate" id="x1-55002x1">
4049 <!--l. 1995--><p class="noindent" >A user-set environment variable, for instance, <span
4050 class="ec-lmtt-12">TEXINPUTS</span>. Environment variables
4051 with a period and a program name appended override; e.g., if ‘<span
4052 class="ec-lmtt-12">latex</span>’ is the name
4053
4054
4055 of the program being run, then <span
4056 class="ec-lmtt-12">TEXINPUTS.latex </span>will override <span
4057 class="ec-lmtt-12">TEXINPUTS</span>.
4058 </p></li>
4059 <li
4060 class="enumerate" id="x1-55004x2">
4061 <!--l. 2000--><p class="noindent" >A program-specific configuration file, for example, a line ‘<span
4062 class="ec-lmtt-12">S /a:/b</span>’ in <span
4063 class="ec-lmss-12">dvips</span>’s
4064 <span
4065 class="ec-lmtt-12">config.ps</span>.
4066 </p></li>
4067 <li
4068 class="enumerate" id="x1-55006x3">
4069 <!--l. 2002--><p class="noindent" >A Kpathsea configuration file <span
4070 class="ec-lmtt-12">texmf.cnf</span>, containing a line like ‘<span
4071 class="ec-lmtt-12">TEXINPUTS=/c:/d</span>’
4072 (see below).
4073 </p></li>
4074 <li
4075 class="enumerate" id="x1-55008x4">
4076 <!--l. 2004--><p class="noindent" >The compile-time default.</p></li></ol>
4077 <!--l. 2006--><p class="noindent" >You can see each of these values for a given search path by using the debugging options (see
4078 “Debugging actions” on page <a
4079 href="#x1-660007.2.4">87<!--tex4ht:ref: sec:debugging --></a>).
4080
4081 </p>
4082 <h5 class="subsubsectionHead"><span class="titlemark">7.1.2 </span> <a
4083 id="x1-560007.1.2"></a>Config files</h5>
4084 <!--l. 2013--><p class="noindent" >Kpathsea reads <span
4085 class="ec-lmri-12">runtime configuration files </span>named <span
4086 class="ec-lmtt-12">texmf.cnf </span>for search path and
4087 other definitions. The search path <span
4088 class="ec-lmtt-12">TEXMFCNF </span>is used to look for these files, but we do
4089 not recommend setting this (or any) environment variable to override the system
4090 directories.
4091 </p><!--l. 2019--><p class="indent" > Instead, normal installation results in a file <span
4092 class="ec-lmtt-12">.../2026/texmf.cnf</span>. If you must make
4093 changes to the defaults (not normally necessary), this is the place to put them. The
4094 main configuration file is in <span
4095 class="ec-lmtt-12">.../2026/texmf-dist/web2c/texmf.cnf</span>. You should
4096 not edit this latter file, as your changes will be lost when the distributed version is
4097 updated.
4098 </p><!--l. 2026--><p class="indent" > As an aside, if you merely wish to add a personal directory to a particular search path,
4099 setting an environment variable is a reasonable method:
4100
4101
4102 </p>
4103 <pre class="verbatim" id="verbatim-4">
4104 <pre class="fancyvrb" id="fancyvrb16"><a
4105 id="x1-56002r1"></a>  TEXINPUTS=.:/my/macro/dir:</pre>
4106 </pre>
4107 <!--l. 2031--><p class="nopar" >To keep the setting maintainable and portable over the years, use a trailing ‘<span
4108 class="ec-lmtt-12">:</span>’ (‘<span
4109 class="ec-lmtt-12">;</span>’ on
4110 Windows) to insert the system paths, instead of trying to write them all out explicitly (see
4111 section <a
4112 href="#x1-580007.1.4">7.1.4<!--tex4ht:ref: sec:default-expansion --></a>). Another option is to use the <span
4113 class="ec-lmtt-12">TEXMFHOME </span>tree (see section <a
4114 href="#x1-240003.2.3">3.2.3<!--tex4ht:ref: sec:directories --></a>).
4115 </p><!--l. 2038--><p class="indent" > <span
4116 class="ec-lmri-12">All </span><span
4117 class="ec-lmtt-12">texmf.cnf </span>files in the search path will be read and definitions in earlier files override
4118 those in later files. For example, with a search path of <span class="obeylines-h"><code class="verb">.:$TEXMF</code></span>, values from <span
4119 class="ec-lmtt-12">./texmf.cnf</span>
4120 override those from <span class="obeylines-h"><code class="verb">$TEXMF/texmf.cnf</code></span>.
4121 </p>
4122 <ul class="itemize1">
4123 <li class="itemize">
4124 <!--l. 2045--><p class="noindent" >Comments start with <span
4125 class="ec-lmtt-12">%</span>, either at the beginning of a line or preceded by whitespace,
4126 and continue to the end of the line.
4127 </p></li>
4128 <li class="itemize">
4129 <!--l. 2048--><p class="noindent" >Blank lines are ignored.
4130 </p></li>
4131 <li class="itemize">
4132 <!--l. 2050--><p class="noindent" >A <span
4133 class="ec-lmtt-12">\ </span>at the end of a line acts as a continuation character, i.e., the next line is
4134 appended. Whitespace at the beginning of continuation lines is not ignored.
4135 </p></li>
4136 <li class="itemize">
4137 <!--l. 2054--><p class="noindent" >Each remaining line has the form:<br
4138 class="newline" />   <span
4139 class="ec-lmro-12">variable </span>[<span
4140 class="ec-lmtt-12">.</span><span
4141 class="ec-lmro-12">progname</span>] [<span
4142 class="ec-lmtt-12">=</span>] <span
4143 class="ec-lmro-12">value</span><br
4144 class="newline" /> where the ‘<span
4145 class="ec-lmtt-12">=</span>’ and surrounding whitespace are optional. (But if <span
4146 class="ec-lmro-12">value </span>begins with
4147 ‘<span
4148 class="ec-lmtt-12">.</span>’, it is simplest to use the ‘<span
4149 class="ec-lmtt-12">=</span>’ to avoid the period being interpreted as the program
4150 name qualifier.)
4151 </p></li>
4152 <li class="itemize">
4153 <!--l. 2062--><p class="noindent" >The <span
4154 class="ec-lmro-12">variable </span>name may contain any character other than whitespace, ‘<span
4155 class="ec-lmtt-12">=</span>’, or ‘<span
4156 class="ec-lmtt-12">.</span>’,
4157 but sticking to ‘<span
4158 class="ec-lmtt-12">A-Za-z_</span>’ is safest.
4159 </p></li>
4160 <li class="itemize">
4161 <!--l. 2066--><p class="noindent" >If ‘<span
4162 class="ec-lmtt-12">.</span><span
4163 class="ec-lmro-12">progname</span>’ is present, the definition only applies if the program that is running
4164 is named <span
4165 class="ec-lmro-12">progname </span>or <span
4166 class="ec-lmro-12">progname</span><span
4167 class="ec-lmtt-12">.exe</span>. This allows different flavors of TeX to have
4168 different search paths, for example.
4169 </p></li>
4170 <li class="itemize">
4171 <!--l. 2071--><p class="noindent" >Considered as strings, <span
4172 class="ec-lmro-12">value </span>may contain any character. However, in practice
4173 most <span
4174 class="ec-lmtt-12">texmf.cnf </span>values are related to path expansion, and since various special
4175 characters are used in expansion (see section <a
4176 href="#x1-610007.1.7">7.1.7<!--tex4ht:ref: sec:cnf-special-chars --></a>), such as braces and commas,
4177 they cannot be used in directory names.
4178 </p><!--l. 2077--><p class="noindent" >A ‘<span
4179 class="ec-lmtt-12">;</span>’ in <span
4180 class="ec-lmro-12">value </span>is translated to ‘<span
4181 class="ec-lmtt-12">:</span>’ if running under Unix, in order to have a single
4182 <span
4183 class="ec-lmtt-12">texmf.cnf </span>that can support both Unix and Windows systems. This translation
4184
4185
4186 happens with any value, not just search paths, but fortunately in practice ‘<span
4187 class="ec-lmtt-12">;</span>’ is
4188 not needed in other values.
4189 </p><!--l. 2083--><p class="noindent" >The <span
4190 class="ec-lmtt-12">$</span><span
4191 class="ec-lmro-12">var</span><span
4192 class="ec-lmtt-12">.</span><span
4193 class="ec-lmro-12">prog </span>feature is not available on the right-hand side; instead, you must
4194 use an additional variable.
4195 </p></li>
4196 <li class="itemize">
4197 <!--l. 2087--><p class="noindent" >All definitions are read before anything is expanded, so variables can be referenced
4198 before they are defined.</p></li></ul>
4199 <!--l. 2090--><p class="noindent" >A configuration file fragment illustrating most of these points is shown below:
4200 </p><!--l. 2094--><p class="indent" >
4201 </p>
4202 <pre class="fancyvrb" id="fancyvrb17"><a
4203 id="x1-56004r1"></a><span
4204 class="ec-lmtt-10x-x-109">TEXMF</span><span
4205 class="ec-lmtt-10x-x-109"> </span><span
4206 class="ec-lmtt-10x-x-109"> </span><span
4207 class="ec-lmtt-10x-x-109"> </span><span
4208 class="ec-lmtt-10x-x-109"> </span><span
4209 class="ec-lmtt-10x-x-109"> </span><span
4210 class="ec-lmtt-10x-x-109"> </span><span
4211 class="ec-lmtt-10x-x-109"> </span><span
4212 class="ec-lmtt-10x-x-109"> </span><span
4213 class="ec-lmtt-10x-x-109"> </span><span
4214 class="ec-lmtt-10x-x-109"> </span><span
4215 class="ec-lmtt-10x-x-109"> </span><span
4216 class="ec-lmtt-10x-x-109"> </span><span
4217 class="ec-lmtt-10x-x-109"> </span><span
4218 class="ec-lmtt-10x-x-109"> =</span><span
4219 class="ec-lmtt-10x-x-109"> {$TEXMFLOCAL,!!$TEXMFMAIN}</span>
4220 <a
4221 id="x1-56006r2"></a><span
4222 class="ec-lmtt-10x-x-109">TEXINPUTS.latex</span><span
4223 class="ec-lmtt-10x-x-109"> </span><span
4224 class="ec-lmtt-10x-x-109"> </span><span
4225 class="ec-lmtt-10x-x-109"> </span><span
4226 class="ec-lmtt-10x-x-109"> =</span><span
4227 class="ec-lmtt-10x-x-109"> .;$TEXMF/tex/{latex,generic;}//</span>
4228 <a
4229 id="x1-56008r3"></a><span
4230 class="ec-lmtt-10x-x-109">TEXINPUTS.fontinst</span><span
4231 class="ec-lmtt-10x-x-109"> =</span><span
4232 class="ec-lmtt-10x-x-109"> .;$TEXMF/tex//;$TEXMF/fonts/afm//</span>
4233 <a
4234 id="x1-56010r4"></a><span
4235 class="ec-lmtt-10x-x-109">%</span><span
4236 class="ec-lmtt-10x-x-109"> e-TeX</span><span
4237 class="ec-lmtt-10x-x-109"> related</span><span
4238 class="ec-lmtt-10x-x-109"> files</span>
4239 <a
4240 id="x1-56012r5"></a><span
4241 class="ec-lmtt-10x-x-109">TEXINPUTS.elatex</span><span
4242 class="ec-lmtt-10x-x-109"> </span><span
4243 class="ec-lmtt-10x-x-109"> </span><span
4244 class="ec-lmtt-10x-x-109"> =</span><span
4245 class="ec-lmtt-10x-x-109"> .;$TEXMF/{etex,tex}/{latex,generic;}//</span>
4246 <a
4247 id="x1-56014r6"></a><span
4248 class="ec-lmtt-10x-x-109">TEXINPUTS.etex</span><span
4249 class="ec-lmtt-10x-x-109"> </span><span
4250 class="ec-lmtt-10x-x-109"> </span><span
4251 class="ec-lmtt-10x-x-109"> </span><span
4252 class="ec-lmtt-10x-x-109"> </span><span
4253 class="ec-lmtt-10x-x-109"> =</span><span
4254 class="ec-lmtt-10x-x-109"> .;$TEXMF/{etex,tex}/{eplain,plain,generic;}//</span></pre>
4255
4256 <h5 class="subsubsectionHead"><span class="titlemark">7.1.3 </span> <a
4257 id="x1-570007.1.3"></a>Path expansion</h5>
4258 <!--l. 2102--><p class="noindent" >Kpathsea recognizes certain special characters and constructions in search paths, similar to
4259 those available in Unix shells. As a general example, the path <span class="obeylines-h"><code class="verb">~$USER/{foo,bar}//baz</code></span>,
4260 expands to all subdirectories under directories <span
4261 class="ec-lmtt-12">foo </span>and <span
4262 class="ec-lmtt-12">bar </span>in <span
4263 class="ec-lmtt-12">$USER</span>’s home directory
4264 that contain a directory or file <span
4265 class="ec-lmtt-12">baz</span>. These expansions are explained in the sections
4266 below.
4267 </p>
4268 <h5 class="subsubsectionHead"><span class="titlemark">7.1.4 </span> <a
4269 id="x1-580007.1.4"></a>Default expansion</h5>
4270 <!--l. 2113--><p class="noindent" >If the highest-priority search path (see “Path sources” on page <a
4271 href="#x1-550007.1.1">75<!--tex4ht:ref: sec:path-sources --></a>) contains an <span
4272 class="ec-lmri-12">extra colon</span>
4273 (i.e., leading, trailing, or doubled), Kpathsea inserts at that point the next-highest-priority
4274 search path that is defined. If that inserted path has an extra colon, the same happens with
4275 the next highest. For example, given an environment variable setting
4276 </p>
4277 <div class="alltt">
4278
4279 <div class="obeylines-v">
4280 <br /><span
4281 class="ec-lmtt-12">&#x003E;</span><span
4282 class="ec-lmtt-12"> </span><span
4283 class="ec-lmtk-10x-x-120">setenv</span><span
4284 class="ec-lmtk-10x-x-120"> TEXINPUTS</span><span
4285 class="ec-lmtk-10x-x-120"> /home/karl:</span></div>
4286 </div> and a <span
4287 class="ec-lmtt-12">TEXINPUTS </span>value from <span
4288 class="ec-lmtt-12">texmf.cnf </span>of
4289 <div class="alltt">
4290
4291 <div class="obeylines-v">
4292 <br /><span
4293 class="ec-lmtt-12"> </span><span
4294 class="ec-lmtt-12"> .:$TEXMF//tex</span></div>
4295 </div> then the final value used for searching will be:
4296 <div class="alltt">
4297
4298
4299
4300 <div class="obeylines-v">
4301 <br /><span
4302 class="ec-lmtt-12"> </span><span
4303 class="ec-lmtt-12"> /home/karl:.:$TEXMF//tex</span></div>
4304 </div>
4305 <!--l. 2134--><p class="indent" > Since it would be useless to insert the default value in more than one place, Kpathsea
4306 changes only one extra ‘<span
4307 class="ec-lmtt-12">:</span>’ and leaves any others in place. It checks first for a leading ‘<span
4308 class="ec-lmtt-12">:</span>’, then
4309 a trailing ‘<span
4310 class="ec-lmtt-12">:</span>’, then a doubled ‘<span
4311 class="ec-lmtt-12">:</span>’.
4312
4313 </p>
4314 <h5 class="subsubsectionHead"><span class="titlemark">7.1.5 </span> <a
4315 id="x1-590007.1.5"></a>Brace expansion</h5>
4316 <!--l. 2142--><p class="noindent" >A useful feature is brace expansion, which means that, for instance, <span class="obeylines-h"><code class="verb">v{a,b}w</code></span> expands to
4317 <span class="obeylines-h"><code class="verb">vaw:vbw</code></span>. Nesting is allowed. This is used to implement multiple TeX hierarchies, by assigning
4318 a brace list to <span
4319 class="ec-lmtt-12">$TEXMF</span>. In the distributed <span
4320 class="ec-lmtt-12">texmf.cnf</span>, a definition like this (simplified for this
4321 example) is made:
4322
4323
4324 </p>
4325 <pre class="verbatim" id="verbatim-5">
4326 <pre class="fancyvrb" id="fancyvrb18"><a
4327 id="x1-59002r1"></a>  TEXMF = {$TEXMFVAR,$TEXMFHOME,!!$TEXMFLOCAL,!!$TEXMFDIST}</pre>
4328 </pre>
4329 <!--l. 2150--><p class="nopar" >We then use this to define, for example, the TeX input path:
4330
4331
4332 </p>
4333 <pre class="verbatim" id="verbatim-6">
4334 <pre class="fancyvrb" id="fancyvrb19"><a
4335 id="x1-59004r1"></a>  TEXINPUTS = .;$TEXMF/tex//</pre>
4336 </pre>
4337 <!--l. 2154--><p class="nopar" >which means that, after looking in the current directory, the <span
4338 class="ec-lmtt-12">$TEXMFVAR/tex</span>, <span
4339 class="ec-lmtt-12">$TEXMFHOME/tex</span>,
4340 <span
4341 class="ec-lmtt-12">$TEXMFLOCAL/tex </span>and <span
4342 class="ec-lmtt-12">$TEXMFDIST/tex </span>trees will be searched (the last two using <span
4343 class="ec-lmtt-12">ls-R </span>data
4344 base files).
4345
4346 </p>
4347 <h5 class="subsubsectionHead"><span class="titlemark">7.1.6 </span> <a
4348 id="x1-600007.1.6"></a>Subdirectory expansion</h5>
4349 <!--l. 2164--><p class="noindent" >Two or more consecutive slashes in a path element following a directory <span
4350 class="ec-lmro-12">d </span>is replaced by all
4351 subdirectories of <span
4352 class="ec-lmro-12">d</span>: first those subdirectories directly under <span
4353 class="ec-lmro-12">d</span>, then the subsubdirectories
4354 under those, and so on. At each level, the order in which the directories are searched is
4355 <span
4356 class="ec-lmri-12">unspecified</span>.
4357 </p><!--l. 2170--><p class="indent" > If you specify any filename components after the ‘<span
4358 class="ec-lmtt-12">//</span>’, only subdirectories with matching
4359 components are included. For example, ‘<span
4360 class="ec-lmtt-12">/a//b</span>’ expands into directories <span
4361 class="ec-lmtt-12">/a/1/b</span>, <span
4362 class="ec-lmtt-12">/a/2/b</span>,
4363 <span
4364 class="ec-lmtt-12">/a/1/1/b</span>, and so on, but not <span
4365 class="ec-lmtt-12">/a/b/c </span>or <span
4366 class="ec-lmtt-12">/a/1</span>.
4367 </p><!--l. 2175--><p class="indent" > Multiple ‘<span
4368 class="ec-lmtt-12">//</span>’ constructs in a path are possible, but ‘<span
4369 class="ec-lmtt-12">//</span>’ at the beginning of a path is
4370 ignored.
4371
4372 </p>
4373 <h5 class="subsubsectionHead"><span class="titlemark">7.1.7 </span> <a
4374 id="x1-610007.1.7"></a>Summary of special characters in <span
4375 class="ec-lmtt-12">texmf.cnf </span>files</h5>
4376 <!--l. 2181--><p class="noindent" >The following list summarizes the special characters and constructs in Kpathsea configuration
4377 files.
4378 </p><!--l. 2186--><p class="noindent" >
4379 </p><dl class="list1"><dt class="list">
4380 <span
4381 class="ec-lmtt-12">:</span> </dt><dd
4382 class="list">
4383 <!--l. 2187--><p class="noindent" >Separator in path specification; at the beginning or the end of a path, or doubled
4384 in the middle, it substitutes the default path expansion.
4385 </p></dd><dt class="list">
4386 <span
4387 class="ec-lmtt-12">;</span> </dt><dd
4388 class="list">
4389 <!--l. 2190--><p class="noindent" >Separator on non-Unix systems (acts like <span
4390 class="ec-lmtt-12">:</span>).
4391 </p></dd><dt class="list">
4392 <span
4393 class="ec-lmtt-12">$</span> </dt><dd
4394 class="list">
4395 <!--l. 2191--><p class="noindent" >Variable expansion.
4396 </p></dd><dt class="list">
4397 <span
4398 class="ec-lmtt-12">~</span> </dt><dd
4399 class="list">
4400 <!--l. 2192--><p class="noindent" >Represents the user’s home directory.
4401 </p></dd><dt class="list">
4402 <span
4403 class="ec-lmtt-12">{...}</span> </dt><dd
4404 class="list">
4405 <!--l. 2193--><p class="noindent" >Brace expansion.
4406 </p></dd><dt class="list">
4407 <span
4408 class="ec-lmtt-12">,</span> </dt><dd
4409 class="list">
4410
4411
4412 <!--l. 2194--><p class="noindent" >Separates items in brace expansion.
4413 </p></dd><dt class="list">
4414 <span
4415 class="ec-lmtt-12">//</span> </dt><dd
4416 class="list">
4417 <!--l. 2195--><p class="noindent" >Subdirectory expansion (can occur anywhere in a path, except at its beginning).
4418 </p></dd><dt class="list">
4419 <span
4420 class="ec-lmtt-12">%</span> and <span
4421 class="ec-lmtt-12">#</span></dt><dd
4422 class="list">
4423 <!--l. 2197--><p class="noindent" >Start of comment.
4424 </p></dd><dt class="list">
4425 <span
4426 class="ec-lmtt-12">\</span> </dt><dd
4427 class="list">
4428 <!--l. 2198--><p class="noindent" >At the end of a line, continuation character to allow multi-line entries.
4429 </p></dd><dt class="list">
4430 <span
4431 class="ec-lmtt-12">!!</span> </dt><dd
4432 class="list">
4433 <!--l. 2200--><p class="noindent" >Search <span
4434 class="ec-lmri-12">only </span>database to locate file, <span
4435 class="ec-lmri-12">do not </span>search the disk.</p></dd></dl>
4436 <!--l. 2204--><p class="indent" > Exactly when a character will be considered special or act as itself depends on the context
4437 in which it is used. The rules are inherent in the multiple levels of interpretation of the
4438 configuration (parsing, expansion, search, …) and so cannot be concisely stated, unfortunately.
4439 There is no general escape mechanism; in particular, ‘<span
4440 class="ec-lmtt-12">\</span>’ is not an “escape character” in
4441 <span
4442 class="ec-lmtt-12">texmf.cnf </span>files.
4443 </p><!--l. 2211--><p class="indent" > When it comes choosing directory names for installation, it is safest to avoid them
4444 all.
4445
4446 </p>
4447 <h4 class="subsectionHead"><span class="titlemark">7.2 </span> <a
4448 id="x1-620007.2"></a>Filename databases</h4>
4449 <!--l. 2217--><p class="noindent" >Kpathsea goes to some lengths to minimize disk accesses for searches. Nevertheless, in the
4450 standard TeX Live, or at any installation with enough directories, searching every possible
4451 directory for a given file will take an excessively long time. Therefore, Kpathsea can use an
4452 externally-built plain text “database” file named <span
4453 class="ec-lmtt-12">ls-R </span>that maps files to directories, thus
4454 avoiding the need to exhaustively search the disk.
4455 </p><!--l. 2225--><p class="indent" > A second database file <span
4456 class="ec-lmtt-12">aliases </span>allows you to give additional names to the files listed in
4457 <span
4458 class="ec-lmtt-12">ls-R</span>.
4459
4460 </p>
4461 <h5 class="subsubsectionHead"><span class="titlemark">7.2.1 </span> <a
4462 id="x1-630007.2.1"></a>The filename database</h5>
4463 <!--l. 2231--><p class="noindent" >As explained above, the name of the main filename database must be <span
4464 class="ec-lmtt-12">ls-R</span>. You can
4465 put one at the root of each TeX hierarchy in your installation that you wish to be
4466 searched (<span
4467 class="ec-lmtt-12">$TEXMF </span>by default). Kpathsea looks for <span
4468 class="ec-lmtt-12">ls-R </span>files along the <span
4469 class="ec-lmtt-12">TEXMFDBS</span>
4470 path.
4471 </p><!--l. 2237--><p class="indent" > The recommended way to create and maintain ‘<span
4472 class="ec-lmtt-12">ls-R</span>’ is to run the <span
4473 class="ec-lmtt-12">mktexlsr </span>script
4474 included with the distribution. It is invoked by the various ‘<span
4475 class="ec-lmtt-12">mktex</span>’… scripts. In principle, this
4476 script just runs the command </p><div class="alltt">
4477
4478
4479
4480 <div class="obeylines-v">
4481 <br /><span
4482 class="ec-lmtt-12">cd</span><span
4483 class="ec-lmtt-12"> </span><span
4484 class="ec-lmro-12">/your/texmf/root</span><span
4485 class="ec-lmtt-12"> &#x0026;&#x0026;</span><span
4486 class="ec-lmtt-12"> </span><span class="path"><span
4487 class="ec-lmtt-12">\</span></span><span
4488 class="ec-lmtt-12">ls</span><span
4489 class="ec-lmtt-12"> -1LAR</span><span
4490 class="ec-lmtt-12"> ./</span><span
4491 class="ec-lmtt-12"> &#x003E;ls-R</span>
4492 </div>
4493 </div> presuming your system’s <span
4494 class="ec-lmtt-12">ls </span>produces the right output format (GNU <span
4495 class="ec-lmtt-12">ls </span>is all right). To ensure
4496 that the database is always up-to-date, it is easiest to rebuild it regularly via <span
4497 class="ec-lmtt-12">cron</span>, so that it is
4498 automatically updated when the installed files change, such as after installing or updating a
4499 LaTeX package.
4500 <!--l. 2250--><p class="indent" > If a file is not found in the database, by default Kpathsea goes ahead and searches the disk.
4501 If a particular path element begins with ‘<span
4502 class="ec-lmtt-12">!!</span>’, however, <span
4503 class="ec-lmri-12">only </span>the database will be searched for
4504 that element, never the disk.
4505
4506 </p>
4507 <h5 class="subsubsectionHead"><span class="titlemark">7.2.2 </span> <a
4508 id="x1-640007.2.2"></a>kpsewhich: Standalone path searching</h5>
4509 <!--l. 2259--><p class="noindent" >The <span
4510 class="ec-lmtt-12">kpsewhich </span>program exercises path searching independent of any particular application.
4511 This can be useful as a sort of <span
4512 class="ec-lmtt-12">find </span>program to locate files in TeX hierarchies (this is used
4513 heavily in the distributed ‘<span
4514 class="ec-lmtt-12">mktex</span>’… scripts).
4515 </p>
4516 <div class="alltt">
4517
4518 <div class="obeylines-v">
4519 <br /><span
4520 class="ec-lmtt-12">&#x003E;</span><span
4521 class="ec-lmtt-12"> </span><span
4522 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4523 class="ec-lmtk-10x-x-120"> </span><span
4524 class="ec-lmro-12">option</span><span
4525 class="ec-lmtk-10x-x-120">…</span><span
4526 class="ec-lmtk-10x-x-120"> </span><span
4527 class="ec-lmro-12">filename</span><span
4528 class="ec-lmtk-10x-x-120">…</span>
4529 </div>
4530 </div> The options specified in <span
4531 class="ec-lmro-12">option </span>start with either ‘<span
4532 class="ec-lmtt-12">-</span>’ or ‘<span
4533 class="ec-lmtt-12">--</span>’, and any unambiguous
4534 abbreviation is accepted.
4535 <!--l. 2270--><p class="indent" > Kpathsea looks up each non-option argument on the command line as a filename, and
4536 returns the first file found. There is no option to return all the files with a particular name
4537 (you can run the Unix ‘<span
4538 class="ec-lmtt-12">find</span>’ utility for that).
4539 </p><!--l. 2275--><p class="indent" > The most common options are described next.
4540 </p><!--l. 2277--><p class="noindent" >
4541 </p><dl class="list1"><dt class="list">
4542 <span
4543 class="ec-lmtt-12">--dpi=</span><span
4544 class="ec-lmro-12">num</span> </dt><dd
4545 class="list">
4546 <!--l. 2278--><p class="noindent" > Set the resolution to <span
4547 class="ec-lmro-12">num</span>; this only affects ‘<span
4548 class="ec-lmtt-12">gf</span>’ and ‘<span
4549 class="ec-lmtt-12">pk</span>’ lookups. ‘<span
4550 class="ec-lmtt-12">-D</span>’ is a synonym,
4551 for compatibility with <span
4552 class="ec-lmss-12">dvips</span>. Default is 600.
4553 </p></dd><dt class="list">
4554 <span
4555 class="ec-lmtt-12">--format=</span><span
4556 class="ec-lmro-12">name</span> </dt><dd
4557 class="list">
4558 <!--l. 2283--><p class="noindent" ><br
4559 class="newline" />Set the format for lookup to <span
4560 class="ec-lmro-12">name</span>. By default, the format is guessed from the
4561 filename. For formats which do not have an associated unambiguous suffix, such as
4562 MetaPost support files and <span
4563 class="ec-lmss-12">dvips </span>configuration files, you have to specify the name as
4564 known to Kpathsea, such as <span
4565 class="ec-lmtt-12">tex </span>or <span
4566 class="ec-lmtt-12">enc files</span>. Run <span
4567 class="ec-lmtt-12">kpsewhich --help-formats</span>
4568 for a list.
4569 </p></dd><dt class="list">
4570 <span
4571 class="ec-lmtt-12">--mode=</span><span
4572 class="ec-lmro-12">string</span> </dt><dd
4573 class="list">
4574 <!--l. 2291--><p class="noindent" ><br
4575 class="newline" />Set the mode name to <span
4576 class="ec-lmro-12">string</span>; this only affects ‘<span
4577 class="ec-lmtt-12">gf</span>’ and ‘<span
4578 class="ec-lmtt-12">pk</span>’ lookups. No default:
4579
4580
4581 any mode will be found.
4582 </p></dd><dt class="list">
4583 <span
4584 class="ec-lmtt-12">--must-exist</span> </dt><dd
4585 class="list">
4586 <!--l. 2294--><p class="noindent" ><br
4587 class="newline" />Do everything possible to find the files, notably including searching the disk. By
4588 default, only the <span
4589 class="ec-lmtt-12">ls-R </span>database is checked, in the interest of efficiency.
4590 </p></dd><dt class="list">
4591 <span
4592 class="ec-lmtt-12">--path=</span><span
4593 class="ec-lmro-12">string</span> </dt><dd
4594 class="list">
4595 <!--l. 2298--><p class="noindent" ><br
4596 class="newline" />Search along the path <span
4597 class="ec-lmro-12">string </span>(colon-separated as usual), instead of guessing the
4598 search path from the filename. ‘<span
4599 class="ec-lmtt-12">//</span>’ and all the usual expansions are supported.
4600 The options ‘<span
4601 class="ec-lmtt-12">--path</span>’ and ‘<span
4602 class="ec-lmtt-12">--format</span>’ are mutually exclusive.
4603 </p></dd><dt class="list">
4604 <span
4605 class="ec-lmtt-12">--progname=</span><span
4606 class="ec-lmro-12">name</span> </dt><dd
4607 class="list">
4608 <!--l. 2303--><p class="noindent" ><br
4609 class="newline" />Set the program name to <span
4610 class="ec-lmro-12">name</span>. This can affect the search paths via the <span
4611 class="ec-lmtt-12">.</span><span
4612 class="ec-lmro-12">progname</span>
4613 feature. The default is <span
4614 class="ec-lmss-12">kpsewhich</span>.
4615 </p></dd><dt class="list">
4616 <span
4617 class="ec-lmtt-12">--show-path=</span><span
4618 class="ec-lmro-12">name</span> </dt><dd
4619 class="list">
4620 <!--l. 2308--><p class="noindent" ><br
4621 class="newline" />shows the path used for file lookups of file type <span
4622 class="ec-lmro-12">name</span>. Either a filename extension
4623 (<span
4624 class="ec-lmtt-12">.pk</span>, <span
4625 class="ec-lmtt-12">.vf</span>, etc.) or a name can be used, just as with ‘<span
4626 class="ec-lmtt-12">--format</span>’ option.
4627 </p></dd><dt class="list">
4628 <span
4629 class="ec-lmtt-12">--debug=</span><span
4630 class="ec-lmro-12">num</span> </dt><dd
4631 class="list">
4632 <!--l. 2312--><p class="noindent" ><br
4633 class="newline" />sets the debugging options to <span
4634 class="ec-lmro-12">num</span>.</p></dd></dl>
4635
4636 <h5 class="subsubsectionHead"><span class="titlemark">7.2.3 </span> <a
4637 id="x1-650007.2.3"></a>Examples of use</h5>
4638 <!--l. 2320--><p class="noindent" >Let us now have a look at Kpathsea in action. Here’s a straightforward search:
4639 </p>
4640 <div class="alltt">
4641
4642 <div class="obeylines-v">
4643 <br /><span
4644 class="ec-lmtt-12">&#x003E;</span><span
4645 class="ec-lmtt-12"> </span><span
4646 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4647 class="ec-lmtk-10x-x-120"> article.cls</span>
4648 <br /><span
4649 class="ec-lmtt-12"> </span><span
4650 class="ec-lmtt-12"> </span><span
4651 class="ec-lmtt-12"> /usr/local/texmf-dist/tex/latex/base/article.cls</span></div>
4652 </div> We are looking for the file <span
4653 class="ec-lmtt-12">article.cls</span>. Since the ‘<span
4654 class="ec-lmtt-12">.cls</span>’ suffix is unambiguous we do not
4655 need to specify that we want to look for a file of type <span
4656 class="ec-lmtt-12">tex </span>(TeX source file directories). We find
4657 it in the subdirectory <span
4658 class="ec-lmtt-12">tex/latex/base </span>below the ‘<span
4659 class="ec-lmtt-12">texmf-dist</span>’ TeX Live directory. Similarly,
4660 all of the following are found without problems thanks to their unambiguous suffix.
4661 <div class="alltt">
4662
4663 <div class="obeylines-v">
4664
4665
4666 <br /><span
4667 class="ec-lmtt-12">&#x003E;</span><span
4668 class="ec-lmtt-12"> </span><span
4669 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4670 class="ec-lmtk-10x-x-120"> array.sty</span>
4671 <br /><span
4672 class="ec-lmtt-12"> </span><span
4673 class="ec-lmtt-12"> </span><span
4674 class="ec-lmtt-12"> /usr/local/texmf-dist/tex/latex/tools/array.sty</span>
4675 <br /><span
4676 class="ec-lmtt-12">&#x003E;</span><span
4677 class="ec-lmtt-12"> </span><span
4678 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4679 class="ec-lmtk-10x-x-120"> latin1.def</span>
4680 <br /><span
4681 class="ec-lmtt-12"> </span><span
4682 class="ec-lmtt-12"> </span><span
4683 class="ec-lmtt-12"> /usr/local/texmf-dist/tex/latex/base/latin1.def</span>
4684 <br /><span
4685 class="ec-lmtt-12">&#x003E;</span><span
4686 class="ec-lmtt-12"> </span><span
4687 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4688 class="ec-lmtk-10x-x-120"> size10.clo</span>
4689 <br /><span
4690 class="ec-lmtt-12"> </span><span
4691 class="ec-lmtt-12"> </span><span
4692 class="ec-lmtt-12"> /usr/local/texmf-dist/tex/latex/base/size10.clo</span>
4693 <br /><span
4694 class="ec-lmtt-12">&#x003E;</span><span
4695 class="ec-lmtt-12"> </span><span
4696 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4697 class="ec-lmtk-10x-x-120"> small2e.tex</span>
4698 <br /><span
4699 class="ec-lmtt-12"> </span><span
4700 class="ec-lmtt-12"> </span><span
4701 class="ec-lmtt-12"> /usr/local/texmf-dist/tex/latex/base/small2e.tex</span>
4702 <br /><span
4703 class="ec-lmtt-12">&#x003E;</span><span
4704 class="ec-lmtt-12"> </span><span
4705 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4706 class="ec-lmtk-10x-x-120"> tugboat.bib</span>
4707 <br /><span
4708 class="ec-lmtt-12"> </span><span
4709 class="ec-lmtt-12"> </span><span
4710 class="ec-lmtt-12"> /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib</span>
4711 </div>
4712 </div>
4713 <!--l. 2345--><p class="indent" > By the way, that last is a BibTeX bibliography database for <span
4714 class="ec-lmro-12">TUGboat </span>articles.
4715 </p>
4716 <div class="alltt">
4717
4718 <div class="obeylines-v">
4719 <br /><span
4720 class="ec-lmtt-12">&#x003E;</span><span
4721 class="ec-lmtt-12"> </span><span
4722 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4723 class="ec-lmtk-10x-x-120"> cmr10.pk</span>
4724 </div>
4725 </div> Font bitmap glyph files of type <span
4726 class="ec-lmtt-12">.pk </span>are used by display programs like <span
4727 class="ec-lmss-12">dvips </span>and <span
4728 class="ec-lmss-12">xdvi</span>. Nothing
4729 is returned in this case since there are no pre-generated Computer Modern ‘<span
4730 class="ec-lmtt-12">.pk</span>’ files in TeX
4731 Live — the Type 1 variants are used by default. <div class="alltt">
4732
4733 <div class="obeylines-v">
4734 <br /><span
4735 class="ec-lmtt-12">&#x003E;</span><span
4736 class="ec-lmtt-12"> </span><span
4737 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4738 class="ec-lmtk-10x-x-120"> wsuipa10.pk</span>
4739 <br /><span
4740 class="ec-lmtt-12"> </span><span
4741 class="ec-lmtt-12"> </span><span
4742 class="ec-lmtt-12"> /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk</span>
4743 </div>
4744 </div> For these fonts (a phonetic alphabet from the University of Washington) we had
4745 to generate ‘<span
4746 class="ec-lmtt-12">.pk</span>’ files, and since the default Metafont mode on our installation is
4747 <span
4748 class="ec-lmtt-12">ljfour </span>with a base resolution of 600 dpi (dots per inch), this instantiation is returned.
4749 <div class="alltt">
4750
4751 <div class="obeylines-v">
4752 <br /><span
4753 class="ec-lmtt-12">&#x003E;</span><span
4754 class="ec-lmtt-12"> </span><span
4755 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4756 class="ec-lmtk-10x-x-120"> -dpi=300</span><span
4757 class="ec-lmtk-10x-x-120"> wsuipa10.pk</span>
4758 </div>
4759 </div> In this case, when specifying that we are interested in a resolution of 300 dpi (<span
4760 class="ec-lmtt-12">-dpi=300</span>) we
4761 see that no such font is available on the system. A program like <span
4762 class="ec-lmss-12">dvips </span>or <span
4763 class="ec-lmss-12">xdvi </span>would go off and
4764 actually build the required <span
4765 class="ec-lmtt-12">.pk </span>files using the script <span
4766 class="ec-lmss-12">mktexpk</span>.
4767 <!--l. 2374--><p class="indent" > Next we turn our attention to <span
4768 class="ec-lmss-12">dvips</span>’s header and configuration files. We first look at one of
4769 the commonly used files, the general prologue <span
4770 class="ec-lmtt-12">tex.pro </span>for TeX support, before turning our
4771 attention to the generic configuration file (<span
4772 class="ec-lmtt-12">config.ps</span>) and the PostScript font map
4773 <span
4774 class="ec-lmtt-12">psfonts.map </span>— as of 2004, map and encoding files have their own search paths and
4775 new location in <span
4776 class="ec-lmtt-12">texmf </span>trees. As the ‘<span
4777 class="ec-lmtt-12">.ps</span>’ suffix is ambiguous we have to specify
4778 explicitly which type we are considering (<span
4779 class="ec-lmtt-12">dvips config</span>) for the file <span
4780 class="ec-lmtt-12">config.ps</span>.
4781 </p><div class="alltt">
4782
4783
4784
4785 <div class="obeylines-v">
4786 <br /><span
4787 class="ec-lmtt-12">&#x003E;</span><span
4788 class="ec-lmtt-12"> </span><span
4789 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4790 class="ec-lmtk-10x-x-120"> tex.pro</span>
4791 <br /><span
4792 class="ec-lmtt-12"> </span><span
4793 class="ec-lmtt-12"> </span><span
4794 class="ec-lmtt-12"> /usr/local/texmf/dvips/base/tex.pro</span>
4795 <br /><span
4796 class="ec-lmtt-12">&#x003E;</span><span
4797 class="ec-lmtt-12"> </span><span
4798 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4799 class="ec-lmtk-10x-x-120"> --format=&#x0022;dvips</span><span
4800 class="ec-lmtk-10x-x-120"> config&#x0022;</span><span
4801 class="ec-lmtk-10x-x-120"> config.ps</span>
4802 <br /><span
4803 class="ec-lmtt-12"> </span><span
4804 class="ec-lmtt-12"> </span><span
4805 class="ec-lmtt-12"> /usr/local/texmf/dvips/config/config.ps</span>
4806 <br /><span
4807 class="ec-lmtt-12">&#x003E;</span><span
4808 class="ec-lmtt-12"> </span><span
4809 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4810 class="ec-lmtk-10x-x-120"> psfonts.map</span>
4811 <br /><span
4812 class="ec-lmtt-12"> </span><span
4813 class="ec-lmtt-12"> </span><span
4814 class="ec-lmtt-12"> /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map</span>
4815 </div>
4816 </div>
4817 <!--l. 2392--><p class="indent" > We now take a closer look at the URW Times PostScript support files. The prefix for these
4818 in the standard font naming scheme is ‘<span
4819 class="ec-lmtt-12">utm</span>’. The first file we look at is the configuration file,
4820 which contains the name of the map file: </p><div class="alltt">
4821
4822 <div class="obeylines-v">
4823 <br /><span
4824 class="ec-lmtt-12">&#x003E;</span><span
4825 class="ec-lmtt-12"> </span><span
4826 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4827 class="ec-lmtk-10x-x-120"> --format=&#x0022;dvips</span><span
4828 class="ec-lmtk-10x-x-120"> config&#x0022;</span><span
4829 class="ec-lmtk-10x-x-120"> config.utm</span>
4830 <br /><span
4831 class="ec-lmtt-12"> </span><span
4832 class="ec-lmtt-12"> </span><span
4833 class="ec-lmtt-12"> /usr/local/texmf-dist/dvips/psnfss/config.utm</span>
4834 </div>
4835 </div> The contents of that file is <div class="alltt">
4836
4837 <div class="obeylines-v">
4838 <br /><span
4839 class="ec-lmtt-12"> </span><span
4840 class="ec-lmtt-12"> p</span><span
4841 class="ec-lmtt-12"> +utm.map</span>
4842 </div>
4843 </div> which points to the file <span
4844 class="ec-lmtt-12">utm.map</span>, which we want to locate next. <div class="alltt">
4845
4846 <div class="obeylines-v">
4847 <br /><span
4848 class="ec-lmtt-12">&#x003E;</span><span
4849 class="ec-lmtt-12"> </span><span
4850 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4851 class="ec-lmtk-10x-x-120"> utm.map</span>
4852 <br /><span
4853 class="ec-lmtt-12"> </span><span
4854 class="ec-lmtt-12"> </span><span
4855 class="ec-lmtt-12"> /usr/local/texmf-dist/fonts/map/dvips/times/utm.map</span>
4856 </div>
4857 </div> This map file defines the file names of the Type 1 PostScript fonts in the URW collection. Its
4858 contents look like (we only show part of the lines): <div class="alltt">
4859
4860 <div class="obeylines-v">
4861 <br /><span
4862 class="ec-lmtt-12">utmb8r</span><span
4863 class="ec-lmtt-12"> </span><span
4864 class="ec-lmtt-12"> NimbusRomNo9L-Medi</span><span
4865 class="ec-lmtt-12"> </span><span
4866 class="ec-lmtt-12"> </span><span
4867 class="ec-lmtt-12"> </span><span
4868 class="ec-lmtt-12"> ...</span><span
4869 class="ec-lmtt-12"> &#x003C;utmb8a.pfb</span>
4870 <br /><span
4871 class="ec-lmtt-12">utmbi8r</span><span
4872 class="ec-lmtt-12"> NimbusRomNo9L-MediItal...</span><span
4873 class="ec-lmtt-12"> &#x003C;utmbi8a.pfb</span>
4874 <br /><span
4875 class="ec-lmtt-12">utmr8r</span><span
4876 class="ec-lmtt-12"> </span><span
4877 class="ec-lmtt-12"> NimbusRomNo9L-Regu</span><span
4878 class="ec-lmtt-12"> </span><span
4879 class="ec-lmtt-12"> </span><span
4880 class="ec-lmtt-12"> </span><span
4881 class="ec-lmtt-12"> ...</span><span
4882 class="ec-lmtt-12"> &#x003C;utmr8a.pfb</span>
4883 <br /><span
4884 class="ec-lmtt-12">utmri8r</span><span
4885 class="ec-lmtt-12"> NimbusRomNo9L-ReguItal...</span><span
4886 class="ec-lmtt-12"> &#x003C;utmri8a.pfb</span>
4887 <br /><span
4888 class="ec-lmtt-12">utmbo8r</span><span
4889 class="ec-lmtt-12"> NimbusRomNo9L-Medi</span><span
4890 class="ec-lmtt-12"> </span><span
4891 class="ec-lmtt-12"> </span><span
4892 class="ec-lmtt-12"> </span><span
4893 class="ec-lmtt-12"> ...</span><span
4894 class="ec-lmtt-12"> &#x003C;utmb8a.pfb</span>
4895 <br /><span
4896 class="ec-lmtt-12">utmro8r</span><span
4897 class="ec-lmtt-12"> NimbusRomNo9L-Regu</span><span
4898 class="ec-lmtt-12"> </span><span
4899 class="ec-lmtt-12"> </span><span
4900 class="ec-lmtt-12"> </span><span
4901 class="ec-lmtt-12"> ...</span><span
4902 class="ec-lmtt-12"> &#x003C;utmr8a.pfb</span>
4903 </div>
4904 </div> Let us, for instance, take the Times Roman instance <span
4905 class="ec-lmtt-12">utmr8a.pfb </span>and find its position in the
4906 <span
4907 class="ec-lmtt-12">texmf </span>directory tree with a search for Type 1 font files: <div class="alltt">
4908
4909 <div class="obeylines-v">
4910 <br /><span
4911 class="ec-lmtt-12">&#x003E;</span><span
4912 class="ec-lmtt-12"> </span><span
4913 class="ec-lmtk-10x-x-120">kpsewhich</span><span
4914 class="ec-lmtk-10x-x-120"> utmr8a.pfb</span>
4915 <br /><span
4916 class="ec-lmtt-12"> </span><span
4917 class="ec-lmtt-12"> </span><span
4918 class="ec-lmtt-12"> /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb</span>
4919
4920
4921 </div>
4922 </div>
4923 <!--l. 2431--><p class="indent" > It should be evident from these examples how you can easily locate the whereabouts of a
4924 given file. This is especially important if you suspect that the wrong version of a file is picked
4925 up somehow, since <span
4926 class="ec-lmss-12">kpsewhich </span>will show you the first file encountered.
4927
4928 </p>
4929 <h5 class="subsubsectionHead"><span class="titlemark">7.2.4 </span> <a
4930 id="x1-660007.2.4"></a>Debugging actions</h5>
4931 <!--l. 2439--><p class="noindent" >Sometimes it is necessary to investigate how a program resolves file references. To make this
4932 practical, Kpathsea offers various levels of debugging output:
4933 </p><!--l. 2443--><p class="noindent" >
4934 </p><dl class="list1"><dt class="list">
4935 <span
4936 class="ec-lmtt-12"> 1 </span> </dt><dd
4937 class="list">
4938 <!--l. 2444--><p class="noindent" ><span
4939 class="ec-lmtt-12">stat </span>calls (disk lookups). When running with an up-to-date <span
4940 class="ec-lmtt-12">ls-R </span>database this
4941 should almost give no output.
4942 </p></dd><dt class="list">
4943 <span
4944 class="ec-lmtt-12"> 2 </span> </dt><dd
4945 class="list">
4946 <!--l. 2447--><p class="noindent" >References to hash tables (such as <span
4947 class="ec-lmtt-12">ls-R </span>databases, map files, configuration files).
4948 </p></dd><dt class="list">
4949 <span
4950 class="ec-lmtt-12"> 4 </span> </dt><dd
4951 class="list">
4952 <!--l. 2449--><p class="noindent" >File open and close operations.
4953 </p></dd><dt class="list">
4954 <span
4955 class="ec-lmtt-12"> 8 </span> </dt><dd
4956 class="list">
4957 <!--l. 2450--><p class="noindent" >General path information for file types searched by Kpathsea. This is useful to find
4958 out where a particular path for the file was defined.
4959 </p></dd><dt class="list">
4960 <span
4961 class="ec-lmtt-12">16 </span> </dt><dd
4962 class="list">
4963 <!--l. 2453--><p class="noindent" >Directory list for each path element (only relevant for searches on disk).
4964 </p></dd><dt class="list">
4965 <span
4966 class="ec-lmtt-12">32 </span> </dt><dd
4967 class="list">
4968 <!--l. 2455--><p class="noindent" >File searches.
4969 </p></dd><dt class="list">
4970 <span
4971 class="ec-lmtt-12">64 </span> </dt><dd
4972 class="list">
4973 <!--l. 2456--><p class="noindent" >Variable values.</p></dd></dl>
4974 <!--l. 2458--><p class="noindent" >A value of <span
4975 class="ec-lmtt-12">-1 </span>will set all the above options; in practice, this is usually the most convenient.
4976 </p><!--l. 2461--><p class="indent" > Similarly, with the <span
4977 class="ec-lmss-12">dvips </span>program, by setting a combination of debug switches, one can
4978 follow in detail where files are being picked up from. Alternatively, when a file is not found, the
4979 debug trace shows in which directories the program looks for the given file, so that one can get
4980 an indication what the problem is.
4981 </p><!--l. 2467--><p class="indent" > Generally speaking, as most programs call the Kpathsea library internally, one can select a
4982 debug option by using the <span
4983 class="ec-lmtt-12">KPATHSEA_DEBUG </span>environment variable, and setting it to (a
4984 combination of) values as described in the above list.
4985 </p><!--l. 2472--><p class="indent" > (Note for Windows users: it is not easy to redirect all messages to a file in this system. For
4986 diagnostic purposes you can temporarily <span
4987 class="ec-lmtt-12">SET KPATHSEA_DEBUG_OUTPUT=err.log</span>).
4988 </p><!--l. 2476--><p class="indent" > Let us consider, as an example, a small LaTeX source file, <span
4989 class="ec-lmtt-12">hello-world.tex</span>, which
4990
4991
4992 contains the following input.
4993
4994
4995 </p>
4996 <pre class="verbatim" id="verbatim-7">
4997 <pre class="fancyvrb" id="fancyvrb20"><a
4998 id="x1-66002r1"></a>  \documentclass{article}
4999 <a
5000 id="x1-66004r2"></a>  \begin{document}
5001 <a
5002 id="x1-66006r3"></a>  Hello World!
5003 <a
5004 id="x1-66008r4"></a>  \end{document}</pre>
5005 </pre>
5006 <!--l. 2483--><p class="nopar" >This little file only uses the font <span
5007 class="ec-lmtt-12">cmr10</span>, so let us look at how <span
5008 class="ec-lmss-12">dvips </span>prepares the PostScript file
5009 (we want to use the Type 1 version of the Computer Modern fonts, hence the option <span
5010 class="ec-lmtt-12">-Pcms</span>).
5011 </p><div class="alltt">
5012
5013 <div class="obeylines-v">
5014 <br /><span
5015 class="ec-lmtt-12">&#x003E;</span><span
5016 class="ec-lmtt-12"> </span><span
5017 class="ec-lmtk-10x-x-120">dvips</span><span
5018 class="ec-lmtk-10x-x-120"> -d4100</span><span
5019 class="ec-lmtk-10x-x-120"> hello-world</span><span
5020 class="ec-lmtk-10x-x-120"> -Pcms</span><span
5021 class="ec-lmtk-10x-x-120"> -o</span>
5022 </div>
5023 </div> In this case we have combined <span
5024 class="ec-lmss-12">dvips</span>’s debug class 4 (font paths) with Kpathsea’s path element
5025 expansion (see the <span
5026 class="ec-lmss-12">dvips </span>reference manual). The output (slightly rearranged) appears in Figure <a
5027 href="#x1-66031r12">12<!--tex4ht:ref: fig:dvipsdbga --></a>.
5028 <figure class="figure">
5029 <a
5030 id="x1-66031r12"></a> <div class="BVerbatimInput">
5031 <span
5032 class="ec-lmtt-10x-x-109">debug:start</span><span
5033 class="ec-lmtt-10x-x-109"> search(file=texmf.cnf,</span><span
5034 class="ec-lmtt-10x-x-109"> must_exist=1,</span><span
5035 class="ec-lmtt-10x-x-109"> find_all=1,</span><br /><span
5036 class="ec-lmtt-10x-x-109"> </span><span
5037 class="ec-lmtt-10x-x-109"> path=.:/usr/local/bin/texlive:/usr/local/bin:</span><br /><span
5038 class="ec-lmtt-10x-x-109"> </span><span
5039 class="ec-lmtt-10x-x-109"> </span><span
5040 class="ec-lmtt-10x-x-109"> </span><span
5041 class="ec-lmtt-10x-x-109"> </span><span
5042 class="ec-lmtt-10x-x-109"> </span><span
5043 class="ec-lmtt-10x-x-109"> </span><span
5044 class="ec-lmtt-10x-x-109"> /usr/local/bin/texmf/web2c:/usr/local:</span><br /><span
5045 class="ec-lmtt-10x-x-109"> </span><span
5046 class="ec-lmtt-10x-x-109"> </span><span
5047 class="ec-lmtt-10x-x-109"> </span><span
5048 class="ec-lmtt-10x-x-109"> </span><span
5049 class="ec-lmtt-10x-x-109"> </span><span
5050 class="ec-lmtt-10x-x-109"> </span><span
5051 class="ec-lmtt-10x-x-109"> /usr/local/texmf/web2c:/.:/./teTeX/TeX/texmf/web2c:).</span><br /><span
5052 class="ec-lmtt-10x-x-109">kdebug:start</span><span
5053 class="ec-lmtt-10x-x-109"> search(file=ls-R,</span><span
5054 class="ec-lmtt-10x-x-109"> must_exist=1,</span><span
5055 class="ec-lmtt-10x-x-109"> find_all=1,</span><br /><span
5056 class="ec-lmtt-10x-x-109"> </span><span
5057 class="ec-lmtt-10x-x-109"> path=~/tex:/usr/local/texmf).</span><br /><span
5058 class="ec-lmtt-10x-x-109">kdebug:search(ls-R)</span><span
5059 class="ec-lmtt-10x-x-109"> =&#x003E;/usr/local/texmf/ls-R</span><br /><span
5060 class="ec-lmtt-10x-x-109">kdebug:start</span><span
5061 class="ec-lmtt-10x-x-109"> search(file=aliases,</span><span
5062 class="ec-lmtt-10x-x-109"> must_exist=1,</span><span
5063 class="ec-lmtt-10x-x-109"> find_all=1,</span><br /><span
5064 class="ec-lmtt-10x-x-109"> </span><span
5065 class="ec-lmtt-10x-x-109"> path=~/tex:/usr/local/texmf).</span><br /><span
5066 class="ec-lmtt-10x-x-109">kdebug:search(aliases)</span><span
5067 class="ec-lmtt-10x-x-109"> =&#x003E;</span><span
5068 class="ec-lmtt-10x-x-109"> /usr/local/texmf/aliases</span><br /><span
5069 class="ec-lmtt-10x-x-109">kdebug:start</span><span
5070 class="ec-lmtt-10x-x-109"> search(file=config.ps,</span><span
5071 class="ec-lmtt-10x-x-109"> must_exist=0,</span><span
5072 class="ec-lmtt-10x-x-109"> find_all=0,</span><br /><span
5073 class="ec-lmtt-10x-x-109"> </span><span
5074 class="ec-lmtt-10x-x-109"> path=.:~/tex:!!/usr/local/texmf/dvips//).</span><br /><span
5075 class="ec-lmtt-10x-x-109">kdebug:search(config.ps)</span><span
5076 class="ec-lmtt-10x-x-109"> =&#x003E;</span><span
5077 class="ec-lmtt-10x-x-109"> /usr/local/texmf/dvips/config/config.ps</span><br /><span
5078 class="ec-lmtt-10x-x-109">kdebug:start</span><span
5079 class="ec-lmtt-10x-x-109"> search(file=/root/.dvipsrc,</span><span
5080 class="ec-lmtt-10x-x-109"> must_exist=0,</span><span
5081 class="ec-lmtt-10x-x-109"> find_all=0,</span><br /><span
5082 class="ec-lmtt-10x-x-109"> </span><span
5083 class="ec-lmtt-10x-x-109"> path=.:~/tex:!!/usr/local/texmf/dvips//).</span><br /><span
5084 class="ec-lmtt-10x-x-109">search(file=/home/goossens/.dvipsrc,</span><span
5085 class="ec-lmtt-10x-x-109"> must_exist=1,</span><span
5086 class="ec-lmtt-10x-x-109"> find_all=0,</span><br /><span
5087 class="ec-lmtt-10x-x-109"> </span><span
5088 class="ec-lmtt-10x-x-109"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).</span><br /><span
5089 class="ec-lmtt-10x-x-109">kdebug:search($HOME/.dvipsrc)</span><span
5090 class="ec-lmtt-10x-x-109"> =&#x003E;</span><br /><span
5091 class="ec-lmtt-10x-x-109">kdebug:start</span><span
5092 class="ec-lmtt-10x-x-109"> search(file=config.cms,</span><span
5093 class="ec-lmtt-10x-x-109"> must_exist=0,</span><span
5094 class="ec-lmtt-10x-x-109"> find_all=0,</span><br /><span
5095 class="ec-lmtt-10x-x-109"> </span><span
5096 class="ec-lmtt-10x-x-109"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).</span><br /><span
5097 class="ec-lmtt-10x-x-109">kdebug:search(config.cms)</span><br /><span
5098 class="ec-lmtt-10x-x-109">=&#x003E;/usr/local/texmf/dvips/cms/config.cms</span></div>
5099 <figcaption class="caption" ><span class="id">Figure 12: </span><span
5100 class="content">Finding configuration files</span></figcaption><!--tex4ht:label?: x1-66031r12 -->
5101 </figure>
5102 <!--l. 2501--><p class="indent" > <span
5103 class="ec-lmss-12">dvips </span>starts by locating its working files. First, <span
5104 class="ec-lmtt-12">texmf.cnf </span>is found, which gives the
5105 definitions of the search paths for the other files, then the file database <span
5106 class="ec-lmtt-12">ls-R </span>(to optimize file
5107 searching) and the file <span
5108 class="ec-lmtt-12">aliases</span>, which makes it possible to declare several names (e.g., a short
5109 DOS-like 8.3 and a more natural longer version) for the same file. Then <span
5110 class="ec-lmss-12">dvips </span>goes on to find
5111 the generic configuration file <span
5112 class="ec-lmtt-12">config.ps </span>before looking for the customization file
5113 <span
5114 class="ec-lmtt-12">.dvipsrc </span>(which, in this case is <span
5115 class="ec-lmri-12">not found</span>). Finally, <span
5116 class="ec-lmss-12">dvips </span>locates the config file for the
5117 Computer Modern PostScript fonts <span
5118 class="ec-lmtt-12">config.cms </span>(this was initiated with the <span
5119 class="ec-lmtt-12">-Pcms</span>
5120 option on the <span
5121 class="ec-lmss-12">dvips </span>command). This file contains the list of the map files which
5122 define the relation between the TeX, PostScript and file system names of the fonts.
5123 </p><div class="alltt">
5124
5125 <div class="obeylines-v">
5126 <br /><span
5127 class="ec-lmtt-12">&#x003E;</span><span
5128 class="ec-lmtt-12"> </span><span
5129 class="ec-lmtk-10x-x-120">more</span><span
5130 class="ec-lmtk-10x-x-120"> /usr/local/texmf/dvips/cms/config.cms</span>
5131 <br /><span
5132 class="ec-lmtt-12"> </span><span
5133 class="ec-lmtt-12"> </span><span
5134 class="ec-lmtt-12"> p</span><span
5135 class="ec-lmtt-12"> +ams.map</span>
5136 <br /><span
5137 class="ec-lmtt-12"> </span><span
5138 class="ec-lmtt-12"> </span><span
5139 class="ec-lmtt-12"> p</span><span
5140 class="ec-lmtt-12"> +cms.map</span>
5141 <br /><span
5142 class="ec-lmtt-12"> </span><span
5143 class="ec-lmtt-12"> </span><span
5144 class="ec-lmtt-12"> p</span><span
5145 class="ec-lmtt-12"> +cmbkm.map</span>
5146 <br /><span
5147 class="ec-lmtt-12"> </span><span
5148 class="ec-lmtt-12"> </span><span
5149 class="ec-lmtt-12"> p</span><span
5150 class="ec-lmtt-12"> +amsbkm.map</span>
5151 </div>
5152 </div> <span
5153 class="ec-lmss-12">dvips </span>thus goes on to find all these files, plus the generic map file <span
5154 class="ec-lmtt-12">psfonts.map</span>, which is
5155 always loaded (it contains declarations for commonly used PostScript fonts; see the last part of
5156 section <a
5157 href="#x1-650007.2.3">7.2.3<!--tex4ht:ref: sec:examples-of-use --></a> for more details about PostScript map file handling).
5158 <!--l. 2528--><p class="indent" > At this point <span
5159 class="ec-lmss-12">dvips </span>identifies itself to the user: </p><div class="alltt">
5160
5161 <div class="obeylines-v">
5162 <br /><span
5163 class="ec-lmtt-12">This</span><span
5164 class="ec-lmtt-12"> is</span><span
5165 class="ec-lmtt-12"> dvips(k)</span><span
5166 class="ec-lmtt-12"> 5.92b</span><span
5167 class="ec-lmtt-12"> Copyright</span><span
5168 class="ec-lmtt-12"> 2002</span><span
5169 class="ec-lmtt-12"> Radical</span><span
5170 class="ec-lmtt-12"> Eye</span><span
5171 class="ec-lmtt-12"> Software</span>
5172 </div>
5173 </div> Then it goes on to look for the prolog file <span
5174 class="ec-lmtt-12">texc.pro</span>: <div class="alltt">
5175
5176
5177
5178 <div class="obeylines-v">
5179 <br /><span
5180 class="ec-lmtt-10x-x-109">kdebug:start</span><span
5181 class="ec-lmtt-10x-x-109"> search(file=texc.pro,</span><span
5182 class="ec-lmtt-10x-x-109"> must_exist=0,</span><span
5183 class="ec-lmtt-10x-x-109"> find_all=0,</span>
5184 <br /><span
5185 class="ec-lmtt-10x-x-109"> </span><span
5186 class="ec-lmtt-10x-x-109"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:</span>
5187 <br /><span
5188 class="ec-lmtt-10x-x-109"> </span><span
5189 class="ec-lmtt-10x-x-109"> </span><span
5190 class="ec-lmtt-10x-x-109"> </span><span
5191 class="ec-lmtt-10x-x-109"> </span><span
5192 class="ec-lmtt-10x-x-109"> </span><span
5193 class="ec-lmtt-10x-x-109"> </span><span
5194 class="ec-lmtt-10x-x-109"> ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).</span>
5195 <br /><span
5196 class="ec-lmtt-10x-x-109">kdebug:search(texc.pro)</span><span
5197 class="ec-lmtt-10x-x-109"> =&#x003E;</span><span
5198 class="ec-lmtt-10x-x-109"> /usr/local/texmf/dvips/base/texc.pro</span>
5199 </div>
5200 </div>
5201 <!--l. 2545--><p class="indent" > After having found the file in question, <span
5202 class="ec-lmss-12">dvips </span>outputs the date and time, and
5203 informs us that it will generate the file <span
5204 class="ec-lmtt-12">hello-world.ps</span>, then that it needs the
5205 font file <span
5206 class="ec-lmtt-12">cmr10</span>, and that the latter is declared as “resident” (no bitmaps needed):
5207 </p><div class="alltt">
5208
5209 <div class="obeylines-v">
5210 <br /><span
5211 class="ec-lmtt-10x-x-109">TeX</span><span
5212 class="ec-lmtt-10x-x-109"> output</span><span
5213 class="ec-lmtt-10x-x-109"> 1998.02.26:1204’</span><span
5214 class="ec-lmtt-10x-x-109"> -&#x003E;</span><span
5215 class="ec-lmtt-10x-x-109"> hello-world.ps</span>
5216 <br /><span
5217 class="ec-lmtt-10x-x-109">Defining</span><span
5218 class="ec-lmtt-10x-x-109"> font</span><span
5219 class="ec-lmtt-10x-x-109"> ()</span><span
5220 class="ec-lmtt-10x-x-109"> cmr10</span><span
5221 class="ec-lmtt-10x-x-109"> at</span><span
5222 class="ec-lmtt-10x-x-109"> 10.0pt</span>
5223 <br /><span
5224 class="ec-lmtt-10x-x-109">Font</span><span
5225 class="ec-lmtt-10x-x-109"> cmr10</span><span
5226 class="ec-lmtt-10x-x-109"> &#x003C;CMR10&#x003E;</span><span
5227 class="ec-lmtt-10x-x-109"> is</span><span
5228 class="ec-lmtt-10x-x-109"> resident.</span></div>
5229 </div> Now the search is on for the file <span
5230 class="ec-lmtt-12">cmr10.tfm</span>, which is found, then a few more prolog files (not
5231 shown) are referenced, and finally the Type 1 instance <span
5232 class="ec-lmtt-12">cmr10.pfb </span>of the font is located and
5233 included in the output file (see last line). <div class="alltt">
5234
5235 <div class="obeylines-v">
5236 <br /><span
5237 class="ec-lmtt-10x-x-109">kdebug:start</span><span
5238 class="ec-lmtt-10x-x-109"> search(file=cmr10.tfm,</span><span
5239 class="ec-lmtt-10x-x-109"> must_exist=1,</span><span
5240 class="ec-lmtt-10x-x-109"> find_all=0,</span>
5241 <br /><span
5242 class="ec-lmtt-10x-x-109"> </span><span
5243 class="ec-lmtt-10x-x-109"> path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:</span>
5244 <br /><span
5245 class="ec-lmtt-10x-x-109"> </span><span
5246 class="ec-lmtt-10x-x-109"> </span><span
5247 class="ec-lmtt-10x-x-109"> </span><span
5248 class="ec-lmtt-10x-x-109"> </span><span
5249 class="ec-lmtt-10x-x-109"> </span><span
5250 class="ec-lmtt-10x-x-109"> </span><span
5251 class="ec-lmtt-10x-x-109"> /var/tex/fonts/tfm//).</span>
5252 <br /><span
5253 class="ec-lmtt-10x-x-109">kdebug:search(cmr10.tfm)</span><span
5254 class="ec-lmtt-10x-x-109"> =&#x003E;</span><span
5255 class="ec-lmtt-10x-x-109"> /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm</span>
5256 <br /><span
5257 class="ec-lmtt-10x-x-109">kdebug:start</span><span
5258 class="ec-lmtt-10x-x-109"> search(file=texps.pro,</span><span
5259 class="ec-lmtt-10x-x-109"> must_exist=0,</span><span
5260 class="ec-lmtt-10x-x-109"> find_all=0,</span>
5261 <br /><span
5262 class="ec-lmtt-10x-x-109"> </span><span
5263 class="ec-lmtt-10x-x-109"> </span><span
5264 class="ec-lmtt-10x-x-109"> ...</span>
5265 <br /><span
5266 class="ec-lmtt-10x-x-109">&#x003C;texps.pro&#x003E;</span>
5267 <br /><span
5268 class="ec-lmtt-10x-x-109">kdebug:start</span><span
5269 class="ec-lmtt-10x-x-109"> search(file=cmr10.pfb,</span><span
5270 class="ec-lmtt-10x-x-109"> must_exist=0,</span><span
5271 class="ec-lmtt-10x-x-109"> find_all=0,</span>
5272 <br /><span
5273 class="ec-lmtt-10x-x-109"> </span><span
5274 class="ec-lmtt-10x-x-109"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:</span>
5275 <br /><span
5276 class="ec-lmtt-10x-x-109"> </span><span
5277 class="ec-lmtt-10x-x-109"> </span><span
5278 class="ec-lmtt-10x-x-109"> </span><span
5279 class="ec-lmtt-10x-x-109"> </span><span
5280 class="ec-lmtt-10x-x-109"> </span><span
5281 class="ec-lmtt-10x-x-109"> </span><span
5282 class="ec-lmtt-10x-x-109"> ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).</span>
5283 <br /><span
5284 class="ec-lmtt-10x-x-109">kdebug:search(cmr10.pfb)</span><span
5285 class="ec-lmtt-10x-x-109"> =&#x003E;</span><span
5286 class="ec-lmtt-10x-x-109"> /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb</span>
5287 <br /><span
5288 class="ec-lmtt-10x-x-109">&#x003C;cmr10.pfb&#x003E;[1]</span>
5289 </div>
5290 </div>
5291
5292 <h4 class="subsectionHead"><span class="titlemark">7.3 </span> <a
5293 id="x1-670007.3"></a>Runtime options</h4>
5294 <!--l. 2576--><p class="noindent" >Another useful feature of Web2C is its possibility to control a number of memory parameters
5295 (in particular, array sizes) via the runtime file <span
5296 class="ec-lmtt-12">texmf.cnf </span>read by Kpathsea. The memory
5297 settings can be found in Part 3 of that file in the TeX Live distribution. The more important
5298 are:
5299 </p><!--l. 2582--><p class="noindent" >
5300 </p><dl class="list1"><dt class="list">
5301 <span
5302 class="ec-lmtt-12">main_memory</span> </dt><dd
5303 class="list">
5304
5305
5306 <!--l. 2583--><p class="noindent" >Total words of memory available, for TeX, Metafont and MetaPost. You must make
5307 a new format file for each different setting. For instance, you could generate a
5308 “huge” version of TeX, and call the format file <span
5309 class="ec-lmtt-12">hugetex.fmt</span>. Using the standard
5310 way of specifying the program name used by Kpathsea, the particular value of the
5311 <span
5312 class="ec-lmtt-12">main_memory </span>variable will then be read from <span
5313 class="ec-lmtt-12">texmf.cnf</span>.
5314 </p></dd><dt class="list">
5315 <span
5316 class="ec-lmtt-12">extra_mem_bot</span> </dt><dd
5317 class="list">
5318 <!--l. 2591--><p class="noindent" >Extra space for “large” TeX data structures: boxes, glue, breakpoints, etc.
5319 Especially useful if you use PI CTeX.
5320 </p></dd><dt class="list">
5321 <span
5322 class="ec-lmtt-12">font_mem_size</span> </dt><dd
5323 class="list">
5324 <!--l. 2595--><p class="noindent" >Number of words for font information available for TeX. This is more or less the
5325 total size of all TFM files read.
5326 </p></dd><dt class="list">
5327 <span
5328 class="ec-lmtt-12">hash_extra</span> </dt><dd
5329 class="list">
5330 <!--l. 2598--><p class="noindent" >Additional space for the hash table of control sequence names; its default value is
5331 <span
5332 class="ec-lmtt-12">600000</span>.</p></dd></dl>
5333 <!--l. 2603--><p class="noindent" >This facility is no substitute for truly dynamic arrays and memory allocation, but since these
5334 are extremely difficult to implement in the present TeX source, these runtime parameters
5335 provide a practical compromise allowing some flexibility.
5336 </p><!--l. 2608--><p class="indent" > <a id="texmfdotdir"></a>
5337 </p>
5338 <h4 class="subsectionHead"><span class="titlemark">7.4 </span> <a
5339 id="x1-680007.4"></a><span
5340 class="ec-lmtt-12">$TEXMFDOTDIR</span></h4>
5341 <!--l. 2612--><p class="noindent" >In various places above, we gave various search paths starting with <span
5342 class="ec-lmtt-12">. </span>(to search the current
5343 directory first), as in </p><div class="alltt">
5344
5345 <div class="obeylines-v">
5346 <br /><span
5347 class="ec-lmtt-10x-x-109">TEXINPUTS=.;$TEXMF/tex//</span>
5348 </div>
5349 </div>
5350 <!--l. 2618--><p class="indent" > This is a simplification. The <span
5351 class="ec-lmtt-12">texmf.cnf </span>file we distribute in TeX Live uses <span
5352 class="ec-lmtt-12">$TEXMFDOTDIR</span>
5353 instead of just ‘<span
5354 class="ec-lmtt-12">.</span>’, as in: </p><div class="alltt">
5355
5356 <div class="obeylines-v">
5357 <br /><span
5358 class="ec-lmtt-10x-x-109">TEXINPUTS=$TEXMFDOTDIR;$TEXMF/tex//</span>
5359 </div>
5360 </div> (In the distributed file, the second path element is also slightly more complicated
5361 than <span
5362 class="ec-lmtt-12">$TEXMF/tex//</span>. But that’s minor; here we want to discuss the <span
5363 class="ec-lmtt-12">$TEXMFDOTDIR</span>
5364 feature.)
5365 <!--l. 2627--><p class="indent" > The reason to use the variable <span
5366 class="ec-lmtt-12">$TEXMFDOTDIR </span>in the path definitions instead of simply
5367 ‘<span
5368 class="ec-lmtt-12">.</span>’ is purely so that it can be overridden. For example, a complex document may
5369 have many source files arranged in many subdirectories. To handle that, you can set
5370 <span
5371 class="ec-lmtt-12">TEXMFDOTDIR </span>to <span
5372 class="ec-lmtt-12">.// </span>(for example, in the environment when you build the document) and
5373 they will all get searched. (Warning: don’t use <span
5374 class="ec-lmtt-12">.// </span>by default; it’s usually highly
5375
5376
5377 undesirable, and potentially insecure, to search through all subdirectories for an arbitrary
5378 document.)
5379 </p><!--l. 2637--><p class="indent" > As another example, you may wish not to search the current directory at all, e.g., if you
5380 have arranged for all the files to be found via explicit paths. You can set <span
5381 class="ec-lmtt-12">$TEXMFDOTDIR </span>to, say,
5382 <span
5383 class="ec-lmtt-12">/nonesuch </span>or any nonexistent directory for this.
5384 </p><!--l. 2642--><p class="indent" > The default value of <span
5385 class="ec-lmtt-12">$TEXMFDOTDIR </span>is just ‘<span
5386 class="ec-lmtt-12">.</span>’, as set in our <span
5387 class="ec-lmtt-12">texmf.cnf</span>.
5388 </p><!--l. 2645--><p class="indent" > <a id="ack"></a>
5389 </p>
5390 <h3 class="sectionHead"><span class="titlemark">8 </span> <a
5391 id="x1-690008"></a>Acknowledgements</h3>
5392 <!--l. 2648--><p class="noindent" >TeX Live is a joint effort by virtually all of the TeX user groups. This edition of TeX Live was
5393 overseen by Karl Berry. The other principal contributors, past and present, are listed
5394 below.
5395 </p>
5396 <ul class="itemize1">
5397 <li class="itemize">
5398 <!--l. 2654--><p class="noindent" >The English, German, Dutch, and Polish TeX user groups (TUG, DANTE
5399 e.V., NTG, and GUST, respectively), which provide the necessary technical and
5400 administrative infrastructure. Please join the TeX user group near you! See
5401 <a
5402 href="https://tug.org/usergroups.html" class="url" ><span
5403 class="ec-lmtt-12">https://tug.org/usergroups.html</span></a>.
5404 </p></li>
5405 <li class="itemize">
5406 <!--l. 2660--><p class="noindent" >The CTAN team (<a
5407 href="https://ctan.org" class="url" ><span
5408 class="ec-lmtt-12">https://ctan.org</span></a>), which distributes the TeX Live images
5409 and provides the common infrastructure for package updates, upon which TeX Live
5410 depends.
5411 </p></li>
5412 <li class="itemize">
5413 <!--l. 2664--><p class="noindent" >Nelson Beebe, for making many platforms available to TeX Live developers, and
5414 his own comprehensive testing and unparalleled bibliographic efforts.
5415 </p></li>
5416 <li class="itemize">
5417 <!--l. 2668--><p class="noindent" >John Bowman, for making many changes to his advanced graphics program
5418 Asymptote to make it work in TeX Live.
5419 </p></li>
5420 <li class="itemize">
5421 <!--l. 2671--><p class="noindent" >Peter Breitenlohner and the e-TeX team for the stable foundation of future TeX’s,
5422 and Peter specifically for years of stellar help with GNU autotools and keeping
5423 sources up to date. Peter passed away in October 2015, and we dedicate the
5424 continuing work to his memory.
5425 </p></li>
5426 <li class="itemize">
5427 <!--l. 2676--><p class="noindent" >Jin-Hwan Cho and all of the DVIPDFM<span
5428 class="lmmi-12">x </span>team, for their excellent driver and
5429 responsiveness to configuration issues.
5430 </p></li>
5431
5432
5433 <li class="itemize">
5434 <!--l. 2679--><p class="noindent" >Thomas Esser, without whose marvelous teTeX package TeX Live would have never
5435 existed.
5436 </p></li>
5437 <li class="itemize">
5438 <!--l. 2682--><p class="noindent" >Michel Goossens, who co-authored the original documentation.
5439 </p></li>
5440 <li class="itemize">
5441 <!--l. 2684--><p class="noindent" >Eitan Gurari, whose TeX4ht is used to create the HTML version of this
5442 documentation, and who worked tirelessly to improve it at short notice, every year.
5443 Eitan prematurely passed away in June 2009, and we dedicate this documentation
5444 to his memory.
5445 </p></li>
5446 <li class="itemize">
5447 <!--l. 2689--><p class="noindent" >Hans Hagen,
5448 for much testing and making his ConTeXt package (<a
5449 href="https://pragma-ade.com" class="url" ><span
5450 class="ec-lmtt-12">https://pragma-ade.com</span></a>)
5451 work within TeX Live’s framework, and continually driving TeX development.
5452 </p></li>
5453 <li class="itemize">
5454 <!--l. 2693--><p class="noindent" >Hàn Thế Thành, Martin Schröder, and the pdfTeX team (<a
5455 href="http://pdftex.org" class="url" ><span
5456 class="ec-lmtt-12">http://pdftex.org</span></a>),
5457 for continuing enhancements of TeX’s abilities.
5458 </p></li>
5459 <li class="itemize">
5460 <!--l. 2697--><p class="noindent" >Hartmut Henkel, for significant development contributions to pdfTeX, LuaTeX,
5461 and more.
5462 </p></li>
5463 <li class="itemize">
5464 <!--l. 2700--><p class="noindent" >Shunshaku Hirata, for much original and continuing work on DVIPDFM<span
5465 class="lmmi-12">x</span>.
5466 </p></li>
5467 <li class="itemize">
5468 <!--l. 2702--><p class="noindent" >Taco Hoekwater, for major renewed development efforts on MetaPost and
5469 (Lua)TeX (<a
5470 href="http://luatex.org" class="url" ><span
5471 class="ec-lmtt-12">http://luatex.org</span></a>) itself, incorporating ConTeXt into TeX Live,
5472 giving Kpathsea multi-threaded functionality, and much more.
5473 </p></li>
5474 <li class="itemize">
5475 <!--l. 2707--><p class="noindent" >Khaled Hosny, for substantial work on XeTeX, DVIPDFM<span
5476 class="lmmi-12">x</span>, and efforts with Arabic
5477 and other fonts.
5478 </p></li>
5479 <li class="itemize">
5480 <!--l. 2710--><p class="noindent" >Paweł Jackowski, for the Windows installer <span
5481 class="ec-lmss-12">tlpm</span>, and Tomasz Łuczak, for <span
5482 class="ec-lmss-12">tlpmgui</span>,
5483 used in past releases.
5484 </p></li>
5485 <li class="itemize">
5486 <!--l. 2713--><p class="noindent" >Akira Kakuto, for providing the Windows binaries and many other significant
5487 development contributions.
5488 </p></li>
5489 <li class="itemize">
5490
5491
5492 <!--l. 2716--><p class="noindent" >Jonathan Kew, for developing the remarkable XeTeX engine and taking the time
5493 and trouble to integrate it in TeX Live, as well as the initial version of the
5494 MacTeX installer, and also for our recommended front-end TeXworks.
5495 </p></li>
5496 <li class="itemize">
5497 <!--l. 2721--><p class="noindent" >Hironori Kitagawa, for maintenance of (e)pTeX and related support.
5498 </p></li>
5499 <li class="itemize">
5500 <!--l. 2723--><p class="noindent" >Dick Koch, for maintaining MacTeX (<a
5501 href="https://tug.org/mactex" class="url" ><span
5502 class="ec-lmtt-12">https://tug.org/mactex</span></a>) in very close
5503 tandem with TeX Live, and for his great good cheer in doing so.
5504 </p></li>
5505 <li class="itemize">
5506 <!--l. 2727--><p class="noindent" >Reinhard Kotucha, for major contributions to the TeX Live 2008 infrastructure
5507 and installer, as well as Windows research efforts, the <span
5508 class="ec-lmtt-12">getnonfreefonts </span>script,
5509 and more.
5510 </p></li>
5511 <li class="itemize">
5512 <!--l. 2731--><p class="noindent" >Siep Kroonenberg, also for major contributions to the TeX Live 2008 infrastructure
5513 and installer, especially on Windows, and for the bulk of work updating this manual
5514 describing those features.
5515 </p></li>
5516 <li class="itemize">
5517 <!--l. 2735--><p class="noindent" >Clerk Ma, for engine bug fixes and extensions.
5518 </p></li>
5519 <li class="itemize">
5520 <!--l. 2737--><p class="noindent" >Mojca Miklavec, for much help with ConTeXt, building many binary sets, and
5521 plenty more.
5522 </p></li>
5523 <li class="itemize">
5524 <!--l. 2740--><p class="noindent" >Heiko Oberdiek, for the <span
5525 class="ec-lmss-12">epstopdf </span>package and many others, compressing the huge
5526 <span
5527 class="ec-lmss-12">pst-geo </span>data files so we could include them, and most of all, for his remarkable
5528 work on <span
5529 class="ec-lmss-12">hyperref</span>.
5530 </p></li>
5531 <li class="itemize">
5532 <!--l. 2745--><p class="noindent" >Phelype Oleinik, for the group-delimited <span
5533 class="ec-lmtt-12">\input </span>across engines in 2020, and more.
5534 </p></li>
5535 <li class="itemize">
5536 <!--l. 2748--><p class="noindent" >Petr Olšak, who coordinated and checked all the Czech and Slovak material very
5537 carefully.
5538 </p></li>
5539 <li class="itemize">
5540 <!--l. 2751--><p class="noindent" >Toshio Oshima, for his <span
5541 class="ec-lmss-12">dviout </span>previewer for Windows.
5542 </p></li>
5543 <li class="itemize">
5544 <!--l. 2753--><p class="noindent" >Manuel Pégourié-Gonnard, for helping with package updates, documentation
5545 improvements, and <span
5546 class="ec-lmss-12">texdoc </span>development.
5547 </p></li>
5548
5549
5550 <li class="itemize">
5551 <!--l. 2756--><p class="noindent" >Fabrice Popineau, for the original Windows support in TeX Live and work on the
5552 French documentation.
5553 </p></li>
5554 <li class="itemize">
5555 <!--l. 2759--><p class="noindent" >Norbert Preining, the principal architect of the current TeX Live infrastructure
5556 and installer, and also for coordinating the Debian version of TeX Live (together
5557 with Frank Küster), and doing so much work along the way.
5558 </p></li>
5559 <li class="itemize">
5560 <!--l. 2764--><p class="noindent" >Sebastian Rahtz, for originally creating TeX Live and maintaining it for many
5561 years. Sebastian passed away in March 2016, and we dedicate the continuing work
5562 to his memory.
5563 </p></li>
5564 <li class="itemize">
5565 <!--l. 2768--><p class="noindent" >Luigi Scarso, for continuing development of MetaPost, LuaTeX, and much more.
5566 </p></li>
5567 <li class="itemize">
5568 <!--l. 2771--><p class="noindent" >Andreas Scherer, for <span
5569 class="ec-lmtt-12">cwebbin</span>, the CWEB implementation used in TeX Live, and
5570 continuing maintenance of the original CWEB.
5571 </p></li>
5572 <li class="itemize">
5573 <!--l. 2774--><p class="noindent" >Tim Stewart, for creating the torrents.
5574 </p></li>
5575 <li class="itemize">
5576 <!--l. 2776--><p class="noindent" >Takuji Tanaka, for maintenance of (e)(u)pTeX and related support.
5577 </p></li>
5578 <li class="itemize">
5579 <!--l. 2778--><p class="noindent" >Tomasz Trzeciak, for wide-ranging help with Windows.
5580 </p></li>
5581 <li class="itemize">
5582 <!--l. 2780--><p class="noindent" >Vladimir Volovich, for substantial help with porting and other maintenance issues,
5583 and especially for making it feasible to include <span
5584 class="ec-lmss-12">xindy</span>.
5585 </p></li>
5586 <li class="itemize">
5587 <!--l. 2784--><p class="noindent" >Staszek Wawrykiewicz, a principal tester for all of TeX Live, and coordinator of the
5588 many major Polish contributions: fonts, Windows installation, and more. Staszek
5589 passed away in February 2018, and we dedicate the continuing work to his memory.
5590 </p></li>
5591 <li class="itemize">
5592 <!--l. 2789--><p class="noindent" >Olaf Weber, for his patient maintenance of Web2C in past years.
5593 </p></li>
5594 <li class="itemize">
5595 <!--l. 2791--><p class="noindent" >Gerben Wierda, for creating and maintaining the original macOS support.
5596 </p></li>
5597 <li class="itemize">
5598 <!--l. 2794--><p class="noindent" >Graham Williams, the originator of the TeX Catalogue.
5599
5600
5601 </p></li>
5602 <li class="itemize">
5603 <!--l. 2796--><p class="noindent" >Joseph Wright, for much work on making the same primitive functionality available
5604 across engines.
5605 </p></li>
5606 <li class="itemize">
5607 <!--l. 2799--><p class="noindent" >Hironobu Yamashita, for much work on pTeX and related support.
5608 </p>
5609 </li></ul>
5610 <!--l. 2803--><p class="indent" > Builders of the binaries: Marc Baudoin (<span
5611 class="ec-lmss-12">amd64-netbsd</span>, <span
5612 class="ec-lmss-12">i386-netbsd</span>), Ken Brown
5613 (<span
5614 class="ec-lmss-12">x86_64-cygwin</span>), Akira Kakuto (<span
5615 class="ec-lmss-12">windows</span>), Dick Koch (<span
5616 class="ec-lmss-12">universal-darwin</span>), Mojca Miklavec
5617 (<span
5618 class="ec-lmss-12">x86_64-darwinlegacy</span>), Norbert Preining (<span
5619 class="ec-lmss-12">aarch64-linux</span>, <span
5620 class="ec-lmss-12">armhf-linux</span>, <span
5621 class="ec-lmss-12">i386-freebsd</span>,
5622 <span
5623 class="ec-lmss-12">amd64-freebsd</span>, <span
5624 class="ec-lmss-12">i386-linux</span>, <span
5625 class="ec-lmss-12">x86_64-linux</span>, <span
5626 class="ec-lmss-12">i386-solaris</span>, <span
5627 class="ec-lmss-12">x86_64-solaris</span>, <span
5628 class="ec-lmss-12">x86_64-linuxmusl</span>). For
5629 information on the TeX Live build process, see <a
5630 href="https://tug.org/texlive/build.html" class="url" ><span
5631 class="ec-lmtt-12">https://tug.org/texlive/build.html</span></a>.
5632 </p><!--l. 2819--><p class="indent" > Translators of this manual: Takuto Asakura (Japanese), Denis Bitouzé &#x0026; Patrick Bideault
5633 (French), Carlos Enriquez Figueras (Spanish), Wang Ran, S YS, Jjgod Jiang, Jinsong Zhao,
5634 Yue Wang, &#x0026; Helin Gai (Chinese), Nikola Lečić (Serbian), Marco Pallante &#x0026; Carla Maggi
5635 (Italian), Petr Sojka &#x0026; Jan Busa (Czech/Slovak), Boris Veytsman &#x0026; Vladimir Lomov
5636 (Russian), Zofia Walczak (Polish), Adelheid Grob (German). The TeX Live documentation
5637 web page is <a
5638 href="https://tug.org/texlive/doc.html" class="url" ><span
5639 class="ec-lmtt-12">https://tug.org/texlive/doc.html</span></a>.
5640 </p><!--l. 2832--><p class="indent" > Of course the most important acknowledgement must go to Donald Knuth, first for
5641 inventing TeX, and then for giving it to the world.
5642
5643 </p>
5644 <h3 class="sectionHead"><span class="titlemark">9 </span> <a
5645 id="x1-700009"></a>Release history</h3>
5646
5647 <h4 class="subsectionHead"><span class="titlemark">9.1 </span> <a
5648 id="x1-710009.1"></a>Past</h4>
5649 <!--l. 2841--><p class="noindent" >Discussion began in late 1993 when the Dutch TeX Users Group was starting work on its
5650 4AllTeX CD for MS-DOS users, and it was hoped at that time to issue a single, rational, CD
5651 for all systems. This was too ambitious a target for the time, but it did spawn not
5652 only the very successful 4AllTeX CD, but also the TUG Technical Council working
5653 group on a <span
5654 class="ec-lmri-12">TeX Directory Structure </span>(<a
5655 href="https://tug.org/tds" class="url" ><span
5656 class="ec-lmtt-12">https://tug.org/tds</span></a>), which specified how
5657 to create consistent and manageable collections of TeX support files. A complete
5658 draft of the TDS was published in the December 1995 issue of <span
5659 class="ec-lmro-12">TUGboat</span>, and it was
5660 clear from an early stage that one desirable product would be a model structure on
5661 CD. The distribution you now have is a very direct result of the working group’s
5662 deliberations. It was also clear that the success of the 4AllTeX CD showed that Unix users
5663 would benefit from a similarly easy system, and this is the other main strand of TeX
5664 Live.
5665 </p><!--l. 2857--><p class="indent" > We first undertook to make a new Unix-based TDS CD in the autumn of 1995, and quickly
5666 identified Thomas Esser’s teTeX as the ideal setup, as it already had multi-platform support
5667
5668
5669 and was built with portability across file systems in mind. Thomas agreed to help, and
5670 work began seriously at the start of 1996. The first edition was released in May
5671 1996. At the start of 1997, Karl Berry completed a major new release of Web2c,
5672 which included nearly all the features which Thomas Esser had added in teTeX, and
5673 we decided to base the 2nd edition of the CD on the standard Web2C, with the
5674 addition of teTeX’s <span
5675 class="ec-lmtt-12">texconfig </span>script. The 3rd edition of the CD was based on a
5676 major revision of Web2C, 7.2, by Olaf Weber; at the same time, a new revision of
5677 teTeX was being made, and TeX Live included almost all of its features. The 4th
5678 edition followed the same pattern, using a new version of teTeX, and a new release of
5679 Web2C (7.3). The system now included a complete Windows setup, thanks to Fabrice
5680 Popineau.
5681 </p><!--l. 2873--><p class="indent" > For the 5th edition (March 2000) many parts of the CD were revised and checked,
5682 updating hundreds of packages. Package details were stored in XML files. But the major
5683 change for TeX Live 5 was that all non-free software was removed. Everything in TeX
5684 Live is now intended to be compatible with the Debian Free Software Guidelines (
5685 <a
5686 href="https://debian.org/intro/free" class="url" ><span
5687 class="ec-lmtt-12">https://debian.org/intro/free</span></a>); we have done our best to check the license conditions of
5688 all packages, but we would very much appreciate hearing of any mistakes.
5689 </p><!--l. 2882--><p class="indent" > The 6th edition (July 2001) had much more material updated. The major change was a
5690 new install concept: the user could select a more exact set of needed collections.
5691 Language-related collections were completely reorganized, so selecting any of them installs not
5692 only macros, fonts, etc., but also prepares an appropriate <span
5693 class="ec-lmtt-12">language.dat</span>.
5694 </p><!--l. 2888--><p class="indent" > The 7th edition of 2002 had the notable addition of macOS support, and the usual
5695 myriad of updates to all sorts of packages and programs. An important goal was
5696 integration of the source back with teTeX, to correct the drift apart in versions 5
5697 and 6.
5698
5699 </p>
5700 <h5 class="subsubsectionHead"><span class="titlemark">9.1.1 </span> <a
5701 id="x1-720009.1.1"></a>2003</h5>
5702 <!--l. 2895--><p class="noindent" >In 2003, with the continuing flood of updates and additions, we found that TeX Live had
5703 grown so large it could no longer be contained on a single CD, so we split it into three different
5704 distributions. In addition:
5705 </p>
5706 <ul class="itemize1">
5707 <li class="itemize">
5708 <!--l. 2901--><p class="noindent" >At the request of the LaTeX team, we changed the standard <span
5709 class="ec-lmss-12">latex </span>and <span
5710 class="ec-lmss-12">pdflatex</span>
5711 commands to now use e-TeX (see p. <a
5712 href="#x1-11001x2.3">12<!--tex4ht:ref: text:etex --></a>).
5713 </p></li>
5714 <li class="itemize">
5715 <!--l. 2904--><p class="noindent" >The new Latin Modern fonts were included (and are recommended).
5716 </p></li>
5717 <li class="itemize">
5718 <!--l. 2905--><p class="noindent" >Support for Alpha OSF was removed (HPUX support was removed previously),
5719 since no one had (or volunteered) hardware available on which to compile new
5720
5721
5722 binaries.
5723 </p></li>
5724 <li class="itemize">
5725 <!--l. 2908--><p class="noindent" >Windows setup was substantially changed; for the first time an integrated
5726 environment based on XEmacs was introduced.
5727 </p></li>
5728 <li class="itemize">
5729 <!--l. 2910--><p class="noindent" >Important supplementary programs for Windows (Perl, Ghostscript, ImageMagick,
5730 Ispell) are now installed in the TeX Live installation directory.
5731 </p></li>
5732 <li class="itemize">
5733 <!--l. 2913--><p class="noindent" >Font map files used by <span
5734 class="ec-lmss-12">dvips</span>, <span
5735 class="ec-lmss-12">dvipdfm </span>and <span
5736 class="ec-lmss-12">pdftex </span>are now generated by the new
5737 program <span
5738 class="ec-lmss-12">updmap </span>and installed into <span
5739 class="ec-lmtt-12">texmf/fonts/map</span>.
5740 </p></li>
5741 <li class="itemize">
5742 <!--l. 2916--><p class="noindent" >TeX, Metafont, and MetaPost now, by default, output most input characters (32
5743 and above) as themselves in output (e.g., <span class="obeylines-h"><code class="verb">\write</code></span>) files, log files, and the terminal,
5744 i.e., <span
5745 class="ec-lmri-12">not </span>translated using the <span class="obeylines-h"><code class="verb">^^</code></span> notation. In TeX Live 7, this translation was
5746 dependent on the system locale settings; now, locale settings do not influence the
5747 TeX programs’ behavior. If for some reason you need the <span class="obeylines-h"><code class="verb">^^</code></span> output, rename the
5748 file <span class="obeylines-h"><code class="verb">texmf/web2c/cp8bit.tcx</code></span>. (Future releases will have cleaner ways to control
5749 this.)
5750 </p></li>
5751 <li class="itemize">
5752 <!--l. 2926--><p class="noindent" >This documentation was substantially revised.
5753 </p></li>
5754 <li class="itemize">
5755 <!--l. 2927--><p class="noindent" >Finally, since the edition numbers had grown unwieldy, the version is now simply
5756 identified by the year: TeX Live 2003.</p></li></ul>
5757
5758 <h5 class="subsubsectionHead"><span class="titlemark">9.1.2 </span> <a
5759 id="x1-730009.1.2"></a>2004</h5>
5760 <!--l. 2934--><p class="noindent" >2004 saw many changes:
5761 </p>
5762 <ul class="itemize1">
5763 <li class="itemize">
5764 <!--l. 2938--><p class="noindent" >If you have locally-installed fonts which use their own <span
5765 class="ec-lmtt-12">.map </span>or (much less likely)
5766 <span
5767 class="ec-lmtt-12">.enc </span>support files, you may need to move those support files.
5768 </p><!--l. 2942--><p class="noindent" ><span
5769 class="ec-lmtt-12">.map </span>files are now searched for in subdirectories of <span
5770 class="ec-lmtt-12">fonts/map </span>only (in each <span
5771 class="ec-lmtt-12">texmf</span>
5772 tree), along the <span
5773 class="ec-lmtt-12">TEXFONTMAPS </span>path. Similarly, <span
5774 class="ec-lmtt-12">.enc </span>files are now searched for in
5775 subdirectories of <span
5776 class="ec-lmtt-12">fonts/enc </span>only, along the <span
5777 class="ec-lmtt-12">ENCFONTS </span>path. <span
5778 class="ec-lmss-12">updmap </span>will attempt
5779 to warn about problematic files.
5780 </p><!--l. 2949--><p class="noindent" >For methods of handling this and other information, please see
5781 <a
5782 href="https://tug.org/texlive/mapenc.html" class="url" ><span
5783 class="ec-lmtt-12">https://tug.org/texlive/mapenc.html</span></a>.
5784
5785
5786 </p></li>
5787 <li class="itemize">
5788 <!--l. 2952--><p class="noindent" >The TeX Collection has been expanded with the addition of a MiKTeX-based
5789 installable CD, for those who prefer that implementation to Web2C. See section <a
5790 href="#x1-80002">2<!--tex4ht:ref: sec:overview-tl --></a>
5791 (p. <a
5792 href="#x1-80002">8<!--tex4ht:ref: sec:overview-tl --></a>).
5793 </p></li>
5794 <li class="itemize">
5795 <!--l. 2956--><p class="noindent" >Within TeX Live, the single large <span
5796 class="ec-lmtt-12">texmf </span>tree of previous releases has been replaced
5797 by three: <span
5798 class="ec-lmtt-12">texmf</span>, <span
5799 class="ec-lmtt-12">texmf-dist</span>, and <span
5800 class="ec-lmtt-12">texmf-doc</span>. See section <a
5801 href="#x1-90002.1">2.1<!--tex4ht:ref: sec:tld --></a> (p. <a
5802 href="#x1-90002.1">8<!--tex4ht:ref: sec:tld --></a>), and the
5803 <span
5804 class="ec-lmtt-12">README </span>files for each.
5805 </p></li>
5806 <li class="itemize">
5807 <!--l. 2962--><p class="noindent" >All TeX-related input files are now collected in the <span
5808 class="ec-lmtt-12">tex </span>subdirectory of <span
5809 class="ec-lmtt-12">texmf*</span>
5810 trees, rather than having separate sibling directories <span
5811 class="ec-lmtt-12">tex</span>, <span
5812 class="ec-lmtt-12">etex</span>, <span
5813 class="ec-lmtt-12">pdftex</span>, <span
5814 class="ec-lmtt-12">pdfetex</span>,
5815 etc. See <a
5816 href="../../../../texmf-dist/doc/generic/tds/tds.html#Extensions" ><span
5817 class="ec-lmtt-12">texmf-dist/doc/generic/tds/tds.html#Extensions</span></a>.
5818 </p></li>
5819 <li class="itemize">
5820 <!--l. 2969--><p class="noindent" >Helper scripts
5821 (not meant to be invoked by users) are now located in a new <span
5822 class="ec-lmtt-12">scripts </span>subdirectory
5823 of <span
5824 class="ec-lmtt-12">texmf* </span>trees, and can be searched for via <span class="obeylines-h"><code class="verb">kpsewhich -format=texmfscripts</code></span>.
5825 So if you have programs which call such scripts, they’ll need to be adjusted. See
5826 <a
5827 href="https://tug.org/tds/tds.html\#Scripts" class="url" ><span
5828 class="ec-lmtt-12">https://tug.org/tds/tds.html\#Scripts</span></a>.
5829 </p></li>
5830 <li class="itemize">
5831 <!--l. 2975--><p class="noindent" >Almost all formats leave most characters printable as themselves via the
5832 “translation file” <span
5833 class="ec-lmtt-12">cp227.tcx</span>, instead of translating them with the <span class="obeylines-h"><code class="verb">^^</code></span> notation.
5834 Specifically, characters at positions 32–256, plus tab, vertical tab, and form
5835 feed are considered printable and not translated. The exceptions are plain
5836 TeX (only 32–126 printable), ConTeXt (0–255 printable), and the Omega-related
5837 formats. This default behavior is almost the same as in TeX Live 2003, but
5838 it’s implemented more cleanly, with more possibilities for customization. See
5839 <a
5840 href="../../../../texmf-dist/doc/web2c/web2c.html#TCX-files" ><span
5841 class="ec-lmtt-12">texmf-dist/doc/web2c/web2c.html#TCX-files</span></a>. (By the way, with Unicode
5842 input, TeX may output partial character sequences when showing error contexts,
5843 since it is byte-oriented.)
5844 </p></li>
5845 <li class="itemize">
5846 <!--l. 2988--><p class="noindent" ><span
5847 class="ec-lmss-12">pdfetex </span>is now the default engine for all formats except (plain) <span
5848 class="ec-lmss-12">tex </span>itself. (Of course
5849 it generates DVI when run as <span
5850 class="ec-lmss-12">latex</span>, etc.) This means, among other things, that the
5851 microtypographic features of <span
5852 class="ec-lmss-12">pdftex </span>are available in LaTeX, ConTeXt, etc., as well
5853 as the e-TeX features (<a
5854 href="../../../../texmf-dist/doc/etex/base/" >texmf-dist/doc/etex/base/</a>).
5855 </p><!--l. 2995--><p class="noindent" >It also means it’s <span
5856 class="ec-lmri-12">more important than ever </span>to use the <span
5857 class="ec-lmss-12">ifpdf </span>package (works
5858 with both plain and LaTeX) or equivalent code, because simply testing whether
5859 <span
5860 class="ec-lmtt-12">\pdfoutput </span>or some other primitive is defined is not a reliable way to determine
5861 if PDF output is being generated. We made this backward compatible as best we
5862 could this year, but next year, <span
5863 class="ec-lmtt-12">\pdfoutput </span>may be defined even when DVI is being
5864 written.
5865 </p></li>
5866
5867
5868 <li class="itemize">
5869 <!--l. 3003--><p class="noindent" >pdfTeX (<a
5870 href="http://pdftex.org" class="url" ><span
5871 class="ec-lmtt-12">http://pdftex.org</span></a>) has many new features:
5872 </p>
5873 <ul class="itemize2">
5874 <li class="itemize">
5875 <!--l. 3007--><p class="noindent" ><span
5876 class="ec-lmtt-12">\pdfmapfile </span>and <span
5877 class="ec-lmtt-12">\pdfmapline </span>provide font map support from within a
5878 document.
5879 </p></li>
5880 <li class="itemize">
5881 <!--l. 3010--><p class="noindent" >Microtypographic font expansion can be used more easily.<br
5882 class="newline" /><a
5883 href="http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html" class="url" ><span
5884 class="ec-lmtt-12">http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html</span></a>
5885 </p></li>
5886 <li class="itemize">
5887 <!--l. 3013--><p class="noindent" >All parameters previously set through the special
5888 configuration file <span
5889 class="ec-lmtt-12">pdftex.cfg </span>must now be set through primitives, typically
5890 in <span
5891 class="ec-lmtt-12">pdftexconfig.tex</span>; <span
5892 class="ec-lmtt-12">pdftex.cfg </span>is no longer supported. Any extant <span
5893 class="ec-lmtt-12">.fmt</span>
5894 files must be redumped when <span
5895 class="ec-lmtt-12">pdftexconfig.tex </span>is changed.
5896 </p></li>
5897 <li class="itemize">
5898 <!--l. 3019--><p class="noindent" >See the pdfTeX manual for more:
5899 <a
5900 href="../../../../texmf-dist/doc/pdftex/manual/pdftex-a.pdf" >texmf-dist/doc/pdftex/manual/pdftex-a.pdf</a>.
5901 </p>
5902 </li></ul>
5903 </li>
5904 <li class="itemize">
5905 <!--l. 3023--><p class="noindent" >The <span
5906 class="ec-lmtt-12">\input </span>primitive in <span
5907 class="ec-lmss-12">tex </span>(and <span
5908 class="ec-lmss-12">mf </span>and <span
5909 class="ec-lmss-12">mpost</span>) now accepts double quotes containing
5910 spaces and other special characters. Typical examples:
5911
5912
5913 </p>
5914 <pre class="verbatim" id="verbatim-8">
5915 <pre class="fancyvrb" id="fancyvrb21"><a
5916 id="x1-73002r1"></a>\input &#x0022;filename with spaces&#x0022;   % plain
5917 <a
5918 id="x1-73004r2"></a>\input{&#x0022;filename with spaces&#x0022;}  % latex</pre>
5919 </pre>
5920 <!--l. 3029--><p class="nopar" >See the Web2C manual for more: <a
5921 href="../../../../texmf-dist/doc/web2c" >texmf-dist/doc/web2c</a>.
5922 </p></li>
5923 <li class="itemize">
5924 <!--l. 3032--><p class="noindent" >encTeX support is now included within Web2C and consequently all TeX programs,
5925 via the <span
5926 class="ec-lmtt-12">-enc </span>option — <span
5927 class="ec-lmri-12">only when formats are built</span>. encTeX supports general
5928 re-encoding of input and output, enabling full support of Unicode (in UTF-8). See
5929 <a
5930 href="../../../../texmf-dist/doc/generic/enctex/" >texmf-dist/doc/generic/enctex/</a> and <a
5931 href="http://olsak.net/enctex.html" class="url" ><span
5932 class="ec-lmtt-12">http://olsak.net/enctex.html</span></a>.
5933 </p></li>
5934 <li class="itemize">
5935 <!--l. 3039--><p class="noindent" >Aleph, a new engine combining e-TeX and Omega, is available. Some information is
5936 available in <a
5937 href="../../../../texmf-dist/doc/aleph/base" >texmf-dist/doc/aleph/base</a> and <a
5938 href="https://texfaq.org/FAQ-enginedev" class="url" ><span
5939 class="ec-lmtt-12">https://texfaq.org/FAQ-enginedev</span></a>.
5940 The LaTeX-based format for Aleph is named <span
5941 class="ec-lmss-12">lamed</span>.
5942 </p></li>
5943 <li class="itemize">
5944 <!--l. 3044--><p class="noindent" >The latest LaTeX release has a new version of the LPPL — now officially a
5945 Debian-approved license. Assorted other updates, see the <span
5946 class="ec-lmtt-12">ltnews </span>files in
5947 <a
5948 href="../../../../texmf-dist/doc/latex/base" >texmf-dist/doc/latex/base</a>.
5949 </p></li>
5950 <li class="itemize">
5951 <!--l. 3049--><p class="noindent" ><span
5952 class="ec-lmss-12">dvipng</span>, a new program for converting DVI to PNG image files, is included. See
5953 <a
5954 href="https://ctan.org/pkg/dvipng" class="url" ><span
5955 class="ec-lmtt-12">https://ctan.org/pkg/dvipng</span></a>.
5956 </p></li>
5957 <li class="itemize">
5958 <!--l. 3053--><p class="noindent" >We reduced the <span
5959 class="ec-lmss-12">cbgreek </span>package to a “medium” sized set of fonts, with the assent and
5960 advice of the author (Claudio Beccari). The excised fonts are the invisible, outline, and
5961 transparency ones, which are relatively rarely used, and we needed the space. The full set
5962 is of course available from CTAN (<a
5963 href="https://ctan.org/pkg/cbgreek-complete" class="url" ><span
5964 class="ec-lmtt-12">https://ctan.org/pkg/cbgreek-complete</span></a>).
5965 </p></li>
5966 <li class="itemize">
5967 <!--l. 3059--><p class="noindent" ><span
5968 class="ec-lmss-12">oxdvi </span>has been removed; just use <span
5969 class="ec-lmss-12">xdvi</span>.
5970 </p></li>
5971 <li class="itemize">
5972 <!--l. 3061--><p class="noindent" >The <span
5973 class="ec-lmss-12">ini </span>and <span
5974 class="ec-lmss-12">vir </span>commands (links) for <span
5975 class="ec-lmss-12">tex</span>, <span
5976 class="ec-lmss-12">mf</span>, and <span
5977 class="ec-lmss-12">mpost </span>are no longer created, such as
5978 <span
5979 class="ec-lmss-12">initex</span>. The <span
5980 class="ec-lmss-12">ini </span>functionality has been available through the command-line option <span
5981 class="ec-lmtt-12">-ini </span>for
5982 years now.
5983 </p></li>
5984 <li class="itemize">
5985 <!--l. 3066--><p class="noindent" ><span
5986 class="ec-lmss-12">i386-openbsd </span>platform support was removed. Since the <span
5987 class="ec-lmss-12">tetex </span>package in the BSD Ports
5988 system is available, and GNU/Linux and FreeBSD binaries were available, it seemed
5989 volunteer time could be better spent elsewhere.
5990 </p></li>
5991 <li class="itemize">
5992 <!--l. 3071--><p class="noindent" >On <span
5993 class="ec-lmss-12">sparc-solaris </span>(at least), you may have to set the <span
5994 class="ec-lmtt-12">LD_LIBRARY_PATH </span>environment
5995
5996
5997 variable to run the <span
5998 class="ec-lmss-12">t1utils </span>programs. This is because they are compiled with C++, and
5999 there is no standard location for the runtime libraries. (This is not new in 2004, but
6000 wasn’t previously documented.) Similarly, on <span
6001 class="ec-lmss-12">mips-irix</span>, the MIPSpro 7.4 runtimes are
6002 required.
6003 </p>
6004 </li></ul>
6005
6006 <h5 class="subsubsectionHead"><span class="titlemark">9.1.3 </span> <a
6007 id="x1-740009.1.3"></a>2005</h5>
6008 <!--l. 3082--><p class="noindent" >2005 saw the usual huge number of updates to packages and programs. The infrastructure
6009 stayed relatively stable from 2004, but inevitably there were some changes there as
6010 well:
6011 </p>
6012 <ul class="itemize1">
6013 <li class="itemize">
6014 <!--l. 3088--><p class="noindent" >New scripts <span
6015 class="ec-lmss-12">texconfig-sys</span>, <span
6016 class="ec-lmss-12">updmap-sys</span>, and <span
6017 class="ec-lmss-12">fmtutil-sys </span>were introduced, which
6018 modify the configuration in the system trees. The <span
6019 class="ec-lmss-12">texconfig</span>, <span
6020 class="ec-lmss-12">updmap</span>, and <span
6021 class="ec-lmss-12">fmtutil</span>
6022 scripts now modify user-specific files, under <span
6023 class="ec-lmtt-12">$HOME/.texlive2005</span>.
6024 </p></li>
6025 <li class="itemize">
6026 <!--l. 3094--><p class="noindent" >Corresponding new variables <span
6027 class="ec-lmtt-12">TEXMFCONFIG </span>and <span
6028 class="ec-lmtt-12">TEXMFSYSCONFIG </span>to specify the
6029 trees where configuration files (user or system, respectively) are found. Thus,
6030 you may need to move personal versions of <span
6031 class="ec-lmtt-12">fmtutil.cnf </span>and <span
6032 class="ec-lmtt-12">updmap.cfg </span>to
6033 these places; another option is to redefine <span
6034 class="ec-lmtt-12">TEXMFCONFIG </span>or <span
6035 class="ec-lmtt-12">TEXMFSYSCONFIG</span>
6036 in <span
6037 class="ec-lmtt-12">texmf.cnf</span>. In any case the real location of these files and the values of
6038 <span
6039 class="ec-lmtt-12">TEXMFCONFIG </span>and <span
6040 class="ec-lmtt-12">TEXMFSYSCONFIG </span>must agree. See section <a
6041 href="#x1-100002.2">2.2<!--tex4ht:ref: sec:texmftrees --></a>, p. <a
6042 href="#x1-100002.2">10<!--tex4ht:ref: sec:texmftrees --></a>.
6043 </p></li>
6044 <li class="itemize">
6045 <!--l. 3105--><p class="noindent" >Last year, we kept <span class="obeylines-h"><code class="verb">\pdfoutput</code></span> and other primitives undefined for DVI output,
6046 even though the <span
6047 class="ec-lmss-12">pdfetex </span>program was being used. This year, as promised, we undid
6048 that compatibility measure. So if your document uses <span class="obeylines-h"><code class="verb">\ifx\pdfoutput\undefined</code></span>
6049 to test if PDF is being output, it will need to be changed. You can use the package
6050 <span
6051 class="ec-lmss-12">ifpdf.sty </span>(which works under both plain TeX and LaTeX) to do this, or steal its
6052 logic.
6053 </p></li>
6054 <li class="itemize">
6055 <!--l. 3113--><p class="noindent" >Last year, we changed most formats to output (8-bit) characters as themselves (see
6056 previous section). The new TCX file <span
6057 class="ec-lmtt-12">empty.tcx </span>now provides an easier way to get the
6058 original <span class="obeylines-h"><code class="verb">^^</code></span> notation if you so desire, as in:
6059
6060
6061 </p>
6062 <pre class="verbatim" id="verbatim-9">
6063 <pre class="fancyvrb" id="fancyvrb22"><a
6064 id="x1-74002r1"></a>latex --translate-file=empty.tcx yourfile.tex</pre>
6065 </pre>
6066 <!--l. 3119--><p class="nopar" >
6067 </p></li>
6068 <li class="itemize">
6069 <!--l. 3121--><p class="noindent" >The new program <span
6070 class="ec-lmss-12">dvipdfmx </span>is included for translation of DVI to PDF; this is an actively
6071 maintained update of <span
6072 class="ec-lmss-12">dvipdfm </span>(which is also still available for now, though no longer
6073 recommended).
6074 </p></li>
6075 <li class="itemize">
6076 <!--l. 3126--><p class="noindent" >The new programs <span
6077 class="ec-lmss-12">pdfopen </span>and <span
6078 class="ec-lmss-12">pdfclose </span>are included to allow reloading of PDF files in
6079 the Adobe Acrobat Reader without restarting the program. (Other PDF readers, notably
6080 <span
6081 class="ec-lmss-12">xpdf</span>, <span
6082 class="ec-lmss-12">gv</span>, and <span
6083 class="ec-lmss-12">gsview</span>, have never suffered from this problem.)
6084 </p></li>
6085 <li class="itemize">
6086 <!--l. 3132--><p class="noindent" >For consistency, the variables <span
6087 class="ec-lmtt-12">HOMETEXMF </span>and <span
6088 class="ec-lmtt-12">VARTEXMF </span>have been renamed to
6089 <span
6090 class="ec-lmtt-12">TEXMFHOME </span>and <span
6091 class="ec-lmtt-12">TEXMFSYSVAR</span>, respectively. There is also <span
6092 class="ec-lmtt-12">TEXMFVAR</span>, which is by default
6093 user-specific. See the first point above.
6094 </p>
6095 </li></ul>
6096
6097 <h5 class="subsubsectionHead"><span class="titlemark">9.1.4 </span> <a
6098 id="x1-750009.1.4"></a>2006–2007</h5>
6099 <!--l. 3143--><p class="noindent" >In 2006–2007, the major new addition to TeX Live was the XeTeX program, available as the
6100 <span
6101 class="ec-lmtt-12">xetex </span>and <span
6102 class="ec-lmtt-12">xelatex </span>programs; see <a
6103 href="https://scripts.sil.org/xetex" class="url" ><span
6104 class="ec-lmtt-12">https://scripts.sil.org/xetex</span></a>.
6105 </p><!--l. 3147--><p class="indent" > MetaPost also received a notable update, with more planned for the
6106 future (<a
6107 href="https://tug.org/metapost/articles" class="url" ><span
6108 class="ec-lmtt-12">https://tug.org/metapost/articles</span></a>), likewise pdfTeX (
6109 <a
6110 href="https://tug.org/applications/pdftex" class="url" ><span
6111 class="ec-lmtt-12">https://tug.org/applications/pdftex</span></a>).
6112 </p><!--l. 3151--><p class="indent" > The TeX <span
6113 class="ec-lmtt-12">.fmt </span>(high-speed format) and the similar files for MetaPost and Metafont are
6114 now stored in subdirectories of <span
6115 class="ec-lmtt-12">texmf/web2c</span>, instead of in the directory itself (although the
6116 directory is still searched, for the sake of existing <span
6117 class="ec-lmtt-12">.fmt</span>’s). The subdirectories are named for the
6118 ‘engine’ in use, such as <span
6119 class="ec-lmtt-12">tex </span>or <span
6120 class="ec-lmtt-12">pdftex </span>or <span
6121 class="ec-lmtt-12">xetex</span>. This change should be invisible in normal
6122 use.
6123 </p><!--l. 3159--><p class="indent" > The (plain) <span
6124 class="ec-lmtt-12">tex </span>program no longer reads <span
6125 class="ec-lmtt-12">%&#x0026; </span>first lines to determine what format
6126 to run; it is the pure Knuthian TeX. (LaTeX and everything else do still read <span
6127 class="ec-lmtt-12">%&#x0026;</span>
6128 lines).
6129 </p><!--l. 3163--><p class="indent" > Of course the year also saw (the usual) hundreds of other updates to packages and
6130 programs. As usual, please check CTAN (<a
6131 href="https://ctan.org" class="url" ><span
6132 class="ec-lmtt-12">https://ctan.org</span></a>) for updates.
6133 </p><!--l. 3167--><p class="indent" > Internally, the source tree is now stored in Subversion, with a standard web interface for
6134 viewing the tree, as linked from our home page. Although not visible in the final
6135 distribution, we expect this will provide a stable development foundation for future
6136 years.
6137 </p><!--l. 3172--><p class="indent" > Finally, in May 2006 Thomas Esser announced that he would no longer be updating teTeX
6138 (<a
6139 href="https://tug.org/tetex" class="url" ><span
6140 class="ec-lmtt-12">https://tug.org/tetex</span></a>). As a result, there was a surge of interest in TeX Live, especially
6141
6142
6143 among GNU/Linux distributors. (There is a new <span
6144 class="ec-lmtt-12">tetex </span>installation scheme in TeX Live, which
6145 provides an approximate equivalent.) We hope this will eventually translate to improvements
6146 in the TeX environment for everyone.
6147
6148 </p>
6149 <h5 class="subsubsectionHead"><span class="titlemark">9.1.5 </span> <a
6150 id="x1-760009.1.5"></a>2008</h5>
6151 <!--l. 3182--><p class="noindent" >In 2008, the entire TeX Live infrastructure was redesigned and reimplemented. Complete
6152 information about an installation is now stored in a plain text file <span
6153 class="ec-lmtt-12">tlpkg/texlive.tlpdb</span>.
6154 </p><!--l. 3186--><p class="indent" > Among other things, this finally makes possible upgrading a TeX Live installation
6155 over the Internet after the initial installation, a feature MiKTeX has provided for
6156 many years. We expect to regularly update new packages as they are released to
6157 CTAN.
6158 </p><!--l. 3191--><p class="indent" > The major new engine LuaTeX (<a
6159 href="http://luatex.org" class="url" ><span
6160 class="ec-lmtt-12">http://luatex.org</span></a>) is included; besides a new level of
6161 flexibility in typesetting, this provides an excellent scripting language for use both inside and
6162 outside of TeX documents.
6163 </p><!--l. 3196--><p class="indent" > Support among Windows and the Unix-based platforms is now much more uniform. In
6164 particular, most Perl and Lua scripts are now available on Windows, using the Perl internally
6165 distributed with TeX Live.
6166 </p><!--l. 3200--><p class="indent" > The new <span
6167 class="ec-lmss-12">tlmgr </span>script (section <a
6168 href="#x1-420005">5<!--tex4ht:ref: sec:tlmgr --></a>) is the general interface for managing TeX Live after the
6169 initial installation. It handles package updates and consequent regeneration of formats, map
6170 files, and language files, optionally including local additions.
6171 </p><!--l. 3205--><p class="indent" > With the advent of <span
6172 class="ec-lmss-12">tlmgr</span>, the <span
6173 class="ec-lmss-12">texconfig </span>actions to edit the format and hyphenation
6174 configuration files are now disabled.
6175 </p><!--l. 3208--><p class="indent" > The <span
6176 class="ec-lmss-12">xindy </span>indexing program (<a
6177 href="http://xindy.sourceforge.net/" class="url" ><span
6178 class="ec-lmtt-12">http://xindy.sourceforge.net/</span></a>) is now included on
6179 most platforms.
6180 </p><!--l. 3211--><p class="indent" > The <span
6181 class="ec-lmss-12">kpsewhich </span>tool can now report all matches for a given file (option <span
6182 class="ec-lmtt-12">--all</span>) and limit
6183 matches to a given subdirectory (option <span
6184 class="ec-lmtt-12">--subdir</span>).
6185 </p><!--l. 3215--><p class="indent" > The <span
6186 class="ec-lmss-12">dvipdfmx </span>program now includes functionality to extract bounding box information, via
6187 the command name <span
6188 class="ec-lmss-12">extractbb</span>; this was one of the last features provided by <span
6189 class="ec-lmss-12">dvipdfm </span>not in
6190 <span
6191 class="ec-lmss-12">dvipdfmx</span>.
6192 </p><!--l. 3220--><p class="indent" > The font aliases <span
6193 class="ec-lmtt-12">Times-Roman</span>, <span
6194 class="ec-lmtt-12">Helvetica</span>, and so on have been removed. Different
6195 packages expected them to behave differently (in particular, to have different encodings), and
6196 there was no good way to resolve this.
6197 </p><!--l. 3225--><p class="indent" > The <span
6198 class="ec-lmss-12">platex </span>format has been removed, to resolve a name conflict with a completely different
6199 Japanese <span
6200 class="ec-lmss-12">platex</span>; the <span
6201 class="ec-lmss-12">polski </span>package is now the main Polish support.
6202 </p><!--l. 3229--><p class="indent" > Internally, the <span
6203 class="ec-lmtt-12">WEB</span> string pool files are now compiled into the binaries, to ease
6204 upgrades.
6205 </p><!--l. 3232--><p class="indent" > Finally, the changes made by Donald Knuth in his ‘TeX tuneup of 2008’ are included in
6206 this release. See <a
6207 href="https://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf" class="url" ><span
6208 class="ec-lmtt-12">https://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf</span></a>.
6209
6210 </p>
6211 <h5 class="subsubsectionHead"><span class="titlemark">9.1.6 </span> <a
6212 id="x1-770009.1.6"></a>2009</h5>
6213
6214
6215 <!--l. 3238--><p class="noindent" >In 2009, the default output format for Lua(L<span
6216 class="ec-lmr-8">A</span>)TeX is now PDF, to take advantage of LuaTeX’s
6217 OpenType support, et al. New executables named <span
6218 class="ec-lmtt-12">dviluatex </span>and <span
6219 class="ec-lmtt-12">dvilualatex </span>run
6220 LuaTeX with DVI output. The LuaTeX home page is <a
6221 href="http://luatex.org" class="url" ><span
6222 class="ec-lmtt-12">http://luatex.org</span></a>.
6223 </p><!--l. 3243--><p class="indent" > The original Omega engine and Lambda format have been excised, after discussions
6224 with the Omega authors. The updated Aleph and Lamed remain, as do the Omega
6225 utilities.
6226 </p><!--l. 3247--><p class="indent" > A new release of the AMS Type 1 fonts is included, including Computer Modern: a few shape
6227 changes made over the years by Knuth in the Metafont sources have been integrated, and the
6228 hinting has been updated. The Euler fonts have been thoroughly reshaped by Hermann Zapf (see
6229 <a
6230 href="https://tug.org/TUGboat/Articles/tb29-2/tb92hagen-euler.pdf" class="url" ><span
6231 class="ec-lmtt-12">https://tug.org/TUGboat/Articles/tb29-2/tb92hagen-euler.pdf</span></a>). In all cases, the metrics
6232 remain unchanged. The AMS fonts home page is <a
6233 href="https://ams.org/tex/amsfonts.html" class="url" ><span
6234 class="ec-lmtt-12">https://ams.org/tex/amsfonts.html</span></a>.
6235 </p><!--l. 3255--><p class="indent" > The new GUI front end TeXworks is included for Windows, and also in MacTeX. For other
6236 platforms, and more information, see the TeXworks home page, <a
6237 href="https://tug.org/texworks" class="url" ><span
6238 class="ec-lmtt-12">https://tug.org/texworks</span></a>.
6239 It is a cross-platform front-end inspired by the macOS TeXShop editor, aiming at
6240 ease-of-use.
6241 </p><!--l. 3261--><p class="indent" > The graphics program Asymptote is included for several platforms. This implements a
6242 text-based graphics description language vaguely akin to MetaPost, but with advanced 3D
6243 support and other features. Its home page is <a
6244 href="https://asymptote.sourceforge.io" class="url" ><span
6245 class="ec-lmtt-12">https://asymptote.sourceforge.io</span></a>.
6246 </p><!--l. 3266--><p class="indent" > The separate <span
6247 class="ec-lmtt-12">dvipdfm </span>program has been replaced by <span
6248 class="ec-lmtt-12">dvipdfmx</span>, which operates in a special
6249 compatibility mode under that name. <span
6250 class="ec-lmtt-12">dvipdfmx </span>includes CJK support and has accumulated
6251 many other fixes over the years since the last <span
6252 class="ec-lmtt-12">dvipdfm </span>release.
6253 </p><!--l. 3272--><p class="indent" > Executables for the <span
6254 class="ec-lmss-12">cygwin </span>and <span
6255 class="ec-lmss-12">i386-netbsd </span>platforms are now included, while we were
6256 advised that OpenBSD users get TeX through their package systems, plus there
6257 were difficulties in making binaries that have a chance of working on more than one
6258 version.
6259 </p><!--l. 3277--><p class="indent" > A miscellany of smaller changes: we now use <span
6260 class="ec-lmss-12">xz </span>compression, the stable replacement for
6261 <span
6262 class="ec-lmss-12">lzma </span>(<a
6263 href="https://tukaani.org/xz/" class="url" ><span
6264 class="ec-lmtt-12">https://tukaani.org/xz/</span></a>); a literal <span class="obeylines-h"><code class="verb">$</code></span> is allowed in filenames when it does not
6265 introduce a known variable name; the Kpathsea library is now multi-threaded (made use of in
6266 MetaPost); the entire TeX Live build is now based on Automake.
6267 </p><!--l. 3284--><p class="indent" > Final note on the past: all releases of TeX Live, along with ancillary material such as
6268 CD labels, are available at <a
6269 href="ftp://tug.org/historic/systems/texlive" class="url" ><span
6270 class="ec-lmtt-12">ftp://tug.org/historic/systems/texlive</span></a>.
6271
6272 </p>
6273 <h5 class="subsubsectionHead"><span class="titlemark">9.1.7 </span> <a
6274 id="x1-780009.1.7"></a>2010</h5>
6275 <!--l. 3292--><p class="noindent" >In 2010, the default version for PDF output is now 1.5, enabling more compression. This
6276 applies to all the TeX engines when used to produce PDF and to <span
6277 class="ec-lmtt-12">dvipdfmx</span>. Loading the <span
6278 class="ec-lmss-12">pdf14</span>
6279 LaTeX package changes back to PDF 1.4, or set <span class="obeylines-h"><code class="verb">\pdfminorversion=4</code></span>.
6280 </p><!--l. 3297--><p class="indent" > pdf(L<span
6281 class="ec-lmr-8">A</span>)TeX now <span
6282 class="ec-lmri-12">automatically </span>converts a requested Encapsulated PostScript (EPS) file to
6283 PDF, via the <span
6284 class="ec-lmss-12">epstopdf </span>package, when and if the LaTeX <span
6285 class="ec-lmtt-12">graphics.cfg </span>configuration file is
6286 loaded, and PDF is being output. The default options are intended to eliminate
6287 any chance of hand-created PDF files being overwritten, but you can also prevent
6288 <span
6289 class="ec-lmtt-12">epstopdf </span>from being loaded at all by putting <span class="obeylines-h"><code class="verb">\newcommand{\DoNotLoadEpstopdf}{}</code></span>
6290 (or <span class="obeylines-h"><code class="verb">\def...</code></span>) before the <span
6291 class="ec-lmtt-12">\documentclass </span>declaration. It is also not loaded if the
6292 <span
6293 class="ec-lmss-12">pst-pdf </span>package is used. For more details, see the <span
6294 class="ec-lmss-12">epstopdf </span>package documentation (
6295
6296
6297 <a
6298 href="https://ctan.org/pkg/epstopdf-pkg" class="url" ><span
6299 class="ec-lmtt-12">https://ctan.org/pkg/epstopdf-pkg</span></a>).
6300 </p><!--l. 3309--><p class="indent" > A related change is that execution of a very few external commands from TeX, via
6301 the <span
6302 class="ec-lmtt-12">\write18 </span>feature, is now enabled by default. These commands are <span
6303 class="ec-lmtt-12">repstopdf</span>,
6304 <span
6305 class="ec-lmtt-12">makeindex</span>, <span
6306 class="ec-lmtt-12">kpsewhich</span>, <span
6307 class="ec-lmtt-12">bibtex</span>, and <span
6308 class="ec-lmtt-12">bibtex8</span>; the list is defined in <span
6309 class="ec-lmtt-12">texmf.cnf</span>.
6310 Environments which must disallow all such external commands can deselect this option in
6311 the installer (see section <a
6312 href="#x1-250003.2.4">3.2.4<!--tex4ht:ref: sec:options --></a>), or override the value after installation by running
6313 <span class="obeylines-h"><code class="verb">tlmgr conf texmf shell_escape 0</code></span>.
6314 </p><!--l. 3318--><p class="indent" > Yet another related change is that BibTeX and Makeindex now refuse to write their output
6315 files to an arbitrary directory (like TeX itself), by default. This is so they can now be enabled
6316 for use by the restricted <span
6317 class="ec-lmtt-12">\write18</span>. To change this, the <span
6318 class="ec-lmtt-12">TEXMFOUTPUT </span>environment variable can
6319 be set, or the <span class="obeylines-h"><code class="verb">openout_any</code></span> setting changed.
6320 </p><!--l. 3324--><p class="indent" > XeTeX now supports margin kerning along the same lines as pdfTeX. (Font expansion is
6321 not presently supported.)
6322 </p><!--l. 3327--><p class="indent" > By default, <span
6323 class="ec-lmss-12">tlmgr </span>now saves one backup of each package updated (<span
6324 class="ec-lmtt-12">tlmgr option</span>
6325 <span
6326 class="ec-lmtt-12">autobackup 1</span>), so broken package updates can be easily reverted with <span
6327 class="ec-lmtt-12">tlmgr restore</span>. If you
6328 do post-install updates, and don’t have the disk space for the backups, run <span
6329 class="ec-lmtt-12">tlmgr option</span>
6330 <span
6331 class="ec-lmtt-12">autobackup 0</span>.
6332 </p><!--l. 3333--><p class="indent" > New programs included: the pTeX engine and related utilities for typesetting Japanese; the
6333 BibTeXU program for Unicode-enabled BibTeX; the <span
6334 class="ec-lmss-12">chktex </span>utility (originally from
6335 <a
6336 href="http://baruch.ev-en.org/proj/chktex" class="url" ><span
6337 class="ec-lmtt-12">http://baruch.ev-en.org/proj/chktex</span></a>) for checking (L<span
6338 class="ec-lmr-8">A</span>)TeX documents; the <span
6339 class="ec-lmss-12">dvisvgm </span>(
6340 <a
6341 href="https://dvisvgm.de" class="url" ><span
6342 class="ec-lmtt-12">https://dvisvgm.de</span></a>) DVI-to-SVG translator.
6343 </p><!--l. 3341--><p class="indent" > Executables for these new platforms are included: <span
6344 class="ec-lmtt-12">amd64-freebsd</span>, <span
6345 class="ec-lmtt-12">amd64-kfreebsd</span>,
6346 <span
6347 class="ec-lmtt-12">i386-freebsd</span>, <span
6348 class="ec-lmtt-12">i386-kfreebsd</span>, <span
6349 class="ec-lmtt-12">x86_64-darwin</span>, <span
6350 class="ec-lmtt-12">x86_64-solaris</span>.
6351 </p><!--l. 3345--><p class="indent" > A change in TeX Live 2009 that we failed to note: numerous TeX4ht-related executables (
6352 <a
6353 href="https://tug.org/tex4ht" class="url" ><span
6354 class="ec-lmtt-12">https://tug.org/tex4ht</span></a>) were removed from the binary directories. The generic <span
6355 class="ec-lmtt-12">mk4ht</span>
6356 program can be used to run any of the various <span
6357 class="ec-lmtt-12">tex4ht </span>combinations.
6358 </p><!--l. 3350--><p class="indent" > Finally, the TeX Live release on the TeX Collection DVD can no longer be run live (oddly
6359 enough). A single DVD no longer has enough room. One beneficial side effect is that
6360 installation from the physical DVD is much faster.
6361
6362 </p>
6363 <h5 class="subsubsectionHead"><span class="titlemark">9.1.8 </span> <a
6364 id="x1-790009.1.8"></a>2011</h5>
6365 <!--l. 3357--><p class="noindent" >The macOS binaries (<span
6366 class="ec-lmtt-12">universal-darwin </span>and <span
6367 class="ec-lmtt-12">x86_64-darwin</span>) now work only on Leopard or
6368 later; Panther and Tiger are no longer supported.
6369 </p><!--l. 3361--><p class="indent" > The <span
6370 class="ec-lmtt-12">biber </span>program for bibliography processing is included on common platforms. Its
6371 development is closely coupled with the <span
6372 class="ec-lmtt-12">biblatex </span>package, which completely reimplements the
6373 bibliographical facilities provided by LaTeX.
6374 </p><!--l. 3366--><p class="indent" > The MetaPost (<span
6375 class="ec-lmtt-12">mpost</span>) program no longer creates or uses <span
6376 class="ec-lmtt-12">.mem </span>files. The needed files, such
6377 as <span
6378 class="ec-lmtt-12">plain.mp</span>, are simply read on every run. This is related to supporting MetaPost as a library,
6379 which is another significant though not user-visible change.
6380 </p><!--l. 3371--><p class="indent" > The <span
6381 class="ec-lmtt-12">updmap </span>implementation in Perl, previously used only on Windows, has been revamped
6382 and is now used on all platforms. There shouldn’t be any user-visible changes as a result,
6383 except that it runs much faster.
6384 </p><!--l. 3376--><p class="indent" > The <span
6385 class="ec-lmss-12">initex </span>and <span
6386 class="ec-lmss-12">inimf </span>programs were restored (but no other <span
6387 class="ec-lmss-12">ini* </span>variants).
6388
6389
6390
6391 </p>
6392 <h5 class="subsubsectionHead"><span class="titlemark">9.1.9 </span> <a
6393 id="x1-800009.1.9"></a>2012</h5>
6394 <!--l. 3381--><p class="noindent" ><span
6395 class="ec-lmtt-12">tlmgr </span>supports updates from multiple network repositories. The section on multiple
6396 repositories in the <span
6397 class="ec-lmtt-12">tlmgr help </span>output has more.
6398 </p><!--l. 3385--><p class="indent" > The parameter <span
6399 class="ec-lmtt-12">\XeTeXdashbreakstate </span>is set to 1 by default, for both <span
6400 class="ec-lmtt-12">xetex </span>and
6401 <span
6402 class="ec-lmtt-12">xelatex</span>. This allows line breaks after em-dashes and en-dashes, which has always been the
6403 behavior of plain TeX, LaTeX, LuaTeX, etc. Existing XeTeX documents which must
6404 retain perfect line-break compatibility will need to set <span
6405 class="ec-lmtt-12">\XeTeXdashbreakstate </span>to 0
6406 explicitly.
6407 </p><!--l. 3392--><p class="indent" > The output files generated by <span
6408 class="ec-lmtt-12">pdftex </span>and <span
6409 class="ec-lmtt-12">dvips</span>, among others, can now exceed 2
6410 gigabytes.
6411 </p><!--l. 3395--><p class="indent" > The 35 standard PostScript fonts are included in the output of <span
6412 class="ec-lmtt-12">dvips </span>by default, since so
6413 many different versions of them are extant.
6414 </p><!--l. 3399--><p class="indent" > In the restricted <span
6415 class="ec-lmtt-12">\write18 </span>execution mode, set by default, <span
6416 class="ec-lmtt-12">mpost </span>is now an allowed
6417 program.
6418 </p><!--l. 3402--><p class="indent" > A <span
6419 class="ec-lmtt-12">texmf.cnf </span>file is also found in <span
6420 class="ec-lmtt-12">../texmf-local</span>, e.g.,
6421 <span
6422 class="ec-lmtt-12">/usr/local/texlive/texmf-local/web2c/texmf.cnf</span>, if it exists.
6423 </p><!--l. 3406--><p class="indent" > The <span
6424 class="ec-lmtt-12">updmap </span>script reads a per-tree <span
6425 class="ec-lmtt-12">updmap.cfg </span>instead of one global config. This change
6426 should be invisible, unless you edited your updmap.cfg’s directly. The <span class="obeylines-h"><code class="verb">updmap --help</code></span> output
6427 has more.
6428 </p><!--l. 3410--><p class="indent" > Platforms: <span
6429 class="ec-lmss-12">armel-linux </span>and <span
6430 class="ec-lmss-12">mipsel-linux </span>added; <span
6431 class="ec-lmss-12">sparc-linux </span>and <span
6432 class="ec-lmss-12">i386-netbsd </span>are no longer in
6433 the main distribution.
6434
6435 </p>
6436 <h5 class="subsubsectionHead"><span class="titlemark">9.1.10 </span> <a
6437 id="x1-810009.1.10"></a>2013</h5>
6438 <!--l. 3416--><p class="noindent" >Distribution layout: the top-level <span
6439 class="ec-lmtt-12">texmf/ </span>directory has been merged into <span
6440 class="ec-lmtt-12">texmf-dist/</span>, for
6441 simplicity. Both the <span
6442 class="ec-lmtt-12">TEXMFMAIN </span>and <span
6443 class="ec-lmtt-12">TEXMFDIST </span>Kpathsea variables now point to
6444 <span
6445 class="ec-lmtt-12">texmf-dist</span>.
6446 </p><!--l. 3421--><p class="indent" > Many small language collections have been merged together, to simplify installation.
6447 </p><!--l. 3424--><p class="indent" > MetaPost: native support for PNG output and floating-point (IEEE double) has been
6448 added.
6449 </p><!--l. 3427--><p class="indent" > LuaTeX: updated to Lua 5.2, and includes a new library (<span
6450 class="ec-lmtt-12">pdfscanner</span>) to process external
6451 PDF page content, among much else (see its web pages).
6452 </p><!--l. 3431--><p class="indent" > XeTeX (also see its web pages for more): </p>
6453 <ul class="itemize1">
6454 <li class="itemize">
6455 <!--l. 3433--><p class="noindent" >The HarfBuzz library is now used for font layout instead of ICU. (ICU is still
6456 used to support input encodings, bidirectionality, and the optional Unicode line
6457 breaking.)
6458 </p></li>
6459 <li class="itemize">
6460
6461
6462 <!--l. 3436--><p class="noindent" >Graphite2 and HarfBuzz are used instead of SilGraphite for Graphite layout.
6463 </p></li>
6464 <li class="itemize">
6465 <!--l. 3438--><p class="noindent" >On Macs, Core Text is used instead of the (deprecated) ATSUI.
6466 </p></li>
6467 <li class="itemize">
6468 <!--l. 3439--><p class="noindent" >Prefer TrueType/OpenType fonts to Type1 when the names are the same.
6469 </p></li>
6470 <li class="itemize">
6471 <!--l. 3440--><p class="noindent" >Fix occasional mismatch in font finding between XeTeX and <span
6472 class="ec-lmtt-12">xdvipdfmx</span>.
6473 </p></li>
6474 <li class="itemize">
6475 <!--l. 3442--><p class="noindent" >Support OpenType math cut-ins.</p></li></ul>
6476 <!--l. 3445--><p class="indent" > <span
6477 class="ec-lmss-12">xdvi</span>: now uses FreeType instead of <span
6478 class="ec-lmtt-12">t1lib </span>for rendering.
6479 </p><!--l. 3447--><p class="indent" > <span
6480 class="ec-lmss-12">microtype.sty</span>: some support for XeTeX (protrusion) and LuaTeX (protrusion, font
6481 expansion, tracking), among other enhancements.
6482 </p><!--l. 3451--><p class="indent" > <span
6483 class="ec-lmss-12">tlmgr</span>: new <span
6484 class="ec-lmtt-12">pinning </span>action to ease configuring multiple repositories; that section in <span class="obeylines-h"><code class="verb">tlmgr --help</code></span>
6485 has more, online at <a
6486 href="https://tug.org/texlive/doc/tlmgr.html#MULTIPLE-REPOSITORIES" class="url" ><span
6487 class="ec-lmtt-12">https://tug.org/texlive/doc/tlmgr.html#MULTIPLE-REPOSITORIES</span></a>.
6488 </p><!--l. 3455--><p class="indent" > Platforms: <span
6489 class="ec-lmss-12">armhf-linux</span>, <span
6490 class="ec-lmss-12">mips-irix</span>, <span
6491 class="ec-lmss-12">i386-netbsd</span>, and <span
6492 class="ec-lmss-12">amd64-netbsd </span>added or revived;
6493 <span
6494 class="ec-lmss-12">powerpc-aix </span>removed.
6495
6496 </p>
6497 <h5 class="subsubsectionHead"><span class="titlemark">9.1.11 </span> <a
6498 id="x1-820009.1.11"></a>2014</h5>
6499 <!--l. 3461--><p class="noindent" >2014 saw another TeX tune-up from Knuth; this affected all engines, but the only visible
6500 change likely is the restoration of the <span
6501 class="ec-lmtt-12">preloaded format </span>string on the banner line. Per Knuth,
6502 this now reflects the format that <span
6503 class="ec-lmri-12">would </span>be loaded by default, rather than an undumped
6504 format that is actually preloaded in the binary; it may be overridden in various
6505 ways.
6506 </p><!--l. 3468--><p class="indent" > pdfTeX: new warning-suppression parameter <span
6507 class="ec-lmtt-12">\pdfsuppresswarningpagegroup</span>; new
6508 primitives for fake interword spaces to help with PDF text reflowing: <span
6509 class="ec-lmtt-12">\pdfinterwordspaceon</span>,
6510 <span
6511 class="ec-lmtt-12">\pdfinterwordspaceoff</span>, <span
6512 class="ec-lmtt-12">\pdffakespace</span>.
6513 </p><!--l. 3473--><p class="indent" > LuaTeX: Notable changes and fixes were made to font loading and hyphenation. The
6514 biggest addition is a new engine variant, <span
6515 class="ec-lmtt-12">luajittex </span>and its siblings <span
6516 class="ec-lmtt-12">texluajit </span>and
6517 <span
6518 class="ec-lmtt-12">texluajitc</span>. This uses a just-in-time Lua compiler (detailed <span
6519 class="ec-lmro-12">TUGboat </span>article at
6520 <a
6521 href="https://tug.org/TUGboat/tb34-1/tb106scarso.pdf" class="url" ><span
6522 class="ec-lmtt-12">https://tug.org/TUGboat/tb34-1/tb106scarso.pdf</span></a>). <span
6523 class="ec-lmtt-12">luajittex </span>is still in development, is
6524 not available on all platforms, and is considerably less stable than <span
6525 class="ec-lmtt-12">luatex</span>. Neither we nor its
6526 developers recommend using it except for the specific purpose of experimenting with jit on Lua
6527 code.
6528 </p><!--l. 3484--><p class="indent" > XeTeX: The same image formats are now supported on all platforms (including Mac);
6529 avoid Unicode compatibility decomposition fallback (but not other variants); prefer OpenType
6530 to Graphite fonts, for compatibility with previous XeTeX versions.
6531 </p><!--l. 3489--><p class="indent" > MetaPost: A new numbersystem <span
6532 class="ec-lmtt-12">decimal </span>is supported, along with a companion internal
6533 <span
6534 class="ec-lmtt-12">numberprecision</span>; a new definition of <span
6535 class="ec-lmtt-12">drawdot </span>in <span
6536 class="ec-lmtt-12">plain.mp</span>, per Knuth; bug fixes in SVG and
6537 PNG output, among others.
6538
6539
6540 </p><!--l. 3494--><p class="indent" > The <span
6541 class="ec-lmss-12">pstopdf </span>ConTeXt utility will be removed as a standalone command at some point after
6542 the release, due to conflicts with OS utilities of the same name. It can still (and now) be
6543 invoked as <span
6544 class="ec-lmtt-12">mtxrun –script pstopdf</span>.
6545 </p><!--l. 3499--><p class="indent" > <span
6546 class="ec-lmss-12">psutils </span>has been substantially revised by a new maintainer. As a result, several seldom-used
6547 utilities (<span
6548 class="ec-lmtt-12">fix*</span>, <span
6549 class="ec-lmtt-12">getafm</span>, <span
6550 class="ec-lmtt-12">psmerge</span>, <span
6551 class="ec-lmtt-12">showchar</span>) are now only in the <span
6552 class="ec-lmtt-12">scripts/ </span>directory rather
6553 than being user-level executables (this can be reversed if it turns out to be problematic). A
6554 new script, <span
6555 class="ec-lmtt-12">psjoin</span>, has been added.
6556 </p><!--l. 3506--><p class="indent" > The MacTeX redistribution of TeX Live (section <a
6557 href="#x1-160003.1.2">3.1.2<!--tex4ht:ref: sec:macosx --></a>) no longer includes the optional
6558 Mac-only packages for the Latin Modern and TeX Gyre fonts, since it is easy enough for
6559 individual users to make them available to the system. The <span
6560 class="ec-lmss-12">convert </span>program from
6561 ImageMagick has also been excised, since TeX4ht (specifically <span
6562 class="ec-lmtt-12">tex4ht.env</span>) now uses
6563 Ghostscript directly.
6564 </p><!--l. 3513--><p class="indent" > The <span
6565 class="ec-lmss-12">langcjk </span>collection for Chinese, Japanese, and Korean support has been split into
6566 individual language collections for the sake of more moderate sizes.
6567 </p><!--l. 3517--><p class="indent" > Platforms: <span
6568 class="ec-lmss-12">x86_64-cygwin </span>added, <span
6569 class="ec-lmss-12">mips-irix </span>removed; Microsoft no longer supports Windows
6570 XP, so our programs may start failing there at any time.
6571
6572 </p>
6573 <h5 class="subsubsectionHead"><span class="titlemark">9.1.12 </span> <a
6574 id="x1-830009.1.12"></a>2015</h5>
6575 <!--l. 3523--><p class="noindent" >LaTeX2e now incorporates, by default, changes previously included only by explicitly loading
6576 the <span
6577 class="ec-lmss-12">fixltx2e </span>package, which is now a no-op. A new <span
6578 class="ec-lmss-12">latexrelease </span>package and other mechanisms
6579 allow for controlling what is done. The included LaTeX News #22 and “LaTeX changes”
6580 documents have details. Incidentally, the <span
6581 class="ec-lmss-12">babel </span>and <span
6582 class="ec-lmss-12">psnfss </span>packages, while core parts of LaTeX,
6583 are maintained separately and are not affected by these changes (and should still
6584 work).
6585 </p><!--l. 3532--><p class="indent" > Internally, LaTeX2e now includes Unicode-related engine configuration (what characters
6586 are letters, naming of primitives, etc.) which was previously part of TeX Live. This change is
6587 intended to be invisible to users; a few low-level internal control sequences have been renamed
6588 or removed, but the behavior should be just the same.
6589 </p><!--l. 3538--><p class="indent" > pdfTeX: Support JPEG Exif as well as JFIF; do not emit a warning if
6590 <span
6591 class="ec-lmtt-12">\pdfinclusionerrorlevel </span>is negative; sync with <span
6592 class="ec-lmss-12">xpdf</span> 3.04.
6593 </p><!--l. 3542--><p class="indent" > LuaTeX: New library <span
6594 class="ec-lmss-12">newtokenlib </span>for scanning tokens; bug fixes in the <span
6595 class="ec-lmtt-12">normal </span>random
6596 number generator and other places.
6597 </p><!--l. 3545--><p class="indent" > XeTeX: Image handling fixes; <span
6598 class="ec-lmss-12">xdvipdfmx </span>binary looked for first as a sibling to <span
6599 class="ec-lmss-12">xetex</span>;
6600 internal <span
6601 class="ec-lmtt-12">XDV </span>opcodes changed.
6602 </p><!--l. 3548--><p class="indent" > MetaPost: New numbersystem <span
6603 class="ec-lmtt-12">binary</span>; new Japanese-enabled <span
6604 class="ec-lmss-12">upmpost </span>and <span
6605 class="ec-lmss-12">updvitomp</span>
6606 programs, analogous to <span
6607 class="ec-lmss-12">up*tex</span>.
6608 </p><!--l. 3552--><p class="indent" > MacTeX: Updates to the included Ghostscript package for CJK support. The
6609 TeX Distribution Preference Pane now works in Yosemite (macOS 10.10). Resource-fork font
6610 suitcases (generally without an extension) are no longer supported by XeTeX; data-fork
6611 suitcases (<span
6612 class="ec-lmtt-12">.dfont</span>) remain supported.
6613 </p><!--l. 3558--><p class="indent" > Infrastructure: The <span
6614 class="ec-lmss-12">fmtutil </span>script has been reimplemented to read <span
6615 class="ec-lmtt-12">fmtutil.cnf </span>on a
6616 per-tree basis, analogous to <span
6617 class="ec-lmss-12">updmap</span>. Web2C <span
6618 class="ec-lmss-12">mktex* </span>scripts (including <span
6619 class="ec-lmss-12">mktexlsr</span>, <span
6620 class="ec-lmss-12">mktextfm</span>,
6621 <span
6622 class="ec-lmss-12">mktexpk</span>) now prefer programs in their own directory, instead of always using the existing
6623
6624
6625 <span
6626 class="ec-lmtt-12">PATH</span>.
6627 </p><!--l. 3564--><p class="indent" > Platforms: <span
6628 class="ec-lmss-12">*-kfreebsd </span>removed, since TeX Live is now easily available through the system
6629 platform mechanisms. Support for some additional platforms is available as custom binaries (
6630 <a
6631 href="https://tug.org/texlive/custom-bin.html" class="url" ><span
6632 class="ec-lmtt-12">https://tug.org/texlive/custom-bin.html</span></a>). In addition, some platforms are now
6633 omitted from the DVD (simply to save space), but can be installed normally over the
6634 net.
6635
6636 </p>
6637 <h5 class="subsubsectionHead"><span class="titlemark">9.1.13 </span> <a
6638 id="x1-840009.1.13"></a>2016</h5>
6639 <!--l. 3574--><p class="noindent" >LuaTeX: Sweeping changes to primitives, both renames and removals, along
6640 with some node structure rearrangements. The changes are summarized in an
6641 article by Hans Hagen, “LuaTeX 0.90 backend changes for PDF and more” (
6642 <a
6643 href="https://tug.org/TUGboat/tb37-1/tb115hagen-pdf.pdf" class="url" ><span
6644 class="ec-lmtt-12">https://tug.org/TUGboat/tb37-1/tb115hagen-pdf.pdf</span></a>); for all the details, see the
6645 LuaTeX manual, <a
6646 href="../../../../texmf-dist/doc/luatex/base/luatex.pdf" >texmf-dist/doc/luatex/base/luatex.pdf</a>.
6647 </p><!--l. 3582--><p class="indent" > Metafont: New highly experimental sibling programs MFlua and MFluajit, integrating Lua
6648 with Metafont, for trial testing purposes.
6649 </p><!--l. 3585--><p class="indent" > MetaPost: Bug fixes and internal preparations for MetaPost 2.0.
6650 </p><!--l. 3587--><p class="indent" > <span
6651 class="ec-lmtt-12">SOURCE_DATE_EPOCH </span>support in all engines except LuaTeX (which will come in the
6652 next release) and original <span
6653 class="ec-lmtt-12">tex </span>(intentionally omitted): if the environment variable
6654 <span
6655 class="ec-lmtt-12">SOURCE_DATE_EPOCH </span>is set, its value is used for timestamps in the PDF output. If
6656 <span
6657 class="ec-lmtt-12">SOURCE_DATE_EPOCH_TEX_PRIMITIVES </span>is also set, the <span
6658 class="ec-lmtt-12">SOURCE_DATE_EPOCH </span>value is used to
6659 initialize the TeX primitives <span
6660 class="ec-lmtt-12">\year</span>, <span
6661 class="ec-lmtt-12">\month</span>, <span
6662 class="ec-lmtt-12">\day</span>, <span
6663 class="ec-lmtt-12">\time</span>. The pdfTeX manual has examples
6664 and details.
6665 </p><!--l. 3596--><p class="indent" > pdfTeX: Three new primitives <span
6666 class="ec-lmtt-12">\pdfinfoomitdate</span>, <span
6667 class="ec-lmtt-12">\pdfsuppressptexinfo</span>, and
6668 <span
6669 class="ec-lmtt-12">\pdftrailerid</span>, to control values appearing in the output which normally change with each
6670 run. These features are for PDF output only, not DVI.
6671 </p><!--l. 3601--><p class="indent" > XeTeX: New primitives <span
6672 class="ec-lmtt-12">\XeTeXhyphenatablelength</span>, <span
6673 class="ec-lmtt-12">\XeTeXgenerateactualtext</span>,<br
6674 class="newline" /><span
6675 class="ec-lmtt-12">\XeTeXinterwordspaceshaping</span>, <span
6676 class="ec-lmtt-12">\mdfivesum</span>; character class limit increased to 4096; DVI id
6677 byte incremented.
6678 </p><!--l. 3606--><p class="indent" > Other utilities: </p>
6679 <ul class="itemize1">
6680 <li class="itemize">
6681 <!--l. 3608--><p class="noindent" ><span
6682 class="ec-lmtt-12">gregorio </span>is a new program, part of the <span
6683 class="ec-lmtt-12">gregoriotex </span>package for typesetting
6684 Gregorian chant scores; it is included in <span
6685 class="ec-lmtt-12">shell_escape_commands </span>by default.
6686 </p></li>
6687 <li class="itemize">
6688 <!--l. 3612--><p class="noindent" ><span
6689 class="ec-lmtt-12">upmendex </span>is an index creation program, mostly compatible with <span
6690 class="ec-lmtt-12">makeindex</span>, with
6691 support for Unicode sorting, among other changes.
6692 </p></li>
6693 <li class="itemize">
6694 <!--l. 3616--><p class="noindent" ><span
6695 class="ec-lmtt-12">afm2tfm </span>now makes only accent-based height adjustments upward; a new option
6696 <span
6697 class="ec-lmtt-12">-a </span>omits all adjustments.
6698 </p></li>
6699 <li class="itemize">
6700
6701
6702 <!--l. 3619--><p class="noindent" ><span
6703 class="ec-lmtt-12">ps2pk </span>can handle extended PK/GF fonts.</p></li></ul>
6704 <!--l. 3622--><p class="indent" > MacTeX: The TeX Distribution Preference Pane is gone; its functionality is now in TeX
6705 Live Utility; bundled GUI applications upgraded; new script <span
6706 class="ec-lmtt-12">cjk-gs-integrate </span>to be run by
6707 users who wish to incorporate various CJK fonts into Ghostscript.
6708 </p><!--l. 3627--><p class="indent" > Infrastructure: System-level <span
6709 class="ec-lmtt-12">tlmgr </span>configuration file supported; verify package
6710 checksums; if GPG is available, verify signature of network updates. These checks
6711 happen with both the installer and <span
6712 class="ec-lmtt-12">tlmgr</span>. If GPG is not available, updates proceed as
6713 usual.
6714 </p><!--l. 3632--><p class="indent" > Platforms: <span
6715 class="ec-lmtt-12">alpha-linux </span>and <span
6716 class="ec-lmtt-12">mipsel-linux </span>removed.
6717
6718 </p>
6719 <h5 class="subsubsectionHead"><span class="titlemark">9.1.14 </span> <a
6720 id="x1-850009.1.14"></a>2017</h5>
6721 <!--l. 3637--><p class="noindent" >LuaTeX: More callbacks, more typesetting control, more access to internals; <span
6722 class="ec-lmtt-12">ffi </span>library for
6723 dynamic code loading added on some platforms.
6724 </p><!--l. 3641--><p class="indent" > pdfTeX: Environment variable <span class="obeylines-h"><code class="verb">SOURCE_DATE_EPOCH_TEX_PRIMITIVES</code></span> from last year
6725 renamed to <span class="obeylines-h"><code class="verb">FORCE_SOURCE_DATE</code></span>, with no changes in functionality; if the <span
6726 class="ec-lmtt-12">\pdfpageattr </span>token
6727 list contains the string <span
6728 class="ec-lmtt-12">/MediaBox</span>, omit output of the default <span
6729 class="ec-lmtt-12">/MediaBox</span>.
6730 </p><!--l. 3646--><p class="indent" > XeTeX: Unicode/OpenType math now based on HarfBuzz’s MATH table support; some
6731 bug fixes.
6732 </p><!--l. 3649--><p class="indent" > Dvips: Make the last papersize special win, for consistency with <span
6733 class="ec-lmtt-12">dvipdfmx </span>and package
6734 expectations; the <span
6735 class="ec-lmtt-12">-L0 </span>option (<span
6736 class="ec-lmtt-12">L0 </span>config setting) restores the previous behavior of the first
6737 special winning.
6738 </p><!--l. 3654--><p class="indent" > epTeX, eupTeX: New primitives <span
6739 class="ec-lmtt-12">\pdfuniformdeviate</span>, <span
6740 class="ec-lmtt-12">\pdfnormaldeviate</span>,
6741 <span
6742 class="ec-lmtt-12">\pdfrandomseed</span>, <span
6743 class="ec-lmtt-12">\pdfsetrandomseed</span>, <span
6744 class="ec-lmtt-12">\pdfelapsedtime</span>, <span
6745 class="ec-lmtt-12">\pdfresettimer</span>, from
6746 pdfTeX.
6747 </p><!--l. 3658--><p class="indent" > MacTeX: As of this year, only macOS releases for which Apple still releases security
6748 patches will be supported in MacTeX, under the platform name <span class="obeylines-h"><code class="verb">x86_64-darwin</code></span>; currently this
6749 means Yosemite, El Capitan, and Sierra (10.10 and newer). Binaries for older macOS versions
6750 are not included in MacTeX, but are still available in TeX Live (<span class="obeylines-h"><code class="verb">x86_64-darwinlegacy</code></span>,
6751 <span
6752 class="ec-lmtt-12">i386-darwin</span>, <span
6753 class="ec-lmtt-12">powerpc-darwin</span>).
6754 </p><!--l. 3665--><p class="indent" > Infrastructure: The <span
6755 class="ec-lmtt-12">TEXMFLOCAL </span>tree is now searched before <span
6756 class="ec-lmtt-12">TEXMFSYSCONFIG </span>and
6757 <span
6758 class="ec-lmtt-12">TEXMFSYSVAR </span>(by default); the hope is that this will better match expectations of
6759 local files overriding system files. Also, <span
6760 class="ec-lmtt-12">tlmgr </span>has a new mode <span
6761 class="ec-lmtt-12">shell </span>for interactive
6762 and scripted use, and a new action <span
6763 class="ec-lmtt-12">conf auxtrees </span>to easily add and remove extra
6764 trees.
6765 </p><!--l. 3672--><p class="indent" > <span
6766 class="ec-lmtt-12">updmap </span>and <span
6767 class="ec-lmtt-12">fmtutil</span>: These scripts now give a warning when invoked without explicitly
6768 specifying either so-called system mode (<span
6769 class="ec-lmtt-12">updmap-sys</span>, <span
6770 class="ec-lmtt-12">fmtutil-sys</span>, or option <span
6771 class="ec-lmtt-12">-sys</span>), or user
6772 mode (<span
6773 class="ec-lmtt-12">updmap-user</span>, <span
6774 class="ec-lmtt-12">fmtutil-user</span>, or option <span
6775 class="ec-lmtt-12">-user</span>). The hope is that this will reduce
6776 the perennial problem of invoking user mode by accident and thus losing future
6777 system updates. See <a
6778 href="https://tug.org/texlive/scripts-sys-user.html" class="url" ><span
6779 class="ec-lmtt-12">https://tug.org/texlive/scripts-sys-user.html</span></a> for
6780 details.
6781 </p><!--l. 3680--><p class="indent" > <span
6782 class="ec-lmtt-12">install-tl</span>: Personal paths such as <span
6783 class="ec-lmtt-12">TEXMFHOME </span>are now set to MacTeX values
6784 (<span class="obeylines-h"><code class="verb">~/Library/...</code></span>) by default on Macs. New option <span
6785 class="ec-lmtt-12">-init-from-profile </span>to start an
6786 installation with the values from a given profile; new command <span
6787 class="ec-lmtt-12">P </span>to explicitly save a profile;
6788
6789
6790 new profile variable names (but previous ones are still accepted).
6791 </p><!--l. 3687--><p class="indent" > SyncTeX: the name of the temporary file now looks like <span
6792 class="ec-lmtt-12">foo.synctex(busy)</span>, instead of
6793 <span
6794 class="ec-lmtt-12">foo.synctex.gz(busy) </span>(no <span
6795 class="ec-lmtt-12">.gz</span>). Front-ends and build systems that want to remove temp
6796 files may need adjusting.
6797 </p><!--l. 3692--><p class="indent" > Other utilities: <span
6798 class="ec-lmtt-12">texosquery-jre8 </span>is a new cross-platform program for retrieving locale and
6799 other OS information from a TeX document; it is included in <span class="obeylines-h"><code class="verb">shell_escape_commands</code></span> by
6800 default for restricted shell execution. (Older JRE versions are supported by texosquery, but
6801 cannot be enabled in restricted mode, as they are no longer supported by Oracle, even for
6802 security issues.)
6803 </p><!--l. 3699--><p class="indent" > Platforms: See MacTeX entry above; no other changes.
6804
6805 </p>
6806 <h5 class="subsubsectionHead"><span class="titlemark">9.1.15 </span> <a
6807 id="x1-860009.1.15"></a>2018</h5>
6808 <!--l. 3704--><p class="noindent" >Kpathsea: Case-insensitive filename matching now done by default in non-system directories;
6809 set <span
6810 class="ec-lmtt-12">texmf.cnf </span>or environment variable <span
6811 class="ec-lmtt-12">texmf_casefold_search </span>to <span
6812 class="ec-lmtt-12">0 </span>to disable. Full details
6813 in the Kpathsea manual (<a
6814 href="https://tug.org/kpathsea" class="url" ><span
6815 class="ec-lmtt-12">https://tug.org/kpathsea</span></a>).
6816 </p><!--l. 3709--><p class="indent" > epTeX, eupTeX: New primitive <span
6817 class="ec-lmtt-12">\epTeXversion</span>.
6818 </p><!--l. 3711--><p class="indent" > LuaTeX: Preparation for moving to Lua 5.3 in 2019: a binary <span
6819 class="ec-lmtt-12">luatex53 </span>is available on
6820 most platforms, but must be renamed to <span
6821 class="ec-lmtt-12">luatex </span>to be effective. Or use the ConTeXt Garden (
6822 <a
6823 href="https://wiki.contextgarden.net" class="url" ><span
6824 class="ec-lmtt-12">https://wiki.contextgarden.net</span></a>) files; more information there.
6825 </p><!--l. 3716--><p class="indent" > MetaPost: Fixes for wrong path directions, TFM and PNG output.
6826 </p><!--l. 3718--><p class="indent" > pdfTeX: Allow encoding vectors for bitmap fonts; current directory not hashed into PDF
6827 ID; bug fixes for <span
6828 class="ec-lmtt-12">\pdfprimitive </span>and related.
6829 </p><!--l. 3721--><p class="indent" > XeTeX: Support <span
6830 class="ec-lmtt-12">/Rotate </span>in PDF image inclusion; exit nonzero if the output driver fails;
6831 various obscure UTF-8 and other primitive fixes.
6832 </p><!--l. 3725--><p class="indent" > MacTeX: See version support changes below. In addition, the files installed in
6833 <span
6834 class="ec-lmtt-12">/Applications/TeX/ </span>by MacTeX have been reorganized for greater clarity; now this location
6835 contains four GUI programs (BibDesk, LaTeXiT, TeX Live Utility, and TeXShop) at the top
6836 level and folders with additional utilities and documentation.
6837 </p><!--l. 3731--><p class="indent" > <span
6838 class="ec-lmtt-12">tlmgr</span>: new front-ends <span
6839 class="ec-lmtt-12">tlshell </span>(Tcl/Tk) and <span
6840 class="ec-lmtt-12">tlcockpit </span>(Java); JSON output; <span
6841 class="ec-lmtt-12">uninstall</span>
6842 now a synonym for <span
6843 class="ec-lmtt-12">remove</span>; new action/option <span
6844 class="ec-lmtt-12">print-platform-info</span>.
6845 </p><!--l. 3735--><p class="indent" > Platforms: </p>
6846 <ul class="itemize1">
6847 <li class="itemize">
6848 <!--l. 3738--><p class="noindent" >Removed: <span
6849 class="ec-lmtt-12">armel-linux</span>, <span
6850 class="ec-lmtt-12">powerpc-linux</span>.
6851 </p></li>
6852 <li class="itemize">
6853 <!--l. 3740--><p class="noindent" ><span
6854 class="ec-lmtt-12">x86_64-darwin </span>supports 10.10–10.13 (Yosemite, El Capitan, Sierra, and
6855 High Sierra).
6856 </p></li>
6857 <li class="itemize">
6858 <!--l. 3743--><p class="noindent" ><span
6859 class="ec-lmtt-12">x86_64-darwinlegacy </span>supports 10.6–10.10 (though <span
6860 class="ec-lmtt-12">x86_64-darwin </span>is preferred
6861 for 10.10). All support for 10.5 (Leopard) is gone, that is, both the <span
6862 class="ec-lmtt-12">powerpc-darwin</span>
6863 and <span
6864 class="ec-lmtt-12">i386-darwin platforms </span>have been removed.
6865
6866
6867 </p></li>
6868 <li class="itemize">
6869 <!--l. 3748--><p class="noindent" >Windows: XP is no longer supported.</p></li></ul>
6870
6871 <h5 class="subsubsectionHead"><span class="titlemark">9.1.16 </span> <a
6872 id="x1-870009.1.16"></a>2019</h5>
6873 <!--l. 3754--><p class="noindent" >Kpathsea: More consistent brace expansion and path splitting; new variable <span
6874 class="ec-lmtt-12">TEXMFDOTDIR</span>
6875 instead of hard-coded <span
6876 class="ec-lmtt-12">.</span> in paths allows for easily searching additional or sub-directories (see
6877 comments in <span
6878 class="ec-lmtt-12">texmf.cnf</span>).
6879 </p><!--l. 3759--><p class="indent" > epTeX, eupTeX: New primitives <span
6880 class="ec-lmtt-12">\readpapersizespecial </span>and <span
6881 class="ec-lmtt-12">\expanded</span>.
6882 </p><!--l. 3762--><p class="indent" > LuaTeX: Lua 5.3 now used, with concomitant arithmetic and interface changes. The
6883 homegrown library pplib is used to read pdf files, thus eliminating the dependency on poppler
6884 (and the need for C++); Lua interface changed accordingly.
6885 </p><!--l. 3767--><p class="indent" > MetaPost: <span
6886 class="ec-lmtt-12">r-mpost </span>command name recognized as an alias for invocation with the
6887 <span
6888 class="ec-lmtt-12">--restricted </span>option, and added to the list of restricted commands available by default.
6889 Minimum precision now 2 for decimal and binary mode. Binary mode no longer available in
6890 MPlib but still available in standalone MetaPost.
6891 </p><!--l. 3774--><p class="indent" > pdfTeX: New primitive <span
6892 class="ec-lmtt-12">\expanded</span>; if new primitive parameter <span
6893 class="ec-lmtt-12">\pdfomitcharset </span>is set to
6894 1, the <span
6895 class="ec-lmtt-12">/CharSet </span>string omitted from the PDF output, since it cannot feasibly be guaranteed
6896 correct, as required by PDF/A-2 and PDF/A-3.
6897 </p><!--l. 3779--><p class="indent" > XeTeX: New primitives for cross-engine support: <span
6898 class="ec-lmtt-12">\expanded</span>, <span
6899 class="ec-lmtt-12">\creationdate</span>,
6900 <span
6901 class="ec-lmtt-12">\elapsedtime</span>, <span
6902 class="ec-lmtt-12">\filedump</span>, <span
6903 class="ec-lmtt-12">\filemoddate</span>, <span
6904 class="ec-lmtt-12">\filesize</span>, <span
6905 class="ec-lmtt-12">\resettimer</span>, <span
6906 class="ec-lmtt-12">\normaldeviate</span>,
6907 <span
6908 class="ec-lmtt-12">\uniformdeviate</span>, <span
6909 class="ec-lmtt-12">\randomseed</span>; extend <span
6910 class="ec-lmtt-12">\Ucharcat </span>to produce active characters.
6911 </p><!--l. 3791--><p class="indent" > <span
6912 class="ec-lmtt-12">tlmgr</span>: Support <span
6913 class="ec-lmtt-12">curl </span>as a download program; use <span
6914 class="ec-lmtt-12">lz4 </span>and gzip before <span
6915 class="ec-lmtt-12">xz </span>for local backups,
6916 if available; prefer system-provided binaries over binaries provided with TeX Live for
6917 compressor and download programs, unless the environment variable <span
6918 class="ec-lmtt-12">TEXLIVE_PREFER_OWN </span>is
6919 set.
6920 </p><!--l. 3797--><p class="indent" > <span
6921 class="ec-lmtt-12">install-tl</span>: New option <span
6922 class="ec-lmtt-12">-gui </span>(with no argument) is the default on Windows and Macs,
6923 and invokes a new Tcl/TK GUI (see sections <a
6924 href="#x1-50001.3">1.3<!--tex4ht:ref: sec:basic --></a> and <a
6925 href="#x1-200003.1.6">3.1.6<!--tex4ht:ref: sec:graphical-inst --></a>).
6926 </p><!--l. 3801--><p class="indent" > Utilities: </p>
6927 <ul class="itemize1">
6928 <li class="itemize">
6929 <!--l. 3803--><p class="noindent" ><span
6930 class="ec-lmtt-12">cwebbin </span>(<a
6931 href="https://ctan.org/pkg/cwebbin" class="url" ><span
6932 class="ec-lmtt-12">https://ctan.org/pkg/cwebbin</span></a>) is now the CWEB implementation
6933 in TeX Live, with support for more language dialects, and including the <span
6934 class="ec-lmtt-12">ctwill</span>
6935 program to make mini-indexes.
6936 </p></li>
6937 <li class="itemize">
6938 <!--l. 3807--><p class="noindent" ><span
6939 class="ec-lmtt-12">chkdvifont</span>: report font information from DVI files, also from tfm/ofm, vf, gf, pk.
6940 </p></li>
6941 <li class="itemize">
6942 <!--l. 3810--><p class="noindent" ><span
6943 class="ec-lmtt-12">dvispc</span>: make a DVI file page-independent with respect to specials.</p></li></ul>
6944 <!--l. 3813--><p class="indent" > MacTeX: <span
6945 class="ec-lmtt-12">x86_64-darwin </span>now supports 10.12 and higher (Sierra, High Sierra, Mojave);
6946 <span
6947 class="ec-lmtt-12">x86_64-darwinlegacy </span>still supports 10.6 and newer. The spell checker Excalibur is no longer
6948 included, since it requires 32-bit support.
6949 </p><!--l. 3818--><p class="indent" > Platforms: removed <span
6950 class="ec-lmtt-12">sparc-solaris</span>.
6951
6952
6953
6954 </p>
6955 <h5 class="subsubsectionHead"><span class="titlemark">9.1.17 </span> <a
6956 id="x1-880009.1.17"></a>2020</h5>
6957 <!--l. 3823--><p class="noindent" >General: </p>
6958 <ul class="itemize1">
6959 <li class="itemize">
6960 <!--l. 3824--><p class="noindent" >The <span
6961 class="ec-lmtt-12">\input </span>primitive in all TeX engines, including <span
6962 class="ec-lmtt-12">tex</span>, now also accepts a
6963 group-delimited filename argument, as a system-dependent extension. The usage
6964 with a standard space/token-delimited filename is completely unchanged. The
6965 group-delimited argument was previously implemented in LuaTeX; now it is
6966 available in all engines. ASCII double quote characters (<span
6967 class="ec-lmtt-12">&#x0022;</span>) are removed from
6968 the filename, but it is otherwise left unchanged after tokenization. This does not
6969 currently affect LaTeX’s <span
6970 class="ec-lmtt-12">\input </span>command, as that is a macro redefinition of the
6971 standard <span
6972 class="ec-lmtt-12">\input </span>primitive.
6973 </p></li>
6974 <li class="itemize">
6975 <!--l. 3834--><p class="noindent" >New option <span
6976 class="ec-lmtt-12">--cnf-line </span>for <span
6977 class="ec-lmtt-12">kpsewhich</span>, <span
6978 class="ec-lmtt-12">tex</span>, <span
6979 class="ec-lmtt-12">mf</span>, and all other engines, to support
6980 arbitrary configuration settings on the command line.
6981 </p></li>
6982 <li class="itemize">
6983 <!--l. 3838--><p class="noindent" >The addition of various primitives to various engines in this and previous years
6984 is intended to result in a common set of functionality available across all engines
6985 (<span
6986 class="ec-lmro-12">LaTeX</span><span
6987 class="ec-lmro-12"> News #31</span>, <a
6988 href="https://latex-project.org/news" class="url" ><span
6989 class="ec-lmtt-12">https://latex-project.org/news</span></a>).
6990 </p>
6991 </li></ul>
6992 <!--l. 3845--><p class="indent" > epTeX, eupTeX: Several new primitives, mostly for cross-engine support: <span
6993 class="ec-lmtt-12">\Uchar</span>,
6994 <span
6995 class="ec-lmtt-12">\Ucharcat</span>, <span
6996 class="ec-lmtt-12">\current(x)spacingmode</span>, <span
6997 class="ec-lmtt-12">\ifincsname</span>; also, revise <span
6998 class="ec-lmtt-12">\fontchar??</span> and
6999 <span
7000 class="ec-lmtt-12">\iffontchar</span>. For eupTeX only: <span
7001 class="ec-lmtt-12">\currentcjktoken</span>.
7002 </p><!--l. 3850--><p class="indent" > LuaTeX: Integration with HarfBuzz library, available as new engines <span
7003 class="ec-lmtt-12">luahbtex</span>
7004 (used for <span
7005 class="ec-lmtt-12">lualatex</span>) and <span
7006 class="ec-lmtt-12">luajithbtex</span>. New primitives: <span
7007 class="ec-lmtt-12">\eTeXgluestretchorder</span>,
7008 <span
7009 class="ec-lmtt-12">\eTeXglueshrinkorder</span>.
7010 </p><!--l. 3854--><p class="indent" > pdfTeX: New primitive <span
7011 class="ec-lmtt-12">\pdfmajorversion</span>; this merely changes the version number in the
7012 PDF output; it has no effect on any PDF content. <span
7013 class="ec-lmtt-12">\pdfximage </span>and similar now search for
7014 image files in the same way as <span
7015 class="ec-lmtt-12">\openin</span>.
7016 </p><!--l. 3859--><p class="indent" > pTeX: New primitives <span
7017 class="ec-lmtt-12">\ifjfont</span>, <span
7018 class="ec-lmtt-12">\iftfont</span>. Also in epTeX, upTeX, eupTeX.
7019 </p><!--l. 3862--><p class="indent" > XeTeX: Fixes for <span
7020 class="ec-lmtt-12">\Umathchardef</span>, <span
7021 class="ec-lmtt-12">\XeTeXinterchartoks</span>, <span
7022 class="ec-lmtt-12">\pdfsavepos</span>.
7023 </p><!--l. 3864--><p class="indent" > Dvips: Output encodings for bitmap fonts, for better copy/paste capabilities (
7024 <a
7025 href="https://tug.org/TUGboat/tb40-2/tb125rokicki-type3search.pdf" class="url" ><span
7026 class="ec-lmtt-12">https://tug.org/TUGboat/tb40-2/tb125rokicki-type3search.pdf</span></a>).
7027 </p><!--l. 3868--><p class="indent" > MacTeX: MacTeX and <span
7028 class="ec-lmtt-12">x86_64-darwin </span>now require 10.13 or higher (High Sierra, Mojave,
7029 and Catalina); <span
7030 class="ec-lmtt-12">x86_64-darwinlegacy </span>supports 10.6 and newer. MacTeX is notarized and
7031 command line programs have hardened runtimes, as now required by Apple for install
7032 packages. BibDesk and TeX Live Utility are not in MacTeX because they are not notarized,
7033 but a <span
7034 class="ec-lmtt-12">README </span>file lists urls where they can be obtained.
7035 </p><!--l. 3876--><p class="indent" > <span class="obeylines-h"><code class="verb">x86_64-darwinlegacy</code></span>: drop X11 support, including <span
7036 class="ec-lmss-12">xdvi</span>.
7037
7038
7039 </p><!--l. 3878--><p class="indent" > <span
7040 class="ec-lmtt-12">tlmgr </span>and infrastructure: </p>
7041 <ul class="itemize1">
7042 <li class="itemize">
7043 <!--l. 3879--><p class="noindent" >Automatically retry (once) packages that fail to download.
7044 </p></li>
7045 <li class="itemize">
7046 <!--l. 3880--><p class="noindent" >New option <span
7047 class="ec-lmtt-12">tlmgr check texmfdbs</span>, to check consistency of <span
7048 class="ec-lmtt-12">ls-R </span>files and
7049 <span
7050 class="ec-lmtt-12">!!</span> specifications for each tree.
7051 </p></li>
7052 <li class="itemize">
7053 <!--l. 3883--><p class="noindent" >Use versioned filenames for the package containers, as in:<br
7054 class="newline" /><span
7055 class="ec-lmtt-12">tlnet/archive/</span><span
7056 class="ec-lmtto-10x-x-120">pkgname</span><span
7057 class="ec-lmtt-12">.rNNN.tar.xz</span>. This should be invisible to users, but is a
7058 notable change in distribution.
7059 </p></li>
7060 <li class="itemize">
7061 <!--l. 3886--><p class="noindent" ><span
7062 class="ec-lmtt-12">catalogue-date </span>information no longer propagated from the TeX Catalogue, since
7063 it was often unrelated to package updates.</p></li></ul>
7064
7065 <h5 class="subsubsectionHead"><span class="titlemark">9.1.18 </span> <a
7066 id="x1-890009.1.18"></a>2021</h5>
7067 <!--l. 3893--><p class="noindent" >General: </p>
7068 <ul class="itemize1">
7069 <li class="itemize">
7070 <!--l. 3894--><p class="noindent" >Donald Knuth’s changes for his 2021 tuneup of TeX and Metafont are incorporated
7071 (<a
7072 href="https://tug.org/TUGboat/tb42-1/tb130knuth-tuneup21.pdf" class="url" ><span
7073 class="ec-lmtt-12">https://tug.org/TUGboat/tb42-1/tb130knuth-tuneup21.pdf</span></a>). They are
7074 also available on CTAN as the <span
7075 class="ec-lmtt-12">knuth-dist </span>and <span
7076 class="ec-lmtt-12">knuth-local </span>packages. As
7077 expected, the fixes are for obscure cases and do not affect any behavior in practice.
7078 </p></li>
7079 <li class="itemize">
7080 <!--l. 3901--><p class="noindent" >Except in original TeX: if <span
7081 class="ec-lmtt-12">\tracinglostchars </span>is set to 3 or more, missing
7082 characters will result in an error, not just a message in the log file, and the missing
7083 character code will be shown in hex.
7084 </p></li>
7085 <li class="itemize">
7086 <!--l. 3905--><p class="noindent" >Except in original TeX: a new integer parameter <span
7087 class="ec-lmtt-12">\tracingstacklevels</span>, if
7088 positive, and <span
7089 class="ec-lmtt-12">\tracingmacros </span>is also positive, causes a prefix indicating the macro
7090 expansion depth to be output on each relevant log line (e.g., <span class="obeylines-h"><code class="verb">~..</code></span> at depth 2). Also,
7091 macro logging is truncated at a depth <span
7092 class="lmsy-10x-x-120">≥ </span>the parameter value.
7093 </p>
7094 </li></ul>
7095 <!--l. 3913--><p class="indent" > Aleph: The Aleph-based LaTeX format, named <span
7096 class="ec-lmtt-12">lamed</span>, has been removed. The <span
7097 class="ec-lmtt-12">aleph</span>
7098 binary itself is still included and supported.
7099 </p><!--l. 3916--><p class="indent" > LuaTeX: </p>
7100 <ul class="itemize1">
7101 <li class="itemize">
7102
7103
7104 <!--l. 3917--><p class="noindent" >Lua 5.3.6.
7105 </p></li>
7106 <li class="itemize">
7107 <!--l. 3918--><p class="noindent" >Callback for nesting level used in <span
7108 class="ec-lmtt-12">\tracingmacros</span>, as generalized variant of the
7109 new <span
7110 class="ec-lmtt-12">\tracingstacklevels</span>.
7111 </p></li>
7112 <li class="itemize">
7113 <!--l. 3920--><p class="noindent" >Mark math glyphs as protected to prevent processing as text.
7114 </p></li>
7115 <li class="itemize">
7116 <!--l. 3921--><p class="noindent" >Removed width/ic compensation for traditional math code path.</p></li></ul>
7117 <!--l. 3924--><p class="indent" > MetaPost: </p>
7118 <ul class="itemize1">
7119 <li class="itemize">
7120 <!--l. 3925--><p class="noindent" ><span class="obeylines-h"><code class="verb">SOURCE_DATE_EPOCH</code></span> environment variable support for reproducible output.
7121 </p></li>
7122 <li class="itemize">
7123 <!--l. 3926--><p class="noindent" >Avoid wrong final <span
7124 class="ec-lmtt-12">% </span>in <span
7125 class="ec-lmtt-12">mpto</span>.
7126 </p></li>
7127 <li class="itemize">
7128 <!--l. 3927--><p class="noindent" >Document <span
7129 class="ec-lmtt-12">-T </span>option, other fixes to manual.
7130 </p></li>
7131 <li class="itemize">
7132 <!--l. 3928--><p class="noindent" >Value of <span
7133 class="ec-lmtt-12">epsilon </span>changed in binary and decimal modes, so that the function
7134 <span class="obeylines-h"><code class="verb">mp_solve_rising_cubic</code></span> works as expected.</p></li></ul>
7135 <!--l. 3932--><p class="indent" > pdfTeX: </p>
7136 <ul class="itemize1">
7137 <li class="itemize">
7138 <!--l. 3933--><p class="noindent" >New primitives <span
7139 class="ec-lmtt-12">\pdfrunninglinkoff </span>and <span
7140 class="ec-lmtt-12">\pdfrunninglinkon</span>; e.g., for disabling
7141 generation of links in headers and footers.
7142 </p></li>
7143 <li class="itemize">
7144 <!--l. 3936--><p class="noindent" >Warn instead of aborting when “<span
7145 class="ec-lmtt-12">\pdfendlink </span>ended up in different nesting level
7146 than <span
7147 class="ec-lmtt-12">\pdfstartlink</span>”.
7148 </p></li>
7149 <li class="itemize">
7150 <!--l. 3938--><p class="noindent" >Dump <span
7151 class="ec-lmtt-12">\pdfglyphtounicode </span>assignments in <span
7152 class="ec-lmtt-12">fmt </span>file.
7153 </p></li>
7154 <li class="itemize">
7155 <!--l. 3939--><p class="noindent" >Source: <span
7156 class="ec-lmtt-12">poppler </span>support removed, as it was too hard to keep in sync with upstream.
7157 In native TeX Live, pdfTeX has always used <span
7158 class="ec-lmtt-12">libs/xpdf</span>, which is cut-down and
7159 adapted code from <span
7160 class="ec-lmtt-12">xpdf</span>.</p></li></ul>
7161 <!--l. 3944--><p class="indent" > XeTeX: Fixes for math kerning.
7162 </p><!--l. 3946--><p class="indent" > Dvipdfmx: </p>
7163 <ul class="itemize1">
7164 <li class="itemize">
7165
7166
7167 <!--l. 3947--><p class="noindent" >Ghostscript is now invoked safely by default; to override (thereby assuming all input
7168 files are trusted), use <span class="obeylines-h"><code class="verb">-i dvipdfmx-unsafe.cfg</code></span>. To use PSTricks with XeTeX,
7169 this is required, as in:<br
7170 class="newline" /><span class="obeylines-h"><code class="verb">xetex -output-driver=&#x0022;xdvipdfmx -i dvipdfmx-unsafe.cfg -q -E&#x0022; ...</code></span>
7171 </p></li>
7172 <li class="itemize">
7173 <!--l. 3952--><p class="noindent" >If an image file is not found, exit with bad status.
7174 </p></li>
7175 <li class="itemize">
7176 <!--l. 3953--><p class="noindent" >Extended special syntax for color support.
7177 </p></li>
7178 <li class="itemize">
7179 <!--l. 3954--><p class="noindent" >Specials for manipulating <span class="obeylines-h"><code class="verb">ExtGState</code></span>.
7180 </p></li>
7181 <li class="itemize">
7182 <!--l. 3955--><p class="noindent" >Compatibility specials <span
7183 class="ec-lmtt-12">pdfcolorstack </span>and <span
7184 class="ec-lmtt-12">pdffontattr</span>.
7185 </p></li>
7186 <li class="itemize">
7187 <!--l. 3956--><p class="noindent" >Experimental support for <span
7188 class="ec-lmtt-12">dviluatex</span>’s extended <span class="obeylines-h"><code class="verb">fnt_def</code></span>.
7189 </p></li>
7190 <li class="itemize">
7191 <!--l. 3957--><p class="noindent" >Support new feature of virtual font to fallback Japanese font definition.</p></li></ul>
7192 <!--l. 3960--><p class="indent" > Dvips: </p>
7193 <ul class="itemize1">
7194 <li class="itemize">
7195 <!--l. 3961--><p class="noindent" >Default PostScript document title is now the basename of the input file, and can
7196 be overridden with the new option <span
7197 class="ec-lmtt-12">-title</span>.
7198 </p></li>
7199 <li class="itemize">
7200 <!--l. 3963--><p class="noindent" >If an <span
7201 class="ec-lmtt-12">.eps </span>or other image file is not found, exit with bad status.
7202 </p></li>
7203 <li class="itemize">
7204 <!--l. 3965--><p class="noindent" >Support new feature of virtual font to fallback Japanese font definition.</p></li></ul>
7205 <!--l. 3968--><p class="indent" > MacTeX: MacTeX and its new binary folder <span
7206 class="ec-lmtt-12">universal-darwin </span>now require macOS 10.14
7207 or higher (Mojave, Catalina, and Big Sur); the <span class="obeylines-h"><code class="verb">x86_64-darwin</code></span> binary folder is no longer
7208 present. The <span class="obeylines-h"><code class="verb">x86_64-darwinlegacy</code></span> binary folder, available only with the Unix <span
7209 class="ec-lmtt-12">install-tl</span>,
7210 supports 10.6 and newer.
7211 </p><!--l. 3974--><p class="indent" > This is an important year for the Macintosh because Apple introduced ARM machines in
7212 November and will sell and support both ARM and Intel machines for many years. All
7213 programs in <span
7214 class="ec-lmtt-12">universal-darwin </span>have executable code for both ARM and Intel. Both binaries
7215 are compiled from the same source code.
7216 </p><!--l. 3980--><p class="indent" > The additional programs Ghostscript, LaTeXiT, TeX Live Utility, and TeXShop are all
7217 universal and are signed with a hardened runtime, so all are included in MacTeX this
7218 year.
7219 </p><!--l. 3984--><p class="indent" > <span
7220 class="ec-lmtt-12">tlmgr </span>and infrastructure: </p>
7221 <ul class="itemize1">
7222
7223
7224 <li class="itemize">
7225 <!--l. 3985--><p class="noindent" >keep only one backup of the main repository’s <span
7226 class="ec-lmtt-12">texlive.tlpdb</span>.
7227 </p></li>
7228 <li class="itemize">
7229 <!--l. 3986--><p class="noindent" >even more portability across systems and Perl versions.
7230 </p></li>
7231 <li class="itemize">
7232 <!--l. 3987--><p class="noindent" ><span
7233 class="ec-lmtt-12">tlmgr info </span>reports new <span
7234 class="ec-lmtt-12">lcat-* </span>and <span
7235 class="ec-lmtt-12">rcat-* </span>fields for local vs. remote Catalogue
7236 data.
7237 </p></li>
7238 <li class="itemize">
7239 <!--l. 3989--><p class="noindent" >full logging of subcommands moved to a new log file:<br
7240 class="newline" /><span
7241 class="ec-lmtt-12">texmf-var/web2c/tlmgr-commands.log</span>.</p></li></ul>
7242
7243 <h5 class="subsubsectionHead"><span class="titlemark">9.1.19 </span> <a
7244 id="x1-900009.1.19"></a>2022</h5>
7245 <!--l. 3996--><p class="noindent" >General: </p>
7246 <ul class="itemize1">
7247 <li class="itemize">
7248 <!--l. 3997--><p class="noindent" >New engine <span
7249 class="ec-lmtt-12">hitex</span>, which outputs its own HINT format, designed especially for
7250 reading technical documents on mobile devices. HINT viewers for GNU/Linux,
7251 Windows, and Android are available separately from TeX Live.
7252 </p></li>
7253 <li class="itemize">
7254 <!--l. 4002--><p class="noindent" ><span
7255 class="ec-lmtt-12">tangle</span>, <span
7256 class="ec-lmtt-12">weave</span>: support optional third argument to specify output file.
7257 </p></li>
7258 <li class="itemize">
7259 <!--l. 4005--><p class="noindent" >Knuth’s program <span
7260 class="ec-lmtt-12">twill </span>for making mini-indexes for original <span
7261 class="ec-lmtt-12">WEB </span>programs now
7262 included.
7263 </p>
7264 </li></ul>
7265 <!--l. 4010--><p class="indent" > Cross-engine extensions (except in original TeX, Aleph, and hiTeX): </p>
7266 <ul class="itemize1">
7267 <li class="itemize">
7268 <!--l. 4012--><p class="noindent" >New primitive <span
7269 class="ec-lmtt-12">\showstream </span>to redirect <span
7270 class="ec-lmtt-12">\show </span>output to a file.
7271 </p></li>
7272 <li class="itemize">
7273 <!--l. 4013--><p class="noindent" >New primitives <span
7274 class="ec-lmtt-12">\partokenname </span>and <span
7275 class="ec-lmtt-12">\partokencontext </span>allow overriding the name
7276 of the <span
7277 class="ec-lmtt-12">\par </span>token emitted at blank lines, the end of vboxes, etc.</p></li></ul>
7278 <!--l. 4018--><p class="indent" > epTeX, eupTeX: </p>
7279 <ul class="itemize1">
7280 <li class="itemize">
7281 <!--l. 4019--><p class="noindent" >New
7282 primitives:
7283
7284
7285 <span
7286 class="ec-lmtt-12">\lastnodefont</span>,
7287 <span
7288 class="ec-lmtt-12">\suppresslongerror</span>,
7289 <span
7290 class="ec-lmtt-12">\suppressoutererror</span>,
7291 <span
7292 class="ec-lmtt-12">\suppressmathparerror</span>.
7293 </p></li>
7294 <li class="itemize">
7295 <!--l. 4021--><p class="noindent" >pdfTeX
7296 extension
7297 <span
7298 class="ec-lmtt-12">\vadjust</span>
7299 <span
7300 class="ec-lmtt-12">pre</span>
7301 now
7302 available.</p></li></ul>
7303 <!--l. 4024--><p class="indent" > LuaTeX: </p>
7304 <ul class="itemize1">
7305 <li class="itemize">
7306 <!--l. 4025--><p class="noindent" >Support structured destinations from PDF 2.0.
7307 </p></li>
7308 <li class="itemize">
7309 <!--l. 4026--><p class="noindent" >PNG /Smask for PDF 2.0.
7310 </p></li>
7311 <li class="itemize">
7312 <!--l. 4027--><p class="noindent" >Variable font interface for <span
7313 class="ec-lmtt-12">luahbtex</span>.
7314 </p></li>
7315 <li class="itemize">
7316 <!--l. 4028--><p class="noindent" >Different radical style defaults in mathdefaultsmode.
7317 </p></li>
7318 <li class="itemize">
7319 <!--l. 4029--><p class="noindent" >Optionally block selected discretionary creation.
7320 </p></li>
7321 <li class="itemize">
7322 <!--l. 4030--><p class="noindent" >Improvements for TrueType fonts implementation.
7323 </p></li>
7324 <li class="itemize">
7325 <!--l. 4031--><p class="noindent" >More efficient <span
7326 class="ec-lmtt-12">\fontdimen </span>allocation.
7327 </p></li>
7328 <li class="itemize">
7329 <!--l. 4032--><p class="noindent" >Ignore paragraphs with only a local <span
7330 class="ec-lmtt-12">par </span>node followed by direction synchronization
7331 nodes.</p></li></ul>
7332 <!--l. 4036--><p class="indent" > MetaPost: Bug fix for infinite macro expansion.
7333 </p><!--l. 4038--><p class="indent" > pdfTeX: </p>
7334 <ul class="itemize1">
7335 <li class="itemize">
7336 <!--l. 4039--><p class="noindent" >Support
7337 structured
7338
7339
7340 destinations
7341 from
7342 PDF
7343 2.0.
7344 </p></li>
7345 <li class="itemize">
7346 <!--l. 4040--><p class="noindent" >For
7347 letterspaced
7348 fonts,
7349 use
7350 explicit
7351 <span
7352 class="ec-lmtt-12">\fontdimen</span>6
7353 if
7354 specified.
7355 </p></li>
7356 <li class="itemize">
7357 <!--l. 4041--><p class="noindent" >Always
7358 start
7359 a
7360 warning
7361 at
7362 the
7363 beginning
7364 of
7365 a
7366 line.
7367 </p></li>
7368 <li class="itemize">
7369 <!--l. 4042--><p class="noindent" >For
7370 characters
7371 with
7372 autokern
7373 (<span
7374 class="ec-lmtt-12">\pdfappendkern</span>
7375 and
7376 <span
7377 class="ec-lmtt-12">\pdfprependkern</span>),
7378 still
7379 do
7380 protrusion;
7381 likewise,
7382 autokern
7383 both
7384 implicit
7385 and
7386 explicit
7387
7388
7389 hyphens.</p></li></ul>
7390 <!--l. 4047--><p class="indent" > pTeX et al.: </p>
7391 <ul class="itemize1">
7392 <li class="itemize">
7393 <!--l. 4048--><p class="noindent" >Major update of pTeX to 4.0.0 to better support current LaTeX.
7394 </p></li>
7395 <li class="itemize">
7396 <!--l. 4049--><p class="noindent" >New primitives <span
7397 class="ec-lmtt-12">\ptexlineendmode </span>and <span
7398 class="ec-lmtt-12">\toucs</span>.
7399 </p></li>
7400 <li class="itemize">
7401 <!--l. 4050--><p class="noindent" ><span
7402 class="ec-lmtt-12">\ucs </span>(formerly available in uptex, euptex) now available also in pTeX and epTeX.
7403 </p></li>
7404 <li class="itemize">
7405 <!--l. 4052--><p class="noindent" >Distinguish eight-bit characters
7406 and Japanese characters, as discussed in a <span
7407 class="ec-lmro-12">TUGboat </span>article by Hironori Kitagawa
7408 (<a
7409 href="https://tug.org/TUGboat/tb41-3/tb129kitagawa-char.pdf" class="url" ><span
7410 class="ec-lmtt-12">https://tug.org/TUGboat/tb41-3/tb129kitagawa-char.pdf</span></a>).</p></li></ul>
7411 <!--l. 4057--><p class="indent" > XeTeX: New wrapper scripts <span
7412 class="ec-lmtt-12">xetex-unsafe </span>and <span
7413 class="ec-lmtt-12">xelatex-unsafe </span>for simpler invocation of
7414 documents requiring both XeTeX and PSTricks transparency operators, which is inherently
7415 unsafe (until and unless reimplementation in Ghostscript happens). For safety, use
7416 Lua(L<span
7417 class="ec-lmr-8">A</span>)TeX.
7418 </p><!--l. 4063--><p class="indent" > Dvipdfmx: </p>
7419 <ul class="itemize1">
7420 <li class="itemize">
7421 <!--l. 4064--><p class="noindent" >Support for PSTricks without requiring <span
7422 class="ec-lmtt-12">-dNOSAFER</span>, except for transparency.
7423 </p></li>
7424 <li class="itemize">
7425 <!--l. 4066--><p class="noindent" >The <span
7426 class="ec-lmtt-12">-r </span>option to set bitmap font resolution works again.</p></li></ul>
7427 <!--l. 4069--><p class="indent" > Dvips: By default, do not attempt automatic media adjustment for rotated paper sizes; the
7428 new option <span
7429 class="ec-lmtt-12">--landscaperotate </span>re-enables.
7430 </p><!--l. 4072--><p class="indent" > <span
7431 class="ec-lmtt-12">upmendex</span>: Experimental support for Arabic and Hebrew scripts; improved character
7432 classification and language support.
7433 </p><!--l. 4075--><p class="indent" > Kpathsea: First path returned from <span
7434 class="ec-lmtt-12">kpsewhich -all </span>is now the same as a regular (non-all)
7435 search.
7436 </p><!--l. 4078--><p class="indent" > <span
7437 class="ec-lmtt-12">tlmgr </span>and infrastructure: </p>
7438 <ul class="itemize1">
7439 <li class="itemize">
7440 <!--l. 4079--><p class="noindent" >use https for <span
7441 class="ec-lmtt-12">mirror.ctan.org </span>by default.
7442 </p></li>
7443 <li class="itemize">
7444 <!--l. 4080--><p class="noindent" >use <span
7445 class="ec-lmtt-12">TEXMFROOT </span>instead of <span
7446 class="ec-lmtt-12">SELFAUTOPARENT </span>for easier relocating.
7447 </p></li>
7448 <li class="itemize">
7449 <!--l. 4082--><p class="noindent" ><span
7450 class="ec-lmtt-12">install-tl</span>: if download or installation fails for a given package, automatically
7451 continue and later retry (once).</p></li></ul>
7452 <!--l. 4086--><p class="indent" > MacTeX: MacTeX and its binary folder <span
7453 class="ec-lmtt-12">universal-darwin </span>require macOS 10.14 or
7454 higher (Mojave, Catalina, Big Sur, Monterey). The <span class="obeylines-h"><code class="verb">x86_64-darwinlegacy</code></span> binary
7455
7456
7457 folder, available only with the Unix <span
7458 class="ec-lmtt-12">install-tl</span>, supports 10.6 (Snow Leopard) and
7459 newer.
7460 </p><!--l. 4091--><p class="indent" > Platforms: No changes to platform support for this year (2022). However, for next year’s
7461 release (2023), we are planning to switch the Windows binaries from 32-bit to 64-bit.
7462 Unfortunately we cannot feasibly support both simultaneously.
7463
7464 </p>
7465 <h5 class="subsubsectionHead"><span class="titlemark">9.1.20 </span> <a
7466 id="x1-910009.1.20"></a>2023</h5>
7467 <!--l. 4099--><p class="noindent" >Windows: As announced previously, TeX Live now contains 64-bit Windows binaries instead of
7468 32-bit. The new directory name is <span
7469 class="ec-lmtt-12">bin/windows </span>(it did not seem right to put 64-bit
7470 binaries into a directory named with “32”). We know this will cause extra work for
7471 Windows users, but there seemed no better alternative. If you need 32-bit Windows
7472 support, you’ll need to install TeX Live 2022. From Windows 11 onward, Windows on
7473 ARM supports emulation of 64-bit AMD/Intel and thus can use the current TeX
7474 Live. However, Windows 10 on ARM cannot emulate Intel/AMD 64-bit, and will
7475 therefore also need a 32-bit TeX Live. See the separate TeX Live Windows web page (
7476 <a
7477 href="https://tug.org/texlive/windows.html" class="url" ><span
7478 class="ec-lmtt-12">https://tug.org/texlive/windows.html</span></a>).
7479 </p><!--l. 4112--><p class="indent" >
7480 Cross-engine
7481 extensions
7482 (except
7483 in
7484 original
7485 TeX
7486 and
7487 e-TeX):
7488 <span
7489 class="ec-lmtt-12">\special</span>
7490 followed
7491 by
7492 a
7493 new
7494 keyword
7495 “<span
7496 class="ec-lmtt-12">shipout</span>”
7497 delays
7498 expansion
7499 of
7500 the
7501 argument
7502 tokens
7503 until
7504 <span
7505 class="ec-lmtt-12">\shipout</span>
7506 time,
7507 as
7508
7509
7510 with
7511 a
7512 non-<span class="obeylines-h"><code class="verb">\immediate\write</code></span>.
7513 </p><!--l. 4118--><p class="noindent" >epTeX, eupTeX:</p>
7514 <ul class="itemize1">
7515 <li class="itemize">
7516 <!--l. 4119--><p class="noindent" >“Raw” (u)ptex no longer built; (u)ptex now runs in e(u)ptex’s compatibility mode.
7517 Same for pTeX tools, listed below.
7518 </p></li>
7519 <li class="itemize">
7520 <!--l. 4121--><p class="noindent" >New primitives: <span
7521 class="ec-lmtt-12">\tojis</span>, <span
7522 class="ec-lmtt-12">\ptextracingfonts</span>, <span
7523 class="ec-lmtt-12">\ptexfontname</span>.
7524 </p></li>
7525 <li class="itemize">
7526 <!--l. 4123--><p class="noindent" >For <span
7527 class="ec-lmtt-12">\font</span>, new syntax for JIS/UCS is supported.</p></li></ul>
7528 <!--l. 4126--><p class="noindent" >LuaTeX: </p>
7529 <ul class="itemize1">
7530 <li class="itemize">
7531 <!--l. 4127--><p class="noindent" >new primitive <span
7532 class="ec-lmtt-12">\variablefam </span>to allow math characters to keep their class while
7533 still letting the family adapt.
7534 </p></li>
7535 <li class="itemize">
7536 <!--l. 4129--><p class="noindent" >improved r2l annotation areas
7537 </p></li>
7538 <li class="itemize">
7539 <!--l. 4130--><p class="noindent" >cross-engine “late <span
7540 class="ec-lmtt-12">\special</span>” described above.
7541 </p></li>
7542 <li class="itemize">
7543 <!--l. 4131--><p class="noindent" >in LuaTeX 1.17.0, released in May 2023: the socket library is now disabled by
7544 default; a new command line option <span
7545 class="ec-lmtt-12">–socket </span>enables it, as well as <span
7546 class="ec-lmtt-12">–shell-escape</span>
7547 (not <span
7548 class="ec-lmtt-12">–shell-restricted</span>). In addition, the mime library is now always available,
7549 and new functions <span
7550 class="ec-lmtt-12">os.socketsleep </span>and <span
7551 class="ec-lmtt-12">os.socketgettime </span>are also always
7552 available. Finally, some obscure ways to work around various security features were
7553 fixed.</p></li></ul>
7554 <!--l. 4141--><p class="noindent" >MetaPost: Bug fixes. <span
7555 class="ec-lmtt-12">svg-&#x003E;dx </span>and <span
7556 class="ec-lmtt-12">svg-&#x003E;dy </span>are now <span
7557 class="ec-lmtt-12">double</span>, for better precision;
7558 <span class="obeylines-h"><code class="verb">mp_begin_iteration</code></span> updated; memory leak in <span
7559 class="ec-lmtt-12">mplib </span>fixed.
7560 </p><!--l. 4145--><p class="noindent" >pdfTeX: </p>
7561 <ul class="itemize1">
7562 <li class="itemize">
7563 <!--l. 4146--><p class="noindent" >new primitive <span
7564 class="ec-lmtt-12">\pdfomitinfodict </span>to omit <span
7565 class="ec-lmtt-12">/Info </span>dictionary completely.
7566 </p></li>
7567 <li class="itemize">
7568 <!--l. 4148--><p class="noindent" >new primitive <span
7569 class="ec-lmtt-12">\pdfomitprocset </span>to control omitting <span
7570 class="ec-lmtt-12">/ProcSet </span>array: <span
7571 class="ec-lmtt-12">/ProcSet </span>is
7572 included if this parameter is negative, or if this parameter is zero and pdftex is
7573 generating PDF 1.x output.
7574 </p></li>
7575 <li class="itemize">
7576
7577
7578 <!--l. 4152--><p class="noindent" >with <span
7579 class="ec-lmtt-12">\pdfinterwordspaceon</span>, if the current font’s encoding has a <span
7580 class="ec-lmtt-12">/space </span>character
7581 at slot 32, it is used; otherwise, the <span
7582 class="ec-lmtt-12">/space </span>from the (new) default font
7583 <span
7584 class="ec-lmtt-12">pdftexspace </span>is used. That default font can be overridden with the new primitive
7585 <span
7586 class="ec-lmtt-12">\pdfspacefont</span>. This same new procedure is used for <span
7587 class="ec-lmtt-12">\pdffakespace</span>.</p></li></ul>
7588 <!--l. 4160--><p class="noindent" >pTeX et al.: </p>
7589 <ul class="itemize1">
7590 <li class="itemize">
7591 <!--l. 4161--><p class="noindent" >As mentioned above, <span
7592 class="ec-lmtt-12">ptex </span>now runs <span
7593 class="ec-lmtt-12">eptex </span>in compatibility mode instead of being
7594 built separately.
7595 </p></li>
7596 <li class="itemize">
7597 <!--l. 4164--><p class="noindent" >pTeX tools (pbibtex, pdvitype, ppltotf, ptftopl) merged into corresponding upTeX
7598 versions, running in compatibility mode.</p></li></ul>
7599 <!--l. 4168--><p class="noindent" >XeTeX: fixed <span
7600 class="ec-lmtt-12">\topskip </span>and <span
7601 class="ec-lmtt-12">\splittopskip </span>computation when <span
7602 class="ec-lmtt-12">\XeTeXupwardsmode </span>is active;
7603 the cross-engine “late <span
7604 class="ec-lmtt-12">\special</span>” described above.
7605 </p><!--l. 4172--><p class="noindent" >Dvipdfmx: new option <span
7606 class="ec-lmtt-12">--pdfm-str-utf8 </span>to make pdfmark and/or bookmark.
7607 </p><!--l. 4175--><p class="noindent" >BibTeXu: </p>
7608 <ul class="itemize1">
7609 <li class="itemize">
7610 <!--l. 4176--><p class="noindent" >This BibTeX variant is mostly upward-compatible with BibTeX, with much better
7611 (Unicode-based) multilingual support. It’s been in TeX Live for some years.
7612 </p></li>
7613 <li class="itemize">
7614 <!--l. 4179--><p class="noindent" >This year, more features to support CJK languages have been added, some
7615 extended from the Japanese (u)pbibtex and other programs.</p></li></ul>
7616 <!--l. 4183--><p class="noindent" >Kpathsea: Support guessing input file encodings for Unix-ish platforms, as on Windows;
7617 enabled for (<span
7618 class="ec-lmtt-12">e</span>)<span
7619 class="ec-lmtt-12">p</span>(<span
7620 class="ec-lmtt-12">la</span>)<span
7621 class="ec-lmtt-12">tex</span>, <span
7622 class="ec-lmtt-12">pbibtex</span>, <span
7623 class="ec-lmtt-12">mendex</span>.
7624 </p><!--l. 4188--><p class="noindent" ><span
7625 class="ec-lmtt-12">tlmgr </span>and infrastructure: </p>
7626 <ul class="itemize1">
7627 <li class="itemize">
7628 <!--l. 4189--><p class="noindent" >default to text interface on macOS.
7629 </p></li>
7630 <li class="itemize">
7631 <!--l. 4190--><p class="noindent" >install core packages first, retry other packages once.
7632 </p></li>
7633 <li class="itemize">
7634 <!--l. 4191--><p class="noindent" >simplistic checks are done for enough disk space.</p></li></ul>
7635 <!--l. 4194--><p class="noindent" >MacTeX: </p>
7636 <ul class="itemize1">
7637 <li class="itemize">
7638 <!--l. 4195--><p class="noindent" >MacTeX and its binary folder <span
7639 class="ec-lmtt-12">universal-darwin </span>require macOS 10.14 or higher
7640 (Mojave, Catalina, Big Sur, Monterey, Ventura). The <span
7641 class="ec-lmtt-12">x86_64-darwinlegacy</span>
7642 binary folder, available only with the Unix <span
7643 class="ec-lmtt-12">install-tl</span>, supports 10.6
7644 (Snow Leopard) and later.
7645 </p></li>
7646 <li class="itemize">
7647
7648
7649 <!--l. 4201--><p class="noindent" >The GUI package in MacTeX now contains <span
7650 class="ec-lmtt-12">hintview</span>, a macOS viewer for HINT
7651 documents (created by the <span
7652 class="ec-lmtt-12">hitex </span>and <span
7653 class="ec-lmtt-12">hilatex </span>engines for mobile devices; see
7654 the HiTeX web page, <a
7655 href="https://hint.userweb.mwn.de/hint/hitex.html" class="url" ><span
7656 class="ec-lmtt-12">https://hint.userweb.mwn.de/hint/hitex.html</span></a>). The
7657 GUI package no longer installs a folder of documents, replacing them with a short
7658 <span
7659 class="ec-lmtt-12">READ</span><span
7660 class="ec-lmtt-12"> ME </span>for new users and a page about <span
7661 class="ec-lmtt-12">hintview</span>.
7662 </p></li>
7663 <li class="itemize">
7664 <!--l. 4208--><p class="noindent" >The <span
7665 class="ec-lmtt-12">Extras </span>folder of additional TeX software on the DVD has been replaced with
7666 a document containing links to download sites.</p></li></ul>
7667 <!--l. 4212--><p class="noindent" >Platforms: </p>
7668 <ul class="itemize1">
7669 <li class="itemize">
7670 <!--l. 4213--><p class="noindent" >As mentioned above, the new <span
7671 class="ec-lmtt-12">windows </span>binary directory contains 64-bit Windows
7672 binaries, and
7673 </p></li>
7674 <li class="itemize">
7675 <!--l. 4215--><p class="noindent" >the <span
7676 class="ec-lmtt-12">bin/win32 </span>binary directory is gone, since we cannot support 32-bit and 64-bit
7677 Windows simultaneously.
7678 </p></li>
7679 <li class="itemize">
7680 <!--l. 4217--><p class="noindent" >The <span
7681 class="ec-lmtt-12">i386-cygwin </span>binary directory is gone, since Cygwin no longer supports i386.</p></li></ul>
7682
7683 <h5 class="subsubsectionHead"><span class="titlemark">9.1.21 </span> <a
7684 id="x1-920009.1.21"></a>2024</h5>
7685 <!--l. 4224--><p class="noindent" >Cross-engine changes (except in original TeX, e-TeX, and LuaTeX): </p>
7686 <ul class="itemize1">
7687 <li class="itemize">
7688 <!--l. 4226--><p class="noindent" >Avoid crashes on devious use of <span
7689 class="ec-lmtt-12">\output </span>and <span
7690 class="ec-lmtt-12">\write </span>braces.
7691 </p></li>
7692 <li class="itemize">
7693 <!--l. 4227--><p class="noindent" >Tiny inner-loop optimization. (Both these changes are due to David Fuchs.)</p></li></ul>
7694 <!--l. 4231--><p class="noindent" >LuaTeX: </p>
7695 <ul class="itemize1">
7696 <li class="itemize">
7697 <!--l. 4232--><p class="noindent" >Lua-level checks for writing to files now similar to the TeX-level checks.
7698 </p></li>
7699 <li class="itemize">
7700 <!--l. 4234--><p class="noindent" >If the Lua value <span
7701 class="ec-lmtt-12">texconfig.trace_extra_newline </span>is set, blank lines are output
7702 in the log between macro parameters. In 2020–2023, this was the case by default;
7703 before that, such blank lines were never output, which is the behavior of the other
7704 engines.
7705 </p></li>
7706 <li class="itemize">
7707 <!--l. 4238--><p class="noindent" >In the past, Windows <span
7708 class="ec-lmtt-12">texlua </span>(not <span
7709 class="ec-lmtt-12">luatex</span>, and not any other platform), internally
7710 performed wildcard expansion on the arguments. This no longer happens.</p></li></ul>
7711
7712
7713 <!--l. 4243--><p class="noindent" >MetaPost: </p>
7714 <ul class="itemize1">
7715 <li class="itemize">
7716 <!--l. 4244--><p class="noindent" >MPFI
7717 library
7718 now
7719 included
7720 for
7721 interval
7722 arithmetic;
7723 enabled
7724 with
7725 <span
7726 class="ec-lmtt-12">--numbersystem=interval</span>.</p></li></ul>
7727 <!--l. 4248--><p class="noindent" >pdfTeX: </p>
7728 <ul class="itemize1">
7729 <li class="itemize">
7730 <!--l. 4249--><p class="noindent" >More reliable text extraction on BigEndian systems.
7731 </p></li>
7732 <li class="itemize">
7733 <!--l. 4250--><p class="noindent" >More checks against corrupt pfb, fmt, pdf files.
7734 </p></li>
7735 <li class="itemize">
7736 <!--l. 4251--><p class="noindent" >Avoid writing a corrupt pdf given unusual pdf inclusions.
7737 </p></li>
7738 <li class="itemize">
7739 <!--l. 4252--><p class="noindent" >Manual converted to LaTeX and thoroughly reviewed, though substantive updates
7740 are minimal.</p></li></ul>
7741 <!--l. 4256--><p class="noindent" >epTeX, eupTeX: </p>
7742 <ul class="itemize1">
7743 <li class="itemize">
7744 <!--l. 4257--><p class="noindent" >New simple encoding conversion utility <span
7745 class="ec-lmtt-12">ptekf</span>.
7746 </p></li>
7747 <li class="itemize">
7748 <!--l. 4258--><p class="noindent" ><span
7749 class="ec-lmtt-12">eptex </span>no longer built separately; it runs in <span
7750 class="ec-lmtt-12">euptex</span>’s legacy-encoding mode.</p></li></ul>
7751 <!--l. 4262--><p class="noindent" >XeTeX: </p>
7752 <ul class="itemize1">
7753 <li class="itemize">
7754 <!--l. 4263--><p class="noindent" >Unicode characters in filenames beyond the BMP are supported.</p></li></ul>
7755 <!--l. 4266--><p class="noindent" >Dvipdfmx: </p>
7756 <ul class="itemize1">
7757 <li class="itemize">
7758 <!--l. 4267--><p class="noindent" >Calculate time zone offset in the same way as pdfTeX.
7759 </p></li>
7760 <li class="itemize">
7761 <!--l. 4268--><p class="noindent" >Handle variation selectors to cope with the new Adobe-Japan1-UCS2 CMap.
7762
7763
7764 </p></li>
7765 <li class="itemize">
7766 <!--l. 4269--><p class="noindent" >Fallback multibyte characters in virtual fonts to OFM fonts for (u)pTeX.
7767 </p></li>
7768 <li class="itemize">
7769 <!--l. 4270--><p class="noindent" >Support the <span
7770 class="ec-lmtt-12">named </span>keyword in the <span
7771 class="ec-lmtt-12">pdf:image </span>special.</p></li></ul>
7772 <!--l. 4273--><p class="noindent" >Kpathsea: </p>
7773 <ul class="itemize1">
7774 <li class="itemize">
7775 <!--l. 4274--><p class="noindent" >Support an extended check for safe filenames which also allows writing under
7776 <span
7777 class="ec-lmtt-12">TEXMF</span>[<span
7778 class="ec-lmtt-12">SYS</span>]<span
7779 class="ec-lmtt-12">VAR</span>, for Lua(L<span
7780 class="ec-lmr-8">A</span>)TeX; new functions and corresponding <span
7781 class="ec-lmtt-12">kpsewhich</span>
7782 options.
7783 </p></li>
7784 <li class="itemize">
7785 <!--l. 4277--><p class="noindent" >Support a new variable <span
7786 class="ec-lmtt-12">TEXMF_OUTPUT_DIRECTORY </span>(alongside the traditional
7787 <span
7788 class="ec-lmtt-12">TEXMFOUTPUT</span>), so that subprograms can have access to an <span
7789 class="ec-lmtt-12">--output-directory</span>
7790 setting in an engine invocation.</p></li></ul>
7791 <!--l. 4282--><p class="noindent" >CWEB: </p>
7792 <ul class="itemize1">
7793 <li class="itemize">
7794 <!--l. 4283--><p class="noindent" >Support LuaTeX as backend TeX engine.
7795 </p></li>
7796 <li class="itemize">
7797 <!--l. 4284--><p class="noindent" >Fix buffer overflow on lines with no breakpoint.</p></li></ul>
7798 <!--l. 4287--><p class="noindent" ><span
7799 class="ec-lmtt-12">tlmgr</span>: </p>
7800 <ul class="itemize1">
7801 <li class="itemize">
7802 <!--l. 4288--><p class="noindent" >New action <span
7803 class="ec-lmtt-12">bug </span>to help find bug-reporting information.
7804 </p></li>
7805 <li class="itemize">
7806 <!--l. 4289--><p class="noindent" >Use our own root certificate bundle on all platforms, to support LWP more widely,
7807 notably on macOS.
7808 </p></li>
7809 <li class="itemize">
7810 <!--l. 4291--><p class="noindent" >Detect a remote repository older than the local installation (i.e., a stale mirror),
7811 and don’t update, to avoid incorrect package removals.
7812 </p></li>
7813 <li class="itemize">
7814 <!--l. 4293--><p class="noindent" >Support ConTeXt paper size setting.
7815 </p></li>
7816 <li class="itemize">
7817 <!--l. 4294--><p class="noindent" >Prune backups of tlpdb files for mirrored repositories (main and tlcontrib).</p></li></ul>
7818 <!--l. 4298--><p class="noindent" >Platforms: </p>
7819 <ul class="itemize1">
7820 <li class="itemize">
7821 <!--l. 4299--><p class="noindent" >The ISO image again includes binaries for all platforms. For the last several
7822
7823
7824 years, some binary sets had been pruned, but this year, we are not creating a
7825 physical DVD as a user group benefit, so may as well include everything again.
7826 Also, even a maximimally-pruned image is too large to fit on a single-layer
7827 DVD, so pruning has no benefit for the 2024 volunteer burners. More info at
7828 <a
7829 href="https://tug.org/texcollection/" class="url" ><span
7830 class="ec-lmtt-12">https://tug.org/texcollection/</span></a>.
7831 </p></li>
7832 <li class="itemize">
7833 <!--l. 4306--><p class="noindent" >Robert Alessi provides binaries for a native TeX Live installation on OpenBSD at
7834 <a
7835 href="https://sr.ht/~ralessi/texlive-openbsd/" class="url" ><span
7836 class="ec-lmtt-12">https://sr.ht/~ralessi/texlive-openbsd/</span></a>.</p></li></ul>
7837 <!--l. 4310--><p class="noindent" >MacTeX: contains the latest Ghostscript 10.03.0, updates of all four GUI programs, along with
7838 (as always) all new TeX Live changes. The binaries still support macOS 10.14 (Mojave, 2018)
7839 and later. (As usual, earlier Mac versions are supported by the <span
7840 class="ec-lmtt-12">x86_64-darwinlegacy</span>
7841 binaries, which are part of TeX Live, but not MacTeX.)
7842
7843 </p>
7844 <h5 class="subsubsectionHead"><span class="titlemark">9.1.22 </span> <a
7845 id="x1-930009.1.22"></a>2025</h5>
7846 <!--l. 4319--><p class="noindent" >Cross-engine changes (except in original TeX): </p>
7847 <ul class="itemize1">
7848 <li class="itemize">
7849 <!--l. 4321--><p class="noindent" >Generate PDF-1.7 in all formats, both plain and LaTeX; before, it was 1.5. You may
7850 need an older version, especially for printing companies. You can generate, e.g., PDF-1.4
7851 in various ways: </p>
7852 <ul class="itemize2">
7853 <li class="itemize">
7854 <!--l. 4325--><p class="noindent" >Running <span
7855 class="ec-lmtt-12">ps2pdf14 </span>on the PDF file after it’s generated by TeX; this simple
7856 wrapper is part of Ghostscript. Other external software can do the same job.
7857 </p></li>
7858 <li class="itemize">
7859 <!--l. 4328--><p class="noindent" >LaTeX with PDF backends: <span class="obeylines-h"><code class="verb">\pdf_version_gset:n{1.4}</code></span>
7860 </p></li>
7861 <li class="itemize">
7862 <!--l. 4329--><p class="noindent" >pdfTeX: <span class="obeylines-h"><code class="verb">\pdfmajorversion=1 \pdfminorversion=4</code></span>
7863 </p></li>
7864 <li class="itemize">
7865 <!--l. 4330--><p class="noindent" >LuaTeX: <span class="obeylines-h"><code class="verb">\pdfvariable majorversion=1 \pdfvariable minorversion=4</code></span>
7866 </p></li>
7867 <li class="itemize">
7868 <!--l. 4332--><p class="noindent" >XeTeX: <span class="obeylines-h"><code class="verb">\special{pdf:majorversion:1}\special{pdf:minorversion:4}</code></span></p></li></ul>
7869 </li>
7870 <li class="itemize">
7871 <!--l. 4335--><p class="noindent" >If TeX exits due to the <span
7872 class="ec-lmtt-12">-halt-on-error </span>option, write the help message to the log file, as
7873 happens by default.
7874 </p></li>
7875 <li class="itemize">
7876
7877
7878 <!--l. 4337--><p class="noindent" >New primitive parameter <span
7879 class="ec-lmtt-12">\ignoreprimitiveerror</span>; if set to 1, the error <span
7880 class="ec-lmtt-12">&#x0022;Infinite</span>
7881 <span
7882 class="ec-lmtt-12">glue shrinkage found in box being split&#x0022; </span>becomes a warning, so the program exit
7883 status is not changed to failure. Other values are reserved for future use. (Background:
7884 <a
7885 href="https://www.latex-project.org/news/latex2e-news/ltnews39.pdf" class="url" ><span
7886 class="ec-lmtt-12">https://www.latex-project.org/news/latex2e-news/ltnews39.pdf</span></a>, section
7887 “Enhancements to the new mark mechanism”.
7888 </p></li>
7889 <li class="itemize">
7890 <!--l. 4344--><p class="noindent" >Scaling fonts to <span
7891 class="lmsy-10x-x-120">≥</span><span
7892 class="rm-lmr-12">2048</span>pt now results in an error message, instead of (unhandled)
7893 arithmetic overflow or silent changing of the user’s value.</p></li></ul>
7894 <!--l. 4348--><p class="noindent" >LuaTeX: </p>
7895 <ul class="itemize1">
7896 <li class="itemize">
7897 <!--l. 4349--><p class="noindent" >LuaJIT 2.1.1736781742.
7898 </p></li>
7899 <li class="itemize">
7900 <!--l. 4350--><p class="noindent" >New <span
7901 class="ec-lmtt-12">luaffi </span>lib, supporting aarch64.
7902 </p></li>
7903 <li class="itemize">
7904 <!--l. 4351--><p class="noindent" >If <span
7905 class="ec-lmtt-12">\tracinglostchars=4</span>, warn about
7906 missing characters when glyphs are processed, instead of waiting until typesetting
7907 needs them. If <span
7908 class="ec-lmtt-12">\tracinglostchars=5</span>, make that “early” diagnostic into an error.
7909 </p></li>
7910 <li class="itemize">
7911 <!--l. 4355--><p class="noindent" >New primitive <span
7912 class="ec-lmtt-12">\mathemptydisplaymode</span>; when set to 1, empty paragraphs before
7913 a display equation will be ignored. By default paragraphs before a display equation
7914 containing dir nodes are not ignored, which has been the traditional behavior.
7915 </p></li>
7916 <li class="itemize">
7917 <!--l. 4359--><p class="noindent" >For PNG handling, we no longer set the attr on the mask. If we get a report about
7918 dropping this we could add a <span
7919 class="ec-lmtt-12">maskattr </span>feature, but one should consider to include
7920 a correct pdf of the image instead, as it’s more robust.
7921 </p></li>
7922 <li class="itemize">
7923 <!--l. 4363--><p class="noindent" >Handle token combiners in immediate assignments.
7924 </p></li>
7925 <li class="itemize">
7926 <!--l. 4364--><p class="noindent" >Cross-engine updates noted above.</p></li></ul>
7927 <!--l. 4370--><p class="noindent" >pdfTeX: </p>
7928 <ul class="itemize1">
7929 <li class="itemize">
7930 <!--l. 4371--><p class="noindent" >New primitive <span
7931 class="ec-lmtt-12">\pdfptexuseunderscore </span>to use <span class="obeylines-h"><code class="verb">_</code></span> instead of <span class="obeylines-h"><code class="verb">.</code></span> in various dictionary
7932 entries, e.g., <span class="obeylines-h"><code class="verb">PTEX_Fullbanner</code></span> instead of <span class="obeylines-h"><code class="verb">PTEX.Fullbanner</code></span>.
7933 </p></li>
7934 <li class="itemize">
7935 <!--l. 4374--><p class="noindent" >Don’t omit real spaces just because the font changes.
7936 </p></li>
7937
7938
7939 <li class="itemize">
7940 <!--l. 4375--><p class="noindent" >Increase tolerance for detecting interword spaces in overfull lines.
7941 </p></li>
7942 <li class="itemize">
7943 <!--l. 4376--><p class="noindent" >Ignore tiny resolutions like 1x1 embedded in images instead of exceeding
7944 <span
7945 class="ec-lmtt-12">\maxdimen</span>.
7946 </p></li>
7947 <li class="itemize">
7948 <!--l. 4378--><p class="noindent" >Cross-engine updates noted above.</p></li></ul>
7949 <!--l. 4381--><p class="noindent" >epTeX, eupTeX: </p>
7950 <ul class="itemize1">
7951 <li class="itemize">
7952 <!--l. 4382--><p class="noindent" >Support combining characters with multiple codepoints, Unicode Latin characters
7953 and 16-bit OFM Level-0 with new kcatcodes: <span
7954 class="ec-lmtt-12">modifier</span>(20), <span class="obeylines-h"><code class="verb">latin_ucs</code></span>(14).
7955 </p></li>
7956 <li class="itemize">
7957 <!--l. 4385--><p class="noindent" >Cross-engine updates noted above.</p></li></ul>
7958 <!--l. 4388--><p class="noindent" >XeTeX: </p>
7959 <ul class="itemize1">
7960 <li class="itemize">
7961 <!--l. 4389--><p class="noindent" >Cross-engine updates noted above.</p></li></ul>
7962 <!--l. 4392--><p class="noindent" >Dvipdfmx: </p>
7963 <ul class="itemize1">
7964 <li class="itemize">
7965 <!--l. 4393--><p class="noindent" >The <span
7966 class="ec-lmtt-12">ebb </span>executable is now a separately-maintained script instead of a link to
7967 <span
7968 class="ec-lmtt-12">dvipdfmx</span>.
7969 </p></li>
7970 <li class="itemize">
7971 <!--l. 4395--><p class="noindent" >Support upTeX new encoding for combining characters via virtual fonts.
7972 </p></li>
7973 <li class="itemize">
7974 <!--l. 4396--><p class="noindent" >Fixes for embedded TrueType fonts with <span
7975 class="lmmi-12">&#x003E; </span><span
7976 class="rm-lmr-12">127 </span>glyphs, and more.
7977 </p></li>
7978 <li class="itemize">
7979 <!--l. 4397--><p class="noindent" >Fixes for including images multiple times.</p></li></ul>
7980 <!--l. 4400--><p class="noindent" >CWEB: </p>
7981 <ul class="itemize1">
7982 <li class="itemize">
7983 <!--l. 4401--><p class="noindent" >New option <span
7984 class="ec-lmtt-12">+F </span>for cweave and ctwill for compound statements.
7985 </p></li>
7986 <li class="itemize">
7987 <!--l. 4402--><p class="noindent" >Sync pdf bookmark pages with table-of-contents.
7988 </p></li>
7989 <li class="itemize">
7990 <!--l. 4403--><p class="noindent" >Integration of Martin Ruckert’s solution for faster index sorting.
7991
7992
7993 </p></li>
7994 <li class="itemize">
7995 <!--l. 4404--><p class="noindent" >Support macro <span
7996 class="ec-lmtt-12">\9 </span>for sorting names-of-the-sections.
7997 </p></li>
7998 <li class="itemize">
7999 <!--l. 4405--><p class="noindent" >Improved sorting algorithm in <span
8000 class="ec-lmtt-12">ctwill-proofsort</span>.
8001 </p></li>
8002 <li class="itemize">
8003 <!--l. 4406--><p class="noindent" >Output names-of-the-sections in <span
8004 class="ec-lmtt-12">ctwill </span>format.</p></li></ul>
8005 <!--l. 4409--><p class="indent" > Dvips: </p>
8006 <ul class="itemize1">
8007 <li class="itemize">
8008 <!--l. 4410--><p class="noindent" >Support upTeX new encoding for combining characters via virtual fonts.</p></li></ul>
8009 <!--l. 4414--><p class="noindent" >Kpathsea: </p>
8010 <ul class="itemize1">
8011 <li class="itemize">
8012 <!--l. 4415--><p class="noindent" ><span
8013 class="ec-lmtt-12">kpsewhich </span>outputs a blank line when a given file cannot be found, if more than
8014 one file to search for is specified.</p></li></ul>
8015 <!--l. 4419--><p class="noindent" ><span
8016 class="ec-lmtt-12">tlmgr</span>: </p>
8017 <ul class="itemize1">
8018 <li class="itemize">
8019 <!--l. 4420--><p class="noindent" ><span
8020 class="ec-lmtt-12">tlmgr info</span>: new option <span
8021 class="ec-lmtt-12">–only-files </span>to just report the files for a given package.
8022 </p></li>
8023 <li class="itemize">
8024 <!--l. 4422--><p class="noindent" ><span
8025 class="ec-lmtt-12">tlmgr search</span>: new option <span
8026 class="ec-lmtt-12">–json</span>.</p></li></ul>
8027 <!--l. 4425--><p class="noindent" >Platforms: </p>
8028 <ul class="itemize1">
8029 <li class="itemize">
8030 <!--l. 4426--><p class="noindent" >The <span class="obeylines-h"><code class="verb">x86_64-linux</code></span> binaries are now built on Alma Linux 8, since support for
8031 CentOS 7 (even for security updates) ended as of June 30, 2024. We regret
8032 this but see no alternative. Binaries for older systems will be available (see
8033 <a
8034 href="https://tug.org/texlive/custom-bin.html" class="url" ><span
8035 class="ec-lmtt-12">https://tug.org/texlive/custom-bin.html</span></a>).
8036 </p></li>
8037 <li class="itemize">
8038 <!--l. 4432--><p class="noindent" >TeX Live now provides a file <span
8039 class="ec-lmtt-12">scripts-targets.lst </span>with both the name and
8040 the target for symlinked scripts, for the convenience of distros. It’s in the source
8041 directory <span
8042 class="ec-lmtt-12">Build/source/texk/texlive/linked_scripts</span>. The longstanding file
8043 <span
8044 class="ec-lmtt-12">scripts.lst</span>, with just the targets, in that directory, is still maintained.</p></li></ul>
8045 <!--l. 4440--><p class="noindent" >Windows: </p>
8046 <ul class="itemize1">
8047 <li class="itemize">
8048 <!--l. 4442--><p class="noindent" >Visual Basic usage in <span
8049 class="ec-lmtt-12">uninstall-windows </span>and <span
8050 class="ec-lmtt-12">runscript.tlu </span>has been replaced
8051 by Powershell, since VB is optional as of Windows 11.</p></li></ul>
8052 <!--l. 4447--><p class="noindent" >MacTeX: Again this year, MacTeX-2025 supports both Arm and Intel processors on macOS
8053 10.14 (Mojave, 2018), and higher. It installs: </p>
8054
8055
8056 <ul class="itemize1">
8057 <li class="itemize">
8058 <!--l. 4451--><p class="noindent" >TeX Live 2025.
8059 </p></li>
8060 <li class="itemize">
8061 <!--l. 4452--><p class="noindent" >Ghostscript-10.04.0.
8062 </p></li>
8063 <li class="itemize">
8064 <!--l. 4453--><p class="noindent" ><span
8065 class="ec-lmtt-12">libgs </span>and <span
8066 class="ec-lmtt-12">mutool</span>, for <span
8067 class="ec-lmtt-12">dvisvgm</span>. In previous years, this <span
8068 class="ec-lmtt-12">dvisvgm </span>support required
8069 X11, but that requirement is eliminated in 2025 and <span
8070 class="ec-lmtt-12">dvisvgm </span>will work both with
8071 and without X11.
8072 </p></li>
8073 <li class="itemize">
8074 <!--l. 4457--><p class="noindent" >HintView 2.0, which understands the color extensions added to the latest <span
8075 class="ec-lmtt-12">hitex </span>in
8076 TeX Live 2025.
8077 </p></li>
8078 <li class="itemize">
8079 <!--l. 4459--><p class="noindent" >Asymptote, which now requires macOS 11 (Big Sur, 2020) or higher.
8080 </p></li>
8081 <li class="itemize">
8082 <!--l. 4460--><p class="noindent" >TeXShop 5.49, which supports Apple’s latest Apple Intelligence features, including
8083 Writing Tools.</p></li></ul>
8084 <!--l. 4465--><p class="indent" > <a id="news"></a>
8085 </p>
8086 <h4 class="subsectionHead"><span class="titlemark">9.2 </span> <a
8087 id="x1-940009.2"></a>Present: 2026</h4>
8088 <!--l. 4469--><p class="noindent" >Cross-engine changes (except in original TeX and Aleph): </p>
8089 <ul class="itemize1">
8090 <li class="itemize">
8091 <!--l. 4471--><p class="noindent" >When the “<span
8092 class="ec-lmtt-12">Infinite glue shrinkage</span>” error is ignored (see the 2025 release
8093 notes), the word “error” is no longer included in the output, and the message is
8094 written only to the log file. This was a source of minor confusion and false positives.</p></li></ul>
8095 <!--l. 4477--><p class="noindent" >HiTeX: </p>
8096 <ul class="itemize1">
8097 <li class="itemize">
8098 <!--l. 4478--><p class="noindent" >Now
8099 exclusively
8100 uses
8101 the
8102 UTF-8
8103 input
8104 encoding.
8105 </p></li>
8106
8107
8108 <li class="itemize">
8109 <!--l. 4479--><p class="noindent" >OpenType
8110 and
8111 TrueType
8112 fonts
8113 are
8114 now
8115 supported
8116 minimally
8117 (no
8118 ligatures,
8119 no
8120 math);
8121 this
8122 will
8123 improve
8124 in
8125 time.
8126 </p></li>
8127 <li class="itemize">
8128 <!--l. 4481--><p class="noindent" ><span
8129 class="ec-lmtt-12">\Uchar</span>
8130 and
8131 <span
8132 class="ec-lmtt-12">\Ucharcat</span>
8133 primitives
8134 added.
8135 </p></li>
8136 <li class="itemize">
8137 <!--l. 4482--><p class="noindent" >The
8138 LaTeX
8139 kernel
8140 needs
8141 updates
8142 for
8143 this
8144 version,
8145 so
8146 <span
8147 class="ec-lmtt-12">hilatex</span>
8148 is
8149 not
8150 available
8151 for
8152 the
8153 time
8154 being.
8155 </p></li>
8156
8157
8158 <li class="itemize">
8159 <!--l. 4484--><p class="noindent" >Major
8160 changes
8161 throughout
8162 the
8163 code
8164 base,
8165 including
8166 the
8167 HINT
8168 viewers,
8169 to
8170 implement
8171 the
8172 above.
8173 Use
8174 with
8175 care!
8176 </p></li>
8177 <li class="itemize">
8178 <!--l. 4486--><p class="noindent" >Cross-engine
8179 updates
8180 noted
8181 above.</p></li></ul>
8182 <!--l. 4489--><p class="noindent" >LuaTeX: </p>
8183 <ul class="itemize1">
8184 <li class="itemize">
8185 <!--l. 4490--><p class="noindent" >New <span
8186 class="ec-lmtt-12">luaffi</span>.
8187 </p></li>
8188 <li class="itemize">
8189 <!--l. 4491--><p class="noindent" >Lua bindings for the HarfBuzz subset API.
8190 </p></li>
8191 <li class="itemize">
8192 <!--l. 4492--><p class="noindent" ><span
8193 class="ec-lmtt-12">read_img </span>now looks in a given <span
8194 class="ec-lmtt-12">–output-directory</span>.
8195 </p></li>
8196 <li class="itemize">
8197 <!--l. 4493--><p class="noindent" >Saves and restores <span
8198 class="ec-lmtt-12">pdf-&#x003E;objcompresslevel </span>along with <span
8199 class="ec-lmtt-12">pdf-&#x003E;compress_level</span>.
8200 </p></li>
8201 <li class="itemize">
8202 <!--l. 4495--><p class="noindent" ><span
8203 class="ec-lmtt-12">texlua </span>errors print tracebacks.
8204 </p></li>
8205 <li class="itemize">
8206 <!--l. 4496--><p class="noindent" ><span
8207 class="ec-lmtt-12">set_macro </span>check for removing trailing space improved.
8208 </p></li>
8209
8210
8211 <li class="itemize">
8212 <!--l. 4497--><p class="noindent" >Wrong spacing around display with <span
8213 class="ec-lmtt-12">\matheqdirmode=1 </span>partially fixed.
8214 </p></li>
8215 <li class="itemize">
8216 <!--l. 4499--><p class="noindent" >Restored <span
8217 class="ec-lmtt-12">\mathflattenmode</span>.
8218 </p></li>
8219 <li class="itemize">
8220 <!--l. 4500--><p class="noindent" >Fixes for legacy handling of TrueType fonts.
8221 </p></li>
8222 <li class="itemize">
8223 <!--l. 4501--><p class="noindent" >Experimental extension to <span
8224 class="ec-lmtt-12">ToUnicode </span>for Type 1 fonts.
8225 </p></li>
8226 <li class="itemize">
8227 <!--l. 4502--><p class="noindent" >Maximum size of the destination names table for PDF output raised to 1048576.
8228 </p></li>
8229 <li class="itemize">
8230 <!--l. 4504--><p class="noindent" >Additional <span
8231 class="ec-lmtt-12">value </span>field for write nodes (<span
8232 class="ec-lmtt-12">getfield</span>) for unexpanded token tables.
8233 </p></li>
8234 <li class="itemize">
8235 <!--l. 4506--><p class="noindent" >Some unused modes made obsolete.
8236 </p></li>
8237 <li class="itemize">
8238 <!--l. 4507--><p class="noindent" >Cross-engine updates noted above.</p></li></ul>
8239 <!--l. 4510--><p class="noindent" >MetaPost: </p>
8240 <ul class="itemize1">
8241 <li class="itemize">
8242 <!--l. 4511--><p class="noindent" ><span
8243 class="ec-lmtt-12">mp_number_to_scaled</span>
8244 returns
8245 a
8246 64-bit
8247 signed
8248 integer
8249 instead
8250 of
8251 the
8252 system-dependent
8253 <span
8254 class="ec-lmtt-12">int</span>.
8255 Internally,
8256 start
8257 on
8258 replacing
8259 <span
8260 class="ec-lmtt-12">int</span>
8261 with
8262 <span
8263 class="ec-lmtt-12">int64_t</span>
8264 in
8265
8266
8267 general.
8268 </p></li>
8269 <li class="itemize">
8270 <!--l. 4514--><p class="noindent" ><span
8271 class="ec-lmtt-12">mp_hard_times</span>
8272 fixed.
8273 </p></li>
8274 <li class="itemize">
8275 <!--l. 4515--><p class="noindent" >Fixes
8276 for
8277 <span
8278 class="ec-lmtt-12">weave</span>.
8279 </p></li>
8280 <li class="itemize">
8281 <!--l. 4516--><p class="noindent" >Help
8282 message
8283 reorganized
8284 and
8285 updated
8286 for
8287 consistency.</p></li></ul>
8288 <!--l. 4519--><p class="noindent" >pdfTeX: </p>
8289 <ul class="itemize1">
8290 <li class="itemize">
8291 <!--l. 4520--><p class="noindent" >Don’t complain about PDF minor version <span
8292 class="lmsy-10x-x-120">≤</span><span
8293 class="rm-lmr-12">2 </span>unless major version <span
8294 class="rm-lmr-12">= 1</span>.
8295 </p></li>
8296 <li class="itemize">
8297 <!--l. 4521--><p class="noindent" >Don’t erroneously shift fraction denominators or other text if <span
8298 class="ec-lmtt-12">\pdfpageheight </span>is
8299 used.
8300 </p></li>
8301 <li class="itemize">
8302 <!--l. 4523--><p class="noindent" >Fix overlapping text in <span
8303 class="ec-lmtt-12">ptmr8r </span>and other fonts.
8304 </p></li>
8305 <li class="itemize">
8306 <!--l. 4524--><p class="noindent" >If the environment variable <span
8307 class="ec-lmtt-12">TEXMF_DEBUG_PNG_COPY </span>is set to 1, report attributes
8308 of each PNG image and whether it was copied.
8309 </p></li>
8310 <li class="itemize">
8311 <!--l. 4526--><p class="noindent" >Cross-engine updates noted above.</p></li></ul>
8312 <!--l. 4529--><p class="noindent" >epTeX, eupTeX: </p>
8313 <ul class="itemize1">
8314 <li class="itemize">
8315 <!--l. 4530--><p class="noindent" >Cross-engine updates noted above.</p></li></ul>
8316 <!--l. 4533--><p class="noindent" >XeTeX: </p>
8317 <ul class="itemize1">
8318
8319
8320 <li class="itemize">
8321 <!--l. 4534--><p class="noindent" >Cross-engine updates noted above.</p></li></ul>
8322 <!--l. 4537--><p class="noindent" >Dvipdfmx: </p>
8323 <ul class="itemize1">
8324 <li class="itemize">
8325 <!--l. 4538--><p class="noindent" >Option <span
8326 class="ec-lmtt-12">-o - </span>to send output to stdout reenabled, after being unintentionally
8327 disabled for several years.</p></li></ul>
8328 <!--l. 4542--><p class="noindent" >CWEB: </p>
8329 <ul class="itemize1">
8330 <li class="itemize">
8331 <!--l. 4543--><p class="noindent" >All CWEB programs work <span
8332 class="ec-lmtt-12">–verbose</span>ly by default again.
8333 </p></li>
8334 <li class="itemize">
8335 <!--l. 4544--><p class="noindent" >All CWEB programs no longer fail in case of warning messages.
8336 </p></li>
8337 <li class="itemize">
8338 <!--l. 4545--><p class="noindent" ><span
8339 class="ec-lmtt-12">ctangle </span>produces far less whitespace in preprocessor macros.
8340 </p></li>
8341 <li class="itemize">
8342 <!--l. 4546--><p class="noindent" ><span
8343 class="ec-lmtt-12">ctwill-proofsort </span>supports multiple definitions for the same identifier.</p></li></ul>
8344 <!--l. 4553--><p class="noindent" >Upmendex: </p>
8345 <ul class="itemize1">
8346 <li class="itemize">
8347 <!--l. 4554--><p class="noindent" >Experimental support for Brahmic scripts (Bengali, Gurmukhi, Gujarati, Kannada,
8348 Lao, Malayalam, Oriya, Sinhala, Tamil, Telugu).</p></li></ul>
8349 <!--l. 4558--><p class="noindent" >Kpathsea: </p>
8350 <ul class="itemize1">
8351 <li class="itemize">
8352 <!--l. 4559--><p class="noindent" >New
8353 configuration
8354 value
8355 <span
8356 class="ec-lmtt-12">texmf_nlink_for_leaf</span>
8357 to
8358 specify
8359 whether
8360 the
8361 <span
8362 class="ec-lmtt-12">st_nlink=2</span>
8363 check
8364 is
8365 made
8366 to
8367 decide
8368 whether
8369 we’re
8370 in
8371
8372
8373 a
8374 leaf
8375 directory;
8376 in
8377 the
8378 default
8379 <span
8380 class="ec-lmtt-12">texmf.cnf</span>,
8381 the
8382 check
8383 is
8384 now
8385 disabled.
8386 </p></li>
8387 <li class="itemize">
8388 <!--l. 4564--><p class="noindent" >The
8389 configuration
8390 value
8391 <span
8392 class="ec-lmtt-12">openin_any</span>
8393 no
8394 longer
8395 has
8396 any
8397 effect;
8398 the
8399 interface
8400 functions
8401 are
8402 still
8403 compiled
8404 into
8405 the
8406 library,
8407 but
8408 now
8409 consider
8410 any
8411 filename
8412 to
8413 be
8414 ok
8415 for
8416 reading.
8417 To
8418 the
8419 best
8420 of
8421
8422
8423 anyone’s
8424 knowledge,
8425 no
8426 value
8427 but
8428 ‘<span
8429 class="ec-lmtt-12">a</span>’
8430 was
8431 ever
8432 useful
8433 (or
8434 used).</p></li></ul>
8435 <!--l. 4570--><p class="noindent" ><span
8436 class="ec-lmtt-12">tlmgr</span>: </p>
8437 <ul class="itemize1">
8438 <li class="itemize">
8439 <!--l. 4571--><p class="noindent" >Check for backup container creation failure.
8440 </p></li>
8441 <li class="itemize">
8442 <!--l. 4572--><p class="noindent" >In <span
8443 class="ec-lmtt-12">–usermode</span>, do not warn about the <span
8444 class="ec-lmtt-12">texlive-scripts </span>package being missing.</p></li></ul>
8445 <!--l. 4576--><p class="noindent" >Other programs: </p>
8446 <ul class="itemize1">
8447 <li class="itemize">
8448 <!--l. 4577--><p class="noindent" ><span
8449 class="ec-lmtt-12">fmtutil, updmap</span>: make self-locating as with <span
8450 class="ec-lmtt-12">tlmgr</span>.
8451 </p></li>
8452 <li class="itemize">
8453 <!--l. 4578--><p class="noindent" >New program <span
8454 class="ec-lmtt-12">xdvipsk</span>, an extended <span
8455 class="ec-lmtt-12">dvips </span>with support for more image formats
8456 and (with LuaTeX) OpenType and TrueType fonts. See the article by Sigitas
8457 Tolusis in <span
8458 class="ec-lmro-12">TUGboat</span>, <a
8459 href="https://tug.org/TUGboat/tb38-2/tb119tolusis.pdf" class="url" ><span
8460 class="ec-lmtt-12">https://tug.org/TUGboat/tb38-2/tb119tolusis.pdf</span></a>.
8461 </p></li>
8462 <li class="itemize">
8463 <!--l. 4582--><p class="noindent" >Many man pages substantially updated.</p></li></ul>
8464 <!--l. 4585--><p class="noindent" >Platforms: </p>
8465 <ul class="itemize1">
8466 <li class="itemize">
8467 <!--l. 4586--><p class="noindent" >See MacTeX note just below.
8468 </p></li>
8469 <li class="itemize">
8470 <!--l. 4587--><p class="noindent" >The <span
8471 class="ec-lmtt-12">i386-linux</span>, <span
8472 class="ec-lmtt-12">aarch64-linux</span>, and <span
8473 class="ec-lmtt-12">armhf-linux </span>binaries are now built on
8474 Debian bullseye (initially released 2021).</p></li></ul>
8475 <!--l. 4592--><p class="noindent" >MacTeX: MacTeX-2026 now supports Big Sur (2020, macOS 11) and higher, on both Intel
8476 and Arm. Support for Mojave (2018) and Catalina (2019, macOS 10) has been dropped.
8477 It installs: </p>
8478 <ul class="itemize1">
8479 <li class="itemize">
8480 <!--l. 4597--><p class="noindent" >TeX Live 2026;
8481 </p></li>
8482 <li class="itemize">
8483
8484
8485 <!--l. 4598--><p class="noindent" >Ghostscript-10.06.0;
8486 </p></li>
8487 <li class="itemize">
8488 <!--l. 4599--><p class="noindent" >TeXShop, including a special version supporting Liquid Glass;
8489 </p></li>
8490 <li class="itemize">
8491 <!--l. 4600--><p class="noindent" >LaTeXiT, BibDesk, HintView.</p></li></ul>
8492 <!--l. 4603--><p class="indent" > The companion small BasicTeX distribution for Macs (download size about 120MB,
8493 <a
8494 href="https://tug.org/mactex/morepackages.html" class="url" ><span
8495 class="ec-lmtt-12">https://tug.org/mactex/morepackages.html</span></a>) now includes all core packages for tagging
8496 support, the LaTeX <span
8497 class="ec-lmtt-12">-dev </span>engines for testing, and <span
8498 class="ec-lmtt-12">tex4ht</span>. Those who would like to install this
8499 on other platforms can use <span
8500 class="ec-lmtt-12">scheme-small</span>. BasicTeX supports all three main typesetting
8501 engines: pdfLaTeX, XeLaTeX, and LuaLaTeX.
8502 </p><!--l. 4613--><p class="noindent" >Finally: many thanks to Siep Kroonenberg for her work on TeX Live, especially Windows
8503 support, for many years. She has retired and is moving on to other projects. Thanks again
8504 Siep, and best wishes!
8505
8506 </p>
8507 <h4 class="subsectionHead"><span class="titlemark">9.3 </span> <a
8508 id="x1-950009.3"></a>Future</h4>
8509 <!--l. 4620--><p class="noindent" >We intend to continue to release new versions of TeX Live, and would like to provide more
8510 documentation, more programs, an ever-improved and better-checked tree of macros and fonts,
8511 and anything else TeX. This work is all done by volunteers in their spare time, and there is
8512 always more to do. Please see <a
8513 href="https://tug.org/texlive/contribute.html" class="url" ><span
8514 class="ec-lmtt-12">https://tug.org/texlive/contribute.html</span></a>.
8515 </p><!--l. 4626--><p class="indent" > Please send corrections, suggestions, and offers of help to:
8516 </p><blockquote class="quote">
8517
8518 <!--l. 4628--><p class="noindent" ><a
8519 href="mailto:[email protected]" ><span class="path"><span
8520 class="ec-lmtt-12">[email protected]</span></span></a> <span
8521 class="ec-lmr-10x-x-109">(public mailing list, you need not subscribe in order to</span>
8522 <span
8523 class="ec-lmr-10x-x-109">post)</span><br
8524 class="newline" /><a
8525 href="https://tug.org/texlive" class="url" ><span
8526 class="ec-lmtt-12">https://tug.org/texlive</span></a></p></blockquote>
8527 <!--l. 4634--><p class="noindent" ><span
8528 class="ec-lmro-12">Happy TeXing!</span>
8529 </p>
8530
8531 </body>
8532 </html>
8533
8534
8535