texlive-en: windows still incomplete.

as yet untouched: Testing the installation; User's Guide to web2c;
Acknowledgements; release history


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

6 files changed, 142 insertions, 13 deletions

diff --git a/Master/texmf-doc/source/texlive/texlive-en/installation.tex b/Master/texmf-doc/source/texlive/texlive-en/installation.tex
index 6d5f367391c..f27739a5857 100644
--- a/Master/texmf-doc/source/texlive/texlive-en/installation.tex
+++ b/Master/texmf-doc/source/texlive/texlive-en/installation.tex
@@ -253,9 +253,10 @@ submenus, selection letters are case-sensitive\Dash unless you run
 the gui installer, where you can simply click checkboxes; see
 figure~\ref{fig:gui_collections}.
 
-If you want more detail, you need run the \prog{tlmgr} program afterwards,
-see....  The installer will take care of appropriate configuration
-of format generation, hyphenation patterns and font-related matters.
+If you want more detail, you need run the \prog{tlmgr} program
+afterwards, see section~\ref{sec:tlmgr}.  The installer will take
+care of appropriate configuration of format generation, hyphenation
+patterns and font-related matters.
 
 \subsubsection{Directories}
 \label{sec:directories}
@@ -579,6 +580,29 @@ The `old' \ConTeXt{} should run out of the box. The new `Mark IV'
 \ConTeXt{} will require manual setup; see
 \url{http://wiki.contextgarden.net/Running_Mark_IV}
 
+\subsubsection{Integrating local and personal macros}
+
+This is already mentioned implicitly in
+section~\ref{sec:texmftrees}: \dirname{TEXMFLOCAL}, \emph{e.g.}
+\dirname{/usr/local/texlive/texmf-local} or
+\verb|C:\Program Files\texlive\texmf-local| is intended for local
+fonts and macros; \dirname{TEXMFHOME}, usually \dirname{$HOME/texmf}
+or \verb|%USERPROFILE%\texmf|, are for
+personal fonts and macros. These directories should stick around
+from release to release. Their content will be automatically seen by
+a new \TL{} release.
+
+\subsubsection{Integrating third-party fonts}
+
+This is unfortunately a very complicated and messy topic. Forget
+about it unless you really know your way around blindfolded in a
+\TeX{} installation. Don't forget to check first what you get for
+free: see section~\ref{sec:tl-fonts}.
+
+An alternative is using Xe\TeX,
+see section~\ref{sec:tex-extensions}, which lets you use operating
+system fonts without installation in \TeX.
+
 
 \subsection{Testing the installation}
 \label{sec:test-install}
@@ -725,7 +749,7 @@ will start almost instantaneously.
 
 The rest of the system will be unaware of \TL. If you want your
 editor to be aware of this \TL, then you can start it from
-a second, parallel \TL{} session.
+a second, parallel such \TL{} session.
 
 You can also use \filename{tl-portable} to run \TL{} on a
 \acro{USB} stick.  In this case, copy all the top-level files and
diff --git a/Master/texmf-doc/source/texlive/texlive-en/live.tex b/Master/texmf-doc/source/texlive/texlive-en/live.tex
index e0c64d730dd..36b00d0f2bf 100644
--- a/Master/texmf-doc/source/texlive/texlive-en/live.tex
+++ b/Master/texmf-doc/source/texlive/texlive-en/live.tex
@@ -30,8 +30,8 @@
 \input{overview}
 \input{installation}
 \input{maintenance}
-\input{macosx}
-%\input{windows}
+%\input{macosx}
+\input{windows}
 \input{web2c}
 \input{acknowledgements}
 \input{releasehist}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/maintenance.tex b/Master/texmf-doc/source/texlive/texlive-en/maintenance.tex
index bdb4af0e1aa..f9218a47d26 100644
--- a/Master/texmf-doc/source/texlive/texlive-en/maintenance.tex
+++ b/Master/texmf-doc/source/texlive/texlive-en/maintenance.tex
@@ -97,6 +97,19 @@ Installing a language also triggers format generation:
 \begin{alltt}
 > \Ucom{tlmgr install collection-langdutch}
 \end{alltt}
+Printing some information about a package:
+\begin{alltt}
+C:\bs Documents and Settings\bs siepo> \Ucom{tlmgr show collection-wintools}
+\end{alltt}
+produces
+\begin{fverbatim}
+Package:   collection-wintools
+Category:  Collection
+ShortDesc: Windows support programs
+LongDesc:  Utilities for Windows, since they are not readily available there:
+ gzip, chktex, jpeg2ps, unzip, wget, xpdf.
+Installed: Yes
+\end{fverbatim}
 Updating your entire installation:
 \begin{alltt}
 > \Ucom{tlmgr update -all}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/overview.tex b/Master/texmf-doc/source/texlive/texlive-en/overview.tex
index 13d97f925b8..9c99f717c87 100644
--- a/Master/texmf-doc/source/texlive/texlive-en/overview.tex
+++ b/Master/texmf-doc/source/texlive/texlive-en/overview.tex
@@ -273,3 +273,9 @@ utilities.
 \end{cmddescription}
 
 
+\subsection{Fonts in \protect\TL}
+\label{sec:tl-fonts}
+\TL{} also comes with more and more high-quality scalable fonts
+built-in: check \emph{e.g.} the \CTAN{} catalogue. Most fonts listed
+there are available as a \TL{} package. Check also
+\dirname{texmf-doc/english/free-math-fonts-survey}.
diff --git a/Master/texmf-doc/source/texlive/texlive-en/psview.png b/Master/texmf-doc/source/texlive/texlive-en/psview.png
new file mode 100644
index 00000000000..8322bdda693
--- /dev/null
+++ b/Master/texmf-doc/source/texlive/texlive-en/psview.png
diff --git a/Master/texmf-doc/source/texlive/texlive-en/windows.tex b/Master/texmf-doc/source/texlive/texlive-en/windows.tex
index 2564c8e0dcc..15d1c6762a3 100644
--- a/Master/texmf-doc/source/texlive/texlive-en/windows.tex
+++ b/Master/texmf-doc/source/texlive/texlive-en/windows.tex
@@ -1,10 +1,96 @@
-registry
-more automatic postinstall
-user vs system
-gs, perl, psv
-file associations
-shortcuts
-fc-cache
+\section{Notes on Windows}
+\label{sec:windows}
+
+This edition of \TL, we built a unified installer for Windows and
+Unix. We limited support to Windows 2000, XP and Vista. These
+versions are less quirky than their predecessors, and have user home
+directories (\verb|%USERPROFILE%|).
+
+%\subsection{Different user expectations}
+%
+%We made some effort to conform to expectations of Windows users: the
+%installer defaults to \GUI{} mode; the default install location is
+%\dirname{Program Files}, it creates shortcuts to some
+%documentation and some \GUI{} utilities; it creates an entry in
+%Add/Remove Programs, and there is no need for any manual
+%configuration afterwards.
+%
+%A second issue is that Windows users are often unaware of different
+%levels of user permissions. Later Windows versions make some
+%rudimentary differentiation between administrators and regular
+%users, but non-administrators can \emph{e.g.} still write to many
+%locations outside their `home' directory., We tried to deal with this as
+%unobtrusively as possible.
+
+\subsection{Additional included software}
+
+\begin{figure}[tb]
+\tlpng{psview}{.6\linewidth}
+\caption{PS\_View: very high magnifications available!}\label{fig:psview}
+\end{figure}
+
+To be complete, a \TL installation needs support packages that are not
+commonly found on a Windows machine. \TL{} provides the missing
+pieces:
+\begin{description}
+\item[Perl and Ghostscript] Because of the importance of Perl and
+  Ghostscript, \TL{} includes `hidden' copies of these
+  programs. \TL{} programs that need them know where to find them,
+  but they don't betray their presence through environment variables
+  or registry settings. They aren't full-scale distributions, and
+  shouldn't interfere with a normal installation of Perl or
+  Ghostscript.
+\item[Command-line tools] A number of Windows ports of common Unix
+  command-line programs are installed along with the usual \TL{}
+  binaries. These include gzip, chktex, jpeg2ps, unzip, wget and the
+  command-line utilities from the xpdf suite.
+\item[PS\_View] Also installed is PS\_View, a new PostScript viewer
+  with a free license; see figure~\ref{fig:psview}.
+\end{description}
+\begin{description}
+\item[The \texttt{support} directory], already mentioned in
+  section~\ref{sec:tld}. This directory contains various programs
+  which can be useful in connection with \TeX, in particular a
+  number of \TeX-aware editors and \TeX{} frontends. The software in
+  this directory isn't covered by the installer.
+\end{description}
+
+\subsection{Urls for additional downloadable software}
+
+Urls for some other tools you may consider installing:
+\begin{description}
+\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/}
+\item[Perl] \url{http://www.activestate.com/} (but you might need some
+      supplementary packages from CPAN: \url{http://www.cpan.org/})
+\item[ImageMagick] \url{http://www.imagemagick.com}
+\item[NetPBM] alternatively, you could use NetPBM instead of ImageMagick to
+      process or convert your graphic files. NetPBM home page is
+      \url{http://netpbm.sourceforge.net/}
+\item[\TeX-oriented editors] There is a wide choice, and it is a matter of the
+      user's taste. Here is a selection:
+      \begin{itemize*}
+  \item \cmdname{GNU Emacs} is available natively under Windows, see
+        \url{http://www.gnu.org/software/emacs/windows/ntemacs.html}
+  \item \cmdname{Emacs} with AucTeX is available natively under Windows, see
+        \url{ftp://alpha.gnu.org/gnu/auctex}
+  \item \cmdname{WinShell} is available on \TL in the \path|support|
+        directory, see \url{http://www.winshell.de}
+  \item \cmdname{WinEdt} is shareware available from \url{http://www.winedt.com}
+  \item \cmdname{Vim} is available from \url{http://www.vim.org}
+  \item TeXnicCenter is free software, available from
+          \url{http://www.toolscenter.org} and in the proTeXt distribution.
+  \item \cmdname{LEd} is available from \url{http://www.ctan.org/support/LEd}
+  \item \cmdname{SciTE} is available from \url{http://www.scintilla.org/SciTE.html}
+      \end{itemize*}
+\end{description}
+
+%registry
+%user vs system
+%file associations
+%path problem
+%non-admin
+%network install
+%fc-cache
 
 %%% Local Variables:
 %%% mode: latex