summaryrefslogtreecommitdiff
path: root/Master/texmf-doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-03-24 23:51:45 +0000
committerKarl Berry <karl@freefriends.org>2008-03-24 23:51:45 +0000
commit22da51987dc6b39f278b604ebffe7debfb8abdd8 (patch)
treec1a9b7c0a4100fc10ab2c27a60499ad3c720bae2 /Master/texmf-doc
parent0767e493de6a05cad8eecbe47e0eb59af537ce91 (diff)
new tl-portable stuff.
git-svn-id: svn://tug.org/texlive/trunk@7135 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-doc')
-rw-r--r--Master/texmf-doc/source/english/texlive-en/live.tex247
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