diff options
Diffstat (limited to 'Master/texmf/doc/texlive/texlive-en/texlive-en.tex')
-rw-r--r-- | Master/texmf/doc/texlive/texlive-en/texlive-en.tex | 115 |
1 files changed, 91 insertions, 24 deletions
diff --git a/Master/texmf/doc/texlive/texlive-en/texlive-en.tex b/Master/texmf/doc/texlive/texlive-en/texlive-en.tex index b6c0c8c9efe..9cf29c4e92e 100644 --- a/Master/texmf/doc/texlive/texlive-en/texlive-en.tex +++ b/Master/texmf/doc/texlive/texlive-en/texlive-en.tex @@ -20,7 +20,7 @@ \url{http://tug.org/texlive/} } -\date{May 2011} +\date{June 2011} \maketitle @@ -80,7 +80,7 @@ small, and downloads everything requested from the Internet. The \DVD{} installer lets you install to a local disk. You cannot run \TL{} directly from the \TK{} \DVD{} (or its \code{.iso} image), but you -can prepare a runnable installation on, e.g., a \acro{USB} stick (see +can prepare a runnable installation on, e.g., a \USB{} stick (see section~\ref{sec:portable-tl}). Installation is described in later sections (\p.\pageref{sec:install}), but here is a quick start: @@ -725,7 +725,7 @@ platforms as well. This can be useful if you are sharing a \TeX\ tree across a network of heterogenous machines, or for a dual-boot system. -\subsubsection{Selecting what is going to be installed} +\subsubsection{Selecting what is to be installed} \label{sec:components} \begin{figure}[tbh] @@ -916,10 +916,17 @@ to introduce option names. These are the most common ones: language but if it fails, or if the right language is not available, then it uses English as a fallback. -\item[-portable] Install for portable use on a \acro{USB} stick - or \DVD. This option minimizes impact on the host system, making \TL{} - self-contained in a single directory. See also - section~\ref{sec:portable-tl} for more details on portable usage. +\item[-in-place] If you already have an rsync, svn, or other copy of + \TL{} (see \url{http://tug.org/texlive/acquire-mirror.html}) then this + option will use what you've got, as-is, and do only the necessary + post-install. Be warned that the file \filename{tlpkg/texlive.tlpdb} + may be overwritten; saving it is your responsibility. Also, package + removal has to be done manually. This option cannot be toggled via the + installer interface. + +\item[-portable] Install for portable use on, e.g., a \USB{} stick. + Also selectable from within the GUI and text + installers; see section~\ref{sec:portable-tl}. \item[-profile {\sl file}] The installer always writes a file \filename{texlive.profile} to the \dirname{tlpkg} subdirectory of your @@ -931,6 +938,7 @@ to introduce option names. These are the most common ones: repository from which to install; see following. \end{ttdescription} + \subsubsection{The \optname{-repository} option} \label{sec:location} @@ -1304,7 +1312,12 @@ For a much longer list of packages and programs, see -\section{Network installations} +\section{Specialized installation considerations} + +The previous sections describe the basic installation process. Here we +turn to some specialized cases. + +\subsection{Network (shared) installations} \label{sec:netinstall} \TL{} has been designed to be sharable between different users on one @@ -1333,27 +1346,81 @@ in the same zip file. See the web page for more information. \htmlanchor{tlportable} -\section{Maximally portable \protect\TL{} on DVD and USB} +\subsection{Portable (\USB{}) installations} \label{sec:portable-tl} -To use \TL{} in a ``portable'' way, minimizing impact on the host -system, you should first install \TL{} to a \acro{USB} stick using the -\optname{-portable} option of the installer (see -section~\ref{sec:cmdline}). Then you can run the \filename{tl-portable} -script (Unix) or \filename{tl-portable.bat} batch file (Windows) from -the resulting installation root to start up a shell. +The \code{-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 +\USB{} stick or copy it to a \USB{} stick afterwards. + +To actually run using this portable installation, you need to add the +appropriate binary directory to the search path during your terminal +session, as usual. For Windows, you can double-click +\filename{tl-tray-menu} at the root of the installation to choose +between a few common tasks: + +\begin{verbatim} +... +1 TeX Live command prompt +2 Managing the installation +3 TeXworks +Q Quit +... +\end{verbatim} + -You could also burn the resulting contents of the stick back to \DVD{} -if that is more convenient to (for example) give to others. +\subsection{\ISO\ (or \DVD) installations} -When the \filename{tl-portable} script is run from a \DVD{} for the -first time, some files will be generated on the host system in a -directory \dirname{~/.tlportable2010}, which will take some time. On -subsequent runs, though, it will start quickly. +If you don't need to update or otherwise modify your installation often, +and\slash or have several systems on which to use \TL{}, it may be +convenient to create an \ISO\ of your \TL{} installation, because: + +\begin{itemize} +\item Copying an \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 \ISO + installation is not tied to the idiosyncrasies and limitations of + other mutually supported filesystems (\acro{FAT32}, \acro{NTFS}, + \acro{HFS+}). +\item Virtual machines can simply mount such an \ISO. +\end{itemize} + +Of course you can also burn an \ISO\ to \DVD, if that is useful for you. + +Desktop \GNU/Linux/Unix systems, including \MacOSX, are able to mount an +\ISO. Apart from that, nothing changes compared to a normal hard disk +installation, see section \ref{sec:env}. + +When preparing such an \ISO\ installation, it is best not to omit the +subdirectory for the release year, but instead to have +\filename{texmf-local} at the same level as the other trees +(\filename{texmf}, \filename{texmf-dist}, etc.). You can do this with +the normal directory options in the installer. + +For a physical (rather than virtual) Windows system, you can burn the +\ISO\ to \acro{DVD}. However, it may be worth your while to investigate +free \ISO-mounting options. For Windows \acro{XP}, Microsoft offers +\filename{winxpvirtualcdcontrolpanel}. + +For Windows system integration, you can include the \filename{w32client} +scripts described in section~\ref{sec:netinstall} and +at \url{http://tug.org/texlive/w32client.html}, which work just as well +for an \ISO\ as for a network installation. + +On \MacOSX, TeXShop and \TeX{}works will be able to use the \acro{DVD} +installation if a symlink \filename{/usr/texbin} points to the +appropriate binary directory, e.g., +\begin{verbatim} +sudo ln -s /Volumes/MyTeXLive/bin/universal-darwin /usr/texbin +\end{verbatim} -The rest of the system will be unaware of \TL. If you want your editor -to be aware of this \TL, then you should start it from a second, -parallel, such \filename{tl-portable} session. +Historical note: \TL{} 2010 was the first \TL{} edition which was no +longer distributed `live'. However, it always required some acrobatics +to run from \DVD\ or \ISO; in particular, there was no way around +setting at least one extra environment variable. If you create your +\ISO\ from an existing installation then there is no need for this. \section{\cmdname{tlmgr}: Managing your installation} |