summaryrefslogtreecommitdiff
path: root/Master/texmf
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf')
-rw-r--r--Master/texmf/doc/texlive/texlive-en/texlive-en.tex39
1 files changed, 18 insertions, 21 deletions
diff --git a/Master/texmf/doc/texlive/texlive-en/texlive-en.tex b/Master/texmf/doc/texlive/texlive-en/texlive-en.tex
index 8abcd77974d..fc3cf460844 100644
--- a/Master/texmf/doc/texlive/texlive-en/texlive-en.tex
+++ b/Master/texmf/doc/texlive/texlive-en/texlive-en.tex
@@ -902,6 +902,11 @@ 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 the \acro{USB} stick
+ or \DVD. This option minimazes 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[-profile {\sl file}] The installer always writes a file
\filename{texlive.profile} to the \dirname{tlpkg} subdirectory of your
installation. This option tells the installer to re-use such a
@@ -1312,35 +1317,27 @@ in the same zip file. See the web page for more information.
\section{Maximally portable \protect\TL{} on DVD and USB}
\label{sec:portable-tl}
-In the root of the \TL{} installation, or the \dirname{texlive}
-subdirectory of the \TK{} \DVD, are a \filename{tl-portable} script
+In the root of the \TL{} installation are a \filename{tl-portable} script
(Unix) and a \filename{tl-portable.bat} batch file (Windows) which start
up a secondary shell\slash command prompt with environment settings for
-directly accessing the \TL{} on the \DVD.
-
-When it runs for the first time, some files will be generated in a
-directory \dirname{~/.tlportable2010}, which will take a little time.
+directly accessing the \TL{} on the \acro{USB} stick or \DVD.
+
+You should first install \TL{} on the stick using the \optname{-portable}
+option of the installer (see section~\ref{sec:cmdline}). Then run
+the \filename{tl-portable} script from the installation root to start up
+a shell.
+
+You could also burn the resulting contents of the stick back to \DVD{}
+if that is more convenient to (for example) give to others.
+When the \filename{tl-portable} script is run from \DVD{} for the first
+time, some files will be generated on the host system in a directory
+\dirname{~/.tlportable2010}, which will take a little time.
On subsequent runs, though, it will start almost instantaneously.
The rest of the system will be unaware of \TL. If you want your editor
to be aware of this \TL, then you can start it from a second, parallel,
such \filename{tl-portable} session.
-You can also use \filename{tl-portable} to run \TL{} on a
-\acro{USB} stick. In this case, copy all the top-level files and
-the contents of the \dirname{bin}, \dirname{texmf},
-\dirname{texmf-dist}, and \dirname{tlpkg} directories (at least) to
-the stick. This may take quite a while! If you are copying to a
-\acro{FAT}32-formatted \acro{USB} stick, make sure to dereference
-symbolic links (\code{cp -L}). A \dirname{texmf-local} directory on
-the stick will also be found and used.
-
-Then run \filename{tl-portable} from the root of the stick, as above.
-In this case, the script will notice that the stick is writable and use
-it for generated files. You could burn the resulting contents of the
-stick back to \DVD{} if that is more convenient to (for example) give to
-others.
-
\section{\cmdname{tlmgr}: Managing your installation}
\label{sec:tlmgr}