[tldoc] Request for uninstallation guide

[Karl Berry]

Hi Cyrus,

    Subject: [tldoc] Request for uninstallation guide

Ok, I added a short section about it.
The basic answer is "tlmgr uninstall --all", although (as you pointed
out) this does not undo the post-install actions.

Thanks for the suggestion,
Karl

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\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}.