[tldoc] TeX Live 2014 manual update

[Siep Kroonenberg]

On Fri, May 02, 2014 at 11:07:52PM +0000, Karl Berry wrote:
> Hi everyone - I've done the usual updates to the TeX Live manual.
> 
> It is in texmf-dist/doc/texlive/texlive-en.tex if you have the sources
> checked out, or you can get the stuff through (for example) the web
> interface at
> http://tug.org/svn/texlive/trunk/Master/texmf-dist/doc/texlive/texlive-en/

Unfortunately some belated updates from me, mostly about the Windows
exe installer.

Screenshots have been updated.

A diff of my changes:

Index: texlive-en/texlive-en.tex
===================================================================
--- texlive-en/texlive-en.tex	(revision 33844)
+++ texlive-en/texlive-en.tex	(working copy)
@@ -447,14 +447,15 @@
 \subsection{Starting the installer}
 \label{sec:inst-start}
 
-To begin, get the \TK{} \DVD{} or download the \TL{} net installer, and
-locate the installer script: \filename{install-tl} for Unix,
-\filename{install-tl-windows.bat} for Windows.  See
+To begin, get the \TK{} \DVD{} or download the \TL{} net installer.%, and
+%locate the installer script: \filename{install-tl} for Unix,
+%\filename{install-tl-windows.bat} for Windows.  
+See
 \url{http://tug.org/texlive/acquire.html} for more information and other
 methods of getting the software.
 
 \begin{description}
-\item [Net installer:] Download from \CTAN, under
+\item [Net installer, zip or tar.gz:] Download from \CTAN, under
 \dirname{systems/texlive/tlnet}; the url
 \url{http://mirror.ctan.org/systems/texlive/tlnet} will automatically
 redirect to a nearby, up-to-date, mirror.  You can retrieve either
@@ -464,6 +465,13 @@
 \filename{install-tl-windows.bat} will be in the \dirname{install-tl}
 subdirectory.
 
+\item[Net installer, Windows exe:] Download from \CTAN{} as above,
+and double-click. This starts up a first-stage installer and
+unpacker; see Figure~\ref{fig:nsis}. It gives three choices:
+``Simple install'' starts up the wizard installer, ``Custom
+install'' the expert GUI installer, as described in
+section~\ref{sec:wininst}. A third option is just unpacking.
+
 \item [\TeX{} Collection \DVD:] go to the \DVD's \dirname{texlive}
 subdirectory. Under Windows, the installer normally starts automatically
 when you insert the \DVD.  You can get the \DVD\ by becoming a member of
@@ -476,6 +484,11 @@
 
 \end{description}
 
+\begin{figure}[tb]
+\tlpng{nsis_installer}{.6\linewidth}
+\caption{First stage of Windows .exe installer}\label{fig:nsis}
+\end{figure}
+
 The same installer program is run, whatever the source.  The most
 visible difference between the two is that with the net installer, what
 you end up with is the packages that are currently available.  This is
@@ -542,9 +555,9 @@
 documentation and applications.
 
 
-\subsubsection{Windows}
+\subsubsection{Windows}\label{sec:wininst}
 
-If you are using the net installer, or the \DVD\ installer failed to
+If you are using the unpacked downloaded zip file, or the \DVD\ installer failed to
 start automatically, double-click \filename{install-tl-windows.bat}.
 For more customization options, e.g., selection of specific package
 collections, run \filename{install-tl-advanced.bat} instead.
@@ -553,12 +566,12 @@
 \texttt{>} denotes the prompt; user input is \Ucom{\texttt{bold}}.  If
 you are in the installer directory, run just:
 \begin{alltt}
-> \Ucom{install-tl}
+> \Ucom{install-tl-windows}
 \end{alltt}
 
 Or you can invoke it with an absolute location, such as:
 \begin{alltt}
-> \Ucom{D:\bs{}texlive\bs{}install-tl}
+> \Ucom{D:\bs{}texlive\bs{}install-tl-windows}
 \end{alltt}
 for the \TK\ \DVD, supposing that \dirname{D:} is the optical
 drive. Figure~\ref{fig:wizard-w32} displays the wizard installer, which
@@ -566,12 +579,12 @@
 
 To install in text mode, use:
 \begin{alltt}
-> \Ucom{install-tl -no-gui}
+> \Ucom{install-tl-windows -no-gui}
 \end{alltt}
 
 For a complete listing of the various options:
 \begin{alltt}
-> \Ucom{install-tl -help}
+> \Ucom{install-tl-windows -help}
 \end{alltt}
 
 \begin{figure}[tb]
@@ -670,7 +683,7 @@
 no questions.  If you want to customize your setup, you should run one
 of the other installers.
 
-This mode can be invoked explicitly with
+On other platforms, this mode can be invoked explicitly with
 \begin{alltt}
 > \Ucom{install-tl -gui=wizard}
 \end{alltt}
@@ -1696,12 +1709,11 @@
 
 In later versions of Windows, a distinction is made between regular
 users and administrators, where only the latter have free access to the
-entire operating system. In practice, though, you could better describe
-these classes of users as unprivileged users and normal users: being an
-administrator is the rule, not the exception. Nevertheless, we have made
+entire operating system. We have made
 an effort to make \TL{} installable without administrative privileges.
 
-If the user is an administrator, there is an option to install for all
+If the installer is started with administrative permissions, 
+there is an option to install for all
 users.  If this option is chosen, shortcuts are created for all users,
 and the system environment is modified. Otherwise, shortcuts and menu
 entries are created for the current user, and the user environment is
@@ -1721,7 +1733,7 @@
 \TeX{}works, if installed, also prepends \TL{} to the search path, so it
 should also be immune to this path problem.
 
-For Windows Vista and later there is another twist: even if you are
+For Windows Vista and later you should be aware that even if you are
 logged in as administrator, you need to explicitly ask for administrator
 privileges. In fact, there is not much point in logging in as
 administrator. Instead, right-clicking on the program or shortcut that
I 
> 
> So please take a look at updating your translations.  For comparison
> purposes, last year's manual is saved as archive/live-2013.tex as usual.
> There is hardly anything this year beyond the usual new news section and
> year increments.
> 
> I updated the transcripts, but the screenshots are not updated yet.
> (The text talks about removing mips-irix this year [the builder is
> MIA], but I haven't actually done so yet.)
> 
> Please let me know if you won't have time to do the update over the next
> couple of weeks.
> 
> Thanks,
> Karl
> 

-- 
Siep Kroonenberg