summaryrefslogtreecommitdiff
path: root/Master/tlpkg/doc/tl-portable.tex
blob: f05fe9e97505ae027eed5fcd972654b2ff93c04e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
\documentclass{article}
\let\tldocenglish=1  % for live4ht.cfg
%\usepackage{tex-live}
% replacement macros
\usepackage{url}
\let\filename\url
\newcommand\acro[1]{#1}
\newcommand\TL{\TeX~Live}
\let\ttdescription\description
\let\endttdescription\enddescription
\newcommand\htmlanchor[1]{\relax}

\usepackage[latin1]{inputenc} % translators: use your preferred encodings.
\usepackage[T1]{fontenc}

\begin{document}

\section{Bits and pieces to be added to the \TL{} manual}

\subsection{Add to: Command-line install-tl options}

\begin{ttdescription}
\item[-portable] Install for portable use on \emph{e.g.} a
  \acro{USB} stick. Also selectable from within the perltk- and text
  installers; see section~\ref{sec:portable-tl}.

\item[-in-place] If you already have an rsync- or svn checkout of
  \TL{} then this option will use it as-is and just do the necessary
  post-install. Be warned that the file
  \filename{tlpkg/texlive.tlpdb} may be rewritten, and that removal
  has to be done manually. This option cannot be toggled via the
  installer interface.
\end{ttdescription}

% The next section replaces the `Maximally portable \protect\TL{} on
% DVD and USB' section

\section{Special scenarios}

\htmlanchor{tlportable}
\subsection{Creating a portable installation}
\label{sec:portable-tl}

The 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
\acro{USB} stick or copy it to a USB stick afterwards.

If you want to run this portable installation, you need to add the
appropriate binary directory to the searchpath during your terminal
session.  For Windows, you can double-click a batchfile
\filename{tlmenu.bat} in the root of the installation that lets you
choose between a few tasks:
\begin{verbatim}
=== TeX Live Menu ===

1 TeX Live command prompt
2 Managing the installation
3 TeXWorks
Q Quit

Make a choice
\end{verbatim}

\subsection{Running from \acro{ISO} or \acro{DVD}}

If you don't update or modify your installation too often, and have
several systems on which to use \TL{}, it may be convenient to
create an \acro{ISO} of your \TL{} installation:

\begin{itemize}
\item Copying an \acro{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 \acro{ISO}
  installation is not tied to the idiosyncracies and limitations of
  other mutually supported filesystems (\acro{FAT32}, \acro{NTFS},
  \acro{HFS+}).
\item Virtual machines can simply mount such an \acro{ISO}.
\end{itemize}

When preparing for an \acro{ISO}- or \acro{DVD} installation, it
makes sense not to have a subdirectory for the year, but to have
\filename{texmf-local} at the same level as the other trees
(\filename{texmf}, \filename{texmf-dist} etc.).

\subsubsection{How to use}

Desktop Unix/Linux systems, including Mac OS X, are able to mount an
\acro{ISO}. Apart from that, nothing changes compared to a normal
hard disk installation, see section \ref{sec:env}.

For a physical (rather than virtual) Windows system, you can burn
the \acro{ISO} to \acro{DVD}. However, it may be worth your while to
investigate free \acro{ISO}-mounting options. For Windows XP,
Microsoft itself offers \filename{winxpvirtualcdcontrolpanel}.

For Windows system integration, you can include the
\filename{w32client} scripts described in \ref{sec:netinstall} and
\url{http://www.tug.org/texlive/w32client.html}, which work just as
well for an \acro{ISO}- as for a network installation.

For Mac OS X, TeXshop and TeXworks will be able to use the
\acro{DVD} installation if a symlink \filename{/usr/texbin} points
to the appropriate binary directory, \emph{e.g.}
\begin{verbatim}
sudo ln -s /Volumes/MyTeXLive/bin/universal-darwin /usr/texbin
\end{verbatim}

\textbf{Note.}  \TL{} 2010 was the first \TL{} edition which was no
longer `live'. But it always required some acrobatics to run earlier
versions from \acro{DVD} or \acro{ISO}. In particular, there was no
way around setting at least one extra environment variable. If you
create your \acro{ISO} from an existing installation then there is
no need for this.
\end{document}