summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex')
-rw-r--r--Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex68
1 files changed, 57 insertions, 11 deletions
diff --git a/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex b/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex
index 5c771ec01a6..b7e741b2dbc 100644
--- a/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex
+++ b/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex
@@ -486,7 +486,7 @@ a \TeX\ user group (highly recommended,
(\url{https://tug.org/store}), or burning your own from the \ISO\ image.
You can also mount the \ISO\ directly on most systems. After installing
from \DVD\ or \ISO, if you want to get continuing updates from the
-Internet, please see \ref{sec:dvd-install-net-updates}.
+Internet, please see section~\ref{sec:dvd-install-net-updates}.
\end{description}
@@ -513,7 +513,7 @@ The following sections explain installer start-up in more detail.
Below, \texttt{>} denotes the shell prompt; user input is
\Ucom{\texttt{bold}}.
-The script \filename{install-tl} is a Perl script. The simplest way
+The \filename{install-tl} program is a Perl script. The simplest way
to start it on a Unix-compatible system is as follows:
\begin{alltt}
> \Ucom{perl /path/to/installer/install-tl}
@@ -1007,7 +1007,7 @@ If the given argument is local (either a path or a \texttt{file:/} url),
compressed files in an \dirname{archive} subdirectory of the repository
path are used (even if uncompressed files are available as well).
-
+\htmlanchor{postinstall}
\subsection{Post-install actions}
\label{sec:postinstall}
@@ -1351,6 +1351,51 @@ section~\ref{sec:font-conf-sys}.
\end{enumerate}
+\htmlanchor{uninstall}
+\subsection{Uninstalling \TL}
+\label{sec:uninstall}
+
+To uninstall \TL\ (after a successful installation):
+
+\begin{alltt}
+> \Ucom{tlmgr uninstall --all}
+\end{alltt}
+
+You will be asked for confirmation, else nothing will be done.
+(Without \code{-{}-all}, the \code{uninstall} action is used to remove
+individual packages.)
+
+This does not remove user-specific directories, namely (see also
+section~{sec:texmftrees}):
+
+\begin{ttdescription}
+\item [TEXMFCONFIG] This is intended for user configuration changes.
+If you want to preserve them, be sure you know how to recreate them
+before removing.
+
+\item [TEXMFVAR] This is intended to store automatically-generated
+runtime data, such as local format files. Unless you've used it for
+other purposes, it should be safe to remove.
+
+\item[TEXMFHOME] Contains only files you yourself installed, typically
+those not available in the distributions. Unless you are completely
+stopping using \TeX, or want to start over from scratch, you probably
+don't want to remove this.
+
+\end{ttdescription}
+
+\noindent You can find the directory paths for these variables by
+running \code{kpsewhich -var-value=\ttvar{var}}.
+
+This \prog{tlmgr} uninstallation also does not undo post-installation
+actions, such as \envname{PATH} changes in your shell initialization
+files and system access to the fonts in \TL\ (see
+section~\ref{sec:postinstall}).
+
+On Windows, uninstallation can be done through the \GUI; see
+section~\ref{sec:winfeatures}.
+
+
\subsection{Links for additional downloadable software}
If you are new to \TeX{}, or otherwise need help with actually writing
@@ -1359,11 +1404,12 @@ If you are new to \TeX{}, or otherwise need help with actually writing
Links for some other tools you may consider installing:
\begin{description}
-\item[Ghostscript] \url{https://ghostscript.com/}
+\item[Ghostscript] \url{https://ghostscript.com/}, a free PostScript and
+ PDF interpreter.
\item[Perl] \url{https://perl.org/} with
- supplementary packages from CPAN, \url{https://cpan.org/}
+ supplementary packages from CPAN, \url{https://cpan.org/}.
\item[ImageMagick] \url{https://imagemagick.org}, for graphics
- processing and conversion
+ processing and conversion.
\item[NetPBM] \url{http://netpbm.sourceforge.net}, also for graphics.
\item[\TeX-oriented editors] There is a wide choice, and it is a matter of the
@@ -3159,8 +3205,8 @@ The \cmdname{xindy} indexing program
(\url{http://xindy.sourceforge.net/}) is now included on most platforms.
The \cmdname{kpsewhich} tool can now report all matches for a given file
-(option \optname{--all}) and limit matches to a given subdirectory
-(option \optname{--subdir}).
+(option \optname{-{}-all}) and limit matches to a given subdirectory
+(option \optname{-{}-subdir}).
The \cmdname{dvipdfmx} program now includes functionality to extract
bounding box information, via the command name \cmdname{extractbb}; this
@@ -3715,7 +3761,7 @@ eliminating the dependency on poppler (and the need for C++);
Lua interface changed accordingly.
MetaPost: \code{r-mpost} command name recognized as an
-alias for invocation with the \code{--restricted} option, and added to
+alias for invocation with the \code{-{}-restricted} option, and added to
the list of restricted commands available by default.
Minimum precision now 2 for decimal and binary mode.
Binary mode no longer available in MPlib but still available in
@@ -3781,7 +3827,7 @@ are removed from the filename, but it is otherwise left unchanged after
tokenization. This does not currently affect \LaTeX's \cs{input} command,
as that is a macro redefinition of the standard \cs{input} primitive.
-\item New option \texttt{--cnf-line} for \texttt{kpsewhich}, \texttt{tex},
+\item New option \optname{-{}-cnf-line} for \texttt{kpsewhich}, \texttt{tex},
\texttt{mf}, and all other engines, to support arbitrary configuration
settings on the command line.
@@ -3825,7 +3871,7 @@ are not in Mac\TeX\ because they are not notarized, but a
\code{tlmgr} and infrastructure: \begin{itemize*}
\item Automatically retry (once) packages that fail to download.
\item New option \texttt{tlmgr check texmfdbs}, to
-to check consistency of \texttt{ls-R} files and \texttt{!!}
+to check consistency of \texttt{ls-R} files and \texttt{!!}\
specifications for each tree.
\item Use versioned filenames for the package containers, as in
\texttt{tlnet/archive/\textsl{pkgname}.rNNN.tar.xz}; should be