TL manual: portable, in-place and ISO sections

git-svn-id: svn://tug.org/texlive/trunk@21850 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 116 insertions, 0 deletions

diff --git a/Master/tlpkg/doc/tl-portable.tex b/Master/tlpkg/doc/tl-portable.tex
new file mode 100644
index 00000000000..f05fe9e9750
--- /dev/null
+++ b/Master/tlpkg/doc/tl-portable.tex
@@ -0,0 +1,116 @@
+\documentclass{article}
+\let\tldocenglish=1  % for live4ht.cfg
+%\usepackage{tex-live}
+% replacement macros
+\usepackage{url}
+\let\filename\url
+\newcommand\acro[1]{#1}
+\newcommand\TL{\TeX~Live}
+\let\ttdescription\description
+\let\endttdescription\enddescription
+\newcommand\htmlanchor[1]{\relax}
+
+\usepackage[latin1]{inputenc} % translators: use your preferred encodings.
+\usepackage[T1]{fontenc}
+
+\begin{document}
+
+\section{Bits and pieces to be added to the \TL{} manual}
+
+\subsection{Add to: Command-line install-tl options}
+
+\begin{ttdescription}
+\item[-portable] Install for portable use on \emph{e.g.} a
+  \acro{USB} stick. Also selectable from within the perltk- and text
+  installers; see section~\ref{sec:portable-tl}.
+
+\item[-in-place] If you already have an rsync- or svn checkout of
+  \TL{} then this option will use it as-is and just do the necessary
+  post-install. Be warned that the file
+  \filename{tlpkg/texlive.tlpdb} may be rewritten, and that removal
+  has to be done manually. This option cannot be toggled via the
+  installer interface.
+\end{ttdescription}
+
+% The next section replaces the `Maximally portable \protect\TL{} on
+% DVD and USB' section
+
+\section{Special scenarios}
+
+\htmlanchor{tlportable}
+\subsection{Creating a portable installation}
+\label{sec:portable-tl}
+
+The portable installer option creates a completely self-contained
+TeX Live installation under a common root and forgoes system
+integration. You can create such an installation directly on a
+\acro{USB} stick or copy it to a USB stick afterwards.
+
+If you want to run this portable installation, you need to add the
+appropriate binary directory to the searchpath during your terminal
+session.  For Windows, you can double-click a batchfile
+\filename{tlmenu.bat} in the root of the installation that lets you
+choose between a few tasks:
+\begin{verbatim}
+=== TeX Live Menu ===
+
+1 TeX Live command prompt
+2 Managing the installation
+3 TeXWorks
+Q Quit
+
+Make a choice
+\end{verbatim}
+
+\subsection{Running from \acro{ISO} or \acro{DVD}}
+
+If you don't update or modify your installation too often, and have
+several systems on which to use \TL{}, it may be convenient to
+create an \acro{ISO} of your \TL{} installation:
+
+\begin{itemize}
+\item Copying an \acro{ISO} between different computers is much
+  faster than copying a normal installation.
+\item If you are dual-booting between different operating systems
+  and want them to share a \TL{} installation, an \acro{ISO}
+  installation is not tied to the idiosyncracies and limitations of
+  other mutually supported filesystems (\acro{FAT32}, \acro{NTFS},
+  \acro{HFS+}).
+\item Virtual machines can simply mount such an \acro{ISO}.
+\end{itemize}
+
+When preparing for an \acro{ISO}- or \acro{DVD} installation, it
+makes sense not to have a subdirectory for the year, but to have
+\filename{texmf-local} at the same level as the other trees
+(\filename{texmf}, \filename{texmf-dist} etc.).
+
+\subsubsection{How to use}
+
+Desktop Unix/Linux systems, including Mac OS X, are able to mount an
+\acro{ISO}. Apart from that, nothing changes compared to a normal
+hard disk installation, see section \ref{sec:env}.
+
+For a physical (rather than virtual) Windows system, you can burn
+the \acro{ISO} to \acro{DVD}. However, it may be worth your while to
+investigate free \acro{ISO}-mounting options. For Windows XP,
+Microsoft itself offers \filename{winxpvirtualcdcontrolpanel}.
+
+For Windows system integration, you can include the
+\filename{w32client} scripts described in \ref{sec:netinstall} and
+\url{http://www.tug.org/texlive/w32client.html}, which work just as
+well for an \acro{ISO}- as for a network installation.
+
+For Mac OS X, TeXshop and TeXworks will be able to use the
+\acro{DVD} installation if a symlink \filename{/usr/texbin} points
+to the appropriate binary directory, \emph{e.g.}
+\begin{verbatim}
+sudo ln -s /Volumes/MyTeXLive/bin/universal-darwin /usr/texbin
+\end{verbatim}
+
+\textbf{Note.}  \TL{} 2010 was the first \TL{} edition which was no
+longer `live'. But it always required some acrobatics to run earlier
+versions from \acro{DVD} or \acro{ISO}. In particular, there was no
+way around setting at least one extra environment variable. If you
+create your \acro{ISO} from an existing installation then there is
+no need for this.
+\end{document}