summaryrefslogtreecommitdiff
path: root/Master/texmf-doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-07-15 01:02:45 +0000
committerKarl Berry <karl@freefriends.org>2008-07-15 01:02:45 +0000
commit5cbf15f842d1a9863c3bca08ddb4547057df7cfd (patch)
tree2a126835df24303bfbf0a6d2560af308aeb7020b /Master/texmf-doc
parent97b6bd75687e8502b9cf282120440deaab0d43be (diff)
first edits, bigger \acro
git-svn-id: svn://tug.org/texlive/trunk@9562 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-doc')
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/tex-live.sty5
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/texlive-en.tex99
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.