tweak auctex, mention texshop

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

1 files changed, 116 insertions, 130 deletions

diff --git a/Master/texmf/doc/texlive/texlive-en/texlive-en.tex b/Master/texmf/doc/texlive/texlive-en/texlive-en.tex
index 52ebbbbfe0e..b8b3e4333e2 100644
--- a/Master/texmf/doc/texlive/texlive-en/texlive-en.tex
+++ b/Master/texmf/doc/texlive/texlive-en/texlive-en.tex
@@ -1192,26 +1192,26 @@ If you are new to \TeX{}, or otherwise need help with actually writing
 \TL{} has been designed to be shared between different users, and even
 different systems on a network. With a standard directory layout, no
 hard paths are configured: the locations for files needed by \TL{}
-programs are defined relative to the places of those programs.  You can
-see this at work in the configuration file
-\filename{$TEXMFMAIN/web2c/texmf.cnf}, which contains lines such as
+programs are found relative to the programs.  You can see this in the
+principal configuration file \filename{$TEXMFMAIN/web2c/texmf.cnf},
+which contains lines such as
 \begin{sverbatim}
 TEXMFMAIN = $SELFAUTOPARENT/texmf
 ...
 TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local
 \end{sverbatim}
-This means that other systems or other users merely need to add the
-directory for \TL{} binaries for their platform to their search path.
+This means that adding the directory for \TL{} executables for their
+platform to their search path is sufficient to get a working setup.
 
 By the same token, you can also install \TL{} locally and then move
 the entire hierarchy afterwards to a network location.
 
-Of course, Windows users have different expectations. The directory
-\dirname{texmf-doc/source/texlive/texlive-common/w32client} contains a
-sample script \filename{install-w32client} which creates settings and
-menu shortcuts for using an existing \TL{} installation on a
-\acro{LAN}. It is to be invoked through a batch file
-\filename{install-w32client.bat} in the same directory.
+Windows users have different expectations. The directory
+\OnCD{texmf/doc/texlive/texlive-common/w32client/} contains a sample
+script \filename{install-w32client} which creates settings and menu
+shortcuts for using an existing \TL{} installation on a \acro{LAN}. It
+is invoked through a batch file \filename{install-w32client.bat} in the
+same directory.
 
 You can read more about \TL{} configuration and path searching in
 section~\ref{sec:kpathsea}.
@@ -1226,7 +1226,7 @@ something with minimal side effects.
 
 In the root of the \TL{} \DVD, or the \dirname{texlive} subdirectory of
 the \TK{} \DVD, are a \filename{tl-portable} script (Unix) and a
-\filename{tl-portable.bat} batchfile (Windows) which start up a
+\filename{tl-portable.bat} batch file (Windows) which start up a
 secondary shell\slash command prompt with environment settings suitable
 for directly accessing the \TL{} on the \DVD.
 
@@ -1269,18 +1269,17 @@ others.
 \caption{\texttt{tlmgr} in GUI mode: Configuration tab}\label{fig:tlmgr-config}
 \end{figure}
 
-The installer installs a program named \prog{tlmgr} for managing \TL{}
-after the initial installation.  The programs \prog{updmap},
-\prog{fmtutil} and \prog{texconfig} are still included and will be
-retained in the future, but \prog{tlmgr} is now the preferred interface.
-Its capabilities include:
+\TL{} includes a program named \prog{tlmgr} for managing \TL{} after the
+initial installation.  The programs \prog{updmap}, \prog{fmtutil} and
+\prog{texconfig} are still included and will be retained in the future,
+but \prog{tlmgr} is now the preferred interface.  Its capabilities
+include:
 
 \begin{itemize*}
-\item listing schemes, collections and packages;
-\item installing, updating, backing up, restoring and uninstalling
+\item installing, updating, backing up, restoring, and uninstalling
   individual packages, optionally taking dependencies into account;
-\item searching for packages;
-\item listing and adding architectures;
+\item searching for and listing packages, etc.;
+\item listing, adding, and removing architectures;
 \item changing installation options such as paper size and source
   location (see section~\ref{sec:location}).
 \end{itemize*}
@@ -1302,43 +1301,42 @@ Figure~\ref{fig:tlmgr-config} shows the configuration tab.
 
 \subsection{Sample \cmdname{tlmgr} command-line invocations}
 
-This example adds several packages, including a new `engine', from a
-non-default location:
+After the initial installation, you can update your system to the latest
+versions available with:
+\begin{alltt}
+> \Ucom{tlmgr update -all}
+\end{alltt}
+If this makes you nervous, first try
+\begin{alltt}
+> \Ucom{tlmgr update -all -dry-run}
+\end{alltt}
+or
+\begin{alltt}
+> \Ucom{tlmgr update -list}
+\end{alltt}
+
+This more complex example adds several packages, including the engine
+\XeTeX, from a local directory:
 
 \begin{alltt}
-> \Ucom{tlmgr -location http://172.16.18.1/tldev install collection-xetex xkeyval}
+> \Ucom{tlmgr -location /local/mirror/tlnet install collection-xetex xkeyval}
 \end{alltt}
-It generates the following output:
+It generates the following output (abridged):
 \begin{fverbatim}
 install: collection-xetex
 install: arabxetex
 install: euenc
-install: bidi
-install: fontspec
-install: fontwrap
-install: ifxetex
-install: philokalia
-install: polyglossia
-install: xecyr
-install: xecyr.i386-linux
-install: xepersian
+...
 install: xetex
 install: xetexconfig
 install: xetex.i386-linux
 running post install action for xetex
 install: xetex-def
-install: xetex-pstricks
-install: xetexfontinfo
-install: xltxtra
-install: xunicode
+...
 install: xkeyval
 running mktexlsr
 mktexlsr: Updating /usr/local/texlive/2009/texmf/ls-R...
-mktexlsr: Updating /usr/local/texlive/2009/texmf-config/ls-R...
-mktexlsr: Updating /usr/local/texlive/2009/texmf-dist/ls-R...
-mktexlsr: Updating /usr/local/texlive/2009/texmf-doc/ls-R...
-mktexlsr: Updating /usr/local/texlive/2009/../texmf-local/ls-R...
-mktexlsr: Updating /usr/local/texlive/2009/texmf-var/ls-R...
+...
 mktexlsr: Done.
 regenerating fmtutil.cnf
 running fmtutil-sys --missing
@@ -1346,40 +1344,30 @@ running fmtutil-sys --missing
 Transcript written on xelatex.log.
 fmtutil: /usr/local/texlive/2009/texmf-var/web2c/xetex/xelatex.fmt installed.
 \end{fverbatim}
-As you see, \prog{tlmgr} installs dependencies, and takes care of any
+
+As you may see, \prog{tlmgr} installs dependencies, and takes care of any
 necessary post-install actions, including updating the filename database
-and (re)generating formats.  (Here we generated new formats for \XeTeX.)
+and (re)generating formats.  In the above, we generated new formats for
+\XeTeX.
 
-This example installs a new language.  This also triggers format
+This next example installs a new language, which also triggers format
 regeneration:
 \begin{alltt}
 > \Ucom{tlmgr install collection-langdutch}
 \end{alltt}
 To describe a package:
 \begin{alltt}
-> \Ucom{tlmgr show collection-wintools}
+> \Ucom{tlmgr show collection-latexextra}
 \end{alltt}
 which 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
+package:    collection-latexextra
+category:   Collection
+shortdesc:  LaTeX supplementary packages
+longdesc:   A large collection of add-on packages for LaTeX.
+installed:  Yes
+revision:   14675
 \end{fverbatim}
-Updating your entire installation to the latest versions available:
-\begin{alltt}
-> \Ucom{tlmgr update -all}
-\end{alltt}
-If this makes you nervous, first try
-\begin{alltt}
-> \Ucom{tlmgr update -all -dry-run}
-\end{alltt}
-or
-\begin{alltt}
-> \Ucom{tlmgr update -list}
-\end{alltt}
 For full documentation:
 \begin{alltt}
 > \Ucom{tlmgr -help}
@@ -1400,14 +1388,15 @@ was only possible by dropping support for older Windows versions, so
 Under Windows, the installer does some extra things:
 \begin{description}
 \item[Menus and shortcuts.] A new `\TL{}' submenu of the
-  Start menu is installed, which contains entries for some \GUI{} programs
-  (\prog{tlmgr}, \prog{texdoctk}, the PS\_View PostScript previewer)
-  and some documentation. PS\_View also gets a shortcut on the
-  desktop as a drag-and-drop target for PostScript files.
+  Start menu is installed, which contains entries for some \GUI{}
+  programs (\prog{tlmgr}, \prog{texdoctk}, the PS\_View (\prog{psv})
+  PostScript previewer and some documentation. PS\_View also gets a
+  shortcut on the desktop as a drag-and-drop target for PostScript
+  files.
 \item[Automatic setting of environment variables.] No manual
   configuration steps are required.
 \item[Uninstaller.] The installer creates an entry under `Add/Remove
-  Programs' for \TL. The uninstall tab of\prog{tlmgr} refers to
+  Programs' for \TL. The uninstall tab of \prog{tlmgr} refers to
   this.
 \end{description}
 
@@ -1426,44 +1415,35 @@ pieces:
   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
+  or registry settings. They aren't full-scale installations, and
   shouldn't interfere with any system installations of Perl or
   Ghostscript.
+
+\item[PS\_View.] Also installed is PS\_View, a PostScript viewer; see
+  figure~\ref{fig:psview}.
+
+\item[dviout.] Also installed is \prog{dviout}, a \acro{DVI} viewer.
+  At first, when you preview files with \cmdname{dviout}, it will create
+  fonts, because screen fonts were not installed. After a while, you
+  will have created most of the fonts you use, and you will rarely see
+  the font-creation window.  More information can be found in the
+  (highly recommended) on-line help.
+
 \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 \cmdname{gzip}, \cmdname{chktex},
   \cmdname{jpeg2ps}, \cmdname{unzip}, \cmdname{wget} and the
-  command-line utilities from the \cmdname{xpdf} suite.  (The
+  command-line utilities from the \cmdname{xpdf} suite.  The
   \cmdname{xpdf} viewer itself is not available for Windows, but the
   Sumatra \acro{PDF} viewer is based on it:
-  \url{http://blog.kowalczyk.info/software/sumatrapdf}.)
-\item[\texttt{fc-cache}] helps \XeTeX{} to handle fonts more
-  efficiently.
-\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. This directory also
-  contains the \cmdname{dviout} \dvi{} previewer; see the next section.
-\end{description}
-
-\subsection{The Dviout previewer}
+  \url{http://blog.kowalczyk.info/software/sumatrapdf}.
 
-This \TL{} release unfortunately doesn't offer a preinstalled \dvi{}
-previewer for Windows. However, you can install \prog{dviout} by
-Toshio Oshima from the \path{support/dviout/} directory, which
-contains also a short \filename{README} describing how to install
-and configure \prog{dviout} for \TL.  Please read this carefully
-before installation.
+\item[fc-list, et al.] The tools from the fontconfig library allow
+  \XeTeX{} to handle system fonts on Windows.  You can use
+  \prog{fc-list} to determine the font names to pass to Xe\TeX's
+  extended \cs{font} command
 
-At first, when you preview files with \cmdname{dviout}, it will create fonts,
-because screen fonts were not installed. After a while, you will have created
-most of the fonts you use, and you will rarely see the font-creation window.
-More information can be found in the (very good) on-line help.
+\end{description}
 
 \subsection{Links for additional downloadable software}
 
@@ -1477,24 +1457,26 @@ Urls for some other tools you may consider installing:
 \item[NetPBM] \url{http://netpbm.sourceforge.net/}, also for graphics.
       
 \item[\TeX-oriented editors] There is a wide choice, and it is a matter of the
-      user's taste. Here is a selection, in no particular order:
+      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 Auc\TeX\ for Windows is available in \TL's
         \path{support} directory; its home page is
         \url{http://www.gnu.org/software/auctex}.
-  \item \cmdname{WinShell} is available in \TL's \path|support|
-        directory; its home page is \url{http://www.winshell.de}.
-  \item \cmdname{WinEdt} is shareware available from
-        \url{http://www.winedt.com}.
-  \item \cmdname{Vim} is free software, available from
-        \url{http://www.vim.org}.
-  \item TeXnicCenter is free software, available from
-        \url{http://www.toolscenter.org} and in the pro\TeX{}t 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}.
+  \item \cmdname{TeXnicCenter} is free software, available from
+        \url{http://www.toolscenter.org} and in the pro\TeX{}t distribution.
+  \item \cmdname{TeXworks} is free software, available from
+        \url{http://tug.org/texworks} and installed for Windows and
+        \MacOSX\ as part of \TL.
+  \item \cmdname{Vim} is free software, available from
+        \url{http://www.vim.org}.
+  \item \cmdname{WinShell} is available from \url{http://www.winshell.de}.
+  \item \cmdname{WinEdt} is shareware available from
+        \url{http://www.winedt.com}.
   \end{itemize*}
 \end{description}
 
@@ -1503,7 +1485,7 @@ Urls for some other tools you may consider installing:
 \label{sec:winhome}
 
 The Windows counterpart of a Unix home directory is the
-\verb|%USERPROFILE%| directory.  Under Windows XP and Windows 2000, this
+\verb|%USERPROFILE%| directory.  Under Windows \acro{XP} and Windows 2000, this
 is usually \verb|C:\Documents and Settings\<username>|, and under
 Windows Vista \verb|C:\Users\<username>|.  In the
 \filename{texmf.cnf} file, and \KPS{} in general, \verb|~| will expand
@@ -2408,12 +2390,12 @@ respectively), which provide the necessary technical and administrative
 infrastructure.  Please join the \TeX\ user group near you!  (See
 \url{http://tug.org/usergroups.html}.)
 
-\item The \acro{CTAN} team, most notably Robin Fairbairns, Jim Hef{}feron,
+\item The \acro{CTAN} team, notably Robin Fairbairns, Jim Hef{}feron,
 and Rainer Sch\"opf, which distributes the \TL{} images and provides the
 common infrastructure for package updates, upon which \TL{} depends.
 
 \item Peter Breitenlohner (and the \eTeX\ team) for the stable foundation
-of future \TeX's, and Peter specifically for stellar help with the GNU
+of future \TeX's, and Peter specifically for stellar help with the \GNU\
 autotools usage throughout \TL.
 
 \item Thomas Esser, without whose marvelous \teTeX{} package \TL{}
@@ -2423,7 +2405,8 @@ would have never existed.
 
 \item Eitan Gurari, whose \TeX4ht was used to create the \HTML{}
 version of this documentation, and who worked tirelessly to improve
-it at short notice.
+it at short notice.  Eitan prematurely passed away in June 2009, and we
+dedicate this documentation to his memory.
 
 \item \Thanh, Martin Schr\"oder, and the pdf\TeX\ team
 (\url{http://pdftex.org}) for continuing enhancements of \TeX's
@@ -2437,7 +2420,7 @@ pdf\TeX\, Lua\TeX, and more.
 
 \item Taco Hoekwater, for renewed development efforts on MetaPost and
 (Lua)\TeX\ (\url{http://luatex.org}) itself, and for incorporating
-\ConTeXt\ into \TL.
+\ConTeXt\ into \TL, among much else.
 
 \item Pawe{\l} Jackowski, for the Windows installer \cmdname{tlpm},
 and Tomasz {\L}uczak, for \cmdname{tlpmgui}, used in past releases.
@@ -2447,9 +2430,10 @@ binaries from his \acro{W32TEX} distribution for Japanese \TeX\
 (\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}), and many
 other contributions.
 
-\item Jonathan Kew and \acro{SIL}, for the major new development of
-\XeTeX{} and taking the time and trouble to integrate it in \TL{}, as
-well as the initial version of the Mac\TeX\ installer.
+\item Jonathan Kew, for developing the \XeTeX{} engine and taking the
+time and trouble to integrate it in \TL{}, as well as the initial
+version of the Mac\TeX\ installer, and also for our recommended
+front-end \TeX{}works.
 
 \item Dick Koch, for maintaining Mac\TeX\ (\url{http://tug.org/mactex})
 in very close tandem with \TL{}, and for his great good cheer in doing
@@ -2469,7 +2453,7 @@ material very carefully.
 \item Toshio Oshima, for his \cmdname{dviout} previewer for Windows.
 
 \item Manuel P\'egouri\'e-Gonnard, for helping with package updates,
-documentation improvements, and \cmdname{tldoc} development.
+documentation improvements, and \cmdname{texdoc} development.
 
 \item Fabrice Popineau, for the original Windows support in \TL{} and
 work on the French documentation.
@@ -2502,16 +2486,16 @@ and much integration and testing.
 \end{itemize*}
 
 Builders of the binaries:
-Reinhard Kotucha (\pkgname{x86\_64-linux}),
-Tim Arnold (\pkgname{hppa-hpux}),
-Randy Au (\pkgname{amd64-freebsd}),
-Edd Barrett (\pkgname{i386-openbsd}),
-Karl Berry (\pkgname{i386-linux}),
+Peter Breitenlohner (\pkgname{x86\_64-linux}),
+%Tim Arnold (\pkgname{hppa-hpux}),
+%Randy Au (\pkgname{amd64-freebsd}),
+%Edd Barrett (\pkgname{i386-openbsd}),
+Karl Berry (\pkgname{i386-linux}, \pkgname{sparc-linux}),
 Akira Kakuto (\pkgname{win32}),
 Dick Koch (\pkgname{universal-darwin}),
-Manfred Lotz (\pkgname{i386-freebsd}),
+%Manfred Lotz (\pkgname{i386-freebsd}),
 Norbert Preining (\pkgname{alpha-linux}),
-Arthur Reutenauer (\pkgname{sparc-linux}),
+%Arthur Reutenauer (\pkgname{sparc-linux}),
 Thomas Schmitz (\pkgname{powerpc-linux}),
 Apostolos Syropoulos (\pkgname{i386-solaris}),
 Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-solaris}),
@@ -2519,9 +2503,8 @@ Olaf Weber (\pkgname{mips-irix}).
 For information on the \TL{} build process, see
 \url{http://tug.org/texlive/build.html}.
 
-Documentation and translation updates:
-Karl Berry (English),
-Daniel Flipo (French),
+Current documentation translators:
+Manuel P\'egouri\'e-Gonnard (French),
 Klaus H\"oppner (German),
 Petr Sojka \& Jan Busa (Czech\slash Slovak),
 Boris Veytsman (Russian),
@@ -2879,15 +2862,13 @@ distributors.  (There is a new \texttt{tetex} installation scheme in
 eventually translate to improvements in the \TeX\ environment for
 everyone.
 
+\subsubsection{2008}
+
 \medskip \noindent
 Final note on the past: all releases of \TL{}, along with ancillary
 material such as \CD\ labels, are available at
 \url{ftp://tug.org/historic/systems/texlive}.
 
-\htmlanchor{news}
-\subsection{Present}
-\label{sec:tlcurrent}
-
 In 2008, the entire \TL{} infrastructure was redesigned and
 reimplemented.  Complete information about an installation is now stored
 in a plain text file \filename{tlpkg/texlive.tlpdb}.
@@ -2942,6 +2923,11 @@ Finally, the changes made by Donald Knuth in his `\TeX\ tuneup of 2008'
 are included in this release.  See
 \url{http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf}.
 
+\htmlanchor{news}
+\subsection{Present}
+\label{sec:tlcurrent}
+
+In 2009 xx.
 
 \subsection{Future}