# [tldoc] corrections to texlive-en.tex

Staszek Wawrykiewicz staw at gust.org.pl
Wed Jun 16 03:22:19 CEST 2010

I found some corrections to the original texlive-en.tex

<The \DVD{} installer lets you install to a local disk, but you can also
<run \TL{} directly from the \DVD{} (or from a \DVD{} image, if your
<system supports that).  Installation is described in later sections
<(\p.\pageref{sec:install}), but here is a quick start:

The \DVD{} installer lets you install to a local disk. You cannot
run \TL{} directly from the \DVD{} (or from a \DVD{} image, if your
system supports that), but you can prepare the runable installation
on, e.g., USB stick (see: \ref{sec:portable-tl}). Installation is
described in later sections (\p.\pageref{sec:install}), but here is
a quick start:

---
<\htmlanchor{runfromdvd}
<\subsubsection{Set up for running from DVD{} (text mode only)}
<\label{sec:fromdvd}
<
<Type |V|' to select this option. This changes the main menu into something
<as in figure~\ref{fig:main-fromdvd}.
<
<\begin{figure}[tbh]
<\begin{boxedverbatim}
<======================> TeX Live installation procedure <=====================
<...
< <D> directories:
<   TEXDIRW (Writable root):
<     !! default location: /usr/local/texlive/20010
<     !! is not writable, please select a different one!
<   ...
<
< <O> options:
<   [ ] use letter size instead of A4 by default
<   [X] create all format files
<
< <V> set up for installing to hard disk
<
<Actions:
< <I> start installation for running from DVD
< <H> help
< <Q> quit
<\end{boxedverbatim}
<\caption{The main menu with \optname{from DVD}' set}\label{fig:main-fromdvd}
<\end{figure}
<
<Note the changes: all options about what to install have
<disappeared, and the directories section now talks about
<\dirname{TEXDIRW} and a writable root''. The symlinks option has also
<disappeared.
<
<The installer will still create various directories and configuration
<files, but won't copy \dirname{texmf} or \dirname{texmf-dist} to hard
<disk.
<
<Post-install configuration for Unix will be slightly more complicated,
<because now the directory layout deviates from the default; see
<section~\ref{sec:postinstall}.
<
<This option is not in the \GUI{} installer, but it is available both
<for Unix and for Windows. Windows users have to start the installer
<from a command prompt, see section~\ref{sec:cmdline}.
<
<Section \ref{sec:portable-tl} describes a more strictly portable
<way to run \TL, which doesn't make or require any changes in the
<system's configuration, but doesn't allow any configuration either.

All that section to zap.

---

<\htmlanchor{runningfromdvd}
<\subsubsection{When running from DVD}
<
<Normally, a \TL{} program consults a file \filename{texmf.cnf} for the
<location of the various trees. It looks for this file in a series of
<locations relative to its own location. However, this scheme breaks down
<when a program is run from \DVD{}: the \DVD{} is read-only. Some of the
<paths to be recorded in \filename{texmf.cnf} are only known at
<installation time, so this file cannot be on the \DVD{} and must be
<placed somewhere else. This makes it necessary to define an environment
<\envname{TEXMFCNF} variable which tells \TL{} programs in what directory
<to find this \filename{texmf.cnf}.  It is also still necessary to modify
<the \envname{PATH} environment variable, as described before.
<
<At the end of the installation, the installer should have printed a
<message giving the value to which \envname{TEXMFCNF} should be set. In
<case you missed it: this value is \dirname{\$TEXMFSYSVAR/web2c}. For the
<default, \dirname{/usr/local/texlive/2010/texmf-var/web2c}, you need the
<lines
<\begin{sverbatim}
<TEXMFCNF=/usr/local/texlive/2010/texmf-var/web2c; export TEXMFCNF
<\end{sverbatim}
<or, for [t]csh:
<\begin{sverbatim}
<setenv TEXMFCNF /usr/local/texlive/2010/texmf-var/web2c
<\end{sverbatim}
<
<This option is most useful when you want to run \TL{} on your own
<system, but don't have enough disk space to install it.  If you want a
<truly portable' \TL{} that is self-contained, e.g., for a USB stick,
<see section~\ref{sec:portable-tl}.

All that section to zap.

---
<The running from \DVD{}' option described in
<section~\ref{sec:fromdvd} is fine for your own system, but if you
<are a guest on somebody else's system then you would probably like
<something with minimal side effects.

If you are a guest on somebody else's system then you would probably like
something with minimal side effects.

[hmmm, to reconsider how to start this section]

All the best,

----
Staszek Wawrykiewicz
staw at gust.org.pl