summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-08-17 17:02:26 +0000
committerKarl Berry <karl@freefriends.org>2009-08-17 17:02:26 +0000
commit7e953fee56ac81a60fbe3e1732474cc859b794a7 (patch)
tree7f801a96b8866b9f9663a1bac455d571bc9759c9 /Master
parent9305dc8b1566c6b5f9637ffbbfe2b2e1bcc8cfeb (diff)
tweak auctex, mention texshop
git-svn-id: svn://tug.org/texlive/trunk@14733 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf/doc/texlive/texlive-en/texlive-en.tex246
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}