summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/texlive/texlive-en/texlive-en.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/texlive/texlive-en/texlive-en.tex')
-rw-r--r--Master/texmf/doc/texlive/texlive-en/texlive-en.tex115
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}