first edits, bigger \acro

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

2 files changed, 46 insertions, 58 deletions

diff --git a/Master/texmf-doc/source/texlive/texlive-en/tex-live.sty b/Master/texmf-doc/source/texlive/texlive-en/tex-live.sty
index 22a00a09fb7..f95632a3e1e 100644
--- a/Master/texmf-doc/source/texlive/texlive-en/tex-live.sty
+++ b/Master/texmf-doc/source/texlive/texlive-en/tex-live.sty
@@ -33,7 +33,8 @@
 % for a proper \acro command (even in the context of the definition in
 % ltugboat -- \DRC overrides without checking)
 \RequirePackage{relsize}
-\DeclareRobustCommand{\acro}[1]{\textsmaller{#1}\@}
+%\DeclareRobustCommand{\acro}[1]{\textscale{.9}{#1}\@}
+\def\acro#1{\textscale{.9}{#1}\@}
 %
 \RequirePackage{fancyvrb}
 \DefineVerbatimEnvironment{verbatim}{Verbatim}{fontsize=\normalsize}
@@ -157,7 +158,7 @@
 \def\teTeX{\textrm{te}\TeX\xspace}
 \def\TeXLive{\TeX{} Live\xspace}
 \def\TFtoPL{\cmdname{TFtoPL}\null}
-\def\TK{\textsf{\TeX\ Collection}}
+\def\TK{\TeX\ Collection}
 \let\TL=\TeXLive
 \def\TypeI{Type~1}
 \def\VFtoVP{\cmdname{VFtoVP}\null}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/texlive-en.tex b/Master/texmf-doc/source/texlive/texlive-en/texlive-en.tex
index c3b017fd9cf..7c5c8192037 100644
--- a/Master/texmf-doc/source/texlive/texlive-en/texlive-en.tex
+++ b/Master/texmf-doc/source/texlive/texlive-en/texlive-en.tex
@@ -9,7 +9,7 @@
 \begin{document}
 
 \title{%
-  {\huge \textit{The \protect\TL{} Guide}\\\strut}
+  {\huge \textit{The \protect\TL{} Guide}\\[1ex]}
   {\LARGE \textsf{\TL{} 2008}}
 }
 
@@ -56,26 +56,26 @@ see the end of the document, section~\ref{sec:history}
 \subsection{Operating system support}
 \label{sec:os_support}
 
-\TL{} contains binaries for many Linux- and Unix architectures,
+\TL{} contains binaries for many Unix-based architectures,
 including \MacOSX.  The included sources should enable installation
-on additional Linux- and Unix platforms.
+on platforms for which we do not have binaries.
 
 As to Windows: only Windows 2000 and later are supported. Windows
 9\textit{x}, ME and NT have been dropped. Because of this
-restriction, Windows requires less special treatment compared to
-Linux and Unix. There are no 64-bit executables for Windows, but the
+change, Windows requires much less special treatment compared to
+the Unix systems. There are no 64-bit executables for Windows, but the
 32-bit executables should run on 64-bit systems.
 
 See section~\ref{sec:tl-coll-dists} for alternate solutions
 for Windows and \MacOSX.
 
-\subsection{Basic usage of \protect\TL{}}
+\subsection{Basic installation of \protect\TL{}}
 \label{sec:basic}
 
-You can install \TL{} either from \DVD{} or over the internet. The
-net installer itself is very small and downloads everything needed
-from the internet. The net installer is an attractive option if you
-need only a fraction of the complete \TL.
+You can install \TL{} either from \DVD{} or over the Internet. The net
+installer itself is small, and downloads everything requested from the
+Internet. The net installer is an attractive option if you need only a
+fraction of the complete \TL.
 
 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
@@ -86,14 +86,15 @@ installation sections following, but here is a quick start:
 
 \begin{itemize*}
 
-\item The installation script is \filename{install-tl}, which has
-both a text mode (default for Unix) and a \GUI{} mode (default for
-Windows).
+\item The installation script is named \filename{install-tl}.  It has
+  both a text mode (default for Unix, run \code{tlmgr -gui} to
+  override) and a \GUI{} mode (default for Windows, run \code{tlmgr
+  -no-gui} to override).
 
-\item One of the installed items is \prog{tlmgr} or \TL\ Manager,
-  which can also be used in \GUI{} mode and in text mode. You can
-  use it to install and uninstall packages and do various
-  configuration tasks.
+\item One of the installed items is a new program, the `\TL\ Manager',
+  named \prog{tlmgr}.  Like the installer, it can be used in both \GUI{}
+  mode and in text mode. You can use it to install and uninstall
+  packages and do various configuration tasks.
 
 \end{itemize*}
 
@@ -101,13 +102,12 @@ Windows).
 \subsection{Getting help}
 \label{sec:help}
 
-The \TeX{} community is both active and friendly, and virtually all
-serious questions end up getting answered.  However, the support is
-informal, done by volunteers and casual readers, so it's especially
-important that you do your homework before asking.  (If you prefer
-guaranteed commercial support, you can forego \TL{} completely and
-purchase a vendor's system; \url{http://tug.org/interest.html#vendors}
-has a list.)
+The \TeX{} community is both active and friendly, and most serious
+questions end up getting answered.  However, the support is informal,
+done by volunteers and casual readers, so it's especially important that
+you do your homework before asking.  (If you prefer guaranteed
+commercial support, you can forego \TL{} completely and purchase a
+vendor's system; \url{http://tug.org/interest.html#vendors} has a list.)
 
 Here is a list of resources, approximately in the order we recommend
 using them:
@@ -126,8 +126,7 @@ using them:
 \item [\TeX{} Catalogue] If you are looking for a specific package,
 font, program, etc., the \TeX{} Catalogue is the place to look.  It is a
 huge collection of all \TeX{}-related items.  See
-%\OnCD{texmf-doc/doc/english/catalogue}, or
-\url{http://dante.ctan.org/tex-archive/help/Catalogue/index.html}.
+\url{http://www.ctan.org/tex-archive/help/Catalogue/index.html}.
 
 \item [\TeX{} Web Resources] The web page
 \url{http://tug.org/interest.html} has many \TeX{}-related links, in
@@ -145,16 +144,17 @@ search, for example on \url{http://google.com}, never hurts.
 \item [asking questions] If you cannot find an answer, you can post to
 \dirname{comp.text.tex} through Google or your newsreader, or to
 \email{texhax@tug.org} through email.  But before you post,
-\emph{please} read this \acro{FAQ} entry on asking questions in such a
-way that you're most likely to get an answer:
+\emph{please} read this \acro{FAQ} entry, to maximize 
+your chances of getting a useful answer:
 \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}.
 
 \item [\TL{} support] If you want to report a bug or have
 suggestions or comments on the \TL{} distribution, installation, or
 documentation, the mailing list is \email{tex-live@tug.org}.  However,
 if your question is about how to use a particular program included in
-\TL{}, you are better off writing to that program's maintainer or
-mailing list.
+\TL{}, please write to that program's maintainer or
+mailing list.  Often running a program with the \code{-{}-help} option
+will provide a bug reporting address.
 
 \end{description}
 
@@ -182,35 +182,30 @@ The \TK{} \DVD{} comprises the following:
 \begin{description}
 
 \item [live] A complete \TeX{} system which can be run live or
-  installed to disk. It is too large for \acro{CD}.
+  installed to disk.
 
 \item [CTAN] A snapshot of the \CTAN{} repository
 
-\item [protext] An enhancement of the \MIKTEX\ distribution for Windows,
+\item [pro\TeX{}t] An enhancement of the \MIKTEX\ distribution for Windows,
 \ProTeXt\ adds a few extra tools to \MIKTEX, and simplifies
 installation.  It is entirely independent of \TL{}, and has its own
-installation instructions.  It can be run live, or installed to disk.
-The \ProTeXt\ home page is \url{http://tug.org/protext}.
+installation instructions.  The \ProTeXt\ home page is
+\url{http://tug.org/protext}.
 
-\item [Mac\TeX] for \MacOSX is independent of but based on \TL{},
-  although slightly modified to make a better fit with \MacOSX. Its
-  home page is \url{http://www.tug.org/mactex/}.
+\item [Mac\TeX] for \MacOSX adds a native \MacOSX\ installer and other
+Mac applications to \TL{}.  Its home page is
+\url{http://www.tug.org/mactex/}.
 
 \item [\texttt{texmf-extra}] A directory with assorted additional packages.
 
 \end{description}
 
-\CTAN{}, \pkgname{protext}, Mac\TeX, and \dirname{texmf-extra} do not follow
-the same copying conditions as \TL{}, so be careful when redistributing or
-modifying.
+\CTAN{}, \pkgname{protext}, Mac\TeX, and \dirname{texmf-extra} do not
+necessarily follow the same copying conditions as \TL{}, so be careful
+when redistributing or modifying.
 
-\noindent You can tell which type of distribution you're in by
-looking for a \filename{release-texlive.txt} file at the top of the
-\TL{} directory.  This file also contains the \TL{} release date.
 
-Naturally, each user group chooses what to distribute to its own members.
-
-\subsection{Top level directories}
+\subsection{Top level \TL{} directories}
 \label{sec:tld}
 
 Here is a brief listing and description of the top level directories in
@@ -350,9 +345,6 @@ The default layout is:
   \end{ttdescription}
 \end{description}
 
-For more discussion of \texttt{texconfig} and related utilities, please
-see section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig}.
-
 
 \subsection{Extensions to \protect\TeX}
 \label{sec:tex-extensions}
@@ -793,7 +785,7 @@ start the installation process. When it is done, skip to
 section~\ref{sec:postinstall} to read what else needs to be done, if
 anything.
 
-\subsubsection{Set up for running from \DVD{} (text mode only)}
+\subsubsection{Set up for running from DVD{} (text mode only)}
 \label{sec:fromdvd}
 
 Typing `V' to select this option. This changes the main menu into something
@@ -2714,7 +2706,6 @@ there were some changes there as well:
       configuration in the system trees.  The \cmdname{texconfig},
       \cmdname{updmap}, and \cmdname{fmtutil} scripts now modify
       user-specific files, under \dirname{$HOME/.texlive2005}.
-      See section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig}.
 
 \item Corresponding new variables \envname{TEXMFCONFIG} and
       \envname{TEXMFSYSCONFIG} to specify the trees where configuration
@@ -2728,7 +2719,7 @@ there were some changes there as well:
       See section~\ref{sec:texmftrees}, \p.\pageref{sec:texmftrees}.
 
 \item Last year, we kept \verb|\pdfoutput| and other primitives undefined
-      for DVI output, even though the \cmdname{pdfetex} program was
+      for \dvi\ output, even though the \cmdname{pdfetex} program was
       being used.  This year, as promised, we undid that compatibility
       measure.  So if your document uses \verb|\ifx\pdfoutput\undefined|
       to test if PDF is being output, it will need to be changed.  You
@@ -2786,10 +2777,6 @@ The (plain) \texttt{tex} program no longer reads \texttt{\%\&} first
 lines to determine what format to run; it is the pure Knuthian \TeX.
 (\LaTeX\ and everything else do still read \texttt{\%\&} lines).
 
-The installation scripts now accept various environment variables to
-allow for non-interactive installation; see
-section~\ref{sec:noninteractive-install}.
-
 Of course the year also saw (the usual) hundreds of other updates to
 packages and programs.  As usual, please check \acro{CTAN}
 (\url{http://www.ctan.org}) for updates.