new tl-portable stuff.

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

1 files changed, 106 insertions, 141 deletions

diff --git a/Master/texmf-doc/source/english/texlive-en/live.tex b/Master/texmf-doc/source/english/texlive-en/live.tex
index f6b416b051f..07b9e029ddf 100644
--- a/Master/texmf-doc/source/english/texlive-en/live.tex
+++ b/Master/texmf-doc/source/english/texlive-en/live.tex
@@ -87,7 +87,7 @@ can be found in section \ref{sec:win-install} on
 p.~\pageref{sec:win-install}.
 
 \item The single package installation script is \texttt{install-pkg.sh}.
-(After installation on Linux with \texttt{tlpmgui}, you can also try
+(After installation on GNU/Linux with \texttt{tlpmgui}, you can also try
 running \texttt{tlpmgui} again to add or remove individual packages or
 collections.)
 
@@ -231,7 +231,7 @@ bin        & The \TeX{} system programs, arranged by platform. \\
 source     & The source of all programs, including the main \Webc{}
 	  \TeX{} and \MF{} distributions. These are stored in a
   \cmdname{bzip2}-compressed tar archive. \\
-setuptl    & Installation programs for Linux and Windows. \\
+setuptl    & Installation programs for GNU/Linux and Windows. \\
 support    & Assorted auxiliary packages and programs.  These are
   \emph{not} installed automatically.  This includes
   assorted editors and \TeX\ shells. \\
@@ -409,12 +409,13 @@ have been able to mount the \CD{}s with full Rock Ridge compatibility.
 
 
 % 
-\subsection{Running \protect\TL{} directly from media (Unix)}
+\subsection{Portable \protect\TL{} on DVD and USB (Unix)}
+\label{sec:portable-unix}
 
 \def\runlive{% text repeated in windows section
 It is possible to use the \TeX{} system directly from the \pkgname{live}
-\DVD{}, without installing the distribution to disk.  (Thus the name
-\TeX\ `Live', in fact.)  It is \emph{not} possible to run \TeX{}
+\DVD{}, without installing the distribution to hard disk.  (Thus the
+name \TeX\ `Live', in fact.)  It is \emph{not} possible to run \TeX{}
 directly from the other \CD{}s (see section~\ref{sec:multiple-dist},
 \p.\pageref{sec:multiple-dist}).
 }
@@ -422,7 +423,7 @@ directly from the other \CD{}s (see section~\ref{sec:multiple-dist},
 \def\startinst{% repeated in other subsections
 To start, you mount the \CD{} or \DVD{}, with Rock Ridge extensions
 enabled.  The exact command to do this varies from system to system; the
-following works under Linux, except the name of the device
+following works under \acro{GNU}/Linux, except the name of the device
 (\filename{/dev/cdrom}, here) may vary. (All our examples will use
 \texttt{>} as the shell prompt; user input is
 \Ucom{\texttt{underlined}}.)
@@ -435,8 +436,8 @@ following works under Linux, except the name of the device
 > \Ucom{cd /mnt/cdrom}
 \end{alltt}
 
-\noindent Under \MacOSX, the directory is typically under
-\dirname{/Volumes}, and the media will be mounted automatically.
+\noindent (Under \MacOSX, the directory is typically under
+\dirname{/Volumes}, and the media will be mounted automatically.)
 
 Your \code{umask} at the time of installation will be respected by the
 \TL{} installer.  Therefore, if you want your installation to be usable
@@ -446,119 +447,34 @@ permissive, for instance, \code{umask 002}.  For more information about
 
 }
 
-\def\installtlsh{
-Run the installation script \filename{install-tl.sh}:
-\begin{alltt}
-> \Ucom{sh install-tl.sh}\\
-Welcome to TeX Live...
-\end{alltt}
-
-\noindent After various greeting messages and a list of the main menu
-options, the installation will ask you to enter a command.  Do this by
-typing the desired character and hitting return; don't type the angle
-brackets shown.  Either uppercase or lowercase is ok; we'll use
-lowercase in our examples.
-}
-
 \runlive
 \startinst
-\installtlsh
-
-For running live, our first command will be \Ucom{d} and then the
-subcommand \Ucom{1} to set directories.  Even in this case, we must
-choose a directory on the local disk to place files that the \TeX{}
-system itself generates, such as fonts and formats, and also to provide
-a place for updated configuration files, if need be.
-
-We'll use \dirname{/opt/texlive2007} in this example.  It's good to
-include the year in the name, as these generated files are not
-in general compatible from release to release.  (If the default value of
-\dirname{/usr/local/texlive/2007} works for you, then you can skip this
-step.)
 
-\begin{alltt}
-Enter command: \Ucom{d}
-Current directories setup:
-<1>  TEXDIR:     /usr/local/texlive/2007
-...
-Enter command: \Ucom{1}
-New value for TEXDIR [/usr/local/texlive/TeX]: \Ucom{/opt/texlive2007}
-...
-Enter command: \Ucom{r}
-\end{alltt}
+Then, in a terminal, run this command:
 
-\noindent Back at the main menu, our second and last command is
-\Ucom{r}, to set up for running live off the media without installing
-to disk:
 \begin{alltt}
-Enter command: \Ucom{r}
-Preparing destination directories...
-...
-Welcome to TeX Live!
->
+> \Ucom{sh tl-portable.sh}
 \end{alltt}
 
-\noindent And we are back at the system prompt, as shown.
-
-Next, it is necessary to alter two environment variables:
-\envname{PATH}, to an architecture-dependent value (so that we can run
-the programs), and \envname{TEXMFSYSVAR}, to the value specified above.
-See table~\ref{tab:archlist} for a list of the architecture names for
-the different systems.
-
-
-\def\textruntexconfig{%
-After the main installation has completed, and environment variables
-have been set, the last step is to run \cmdname{texconfig} or
-\cmdname{texconfig-sys} to customize your installation to your needs.
-This is explained in section~\ref{sec:texconfig},
-\p.\pageref{sec:texconfig}.
-}
-\textruntexconfig
-
-\begin{table*}[ht]
-\caption[Supported system architectures.]{Supported system
-architectures.}
-\label{tab:archlist}
-\begin{tabular}{>{\ttfamily}ll}
-alpha-linux	   & HP Alpha GNU/Linux   \\
-hppa-hpux          & HPPA HP-UX	  \\
-i386-darwin        & x86 \MacOSX    \\
-i386-freebsd       & x86 FreeBSD    \\
-i386-linux         & x86 GNU/Linux  \\
-i386-openbsd       & x86 OpenBSD   \\
-i386-solaris       & x86 Solaris    \\
-mips-irix          & SGI IRIX             \\
-powerpc-aix        & IBM RS/6000 AIX      \\
-powerpc-darwin     & PowerPC \MacOSX      \\
-powerpc-linux      & PowerPC GNU/Linux      \\
-sparc-linux        & Sun Sparc GNU/Linux  \\
-sparc-solaris      & Sun Sparc Solaris    \\
-win32		   & Windows (32-bit)     \\
-x86\_64-linux      & x86 64-bit GNU/Linux \\
-\hline
-\end{tabular}
-\end{table*}
-
-\label{text:path}
-The syntax for setting the environment variables, and the initialization
-file to put them in, depends on the shell you use.  If you use a
-Bourne-compatible shell (\cmdname{sh}, \cmdname{bash}, \cmdname{ksh}, et
-al.), put the following into your \filename{$HOME/.profile} file:
-\begin{alltt}
-PATH=/mnt/cdrom/bin/\var{archname}:$PATH; export PATH
-TEXMFSYSVAR=/opt/texlive2007/texmf-var; export TEXMFSYSVAR
-\end{alltt}
-
-\noindent For C shell-compatible shells (\cmdname{csh}, \cmdname{tcsh}),
-put the following into your \filename{$HOME/.cshrc} file:
-\begin{alltt}
-setenv PATH /mnt/cdrom/bin/\var{archname}:$PATH
-setenv TEXMFSYSVAR /opt/texlive2007/texmf-var
-\end{alltt}
-
-\noindent Then log out, log back in, and test your installation
-(see section~\ref{sec:test-install}, \p.\pageref{sec:test-install}).
+This \filename{tl-portable.sh} script is at the top level of the
+distribution.  It starts up a secondary shell with the necessary
+environment settings.  When it runs for the first time, some files will
+be generated in a directory \dirname{~/.texlive2008}.  On subsequent
+runs, though, it will start almost instantaneously.
+
+You can run several parallel \TL{} sessions this way, each in a
+different terminal.
+
+You can also use \filename{tl-portable.sh} 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.  A
+\dirname{texmf-local} directory on the stick will also be found and
+used.  Then run \filename{tl-portable.sh} 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's more convenient to (for example) give
+to others.
 
 \def\textifindoubt{%
 If in doubt, please ask any local system gurus to help you with
@@ -566,7 +482,7 @@ problems; for example, the way to mount the \TL{} media, which
 directory or directories to use, and precise details of the changes to
 your personal initialization files can and do vary from site to site.
 }
-\textifindoubt
+
 
 
 % 
@@ -580,7 +496,18 @@ hard disk.  This can be done from either the \pkgname{live} or
 distributions.)
 
 \startinst
-\installtlsh
+
+Run the installation script \filename{install-tl.sh}:
+\begin{alltt}
+> \Ucom{sh install-tl.sh}\\
+Welcome to TeX Live...
+\end{alltt}
+
+\noindent After various greeting messages and a list of the main menu
+options, the installation will ask you to enter a command.  Do this by
+typing the desired character and hitting return; don't type the angle
+brackets shown.  Either uppercase or lowercase is ok; we'll use
+lowercase in our examples.
 
 Table~\ref{tab:main-menu-options} briefly lists the options in the main
 menu.  The order in which you select the options makes little
@@ -782,7 +709,11 @@ put the following into your \filename{$HOME/.cshrc} file:
 setenv PATH /usr/local/texlive/2007/bin/\var{archname}:$PATH
 \end{alltt}
 
-\textruntexconfig
+After the main installation has completed, and environment variables
+have been set, the last step is to run \cmdname{texconfig} or
+\cmdname{texconfig-sys} to customize your installation to your needs.
+This is explained in section~\ref{sec:texconfig},
+\p.\pageref{sec:texconfig}.
 
 Here is a minimal annotated example which accepts the default
 directories and installs binaries for the current system only.  Thus,
@@ -793,7 +724,7 @@ shell prompt as usual.
 > \Ucom{sh install-tl.sh}
 \Ucom{i}                         # perform installation
 > \Ucom{texconfig} ...           # see section \ref{sec:texconfig}
-# New PATH element, with Linux as the example:
+# New PATH element, with GNU/Linux as the example:
 > \Ucom{PATH=/usr/local/texlive/2007/bin/i386-linux:$PATH; export PATH}
 \end{alltt}
 
@@ -812,6 +743,30 @@ MANPATH_MAP /usr/local/texlive/2007/bin/i386-linux \
 
 \textifindoubt
 
+\begin{table*}[ht]
+\caption[Supported system architectures.]{Supported system
+architectures.}
+\label{tab:archlist}
+\begin{tabular}{>{\ttfamily}ll}
+alpha-linux	   & HP Alpha GNU/Linux   \\
+hppa-hpux          & HPPA HP-UX	  \\
+i386-darwin        & x86 \MacOSX    \\
+i386-freebsd       & x86 FreeBSD    \\
+i386-linux         & x86 GNU/Linux  \\
+i386-openbsd       & x86 OpenBSD   \\
+i386-solaris       & x86 Solaris    \\
+mips-irix          & SGI IRIX             \\
+powerpc-aix        & IBM RS/6000 AIX      \\
+powerpc-darwin     & PowerPC \MacOSX      \\
+powerpc-linux      & PowerPC GNU/Linux      \\
+sparc-linux        & Sun Sparc GNU/Linux  \\
+sparc-solaris      & Sun Sparc Solaris    \\
+win32		   & Windows (32-bit)     \\
+x86\_64-linux      & x86 64-bit GNU/Linux \\
+\hline
+\end{tabular}
+\end{table*}
+
 
 \subsubsection{Non-interactive installation}
 \label{sec:noninteractive-install}
@@ -1187,34 +1142,24 @@ where needed.
 \section{Windows installation}
 \label{sec:win-install}
 
-In this release of \TL{}, happily, the distribution once
-again has a native Windows installer, named \cmdname{tlpmgui.exe}.  (See
-section~\ref{sec:multiple-dist}, \p.\pageref{sec:multiple-dist}, for an
-explanation of the different distributions.)
-
-\cmdname{tlpmgui} has essentially the same options as the Unix
-installer, only done through a GUI interface: selecting schemes,
-individual collections, installation directories, and so on.
-Section~\ref{sec:unix-install-disk} on
-\p.\pageref{sec:unix-install-disk} describes the basic elements.  It
-also allows some post-installation activities such as adding/removing
-packages, updating the filename database and building formats.
-Moreover, \cmdname{tlpmgui} can setup the system for running
-programs directly from the \DVD.
-
-For those who like to look underneath the hood, \cmdname{tlpmgui} uses
-as its ``engine'' a command-line Windows program named \cmdname{tlpm}.
-
-The Windows \TeX{} system included in \TL{} is based on new binaries 
-borrowed from the \acro{W32TEX} distribution, kindly provided by Akira Kakuto.
-It also includes some older (but still working) tools made by Fabrice
-Popineau, and also a new \texttt{dvi} previewer, \textsf{dviout} by
-Toshio Oshima. 
+In this release of \TL{}, the same installer should work under Windows
+as Unix.
+
+The Windows \TeX{} system included in \TL{} is based on binaries from
+the \acro{W32TEX} distribution, kindly provided by Akira Kakuto.  It
+also includes some older (but still working) tools made by Fabrice
+Popineau, and also the textsf{dviout} previewer for \texttt{dvi} files,
+by Toshio Oshima.
 
 \TL{} can be installed on systems running Windows 98, \acro{ME},
 \acro{NT}, \acro{2K} or \acro{XP}.  Older versions of Windows (3.1x)
 and \acro{MS-DOS} are not supported.
 
+Under Windows, registry entries are created to associate
+\filename{.texlua} files with \filename{texlua.exe}.  These are per-user
+entries, but there is no way to restrict the effect to a particular
+session.
+
 \textbf{Warning:} Win9.x users must ensure they have enough environment
   space before undertaking installation. The \cmdname{tlpmgui.exe}
   program won't change the environment size for them. A few environment
@@ -1222,6 +1167,26 @@ and \acro{MS-DOS} are not supported.
   environment space. Add \texttt{SHELL=<path>COMMAND.COM /E:4096 /P} in the
   config.sys file in order to increase your environment size.
 
+
+% 
+\subsection{Portable \protect\TL{} on DVD and USB (Windows)}
+
+\runlive
+
+Then, view the \DVD{} contents and double-click
+\filename{tl-portable.bat}.  (Alternatively, start a `Command Prompt'
+and run it that way.)  The first time this batch script runs, some files
+will be generated in a folder \dirname{C:/Documents and
+Settings/<username>/.texlive2008}.  On subsequent runs, though, the the
+script will start almost instantaneously.
+
+You will be left in `Command Prompt' window in which you can run \TeX.
+
+For information about running \TL{} from a \acro{USB} stick, see
+section~\ref{sec:portable-unix}.
+
+
+% 
 \subsection{Installing \protect\TeX\protect\ Live to disk}
 
 After inserting the \TL{} \acro{CD} into the \acro{CD} drive, autostart should