From 7e953fee56ac81a60fbe3e1732474cc859b794a7 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 17 Aug 2009 17:02:26 +0000 Subject: tweak auctex, mention texshop git-svn-id: svn://tug.org/texlive/trunk@14733 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf/doc/texlive/texlive-en/texlive-en.tex | 246 ++++++++++----------- 1 file changed, 116 insertions(+), 130 deletions(-) (limited to 'Master/texmf') 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\|, and under Windows Vista \verb|C:\Users\|. 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} -- cgit v1.2.3