diff options
Diffstat (limited to 'Master/texmf-doc/source/english/texlive-en/live.tex')
-rw-r--r-- | Master/texmf-doc/source/english/texlive-en/live.tex | 138 |
1 files changed, 88 insertions, 50 deletions
diff --git a/Master/texmf-doc/source/english/texlive-en/live.tex b/Master/texmf-doc/source/english/texlive-en/live.tex index 82347e3dcde..9872ad090df 100644 --- a/Master/texmf-doc/source/english/texlive-en/live.tex +++ b/Master/texmf-doc/source/english/texlive-en/live.tex @@ -10,14 +10,14 @@ \title{% {\huge \textit{The \protect\TL{} Guide}\\\strut} - {\LARGE \textsf{\TK{} 2005}} + {\LARGE \textsf{\TK{} 2006}} } -\author{Sebastian Rahtz \& Karl Berry, editors \\[3mm] +\author{Karl Berry, editor \\[3mm] \url{http://tug.org/texlive/} } -\date{October 2005} +\date{December 2006} \maketitle @@ -215,7 +215,7 @@ members.) Here is a brief listing and description of the top level directories in the \TL{} distribution. On the \pkgname{live} \DVD, the entire \TL{} -hierarchy is in a subdirectory \dirname{texlive2005}, not at the top +hierarchy is in a subdirectory \dirname{texliveYYYY}, not at the top level of the disc. \smallskip @@ -313,15 +313,14 @@ classes of marks, additional debugging features, and more) and the \eTeX{} is 100\% compatible with ordinary \TeX. See \OnCD{texmf-dist/doc/etex/base/etex_man.pdf}. -\item [pdf\TeX] writes Acrobat \acro{PDF} format as well as \dvi{}. The -\LaTeX{} \pkgname{hyperref} package has an option `\optname{pdftex}' -which turns on all the program features. See +\item [pdf\TeX] builds on the \eTeX\ extensions, adding support for +writing \acro{PDF} output as well as \dvi{}. See \OnCD{texmf/doc/pdftex/manual/} for the manual, and -\OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex}. +\OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex}. This is the +default program for all formats except plain \TeX. -\item [pdfe\TeX] combines the pdf\TeX\ and \eTeX\ extensions. This is -the default program for all formats except plain \TeX. -See above for documentation. +\item [Xe\TeX] adds support for Unicode input and OpenType fonts, using +third-party libraries. See \url{http://scripts.sil.org/xetex}. \item [\OMEGA\ (Omega)] is based on Unicode (16-bit characters), thus supports working with almost all the world's scripts simultaneously. It @@ -461,19 +460,19 @@ choose a directory on the local disk to place files that the \TeX{} system itself generates, such as fonts and formats, and also to provide a place for updated configuration files, if need be. -We'll use \dirname{/opt/texlive2005} in this example. It's good to +We'll use \dirname{/opt/texlive2006} in this example. It's good to include the year in the name, as these generated files are not -compatible from release to release. (If the default value of -\dirname{/usr/local/texlive/2005} works for you, then you can skip this +in general compatible from release to release. (If the default value of +\dirname{/usr/local/texlive/2006} works for you, then you can skip this step.) \begin{alltt} Enter command: \Ucom{d} Current directories setup: -<1> TEXDIR: /usr/local/texlive/2005 +<1> TEXDIR: /usr/local/texlive/2006 ... Enter command: \Ucom{1} -New value for TEXDIR [/usr/local/texlive/TeX]: \Ucom{/opt/texlive2005} +New value for TEXDIR [/usr/local/texlive/TeX]: \Ucom{/opt/texlive2006} ... Enter command: \Ucom{r} \end{alltt} @@ -538,14 +537,14 @@ Bourne-compatible shell (\cmdname{sh}, \cmdname{bash}, \cmdname{ksh}, et al.), put the following into your \filename{$HOME/.profile} file: \begin{alltt} PATH=/mnt/cdrom/bin/\var{archname}:$PATH; export PATH -TEXMFSYSVAR=/opt/texlive2005/texmf-var; export TEXMFVAR +TEXMFSYSVAR=/opt/texlive2006/texmf-var; export TEXMFVAR \end{alltt} \noindent For C shell-compatible shells (\cmdname{csh}, \cmdname{tcsh}), put the following into your \filename{$HOME/.cshrc} file: \begin{alltt} setenv PATH /mnt/cdrom/bin/\var{archname}:$PATH -setenv TEXMFSYSVAR /opt/texlive2005/texmf-var +setenv TEXMFSYSVAR /opt/texlive2006/texmf-var \end{alltt} \noindent Then log out, log back in, and test your installation @@ -681,7 +680,7 @@ be changed here: \begin{ttdescription} \item [TEXDIR] The top-level directory under which everything else will be installed. The default value is -\dirname{/usr/local/texlive/2005}, and is often changed. We recommend +\dirname{/usr/local/texlive/2006}, and is often changed. We recommend including the year in the name, to keep different releases of \TL{} separate. (You may wish to make a version-independent name such \dirname{/usr/local/texlive} via a symbolic link, which you can then @@ -756,13 +755,13 @@ on your shell. If you use a Bourne-compatible shell (\cmdname{sh}, \filename{$HOME/.profile} file: \begin{alltt} -PATH=/usr/local/texlive/2005/bin/\var{archname}:$PATH; export PATH +PATH=/usr/local/texlive/2006/bin/\var{archname}:$PATH; export PATH \end{alltt} \noindent For C shell-compatible shells (\cmdname{csh}, \cmdname{tcsh}), put the following into your \filename{$HOME/.cshrc} file: \begin{alltt} -setenv PATH /usr/local/texlive/2005/bin/\var{archname}:$PATH +setenv PATH /usr/local/texlive/2006/bin/\var{archname}:$PATH \end{alltt} \textruntexconfig @@ -777,7 +776,7 @@ shell prompt as usual. \Ucom{i} # perform installation > \Ucom{texconfig} ... # see section \ref{sec:texconfig} # New PATH element, with Linux as the example: -> \Ucom{PATH=/usr/local/texlive/2005/bin/i386-linux:$PATH; export PATH} +> \Ucom{PATH=/usr/local/texlive/2006/bin/i386-linux:$PATH; export PATH} \end{alltt} \textifindoubt @@ -968,14 +967,14 @@ configuration file for the base \Webc{} programs is named default settings and useful alternatives. As of 2005, \cmdname{texconfig} alters files in a user-specific -directory, namely \dirname{$HOME/.texlive2005}. If you install \TeX\ +directory, as in \dirname{$HOME/.texlive2005}. If you install \TeX\ just for yourself, that is unlikely to make a difference. But if you install \TeX\ on a multi-user system, you will want to change the configuration for the whole system. In this case, run \cmdname{texconfig-sys} instead of \cmdname{texconfig}. Likewise, the \cmdname{updmap} and \cmdname{fmtutil} scripts were -changed, to work under \dirname{$HOME/.texlive2005}. To alter system +changed, to work under \dirname{$HOME/.texliveYYYY}. To alter system directories, use \cmdname{updmap-sys} and \cmdname{fmtutil-sys}. In particular, for multi-user systems, you will probably want to @@ -1219,7 +1218,7 @@ these operations are done there, some of them can be lengthy. So please wait until you see a statement about the successfully finished installation. The shortcut for \cmdname{tlpmgui} will be added to the -\guiseq{Start\arw Programs\arw TeXLive2005} menu. +\guiseq{Start\arw Programs\arw TeXLive2006} menu. If it is needed (Win9x/WinME), you will be asked to reboot your computer. @@ -1296,12 +1295,12 @@ conveniently view PS/PDF files. \cmdname{GSView} is available from \section{Maintenance of the installation in Windows} If you have TeX Live installed, you can use \cmdname{tlpmgui} again -for modyfying and maintaining your installation. +for modifying and maintaining your installation. \subsection{Adding/removing packages} As the \cmdname{tlpmgui} shortcut is available in the \guiseq{Start\arw -Programs\arw TeXLive2005} menu, start it from here. The maintenance window +Programs\arw TeXLive2006} menu, start it from here. The maintenance window titled \guiseq{TeX Live installation and maintenance utility} shows. It contains several tabs: \guiseq{Add Packages}, \guiseq{Remove packages}, \guiseq{Manage installation}, \guiseq{Remove installation}. @@ -1391,8 +1390,8 @@ way, you will be safe against upgrades of the \TL{} software. The directory pointed to by \path|$TEXMFLOCAL| is initially empty. If, for example, you want to add the support file for the Maple symbolic computation program, you will have to put the style files in:\\ -\path|c:\TeXLive2005\texmf-local\tex\latex\maple\|\\ and the -documentation files in:\\ \path|c:\TeXLive2005\texmf-local\doc\latex\maple\| +\path|c:\TeXLive2006\texmf-local\tex\latex\maple\|\\ and the +documentation files in:\\ \path|c:\TeXLive2006\texmf-local\doc\latex\maple\| \subsection{Running \texttt{tlmp.exe} from the command line} The \cmdname{tlpm.exe} program which is used as engine by \cmdname{tlpmgui} @@ -1491,7 +1490,7 @@ pointed out. \subsubsection{Dvips} The configuration file for dvips can be found in\\ -\verb+C:\TeXLive2005\texmf-var\dvips\config\config.ps+\\ +\verb+C:\TeXLive2006\texmf-var\dvips\config\config.ps+\\ You may open it with any editor %(\cmdname{WinShell} will do fine) and change some parameters: @@ -1532,7 +1531,7 @@ font package addition. If you add new packages by hand, edit the file If you use the program pdf{}latex to write \acro{PDF} format directly, and you are using \acro{US} letter-size paper, edit the file -\verb+C:\TeXLive2005\texmf-var\tex\generic\config\pdftexconfig.tex+ and +\verb+C:\TeXLive2006\texmf-var\tex\generic\config\pdftexconfig.tex+ and change \samp{\bs pdfpagewidth} and \samp{\bs pdfpageheight}. These entries should read: \begin{alltt} @@ -1593,7 +1592,7 @@ For generic verification procedures, see section~\ref{sec:test-install} Windows-specific tests. Open the file \verb+sample2e.tex+ in your editor (Xemacs, WinShell), -found in \path|C:\TeXLive2005\texmf-dist\tex\latex\base|. The \LaTeX\ source +found in \path|C:\TeXLive2006\texmf-dist\tex\latex\base|. The \LaTeX\ source should appear on the screen. Process it by clicking on the \guiseq{Command\arw LaTeX} menu (XEmacs) or \LaTeX\ icon on the toolbar (WinShell), then view it by clicking on the \guiseq{Command\arw View DVI} @@ -1774,7 +1773,7 @@ There is a different procedure to change it for Win9x, WinME and NT/2K/XP: by \path|;|. Please add the directory with the executables in this line. After this, this line could look as follows: \begin{verbatim} -PATH=c:\windows;c:\windows\system;c:\TeXLive2005\bin\win32 +PATH=c:\windows;c:\windows\system;c:\TeXLive2006\bin\win32 \end{verbatim} \item[Windows ME] You need to run the special program \path|c:\windows\system\msconfig.exe| to be able to change any @@ -1799,7 +1798,7 @@ PATH=c:\windows;c:\windows\system;c:\TeXLive2005\bin\win32 \texttt{PATH} while the field Value shows the current setting of \texttt{PATH} as a list of directories separated by \path|;|. Add the directory where the executables are located (e.g. - \path|c:\TeXLive2005\bin\win32|). If there isn't a \texttt{PATH} variable + \path|c:\TeXLive2006\bin\win32|). If there isn't a \texttt{PATH} variable for your user account, simply click in the field Variable and type in \texttt{PATH}, click in the field \textsf{Value} and type in the directory with the executables. Important: Click on @@ -1908,7 +1907,7 @@ Here are several questions to investigate: \item Is \file{tex.exe} in my \path|PATH|? \item Is the \path|TEXMFCNF| variable correctly set to -\path|c:/TeXLive2005/texmf-var/web2c| (default value)? +\path|c:/TeXLive2006/texmf-var/web2c| (default value)? \item Are there any errors in the log file generated by the \file{tlmpgui.exe} program? @@ -2769,15 +2768,14 @@ The other principal contributors are listed below. \begin{itemize*} -\item The German-speaking \TeX{} Users (\acro{DANTE} e.V.), who provide -the hardware for the \TL{} source repository; and Rainer Sch\"opf and -Reinhard Zierke who look after it. \acro{DANTE} officers Volker Schaa -and Klaus H\"oppner coordinate production with the Lehmann's Bookstore -(\url{http://www.lob.de}). +\item The English, German, Dutch, and Polish \TeX{} user groups +(\acro{TUG}, \acro{DANTE} e.V., \acro{NTG}, and \acro{GUST}, +respectively), which together provide the necessary technical +and administrative infrastructure. Please join your local user group! -\item The Perforce corporation (\url{http://www.perforce.com}), for providing -a free copy of their excellent change management system, which we use -to manage the \TL{} sources. +\item The \acro{CTAN} team, 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. @@ -2795,16 +2793,36 @@ it at short notice. \item Hans Hagen, for major testing and making the \ConTeXt\ format conform to \TL's needs. +\item \Thanh, Martin Schr\"oder, and the pdf\TeX\ team for continuing +enhancements of \TeX's abilities. + +\item Taco Hoekwater, for renewed development efforts on MetaPost and +\TeX\ itself. + \item Pawe{\l} Jackowski, for the Windows installer \cmdname{tlpm}, and Tomasz {\L}uczak, for \cmdname{tlpmgui}. -\item \Thanh, Martin Schr\"oder, and the pdf\TeX\ team for continuing -enhancements of \TeX's abilities. +\item Akira Kakuto, for updated Windows binaries as part of his +\acro{W32TEX} distribution effort +(\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}). + +\item Jonathan Kew and his employer \acro{SIL}, for the major new +development of Xe\TeX{} and taking the time and trouble to integrate it +in \TL{}. + +\item Reinhard Kotucha, for helping with the massive task of updating +packages in \TL{}, as well as Windows research efforts, the +\texttt{getnonfreefonts} script, and more. \item Petr Olsak, who coordinated and checked all the Czech and Slovak material very carefully. -\item Fabrice Popineau, for the Windows binaries in \TL{}. +\item Fabrice Popineau, for the original Windows support in \TL{}. + +\item Norbert Preining, for helping with the \TL{} infrastructure and +package updates, and coordinating the Debian version of \TL{} (together +with Frank K\"uster), making many suggestions for improvement along the +way. \item Staszek Wawrykiewicz, the principal tester for all of \TL{}, and coordinator of the many major Polish contributions: fonts, Windows @@ -3089,8 +3107,7 @@ not new in 2004, but wasn't previously documented.) Similarly, on \end{itemize} -\subsection{Present} -\label{tlcurrent} +\subsubsection{2005} 2005 saw the usual huge number of updates to packages and programs. The infrastructure stayed relatively stable from 2004, but inevitably @@ -3151,10 +3168,32 @@ latex --translate-file=empty.tcx yourfile.tex \end{itemize} + +\subsection{Present} +\label{tlcurrent} + +In 2006, the major new addition to \TL{} was the Xe\TeX{} program, +available as the \texttt{xetex} and \texttt{xelatex} programs; see +\url{http://scripts.sil.org/xetex}. + +MetaPost also received a notable update, with more planned for the +future (\url{http://tug.org/metapost/articles}), likewise pdf\TeX{} +(\url{http://tug.org/applications/pdftex}) + +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. + +Internally, the source tree is now stored in Subversion, with a standard +web interface for viewing the tree, as linked from our home page. +Although not visible in the final distribution, we expect this will +provide a stable development foundation for future years. + + \subsection{Future} \emph{\TL{} is not perfect!} (And never will be.) We intend to -continue to release new versions yearly, and would like to provide more +continue to release new versions, and would like to provide more help material, more utilities, more installation programs, and (of course) an ever-improved and checked tree of macros and fonts. This work is all done by hard-pressed volunteers in their limited spare time, and @@ -3163,7 +3202,6 @@ your name forward! Please send corrections, suggestions, and offers of help to:\hfill\null \begin{quote} -Sebastian Rahtz \ / \ 7 Stratfield Road \ / \ Oxford OX2 7BG \ / \ UK \\ \email{tex-live@tug.org} \\ \url{http://tug.org/texlive} \end{quote} |