Debian Codegraph @

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

raw
1 % $Id: texlive-en.tex 78419 2026-03-18 11:19:15Z mseven $
2 % TeX Live documentation. Originally written by Sebastian Rahtz and
3 % Michel Goossens, now maintained by Karl Berry and others.
4 % Public domain.
5 %
6 \documentclass[12pt]{article}
7 \let\tldocenglish=1 % for live4ht.cfg
8 \usepackage{tex-live}
9 %\usepackage[latin1]{inputenc} % translators: use your preferred encodings.
10 \usepackage[T1]{fontenc} % causes typewriter "--", etc., to be a ligature
11 \usepackage{microtype} % nicer output, and also allows us to do:
12 \DisableLigatures{family=tt*} % no ligatures in tt
13
14 \title{%
15 {\huge \textit{The \TeX\ Live Guide---2026}}
16 }
17
18 \author{Karl Berry, editor \\[3mm]
19 \url{https://tug.org/texlive/}
20 }
21
22 \date{21 February 2026}
23
24 \begin{document}
25 \maketitle
26
27 \begin{multicols}{2}
28 \tableofcontents
29 %\listoftables
30 \end{multicols}
31
32 \section{Introduction}
33 \label{sec:intro}
34
35 \subsection{\protect\TeX\protect\ Live}
36
37 This document describes the main features of the \TL{} software
38 distribution\Dash \TeX{} and related programs for \GNU/Linux and other
39 Unix flavors, \macOS, and Windows systems. You may have acquired \TL{}
40 by downloading, or on a \DVD, or in some other way.
41
42 \TL{} includes executables for \TeX{}, \LaTeXe{}, \ConTeXt,
43 \MF, \MP, \BibTeX{} and many other programs; an extensive collection
44 of macros, fonts and documentation; and support for typesetting in
45 many different scripts from around the world.
46
47 For a brief summary of the major changes in this edition of \TL{},
48 see the end of the document, section~\ref{sec:history}
49 (\p.\pageref{sec:history}).
50
51
52 \htmlanchor{platforms}
53 \subsection{Operating system support}
54 \label{sec:os-support}
55
56 \TL{} contains binaries for many Unix-based platforms, including
57 \GNU/Linux, \macOS, and Cygwin. The included sources can be compiled
58 on platforms for which we do not provide binaries.
59
60 As to Windows: Windows~10 and later are supported. Windows 7 and Vista
61 \emph{may} still mostly work, but \TL{} will no longer even install
62 on Windows XP or earlier. \TL{} includes 64-bit executables for
63 Windows.
64
65
66 \subsection{Basic installation of \protect\TL{}}
67 \label{sec:basic}
68
69 You can install \TL{} either from \DVD{} (or an \ISO\ image) or over the
70 Internet (\url{https://tug.org/texlive/acquire.html}). The net installer
71 itself is small, and downloads everything requested from the Internet.
72
73 You can prepare a runnable installation on, e.g., a \USB{} stick (see
74 section~\ref{sec:portable-tl}). Installation is described in detail in
75 later sections (\p.\pageref{sec:install}), but here is a quick start:
76
77 \begin{itemize*}
78
79 \item For Unix, the installation script is \filename{install-tl}; on
80 Windows, one should instead invoke \filename{install-tl-windows}.
81 The installer will operate in a graphical mode given the option
82 \code{-gui} (default for Windows), or a text mode given
83 the option \code{-gui=text} (default for everything else).
84
85 \item One of the installed items is the `\TL\ Manager' program,
86 named \prog{tlmgr}. Like the installer, it can be used in both \GUI{}
87 mode and in text mode. You can use it to install and uninstall
88 packages and do various configuration tasks.
89
90 \end{itemize*}
91
92
93 \htmlanchor{security}
94 \subsection{Security considerations}
95 \label{sec:security}
96
97 To the best of our knowledge, the core \TeX\ programs themselves are
98 (and always have been) extremely robust. However, the contributed
99 programs in \TL\ may not reach the same level, despite everyone's
100 best efforts. As always, you should be careful when running programs on
101 untrusted input; to improve safety, use a new subdirectory or chroot.
102
103 This need for care is especially urgent on Windows, since in general
104 Windows finds programs in the current directory before anything else,
105 regardless of the search path. This opens up a wide variety of possible
106 attacks. We have closed many holes, but undoubtedly some remain,
107 especially with third-party programs. Thus, we recommend checking for
108 suspicious files in the current directory, especially executables
109 (binaries or scripts). Ordinarily they should not be present, and
110 definitely should not normally be created by merely processing a document.
111
112 Finally, \TeX\ (and its companion programs) are able to write files when
113 processing documents, a feature that can also be abused in a wide
114 variety of ways. Again, processing unknown documents in a new
115 subdirectory is the safest bet.
116
117 Another aspect of security is ensuring that downloaded material has not
118 been changed from what was created. The \prog{tlmgr} program
119 (section~\ref{sec:tlmgr}) will automatically perform cryptographic
120 verification on downloads if the \prog{gpg} (GNU Privacy Guard) program
121 is available. It is not distributed as part of \TL, but see
122 \url{https://texlive.info/tlgpg/} for information about \prog{gpg} if
123 need be.
124
125 \subsection{Getting help}
126 \label{sec:help}
127
128 The \TeX{} community is active and friendly, and most serious questions
129 end up getting answered. However, the support is informal, done by
130 volunteers and casual users, so it's especially important that you do
131 your homework before asking. (If you prefer guaranteed commercial
132 support, you can forgo \TL{} completely and purchase a vendor's system;
133 \url{https://tug.org/interest.html#vendors} has a list.)
134
135 Here is a list of resources, approximately in the order we recommend
136 using them:
137
138 \begin{description}
139 \item [Getting started] If you are new to \TeX, the web page
140 \url{https://tug.org/begin.html} gives a brief introduction to the system.
141
142 \item [CTAN] If you are looking for a particular package, font, program,
143 etc., \CTAN{} is the place to start looking. It is a huge collection of
144 all \TeX{}-related items. The catalog entries also tell you whether a
145 package is available for \TL{} or MiK\TeX. See \url{https://ctan.org}.
146
147 \item [\TeX{} FAQ] The \TeX{} FAQ is a compendium of answers to all
148 sorts of questions, from the most basic to the most arcane. It is
149 available on the Internet through \url{https://texfaq.org}.
150
151 \item [\TeX{} Web Resources] The web page
152 \url{https://tug.org/interest.html} has many \TeX{}-related links, in
153 particular for numerous books, manuals, and articles on all aspects of
154 the system.
155
156 \item [support sites] A general web search never hurts. Principal
157 support sites for \TeX\ include the \LaTeX{}
158 community site at \url{https://latex.org}, the q\&a site
159 \url{https://tex.stackexchange.com}, and the mailing list
160 \url{https://lists.tug.org/texhax}. Their archives have years of past
161 questions and answers for your searching pleasure.
162
163 \item [asking questions] If you cannot find an answer, you can post to
164 \url{http://latex.org/} and \url{https://tex.stackexchange.com/} through
165 their web interfaces, to \email{[email protected]} through email (it's not
166 necessary to subscribe in order to post). But before you post anywhere,
167 please read this FAQ entry, to maximize your chances of getting a useful
168 answer: \url{https://texfaq.org/FAQ-askquestion}.
169
170 \item [\TL{} support] If you want to report a bug or have
171 suggestions or comments on the \TL{} distribution, installation, or
172 documentation, the mailing list is \email{[email protected]}. However,
173 if your question is about how to use a particular program included in
174 \TL{}, please write to that program's maintainer or
175 mailing list. Often running a program with the \code{-{}-help} option
176 will provide a bug reporting address.
177
178 \end{description}
179
180 The other side of the coin is helping others who have questions. All
181 the above resources are open to anyone, so feel free to join, start
182 reading, and help out where you can.
183
184
185 % don't use \TL so the \uppercase in the headline works. Also so
186 % tex4ht ends up with the right TeX. Likewise the \protect's.
187 \section{Overview of \protect\TeX\protect\ Live}
188 \label{sec:overview-tl}
189
190 \subsection{Top level \protect\TL{} directories}
191 \label{sec:tld}
192
193 Here is a brief listing and description of the top level directories in a
194 \TL{} installation.
195
196 \begin{ttdescription}
197 \item[bin] The \TeX{} system programs, arranged by platform.
198 %
199 \item[readme-*.dir] Quick overview and useful links for \TL{},
200 in various languages, in both \HTML{} and plain text.
201 %
202 \item[source] The source to all included programs, including the main
203 \Webc{}-based \TeX{} distributions.
204 %
205 \item[texmf-dist] The principal tree; see \dirname{TEXMFDIST} below.
206 %
207 \item[tlpkg] Scripts, programs and data for managing the
208 installation, and special support for Windows.
209 \end{ttdescription}
210
211 For documentation, the comprehensive links in the top-level file
212 \OnCD{doc.html} may be helpful. The documentation for nearly everything
213 (packages, formats, fonts, program manuals, man pages, Info files) is in
214 \dirname{texmf-dist/doc}. You can use the \cmdname{texdoc} program to
215 find documentation wherever it is located.
216
217 This \TL\ documentation itself is in \dirname{texmf-dist/doc/texlive},
218 available in several languages:
219
220 \begin{itemize*}
221 \item{Czech/Slovak:} \OnCD{texmf-dist/doc/texlive/texlive-cz}
222 \item{German:} \OnCD{texmf-dist/doc/texlive/texlive-de}
223 \item{English:} \OnCD{texmf-dist/doc/texlive/texlive-en}
224 \item{French:} \OnCD{texmf-dist/doc/texlive/texlive-fr}
225 \item{Italian:} \OnCD{texmf-dist/doc/texlive/texlive-it}
226 \item{Japanese:} \OnCD{texmf-dist/doc/texlive/texlive-ja}
227 \item{Polish:} \OnCD{texmf-dist/doc/texlive/texlive-pl}
228 \item{Russian:} \OnCD{texmf-dist/doc/texlive/texlive-ru}
229 \item{Serbian:} \OnCD{texmf-dist/doc/texlive/texlive-sr}
230 \item{Spanish:} \OnCD{texmf-dist/doc/texlive/texlive-es}
231 \item{Simplified Chinese:} \OnCD{texmf-dist/doc/texlive/texlive-zh-cn}
232 \end{itemize*}
233
234 \subsection{The predefined texmf trees}
235 \label{sec:texmftrees}
236
237 This section lists the predefined variables specifying the texmf trees
238 used by the system, and their intended purpose, and the default layout
239 of \TL{}. The command \texttt{tlmgr~conf} shows the values of these
240 variables, so that you can easily find out how they map to particular
241 directories in your installation.
242
243 All of the trees, including the personal ones, should follow the \TeX\
244 Directory Structure (\TDS, \url{https://tug.org/tds}), with all its
245 myriad subdirectories, or files may not be found. Section
246 \ref{sec:local-personal-macros} (\p.\pageref{sec:local-personal-macros})
247 describes this in more detail. The order here is the reverse order in
248 which the trees are searched, that is, later trees in the list override
249 earlier ones.
250
251 \begin{ttdescription}
252 \item [TEXMFDIST] The tree which holds nearly all of the files in the original
253 distribution---configuration files, scripts, packages, fonts, etc.
254 (The main exceptions are the per-platform executables, which are stored
255 in a sibling directory \code{bin/}.)
256 \item [TEXMFSYSVAR] The (site-wide) tree used by \verb+texconfig-sys+,
257 \verb+updmap-sys+, \verb+fmtutil-sys+, and \verb+tlmgr+, to store
258 (cached) runtime data such as format files and generated map files.
259 \item [TEXMFSYSCONFIG] The (site-wide) tree used by
260 \verb+texconfig-sys+, \verb+updmap-sys+, and \verb+fmtutil-sys+ to
261 store modified configuration data.
262 \item [TEXMFLOCAL] The tree which administrators can use for system-wide
263 installation of additional or updated macros, fonts, etc.
264 \item [TEXMFHOME] The tree which users can use for their own individual
265 installations of additional or updated macros, fonts, etc.
266 For each user, this variable points to
267 their own individual directory.
268 \item [TEXMFVAR] The (personal) tree used by \verb+texconfig+,
269 \verb+updmap-user+ and \verb+fmtutil-user+ to store (cached) runtime data such
270 as format files and generated map files.
271 \item [TEXMFCONFIG] The (personal) tree used by the utilities
272 \verb+texconfig+, \verb+updmap-user+, and \verb+fmtutil-user+ to store modified
273 configuration data.
274 \item [TEXMFCACHE] The tree(s) used by \ConTeXt\ MkIV and Lua\LaTeX\
275 to store (cached) runtime data; defaults to \code{TEXMFSYSVAR},
276 or (if that's not writable), \code{TEXMFVAR}.
277 \end{ttdescription}
278
279 \noindent
280 The default layout is:
281 \begin{description}
282 \item[system-wide root] can span multiple \TL{} releases
283 (\texttt{/usr/local/texlive} by default on Unix):
284 \begin{ttdescription}
285 \item[2025] A previous release.
286 \item[2026] The current release.
287 \begin{ttdescription}
288 \item [bin] ~
289 \begin{ttdescription}
290 \item [i386-linux] \GNU/Linux binaries (32-bit)
291 \item [...]
292 \item [universal-darwin] \macOS\ binaries
293 \item [x86\_64-linux] \GNU/Linux binaries (64-bit)
294 \item [windows] Windows binaries (64-bit)
295 \end{ttdescription}
296 \item [texmf-dist\ \ ] \envname{TEXMFDIST} and \envname{TEXMFMAIN}
297 \item [texmf-var \ \ ] \envname{TEXMFSYSVAR}, \envname{TEXMFCACHE}
298 \item [texmf-config] \envname{TEXMFSYSCONFIG}
299 \end{ttdescription}
300 \item [texmf-local] \envname{TEXMFLOCAL}, intended to be
301 retained from release to release.
302 \end{ttdescription}
303 \item[user's home directory] (\texttt{\$HOME} or
304 \texttt{\%USERPROFILE\%})
305 \begin{ttdescription}
306 \item[.texlive2025] Privately generated and configuration data
307 for a previous release.
308 \item[.texlive2026] Privately generated and configuration data
309 for the current release.
310 \begin{ttdescription}
311 \item [texmf-var\ \ \ ] \envname{TEXMFVAR}, \envname{TEXMFCACHE}
312 \item [texmf-config] \envname{TEXMFCONFIG}
313 \end{ttdescription}
314 \item[texmf] \envname{TEXMFHOME} Personal macros, etc.
315 \end{ttdescription}
316 \end{description}
317
318
319 \subsection{Extensions to \protect\TeX}
320 \label{sec:tex-extensions}
321
322 Knuth's original \TeX{} itself is frozen, apart from rare bug fixes. It
323 is present in \TL\ as the program \prog{tex}, and will remain so
324 for the foreseeable future. \TL{} also contains several extended versions of
325 \TeX\ (also known as \TeX\ engines), all derived from the original program.
326
327 \begin{description}
328
329 \item [\eTeX] adds a set of new primitives
330 \label{text:etex} (related to macro expansion, character scanning,
331 classes of marks, additional debugging features, and more) and the
332 \TeXXeT{} extensions for bidirectional typesetting. In default mode,
333 \eTeX{} is 100\% compatible with ordinary \TeX. See
334 \OnCD{texmf-dist/doc/etex/base/etex_man.pdf}.
335
336 \item [pdf\TeX] builds on the \eTeX\ extensions, adding support for
337 writing PDF output as well as \dvi{}, and many non-output-related
338 extensions. This is the program invoked for many common formats, e.g.,
339 \prog{etex}, \prog{latex}, \prog{pdflatex}. Its web site is
340 \url{https://pdftex.org/}. See
341 \OnCD{texmf-dist/doc/pdftex/manual/pdftex-a.pdf} for the manual, and
342 \OnCD{texmf-dist/doc/pdftex/samplepdftex/samplepdf.tex} for example
343 usage of some of its features.
344
345 \item [Lua\TeX] adds support for Unicode input and OpenType\slash
346 TrueType- and system fonts. It also incorporates MetaPost as a library
347 for fast generation of graphics. Most of all, it includes a Lua interpreter
348 (\url{https://lua.org/}), enabling solutions for many thorny \TeX{}
349 problems. When called as \filename{texlua}, it functions as a standalone
350 Lua interpreter. Its web site is \url{https://www.luatex.org/}, and the
351 reference manual is \OnCD{texmf-dist/doc/luatex/base/luatex.pdf}.
352
353 \item [LuaMeta\TeX] is a descendant of Lua\TeX, and is the default
354 engine for \ConTeXt. Most features are implemented in Lua to enable
355 maximum flexibility, including all font handling and backend output.
356 See \url{https://ctan.org/pkg/context}; the reference manual is
357 \OnCD{texmf-dist/doc/luametatex/base/luametatex.pdf}.
358
359 \item [\XeTeX] adds support for Unicode input and OpenType\slash
360 TrueType- and system fonts, implemented using standard third-party
361 libraries. See \url{https://tug.org/xetex}.
362
363 \item [Hi\TeX] outputs its own HINT format, designed for mobile devices.
364 See \url{https://ctan.org/pkg/hitex}.
365
366 \item [(e)(u)p\TeX] provide native support for Japanese typesetting
367 requirements; p\TeX\ is the basic engine, while the `e-' variants add
368 \eTeX\ functionality and `u-' add Unicode support.
369
370 \item [\OMEGA\ (Omega)] is the original engine supporting Unicode,
371 written in the 1990s. supports working with almost all the world's
372 scripts simultaneously. It also supports so-called `\OMEGA{} Translation
373 Processes' (OTPs), for performing complex transformations on arbitrary
374 input. Omega is no longer included in \TL{} as a separate program; only
375 Aleph is provided:
376
377 \item [Aleph] combines the \OMEGA\ and \eTeX\ extensions.
378 See \OnCD{texmf-dist/doc/aleph/base}.
379
380 \end{description}
381
382 For more information about the capabilities and histories of the
383 different engines and the formats built with them, see the article
384 ``Overview of \TeX\ engines and formats'',
385 \url{https://tug.org/TUGboat/tb46-3/tb144berry-engines-formats.pdf}.
386 For a brief comparison of engines vs.\ formats vs.\ packages, see the
387 web page \url{https://tug.org/levels}.
388
389 \subsection{Other notable programs in \protect\TL}
390
391 Here are a few other commonly-used programs included in \TL{}:
392
393 \begin{cmddescription}
394
395 \item [bibtex, biber] bibliography support.
396
397 \item [makeindex, upmendex, xindex, xindy] index support.
398
399 \item [dvips] convert \dvi{} to \PS{}.
400
401 \item [dvipdfmx] convert \dvi{} to PDF, an alternative approach
402 to pdf\TeX\ (mentioned above).
403
404 \item [xdvi] \dvi{} previewer for the X Window System.
405
406 \item [dviconcat, dviselect] cut and paste pages
407 from \dvi{} files.
408
409 \item [psselect, psnup, \ldots] \PS{} utilities.
410
411 \item [pdfjam, pdfjoin, \ldots] PDF utilities.
412
413 \item [context, mtxrun] \ConTeXt\ and PDF processor.
414
415 \item [htlatex, \ldots] \cmdname{tex4ht}: \AllTeX{} to HTML (and
416 XML and DocX and more) converter.
417
418 \end{cmddescription}
419
420
421 \htmlanchor{installation}
422 \section{Installation}
423 \label{sec:install}
424
425 \subsection{Starting the installer}
426 \label{sec:inst-start}
427
428 To begin, the most common method is to download the \TL{} net installer.
429 See \url{https://tug.org/texlive/acquire.html} for more information and
430 other methods of getting the software.
431
432 \begin{description}
433 \item [Net installer, .zip or .tar.gz:] Download the archive from \CTAN,
434 under \dirname{systems/texlive/tlnet}; the url
435 \url{https://mirror.ctan.org/systems/texlive/tlnet} should redirect to a
436 nearby, up-to-date, mirror. You can retrieve either
437 \filename{install-tl.zip} which can be used under Unix and Windows, or
438 the considerably smaller \filename{install-unx.tar.gz} for Unix
439 only. After unpacking, \filename{install-tl} and
440 \filename{install-tl-windows.bat} will be in the
441 subdirectory \dirname{install-tl-yyyymmdd}, where yyyymmdd
442 represents the date when the installer was generated.
443
444 \item[Net installer, Windows .exe:] Download from \CTAN{} as above,
445 and double-click. This starts up a first-stage installer and unpacker;
446 see figure~\ref{fig:nsis}. It gives two choices: `Install'
447 and `Unpack only'.
448
449 \item[\DVD\ or \ISO\ image] The unpacking will already be done, so you just
450 run \filename{install-tl} as described below.
451
452 \end{description}
453
454 \begin{figure}[tb]
455 \def\figdesc{First stage of Windows \code{.exe} installer}
456 \tlpng{nsis_installer}{.6\linewidth}{\figdesc}
457 \caption{\figdesc. Pressing the Install button will give you the
458 window displayed in figure~\ref{fig:basic-w32}.}\label{fig:nsis}
459 \end{figure}
460
461 If you need to download through proxies, use a \filename{~/.wgetrc} file
462 or environment variables with the proxy settings for Wget
463 (\url{https://www.gnu.org/software/wget/manual/html_node/Proxies.html}),
464 or the equivalent for whatever download program you are using. This does
465 not matter if you are installing from the \DVD\ or \ISO\ image.
466
467 By default, the installer uses compression and download programs as
468 found in \code{PATH}. (Exception: on Windows, the tar.exe shipped with
469 TL is always used, regardless of any setting.) If you get errors during
470 download or unpacking, such as \code{tar:\ Skipping to next file header},
471 you can try setting the environment variable \code{TEXLIVE\_PREFER\_OWN}
472 to \code{1} to use \TL-provided programs instead. You can also
473 explicitly specify the programs and/or options to use with other
474 environment variables. The \code{tlmgr} documentation gives the details:
475 \url{https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES}.
476
477 The following sections explain installer start-up in more detail.
478
479 \subsubsection{Unix}
480
481 Below, \texttt{>} denotes the shell prompt; user input is
482 \Ucom{\texttt{bold}}.
483 The \filename{install-tl} program is a Perl script. The simplest way
484 to start it on a Unix-compatible system is as follows:
485 \begin{alltt}
486 > \Ucom{perl /path/to/installer/install-tl}
487 \end{alltt}
488 (Or you can invoke \Ucom{/path/to/installer/install-tl} if it stayed
489 executable, or \texttt{cd} to the directory first, etc.; we won't repeat
490 all the variations.) You may have to enlarge your terminal window so
491 that it shows the full text installer screen
492 (figure~\ref{fig:text-main}).
493
494 To install in \GUI\ mode (figure~\ref{fig:advanced-lnx}), you'll need to
495 have Tcl/Tk installed. Given that, you can run:
496 \begin{alltt}
497 > \Ucom{perl install-tl -gui}
498 \end{alltt}
499
500 The old \code{-wizard} and \code{-perltk}/\code{-expert} options
501 now do the same thing as \code{-gui}. For
502 a complete listing of the various options:
503 \begin{alltt}
504 > \Ucom{perl install-tl -help}
505 \end{alltt}
506
507 \textbf{About Unix permissions:} Your \code{umask} at the time
508 of installation will be respected by the \TL{} installer. Therefore, if
509 you want your installation to be usable by users other than you, make
510 sure your setting is sufficiently permissive, for instance, \code{umask
511 002}. For more information about \code{umask}, consult your system
512 documentation.
513
514 \textbf{Special considerations for Cygwin:} Unlike other
515 Unix-compatible systems, Cygwin does not by default include all of the
516 prerequisite programs needed by the \TL{} installer. See
517 section~\ref{sec:cygwin} for the packages which you need to install first.
518
519
520 \subsubsection{\macOS}
521 \label{sec:macosx}
522
523 A separate distribution is prepared for \macOS, named Mac\TeX\
524 (\url{https://tug.org/mactex}). We recommend using the native Mac\TeX\
525 installer instead of the \TL\ installer on \macOS, because the native
526 installer makes a few Mac-specific adjustments, in particular to allow
527 easily switching between different \TL\ releases on Macs, using the
528 so-called \TeX{}Dist data structure.
529
530 Mac\TeX\ is a superset of \TL, and the main \TeX\ trees and binaries
531 are precisely the same. It adds a few extra folders with Mac-specific
532 documentation and applications.
533
534
535 \subsubsection{Windows}\label{sec:wininst}
536
537 If you are using the unpacked downloaded zip file, or the \DVD\
538 installer failed to start automatically, double-click
539 \filename{install-tl-windows.bat}.
540
541 You can also start the installer from the command-prompt. Below,
542 \texttt{>} denotes the prompt; user input is \Ucom{\texttt{bold}}. If
543 you are in the installer directory, run just:
544 \begin{alltt}
545 > \Ucom{install-tl-windows}
546 \end{alltt}
547
548 Or you can invoke it with an absolute location, such as:
549 \begin{alltt}
550 > \Ucom{C:\bs{}tltemp\bs{}install-tl-windows}
551 \end{alltt}
552 Figure~\ref{fig:basic-w32} displays the initial basic screen of the
553 \GUI\ installer, which is the default for Windows.
554
555 To install in text mode, use:
556 \begin{alltt}
557 > \Ucom{install-tl-windows -no-gui}
558 \end{alltt}
559
560 For a complete listing of the various options:
561 \begin{alltt}
562 > \Ucom{install-tl-windows -help}
563 \end{alltt}
564
565 Add a \texttt{.bat} extension to the invocations if the same directory
566 also contains \texttt{install-tl-windows.exe}. This will not
567 normally be the case, unless you've mirrored the \dirname{tlnet} directory
568 locally.
569
570 Non-ASCII characters in the path for the \TL\ installation must be
571 avoided. This may be a problem particularly under Windows 11, where
572 users are forced to create a Microsoft network account upon
573 installation of Windows. See
574 \url{https://tug.org/texlive/windows.html\#nonascii} for some
575 workarounds.
576
577 \begin{figure}[tb]
578 \begin{boxedverbatim}
579 Installing TeX Live 2026 from: ...
580 Platform: x86_64-linux => 'GNU/Linux on x86_64'
581 Distribution: inst (compressed)
582 Directory for temporary files: /tmp
583 ...
584 Detected platform: GNU/Linux on Intel x86_64
585
586 <B> binary platforms: 1 out of 15
587
588 <S> set installation scheme: scheme-full
589
590 <C> customizing installation collections
591 40 collections out of 41, disk space required: 9402 MB (free: 138718 MB)
592
593 <D> directories:
594 TEXDIR (the main TeX directory):
595 /usr/local/texlive/2026
596 ...
597
598 <O> options:
599 [ ] use letter size instead of A4 by default
600 ...
601
602 <V> set up for portable installation
603
604 Actions:
605 <I> start installation to hard disk
606 <P> save installation profile to 'texlive.profile' and exit
607 <H> help
608 <Q> quit
609 \end{boxedverbatim}
610 \vskip-.5\baselineskip
611 \caption{Main text installer screen (\GNU/Linux)}\label{fig:text-main}
612 \end{figure}
613
614 \begin{figure}[tb]
615 \tlpng{basic-w32}{.6\linewidth}{Basic installer screen (Windows)}
616 \caption{Basic installer screen (Windows); the Advanced button will
617 result in something like figure~\ref{fig:advanced-lnx}}\label{fig:basic-w32}
618 \end{figure}
619
620 \begin{figure}[tb]
621 \tlpng{advanced-lnx}{\linewidth}{Advanced installer screen (\GNU/Linux)}
622 \caption{Advanced \GUI{} installer screen
623 (\GNU/Linux)}\label{fig:advanced-lnx}
624 \end{figure}
625
626
627 \htmlanchor{cygwin}
628 \subsubsection{Cygwin}
629 \label{sec:cygwin}
630
631 Before beginning the installation, use Cygwin's \filename{setup.exe}
632 program to install the \filename{perl} and either \filename{curl} or
633 \filename{wget} packages if you have not already done so. The following
634 additional packages are recommended:
635 \begin{itemize*}
636 \item \filename{fontconfig} [needed by \XeTeX\ and Lua\TeX]
637 \item \filename{ghostscript} [needed by various utilities]
638 \item \filename{libXaw7} [needed by \code{xdvi}]
639 \item \filename{ncurses} [provides the \code{clear} command used by the installer]
640 \end{itemize*}
641
642
643 \subsubsection{The text installer}
644
645 Figure~\ref{fig:text-main} displays the main text mode screen under
646 Unix. The text installer is the default on Unix.
647
648 This is only a command-line installer; there is no cursor support at
649 all. For instance, you cannot tab around checkboxes or input fields.
650 You just type something (case-sensitive) at the prompt and press the
651 Enter key, and then the entire terminal screen will be rewritten, with
652 adjusted content.
653
654 The text installer interface is this primitive in order to make it run
655 on as many platforms as possible, even with a minimal Perl.
656
657 \subsubsection{The graphical installer}
658 \label{sec:graphical-inst}
659
660 The default graphical installer starts out simple, with just a
661 few options; see figure~\ref{fig:basic-w32}. It can be started with
662 \begin{alltt}
663 > \Ucom{install-tl -gui}
664 \end{alltt}
665 The Advanced button gives access to most of the options of the text
666 installer; see figure~\ref{fig:advanced-lnx}.
667
668 The \texttt{perltk}/\texttt{expert} and \texttt{wizard} \GUI{}
669 options now invoke the regular graphical installer.
670
671 \subsection{Running the installer}
672 \label{sec:runinstall}
673
674 The installer is intended to be mostly self-explanatory, but following are a
675 few notes about the various options and submenus.
676
677 \subsubsection{Binary systems menu (Unix only)}
678 \label{sec:binary}
679
680 \begin{figure}[tb]
681 \begin{boxedverbatim}
682 Available platforms:
683 ===============================================================================
684 a [ ] Cygwin on x86_64 (x86_64-cygwin)
685 b [ ] macOS current (11-) on ARM/x86_64 (universal-darwin)
686 c [ ] MacOSX legacy (10.6-) on x86_64 (x86_64-darwinlegacy)
687 d [ ] FreeBSD on x86_64 (amd64-freebsd)
688 e [ ] FreeBSD on Intel x86 (i386-freebsd)
689 f [ ] GNU/Linux on ARM64 (aarch64-linux)
690 g [ ] GNU/Linux on RPi(32-bit) and ARMv7 (armhf-linux)
691 h [ ] GNU/Linux on Intel x86 (i386-linux)
692 i [X] GNU/Linux on x86_64 (x86_64-linux)
693 j [ ] GNU/Linux on x86_64 with musl (x86_64-linuxmusl)
694 k [ ] NetBSD on x86_64 (amd64-netbsd)
695 l [ ] NetBSD on Intel x86 (i386-netbsd)
696 m [ ] Solaris on Intel x86 (i386-solaris)
697 o [ ] Solaris on x86_64 (x86_64-solaris)
698 p [ ] Windows (64-bit) (windows)
699 \end{boxedverbatim}
700 \vskip-.5\baselineskip
701 \caption{Binaries menu}\label{fig:bin-text}
702 \end{figure}
703
704 Figure~\ref{fig:bin-text} displays the text mode binaries menu. By
705 default, only the binaries for your current platform will be installed.
706 From this menu, you can select installation of binaries for other
707 platforms as well. This can be useful if you are sharing a \TeX\
708 tree across a network of heterogeneous machines, or for a dual-boot
709 system.
710
711 \subsubsection{Selecting what is to be installed}
712 \label{sec:components}
713
714 \begin{figure}[tbh]
715 \begin{boxedverbatim}
716 Select scheme:
717 ===============================================================================
718 a [X] full scheme (everything)
719 b [ ] medium scheme (small + more packages and languages)
720 c [ ] small scheme (basic + xetex, metapost, a few languages)
721 d [ ] basic scheme (plain and latex)
722 e [ ] minimal scheme (plain only)
723 f [ ] infrastructure-only scheme (no TeX at all)
724 g [ ] book publishing scheme (core LaTeX and add-ons)
725 h [ ] ConTeXt scheme
726 i [ ] GUST TeX Live scheme
727 j [ ] teTeX scheme (more than medium, but nowhere near full)
728 k [ ] custom selection of collections
729 \end{boxedverbatim}
730 \vskip-.5\baselineskip
731 \caption{Scheme menu}\label{fig:scheme-text}
732 \end{figure}
733
734 Figure~\ref{fig:scheme-text} displays the \TL\ scheme menu; from here,
735 you choose a ``scheme'', which is an overall set of packages and collections.
736 The default \optname{full} scheme installs everything available. This is
737 recommended, but you can also choose the \optname{basic} scheme for
738 just plain and \LaTeX, \optname{small} for a few more programs
739 (equivalent to the so-called Basic\TeX\ installation of Mac\TeX),
740 \optname{minimal} for testing purposes, and \optname{medium} or
741 \optname{teTeX} to get something in between. There are also various
742 specialized and country-specific schemes.
743
744 \begin{figure}[tb]
745 \def\figdesc{Collections menu}
746 \centering \tlpng{stdcoll}{.7\linewidth}{\figdesc}
747 \caption{\figdesc}\label{fig:collections-gui}
748 \end{figure}
749
750 You can refine your scheme selection with the `collections' menu
751 (figure~\ref{fig:collections-gui}, shown in \GUI\ mode for a change).
752
753 Collections are one level more detailed than schemes\Dash in essence, a
754 scheme consists of several collections, a collection consists of one or
755 more packages, and a package (the lowest level grouping in \TL) contains
756 the actual \TeX\ macro files, font files, and so on.
757
758 If you want more control than the collection menus provide, you can use
759 the \TL\ Manager (\prog{tlmgr}) program after installation (see
760 section~\ref{sec:tlmgr}); using that, you can control the installation
761 at the package level.
762
763 \subsubsection{Directories}
764 \label{sec:directories}
765
766 The default layout is described in section~\ref{sec:texmftrees},
767 \p.\pageref{sec:texmftrees}. The default installation directory is
768 \dirname{/usr/local/texlive/2026} on Unix and
769 |C:\texlive\2026| on Windows. This arrangement enables
770 having many parallel \TL\ installations, such as one for each release
771 (typically by year, as here), and you can switch between them merely by
772 altering your search path.
773
774 That installation directory can be overridden by setting the so-called
775 \dirname{TEXDIR} in the installer. The \GUI\ screen for this and other
776 options is shown in figure~\ref{fig:advanced-lnx}. The most common reasons
777 to change it are either lacking enough disk space in that partition (the
778 full \TL\ needs several gigabytes), or lacking write permission for the
779 default location (you don't have to be root or administrator to install
780 \TL, but you do need write access to the target directory).
781
782 On Windows, you normally do not need to be an administrator to
783 create |C:\texlive\2026| (or, more generally,
784 |%SystemDrive%\texlive\2026|).
785
786 The installation directories can also be changed by setting a variety of
787 environment variables before running the installer (most likely,
788 \envname{TEXLIVE\_INSTALL\_PREFIX} or
789 \envname{TEXLIVE\_INSTALL\_TEXDIR}); see the documentation from
790 |install-tl --help| (available online at
791 \url{https://tug.org/texlive/doc/install-tl.html}) for the full list and
792 more details.
793
794 A reasonable alternative destination is a directory under your home,
795 especially if you will be the sole user. Use `|~|' to indicate this, as
796 in `|~/texlive/2026|'.
797
798 But do not use your home directory on Windows if the name of your home
799 or `userprofile' contains non-ASCII characters. We are looking into
800 possible solutions, but cannot promise anything at this point. See also
801 \url{https://tug.org/texlive/windows.html\#nonascii}.
802
803 We recommend including the year in the name, to enable keeping different
804 releases of \TL{} side by side. (You may wish to also maintain a
805 version-independent name, such as \dirname{/usr/local/texlive-cur}, via a
806 symbolic link, which you can then repoint after testing the new release.)
807
808 Changing \dirname{TEXDIR} in the installer will also change
809 \dirname{TEXMFLOCAL}, \dirname{TEXMFSYSVAR} and
810 \dirname{TEXMFSYSCONFIG}.
811
812 \dirname{TEXMFHOME} is the recommended location for personal macro files
813 or packages. The default value is |~/texmf| (|~/Library/texmf| on
814 Macs). In contrast to \dirname{TEXDIR}, here a |~| is preserved in the
815 newly-written configuration files, since it usefully refers to the home
816 directory of the user running \TeX. It expands to \dirname{$HOME} on
817 Unix and \verb|%USERPROFILE%| on Windows. Special redundant note:
818 \envname{TEXMFHOME}, like all trees, must be organized according to the
819 \TDS, or files may not be found.
820
821 \dirname{TEXMFVAR} is the location for storing most cached runtime data
822 specific to each user. \dirname{TEXMFCACHE} is the variable name used
823 for that purpose by Lua\LaTeX\ and \ConTeXt\ MkIV (see
824 section~\ref{sec:context}, \p.\pageref{sec:context}); its
825 default value is \dirname{TEXMFSYSVAR}, or (if that's not writable),
826 \dirname{TEXMFVAR}.
827
828
829 \subsubsection{Options}
830 \label{sec:options}
831
832 \begin{figure}[tbh]
833 \begin{boxedverbatim}
834 Options customization:
835 ===============================================================================
836 <P> use letter size instead of A4 by default: [ ]
837 <E> execution of restricted list of programs: [X]
838 <F> create all format files: [X]
839 <D> install font/macro doc tree: [X]
840 <S> install font/macro source tree: [X]
841 <L> create symlinks in standard directories: [ ]
842 binaries to:
843 manpages to:
844 info to:
845 <Y> after install, set CTAN as source for package updates: [X]
846 \end{boxedverbatim}
847 \vskip-.5\baselineskip
848 \caption{Options menu (Unix)}\label{fig:options-text}
849 \end{figure}
850
851 Figure~\ref{fig:options-text} shows the text mode options menu.
852 More info on each:
853
854 \begin{description}
855 \item[use letter size instead of A4 by default:] The default paper
856 size selection. Of course, individual documents can and should
857 specify a specific paper size, if desired.
858
859 \item[execution of restricted list of programs:] As of \TL\ 2010,
860 execution of a few external programs is allowed by default. The (very
861 short) list of allowed programs is given in the \filename{texmf.cnf}.
862 See the 2010 news (section~\ref{sec:2010news}) for more details.
863
864 \item[create all format files:] We recommend leaving this option
865 checked, to avoid unnecessary problems when creating formats
866 dynamically. See the \prog{fmtutil} documentation for more details.
867
868 \item[install font/macro \ldots\ tree:] Download/install the
869 documentation and source files included in most packages. Unchecking
870 is not recommended.
871
872 \item[create symlinks in standard directories:]
873 This option (Unix only) bypasses the need to change environment
874 variables. Without this option, \TL{} directories usually have to be
875 added to \envname{PATH}, \envname{MANPATH} and \envname{INFOPATH}. You
876 will need write permissions to the target directories. This option is
877 intended for accessing the \TeX\ system through directories that are
878 already known to users, such as \dirname{/usr/local/bin}, which don't
879 already contain any \TeX\ files. Do not overwrite existing files on
880 your system with this option, e.g., by specifying system directories.
881 The safest and recommended approach is to leave the option unchecked.
882
883 \item[after install, set CTAN as source for package updates:]
884 When installing from a \DVD\ or \ISO\ image, this
885 option is enabled by default, since usually one wants to take any
886 subsequent package updates from the \CTAN\ area that is updated
887 throughout the year. The only likely reason to disable it is if you
888 install only a subset from the \DVD\ and plan to augment the
889 installation later. In any case, the package repository for the
890 installer, and for updates after installation, can be set
891 independently as needed; see section~\ref{sec:location} and
892 section~\ref{sec:dvd-install-net-updates}.
893 \end{description}
894 Windows-specific options, as displayed in the advanced \GUI{}
895 interface:
896 \begin{description}
897 \item[adjust searchpath] This ensures that all
898 programs will see the \TL{} binary directory on their search path.
899
900 \item[add menu shortcuts] If set, there will be a \TL{} submenu of
901 the Start menu. There is a third option `Launcher entry' besides
902 `TeX Live menu' and `No shortcuts'. This option is described in
903 section \ref{sec:sharedinstall}.
904
905 \item[File associations] The options are `Only new' (create
906 file associations, but do not overwrite existing ones), `All' and
907 `None'.
908
909 \item[install \TeX{}works front end]
910 \end{description}
911 When all the settings are to your liking, you can type `I' in the
912 text interface, or press the `Install' button in the
913 \GUI, to start the installation process. When it is done,
914 skip to section~\ref{sec:postinstall} to read what else needs to be
915 done, if anything.
916
917 \subsection{Command-line install-tl options}
918 \label{sec:cmdline}
919
920 Type
921 \begin{alltt}
922 > \Ucom{install-tl -help}
923 \end{alltt}
924 for a listing of command-line options. Either |-| or |--| can be used
925 to introduce option names. These are the most common ones:
926
927 \begin{ttdescription}
928 \item[-gui] Use the \GUI{} installer if possible. This requires
929 Tcl/Tk version 8.5 or higher. This was distributed with older \macOS;
930 for Big Sur and later, you'll need to install Tcl/Tk yourself, if you
931 don't choose to use the Mac\TeX\ installer. Tcl/Tk is
932 distributed with \TL{} on Windows. The legacy options
933 \texttt{-gui=perltk} and \texttt{-gui=wizard} are still available
934 but invoke the same \GUI{} interface; if Tcl/Tk is not available,
935 installation continues in text mode.
936
937 \item[-no-gui] Force using the text mode installer.
938
939 \item[-lang {\sl LL}] Specify the installer interface
940 language as a standard (usually two-letter) code. The installer tries
941 to automatically determine the right language but if it fails, or if
942 the right language is not available, then it uses English as a
943 fallback. Run \verb|install-tl --help| to get the list of available
944 languages.
945
946 \item[-portable] Install for portable use on, e.g., a \USB{} stick.
947 Also selectable from within the text installer with the \code{V}
948 command, and from the \GUI{} installer. See
949 section~\ref{sec:portable-tl}.
950
951 \item[-profile {\sl file}] Load the installation profile \var{file} and
952 do the installation with no user interaction. The installer always
953 writes a file \filename{texlive.profile} to the \dirname{tlpkg}
954 subdirectory of your installation. That file can be given as the
955 argument to redo the exact same installation on a different system,
956 for example. Alternatively, you can use a custom profile, most easily
957 created by starting from a generated one and changing values, or an
958 empty file, which will take all the defaults.
959
960 \item [-repository {\sl url-or-directory}] Specify package
961 repository from which to install; see following.
962
963 \htmlanchor{opt-in-place}
964 \item[-in-place] (Documented only for completeness: Do not use this
965 unless you know what you are doing.) If you already have an rsync, svn,
966 or other copy of \TL{} (see
967 \url{https://tug.org/texlive/acquire-mirror.html}) then this option
968 will use what you've got, as-is, and do only the necessary
969 post-install actions. Be warned that the file \filename{tlpkg/texlive.tlpdb}
970 may be overwritten; saving it is your responsibility. Also, package
971 removal has to be done manually. This option cannot be toggled via the
972 installer interface.
973 \end{ttdescription}
974
975
976 \subsubsection{The \optname{-repository} option}
977 \label{sec:location}
978
979 The default network package repository is a \CTAN{} mirror chosen
980 automatically via \url{https://mirror.ctan.org}.
981
982 If you want to override that, the location value can be a url
983 starting with \texttt{ftp:}, \texttt{http:}, \texttt{https:},
984 \texttt{file:/}, or a plain directory path. (When giving an
985 \texttt{http:}, \texttt{https:} or \texttt{ftp:}\ location, trailing
986 `\texttt{/}' characters and/or a trailing `\texttt{/tlpkg}'
987 component are ignored.)
988
989 For example, you could choose a particular \CTAN\ mirror with something
990 like: \url{http://ctan.example.org/tex-archive/systems/texlive/tlnet/},
991 substituting a real hostname and its particular top-level \CTAN\ path
992 for |ctan.example.org/tex-archive|. The list of \CTAN\ mirrors is
993 maintained at \url{https://ctan.org/mirrors}.
994
995 If the given argument is local (either a path or a \texttt{file:/} url),
996 compressed files in an \dirname{archive} subdirectory of the repository
997 path are used (even if uncompressed files are available as well).
998
999 \htmlanchor{postinstall}
1000 \subsection{Post-install actions}
1001 \label{sec:postinstall}
1002
1003 Some post-installation may be required.
1004
1005 \subsubsection{Environment variables for Unix}
1006 \label{sec:env}
1007
1008 If you elected to create symlinks in standard directories (described in
1009 section~\ref{sec:options}), then there is no need to edit environment
1010 variables. Otherwise, on Unix systems, the directory of the binaries
1011 for your platform must be added to the search path. (On Windows, the
1012 installer takes care of this.)
1013
1014 Each supported platform has its own subdirectory under
1015 \dirname{TEXDIR/bin}. See figure~\ref{fig:bin-text} for the list of
1016 subdirectories and corresponding platforms.
1017
1018 Optionally, you can also add the documentation man and Info directories
1019 to their respective search paths, if you want the system tools to find
1020 them. The man pages might be found automatically after the addition to
1021 \envname{PATH}.
1022
1023 For Bourne-compatible shells such as \prog{bash}, and using Intel x86
1024 GNU/Linux and the \TL\ default directory setup as an example, the file to edit
1025 might be \filename{$HOME/.profile} (or another file sourced by
1026 \filename{.profile}), and the lines to add would look like this:
1027
1028 \begin{sverbatim}
1029 PATH=/usr/local/texlive/2026/bin/x86_64-linux:$PATH; export PATH
1030 MANPATH=/usr/local/texlive/2026/texmf-dist/doc/man:$MANPATH; export MANPATH
1031 INFOPATH=/usr/local/texlive/2026/texmf-dist/doc/info:$INFOPATH; export INFOPATH
1032 \end{sverbatim}
1033
1034 For csh or tcsh, the file to edit is typically \filename{$HOME/.cshrc}, and
1035 the lines to add might look like:
1036
1037 \begin{sverbatim}
1038 setenv PATH /usr/local/texlive/2026/bin/x86_64-linux:$PATH
1039 setenv MANPATH /usr/local/texlive/2026/texmf-dist/doc/man:$MANPATH
1040 setenv INFOPATH /usr/local/texlive/2026/texmf-dist/doc/info:$INFOPATH
1041 \end{sverbatim}
1042
1043 If you're not on an \code{x86\_64-linux} platform, use the appropriate
1044 platform name; similarly, if you didn't install in the default
1045 directory, change the directory name. The \TL\ installer reports the
1046 full lines to use at the end of installation.
1047
1048 If you already have \envname{PATH} settings somewhere in your startup
1049 files, merge in the \TL\ directories as you see fit.
1050
1051
1052 \subsubsection{Environment variables: Global configuration}
1053 \label{sec:envglobal}
1054
1055 If you want to make these changes globally, or for a user newly added to
1056 the system, then you are on your own; there is just too much variation
1057 between systems in how and where these things are configured.
1058
1059 Our two hints are: 1)~you may want to check for a file
1060 \filename{/etc/manpath.config} and, if present, add lines such as
1061
1062 \begin{sverbatim}
1063 MANPATH_MAP /usr/local/texlive/2026/bin/x86_64-linux \
1064 /usr/local/texlive/2026/texmf-dist/doc/man
1065 \end{sverbatim}
1066
1067 And 2)~check for a file \filename{/etc/environment} which may define the
1068 search path and other default environment variables.
1069
1070 In each (Unix) binary directory, we also create a symbolic link named
1071 \code{man} to the directory \dirname{texmf-dist/doc/man}. Some \code{man}
1072 programs, such as the standard \macOS\ \code{man}, will automatically
1073 find that, obviating the need for any man page setup.
1074
1075 \htmlanchor{tlisoinstall}
1076 \subsubsection{Internet updates after \DVD\ or \ISO\ installation}
1077 \label{sec:dvd-install-net-updates}
1078
1079 If you installed \TL\ from \DVD\ (see \url{https://tug.org/dvd}) or an
1080 \ISO\ image and then wish to get updates from the Internet, you need to
1081 run this command---\emph{after} you've updated your search path (as
1082 described in the previous section):
1083
1084 \begin{alltt}
1085 > ... update PATH ...
1086 > \Ucom{tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet}
1087 \end{alltt}
1088
1089 This tells \cmdname{tlmgr} to use a nearby \CTAN\ mirror for future updates.
1090 This is done by default when installing from \DVD, via the option
1091 described in section~\ref{sec:options}.
1092
1093 If there are problems with the automatic mirror selection, you can
1094 specify a particular \CTAN\ mirror from the list at
1095 \url{https://ctan.org/mirrors}. Use the exact path to the
1096 \dirname{tlnet} subdir on that mirror, as shown above.
1097
1098
1099 \htmlanchor{xetexfontconfig} % keep historical anchor working
1100 \htmlanchor{sysfontconfig}
1101 \subsubsection{System font configuration for \protect\XeTeX\protect\ and Lua\protect\TeX}
1102 \label{sec:font-conf-sys}
1103
1104 \XeTeX\ and Lua\TeX\ can use any font installed on the system, not just
1105 those in the \TeX\ trees. Such system fonts (not part of \TL) are
1106 usually accessed by giving the font name, e.g., `\code{Liberation
1107 Serif}', although the system filename can also be used.
1108
1109 A related issue is making the fonts from the \TL\ distribution available
1110 as system fonts, which will in turn make them available by font name.
1111
1112 For Lua\TeX: for access by font name, nothing special need be done. All
1113 fonts in \TL\ should be equally accessible by either font name or
1114 filename to Lua\TeX, via the \pkgname{luaotfload} package, which
1115 supports both \LaTeX\ and plain \TeX. The \pkgname{luaotfload} font name
1116 index may need to be rebuilt for new fonts; this is triggered
1117 automatically when trying to load a font which isn't known yet.
1118
1119 For \XeTeX: on Windows, fonts shipped with \TL\ are automatically made
1120 available (by running the \cmdname{fc-cache} program provided for
1121 Windows as part of \TL). For the Mac, you'll need to consult other
1122 documentation. For Unix systems other than \macOS, the procedure is the
1123 following.
1124
1125 When the \pkgname{xetex} package is installed (either at initial
1126 installation or later), the necessary configuration file is created in
1127 \filename{TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf}. To make the
1128 \TL\ fonts available as system fonts,
1129 \begin{enumerate*}
1130 \item Copy that \filename{texlive-fontconfig.conf} file to (typically)
1131 \dirname{/etc/fonts/conf.d/09-texlive.conf}.
1132 \item Run \Ucom{fc-cache -fsv}.
1133 \end{enumerate*}
1134
1135 If you do not have sufficient privileges to carry out the steps above,
1136 or if you want to make the \TL{} fonts available to only one user,
1137 you can do the following:
1138 \begin{enumerate*}
1139 \item Copy the \filename{texlive-fontconfig.conf} file to (typically)
1140 \filename{~/.fonts.conf.d/09-texlive.conf}, where \filename{~} is
1141 your home directory.
1142 \item Run \Ucom{fc-cache -fv}.
1143 \end{enumerate*}
1144
1145 You can run \code{fc-list} to see the names of the available system
1146 fonts. The incantation \code{fc-list : family style file spacing} (all
1147 those arguments are literal strings) shows some generally interesting
1148 information.
1149
1150
1151 \subsubsection{\protect\ConTeXt{} LMTX and MKIV}
1152 \label{sec:context} % keeping both labels for backward compatibility
1153 \label{sec:context-mkiv}
1154
1155 Both the `old' \ConTeXt{} (Mark IV or MkIV) and the `new' \ConTeXt{}
1156 (LMTX or MkXL) should run out of the box after \TL{} installation,
1157 and should need no special attention as long as you stick to
1158 using \verb+tlmgr+ for updates.
1159
1160 \ConTeXt{} does not use the Kpathsea library or the system \code{ls-R}
1161 files; instead, \ConTeXt{} maintains a per-user filename database for
1162 all known trees. Running \code{mktexlsr} won't update these databases
1163 directly, but \ConTeXt{} will automatically rebuild them the next time
1164 it runs. (The \TL-specific files \code{cont-sys.mkiv} and
1165 \code{cont-sys.mkxl} implement this.)
1166
1167 If you ever want to manually rebuild these databases, run either or both of:
1168 \begin{sverbatim}
1169 mtxrun --generate # LMTX
1170 context --generate --luatex # MkIV
1171 \end{sverbatim}
1172 The resulting files are stored under \code{TEXMFCACHE},
1173 whose default value in \TL\ is \verb+TEXMFSYSVAR;TEXMFVAR+.
1174
1175 \ConTeXt\ will read from all paths mentioned in \verb+TEXMFCACHE+, and
1176 write to the first path that is writable. While reading, the last found
1177 match will take precedence in the case of duplicated cache data.
1178
1179 For more information, see \url{https://wiki.contextgarden.net/LMTX}\\
1180 and \url{https://wiki.contextgarden.net/Running_Mark_IV}.
1181
1182
1183 \subsubsection{Integrating local and personal macros}
1184 \label{sec:local-personal-macros}
1185
1186 This is already mentioned implicitly in section~\ref{sec:texmftrees}:
1187 \dirname{TEXMFLOCAL} (by default,
1188 \dirname{/usr/local/texlive/texmf-local} or
1189 \verb|%SystemDrive%\texlive\texmf-local| on Windows)
1190 is intended for system-wide local fonts and macros; and
1191 \dirname{TEXMFHOME} (by default, \dirname{$HOME/texmf} or
1192 \verb|%USERPROFILE%\texmf|), is for personal fonts and macros. These
1193 directories are intended to stick around from release to release, and
1194 have their content seen automatically by a new \TL{} release.
1195 Therefore, it is best to refrain from changing the definition of
1196 \dirname{TEXMFLOCAL} to be too far away from the main \TL{} directory,
1197 or you will need to manually change future releases.
1198
1199 For both trees, files should be placed in their proper \TeX\ Directory
1200 Structure (\TDS) subdirectories; see \url{https://tug.org/tds} or consult
1201 \filename{texmf-dist/web2c/texmf.cnf}. For instance, a \LaTeX{} class file or
1202 package should be placed in \dirname{TEXMFLOCAL/tex/latex} or
1203 \dirname{TEXMFHOME/tex/latex}, or a subdirectory thereof.
1204
1205 \dirname{TEXMFLOCAL} requires an up-to-date filename database, or files
1206 will not be found. You can update it with the command
1207 \cmdname{mktexlsr} or use the `Update filename database' button on the
1208 `Actions' tab of the \TL\ Manager \GUI.
1209
1210 By default, each of these variables is defined to be a single directory,
1211 as shown. This is not a hard-and-fast requirement. If you need to
1212 easily switch back and forth between different versions of large
1213 packages, for example, you can maintain multiple trees for your own
1214 purposes. This is done by setting \dirname{TEXMFHOME} to the
1215 list of directories, within braces, separated by commas:
1216
1217 \begin{verbatim}
1218 TEXMFHOME = {/my/dir1,/mydir2,/a/third/dir}
1219 \end{verbatim}
1220
1221 Section~\ref{sec:brace-expansion} describes brace expansion further.
1222
1223
1224 \subsubsection{Integrating third-party fonts}
1225
1226 This is unfortunately a messy topic for \TeX\ and pdf\TeX. Forget about
1227 it unless you want to delve into many details of the \TeX{}
1228 installation. Many fonts are included in \TL\ already, so take a look if
1229 you like; the web pages under \url{https://tug.org/FontCatalogue}
1230 display nearly all of the text fonts included in the main \TeX\
1231 distributions, categorized in various ways.
1232
1233 If you do want to install your own fonts, see
1234 \url{https://tug.org/fonts/fontinstall.html} for our best effort at
1235 describing the procedure.
1236
1237 Also consider using \XeTeX\ or Lua\TeX\ (see
1238 section~\ref{sec:tex-extensions}), which let you use operating
1239 system fonts without any installation in \TeX. (But beware that using
1240 system fonts usually makes your document sources unusable by anyone in a
1241 different environment.)
1242
1243 \subsection{Testing the installation}
1244 \label{sec:test-install}
1245
1246 After installing \TL{}, you naturally want to test it out, so you can
1247 start creating beautiful documents and\slash or fonts.
1248
1249 One thing you may immediately be looking for is a front-end with which
1250 to edit files. \TL{} installs \TeX{}works
1251 (\url{https://tug.org/texworks}) on Windows (only), and Mac\TeX\ installs
1252 TeXShop (\url{https://pages.uoregon.edu/koch/texshop}). On other Unix
1253 systems, it's left up to you to choose an editor. There are many
1254 choices available, some of which are listed in the next section; see
1255 also \url{https://tug.org/interest.html#editors}. Any plain text editor
1256 will work; something \TeX-specific is not required.
1257
1258 The rest of this section gives some basic procedures for testing that
1259 the new system is functional. We give Unix commands here; under
1260 \macOS{} and Windows, you're more likely to run the tests through a
1261 graphical interface, but the principles are the same.
1262
1263 \begin{enumerate}
1264
1265 \item Make sure that you can run the \cmdname{tex} program in the first
1266 place:
1267 \begin{alltt}
1268 > \Ucom{tex -{}-version}
1269 TeX 3.14159265 (TeX Live ...)
1270 Copyright ... D.E. Knuth.
1271 ...
1272 \end{alltt}
1273 If this comes back with `command not found' instead of version and
1274 copyright information, or with an older version, most likely you don't
1275 have the correct \dirname{bin} subdirectory in your \envname{PATH}. See
1276 the environment-setting information on \p.\pageref{sec:env}.
1277
1278 \item Process a basic \LaTeX{} file, generating PDF:
1279 \begin{alltt}
1280 > \Ucom{pdflatex sample2e.tex}
1281 This is pdfTeX 3.14...
1282 ...
1283 Output written on sample2e.pdf (3 pages, 142120 bytes).
1284 Transcript written on sample2e.log.
1285 \end{alltt}
1286 If this fails to find \filename{sample2e.tex} or other files,
1287 you may have interference from old environment variables or
1288 configuration files; we recommend unsetting all \TeX-related environment
1289 variables for a start. (For a deep analysis, you can ask \TeX{} to
1290 report on exactly what it is searching for, and finding; see ``Debugging
1291 actions'' on page~\pageref{sec:debugging}.)
1292
1293 \item Preview the PDF file, for example:
1294 \begin{alltt}
1295 > \Ucom{xpdf sample2e.pdf}
1296 \end{alltt}
1297 You should see a new window with a nice document explaining some of the
1298 basics of \LaTeX{}. (It's well worth reading, by the way, if you're new
1299 to \TeX.)
1300
1301 Of course there are many other PDF viewers; on Unix systems,
1302 \cmdname{evince} and \cmdname{okular} are commonly used. For Windows, we
1303 recommend trying Sumatra PDF
1304 (\url{https://www.sumatrapdfreader.org/free-pdf-reader.html}). No PDF
1305 viewers are included in \TL{}, so you must install whatever you want to
1306 use separately.
1307
1308 \item Of course you can still generate \TeX's original \dvi{} format:
1309 \begin{alltt}
1310 > \Ucom{latex sample2e.tex}
1311 \end{alltt}
1312
1313 \item And preview the \dvi{} online:
1314 \begin{alltt}
1315 > \Ucom{xdvi sample2e.dvi} # Unix
1316 > \Ucom{dviout sample2e.dvi} # Windows
1317 \end{alltt}
1318 You do have to be running under X for \cmdname{xdvi} to work; if
1319 you're not, or your \envname{DISPLAY} environment variable is set
1320 incorrectly, you'll get an error \samp{Can't open display}.
1321
1322 \item To create a \PS{} file from the \dvi:
1323 \begin{alltt}
1324 > \Ucom{dvips sample2e.dvi -o sample2e.ps}
1325 \end{alltt}
1326
1327 \item Or to create PDF from the \dvi{}, an alternate path to using
1328 pdf\TeX\ (or Xe\TeX\ or Lua\TeX) which can be useful sometimes:
1329 \begin{alltt}
1330 > \Ucom{dvipdfmx sample2e.dvi -o sample2e.pdf}
1331 \end{alltt}
1332
1333 \item Other standard test files you may find useful in addition to
1334 \filename{sample2e.tex}:
1335
1336 \begin{ttdescription}
1337 \item [small2e.tex] A simpler document than \filename{sample2e}, to
1338 reduce the input size if you're having troubles.
1339 \item [testpage.tex] Test if your printer introduces any offsets.
1340 \item [nfssfont.tex] For printing font tables and tests.
1341 \item [testfont.tex] Also for font tables, but using plain \TeX{}.
1342 \item [story.tex] The most canonical (plain) \TeX{} test file of all.
1343 You must type \samp{\bs bye} to the \code{*} prompt after \samp{tex
1344 story.tex}.
1345 \end{ttdescription}
1346
1347 \item If you have installed the \filename{xetex} package, you can test
1348 its access to system fonts as follows:
1349 \begin{alltt}
1350 > \Ucom{xetex opentype-info.tex}
1351 This is XeTeX, Version 3.14\dots
1352 ...
1353 Output written on opentype-info.pdf (1 page).
1354 Transcript written on opentype-info.log.
1355 \end{alltt}
1356
1357 If you get an error message saying ``Invalid fontname `Latin Modern
1358 Roman/ICU'\dots'', then you need to configure your system so that the
1359 fonts shipped with \TL\ can be found. See
1360 section~\ref{sec:font-conf-sys}.
1361
1362 \end{enumerate}
1363
1364 \htmlanchor{uninstall}
1365 \subsection{Uninstalling \TL}
1366 \label{sec:uninstall}
1367
1368 To uninstall \TL\ (after a successful installation; for Windows, see
1369 below):
1370
1371 \begin{alltt}
1372 > \Ucom{tlmgr uninstall --all}
1373 \end{alltt}
1374
1375 You will be asked for confirmation, else nothing will be done.
1376 (Without \code{-{}-all}, the \code{uninstall} action is used to remove
1377 individual packages.)
1378
1379 This does not remove user-specific directories, namely (see also
1380 section~\ref{sec:texmftrees}):
1381
1382 \begin{ttdescription}
1383 \item [TEXMFCONFIG] This is intended for user configuration changes.
1384 If you want to preserve them, be sure you know how to recreate them
1385 before removing.
1386
1387 \item [TEXMFVAR] This is intended to store automatically-generated
1388 runtime data, such as local format files. Unless you've used it for
1389 other purposes, it should be safe to remove.
1390
1391 \item[TEXMFHOME] Contains only files you yourself installed, typically
1392 those not available in the distributions. Unless you are completely
1393 stopping using \TeX, or want to start over from scratch, you probably
1394 don't want to remove this.
1395
1396 \end{ttdescription}
1397
1398 \noindent You can find the directory paths for these variables by
1399 running \code{kpsewhich -var-value=\ttvar{var}}.
1400
1401 This \prog{tlmgr} uninstallation also does not undo post-install
1402 actions, such as \envname{PATH} changes in your shell initialization
1403 files and system access to the fonts in \TL\ (see
1404 section~\ref{sec:postinstall}). You must manually reverse such actions,
1405 if desired.
1406
1407 On Windows, uninstallation can be done through the \GUI; see
1408 section~\ref{sec:winfeatures}.
1409
1410
1411 \subsection{Links for additional downloadable software}
1412
1413 If you are new to \TeX{}, or otherwise need help with actually writing
1414 \TeX{} or \LaTeX{} documents, please visit
1415 \url{https://tug.org/begin.html} for some introductory resources.
1416
1417 Links for some other tools you may consider installing:
1418 \begin{description}
1419 \item[Ghostscript] \url{https://ghostscript.com/}, a free PostScript and
1420 PDF interpreter.
1421 \item[Perl] \url{https://perl.org/} with
1422 supplementary packages from CPAN, \url{https://cpan.org/}.
1423 \item[ImageMagick] \url{https://imagemagick.org}, for graphics
1424 processing and conversion.
1425 \item[NetPBM] \url{http://netpbm.sourceforge.net}, also for graphics.
1426
1427 \item[\TeX-oriented editors] There is a wide choice, and it is a matter of the
1428 user's taste. Here is a selection in alphabetical order (a few
1429 here are for Windows only).
1430 \begin{itemize*}
1431 \item \cmdname{GNU Emacs} is available for all major platforms; see
1432 \url{https://www.gnu.org/software/emacs}.
1433 \item \cmdname{AUC\TeX} runs under Emacs; it's available through
1434 Emacs' package manager \cmdname{ELPA}. Sources are also
1435 available from CTAN. The AUC\TeX\ home page is
1436 \url{https://www.gnu.org/software/auctex}.
1437 \item \cmdname{SciTE} is available from
1438 \url{https://www.scintilla.org/SciTE.html}.
1439 \item \cmdname{Texmaker} is free software, available from
1440 \url{https://www.xm1math.net/texmaker}.
1441 \item \cmdname{TeXstudio} started as a fork of
1442 \cmdname{Texmaker} and given additional features; available from
1443 \url{https://texstudio.org/}.
1444 \item \cmdname{TeXnicCenter} is free software, available from
1445 \url{https://www.texniccenter.org}.
1446 \item \cmdname{TeXworks} is free software, available from
1447 \url{https://tug.org/texworks} and installed as part of \TL\ for
1448 Windows (only).
1449 \item \cmdname{Vim} is free software, available from
1450 \url{https://www.vim.org}.
1451 \item \cmdname{WinEdt} is shareware available though
1452 \url{https://tug.org/winedt} or \url{https://www.winedt.com}.
1453 \item \cmdname{WinShell} is available from \url{https://www.winshell.de}.
1454 \end{itemize*}
1455 \end{description}
1456 For a much longer list of packages and programs, see
1457 \url{https://tug.org/interest.html}.
1458
1459
1460 \section{Specialized installations}
1461
1462 The previous sections described the basic installation process. Here we
1463 turn to some specialized cases.
1464
1465 \htmlanchor{tlsharedinstall}
1466 \subsection{Shared-user (or cross-machine) installations}
1467 \label{sec:sharedinstall}
1468
1469 \TL{} has been designed to be shared between different systems on a
1470 network. With a standard directory layout, no hard paths are
1471 configured: the locations for files needed by \TL{} programs are
1472 found relative to the programs. You can see this in the principal
1473 configuration file
1474 \filename{$TEXMFDIST/web2c/texmf.cnf}, which contains lines such as
1475 \begin{sverbatim}
1476 TEXMFROOT = $SELFAUTOPARENT
1477 ...
1478 TEXMFDIST = $TEXMFROOT/texmf-dist
1479 ...
1480 TEXMFLOCAL = $SELFAUTOGRANDPARENT/texmf-local
1481 \end{sverbatim}
1482 This means that adding the directory for \TL{} executables for their
1483 platform to their search path is sufficient to get a working setup.
1484
1485 By the same token, you can also install \TL{} locally and then move
1486 the entire hierarchy afterwards to a network location.
1487
1488 For Windows, \TL{} includes a launcher \filename{tlaunch}. Its main
1489 window contains menu entries and buttons for various \TeX-related
1490 programs and documentation, customizable via an \code{ini} file. On
1491 first use, it replicates the usual Windows-specific post-install,
1492 \emph{i.e.}, search path modification and file associations, but only
1493 for the current user. Therefore, workstations with access to \TL{} on
1494 the local network only need a menu shortcut for the launcher. See the
1495 \code{tlaunch} manual (\code{texdoc tlaunch}, or
1496 \url{https://ctan.org/pkg/tlaunch}).
1497
1498
1499 \htmlanchor{tlportable}
1500 \subsection{Portable (\USB{}) installations}
1501 \label{sec:portable-tl}
1502
1503 The \code{-portable} installer option (or \code{V} command in the text
1504 installer or corresponding \GUI{} option) creates a completely
1505 self-contained \TL{} installation under a common root and forgoes system
1506 integration. You can create such an installation directly on a \USB{}
1507 stick, or copy it to a \USB{} stick afterwards.
1508
1509 Technically, the portable installation is made self-contained by setting
1510 the default values of \envname{TEXMFHOME}, \envname{TEXMFVAR}, and
1511 \envname{TEXMFCONFIG} to be the same as \envname{TEXMFLOCAL},
1512 \envname{TEXMFSYSVAR}, and \envname{TEXMFSYSCONFIG} respectively; thus,
1513 per-user configuration and caches will not be created.
1514
1515 To run \TeX\ using this portable installation, you need to add the
1516 appropriate binary directory to the search path during your terminal
1517 session, as usual.
1518
1519 On Windows, you can double-click \filename{tl-tray-menu} at the root
1520 of the installation and create a temporary `tray menu' offering a
1521 choice of a few common tasks, as shown in this screenshot:
1522
1523 \medskip
1524 \tlpng{tray-menu}{4cm}{Windows tray menu}
1525 \smallskip
1526
1527 \noindent The `More\ldots' entry explains how you can customize this menu.
1528
1529
1530 \htmlanchor{tlmgr}
1531 \section{\cmdname{tlmgr}: Managing your installation}
1532 \label{sec:tlmgr}
1533
1534 \begin{figure}[tb]
1535 \def\figdesc{\prog{tlshell} \GUI, showing the Actions menu (\GNU/Linux)}
1536 \tlpng{tlshell-linux}{\linewidth}{\figdesc}
1537 \caption{\figdesc}
1538 \label{fig:tlshell}
1539 \end{figure}
1540
1541 \begin{figure}[tb]
1542 \def\figdesc{\prog{tlcockpit} \GUI{} for \prog{tlmgr}}
1543 \tlpng{tlcockpit-packages}{.8\linewidth}{\figdesc}
1544 \caption{\figdesc}
1545 \label{fig:tlcockpit}
1546 \end{figure}
1547
1548 \begin{figure}[tb]
1549 \def\figdesc{Legacy \prog{tlmgr} \GUI\ mode: main window, after `Load'}
1550 \tlpng{tlmgr-gui}{\linewidth}{\figdesc}
1551 \caption{\figdesc}
1552 \label{fig:tlmgr-gui}
1553 \end{figure}
1554
1555 \TL{} includes a program named \prog{tlmgr} for managing \TL{} after the
1556 initial installation. Its capabilities include:
1557
1558 \begin{itemize*}
1559 \item installing, updating, backing up, restoring, and uninstalling
1560 individual packages, optionally taking dependencies into account;
1561 \item searching for and listing packages and their descriptions;
1562 \item listing, adding, and removing platforms;
1563 \item changing installation options such as paper size and source
1564 location (see section~\ref{sec:location}).
1565 \end{itemize*}
1566
1567 \prog{tlmgr}'s functionality completely subsumes the \prog{texconfig}
1568 program. We still distribute and maintain \prog{texconfig} for the sake
1569 of anyone used to its interface, but we recommend using \prog{tlmgr}
1570 nowadays.
1571
1572 \subsection{\GUI{} interfaces for \cmdname{tlmgr}}
1573
1574 \TL{} contains several \GUI{} front-ends for \prog{tlmgr}. Two notable
1575 ones: (1)~Figure~\ref{fig:tlshell} shows \cmdname{tlshell}, which is
1576 written in Tcl/Tk and runs out of the box under Windows;
1577 (2)~Figure~\ref{fig:tlcockpit} shows \prog{tlcockpit}, which requires
1578 Java version~8 or higher and JavaFX. Both are separate packages.
1579
1580 \prog{tlmgr} also has a native \GUI{} mode (shown in
1581 figure~\ref{fig:tlmgr-gui}), which is started with:
1582 \begin{alltt}
1583 > \Ucom{tlmgr -gui}
1584 \end{alltt}
1585 However, this \GUI\ extension requires Perl/Tk, which module is no
1586 longer included in \TL's Perl distribution for Windows.
1587
1588 \subsection{Sample \cmdname{tlmgr} command-line invocations}
1589
1590 After the initial installation, you can update your system to the latest
1591 versions available with:
1592 \begin{alltt}
1593 > \Ucom{tlmgr update -all}
1594 \end{alltt}
1595 If this makes you nervous, first try
1596 \begin{alltt}
1597 > \Ucom{tlmgr update -all -dry-run}
1598 \end{alltt}
1599 or (less verbose):
1600 \begin{alltt}
1601 > \Ucom{tlmgr update -list}
1602 \end{alltt}
1603
1604 This more complex example adds a collection, for the engine \XeTeX, from
1605 a local directory:
1606
1607 \begin{alltt}
1608 > \Ucom{tlmgr -repository /local/mirror/tlnet install collection-xetex}
1609 \end{alltt}
1610 It generates the following output (abridged):
1611 \begin{fverbatim}
1612 install: collection-xetex
1613 install: arabxetex
1614 ...
1615 install: xetex
1616 install: xetexconfig
1617 install: xetex.i386-linux
1618 running post install action for xetex
1619 install: xetex-def
1620 ...
1621 running mktexlsr
1622 mktexlsr: Updating /usr/local/texlive/2026/texmf-dist/ls-R...
1623 ...
1624 running fmtutil-sys --missing
1625 ...
1626 Transcript written on xelatex.log.
1627 fmtutil: /usr/local/texlive/2026/texmf-var/web2c/xetex/xelatex.fmt installed.
1628 \end{fverbatim}
1629
1630 As you can see, \prog{tlmgr} installs dependencies, and takes care of any
1631 necessary post-install actions, including updating the filename database
1632 and (re)generating formats. In the above, we generated new formats for
1633 \XeTeX.
1634
1635 To describe a package (or collection or scheme):
1636 \begin{alltt}
1637 > \Ucom{tlmgr show collection-latexextra}
1638 \end{alltt}
1639 which produces output like this:
1640 \begin{fverbatim}
1641 package: collection-latexextra
1642 category: Collection
1643 shortdesc: LaTeX supplementary packages
1644 longdesc: A very large collection of add-on packages for LaTeX.
1645 installed: Yes
1646 revision: 46963
1647 sizes: 657941k
1648 \end{fverbatim}
1649
1650 Last and most important, for full documentation see
1651 \url{https://tug.org/texlive/tlmgr.html}, or:
1652 \begin{alltt}
1653 > \Ucom{tlmgr -help}
1654 \end{alltt}
1655
1656
1657 \section{Notes on Windows}
1658 \label{sec:windows}
1659
1660 \subsection{Windows-specific features}
1661 \label{sec:winfeatures}
1662
1663 Under Windows, the installer does some extra things:
1664 \begin{description}
1665 \item[Menus and shortcuts.] A new `\TL{}' submenu of the Start menu
1666 is installed. This contains entries for some \GUI{} programs, such
1667 as \prog{tlshell} (a \GUI\ for \prog{tlmgr}) and \prog{dviout}, and some
1668 entries for documentation.
1669
1670 \item[File associations.] If enabled, \prog{TeXworks} and \prog{Dviout}
1671 become either the default program for
1672 their respective filetypes, or get an entry in the `Open with'
1673 right-click menus of those filetypes. However,
1674 higher-priority `User Choice' file associations, which can only be
1675 specified interactively, can get in the way.
1676
1677 \item[PostScript support.] For PostScript files, a PSviewer filetype
1678 now converts PostScript to a temporary PDF, which is then
1679 displayed by the default PDF viewer.
1680
1681 \item[Automatic path adjustment.] No manual configuration steps are required.
1682
1683 \item[Uninstaller.] The installer creates an entry for \TL, either
1684 under `Add/Remove Programs' (admin installation) or under the
1685 \TL\ menu (single-user installation).
1686
1687 \item[Write-protect.] For an admin installation, the \TL\ directories are
1688 write-protected, at least if \TL\ is installed on a normal
1689 NTFS-formatted non-removable disk.
1690 \end{description}
1691
1692 Also, have a look at \filename{tlaunch}, described in
1693 section~\ref{sec:sharedinstall}, for a different approach.
1694
1695 \subsection{Additional software included on Windows}
1696
1697 To be complete, a \TL{} installation needs support programs that are not
1698 commonly found on a Windows machine. \TL{} provides the missing pieces.
1699 These programs are all installed as part of \TL{} only on Windows.
1700
1701 \begin{description}
1702 \item[Perl, Tcl/Tk and Ghostscript.] Because of the importance of Perl and
1703 Ghostscript, and because the installer and tlshell \GUI{}s are written
1704 in Tcl/Tk, \TL{} includes `hidden' copies of these programs. \TL{}
1705 programs that need them know where to find them, but they don't betray
1706 their presence through environment variables or registry settings.
1707 They aren't full-scale installations (except for Ghostscript), and
1708 shouldn't interfere with any system installations of Perl, Tcl/Tk or
1709 Ghostscript. See subsection \ref{sec:externalwndws} how to tell \TL{} that
1710 you want to use your own external installations for contributed
1711 scripts within \TL.
1712
1713 \item[dviout.] Also installed is \prog{dviout}, a DVI viewer.
1714 At first, when you preview files with \cmdname{dviout}, it will create
1715 fonts, because screen fonts were not installed. After a while, you
1716 will have created most of the fonts you use, and you will rarely see
1717 the font-creation window. More information can be found in the
1718 (highly recommended) on-line help.
1719
1720 \item[\TeX{}works.] \TeX{}works is a \TeX-oriented editor with
1721 an integrated PDF viewer.
1722
1723 \item[Command-line tools.] A number of Windows ports of common Unix
1724 command-line programs are installed along with the usual \TL{}
1725 binaries. These include \cmdname{gzip}, \cmdname{zip},
1726 \cmdname{unzip}, and the utilities from the \cmdname{poppler} suite
1727 (\cmdname{pdfinfo}, \cmdname{pdffonts}, \ldots).
1728
1729 \item[fc-list, fc-cache, \ldots] The tools from the \pkgname{fontconfig}
1730 library allow \XeTeX{} to find system fonts on Windows. You can use
1731 \prog{fc-list} to determine the font names to pass to \XeTeX's
1732 extended \cs{font} command. If necessary, run \prog{fc-cache} first to
1733 update font information.
1734
1735 \end{description}
1736
1737 \subsection{Using external Perl, Tcl/Tk and Ghostscript
1738 installations}
1739 \label{sec:externalwndws}
1740
1741 Normally, \TL{} will use its built-in Perl, Tcl/Tk and Ghostscript also
1742 for contributed scripts within \TL. If you wish to use your own external
1743 versions, then you can configure that in the \file{texmf.cnf} file
1744 \emph{in the root of the installation}.
1745
1746 For Perl, you need to add a line
1747 \begin{verbatim}
1748 TEXLIVE_WINDOWS_TRY_EXTERNAL_PERL = 1
1749 \end{verbatim}
1750 \TL{} (specifically, \file{bin/windows/runscript.tlu}) will then search
1751 for \file{perl.exe} on the search path, except for scripts which belong
1752 to the \TL{} infrastructure. This is the most likely setting of the
1753 three to be useful; although the \TL{} Perl includes many additional
1754 modules, it cannot support all third-party scripts.
1755
1756 Similarly, for Tcl/Tk you need a line
1757 \begin{verbatim}
1758 TEXLIVE_WINDOWS_TRY_EXTERNAL_TCL = 1
1759 \end{verbatim}
1760 \TL{} will then search for \file{tclkit.exe}, \file{wish.exe},
1761 \file{wish85.exe}, \file{wish86.exe} and \file{wish87.exe} on the
1762 searchpath.
1763
1764 Ghostscript is handled differently, in that you need to specify the
1765 filename or the full path of your command-line Ghostscript:
1766 \begin{alltt}
1767 TEXLIVE_WINDOWS_EXTERNAL_GS = \var{path of command-line ghostscript}
1768 \end{alltt}
1769 Another difference is that the Ghostscript shipped with \TL\
1770 is complete, with only documentation and printer drivers omitted. So
1771 it's unlikely you'll have any need to override it.
1772
1773 See also section \ref{sec:configfiles} about \file{texmf.cnf}.
1774
1775
1776 \subsection{User Profile is Home}
1777 \label{sec:winhome}
1778
1779 The Windows counterpart of a Unix home directory is the
1780 \verb|%USERPROFILE%| directory. Under Windows Vista and later it is
1781 \verb|C:\Users\<username>|. In the
1782 \filename{texmf.cnf} file, and \KPS{} in general, \verb|~| will
1783 expand appropriately on both Windows and Unix.
1784
1785
1786 \subsection{The Windows registry}
1787 \label{sec:registry}
1788
1789 Windows stores nearly all configuration data in its registry. The
1790 registry contains a set of hierarchically organized keys, with several
1791 root keys. The most important ones for installation programs are
1792 \path{HKEY_CURRENT_USER} and \path{HKEY_LOCAL_MACHINE}, \path{HKCU} and
1793 \path{HKLM} in short. The \path{HKCU} part of the registry is in the
1794 user's home directory (see section~\ref{sec:winhome}). \path{HKLM} is
1795 normally in a subdirectory of the Windows directory.
1796
1797 In some cases, system information could be obtained from environment
1798 variables but for other information, for example the location of
1799 shortcuts, it is necessary to consult the registry. Setting environment
1800 variables permanently also requires registry access.
1801
1802
1803 \subsection{Windows permissions}
1804 \label{sec:winpermissions}
1805
1806 In later versions of Windows, a distinction is made between regular
1807 users and administrators, where only the latter have free access to almost the
1808 entire operating system. We have made an effort to make \TL{}
1809 installable without administrative privileges.
1810
1811 If the installer is started with administrative permissions, there is an
1812 option to install for all users. If this option is chosen, shortcuts
1813 are created for all users, and the system search path is
1814 modified. Otherwise, shortcuts and menu entries are created for the
1815 current user, and the user search path is modified.
1816
1817 Regardless of administrator status, the default root of \TL{} proposed
1818 by the installer is always under \verb|%SystemDrive%|. The installer
1819 always tests whether the root is writable for the current user.
1820
1821 A problem may arise if the user is not an administrator and \TeX{}
1822 already exists in the search path. Since the effective search path
1823 consists of the system search path followed by the user search path, the
1824 new \TL{} would never get precedence. As a workaround, the installer
1825 creates a shortcut to the command-prompt in which the new \TL{} binary
1826 directory is prepended to the local search path. The new \TL{} will be
1827 always usable from within such a command-prompt. The shortcut for
1828 \TeX{}works, if installed, also prepends \TL{} to the search path, so it
1829 should also be immune to this path problem.
1830
1831 You should be aware that even if you are logged in as administrator, you
1832 need to explicitly ask for administrator privileges. In fact, there is
1833 not much point in logging in as administrator. Instead, right-clicking
1834 on the program or shortcut that you want to run usually gives you a
1835 choice `Run as administrator'.
1836
1837
1838 \subsection{Increasing maximum memory on Windows and Cygwin}
1839 \label{sec:cygwin-maxmem}
1840
1841 Windows and Cygwin (see section~\ref{sec:cygwin} for Cygwin installation
1842 specifics) users may find that they run out of memory when running some
1843 of the programs shipped with \TL. For example, \prog{asy} might run out
1844 of memory if you try to allocate an array of 25,000,000 reals, and
1845 Lua\TeX\ might run out of memory if you try to process a document with a
1846 lot of big fonts.
1847
1848 For Cygwin, you can increase the amount of available memory by following
1849 the instructions in the Cygwin User's Guide
1850 (\url{https://cygwin.com/cygwin-ug-net/setup-maxmem.html}).
1851
1852 For Windows, you have to create a file, say \code{moremem.reg}, with
1853 these four lines:
1854
1855 \begin{sverbatim}
1856 Windows Registry Editor Version 5.00
1857
1858 [HKEY_LOCAL_MACHINE\Software\Cygwin]
1859 "heap_chunk_in_mb"=dword:ffffff00
1860 \end{sverbatim}
1861
1862 \noindent and then execute the command \code{regedit /s moremem.reg} as
1863 administrator. (If you want to change memory only for the current user
1864 instead of system-wide, use \code{HKEY\_CURRENT\_USER}.)
1865
1866
1867 \section{A user's guide to Web2C}
1868
1869 \Webc{} is an integrated collection of \TeX-related programs: \TeX{}
1870 itself, \MF{}, \MP, \BibTeX{}, etc. It is the heart of \TL{}. The home
1871 page for \Webc{}, with the current manual and more, is
1872 \url{https://tug.org/web2c}.
1873
1874 A bit of history: The original implementation was by Tomas Rokicki who,
1875 in 1987, developed a first \TeX{}-to-C system based on change files
1876 under Unix, which were primarily the original work of Howard Trickey and
1877 Pavel Curtis. Tim Morgan became the maintainer of the system, and
1878 during this period the name changed to Web-to-C\@. In 1990, Karl Berry
1879 took over the work, assisted by dozens of additional contributors, and
1880 in 1997 he handed the baton to Olaf Weber, who returned it to Karl in
1881 2006.
1882
1883 The \Webc{} system runs on Unix, Windows, \macOS{}, and other operating
1884 systems. It uses Knuth's original sources for \TeX{} and other basic
1885 programs written in the \web{} literate programming system and
1886 translates them into C source code. The core \TeX{} programs handled in
1887 this way are:
1888
1889 \begin{cmddescription}
1890 \item[bibtex] Maintaining bibliographies.
1891 \item[dvicopy] Expands virtual font references in \dvi{} files.
1892 \item[dvitomp] \dvi{} to MPX (MetaPost pictures).
1893 \item[dvitype] \dvi{} to human-readable text.
1894 \item[gftodvi] Generic font proofsheets.
1895 \item[gftopk] Generic to packed fonts.
1896 \item[gftype] GF to human-readable text.
1897 \item[mf] Creating typeface families.
1898 \item[mft] Prettyprinting \MF{} source.
1899 \item[mpost] Creating technical diagrams.
1900 \item[patgen] Creating hyphenation patterns.
1901 \item[pktogf] Packed to generic fonts.
1902 \item[pktype] PK to human-readable text.
1903 \item[pltotf] Plain text property list to TFM.
1904 \item[pooltype] Display \web{} pool files.
1905 \item[tangle] \web{} to Pascal.
1906 \item[tex] Typesetting.
1907 \item[tftopl] TFM to plain text property list.
1908 \item[vftovp] Virtual font to virtual property list.
1909 \item[vptovf] Virtual property list to virtual font.
1910 \item[weave] \web{} to \TeX.
1911 \end{cmddescription}
1912
1913 \noindent The precise functions and syntax of these programs are
1914 described in the documentation of the individual packages and of \Webc{}
1915 itself. However, knowing a few principles governing the whole family of
1916 programs will help you take advantage of your \Webc{} installation.
1917
1918 All programs honor these standard \GNU options:
1919 \begin{ttdescription}
1920 \item[-{}-help] print basic usage summary.
1921 \item[-{}-version] print version information, then exit.
1922 \end{ttdescription}
1923
1924 And most also honor:
1925 \begin{ttdescription}
1926 \item[-{}-verbose] print detailed progress report.
1927 \end{ttdescription}
1928
1929 For locating files the \Webc{} programs use the path searching library
1930 \KPS{} (\url{https://tug.org/kpathsea}). This library uses a combination
1931 of environment variables and configuration files to optimize searching
1932 the (huge) collection of \TeX{} files. \Webc{} can look at many
1933 directory trees simultaneously, which is useful in maintaining \TeX's
1934 standard distribution and local and personal extensions in distinct
1935 trees. To speed up file searches, the root of each tree has a file
1936 \file{ls-R}, containing an entry showing the name and relative pathname
1937 for all files under that root.
1938
1939
1940 \subsection{Kpathsea path searching}
1941 \label{sec:kpathsea}
1942
1943 Let us first describe the generic path searching mechanism of the \KPS{}
1944 library.
1945
1946 We call a \emph{search path} a colon- or semicolon\hyph sepa\-rated list
1947 of \emph{path elements}, which are basically directory names. A
1948 search path can come from (a combination of) many sources. To look up
1949 a file \samp{my-file} along a path \samp{.:/dir}, \KPS{} checks each
1950 element of the path in turn: first \file{./my-file}, then
1951 \file{/dir/my-file}, returning the first match (or possibly all
1952 matches).
1953
1954 In order to adapt optimally to all operating systems' conventions, on
1955 non-Unix systems \KPS{} can use filename separators different from
1956 colon (\samp{:}) and slash (\samp{/}).
1957
1958 To check a particular path element \var{p}, \KPS{} first checks if a
1959 prebuilt database (see ``Filename data\-base'' on
1960 page~\pageref{sec:filename-database}) applies to \var{p}, i.e., if the
1961 database is in a directory that is a prefix of \var{p}. If so, the path
1962 specification is matched against the contents of the database.
1963
1964 Although the simplest and most common path element is a directory
1965 name, \KPS{} supports additional features in search paths: layered
1966 default values, environment variable names, config file values, users'
1967 home directories, and recursive subdirectory searching. Thus, we say
1968 that \KPS{} \emph{expands} a path element, meaning it transforms all
1969 the specifications into basic directory name or names. This is
1970 described in the following sections in the same order as it takes
1971 place.
1972
1973 Note that if the filename being searched for is absolute or explicitly
1974 relative, i.e., starts with \samp{/} or \samp{./} or \samp{../},
1975 \KPS{} simply checks if that file exists.
1976
1977 \ifSingleColumn
1978 \else
1979 \begin{figure*}
1980 \verbatiminput{examples/ex5.tex}
1981 \setlength{\abovecaptionskip}{0pt}
1982 \caption{An illustrative configuration file sample}
1983 \label{fig:config-sample}
1984 \end{figure*}
1985 \fi
1986
1987 \subsubsection{Path sources}
1988 \label{sec:path-sources}
1989
1990 A search path can come from many sources. In the order in which
1991 \KPS{} uses them:
1992
1993 \begin{enumerate}
1994 \item
1995 A user-set environment variable, for instance, \envname{TEXINPUTS}\@.
1996 Environment variables with a period and a program name appended
1997 override; e.g., if \samp{latex} is the name of the program being run,
1998 then \envname{TEXINPUTS.latex} will override \envname{TEXINPUTS}.
1999 \item
2000 A program-specific configuration file, for exam\-ple, a line
2001 \samp{S /a:/b} in \cmdname{dvips}'s \file{config.ps}.
2002 \item A \KPS{} configuration file \file{texmf.cnf}, containing a line like
2003 \samp{TEXINPUTS=/c:/d} (see below).
2004 \item The compile-time default.
2005 \end{enumerate}
2006 \noindent You can see each of these values for a given search path by
2007 using the debugging options (see ``Debugging actions'' on
2008 page~\pageref{sec:debugging}).
2009
2010 \subsubsection{Config files}
2011 \label{sec:configfiles}
2012
2013 \KPS{} reads \emph{runtime configuration files} named \file{texmf.cnf}
2014 for search path and other definitions. The search path
2015 \envname{TEXMFCNF} is used to look for these files, but we do not
2016 recommend setting this (or any) environment variable to override the
2017 system directories.
2018
2019 Instead, normal installation results in a file
2020 \file{.../2026/texmf.cnf}. If you must make changes to the defaults
2021 (not normally necessary), this is the place to put them. The main
2022 configuration file is in \file{.../2026/texmf-dist/web2c/texmf.cnf}.
2023 You should not edit this latter file, as your changes will be lost when
2024 the distributed version is updated.
2025
2026 As an aside, if you merely wish to add a personal directory to a
2027 particular search path, setting an environment variable is a reasonable
2028 method:
2029 \begin{verbatim}
2030 TEXINPUTS=.:/my/macro/dir:
2031 \end{verbatim}
2032 To keep the setting maintainable and portable over the years, use a
2033 trailing \samp{:} (\samp{;} on Windows) to insert the system paths,
2034 instead of trying to write them all out explicitly (see
2035 section~\ref{sec:default-expansion}). Another option is to use the
2036 \envname{TEXMFHOME} tree (see section~\ref{sec:directories}).
2037
2038 \emph{All} \file{texmf.cnf} files in the search path will be read and
2039 definitions in earlier files override those in later files. For
2040 example, with a search path of \verb|.:$TEXMF|, values from
2041 \file{./texmf.cnf} override those from \verb|$TEXMF/texmf.cnf|.
2042
2043 \begin{itemize*}
2044 \item
2045 Comments start with \code{\%}, either at the beginning of a line or
2046 preceded by whitespace, and continue to the end of the line.
2047 \item
2048 Blank lines are ignored.
2049 \item
2050 A \bs{} at the end of a line acts as a continuation character,
2051 i.e., the next line is appended. Whitespace at the beginning of
2052 continuation lines is not ignored.
2053 \item
2054 Each remaining line has the form:\\
2055 \hspace*{2em}\texttt{\var{variable} \textrm{[}.\var{progname}\textrm{]}
2056 \textrm{[}=\textrm{]} \var{value}}\\[1pt]
2057 where the \samp{=} and surrounding whitespace are optional.
2058 (But if \var{value} begins with \samp{.}, it is simplest to use the
2059 \samp{=} to avoid the period being interpreted as the program name
2060 qualifier.)
2061 \item
2062 The \ttvar{variable} name may contain any character other
2063 than whitespace, \samp{=}, or \samp{.}, but sticking to
2064 \samp{A-Za-z\_} is safest.
2065 \item
2066 If \samp{.\var{progname}} is present, the definition only
2067 applies if the program that is running is named
2068 \texttt{\var{progname}} or \texttt{\var{progname}.exe}. This allows
2069 different flavors of \TeX{} to have different search paths, for
2070 example.
2071 \item Considered as strings, \var{value} may contain any character.
2072 However, in practice most \file{texmf.cnf} values are related to path
2073 expansion, and since various special characters are used in expansion
2074 (see section~\ref{sec:cnf-special-chars}), such as braces and commas,
2075 they cannot be used in directory names.
2076
2077 A \samp{;} in \var{value} is translated to \samp{:} if running under
2078 Unix, in order to have a single \file{texmf.cnf} that can support both
2079 Unix and Windows systems. This translation happens with any value, not
2080 just search paths, but fortunately in practice \samp{;} is not needed
2081 in other values.
2082
2083 The \code{\$\var{var}.\var{prog}} feature is not available on the
2084 right-hand side; instead, you must use an additional variable.
2085
2086 \item
2087 All definitions are read before anything is expanded, so
2088 variables can be referenced before they are defined.
2089 \end{itemize*}
2090 A configuration file fragment illustrating most of these points is
2091 \ifSingleColumn
2092 shown below:
2093
2094 \verbatiminput{examples/ex5.tex}
2095 \else
2096 shown in figure~\ref{fig:config-sample}.
2097 \fi
2098
2099 \subsubsection{Path expansion}
2100 \label{sec:path-expansion}
2101
2102 \KPS{} recognizes certain special characters and constructions in
2103 search paths, similar to those available in Unix shells. As a
2104 general example, the path
2105 \verb+~$USER/{foo,bar}//baz+, expands to all subdirectories under
2106 directories \file{foo} and \file{bar} in \texttt{\$USER}'s home
2107 directory that contain a directory or file \file{baz}. These
2108 expansions are explained in the sections below.
2109 %$
2110 \subsubsection{Default expansion}
2111 \label{sec:default-expansion}
2112
2113 If the highest-priority search path (see ``Path sources'' on
2114 page~\pageref{sec:path-sources}) contains an \emph{extra colon} (i.e.,
2115 leading, trailing, or doubled), \KPS{} inserts at that point the
2116 next-highest-prio\-rity search path that is defined. If that inserted
2117 path has an extra colon, the same happens with the next highest. For
2118 example, given an environment variable setting
2119
2120 \begin{alltt}
2121 > \Ucom{setenv TEXINPUTS /home/karl:}
2122 \end{alltt}
2123 and a \code{TEXINPUTS} value from \file{texmf.cnf} of
2124
2125 \begin{alltt}
2126 .:\$TEXMF//tex
2127 \end{alltt}
2128 then the final value used for searching will be:
2129
2130 \begin{alltt}
2131 /home/karl:.:\$TEXMF//tex
2132 \end{alltt}
2133
2134 Since it would be useless to insert the default value in more than one
2135 place, \KPS{} changes only one extra \samp{:}\ and leaves any others in
2136 place. It checks first for a leading \samp{:}, then a trailing
2137 \samp{:}, then a doubled \samp{:}.
2138
2139 \subsubsection{Brace expansion}
2140 \label{sec:brace-expansion}
2141
2142 A useful feature is brace expansion, which means that, for instance,
2143 \verb+v{a,b}w+ expands to \verb+vaw:vbw+. Nesting is allowed.
2144 This is used to implement multiple \TeX{} hierarchies, by
2145 assigning a brace list to \code{\$TEXMF}.
2146 In the distributed \file{texmf.cnf}, a definition like this
2147 (simplified for this example) is made:
2148 \begin{verbatim}
2149 TEXMF = {$TEXMFVAR,$TEXMFHOME,!!$TEXMFLOCAL,!!$TEXMFDIST}
2150 \end{verbatim}
2151 We then use this to define, for example, the \TeX\ input path:
2152 \begin{verbatim}
2153 TEXINPUTS = .;$TEXMF/tex//
2154 \end{verbatim}
2155 %$
2156 which means that, after looking in the current directory, the
2157 \code{\$TEXMFVAR/tex}, \code{\$TEXMFHOME/tex}, \code{\$TEXMFLOCAL/tex}
2158 and \code{\$TEXMFDIST/tex} trees will be searched (the
2159 last two using \file{ls-R} data base files).
2160
2161 \subsubsection{Subdirectory expansion}
2162 \label{sec:subdirectory-expansion}
2163
2164 Two or more consecutive slashes in a path element following a directory
2165 \var{d} is replaced by all subdirectories of \var{d\/}: first those
2166 subdirectories directly under \var{d}, then the subsubdirectories under
2167 those, and so on. At each level, the order in which the directories are
2168 searched is \emph{unspecified}.
2169
2170 If you specify any filename components after the \samp{//}, only
2171 subdirectories with matching components are included. For example,
2172 \samp{/a//b} expands into directories \file{/a/1/b}, \file{/a/2/b},
2173 \file{/a/1/1/b}, and so on, but not \file{/a/b/c} or \file{/a/1}.
2174
2175 Multiple \samp{//} constructs in a path are possible, but
2176 \samp{//} at the beginning of a path is ignored.
2177
2178 \subsubsection{Summary of special characters in \file{texmf.cnf} files}
2179 \label{sec:cnf-special-chars}
2180
2181 The following list summarizes the special characters and constructs in
2182 \KPS{} configuration files.
2183
2184 % need a wider space for the item labels here.
2185 \newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
2186 \begin{ttdescription}
2187 \item[\CODE{:}] Separator in path specification; at the beginning or
2188 the end of a path, or doubled in the middle, it substitutes the
2189 default path expansion.\par
2190 \item[\CODE{;}] Separator on non-Unix systems (acts like \code{:}).
2191 \item[\CODE{\$}] Variable expansion.
2192 \item[\CODE{\string~}] Represents the user's home directory.
2193 \item[\CODE{\char`\{...\char`\}}] Brace expansion.
2194 \item[\CODE{,}] Separates items in brace expansion.
2195 \item[\CODE{//}] Subdirectory expansion (can occur anywhere in
2196 a path, except at its beginning).
2197 \item[\CODE{\%{\rm\ and }\#}] Start of comment.
2198 \item[\CODE{\bs}] At the end of a line, continuation character to allow
2199 multi-line entries.
2200 \item[\CODE{!!}] Search \emph{only} database to locate file, \emph{do
2201 not} search the disk.
2202 \end{ttdescription}
2203
2204 Exactly when a character will be considered special or act as itself
2205 depends on the context in which it is used. The rules are inherent in
2206 the multiple levels of interpretation of the configuration (parsing,
2207 expansion, search, \ldots)\ and so cannot be concisely stated,
2208 unfortunately. There is no general escape mechanism; in particular,
2209 \samp{\bs} is not an ``escape character'' in \file{texmf.cnf} files.
2210
2211 When it comes choosing directory names for installation, it is safest to
2212 avoid them all.
2213
2214 \subsection{Filename databases}
2215 \label{sec:filename-database}
2216
2217 \KPS{} goes to some lengths to minimize disk accesses for searches.
2218 Nevertheless, in the standard \TL, or at any installation with enough
2219 directories, searching every possible directory for a given file will
2220 take an excessively long time. Therefore, \KPS{} can use an
2221 externally-built plain text ``database'' file named \file{ls-R} that
2222 maps files to directories, thus avoiding the need to exhaustively search
2223 the disk.
2224
2225 A second database file \file{aliases} allows you to give additional
2226 names to the files listed in \file{ls-R}.
2227
2228 \subsubsection{The filename database}
2229 \label{sec:ls-R}
2230
2231 As explained above, the name of the main filename database must be
2232 \file{ls-R}. You can put one at the root of each \TeX{} hierarchy in
2233 your installation that you wish to be searched (\code{\$TEXMF} by
2234 default). \KPS{} looks for
2235 \file{ls-R} files along the \code{TEXMFDBS} path.
2236
2237 The recommended way to create and maintain \samp{ls-R} is to run the
2238 \code{mktexlsr} script included with the distribution. It is invoked
2239 by the various \samp{mktex}\dots\ scripts. In principle, this script
2240 just runs the command
2241 \begin{alltt}
2242 cd \var{/your/texmf/root} && \path|\|ls -1LAR ./ >ls-R
2243 \end{alltt}
2244 presuming your system's \code{ls} produces the right output format
2245 (\GNU \code{ls} is all right). To ensure that the database is
2246 always up-to-date, it is easiest to rebuild it regularly via
2247 \code{cron}, so that it is automatically updated when the installed
2248 files change, such as after installing or updating a \LaTeX{} package.
2249
2250 If a file is not found in the database, by default \KPS{} goes ahead
2251 and searches the disk. If a particular path element begins with
2252 \samp{!!}, however, \emph{only} the database will be searched for that
2253 element, never the disk.
2254
2255
2256 \subsubsection{kpsewhich: Standalone path searching}
2257 \label{sec:invoking-kpsewhich}
2258
2259 The \texttt{kpsewhich} program exercises path searching independent of any
2260 particular application. This can be useful as a sort of \code{find}
2261 program to locate files in \TeX{} hierarchies (this is used heavily in
2262 the distributed \samp{mktex}\dots\ scripts).
2263
2264 \begin{alltt}
2265 > \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}}
2266 \end{alltt}
2267 The options specified in \ttvar{option} start with either \samp{-}
2268 or \samp{-{}-}, and any unambiguous abbreviation is accepted.
2269
2270 \KPS{} looks up each non-option argument on the command line as a
2271 filename, and returns the first file found. There is no option to
2272 return all the files with a particular name (you can run the Unix
2273 \samp{find} utility for that).
2274
2275 The most common options are described next.
2276
2277 \begin{ttdescription}
2278 \item[\texttt{-{}-dpi=\var{num}}]\mbox{}
2279 Set the resolution to \ttvar{num}; this only affects \samp{gf}
2280 and \samp{pk} lookups. \samp{-D} is a synonym, for compatibility
2281 with \cmdname{dvips}. Default is 600.
2282
2283 \item[\texttt{-{}-format=\var{name}}]\mbox{}\\
2284 Set the format for lookup to \ttvar{name}. By default, the
2285 format is guessed from the filename. For formats which do not have
2286 an associated unambiguous suffix, such as \MP{} support files and
2287 \cmdname{dvips} configuration files, you have to specify the name as
2288 known to \KPS{}, such as \texttt{tex} or \texttt{enc files}. Run
2289 \texttt{kpsewhich -{}-help-formats} for a list.
2290
2291 \item[\texttt{-{}-mode=\var{string}}]\mbox{}\\
2292 Set the mode name to \ttvar{string}; this only affects \samp{gf}
2293 and \samp{pk} lookups. No default: any mode will be found.
2294 \item[\texttt{-{}-must-exist}]\mbox{}\\
2295 Do everything possible to find the files, notably including
2296 searching the disk. By default, only the \file{ls-R} database is
2297 checked, in the interest of efficiency.
2298 \item[\texttt{-{}-path=\var{string}}]\mbox{}\\
2299 Search along the path \ttvar{string} (colon-separated as usual),
2300 instead of guessing the search path from the filename. \samp{//} and
2301 all the usual expansions are supported. The options \samp{-{}-path}
2302 and \samp{-{}-format} are mutually exclusive.
2303 \item[\texttt{-{}-progname=\var{name}}]\mbox{}\\
2304 Set the program name to \texttt{\var{name}}.
2305 This can affect the search paths via the \texttt{.\var{progname}}
2306 feature.
2307 The default is \cmdname{kpsewhich}.
2308 \item[\texttt{-{}-show-path=\var{name}}]\mbox{}\\
2309 shows the path used for file lookups of file type \texttt{\var{name}}.
2310 Either a filename extension (\code{.pk}, \code{.vf}, etc.) or a
2311 name can be used, just as with \samp{-{}-format} option.
2312 \item[\texttt{-{}-debug=\var{num}}]\mbox{}\\
2313 sets the debugging options to \texttt{\var{num}}.
2314 \end{ttdescription}
2315
2316
2317 \subsubsection{Examples of use}
2318 \label{sec:examples-of-use}
2319
2320 Let us now have a look at \KPS{} in action. Here's a straightforward search:
2321
2322 \begin{alltt}
2323 > \Ucom{kpsewhich article.cls}
2324 /usr/local/texmf-dist/tex/latex/base/article.cls
2325 \end{alltt}
2326 We are looking for the file \file{article.cls}. Since the \samp{.cls}
2327 suffix is unambiguous we do not need to specify that we want to look for a
2328 file of type \optname{tex} (\TeX{} source file directories). We find it in
2329 the subdirectory \file{tex/latex/base} below the \samp{texmf-dist} \TL\
2330 directory. Similarly, all of the following are found without problems
2331 thanks to their unambiguous suffix.
2332 \begin{alltt}
2333 > \Ucom{kpsewhich array.sty}
2334 /usr/local/texmf-dist/tex/latex/tools/array.sty
2335 > \Ucom{kpsewhich latin1.def}
2336 /usr/local/texmf-dist/tex/latex/base/latin1.def
2337 > \Ucom{kpsewhich size10.clo}
2338 /usr/local/texmf-dist/tex/latex/base/size10.clo
2339 > \Ucom{kpsewhich small2e.tex}
2340 /usr/local/texmf-dist/tex/latex/base/small2e.tex
2341 > \Ucom{kpsewhich tugboat.bib}
2342 /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
2343 \end{alltt}
2344
2345 By the way, that last is a \BibTeX{} bibliography database for
2346 \textsl{TUGboat} articles.
2347
2348 \begin{alltt}
2349 > \Ucom{kpsewhich cmr10.pk}
2350 \end{alltt}
2351 Font bitmap glyph files of type \file{.pk} are used by display
2352 programs like \cmdname{dvips} and \cmdname{xdvi}. Nothing is returned in
2353 this case since there are no pre-generated Computer Modern \samp{.pk}
2354 files in \TL{}\Dash the Type~1 variants are used by default.
2355 \begin{alltt}
2356 > \Ucom{kpsewhich wsuipa10.pk}
2357 \ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
2358 \else /usr/local/texmf-var/fonts/pk/ljfour/public/
2359 ... wsuipa/wsuipa10.600pk
2360 \fi\end{alltt}
2361 For these fonts (a phonetic alphabet from the University of Washington)
2362 we had to generate \samp{.pk} files, and since the default \MF{} mode on
2363 our installation is \texttt{ljfour} with a base resolution of 600\dpi{}
2364 (dots per inch), this instantiation is returned.
2365 \begin{alltt}
2366 > \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
2367 \end{alltt}
2368 In this case, when specifying that we are interested in a resolution
2369 of 300\dpi{} (\texttt{-dpi=300}) we see that no such font is available on
2370 the system. A program like \cmdname{dvips} or \cmdname{xdvi} would
2371 go off and actually build the required \texttt{.pk} files
2372 using the script \cmdname{mktexpk}.
2373
2374 Next we turn our attention to \cmdname{dvips}'s header and configuration
2375 files. We first look at one of the commonly used files, the general
2376 prologue \file{tex.pro} for \TeX{} support, before turning our attention
2377 to the generic configuration file (\file{config.ps}) and the \PS{} font
2378 map \file{psfonts.map}\Dash as of 2004, map and encoding files have
2379 their own search paths and new location in \dirname{texmf} trees. As
2380 the \samp{.ps} suffix is ambiguous we have to specify explicitly which
2381 type we are considering (\optname{dvips config}) for the file
2382 \texttt{config.ps}.
2383 \begin{alltt}
2384 > \Ucom{kpsewhich tex.pro}
2385 /usr/local/texmf/dvips/base/tex.pro
2386 > \Ucom{kpsewhich --format="dvips config" config.ps}
2387 /usr/local/texmf/dvips/config/config.ps
2388 > \Ucom{kpsewhich psfonts.map}
2389 /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map
2390 \end{alltt}
2391
2392 We now take a closer look at the URW Times \PS{} support
2393 files. The prefix for these in the standard font naming scheme is
2394 \samp{utm}. The first file we look at is the configuration file,
2395 which contains the name of the map file:
2396 \begin{alltt}
2397 > \Ucom{kpsewhich --format="dvips config" config.utm}
2398 /usr/local/texmf-dist/dvips/psnfss/config.utm
2399 \end{alltt}
2400 The contents of that file is
2401 \begin{alltt}
2402 p +utm.map
2403 \end{alltt}
2404 which points to the file \file{utm.map}, which we want to
2405 locate next.
2406 \begin{alltt}
2407 > \Ucom{kpsewhich utm.map}
2408 /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
2409 \end{alltt}
2410 This map file defines the file names of the Type~1 \PS{} fonts in
2411 the URW collection. Its contents look like (we only show part of the
2412 lines):
2413 \begin{alltt}
2414 utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
2415 utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
2416 utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
2417 utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
2418 utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
2419 utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
2420 \end{alltt}
2421 Let us, for instance, take the Times Roman instance
2422 \file{utmr8a.pfb} and find its position in the \file{texmf} directory
2423 tree with a search for Type~1 font files:
2424 \begin{alltt}
2425 > \Ucom{kpsewhich utmr8a.pfb}
2426 \ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
2427 \else /usr/local/texmf-dist/fonts/type1/
2428 ... urw/utm/utmr8a.pfb
2429 \fi\end{alltt}
2430
2431 It should be evident from these examples how you can easily locate the
2432 whereabouts of a given file. This is especially important if you suspect
2433 that the wrong version of a file is picked up somehow, since
2434 \cmdname{kpsewhich} will show you the first file encountered.
2435
2436 \subsubsection{Debugging actions}
2437 \label{sec:debugging}
2438
2439 Sometimes it is necessary to investigate how a program resolves file
2440 references. To make this practical, \KPS{} offers various levels of
2441 debugging output:
2442
2443 \begin{ttdescription}
2444 \item[\texttt{\ 1}] \texttt{stat} calls (disk lookups). When running
2445 with an up-to-date \file{ls-R} database this should almost give no
2446 output.
2447 \item[\texttt{\ 2}] References to hash tables (such as \file{ls-R}
2448 databases, map files, configuration files).
2449 \item[\texttt{\ 4}] File open and close operations.
2450 \item[\texttt{\ 8}] General path information for file types
2451 searched by \KPS. This is useful to find out where a particular
2452 path for the file was defined.
2453 \item[\texttt{16}] Directory list for each path element (only relevant
2454 for searches on disk).
2455 \item[\texttt{32}] File searches.
2456 \item[\texttt{64}] Variable values.
2457 \end{ttdescription}
2458 A value of \texttt{-1} will set all the above options; in practice,
2459 this is usually the most convenient.
2460
2461 Similarly, with the \cmdname{dvips} program, by setting a combination of
2462 debug switches, one can follow in detail where files are being picked up
2463 from. Alternatively, when a file is not found, the debug trace shows in
2464 which directories the program looks for the given file, so that one can
2465 get an indication what the problem~is.
2466
2467 Generally speaking, as most programs call the \KPS{} library
2468 internally, one can select a debug option by using the
2469 \envname{KPATHSEA\_DEBUG} environment variable, and setting it to (a
2470 combination of) values as described in the above list.
2471
2472 (Note for Windows users: it is not easy to redirect
2473 all messages to a file in this system. For diagnostic purposes
2474 you can temporarily \texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log}).
2475
2476 Let us consider, as an example, a small \LaTeX{} source file,
2477 \file{hello-world.tex}, which contains the following input.
2478 \begin{verbatim}
2479 \documentclass{article}
2480 \begin{document}
2481 Hello World!
2482 \end{document}
2483 \end{verbatim}
2484 This little file only uses the font \file{cmr10}, so let us look at
2485 how \cmdname{dvips} prepares the \PS{} file (we want to use the Type~1
2486 version of the Computer Modern fonts, hence the option \texttt{-Pcms}).
2487 \begin{alltt}
2488 > \Ucom{dvips -d4100 hello-world -Pcms -o}
2489 \end{alltt}
2490 In this case we have combined \cmdname{dvips}'s debug class 4 (font
2491 paths) with \KPS's path element expansion (see the \cmdname{dvips}
2492 reference manual).
2493 The output (slightly rearranged) appears in
2494 Figure~\ref{fig:dvipsdbga}.
2495 \begin{figure*}[tp]
2496 \centering
2497 \input{examples/ex6a.tex}
2498 \caption{Finding configuration files}\label{fig:dvipsdbga}
2499 \end{figure*}
2500
2501 \cmdname{dvips} starts by locating its working files. First,
2502 \file{texmf.cnf} is found, which gives the definitions of the search
2503 paths for the other files, then the file database \file{ls-R} (to
2504 optimize file searching) and the file \file{aliases}, which makes it
2505 possible to declare several names (e.g., a short DOS-like 8.3 and
2506 a more natural longer version) for the same file. Then \cmdname{dvips}
2507 goes on to find the generic configuration file \file{config.ps}
2508 before looking for the customization file \file{.dvipsrc} (which, in
2509 this case is \emph{not found}). Finally, \cmdname{dvips} locates the
2510 config file for the Computer Modern \PS{} fonts \file{config.cms}
2511 (this was initiated with the \texttt{-Pcms} option on the \cmdname{dvips}
2512 command). This file contains the list of the map files which
2513 define the relation between the \TeX{}, \PS{} and file system
2514 names of the fonts.
2515 \begin{alltt}
2516 > \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
2517 p +ams.map
2518 p +cms.map
2519 p +cmbkm.map
2520 p +amsbkm.map
2521 \end{alltt}
2522 \cmdname{dvips} thus goes on to find all these files, plus the generic
2523 map file \file{psfonts.map}, which is always loaded (it contains
2524 declarations for commonly used \PS{} fonts; see the last part of
2525 section~\ref{sec:examples-of-use} for more details about \PS{} map
2526 file handling).
2527
2528 At this point \cmdname{dvips} identifies itself to the user:
2529 \begin{alltt}
2530 This is dvips(k) 5.92b Copyright 2002 Radical Eye Software
2531 \end{alltt}
2532 \ifSingleColumn
2533 Then it goes on to look for the prolog file \file{texc.pro}:
2534 \begin{alltt}\small
2535 kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
2536 path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
2537 ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
2538 kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
2539 \end{alltt}
2540 \else
2541 Then it goes on to look for the prolog file \file{texc.pro} (see
2542 Figure~\ref{fig:dvipsdbgb}).
2543 \fi
2544
2545 After having found the file in question, \cmdname{dvips} outputs
2546 the date and time, and informs us that it will generate the
2547 file \file{hello-world.ps}, then that it needs the font file
2548 \file{cmr10}, and that the latter is declared as ``resident'' (no
2549 bitmaps needed):
2550 \begin{alltt}\small
2551 TeX output 1998.02.26:1204' -> hello-world.ps
2552 Defining font () cmr10 at 10.0pt
2553 Font cmr10 <CMR10> is resident.
2554 \end{alltt}
2555 Now the search is on for the file \file{cmr10.tfm}, which is found,
2556 then a few more prolog files (not shown) are referenced, and finally
2557 the Type~1 instance \file{cmr10.pfb} of the font is located and
2558 included in the output file (see last line).
2559 \begin{alltt}\small
2560 kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
2561 path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
2562 /var/tex/fonts/tfm//).
2563 kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
2564 kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
2565 ...
2566 <texps.pro>
2567 kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
2568 path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
2569 ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
2570 kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
2571 <cmr10.pfb>[1]
2572 \end{alltt}
2573
2574 \subsection{Runtime options}
2575
2576 Another useful feature of \Webc{} is its possibility to control a number
2577 of memory parameters (in particular, array sizes) via the runtime file
2578 \file{texmf.cnf} read by \KPS{}. The memory settings can be found in
2579 Part~3 of that file in the \TL{} distribution. The more important
2580 are:
2581
2582 \begin{ttdescription}
2583 \item[\texttt{main\_memory}]
2584 Total words of memory available, for
2585 \TeX{}, \MF{} and \MP. You must make a new format file for each
2586 different setting. For instance, you could generate a ``huge''
2587 version of \TeX{}, and call the format file \texttt{hugetex.fmt}.
2588 Using the standard way of specifying the program name used by \KPS{},
2589 the particular value of the \texttt{main\_memory} variable will then
2590 be read from \file{texmf.cnf}.
2591 \item[\texttt{extra\_mem\_bot}]
2592 Extra space for ``large'' \TeX{} data structures:
2593 boxes, glue, breakpoints, etc. Especially useful if you use
2594 \PiCTeX{}.
2595 \item[\texttt{font\_mem\_size}]
2596 Number of words for font information available for \TeX. This
2597 is more or less the total size of all TFM files read.
2598 \item[\texttt{hash\_extra}]
2599 Additional space for the hash table of control sequence names; its
2600 default value is \texttt{600000}.
2601 \end{ttdescription}
2602
2603 \noindent This facility is no substitute for truly dynamic
2604 arrays and memory allocation, but since these are extremely difficult to
2605 implement in the present \TeX{} source, these runtime parameters provide
2606 a practical compromise allowing some flexibility.
2607
2608 \htmlanchor{texmfdotdir}
2609 \subsection{\texttt{\$TEXMFDOTDIR}}
2610 \label{sec:texmfdotdir}
2611
2612 In various places above, we gave various search paths starting with
2613 \code{.} (to search the current directory first), as in
2614 \begin{alltt}\small
2615 TEXINPUTS=.;$TEXMF/tex//
2616 \end{alltt}
2617
2618 This is a simplification. The \code{texmf.cnf} file we distribute in
2619 \TL{} uses \filename{$TEXMFDOTDIR} instead of just \samp{.}, as in:
2620 \begin{alltt}\small
2621 TEXINPUTS=$TEXMFDOTDIR;$TEXMF/tex//
2622 \end{alltt}
2623 (In the distributed file, the second path element is also slightly more
2624 complicated than \filename{$TEXMF/tex//}. But that's minor; here we want
2625 to discuss the \filename{$TEXMFDOTDIR} feature.)
2626
2627 The reason to use the variable \filename{$TEXMFDOTDIR} in the path
2628 definitions instead of simply \samp{.} is purely so that it can be
2629 overridden. For example, a complex document may have many source files
2630 arranged in many subdirectories. To handle that, you can set
2631 \filename{TEXMFDOTDIR} to \filename{.//} (for example, in the environment when
2632 you build the document) and they will all get searched. (Warning: don't
2633 use \filename{.//} by default; it's usually highly undesirable, and
2634 potentially insecure, to search through all subdirectories for an
2635 arbitrary document.)
2636
2637 As another example, you may wish not to search the current directory at
2638 all, e.g., if you have arranged for all the files to be found via
2639 explicit paths. You can set \filename{$TEXMFDOTDIR} to, say,
2640 \filename{/nonesuch} or any nonexistent directory for this.
2641
2642 The default value of \filename{$TEXMFDOTDIR} is just \samp{.}, as set in our
2643 \filename{texmf.cnf}.
2644
2645 \htmlanchor{ack}
2646 \section{Acknowledgements}
2647
2648 \TL{} is a joint effort by virtually all of the \TeX{} user groups.
2649 This edition of \TL{} was overseen by Karl Berry. The other principal
2650 contributors, past and present, are listed below.
2651
2652 \begin{itemize*}
2653
2654 \item The English, German, Dutch, and Polish \TeX{} user groups
2655 (TUG, DANTE e.V., NTG, and GUST,
2656 respectively), which provide the necessary technical and administrative
2657 infrastructure. Please join the \TeX\ user group near you! See
2658 \url{https://tug.org/usergroups.html}.
2659
2660 \item The CTAN team (\url{https://ctan.org}), which distributes
2661 the \TL{} images and provides the common infrastructure for package
2662 updates, upon which \TL{} depends.
2663
2664 \item Nelson Beebe, for making many platforms available to \TL\
2665 developers, and his own comprehensive testing and unparalleled
2666 bibliographic efforts.
2667
2668 \item John Bowman, for making many changes to his advanced graphics
2669 program Asymptote to make it work in \TL.
2670
2671 \item Peter Breitenlohner and the \eTeX\ team for the stable foundation
2672 of future \TeX's, and Peter specifically for years of stellar help with
2673 \GNU\ autotools and keeping sources up to date. Peter passed away in
2674 October 2015, and we dedicate the continuing work to his memory.
2675
2676 \item Jin-Hwan Cho and all of the DVIPDFM$x$ team, for their
2677 excellent driver and responsiveness to configuration issues.
2678
2679 \item Thomas Esser, without whose marvelous \teTeX{} package \TL{}
2680 would have never existed.
2681
2682 \item Michel Goossens, who co-authored the original documentation.
2683
2684 \item Eitan Gurari, whose \TeX4ht is used to create the \HTML{}
2685 version of this documentation, and who worked tirelessly to improve it
2686 at short notice, every year. Eitan prematurely passed away in June
2687 2009, and we dedicate this documentation to his memory.
2688
2689 \item Hans Hagen, for much testing and making his \ConTeXt\ package
2690 (\url{https://pragma-ade.com}) work within \TL's framework, and
2691 continually driving \TeX\ development.
2692
2693 \item \Thanh, Martin Schr\"oder, and the pdf\TeX\ team
2694 (\url{http://pdftex.org}), for continuing enhancements of \TeX's
2695 abilities.
2696
2697 \item Hartmut Henkel, for significant development contributions to
2698 pdf\TeX, Lua\TeX, and more.
2699
2700 \item Shunshaku Hirata, for much original and continuing work on DVIPDFM$x$.
2701
2702 \item Taco Hoekwater, for major renewed development efforts on MetaPost and
2703 (Lua)\TeX\ (\url{http://luatex.org}) itself, incorporating
2704 \ConTeXt\ into \TL, giving Kpathsea multi-threaded functionality, and
2705 much more.
2706
2707 \item Khaled Hosny, for substantial work on \XeTeX, DVIPDFM$x$, and
2708 efforts with Arabic and other fonts.
2709
2710 \item Pawe{\l} Jackowski, for the Windows installer \cmdname{tlpm},
2711 and Tomasz {\L}uczak, for \cmdname{tlpmgui}, used in past releases.
2712
2713 \item Akira Kakuto, for providing the Windows binaries and many other
2714 significant development contributions.
2715
2716 \item Jonathan Kew, for developing the remarkable \XeTeX{} engine and
2717 taking the time and trouble to integrate it in \TL{}, as well as the
2718 initial version of the Mac\TeX\ installer, and also for our recommended
2719 front-end \TeX{}works.
2720
2721 \item Hironori Kitagawa, for maintenance of (e)p\TeX\ and related support.
2722
2723 \item Dick Koch, for maintaining Mac\TeX\ (\url{https://tug.org/mactex})
2724 in very close tandem with \TL{}, and for his great good cheer in doing
2725 so.
2726
2727 \item Reinhard Kotucha, for major contributions to the \TL{} 2008
2728 infrastructure and installer, as well as Windows research efforts, the
2729 \texttt{getnonfreefonts} script, and more.
2730
2731 \item Siep Kroonenberg, also for major contributions to the \TL{} 2008
2732 infrastructure and installer, especially on Windows, and for the bulk of
2733 work updating this manual describing those features.
2734
2735 \item Clerk Ma, for engine bug fixes and extensions.
2736
2737 \item Mojca Miklavec, for much help with \ConTeXt, building many binary
2738 sets, and plenty more.
2739
2740 \item Heiko Oberdiek, for the \pkgname{epstopdf} package and many
2741 others, compressing the huge \pkgname{pst-geo} data files so we could
2742 include them, and most of all, for his remarkable work on
2743 \pkgname{hyperref}.
2744
2745 \item Phelype Oleinik, for the group-delimited \cs{input} across engines
2746 in 2020, and more.
2747
2748 \item Petr Ol\v{s}ak, who coordinated and checked all the Czech and Slovak
2749 material very carefully.
2750
2751 \item Toshio Oshima, for his \cmdname{dviout} previewer for Windows.
2752
2753 \item Manuel P\'egouri\'e-Gonnard, for helping with package updates,
2754 documentation improvements, and \cmdname{texdoc} development.
2755
2756 \item Fabrice Popineau, for the original Windows support in \TL{} and
2757 work on the French documentation.
2758
2759 \item Norbert Preining, the principal architect of the current \TL{}
2760 infrastructure and installer, and also for coordinating the Debian
2761 version of \TL{} (together with Frank K\"uster), and doing so much work
2762 along the way.
2763
2764 \item Sebastian Rahtz, for originally creating \TL{} and maintaining it
2765 for many years. Sebastian passed away in March 2016, and we dedicate
2766 the continuing work to his memory.
2767
2768 \item Luigi Scarso, for continuing development of MetaPost, Lua\TeX, and
2769 much more.
2770
2771 \item Andreas Scherer, for \texttt{cwebbin}, the CWEB implementation
2772 used in \TL{}, and continuing maintenance of the original CWEB.
2773
2774 \item Tim Stewart, for creating the torrents.
2775
2776 \item Takuji Tanaka, for maintenance of (e)(u)p\TeX\ and related support.
2777
2778 \item Tomasz Trzeciak, for wide-ranging help with Windows.
2779
2780 \item Vladimir Volovich, for substantial help with porting and other
2781 maintenance issues, and especially for making it feasible to include
2782 \cmdname{xindy}.
2783
2784 \item Staszek Wawrykiewicz, a principal tester for all of \TL{},
2785 and coordinator of the many major Polish contributions: fonts, Windows
2786 installation, and more. Staszek passed away in February 2018, and we
2787 dedicate the continuing work to his memory.
2788
2789 \item Olaf Weber, for his patient maintenance of \Webc\ in past years.
2790
2791 \item Gerben Wierda, for creating and maintaining the original \macOS\
2792 support.
2793
2794 \item Graham Williams, the originator of the \TeX\ Catalogue.
2795
2796 \item Joseph Wright, for much work on making the same primitive
2797 functionality available across engines.
2798
2799 \item Hironobu Yamashita, for much work on p\TeX\ and related support.
2800
2801 \end{itemize*}
2802
2803 Builders of the binaries:
2804 Marc Baudoin (\pkgname{amd64-netbsd}, \pkgname{i386-netbsd}),
2805 Ken Brown (\pkgname{x86\_64-cygwin}),
2806 Akira Kakuto (\pkgname{windows}),
2807 Dick Koch (\pkgname{universal-darwin}),
2808 Mojca Miklavec (\pkgname{x86\_64-darwinlegacy}),
2809 Norbert Preining (%
2810 \pkgname{aarch64-linux},
2811 \pkgname{armhf-linux},
2812 \pkgname{i386-freebsd}, \pkgname{amd64-freebsd},
2813 \pkgname{i386-linux}, \pkgname{x86\_64-linux},
2814 \pkgname{i386-solaris}, \pkgname{x86\_64-solaris},
2815 \pkgname{x86\_64-linuxmusl}).
2816 For information on the \TL{} build process, see
2817 \url{https://tug.org/texlive/build.html}.
2818
2819 Translators of this manual:
2820 Takuto Asakura (Japanese),
2821 Denis Bitouz\'e \& Patrick Bideault (French),
2822 Carlos Enriquez Figueras (Spanish),
2823 Wang Ran, S YS, Jjgod Jiang, Jinsong Zhao, Yue Wang, \& Helin Gai (Chinese),
2824 Nikola Le\v{c}i\'c (Serbian),
2825 Marco Pallante \& Carla Maggi (Italian),
2826 Petr Sojka \& Jan Busa (Czech\slash Slovak),
2827 Boris Veytsman \& Vladimir Lomov (Russian),
2828 Zofia Walczak (Polish),
2829 Adelheid Grob (German). The \TL{} documentation web page
2830 is \url{https://tug.org/texlive/doc.html}.
2831
2832 Of course the most important acknowledgement must go to Donald Knuth,
2833 first for inventing \TeX, and then for giving it to the world.
2834
2835
2836 \section{Release history}
2837 \label{sec:history}
2838
2839 \subsection{Past}
2840
2841 Discussion began in late 1993 when the Dutch \TeX{} Users Group was
2842 starting work on its 4All\TeX{} \CD{} for MS-DOS users, and it
2843 was hoped at that time to issue a single, rational, \CD{} for all
2844 systems. This was too ambitious a target for the time, but it did spawn
2845 not only the very successful 4All\TeX{} \CD{}, but also the TUG
2846 Technical Council working group on a \emph{\TeX{} Directory Structure}
2847 (\url{https://tug.org/tds}), which specified how to create consistent and
2848 manageable collections of \TeX{} support files. A complete draft of the
2849 \TDS{} was published in the December 1995 issue of \textsl{TUGboat}, and
2850 it was clear from an early stage that one desirable product would be a
2851 model structure on \CD{}. The distribution you now have is a very direct
2852 result of the working group's deliberations. It was also clear that the
2853 success of the 4All\TeX{} \CD{} showed that Unix users would benefit
2854 from a similarly easy system, and this is the other main strand of
2855 \TL.
2856
2857 We first undertook to make a new Unix-based \TDS{} \CD{} in the autumn
2858 of 1995, and quickly identified Thomas Esser's \teTeX{} as the ideal
2859 setup, as it already had multi-platform support and was built with
2860 portability across file systems in mind. Thomas agreed to help, and work
2861 began seriously at the start of 1996. The first edition was released in
2862 May 1996. At the start of 1997, Karl Berry completed a major new release
2863 of Web2c, which included nearly all the features which Thomas Esser had
2864 added in \teTeX, and we decided to base the 2nd edition of the \CD{} on
2865 the standard \Webc, with the addition of \teTeX's \texttt{texconfig}
2866 script. The 3rd edition of the \CD{} was based on a major revision of
2867 \Webc, 7.2, by Olaf Weber; at the same time, a new revision of \teTeX
2868 was being made, and \TL{} included almost all of its features. The
2869 4th edition followed the same pattern, using a new version of \teTeX,
2870 and a new release of \Webc{} (7.3). The system now included a complete
2871 Windows setup, thanks to Fabrice Popineau.
2872
2873 For the 5th edition (March 2000) many parts of the \CD{} were revised
2874 and checked, updating hundreds of packages. Package details were stored
2875 in XML files. But the major change for \TL~5 was that all
2876 non-free software was removed. Everything in \TL{} is now intended
2877 to be compatible with the Debian Free Software Guidelines
2878 (\url{https://debian.org/intro/free}); we have done our best to check
2879 the license conditions of all packages, but we would very much
2880 appreciate hearing of any mistakes.
2881
2882 The 6th edition (July 2001) had much more material updated. The major
2883 change was a new install concept: the user could select a more exact set
2884 of needed collections. Language-related collections were completely
2885 reorganized, so selecting any of them installs not only macros, fonts,
2886 etc., but also prepares an appropriate \texttt{language.dat}.
2887
2888 The 7th edition of 2002 had the notable addition of \macOS{} support,
2889 and the usual myriad of updates to all sorts of packages and
2890 programs. An important goal was integration of the source back with
2891 \teTeX, to correct the drift apart in versions~5 and~6.
2892
2893 \subsubsection{2003}
2894
2895 In 2003, with the continuing flood of updates and additions, we found
2896 that \TL{} had grown so large it could no longer be contained on a
2897 single \CD, so we split it into three different distributions.
2898 In addition:
2899
2900 \begin{itemize*}
2901 \item At the request of the \LaTeX{} team, we changed the standard
2902 \cmdname{latex} and \cmdname{pdflatex} commands to now use \eTeX{} (see
2903 \p.\pageref{text:etex}).
2904 \item The new Latin Modern fonts were included (and are recommended).
2905 \item Support for Alpha OSF was removed
2906 (HPUX support was removed previously), since no one had (or
2907 volunteered) hardware available on which to compile new binaries.
2908 \item Windows setup was substantially changed; for the first time
2909 an integrated environment based on XEmacs was introduced.
2910 \item Important supplementary programs for Windows
2911 (Perl, Ghost\-script, Image\-Magick, Ispell) are now installed
2912 in the \TL{} installation directory.
2913 \item Font map files used by \cmdname{dvips}, \cmdname{dvipdfm}
2914 and \cmdname{pdftex} are now generated by the new program
2915 \cmdname{updmap} and installed into \dirname{texmf/fonts/map}.
2916 \item \TeX{}, \MF{}, and \MP{} now, by default, output most input
2917 characters (32 and above) as themselves in output (e.g.,
2918 \verb|\write|) files,
2919 log files, and the terminal, i.e., \emph{not} translated using the
2920 \verb|^^| notation. In \TL{}~7, this translation was
2921 dependent on the system locale settings; now, locale settings do
2922 not influence the \TeX{} programs' behavior. If for some reason
2923 you need the \verb|^^| output, rename the file
2924 \verb|texmf/web2c/cp8bit.tcx|. (Future releases will have cleaner
2925 ways to control this.)
2926 \item This documentation was substantially revised.
2927 \item Finally, since the edition numbers had grown unwieldy,
2928 the version is now simply identified by the year: \TL{} 2003.
2929 \end{itemize*}
2930
2931
2932 \subsubsection{2004}
2933
2934 2004 saw many changes:
2935
2936 \begin{itemize}
2937
2938 \item If you have locally-installed fonts which use their own
2939 \filename{.map} or (much less likely) \filename{.enc} support files, you
2940 may need to move those support files.
2941
2942 \filename{.map} files are now searched for in subdirectories of
2943 \dirname{fonts/map} only (in each \filename{texmf} tree), along the
2944 \envname{TEXFONTMAPS} path. Similarly, \filename{.enc} files are now
2945 searched for in subdirectories of \dirname{fonts/enc} only, along the
2946 \envname{ENCFONTS} path. \cmdname{updmap} will attempt to warn about
2947 problematic files.
2948
2949 For methods of handling this and other information, please see
2950 \url{https://tug.org/texlive/mapenc.html}.
2951
2952 \item The \TK\ has been expanded with the addition of a \MIKTEX-based
2953 installable \CD, for those who prefer that implementation to Web2C.
2954 See section~\ref{sec:overview-tl} (\p.\pageref{sec:overview-tl}).
2955
2956 \item Within \TL, the single large \dirname{texmf} tree of previous
2957 releases has been replaced by three: \dirname{texmf},
2958 \dirname{texmf-dist}, and \dirname{texmf-doc}. See
2959 section~\ref{sec:tld} (\p.\pageref{sec:tld}), and the \filename{README}
2960 files for each.
2961
2962 \item All \TeX-related input files are now collected in
2963 the \dirname{tex} subdirectory of \dirname{texmf*} trees, rather than
2964 having separate sibling directories \dirname{tex}, \dirname{etex},
2965 \dirname{pdftex}, \dirname{pdfetex}, etc. See
2966 \CDref{texmf-dist/doc/generic/tds/tds.html\#Extensions}
2967 {\texttt{texmf-dist/doc/generic/tds/tds.html\#Extensions}}.
2968
2969 \item Helper scripts (not meant to be invoked by users) are now located
2970 in a new \dirname{scripts} subdirectory of \dirname{texmf*} trees, and
2971 can be searched for via \verb|kpsewhich -format=texmfscripts|. So if you have
2972 programs which call such scripts, they'll need to be adjusted. See
2973 \url{https://tug.org/tds/tds.html\#Scripts}.
2974
2975 \item Almost all formats leave most characters printable as
2976 themselves via the ``translation file'' \filename{cp227.tcx}, instead of
2977 translating them with the \verb|^^| notation. Specifically, characters
2978 at positions 32--256, plus tab, vertical tab, and form feed are
2979 considered printable and not translated. The exceptions are plain \TeX\
2980 (only 32--126 printable), \ConTeXt\ (0--255 printable), and the
2981 \OMEGA-related formats. This default behavior is almost the same as in
2982 \TL\ 2003, but it's implemented more cleanly, with more possibilities
2983 for customization. See \CDref{texmf-dist/doc/web2c/web2c.html\#TCX-files}
2984 {\texttt{texmf-dist/doc/web2c/web2c.html\#TCX-files}}.
2985 (By the way, with Unicode input, \TeX\ may output partial character
2986 sequences when showing error contexts, since it is byte-oriented.)
2987
2988 \item \pkgname{pdfetex} is now the default engine for all formats
2989 except (plain) \pkgname{tex} itself. (Of course it generates DVI
2990 when run as \pkgname{latex}, etc.) This means, among other things, that
2991 the microtypographic features of \pkgname{pdftex} are available in
2992 \LaTeX, \ConTeXt, etc., as well as the \eTeX\ features
2993 (\OnCD{texmf-dist/doc/etex/base/}).
2994
2995 It also means it's \emph{more important than ever} to use the
2996 \pkgname{ifpdf} package (works with both plain and \LaTeX) or equivalent
2997 code, because simply testing whether \cs{pdfoutput} or some other
2998 primitive is defined is not a reliable way to determine if PDF
2999 output is being generated. We made this backward compatible as best we
3000 could this year, but next year, \cs{pdfoutput} may be defined even when
3001 DVI is being written.
3002
3003 \item pdf\TeX\ (\url{http://pdftex.org}) has many new features:
3004
3005 \begin{itemize*}
3006
3007 \item \cs{pdfmapfile} and \cs{pdfmapline} provide font map support
3008 from within a document.
3009
3010 \item Microtypographic font expansion can be used more easily.\\
3011 \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}
3012
3013 \item All parameters previously set through the special configuration
3014 file \filename{pdftex.cfg} must now be set through primitives,
3015 typically in \filename{pdftexconfig.tex}; \filename{pdftex.cfg} is no
3016 longer supported. Any extant \filename{.fmt} files must be redumped
3017 when \filename{pdftexconfig.tex} is changed.
3018
3019 \item See the pdf\TeX\ manual for more: \OnCD{texmf-dist/doc/pdftex/manual/pdftex-a.pdf}.
3020
3021 \end{itemize*}
3022
3023 \item The \cs{input} primitive in \cmdname{tex} (and \cmdname{mf} and
3024 \cmdname{mpost}) now accepts double quotes containing spaces and other
3025 special characters. Typical examples:
3026 \begin{verbatim}
3027 \input "filename with spaces" % plain
3028 \input{"filename with spaces"} % latex
3029 \end{verbatim}
3030 See the Web2C manual for more: \OnCD{texmf-dist/doc/web2c}.
3031
3032 \item enc\TeX\ support is now included within Web2C and consequently all
3033 \TeX\ programs, via the \optname{-enc} option\Dash \emph{only when
3034 formats are built}. enc\TeX\ supports general re-encoding of input and
3035 output, enabling full support of Unicode (in UTF-8). See
3036 \OnCD{texmf-dist/doc/generic/enctex/} and
3037 \url{http://olsak.net/enctex.html}.
3038
3039 \item Aleph, a new engine combining \eTeX\ and \OMEGA, is available.
3040 Some information is available in \OnCD{texmf-dist/doc/aleph/base}
3041 and \url{https://texfaq.org/FAQ-enginedev}. The
3042 \LaTeX-based format for Aleph is named \pkgname{lamed}.
3043
3044 \item The latest \LaTeX\ release has a new version of the
3045 LPPL\Dash now officially a Debian-approved license. Assorted
3046 other updates, see the \filename{ltnews} files in
3047 \OnCD{texmf-dist/doc/latex/base}.
3048
3049 \item \cmdname{dvipng}, a new program for converting DVI to
3050 PNG image files, is included. See
3051 \url{https://ctan.org/pkg/dvipng}.
3052
3053 \item We reduced the \pkgname{cbgreek} package to a ``medium'' sized set
3054 of fonts, with the assent and advice of the author (Claudio Beccari).
3055 The excised fonts are the invisible, outline, and transparency ones,
3056 which are relatively rarely used, and we needed the space. The full set
3057 is of course available from CTAN (\url{https://ctan.org/pkg/cbgreek-complete}).
3058
3059 \item \cmdname{oxdvi} has been removed; just use \cmdname{xdvi}.
3060
3061 \item The \cmdname{ini} and \cmdname{vir} commands (links) for
3062 \cmdname{tex}, \cmdname{mf}, and \cmdname{mpost} are no longer created,
3063 such as \cmdname{initex}. The \cmdname{ini} functionality has been
3064 available through the command-line option \optname{-ini} for years now.
3065
3066 \item \pkgname{i386-openbsd} platform support was removed. Since the
3067 \pkgname{tetex} package in the BSD Ports system is available, and
3068 GNU/Linux and FreeBSD binaries were available, it seemed
3069 volunteer time could be better spent elsewhere.
3070
3071 \item On \pkgname{sparc-solaris} (at least), you may have to set the
3072 \envname{LD\_LIBRARY\_PATH} environment variable to run the
3073 \pkgname{t1utils} programs. This is because they are compiled with C++,
3074 and there is no standard location for the runtime libraries. (This is
3075 not new in 2004, but wasn't previously documented.) Similarly, on
3076 \pkgname{mips-irix}, the MIPSpro 7.4 runtimes are required.
3077
3078 \end{itemize}
3079
3080 \subsubsection{2005}
3081
3082 2005 saw the usual huge number of updates to packages and programs.
3083 The infrastructure stayed relatively stable from 2004, but inevitably
3084 there were some changes there as well:
3085
3086 \begin{itemize}
3087
3088 \item New scripts \cmdname{texconfig-sys}, \cmdname{updmap-sys}, and
3089 \cmdname{fmtutil-sys} were introduced, which modify the
3090 configuration in the system trees. The \cmdname{texconfig},
3091 \cmdname{updmap}, and \cmdname{fmtutil} scripts now modify
3092 user-specific files, under \dirname{$HOME/.texlive2005}.
3093
3094 \item Corresponding new variables \envname{TEXMFCONFIG} and
3095 \envname{TEXMFSYSCONFIG} to specify the trees where configuration
3096 files (user or system, respectively) are found. Thus, you may
3097 need to move personal versions of \filename{fmtutil.cnf} and
3098 \filename{updmap.cfg} to these places; another option is to
3099 redefine \envname{TEXMFCONFIG} or \envname{TEXMFSYSCONFIG} in
3100 \filename{texmf.cnf}. In any case the real location of these files
3101 and the values of \envname{TEXMFCONFIG} and \envname{TEXMFSYSCONFIG}
3102 must agree.
3103 See section~\ref{sec:texmftrees}, \p.\pageref{sec:texmftrees}.
3104
3105 \item Last year, we kept \verb|\pdfoutput| and other primitives undefined
3106 for \dvi\ output, even though the \cmdname{pdfetex} program was
3107 being used. This year, as promised, we undid that compatibility
3108 measure. So if your document uses \verb|\ifx\pdfoutput\undefined|
3109 to test if PDF is being output, it will need to be changed. You
3110 can use the package \pkgname{ifpdf.sty} (which works under both
3111 plain \TeX\ and \LaTeX) to do this, or steal its logic.
3112
3113 \item Last year, we changed most formats to output (8-bit) characters as
3114 themselves (see previous section). The new TCX file
3115 \filename{empty.tcx} now provides an easier way to get the
3116 original \verb|^^| notation if you so desire, as in:
3117 \begin{verbatim}
3118 latex --translate-file=empty.tcx yourfile.tex
3119 \end{verbatim}
3120
3121 \item The new program \cmdname{dvipdfmx} is included for translation of
3122 DVI to PDF; this is an actively maintained update of
3123 \cmdname{dvipdfm} (which is also still available for now, though
3124 no longer recommended).
3125
3126 \item The new programs \cmdname{pdfopen} and \cmdname{pdfclose} are included
3127 to allow reloading of PDF files in the Adobe Acrobat Reader without
3128 restarting the program. (Other PDF readers, notably \cmdname{xpdf},
3129 \cmdname{gv}, and \cmdname{gsview}, have never suffered from this
3130 problem.)
3131
3132 \item For consistency, the variables \envname{HOMETEXMF} and
3133 \envname{VARTEXMF} have been renamed to \envname{TEXMFHOME} and
3134 \envname{TEXMFSYSVAR}, respectively. There is also
3135 \envname{TEXMFVAR}, which is by default user-specific. See the
3136 first point above.
3137
3138 \end{itemize}
3139
3140
3141 \subsubsection{2006--2007}
3142
3143 In 2006--2007, the major new addition to \TL{} was the \XeTeX{} program,
3144 available as the \texttt{xetex} and \texttt{xelatex} programs; see
3145 \url{https://scripts.sil.org/xetex}.
3146
3147 MetaPost also received a notable update, with more planned for the
3148 future (\url{https://tug.org/metapost/articles}), likewise pdf\TeX{}
3149 (\url{https://tug.org/applications/pdftex}).
3150
3151 The \TeX\ \filename{.fmt} (high-speed format) and the similar files for
3152 MetaPost and \MF\ are now stored in subdirectories of \dirname{texmf/web2c},
3153 instead of in the directory itself (although the directory is still
3154 searched, for the sake of existing \filename{.fmt}'s). The
3155 subdirectories are named for the `engine' in use, such as \filename{tex}
3156 or \filename{pdftex} or \filename{xetex}. This change should be
3157 invisible in normal use.
3158
3159 The (plain) \texttt{tex} program no longer reads \texttt{\%\&} first
3160 lines to determine what format to run; it is the pure Knuthian \TeX.
3161 (\LaTeX\ and everything else do still read \texttt{\%\&} lines).
3162
3163 Of course the year also saw (the usual) hundreds of other updates to
3164 packages and programs. As usual, please check CTAN
3165 (\url{https://ctan.org}) for updates.
3166
3167 Internally, the source tree is now stored in Subversion, with a standard
3168 web interface for viewing the tree, as linked from our home page.
3169 Although not visible in the final distribution, we expect this will
3170 provide a stable development foundation for future years.
3171
3172 Finally, in May 2006 Thomas Esser announced that he would no longer be
3173 updating te\TeX{} (\url{https://tug.org/tetex}). As a result, there was
3174 a surge of interest in \TL{}, especially among \GNU/Linux
3175 distributors. (There is a new \texttt{tetex} installation scheme in
3176 \TL{}, which provides an approximate equivalent.) We hope this will
3177 eventually translate to improvements in the \TeX\ environment for
3178 everyone.
3179
3180 \subsubsection{2008}
3181
3182 In 2008, the entire \TL{} infrastructure was redesigned and
3183 reimplemented. Complete information about an installation is now stored
3184 in a plain text file \filename{tlpkg/texlive.tlpdb}.
3185
3186 Among other things, this finally makes possible upgrading a \TL{}
3187 installation over the Internet after the initial installation, a feature
3188 MiK\TeX\ has provided for many years. We expect to regularly update new
3189 packages as they are released to \CTAN.
3190
3191 The major new engine Lua\TeX\ (\url{http://luatex.org}) is included;
3192 besides a new level of flexibility in typesetting, this provides an
3193 excellent scripting language for use both inside and outside of \TeX\
3194 documents.
3195
3196 Support among Windows and the Unix-based platforms is now much more
3197 uniform. In particular, most Perl and Lua scripts are now available on
3198 Windows, using the Perl internally distributed with \TL.
3199
3200 The new \cmdname{tlmgr} script (section~\ref{sec:tlmgr}) is the
3201 general interface for managing \TL{} after the initial installation.
3202 It handles package updates and consequent regeneration of formats, map
3203 files, and language files, optionally including local additions.
3204
3205 With the advent of \cmdname{tlmgr}, the \cmdname{texconfig} actions to
3206 edit the format and hyphenation configuration files are now disabled.
3207
3208 The \cmdname{xindy} indexing program
3209 (\url{http://xindy.sourceforge.net/}) is now included on most platforms.
3210
3211 The \cmdname{kpsewhich} tool can now report all matches for a given file
3212 (option \optname{-{}-all}) and limit matches to a given subdirectory
3213 (option \optname{-{}-subdir}).
3214
3215 The \cmdname{dvipdfmx} program now includes functionality to extract
3216 bounding box information, via the command name \cmdname{extractbb}; this
3217 was one of the last features provided by \cmdname{dvipdfm} not in
3218 \cmdname{dvipdfmx}.
3219
3220 The font aliases \filename{Times-Roman}, \filename{Helvetica}, and so on
3221 have been removed. Different packages expected them to behave
3222 differently (in particular, to have different encodings), and there was
3223 no good way to resolve this.
3224
3225 The \pkgname{platex} format has been removed, to resolve a name conflict
3226 with a completely different Japanese \pkgname{platex}; the
3227 \pkgname{polski} package is now the main Polish support.
3228
3229 Internally, the \web\ string pool files are now compiled into the
3230 binaries, to ease upgrades.
3231
3232 Finally, the changes made by Donald Knuth in his `\TeX\ tuneup of 2008'
3233 are included in this release. See
3234 \url{https://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf}.
3235
3236 \subsubsection{2009}
3237
3238 In 2009, the default output format for Lua\AllTeX\ is now PDF, to take
3239 advantage of Lua\TeX's OpenType support, et al. New executables named
3240 \code{dviluatex} and \code{dvilualatex} run Lua\TeX\ with DVI output.
3241 The Lua\TeX\ home page is \url{http://luatex.org}.
3242
3243 The original Omega engine and Lambda format have been excised, after
3244 discussions with the Omega authors. The updated Aleph and Lamed remain,
3245 as do the Omega utilities.
3246
3247 A new release of the AMS \TypeI\ fonts is included, including Computer
3248 Modern: a few shape changes made over the years by Knuth in the Metafont
3249 sources have been integrated, and the hinting has been updated. The
3250 Euler fonts have been thoroughly reshaped by Hermann Zapf (see
3251 \url{https://tug.org/TUGboat/Articles/tb29-2/tb92hagen-euler.pdf}). In
3252 all cases, the metrics remain unchanged. The AMS fonts home page is
3253 \url{https://ams.org/tex/amsfonts.html}.
3254
3255 The new \GUI{} front end \TeX{}works is included for Windows, and also in
3256 Mac\TeX. For other platforms, and more information, see the \TeX{}works
3257 home page, \url{https://tug.org/texworks}. It is a cross-platform
3258 front-end inspired by the \macOS\ TeXShop editor, aiming at
3259 ease-of-use.
3260
3261 The graphics program Asymptote is included for several platforms. This
3262 implements a text-based graphics description language vaguely akin to
3263 MetaPost, but with advanced 3D support and other features. Its home
3264 page is \url{https://asymptote.sourceforge.io}.
3265
3266 The separate \code{dvipdfm} program has been replaced by
3267 \code{dvipdfmx}, which operates in a special compatibility mode under
3268 that name. \code{dvipdfmx} includes CJK support and has
3269 accumulated many other fixes over the years since the last
3270 \code{dvipdfm} release.
3271
3272 Executables for the \pkgname{cygwin} and \pkgname{i386-netbsd} platforms
3273 are now included, while we were advised that OpenBSD users get
3274 \TeX\ through their package systems, plus there were difficulties in
3275 making binaries that have a chance of working on more than one version.
3276
3277 A miscellany of smaller changes: we now use \pkgname{xz} compression,
3278 the stable replacement for \pkgname{lzma}
3279 (\url{https://tukaani.org/xz/}); a literal |$| is allowed in filenames
3280 when it does not introduce a known variable name; the Kpathsea library
3281 is now multi-threaded (made use of in MetaPost); the entire \TL{} build
3282 is now based on Automake.
3283
3284 Final note on the past: all releases of \TL{}, along with ancillary
3285 material such as \CD\ labels, are available at
3286 \url{ftp://tug.org/historic/systems/texlive}.
3287
3288
3289 \subsubsection{2010}
3290 \label{sec:2010news} % keep with 2010
3291
3292 In 2010, the default version for PDF output is now 1.5, enabling more
3293 compression. This applies to all the \TeX\ engines when used to produce
3294 PDF and to \code{dvipdfmx}. Loading the \pkgname{pdf14} \LaTeX\ package
3295 changes back to PDF~1.4, or set |\pdfminorversion=4|.
3296
3297 pdf\AllTeX\ now \emph{automatically} converts a requested Encapsulated
3298 PostScript (EPS) file to PDF, via the \pkgname{epstopdf} package, when
3299 and if the \LaTeX\ \code{graphics.cfg} configuration file is loaded, and
3300 PDF is being output. The default options are intended to eliminate any
3301 chance of hand-created PDF files being overwritten, but you can also
3302 prevent \code{epstopdf} from being loaded at all by putting
3303 |\newcommand{\DoNotLoadEpstopdf}{}| (or |\def...|) before the
3304 \cs{documentclass} declaration. It is also not loaded if the
3305 \pkgname{pst-pdf} package is used. For more details, see the
3306 \pkgname{epstopdf} package documentation
3307 (\url{https://ctan.org/pkg/epstopdf-pkg}).
3308
3309 A related change is that execution of a very few external commands from
3310 \TeX, via the \cs{write18} feature, is now enabled by default. These
3311 commands are \code{repstopdf}, \code{makeindex}, \code{kpsewhich},
3312 \code{bibtex}, and \code{bibtex8}; the list is defined in
3313 \code{texmf.cnf}. Environments which must disallow all such external
3314 commands can deselect this option in the installer (see
3315 section~\ref{sec:options}), or override the value after installation by
3316 running |tlmgr conf texmf shell_escape 0|.
3317
3318 Yet another related change is that \BibTeX\ and Makeindex now refuse to
3319 write their output files to an arbitrary directory (like \TeX\ itself),
3320 by default. This is so they can now be enabled for use by the
3321 restricted \cs{write18}. To change this, the \envname{TEXMFOUTPUT}
3322 environment variable can be set, or the |openout_any| setting changed.
3323
3324 \XeTeX\ now supports margin kerning along the same lines as pdf\TeX.
3325 (Font expansion is not presently supported.)
3326
3327 By default, \prog{tlmgr} now saves one backup of each package updated
3328 (\code{tlmgr option autobackup 1}), so broken package updates can be
3329 easily reverted with \code{tlmgr restore}. If you do post-install
3330 updates, and don't have the disk space for the backups, run \code{tlmgr
3331 option autobackup 0}.
3332
3333 New programs included: the p\TeX\ engine and related utilities for
3334 typesetting Japanese; the \BibTeX{}U program for Unicode-enabled
3335 \BibTeX; the \prog{chktex} utility
3336 (originally from \url{http://baruch.ev-en.org/proj/chktex}) for checking
3337 \AllTeX\
3338 documents; the \prog{dvisvgm} (\url{https://dvisvgm.de})
3339 DVI-to-SVG translator.
3340
3341 Executables for these new platforms are included: \code{amd64-freebsd},
3342 \code{amd64-kfreebsd}, \code{i386-freebsd}, \code{i386-kfreebsd},
3343 \code{x86\_64-darwin}, \code{x86\_64-solaris}.
3344
3345 A change in \TL{} 2009 that we failed to note: numerous \TeX4ht-related
3346 executables (\url{https://tug.org/tex4ht}) were removed from the binary
3347 directories. The generic \code{mk4ht} program can be used to run any of
3348 the various \code{tex4ht} combinations.
3349
3350 Finally, the \TL{} release on the \TK\ \DVD\ can no longer be run live
3351 (oddly enough). A single \DVD\ no longer has enough room. One
3352 beneficial side effect is that installation from the physical \DVD\ is
3353 much faster.
3354
3355 \subsubsection{2011}
3356
3357 The \macOS\ binaries (\code{universal-darwin} and
3358 \code{x86\_64-darwin}) now work only on Leopard or later; Panther and
3359 Tiger are no longer supported.
3360
3361 The \code{biber} program for bibliography processing is included on
3362 common platforms. Its development is closely coupled with the
3363 \code{biblatex} package, which completely reimplements the
3364 bibliographical facilities provided by LaTeX.
3365
3366 The MetaPost (\code{mpost}) program no longer creates or uses
3367 \code{.mem} files. The needed files, such as \code{plain.mp}, are
3368 simply read on every run. This is related to supporting MetaPost as a
3369 library, which is another significant though not user-visible change.
3370
3371 The \code{updmap} implementation in Perl, previously used only on
3372 Windows, has been revamped and is now used on all platforms. There
3373 shouldn't be any user-visible changes as a result, except that it runs
3374 much faster.
3375
3376 The \cmdname{initex} and \cmdname{inimf} programs were restored (but no
3377 other \cmdname{ini*} variants).
3378
3379 \subsubsection{2012}
3380
3381 \code{tlmgr} supports updates from multiple network repositories. The
3382 section on multiple repositories in the \code{tlmgr help} output has
3383 more.
3384
3385 The parameter \cs{XeTeXdashbreakstate} is set to~1 by default, for both
3386 \code{xetex} and \code{xelatex}. This allows line breaks after
3387 em-dashes and en-dashes, which has always been the behavior of plain
3388 \TeX, \LaTeX, Lua\TeX, etc. Existing \XeTeX\ documents which must
3389 retain perfect line-break compatibility will need to set
3390 \cs{XeTeXdashbreakstate} to~0 explicitly.
3391
3392 The output files generated by \code{pdftex} and \code{dvips}, among
3393 others, can now exceed 2 gigabytes.
3394
3395 The 35 standard PostScript fonts are included in the output of
3396 \code{dvips} by default, since so many different versions of them are
3397 extant.
3398
3399 In the restricted \cs{write18} execution mode, set by default,
3400 \code{mpost} is now an allowed program.
3401
3402 A \code{texmf.cnf} file is also found in \filename{../texmf-local},
3403 e.g., \filename{/usr/local/texlive/texmf-local/web2c/texmf.cnf}, if it
3404 exists.
3405
3406 The \code{updmap} script reads a per-tree \code{updmap.cfg} instead of
3407 one global config. This change should be invisible, unless you edited
3408 your updmap.cfg's directly. The \verb|updmap --help| output has more.
3409
3410 Platforms: \pkgname{armel-linux} and \pkgname{mipsel-linux} added;
3411 \pkgname{sparc-linux} and \pkgname{i386-netbsd} are no longer in the
3412 main distribution.
3413
3414 \subsubsection{2013}
3415
3416 Distribution layout: the top-level \code{texmf/} directory has been
3417 merged into \code{texmf-dist/}, for simplicity. Both the
3418 \code{TEXMFMAIN} and \code{TEXMFDIST} Kpathsea variables now point to
3419 \code{texmf-dist}.
3420
3421 Many small language collections have been merged together, to simplify
3422 installation.
3423
3424 \MP: native support for PNG output and floating-point (IEEE double) has
3425 been added.
3426
3427 Lua\TeX: updated to Lua 5.2, and includes a new library
3428 (\code{pdfscanner}) to process external PDF page content, among much
3429 else (see its web pages).
3430
3431 \XeTeX\ (also see its web pages for more):
3432 \begin{itemize*}
3433 \item The HarfBuzz library is now used for font layout instead of
3434 ICU. (ICU is still used to support input encodings, bidirectionality,
3435 and the optional Unicode line breaking.)
3436 \item Graphite2 and HarfBuzz are used instead of SilGraphite for Graphite
3437 layout.
3438 \item On Macs, Core Text is used instead of the (deprecated) ATSUI.
3439 \item Prefer TrueType/OpenType fonts to Type1 when the names are the same.
3440 \item Fix occasional mismatch in font finding between \XeTeX\ and
3441 \code{xdvipdfmx}.
3442 \item Support OpenType math cut-ins.
3443 \end{itemize*}
3444
3445 \cmdname{xdvi}: now uses FreeType instead of \code{t1lib} for rendering.
3446
3447 \pkgname{microtype.sty}: some support for \XeTeX\ (protrusion) and
3448 Lua\TeX\ (protrusion, font expansion, tracking), among other
3449 enhancements.
3450
3451 \cmdname{tlmgr}: new \code{pinning} action to ease configuring multiple
3452 repositories; that section in \verb|tlmgr --help| has more, online at
3453 \url{https://tug.org/texlive/doc/tlmgr.html#MULTIPLE-REPOSITORIES}.
3454
3455 Platforms: \pkgname{armhf-linux}, \pkgname{mips-irix},
3456 \pkgname{i386-netbsd}, and \pkgname{amd64-netbsd} added or revived;
3457 \pkgname{powerpc-aix} removed.
3458
3459 \subsubsection{2014}
3460
3461 2014 saw another \TeX\ tune-up from Knuth; this affected all engines,
3462 but the only visible change likely is the restoration of the
3463 \code{preloaded format} string on the banner line. Per Knuth, this now
3464 reflects the format that \emph{would} be loaded by default, rather than
3465 an undumped format that is actually preloaded in the binary; it may be
3466 overridden in various ways.
3467
3468 pdf\TeX: new warning-suppression parameter
3469 \cs{pdfsuppresswarningpagegroup}; new primitives for fake interword
3470 spaces to help with PDF text reflowing: \cs{pdfinterwordspaceon},
3471 \cs{pdfinterwordspaceoff}, \cs{pdffakespace}.
3472
3473 Lua\TeX: Notable changes and fixes were made to font loading and
3474 hyphenation. The biggest addition is a new engine variant,
3475 \code{luajittex} and its siblings \code{texluajit} and
3476 \code{texluajitc}. This uses a just-in-time Lua compiler (detailed
3477 \textsl{TUGboat} article at
3478 \url{https://tug.org/TUGboat/tb34-1/tb106scarso.pdf}). \code{luajittex}
3479 is still in development, is not available on all platforms, and is
3480 considerably less stable than \code{luatex}. Neither we nor its
3481 developers recommend using it except for the specific purpose of
3482 experimenting with jit on Lua code.
3483
3484 \XeTeX: The same image formats are now supported on all platforms
3485 (including Mac); avoid Unicode compatibility decomposition fallback (but
3486 not other variants); prefer OpenType to Graphite fonts, for
3487 compatibility with previous \XeTeX\ versions.
3488
3489 \MP: A new numbersystem \code{decimal} is supported, along with a
3490 companion internal \code{numberprecision}; a new definition of
3491 \code{drawdot} in \filename{plain.mp}, per Knuth; bug fixes in
3492 SVG and PNG output, among others.
3493
3494 The \cmdname{pstopdf} \ConTeXt\ utility will be removed as a standalone
3495 command at some point after the release, due to conflicts with OS
3496 utilities of the same name. It can still (and now) be invoked as
3497 \code{txrun --script pstopdf}.
3498
3499 \cmdname{psutils} has been substantially revised by a new maintainer.
3500 As a result, several seldom-used utilities (\code{fix*}, \code{getafm},
3501 \code{psmerge}, \code{showchar}) are now only in the \dirname{scripts/}
3502 directory rather than being user-level executables (this can be reversed
3503 if it turns out to be problematic). A new script, \code{psjoin}, has
3504 been added.
3505
3506 The Mac\TeX\ redistribution of \TL\ (section~\ref{sec:macosx}) no
3507 longer includes the optional Mac-only packages for the Latin Modern and
3508 \TeX\ Gyre fonts, since it is easy enough for individual users to make
3509 them available to the system. The \cmdname{convert} program from
3510 ImageMagick has also been excised, since \TeX4ht (specifically
3511 \code{tex4ht.env}) now uses Ghostscript directly.
3512
3513 The \pkgname{langcjk} collection for Chinese, Japanese, and Korean
3514 support has been split into individual language collections for the sake
3515 of more moderate sizes.
3516
3517 Platforms: \pkgname{x86\_64-cygwin} added, \pkgname{mips-irix} removed;
3518 Microsoft no longer supports Windows XP, so our programs may
3519 start failing there at any time.
3520
3521 \subsubsection{2015}
3522
3523 \LaTeXe\ now incorporates, by default, changes previously included only
3524 by explicitly loading the \pkgname{fixltx2e} package, which is now a
3525 no-op. A new \pkgname{latexrelease} package and other mechanisms allow
3526 for controlling what is done. The included \LaTeX\ News \#22 and
3527 ``\LaTeX\ changes'' documents have details. Incidentally, the
3528 \pkgname{babel} and \pkgname{psnfss} packages, while core parts of
3529 \LaTeX, are maintained separately and are not affected by these changes
3530 (and should still work).
3531
3532 Internally, \LaTeXe\ now includes Unicode-related engine configuration
3533 (what characters are letters, naming of primitives, etc.) which was
3534 previously part of \TL. This change is intended to be invisible
3535 to users; a few low-level internal control sequences have been renamed
3536 or removed, but the behavior should be just the same.
3537
3538 pdf\TeX: Support JPEG Exif as well as JFIF; do not
3539 emit a warning if \cs{pdfinclusionerrorlevel} is negative; sync
3540 with \prog{xpdf}~3.04.
3541
3542 Lua\TeX: New library \pkgname{newtokenlib} for scanning tokens; bug
3543 fixes in the \code{normal} random number generator and other places.
3544
3545 \XeTeX: Image handling fixes; \prog{xdvipdfmx} binary looked for first
3546 as a sibling to \prog{xetex}; internal \code{XDV} opcodes changed.
3547
3548 MetaPost: New numbersystem \code{binary}; new Japanese-enabled
3549 \prog{upmpost} and \prog{updvitomp} programs, analogous to
3550 \prog{up*tex}.
3551
3552 Mac\TeX:\ Updates to the included Ghostscript package for CJK
3553 support. The \TeX\ Distribution Preference Pane now works in Yosemite
3554 (\macOS~10.10). Resource-fork font suitcases (generally without an
3555 extension) are no longer supported by \XeTeX; data-fork suitcases
3556 (\code{.dfont}) remain supported.
3557
3558 Infrastructure: The \prog{fmtutil} script has been reimplemented to read
3559 \filename{fmtutil.cnf} on a per-tree basis, analogous to \prog{updmap}.
3560 Web2C \prog{mktex*} scripts (including \prog{mktexlsr}, \prog{mktextfm},
3561 \prog{mktexpk}) now prefer programs in their own directory, instead of
3562 always using the existing \envname{PATH}.
3563
3564 Platforms: \pkgname{*-kfreebsd} removed, since \TL\ is now easily
3565 available through the system platform mechanisms.
3566 Support for some additional platforms is available as custom binaries
3567 (\url{https://tug.org/texlive/custom-bin.html}). In addition, some
3568 platforms are now omitted from the \DVD\ (simply to save space), but can
3569 be installed normally over the net.
3570
3571 %
3572 \subsubsection{2016}
3573
3574 Lua\TeX: Sweeping changes to primitives, both renames and removals,
3575 along with some node structure rearrangements. The changes are
3576 summarized in an article by Hans Hagen, ``Lua\TeX\ 0.90 backend changes
3577 for PDF and more''
3578 (\url{https://tug.org/TUGboat/tb37-1/tb115hagen-pdf.pdf}); for all the
3579 details, see the Lua\TeX\ manual,
3580 \OnCD{texmf-dist/doc/luatex/base/luatex.pdf}.
3581
3582 Metafont: New highly experimental sibling programs MFlua and MFluajit,
3583 integrating Lua with \MF, for trial testing purposes.
3584
3585 MetaPost: Bug fixes and internal preparations for MetaPost 2.0.
3586
3587 \code{SOURCE\_DATE\_EPOCH} support in all engines except Lua\TeX\ (which
3588 will come in the next release) and original \code{tex} (intentionally
3589 omitted): if the environment variable \code{SOURCE\_DATE\_EPOCH} is set,
3590 its value is used for timestamps in the PDF output. If
3591 \code{SOURCE\_DATE\_EPOCH\_TEX\_PRIMITIVES} is also set, the
3592 \code{SOURCE\_DATE\_EPOCH} value is used to initialize the \TeX\
3593 primitives \cs{year}, \cs{month}, \cs{day}, \cs{time}. The pdf\TeX\
3594 manual has examples and details.
3595
3596 pdf\TeX: Three new primitives \cs{pdfinfoomitdate},
3597 \cs{pdfsuppressptexinfo}, and \cs{pdftrailerid}, to control values
3598 appearing in the output which normally change with each run. These
3599 features are for PDF output only, not DVI.
3600
3601 Xe\TeX: New primitives \cs{XeTeXhyphenatablelength},
3602 \cs{XeTeXgenerateactualtext},\\ \cs{XeTeXinterwordspaceshaping},
3603 \cs{mdfivesum}; character class limit increased to 4096; DVI id byte
3604 incremented.
3605
3606 Other utilities:
3607 \begin{itemize*}
3608 \item \code{gregorio} is a new program, part of the \code{gregoriotex}
3609 package for typesetting Gregorian chant scores; it is included in
3610 \code{shell\_escape\_commands} by default.
3611
3612 \item \code{upmendex} is an index creation program, mostly compatible
3613 with \code{makeindex}, with support for Unicode sorting, among other
3614 changes.
3615
3616 \item \code{afm2tfm} now makes only accent-based height adjustments
3617 upward; a new option \code{-a} omits all adjustments.
3618
3619 \item \code{ps2pk} can handle extended PK/GF fonts.
3620 \end{itemize*}
3621
3622 Mac\TeX:\ The \TeX\ Distribution Preference Pane is gone; its
3623 functionality is now in \TL\ Utility; bundled GUI applications
3624 upgraded; new script \code{cjk-gs-integrate} to be run by users who wish
3625 to incorporate various CJK fonts into Ghostscript.
3626
3627 Infrastructure: System-level \code{tlmgr} configuration file supported;
3628 verify package checksums; if GPG is available, verify signature of
3629 network updates. These checks happen with both the installer and
3630 \code{tlmgr}. If GPG is not available, updates proceed as usual.
3631
3632 Platforms: \code{alpha-linux} and \code{mipsel-linux} removed.
3633
3634 %
3635 \subsubsection{2017}
3636
3637 Lua\TeX: More callbacks, more typesetting control, more access to
3638 internals; \code{ffi} library for dynamic code loading added on some
3639 platforms.
3640
3641 pdf\TeX: Environment variable |SOURCE_DATE_EPOCH_TEX_PRIMITIVES| from
3642 last year renamed to |FORCE_SOURCE_DATE|, with no changes in
3643 functionality; if the \cs{pdfpageattr} token list contains the string
3644 \code{/MediaBox}, omit output of the default \code{/MediaBox}.
3645
3646 Xe\TeX: Unicode/OpenType math now based on HarfBuzz's MATH table support;
3647 some bug fixes.
3648
3649 Dvips: Make the last papersize special win, for consistency with
3650 \code{dvipdfmx} and package expectations; the \code{-L0} option (\code{L0}
3651 config setting) restores the previous behavior of the first special
3652 winning.
3653
3654 ep\TeX, eup\TeX: New primitives \cs{pdfuniformdeviate},
3655 \cs{pdfnormaldeviate}, \cs{pdfrandomseed}, \cs{pdfsetrandomseed},
3656 \cs{pdfelapsedtime}, \cs{pdfresettimer}, from pdf\TeX.
3657
3658 Mac\TeX:\ As of this year, only \macOS\ releases for which Apple still
3659 releases security patches will be supported in Mac\TeX, under the
3660 platform name |x86_64-darwin|; currently this means Yosemite,
3661 El~Capitan, and Sierra (10.10 and newer). Binaries for older \macOS\
3662 versions are not included in Mac\TeX, but are still available in \TL\
3663 (|x86_64-darwinlegacy|, \code{i386-darwin}, \code{powerpc-darwin}).
3664
3665 Infrastructure: The \envname{TEXMFLOCAL} tree is now searched before
3666 \envname{TEXMFSYSCONFIG} and \envname{TEXMFSYSVAR} (by default); the
3667 hope is that this will better match expectations of local files
3668 overriding system files. Also, \code{tlmgr} has a new mode \code{shell}
3669 for interactive and scripted use, and a new action \code{conf auxtrees}
3670 to easily add and remove extra trees.
3671
3672 \code{updmap} and \code{fmtutil}: These scripts now give a warning when
3673 invoked without explicitly specifying either so-called system mode
3674 (\code{updmap-sys}, \code{fmtutil-sys}, or option \code{-sys}), or user
3675 mode (\code{updmap-user}, \code{fmtutil-user}, or option \code{-user}).
3676 The hope is that this will reduce the perennial problem of invoking user
3677 mode by accident and thus losing future system updates. See
3678 \url{https://tug.org/texlive/scripts-sys-user.html} for details.
3679
3680 \code{install-tl}: Personal paths such as \envname{TEXMFHOME} are now
3681 set to Mac\TeX\ values (|~/Library/...|)\ by default on Macs. New
3682 option \code{-init-from-profile} to start an installation with the
3683 values from a given profile; new command \code{P} to explicitly save a
3684 profile; new profile variable names (but previous ones are still
3685 accepted).
3686
3687 Sync\TeX: the name of the temporary file now looks like
3688 \code{foo.synctex(busy)}, instead of \code{foo.synctex.gz(busy)}
3689 (no~\code{.gz}). Front-ends and build systems that want to remove temp
3690 files may need adjusting.
3691
3692 Other utilities: \code{texosquery-jre8} is a new cross-platform program
3693 for retrieving locale and other OS information from a \TeX\ document; it
3694 is included in |shell_escape_commands| by default for restricted
3695 shell execution. (Older JRE versions are supported by texosquery, but
3696 cannot be enabled in restricted mode, as they are no longer supported by
3697 Oracle, even for security issues.)
3698
3699 Platforms: See Mac\TeX\ entry above; no other changes.
3700
3701 %
3702 \subsubsection{2018}
3703
3704 Kpathsea: Case-insensitive filename matching now done by default in
3705 non-system directories; set \code{texmf.cnf} or environment variable
3706 \code{texmf\_casefold\_search} to~\code{0} to disable.
3707 Full details in the Kpathsea manual (\url{https://tug.org/kpathsea}).
3708
3709 ep\TeX, eup\TeX: New primitive \cs{epTeXversion}.
3710
3711 Lua\TeX: Preparation for moving to Lua 5.3 in 2019: a binary
3712 \code{luatex53} is available on most platforms, but must be renamed to
3713 \code{luatex} to be effective. Or use the \ConTeXt\ Garden
3714 (\url{https://wiki.contextgarden.net}) files; more information there.
3715
3716 MetaPost: Fixes for wrong path directions, TFM and PNG output.
3717
3718 pdf\TeX: Allow encoding vectors for bitmap fonts; current directory not
3719 hashed into PDF ID; bug fixes for \cs{pdfprimitive} and related.
3720
3721 Xe\TeX: Support \code{/Rotate} in PDF image inclusion; exit nonzero if
3722 the output driver fails; various obscure UTF-8 and other primitive
3723 fixes.
3724
3725 Mac\TeX:\ See version support changes below. In addition, the files
3726 installed in \code{/Applications/TeX/} by Mac\TeX\ have been reorganized for
3727 greater clarity; now this location contains four GUI programs (BibDesk,
3728 LaTeXiT, \TL\ Utility, and TeXShop) at the top level and folders
3729 with additional utilities and documentation.
3730
3731 \code{tlmgr}: new front-ends \code{tlshell} (Tcl/Tk) and
3732 \code{tlcockpit} (Java); JSON output; \code{uninstall} now a synonym
3733 for \code{remove}; new action/option \code{print-platform-info}.
3734
3735 Platforms:
3736 \begin{itemize*}
3737 \item
3738 Removed: \code{armel-linux}, \code{powerpc-linux}.
3739
3740 \item \code{x86\_64-darwin} supports 10.10--10.13
3741 (Yosemite, El~Capitan, Sierra, and High~Sierra).
3742
3743 \item \code{x86\_64-darwinlegacy} supports 10.6--10.10 (though
3744 \code{x86\_64-darwin} is preferred for 10.10). All support for 10.5
3745 (Leopard) is gone, that is, both the \code{powerpc-darwin} and
3746 \code{i386-darwin platforms} have been removed.
3747
3748 \item Windows: XP is no longer supported.
3749 \end{itemize*}
3750
3751 %
3752 \subsubsection{2019}
3753
3754 Kpathsea: More consistent brace expansion and path splitting; new
3755 variable \code{TEXMFDOTDIR} instead of hard-coded \code{.}\ in paths
3756 allows for easily searching additional or sub-directories (see comments
3757 in \code{texmf.cnf}).
3758
3759 ep\TeX, eup\TeX: New primitives \cs{readpapersizespecial} and
3760 \cs{expanded}.
3761
3762 Lua\TeX: Lua 5.3 now used, with concomitant arithmetic and interface changes.
3763 The homegrown library pplib is used to read pdf files, thus
3764 eliminating the dependency on poppler (and the need for C++);
3765 Lua interface changed accordingly.
3766
3767 MetaPost: \code{r-mpost} command name recognized as an
3768 alias for invocation with the \code{-{}-restricted} option, and added to
3769 the list of restricted commands available by default.
3770 Minimum precision now 2 for decimal and binary mode.
3771 Binary mode no longer available in MPlib but still available in
3772 standalone MetaPost.
3773
3774 pdf\TeX: New primitive \cs{expanded}; if new primitive parameter
3775 \cs{pdfomitcharset} is set to 1, the \code{/CharSet} string
3776 omitted from the PDF output, since it cannot feasibly be guaranteed
3777 correct, as required by PDF/A-2 and PDF/A-3.
3778
3779 Xe\TeX: New primitives for cross-engine support: \cs{expanded},
3780 \cs{creationdate},
3781 \cs{elapsedtime},
3782 \cs{filedump},
3783 \cs{filemoddate},
3784 \cs{filesize},
3785 \cs{resettimer},
3786 \cs{normaldeviate},
3787 \cs{uniformdeviate},
3788 \cs{randomseed}; extend \cs{Ucharcat} to produce active
3789 characters.
3790
3791 \code{tlmgr}: Support \code{curl} as a download program;
3792 use \code{lz4} and gzip before \code{xz} for local backups, if available;
3793 prefer system-provided binaries over binaries provided with \TL\ for
3794 compressor and download programs, unless the environment variable
3795 \code{TEXLIVE\_PREFER\_OWN} is set.
3796
3797 \code{install-tl}: New option \code{-gui} (with no argument) is the
3798 default on Windows and Macs, and invokes a new Tcl/TK GUI (see
3799 sections~\ref{sec:basic} and~\ref{sec:graphical-inst}).
3800
3801 Utilities:
3802 \begin{itemize*}
3803 \item \code{cwebbin} (\url{https://ctan.org/pkg/cwebbin}) is now the CWEB
3804 implementation in \TL, with support for more language dialects,
3805 and including the \code{ctwill} program to make mini-indexes.
3806
3807 \item \code{chkdvifont}: report font information from \dvi{} files, also
3808 from tfm/ofm, vf, gf, pk.
3809
3810 \item \code{dvispc}: make a DVI file page-independent with respect to specials.
3811 \end{itemize*}
3812
3813 Mac\TeX:\ \code{x86\_64-darwin} now supports 10.12 and higher (Sierra,
3814 High Sierra, Mojave); \code{x86\_64-darwinlegacy} still supports 10.6
3815 and newer. The spell checker Excalibur is no longer included, since it
3816 requires 32-bit support.
3817
3818 Platforms: removed \code{sparc-solaris}.
3819
3820 %
3821 \subsubsection{2020}
3822
3823 General: \begin{itemize}
3824 \item The \cs{input} primitive in all \TeX\ engines, including
3825 \texttt{tex}, now also accepts a group-delimited filename argument, as a
3826 system-dependent extension. The usage with a standard
3827 space/token-delimited filename is completely unchanged. The
3828 group-delimited argument was previously implemented in Lua\TeX; now it
3829 is available in all engines. ASCII double quote characters (\texttt{"})
3830 are removed from the filename, but it is otherwise left unchanged after
3831 tokenization. This does not currently affect \LaTeX's \cs{input} command,
3832 as that is a macro redefinition of the standard \cs{input} primitive.
3833
3834 \item New option \optname{-{}-cnf-line} for \texttt{kpsewhich}, \texttt{tex},
3835 \texttt{mf}, and all other engines, to support arbitrary configuration
3836 settings on the command line.
3837
3838 \item The addition of various primitives to various engines in this and
3839 previous years is intended to result in a common set of functionality
3840 available across all engines (\textsl{\LaTeX\ News \#31},
3841 \url{https://latex-project.org/news}).
3842
3843 \end{itemize}
3844
3845 ep\TeX, eup\TeX: Several new primitives, mostly for cross-engine support:
3846 \cs{Uchar}, \cs{Ucharcat}, \cs{current(x)spacingmode}, \cs{ifincsname};
3847 also, revise \cs{fontchar??}\ and \cs{iffontchar}. For eup\TeX\ only:
3848 \cs{currentcjktoken}.
3849
3850 Lua\TeX: Integration with HarfBuzz library, available as new engines
3851 \texttt{luahbtex} (used for \texttt{lualatex}) and \texttt{luajithbtex}.
3852 New primitives: \cs{eTeXgluestretchorder}, \cs{eTeXglueshrinkorder}.
3853
3854 pdf\TeX: New primitive \cs{pdfmajorversion}; this merely changes the
3855 version number in the PDF output; it has no effect on any PDF content.
3856 \cs{pdfximage} and similar now search for image files in the same way as
3857 \cs{openin}.
3858
3859 p\TeX: New primitives \cs{ifjfont}, \cs{iftfont}. Also in ep\TeX,
3860 up\TeX, eup\TeX.
3861
3862 Xe\TeX: Fixes for \cs{Umathchardef}, \cs{XeTeXinterchartoks}, \cs{pdfsavepos}.
3863
3864 Dvips: Output encodings for bitmap fonts, for better copy/paste
3865 capabilities
3866 (\url{https://tug.org/TUGboat/tb40-2/tb125rokicki-type3search.pdf}).
3867
3868 Mac\TeX:\ Mac\TeX\ and \texttt{x86\_64-darwin} now require 10.13 or
3869 higher (High~Sierra, Mojave, and Catalina);
3870 \texttt{x86\_64-darwinlegacy} supports 10.6 and newer. Mac\TeX\ is
3871 notarized and command line programs have hardened runtimes, as now
3872 required by Apple for install packages. BibDesk and \TL\ Utility
3873 are not in Mac\TeX\ because they are not notarized, but a
3874 \filename{README} file lists urls where they can be obtained.
3875
3876 |x86_64-darwinlegacy|: drop X11 support, including \cmdname{xdvi}.
3877
3878 \code{tlmgr} and infrastructure: \begin{itemize*}
3879 \item Automatically retry (once) packages that fail to download.
3880 \item New option \texttt{tlmgr check texmfdbs},
3881 to check consistency of \texttt{ls-R} files and \texttt{!!}\
3882 specifications for each tree.
3883 \item Use versioned filenames for the package containers, as in:\\
3884 \texttt{tlnet/archive/\textsl{pkgname}.rNNN.tar.xz}. This should be
3885 invisible to users, but is a notable change in distribution.
3886 \item \texttt{catalogue-date} information no longer propagated from the
3887 \TeX~Catalogue, since it was often unrelated to package updates.
3888 \end{itemize*}
3889
3890 %
3891 \subsubsection{2021}
3892
3893 General: \begin{itemize}
3894 \item Donald Knuth's changes for his 2021 tuneup of \TeX\ and Metafont are
3895 incorporated
3896 (\url{https://tug.org/TUGboat/tb42-1/tb130knuth-tuneup21.pdf}). They are
3897 also available on CTAN as the \code{knuth-dist} and \code{knuth-local}
3898 packages. As expected, the fixes are for obscure cases and do not affect
3899 any behavior in practice.
3900
3901 \item Except in original \TeX: if \cs{tracinglostchars} is set to 3 or
3902 more, missing characters will result in an error, not just a message in
3903 the log file, and the missing character code will be shown in hex.
3904
3905 \item Except in original \TeX: a new integer parameter
3906 \cs{tracingstacklevels}, if positive, and \cs{tracingmacros}
3907 is also positive, causes a prefix indicating the macro expansion depth
3908 to be output on each relevant log line (e.g., |~..| at depth 2).
3909 Also, macro logging is truncated at a depth $\ge$ the parameter value.
3910
3911 \end{itemize}
3912
3913 Aleph: The Aleph-based \LaTeX\ format, named \code{lamed}, has been
3914 removed. The \code{aleph} binary itself is still included and supported.
3915
3916 Lua\TeX: \begin{itemize*}
3917 \item Lua 5.3.6.
3918 \item Callback for nesting level used in \cs{tracingmacros}, as
3919 generalized variant of the new \cs{tracingstacklevels}.
3920 \item Mark math glyphs as protected to prevent processing as text.
3921 \item Removed width/ic compensation for traditional math code path.
3922 \end{itemize*}
3923
3924 MetaPost: \begin{itemize*}
3925 \item |SOURCE_DATE_EPOCH| environment variable support for reproducible output.
3926 \item Avoid wrong final \texttt{\%} in \texttt{mpto}.
3927 \item Document \texttt{-T} option, other fixes to manual.
3928 \item Value of \texttt{epsilon} changed in binary and decimal modes, so that
3929 the function |mp_solve_rising_cubic| works as expected.
3930 \end{itemize*}
3931
3932 pdf\TeX{}: \begin{itemize*}
3933 \item New primitives \cs{pdfrunninglinkoff} and
3934 \cs{pdfrunninglinkon}; e.g., for disabling generation of links in
3935 headers and footers.
3936 \item Warn instead of aborting when ``\cs{pdfendlink} ended up in
3937 different nesting level than \cs{pdfstartlink}''.
3938 \item Dump \cs{pdfglyphtounicode} assignments in \texttt{fmt} file.
3939 \item Source: \texttt{poppler} support removed, as it was too hard to
3940 keep in sync with upstream. In native \TL, pdf\TeX\ has always used
3941 \texttt{libs/xpdf}, which is cut-down and adapted code from \texttt{xpdf}.
3942 \end{itemize*}
3943
3944 Xe\TeX{}: Fixes for math kerning.
3945
3946 Dvipdfmx: \begin{itemize*}
3947 \item Ghostscript is now invoked safely by default; to override
3948 (thereby assuming all input files are trusted), use
3949 \verb|-i dvipdfmx-unsafe.cfg|. To use PSTricks with \XeTeX, this is
3950 required, as in:\\
3951 \verb|xetex -output-driver="xdvipdfmx -i dvipdfmx-unsafe.cfg -q -E" ...|
3952 \item If an image file is not found, exit with bad status.
3953 \item Extended special syntax for color support.
3954 \item Specials for manipulating |ExtGState|.
3955 \item Compatibility specials \code{pdfcolorstack} and \code{pdffontattr}.
3956 \item Experimental support for \code{dviluatex}'s extended |fnt_def|.
3957 \item Support new feature of virtual font to fallback Japanese font definition.
3958 \end{itemize*}
3959
3960 Dvips: \begin{itemize*}
3961 \item Default PostScript document title is now the basename of the input
3962 file, and can be overridden with the new option \texttt{-title}.
3963 \item If an \texttt{.eps} or other image file is not found, exit with bad
3964 status.
3965 \item Support new feature of virtual font to fallback Japanese font definition.
3966 \end{itemize*}
3967
3968 Mac\TeX{}: Mac\TeX{} and its new binary folder \texttt{universal-darwin} now
3969 require \macOS\ 10.14 or higher (Mojave, Catalina, and Big~Sur); the
3970 |x86_64-darwin| binary folder is no longer present. The
3971 |x86_64-darwinlegacy| binary folder, available only with the Unix
3972 \texttt{install-tl}, supports 10.6 and newer.
3973
3974 This is an important year for the Macintosh because Apple introduced
3975 ARM machines in November and will sell and support both ARM and Intel
3976 machines for many years. All programs in \texttt{universal-darwin} have
3977 executable code for both ARM and Intel. Both binaries are compiled from
3978 the same source code.
3979
3980 The additional programs Ghostscript, LaTeXiT, \TeX{} Live Utility, and
3981 TeXShop are all universal and are signed with a hardened runtime, so all
3982 are included in Mac\TeX{} this year.
3983
3984 \code{tlmgr} and infrastructure: \begin{itemize*}
3985 \item keep only one backup of the main repository's \texttt{texlive.tlpdb}.
3986 \item even more portability across systems and Perl versions.
3987 \item \texttt{tlmgr info} reports new \texttt{lcat-*} and \texttt{rcat-*}
3988 fields for local vs. remote Catalogue data.
3989 \item full logging of subcommands moved to a new log file:\\
3990 \texttt{texmf-var/web2c/tlmgr-commands.log}.
3991 \end{itemize*}
3992
3993 %
3994 \subsubsection{2022}
3995
3996 General: \begin{itemize}
3997 \item New engine \code{hitex}, which outputs its own HINT format,
3998 designed especially for reading technical documents on mobile devices.
3999 HINT viewers for GNU/Linux, Windows, and Android are available
4000 separately from \TL.
4001
4002 \item \code{tangle}, \code{weave}: support optional third argument to
4003 specify output file.
4004
4005 \item Knuth's program \code{twill} for making mini-indexes for original
4006 \texttt{WEB} programs now included.
4007
4008 \end{itemize}
4009
4010 Cross-engine extensions (except in original \TeX{}, Aleph, and hi\TeX{}):
4011 \begin{itemize}
4012 \item New primitive \cs{showstream} to redirect \cs{show} output to a file.
4013 \item New primitives \cs{partokenname} and \cs{partokencontext} allow
4014 overriding the name of the \cs{par} token emitted at blank lines, the
4015 end of vboxes, etc.
4016 \end{itemize}
4017
4018 ep\TeX{}, eup\TeX{}: \begin{itemize*}\raggedright
4019 \item New primitives: \cs{lastnodefont}, \cs{suppresslongerror},
4020 \cs{suppressoutererror}, \cs{suppressmathparerror}.
4021 \item pdf\TeX{} extension \cs{vadjust pre} now available.
4022 \end{itemize*}
4023
4024 Lua\TeX{}: \begin{itemize*}
4025 \item Support structured destinations from PDF 2.0.
4026 \item PNG /Smask for PDF 2.0.
4027 \item Variable font interface for \code{luahbtex}.
4028 \item Different radical style defaults in mathdefaultsmode.
4029 \item Optionally block selected discretionary creation.
4030 \item Improvements for TrueType fonts implementation.
4031 \item More efficient \cs{fontdimen} allocation.
4032 \item Ignore paragraphs with only a local \code{par} node followed by direction
4033 synchronization nodes.
4034 \end{itemize*}
4035
4036 MetaPost: Bug fix for infinite macro expansion.
4037
4038 pdf\TeX{}: \begin{itemize*}\raggedright
4039 \item Support structured destinations from PDF 2.0.
4040 \item For letterspaced fonts, use explicit \cs{fontdimen}6 if specified.
4041 \item Always start a warning at the beginning of a line.
4042 \item For characters with autokern (\cs{pdfappendkern} and
4043 \cs{pdfprependkern}), still do protrusion; likewise, autokern
4044 both implicit and explicit hyphens.
4045 \end{itemize*}
4046
4047 p\TeX{}\ et al.: \begin{itemize*}
4048 \item Major update of p\TeX{} to 4.0.0 to better support current \LaTeX{}.
4049 \item New primitives \cs{ptexlineendmode} and \cs{toucs}.
4050 \item \cs{ucs} (formerly available in uptex, euptex) now
4051 available also in p\TeX\ and ep\TeX.
4052 \item Distinguish eight-bit characters and Japanese characters,
4053 as discussed in a \textsl{TUGboat} article by Hironori Kitagawa
4054 (\url{https://tug.org/TUGboat/tb41-3/tb129kitagawa-char.pdf}).
4055 \end{itemize*}
4056
4057 Xe\TeX{}: New wrapper scripts \texttt{xetex-unsafe} and
4058 \texttt{xelatex-unsafe} for simpler invocation of documents requiring
4059 both \XeTeX{} and PSTricks transparency operators, which is inherently
4060 unsafe (until and unless reimplementation in Ghostscript happens). For
4061 safety, use Lua\AllTeX{}.
4062
4063 Dvipdfmx: \begin{itemize*}
4064 \item Support for PSTricks without requiring \texttt{-dNOSAFER}, except
4065 for transparency.
4066 \item The \texttt{-r} option to set bitmap font resolution works again.
4067 \end{itemize*}
4068
4069 Dvips: By default, do not attempt automatic media adjustment for rotated
4070 paper sizes; the new option \texttt{-{}-landscaperotate} re-enables.
4071
4072 \code{upmendex}: Experimental support for Arabic and Hebrew scripts;
4073 improved character classification and language support.
4074
4075 Kpathsea: First path returned from \texttt{kpsewhich -all} is now the
4076 same as a regular (non-all) search.
4077
4078 \code{tlmgr} and infrastructure: \begin{itemize*}
4079 \item use https for \code{mirror.ctan.org} by default.
4080 \item use \code{TEXMFROOT} instead of \code{SELFAUTOPARENT} for easier
4081 relocating.
4082 \item \code{install-tl}: if download or installation fails for a given
4083 package, automatically continue and later retry (once).
4084 \end{itemize*}
4085
4086 Mac\TeX{}: Mac\TeX{} and its binary folder \texttt{universal-darwin}
4087 require \macOS\ 10.14 or higher (Mojave, Catalina, Big~Sur, Monterey). The
4088 |x86_64-darwinlegacy| binary folder, available only with the Unix
4089 \texttt{install-tl}, supports 10.6 (Snow~Leopard) and newer.
4090
4091 Platforms: No changes to platform support for this year (2022). However,
4092 for next year's release (2023), we are planning to switch the Windows
4093 binaries from 32-bit to 64-bit. Unfortunately we cannot feasibly support
4094 both simultaneously.
4095
4096 %
4097 \subsubsection{2023}
4098
4099 Windows:
4100 As announced previously, \TL{} now contains 64-bit Windows
4101 binaries instead of 32-bit. The new directory name is
4102 \texttt{bin/windows} (it did not seem right to put 64-bit binaries into a
4103 directory named with ``32''). We know this will cause extra
4104 work for Windows users, but there seemed no better alternative. If you
4105 need 32-bit Windows support, you'll need to install \TL{} 2022.
4106 From Windows~11 onward, Windows on ARM supports emulation of 64-bit
4107 AMD/Intel and thus can use the current \TL. However, Windows~10 on ARM
4108 cannot emulate Intel/AMD 64-bit, and will therefore also need a 32-bit
4109 \TL. See the separate \TL{} Windows web page
4110 (\url{https://tug.org/texlive/windows.html}).
4111
4112 Cross-engine extensions (except in original \TeX{} and e-\TeX{}):
4113 \cs{special} followed by a new keyword
4114 ``\texttt{shipout}'' delays expansion of the argument tokens
4115 until \cs{shipout} time, as with a
4116 non-\verb|\immediate\write|.{\raggedright\par}
4117
4118 \noindent ep\TeX{}, eup\TeX{}:\begin{itemize*}
4119 \item ``Raw'' (u)ptex no longer built; (u)ptex now runs in
4120 e(u)ptex's compatibility mode. Same for p\TeX{} tools, listed below.
4121 \item New primitives: \cs{tojis}, \cs{ptextracingfonts},
4122 \cs{ptexfontname}.
4123 \item For \cs{font}, new syntax for JIS/UCS is supported.
4124 \end{itemize*}
4125
4126 \noindent Lua\TeX: \begin{itemize*}
4127 \item new primitive \cs{variablefam} to allow math characters to keep
4128 their class while still letting the family adapt.
4129 \item improved r2l annotation areas
4130 \item cross-engine ``late \cs{special}'' described above.
4131 \item in Lua\TeX\ 1.17.0, released in May 2023: the
4132 socket library is now disabled by default; a new command line option
4133 \code{--socket} enables it, as well as \code{--shell-escape} (not
4134 \code{--shell-restricted}). In addition, the mime library is now always
4135 available, and new functions \code{os.socketsleep} and
4136 \code{os.socketgettime} are also always available. Finally, some
4137 obscure ways to work around various security features were
4138 fixed.
4139 \end{itemize*}
4140
4141 \noindent MetaPost: Bug fixes. \texttt{svg->dx} and \texttt{svg->dy} are now
4142 \texttt{double}, for better precision; \verb|mp_begin_iteration|
4143 updated; memory leak in \texttt{mplib} fixed.
4144
4145 \noindent pdf\TeX{}: \begin{itemize*}
4146 \item new primitive \cs{pdfomitinfodict} to omit \texttt{/Info}
4147 dictionary completely.
4148 \item new primitive \cs{pdfomitprocset} to control omitting
4149 \texttt{/ProcSet} array: \texttt{/ProcSet} is included if this
4150 parameter is negative, or if this parameter is zero and pdftex is
4151 generating PDF~1.x output.
4152 \item with \cs{pdfinterwordspaceon}, if the current font's encoding
4153 has a \texttt{/space} character at slot 32, it is used; otherwise,
4154 the \texttt{/space} from the (new) default font \texttt{pdftexspace}
4155 is used. That default font can be overridden with the new primitive
4156 \cs{pdfspacefont}. This same new procedure is used for
4157 \cs{pdffakespace}.
4158 \end{itemize*}
4159
4160 \noindent p\TeX{} et al.: \begin{itemize*}
4161 \item As mentioned above, \texttt{ptex} now runs \texttt{eptex} in
4162 compatibility mode instead of being built separately.
4163
4164 \item p\TeX{} tools (pbibtex, pdvitype, ppltotf, ptftopl) merged into
4165 corresponding up\TeX{} versions, running in compatibility mode.
4166 \end{itemize*}
4167
4168 \noindent Xe\TeX: fixed \cs{topskip} and \cs{splittopskip}
4169 computation when \cs{XeTeXupwardsmode} is active; the cross-engine
4170 ``late \cs{special}'' described above.
4171
4172 \noindent Dvipdfmx: new option \texttt{-{}-pdfm-str-utf8} to make
4173 pdfmark and/or bookmark.
4174
4175 \noindent \BibTeX{}u: \begin{itemize*}
4176 \item This Bib\TeX{} variant is mostly upward-compatible with \BibTeX,
4177 with much better (Unicode-based) multilingual support. It's been in
4178 \TL{} for some years.
4179 \item This year, more features to support CJK languages have been added,
4180 some extended from the Japanese (u)pbibtex and other programs.
4181 \end{itemize*}
4182
4183 \noindent Kpathsea: Support guessing input file encodings for Unix-ish
4184 platforms, as on Windows; enabled for
4185 (\texttt{e})\texttt{p}(\texttt{la})\texttt{tex}, \texttt{pbibtex},
4186 \texttt{mendex}.
4187
4188 \noindent \code{tlmgr} and infrastructure: \begin{itemize*}
4189 \item default to text interface on \macOS.
4190 \item install core packages first, retry other packages once.
4191 \item simplistic checks are done for enough disk space.
4192 \end{itemize*}
4193
4194 \noindent Mac\TeX{}: \begin{itemize*}
4195 \item Mac\TeX{} and its binary folder \texttt{universal-darwin}
4196 require \macOS\ 10.14 or higher (Mojave, Catalina, Big~Sur, Monterey,
4197 Ventura). The \texttt{x86\_64-darwinlegacy} binary folder, available only
4198 with the Unix \texttt{install-tl}, supports 10.6 (Snow~Leopard) and
4199 later.
4200
4201 \item The GUI package in Mac\TeX{} now contains \texttt{hintview}, a \macOS\
4202 viewer for HINT documents (created by the \texttt{hitex} and
4203 \texttt{hilatex} engines for mobile devices; see the Hi\TeX{} web page,
4204 \url{https://hint.userweb.mwn.de/hint/hitex.html}). The GUI package no
4205 longer installs a folder of documents, replacing them with a short
4206 \texttt{READ~ME} for new users and a page about \texttt{hintview}.
4207
4208 \item The \texttt{Extras} folder of additional \TeX{} software on the DVD has
4209 been replaced with a document containing links to download sites.
4210 \end{itemize*}
4211
4212 \noindent Platforms: \begin{itemize*}
4213 \item As mentioned above, the new \texttt{windows} binary directory
4214 contains 64-bit Windows binaries, and
4215 \item the \texttt{bin/win32} binary directory is gone, since we cannot
4216 support 32-bit and 64-bit Windows simultaneously.
4217 \item The \texttt{i386-cygwin} binary directory is gone, since Cygwin no
4218 longer supports i386.
4219 \end{itemize*}
4220
4221 %
4222 \subsubsection{2024}
4223
4224 Cross-engine changes (except in original \TeX{}, e-\TeX{}, and Lua\TeX):
4225 \begin{itemize*}
4226 \item Avoid crashes on devious use of \cs{output} and \cs{write} braces.
4227 \item Tiny inner-loop optimization. (Both these changes are due to
4228 David Fuchs.)
4229 \end{itemize*}
4230
4231 \noindent Lua\TeX: \begin{itemize*}
4232 \item Lua-level checks for writing to files now similar to the
4233 \TeX-level checks.
4234 \item If the Lua value \code{texconfig.trace\_extra\_newline} is set,
4235 blank lines are output in the log between macro parameters. In
4236 2020--2023, this was the case by default; before that, such blank lines
4237 were never output, which is the behavior of the other engines.
4238 \item In the past, Windows \code{texlua} (not \code{luatex}, and not
4239 any other platform), internally performed wildcard expansion on the
4240 arguments. This no longer happens.
4241 \end{itemize*}
4242
4243 \noindent MetaPost: \begin{itemize*}\raggedright
4244 \item MPFI library now included for interval arithmetic; enabled with
4245 \texttt{-{}-numbersystem=interval}.
4246 \end{itemize*}
4247
4248 \noindent pdf\TeX: \begin{itemize*}
4249 \item More reliable text extraction on BigEndian systems.
4250 \item More checks against corrupt pfb, fmt, pdf files.
4251 \item Avoid writing a corrupt pdf given unusual pdf inclusions.
4252 \item Manual converted to \LaTeX\ and thoroughly reviewed, though
4253 substantive updates are minimal.
4254 \end{itemize*}
4255
4256 \noindent ep\TeX{}, eup\TeX{}: \begin{itemize*}
4257 \item New simple encoding conversion utility \texttt{ptekf}.
4258 \item \texttt{eptex} no longer built separately; it runs in \texttt{euptex}'s
4259 legacy-encoding mode.
4260 \end{itemize*}
4261
4262 \noindent Xe\TeX{}: \begin{itemize*}
4263 \item Unicode characters in filenames beyond the BMP are supported.
4264 \end{itemize*}
4265
4266 \noindent Dvipdfmx: \begin{itemize*}
4267 \item Calculate time zone offset in the same way as pdf\TeX.
4268 \item Handle variation selectors to cope with the new Adobe-Japan1-UCS2 CMap.
4269 \item Fallback multibyte characters in virtual fonts to OFM fonts for (u)p\TeX.
4270 \item Support the \code{named} keyword in the \code{pdf:image} special.
4271 \end{itemize*}
4272
4273 \noindent Kpathsea: \begin{itemize*}
4274 \item Support an extended check for safe filenames which also allows
4275 writing under \code{TEXMF}[\code{SYS}]\code{VAR}, for Lua\AllTeX{}; new
4276 functions and corresponding \code{kpsewhich} options.
4277 \item Support a new variable \code{TEXMF\_OUTPUT\_DIRECTORY} (alongside
4278 the traditional \code{TEXMFOUTPUT}), so that subprograms can have access to an
4279 \texttt{-{}-output-directory} setting in an engine invocation.
4280 \end{itemize*}
4281
4282 \noindent CWEB: \begin{itemize*}
4283 \item Support Lua\TeX{} as backend \TeX{} engine.
4284 \item Fix buffer overflow on lines with no breakpoint.
4285 \end{itemize*}
4286
4287 \noindent \code{tlmgr}: \begin{itemize*}
4288 \item New action \code{bug} to help find bug-reporting information.
4289 \item Use our own root certificate bundle on all platforms, to support LWP
4290 more widely, notably on macOS.
4291 \item Detect a remote repository older than the local installation (i.e.,
4292 a stale mirror), and don't update, to avoid incorrect package removals.
4293 \item Support \ConTeXt{} paper size setting.
4294 \item Prune backups of tlpdb files for mirrored repositories (main and
4295 tlcontrib).
4296 \end{itemize*}
4297
4298 \noindent Platforms: \begin{itemize*}
4299 \item The \ISO\ image again includes binaries for all platforms. For the
4300 last several years, some binary sets had been pruned, but this year,
4301 we are not creating a physical DVD as a user group benefit, so may
4302 as well include everything again. Also, even a maximimally-pruned
4303 image is too large to fit on a single-layer DVD, so pruning has no
4304 benefit for the 2024 volunteer burners. More info at
4305 \url{https://tug.org/texcollection/}.
4306 \item Robert Alessi provides binaries for a native \TL\ installation on
4307 OpenBSD at \url{https://sr.ht/~ralessi/texlive-openbsd/}.
4308 \end{itemize*}
4309
4310 \noindent Mac\TeX: contains the latest Ghostscript 10.03.0, updates
4311 of all four GUI programs, along with (as always) all new \TL\ changes. The
4312 binaries still support macOS~10.14 (Mojave, 2018) and later. (As usual,
4313 earlier Mac versions are supported by the \texttt{x86\_64-darwinlegacy}
4314 binaries, which are part of \TL, but not Mac\TeX{}.)
4315
4316 %
4317 \subsubsection{2025}
4318
4319 Cross-engine changes (except in original \TeX{}):
4320 \begin{itemize*}
4321 \item Generate PDF-1.7 in all formats, both plain and \LaTeX{}; before, it was
4322 1.5. You may need an older version, especially for printing companies.
4323 You can generate, e.g., PDF-1.4 in various ways:
4324 \begin{itemize}
4325 \item Running \texttt{ps2pdf14} on the PDF file after it's generated
4326 by \TeX{}; this simple wrapper is part of Ghostscript. Other
4327 external software can do the same job.
4328 \item \LaTeX{} with PDF backends: \verb|\pdf_version_gset:n{1.4}|
4329 \item pdf\TeX{}: \verb|\pdfmajorversion=1 \pdfminorversion=4|
4330 \item Lua\TeX{}:
4331 \verb|\pdfvariable majorversion=1 \pdfvariable minorversion=4|
4332 \item \XeTeX{}:
4333 \verb|\special{pdf:majorversion:1}\special{pdf:minorversion:4}|
4334 \end{itemize}
4335 \item If \TeX{} exits due to the \texttt{-halt-on-error} option,
4336 write the help message to the log file, as happens by default.
4337 \item New primitive parameter \cs{ignoreprimitiveerror}; if set to 1,
4338 the error \texttt{"Infinite glue shrinkage found in box being
4339 split"} becomes a warning, so the program exit status is not changed
4340 to failure.
4341 Other values are reserved for future use. (Background:
4342 \url{https://www.latex-project.org/news/latex2e-news/ltnews39.pdf},
4343 section ``Enhancements to the new mark mechanism''.
4344 \item Scaling fonts to $\ge2048$pt now results in an error message, instead
4345 of (unhandled) arithmetic overflow or silent changing of the user's value.
4346 \end{itemize*}
4347
4348 \noindent Lua\TeX: \begin{itemize*}
4349 \item LuaJIT 2.1.1736781742.
4350 \item New \texttt{luaffi} lib, supporting aarch64.
4351 \item If \cs{tracinglostchars=4}, warn about missing characters when
4352 glyphs are processed, instead of waiting until typesetting needs
4353 them. If \cs{tracinglostchars=5}, make that ``early'' diagnostic
4354 into an error.
4355 \item New primitive \cs{mathemptydisplaymode}; when set
4356 to 1, empty paragraphs before a display equation will be ignored. By
4357 default paragraphs before a display equation containing dir nodes
4358 are not ignored, which has been the traditional behavior.
4359 \item For PNG handling, we no longer set the attr on the mask. If we get
4360 a report about dropping this we could add a \texttt{maskattr}
4361 feature, but one should consider to include a correct pdf of the
4362 image instead, as it's more robust.
4363 \item Handle token combiners in immediate assignments.
4364 \item Cross-engine updates noted above.
4365 \end{itemize*}
4366
4367 %\noindent MetaPost: \begin{itemize*}\raggedright
4368 %\end{itemize*}
4369
4370 \noindent pdf\TeX: \begin{itemize*}
4371 \item New primitive \cs{pdfptexuseunderscore} to use \verb|_| instead of
4372 \verb|.|\ in various dictionary entries, e.g., \verb|PTEX_Fullbanner|
4373 instead of \verb|PTEX.Fullbanner|.
4374 \item Don't omit real spaces just because the font changes.
4375 \item Increase tolerance for detecting interword spaces in overfull lines.
4376 \item Ignore tiny resolutions like 1x1 embedded in images instead of
4377 exceeding \cs{maxdimen}.
4378 \item Cross-engine updates noted above.
4379 \end{itemize*}
4380
4381 \noindent ep\TeX{}, eup\TeX{}: \begin{itemize*}
4382 \item Support combining characters with multiple codepoints,
4383 Unicode Latin characters and 16-bit OFM Level-0 with
4384 new kcatcodes: \texttt{modifier}(20), \verb|latin_ucs|(14).
4385 \item Cross-engine updates noted above.
4386 \end{itemize*}
4387
4388 \noindent Xe\TeX{}: \begin{itemize*}
4389 \item Cross-engine updates noted above.
4390 \end{itemize*}
4391
4392 \noindent Dvipdfmx: \begin{itemize*}
4393 \item The \texttt{ebb} executable is now a separately-maintained script
4394 instead of a link to \texttt{dvipdfmx}.
4395 \item Support up\TeX{} new encoding for combining characters via virtual fonts.
4396 \item Fixes for embedded TrueType fonts with $>127$ glyphs, and more.
4397 \item Fixes for including images multiple times.
4398 \end{itemize*}
4399
4400 \noindent CWEB: \begin{itemize*}
4401 \item New option \texttt{+F} for cweave and ctwill for compound statements.
4402 \item Sync pdf bookmark pages with table-of-contents.
4403 \item Integration of Martin Ruckert's solution for faster index sorting.
4404 \item Support macro \cs{9} for sorting names-of-the-sections.
4405 \item Improved sorting algorithm in \texttt{ctwill-proofsort}.
4406 \item Output names-of-the-sections in \texttt{ctwill} format.
4407 \end{itemize*}
4408
4409 Dvips: \begin{itemize*}
4410 \item Support up\TeX{} new encoding for combining characters via
4411 virtual fonts.
4412 \end{itemize*}
4413
4414 \noindent Kpathsea: \begin{itemize*}
4415 \item \texttt{kpsewhich} outputs a blank line when a given file cannot be
4416 found, if more than one file to search for is specified.
4417 \end{itemize*}
4418
4419 \noindent \code{tlmgr}: \begin{itemize*}
4420 \item \texttt{tlmgr info}: new option \texttt{--only-files} to just
4421 report the files for a given package.
4422 \item \texttt{tlmgr search}: new option \texttt{--json}.
4423 \end{itemize*}
4424
4425 \noindent Platforms: \begin{itemize*}
4426 \item The \verb|x86_64-linux| binaries are now built on Alma Linux~8,
4427 since support for CentOS~7 (even for security updates) ended as of
4428 June~30, 2024. We regret this but see no alternative. Binaries for
4429 older systems will be available
4430 (see \url{https://tug.org/texlive/custom-bin.html}).
4431
4432 \item \TL\ now provides a file \texttt{scripts-targets.lst} with both the name
4433 and the target for symlinked scripts, for the convenience of distros.
4434 It's in the source directory
4435 \texttt{Build/source/texk/texlive/linked\_scripts}. The longstanding
4436 file \texttt{scripts.lst}, with just the targets, in that directory, is
4437 still maintained.
4438 \end{itemize*}
4439
4440 \noindent Windows:
4441 \begin{itemize*}
4442 \item Visual Basic usage in \texttt{uninstall-windows} and
4443 \texttt{runscript.tlu} has been replaced by Powershell, since VB is
4444 optional as of Windows 11.
4445 \end{itemize*}
4446
4447 \noindent Mac\TeX: \hangindent=\leftmargin
4448 Again this year, Mac\TeX{}-2025 supports both Arm and Intel processors
4449 on macOS 10.14 (Mojave, 2018), and higher. It installs:
4450 \begin{itemize*}
4451 \item \TeX{} Live 2025.
4452 \item Ghostscript-10.04.0.
4453 \item \texttt{libgs} and \texttt{mutool}, for \texttt{dvisvgm}. In
4454 previous years, this \texttt{dvisvgm} support required X11, but that
4455 requirement is eliminated in 2025 and \texttt{dvisvgm} will work both
4456 with and without X11.
4457 \item HintView 2.0, which understands the color extensions added to the
4458 latest \texttt{hitex} in \TeX{} Live 2025.
4459 \item Asymptote, which now requires macOS 11 (Big Sur, 2020) or higher.
4460 \item TeXShop 5.49, which supports Apple's latest Apple Intelligence
4461 features, including Writing Tools.
4462 \end{itemize*}
4463
4464 %
4465 \htmlanchor{news}
4466 \subsection{Present: 2026}
4467 \label{sec:tlcurrent}
4468
4469 Cross-engine changes (except in original \TeX{} and Aleph):
4470 \begin{itemize*}
4471 \item When the ``\texttt{Infinite glue shrinkage}'' error is
4472 ignored (see the 2025 release notes), the word ``error'' is no longer
4473 included in the output, and the message is written only to the log file.
4474 This was a source of minor confusion and false positives.
4475 \end{itemize*}
4476
4477 \noindent Hi\TeX: \begin{itemize*}\raggedright
4478 \item Now exclusively uses the UTF-8 input encoding.
4479 \item OpenType and TrueType fonts are now supported minimally (no
4480 ligatures, no math); this will improve in time.
4481 \item \cs{Uchar} and \cs{Ucharcat} primitives added.
4482 \item The \LaTeX{} kernel needs updates for this version, so \texttt{hilatex}
4483 is not available for the time being.
4484 \item Major changes throughout the code base, including the HINT viewers, to
4485 implement the above. Use with care!
4486 \item Cross-engine updates noted above.
4487 \end{itemize*}
4488
4489 \noindent Lua\TeX: \begin{itemize*}
4490 \item New \texttt{luaffi}.
4491 \item Lua bindings for the HarfBuzz subset API.
4492 \item \texttt{read\_img} now looks in a given \texttt{--output-directory}.
4493 \item Saves and restores \texttt{pdf->objcompresslevel} along with
4494 \texttt{pdf->compress\_level}.
4495 \item \texttt{texlua} errors print tracebacks.
4496 \item \texttt{set\_macro} check for removing trailing space improved.
4497 \item Wrong spacing around display with \cs{matheqdirmode=1}
4498 partially fixed.
4499 \item Restored \cs{mathflattenmode}.
4500 \item Fixes for legacy handling of TrueType fonts.
4501 \item Experimental extension to \texttt{ToUnicode} for Type~1 fonts.
4502 \item Maximum size of the destination names table for PDF output raised to
4503 1048576.
4504 \item Additional \texttt{value} field for write nodes (\texttt{getfield}) for
4505 unexpanded token tables.
4506 \item Some unused modes made obsolete.
4507 \item Cross-engine updates noted above.
4508 \end{itemize*}
4509
4510 \noindent MetaPost: \begin{itemize*}\raggedright
4511 \item \texttt{mp\_number\_to\_scaled} returns a 64-bit signed integer instead
4512 of the system-dependent \texttt{int}. Internally, start on replacing
4513 \texttt{int} with \texttt{int64\_t} in general.
4514 \item \texttt{mp\_hard\_times} fixed.
4515 \item Fixes for \texttt{weave}.
4516 \item Help message reorganized and updated for consistency.
4517 \end{itemize*}
4518
4519 \noindent pdf\TeX: \begin{itemize*}
4520 \item Don't complain about PDF minor version $\le2$ unless major version $=1$.
4521 \item Don't erroneously shift fraction denominators or other text if
4522 \cs{pdfpageheight} is used.
4523 \item Fix overlapping text in \texttt{ptmr8r} and other fonts.
4524 \item If the environment variable \code{TEXMF\_DEBUG\_PNG\_COPY} is set to~1,
4525 report attributes of each PNG image and whether it was copied.
4526 \item Cross-engine updates noted above.
4527 \end{itemize*}
4528
4529 \noindent ep\TeX{}, eup\TeX{}: \begin{itemize*}
4530 \item Cross-engine updates noted above.
4531 \end{itemize*}
4532
4533 \noindent Xe\TeX{}: \begin{itemize*}
4534 \item Cross-engine updates noted above.
4535 \end{itemize*}
4536
4537 \noindent Dvipdfmx: \begin{itemize*}
4538 \item Option \texttt{-o -} to send output to stdout reenabled, after being
4539 unintentionally disabled for several years.
4540 \end{itemize*}
4541
4542 \noindent CWEB: \begin{itemize*}
4543 \item All CWEB programs work \texttt{--verbose}ly by default again.
4544 \item All CWEB programs no longer fail in case of warning messages.
4545 \item \texttt{ctangle} produces far less whitespace in preprocessor macros.
4546 \item \texttt{ctwill-proofsort} supports multiple definitions for the same
4547 identifier.
4548 \end{itemize*}
4549
4550 %\noindent Dvips: \begin{itemize*}
4551 %\end{itemize*}
4552
4553 \noindent Upmendex: \begin{itemize*}
4554 \item Experimental support for Brahmic scripts (Bengali, Gurmukhi,
4555 Gujarati, Kannada, Lao, Malayalam, Oriya, Sinhala, Tamil, Telugu).
4556 \end{itemize*}
4557
4558 \noindent Kpathsea: \begin{itemize*}\raggedright
4559 \item New configuration value \texttt{texmf\_nlink\_for\_leaf} to specify
4560 whether the \texttt{st\_nlink=2} check is made to decide whether
4561 we're in a leaf directory; in the default \texttt{texmf.cnf}, the check is
4562 now disabled.
4563
4564 \item The configuration value \texttt{openin\_any} no longer has any effect;
4565 the interface functions are still compiled into the library, but now
4566 consider any filename to be ok for reading. To the best of anyone's
4567 knowledge, no value but `\texttt{a}' was ever useful (or used).
4568 \end{itemize*}
4569
4570 \noindent \code{tlmgr}: \begin{itemize*}
4571 \item Check for backup container creation failure.
4572 \item In \texttt{--usermode}, do not warn about the
4573 \texttt{texlive-scripts} package being missing.
4574 \end{itemize*}
4575
4576 \noindent Other programs: \begin{itemize*}
4577 \item \texttt{fmtutil, updmap}: make self-locating as with \texttt{tlmgr}.
4578 \item New program \texttt{xdvipsk}, an extended \texttt{dvips} with
4579 support for more image formats and (with Lua\TeX{}) OpenType and
4580 TrueType fonts. See the article by Sigitas Tolusis in
4581 \textsl{TUGboat}, \url{https://tug.org/TUGboat/tb38-2/tb119tolusis.pdf}.
4582 \item Many man pages substantially updated.
4583 \end{itemize*}
4584
4585 \noindent Platforms: \begin{itemize*}
4586 \item See Mac\TeX{} note just below.
4587 \item The \texttt{i386-linux}, \texttt{aarch64-linux}, and
4588 \texttt{armhf-linux} binaries are now built on Debian bullseye
4589 (initially released 2021).
4590 \end{itemize*}
4591
4592 \noindent Mac\TeX: \hangindent=\leftmargin
4593 Mac\TeX{}-2026 now supports Big Sur (2020, macOS~11) and higher, on both
4594 Intel and Arm. Support for Mojave (2018) and Catalina (2019,
4595 macOS~10) has been dropped. It installs:
4596 \begin{itemize*}
4597 \item \TeX{} Live 2026;
4598 \item Ghostscript-10.06.0;
4599 \item \TeX{}Shop, including a special version supporting Liquid Glass;
4600 \item \LaTeX{}iT, BibDesk, HintView.
4601 \end{itemize*}
4602
4603 The companion small Basic\TeX{} distribution for Macs (download size
4604 about 120MB, \url{https://tug.org/mactex/morepackages.html}) now
4605 includes all core packages for tagging support, the \LaTeX{}
4606 \texttt{-dev} engines for testing, and \texttt{tex4ht}. Those who would
4607 like to install this on other platforms can use \texttt{scheme-small}.
4608 Basic\TeX{} supports all three main typesetting engines: pdf\LaTeX{},
4609 Xe\LaTeX{}, and Lua\LaTeX{}.
4610
4611 \smallskip
4612
4613 \noindent Finally: many thanks to Siep Kroonenberg for her work on
4614 \TeX{} Live, especially Windows support, for many years. She has retired
4615 and is moving on to other projects. Thanks again Siep, and best wishes!
4616
4617
4618 \subsection{Future}
4619
4620 We intend to continue to release new versions of \TL, and would like to
4621 provide more documentation, more programs, an ever-improved and
4622 better-checked tree of macros and fonts, and anything else \TeX. This
4623 work is all done by volunteers in their spare time, and there is always
4624 more to do. Please see \url{https://tug.org/texlive/contribute.html}.
4625
4626 Please send corrections, suggestions, and offers of help to:
4627 \begin{quote}
4628 \email{[email protected]} {\small (public mailing list,
4629 you need not subscribe in order to post)}\\
4630 \url{https://tug.org/texlive}
4631 \end{quote}
4632
4633 \medskip
4634 \noindent \textsl{Happy \TeX ing!}
4635
4636 \end{document}