| 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} |