summaryrefslogtreecommitdiff
path: root/Master/texmf-doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-05-23 00:39:11 +0000
committerKarl Berry <karl@freefriends.org>2009-05-23 00:39:11 +0000
commit3b8ae63ca616b0a5d4f056524b53c9b896dee994 (patch)
treea8857841f94d6f5209e5094500f9dc43922b5a52 /Master/texmf-doc
parent65cfb8aaa329f6afe84ba28ad28af68f84230493 (diff)
move texlive sources out of texmf-doc
git-svn-id: svn://tug.org/texlive/trunk@13415 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-doc')
-rw-r--r--Master/texmf-doc/source/texlive/texlive-common/examples/ex5.tex6
-rw-r--r--Master/texmf-doc/source/texlive/texlive-common/examples/ex6.tex56
-rw-r--r--Master/texmf-doc/source/texlive/texlive-common/examples/ex6a.tex24
-rw-r--r--Master/texmf-doc/source/texlive/texlive-common/examples/ex6b.tex6
-rw-r--r--Master/texmf-doc/source/texlive/texlive-common/examples/ex6c.tex14
-rw-r--r--Master/texmf-doc/source/texlive/texlive-common/install-w32-main.pngbin50021 -> 0 bytes
-rw-r--r--Master/texmf-doc/source/texlive/texlive-common/psview.pngbin10129 -> 0 bytes
-rw-r--r--Master/texmf-doc/source/texlive/texlive-common/stdcoll.pngbin10661 -> 0 bytes
-rw-r--r--Master/texmf-doc/source/texlive/texlive-common/tlmgr-config.pngbin10167 -> 0 bytes
-rw-r--r--Master/texmf-doc/source/texlive/texlive-common/tlmgr-gui.pngbin11806 -> 0 bytes
-rw-r--r--Master/texmf-doc/source/texlive/texlive-common/w32client/README26
-rwxr-xr-xMaster/texmf-doc/source/texlive/texlive-common/w32client/install-w32client177
-rwxr-xr-xMaster/texmf-doc/source/texlive/texlive-common/w32client/install-w32client.bat28
-rw-r--r--Master/texmf-doc/source/texlive/texlive-cz/Makefile5
-rw-r--r--Master/texmf-doc/source/texlive/texlive-cz/cs-tex-live.sty458
-rw-r--r--Master/texmf-doc/source/texlive/texlive-cz/csquote.sty181
-rw-r--r--Master/texmf-doc/source/texlive/texlive-cz/live4ht.cfg47
-rw-r--r--Master/texmf-doc/source/texlive/texlive-cz/texlive-cz.tex3030
-rw-r--r--Master/texmf-doc/source/texlive/texlive-de/Makefile3
-rw-r--r--Master/texmf-doc/source/texlive/texlive-de/live4ht.cfg47
-rw-r--r--Master/texmf-doc/source/texlive/texlive-de/lmsy10-40.pngbin273 -> 0 bytes
-rw-r--r--Master/texmf-doc/source/texlive/texlive-de/texlive-de.tex3091
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/Makefile69
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/README5
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/bv-live.tex84
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/bvoutln.sty193
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/changemail24
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/l.pl44
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/live-2003.tex3937
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/live-2004.tex3854
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/live-2005.tex3174
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/live-2007.tex3264
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/live-2008.tex2951
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/live-tl7.tex3554
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/live4ht.cfg-200436
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/mod.pl976
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/nocites.tex557
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/picture.tex46
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/split.pl16
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/status.pl31
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.bib235
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.bst60
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2003378
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2004422
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2005429
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2007429
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2008444
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/archive/texlive.pl574
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/live4ht.cfg51
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/tex-live.css44
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/tex-live.sty446
-rw-r--r--Master/texmf-doc/source/texlive/texlive-en/texlive-en.tex2954
-rw-r--r--Master/texmf-doc/source/texlive/texlive-fr/Makefile5
-rw-r--r--Master/texmf-doc/source/texlive/texlive-fr/live.tex3945
-rw-r--r--Master/texmf-doc/source/texlive/texlive-fr/live4ht.cfg47
-rw-r--r--Master/texmf-doc/source/texlive/texlive-fr/tex-live.css44
-rw-r--r--Master/texmf-doc/source/texlive/texlive-fr/texlive-fr.tex3148
-rw-r--r--Master/texmf-doc/source/texlive/texlive-pl/Makefile3
-rw-r--r--Master/texmf-doc/source/texlive/texlive-pl/live4ht.cfg52
-rw-r--r--Master/texmf-doc/source/texlive/texlive-pl/tex-livep.sty446
-rw-r--r--Master/texmf-doc/source/texlive/texlive-pl/texlive-pl.tex3335
-rw-r--r--Master/texmf-doc/source/texlive/texlive-ru/Makefile3
-rw-r--r--Master/texmf-doc/source/texlive/texlive-ru/live4ht.cfg47
-rw-r--r--Master/texmf-doc/source/texlive/texlive-ru/texlive-ru.tex2998
-rw-r--r--Master/texmf-doc/source/texlive/texlive-zh-cn/Makefile47
-rw-r--r--Master/texmf-doc/source/texlive/texlive-zh-cn/README-live.ZH-CN34
-rw-r--r--Master/texmf-doc/source/texlive/texlive-zh-cn/tex-live.sty464
-rw-r--r--Master/texmf-doc/source/texlive/texlive-zh-cn/texlive-zh-cn.tex2576
68 files changed, 0 insertions, 53674 deletions
diff --git a/Master/texmf-doc/source/texlive/texlive-common/examples/ex5.tex b/Master/texmf-doc/source/texlive/texlive-common/examples/ex5.tex
deleted file mode 100644
index 51a49fb670e..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-common/examples/ex5.tex
+++ /dev/null
@@ -1,6 +0,0 @@
-TEXMF = {$TEXMFLOCAL,!!$TEXMFMAIN}
-TEXINPUTS.latex = .;$TEXMF/tex/{latex,generic;}//
-TEXINPUTS.fontinst = .;$TEXMF/tex//;$TEXMF/fonts/afm//
-% e-TeX related files
-TEXINPUTS.elatex = .;$TEXMF/{etex,tex}/{latex,generic;}//
-TEXINPUTS.etex = .;$TEXMF/{etex,tex}/{eplain,plain,generic;}//
diff --git a/Master/texmf-doc/source/texlive/texlive-common/examples/ex6.tex b/Master/texmf-doc/source/texlive/texlive-common/examples/ex6.tex
deleted file mode 100644
index 7a56896e61c..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-common/examples/ex6.tex
+++ /dev/null
@@ -1,56 +0,0 @@
-\begin{figure*}[tp]
-\centering
-\begin{BVerbatim}[fontsize=\small]
-debug:start search(file=texmf.cnf, must_exist=1, find_all=1,
- path=.:/usr/local/bin/texlive:/usr/local/bin:
- /usr/local/bin/texmf/web2c:/usr/local:
- /usr/local/texmf/web2c:/.:/./teTeX/TeX/texmf/web2c:).
-kdebug:start search(file=ls-R, must_exist=1, find_all=1,
- path=~/tex:/usr/local/texmf).
-kdebug:search(ls-R) =>/usr/local/texmf/ls-R
-kdebug:start search(file=aliases, must_exist=1, find_all=1,
- path=~/tex:/usr/local/texmf).
-kdebug:search(aliases) => /usr/local/texmf/aliases
-kdebug:start search(file=config.ps, must_exist=0, find_all=0,
- path=.:~/tex:!!/usr/local/texmf/dvips//).
-kdebug:search(config.ps) => /usr/local/texmf/dvips/config/config.ps
-kdebug:start search(file=/root/.dvipsrc, must_exist=0, find_all=0,
- path=.:~/tex:!!/usr/local/texmf/dvips//).
-search(file=/home/goossens/.dvipsrc, must_exist=1, find_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).
-kdebug:search($HOME/.dvipsrc) =>
-kdebug:start search(file=config.cms, must_exist=0, find_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).
-kdebug:search(config.cms)
-=>/usr/local/texmf/dvips/cms/config.cms
-\end{BVerbatim}
-\caption{Finding configuration files}\label{fig:dvipsdbga}
-
-\bigskip
-
-\begin{BVerbatim}[fontsize=\small]
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{BVerbatim}
-\caption{Finding the prolog file}\label{fig:dvipsdbgb}
-
-\bigskip
-
-\begin{BVerbatim}[fontsize=\small]
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{BVerbatim}
-\caption{Finding the font file}\label{fig:dvipsdbgc}
-\end{figure*}
diff --git a/Master/texmf-doc/source/texlive/texlive-common/examples/ex6a.tex b/Master/texmf-doc/source/texlive/texlive-common/examples/ex6a.tex
deleted file mode 100644
index bbc9f5b42a7..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-common/examples/ex6a.tex
+++ /dev/null
@@ -1,24 +0,0 @@
-\begin{BVerbatim}[fontsize=\small]
-debug:start search(file=texmf.cnf, must_exist=1, find_all=1,
- path=.:/usr/local/bin/texlive:/usr/local/bin:
- /usr/local/bin/texmf/web2c:/usr/local:
- /usr/local/texmf/web2c:/.:/./teTeX/TeX/texmf/web2c:).
-kdebug:start search(file=ls-R, must_exist=1, find_all=1,
- path=~/tex:/usr/local/texmf).
-kdebug:search(ls-R) =>/usr/local/texmf/ls-R
-kdebug:start search(file=aliases, must_exist=1, find_all=1,
- path=~/tex:/usr/local/texmf).
-kdebug:search(aliases) => /usr/local/texmf/aliases
-kdebug:start search(file=config.ps, must_exist=0, find_all=0,
- path=.:~/tex:!!/usr/local/texmf/dvips//).
-kdebug:search(config.ps) => /usr/local/texmf/dvips/config/config.ps
-kdebug:start search(file=/root/.dvipsrc, must_exist=0, find_all=0,
- path=.:~/tex:!!/usr/local/texmf/dvips//).
-search(file=/home/goossens/.dvipsrc, must_exist=1, find_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).
-kdebug:search($HOME/.dvipsrc) =>
-kdebug:start search(file=config.cms, must_exist=0, find_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).
-kdebug:search(config.cms)
-=>/usr/local/texmf/dvips/cms/config.cms
-\end{BVerbatim} \ No newline at end of file
diff --git a/Master/texmf-doc/source/texlive/texlive-common/examples/ex6b.tex b/Master/texmf-doc/source/texlive/texlive-common/examples/ex6b.tex
deleted file mode 100644
index 5a5a92f1f22..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-common/examples/ex6b.tex
+++ /dev/null
@@ -1,6 +0,0 @@
-\begin{BVerbatim}[fontsize=\small]
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{BVerbatim} \ No newline at end of file
diff --git a/Master/texmf-doc/source/texlive/texlive-common/examples/ex6c.tex b/Master/texmf-doc/source/texlive/texlive-common/examples/ex6c.tex
deleted file mode 100644
index 5daaeaa184b..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-common/examples/ex6c.tex
+++ /dev/null
@@ -1,14 +0,0 @@
-\begin{BVerbatim}[fontsize=\small]
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{BVerbatim} \ No newline at end of file
diff --git a/Master/texmf-doc/source/texlive/texlive-common/install-w32-main.png b/Master/texmf-doc/source/texlive/texlive-common/install-w32-main.png
deleted file mode 100644
index a8cc55f6070..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-common/install-w32-main.png
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-doc/source/texlive/texlive-common/psview.png b/Master/texmf-doc/source/texlive/texlive-common/psview.png
deleted file mode 100644
index 8322bdda693..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-common/psview.png
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-doc/source/texlive/texlive-common/stdcoll.png b/Master/texmf-doc/source/texlive/texlive-common/stdcoll.png
deleted file mode 100644
index 16a699ba3c6..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-common/stdcoll.png
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-doc/source/texlive/texlive-common/tlmgr-config.png b/Master/texmf-doc/source/texlive/texlive-common/tlmgr-config.png
deleted file mode 100644
index 7f2d3123689..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-common/tlmgr-config.png
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-doc/source/texlive/texlive-common/tlmgr-gui.png b/Master/texmf-doc/source/texlive/texlive-common/tlmgr-gui.png
deleted file mode 100644
index 9c45772503d..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-common/tlmgr-gui.png
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-doc/source/texlive/texlive-common/w32client/README b/Master/texmf-doc/source/texlive/texlive-common/w32client/README
deleted file mode 100644
index a09ea7cf560..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-common/w32client/README
+++ /dev/null
@@ -1,26 +0,0 @@
-The w32client pair of scripts configure a Windows system to make use
-of an existing read-only TeX Live installation, typically on a
-network drive.
-
-Copy these scripts to the root of the TeX live installation,
-i.e. the same directory as texmf, texmf-dist etc.
-
-This pair of scripts is intended as a prototype. Normally, it should
-work as-is, at least after copying to the right place, but you
-should review the following items:
-
-- check which shortcuts you want to include (add_desktop_shortcut
- and add_menu_shortcut)
-
-- Decide which file associations, if any, you want to create
- (register_extension and register_filetype). Although we wrote the
- functions for it, we decided in the end not to use them in the
- regular installation.
-
-- You can comment out or remove the xetex stanza if you aren't going
-- to use xetex.
-
-- If the directory layout is non-standard, you may have to edit the
- texmf.cnf in the root of the installation. Use relative
- directories, using $SELFAUTOPARENT, whenever possible. See
- texmf/web2c/texmf.cnf for examples.
diff --git a/Master/texmf-doc/source/texlive/texlive-common/w32client/install-w32client b/Master/texmf-doc/source/texlive/texlive-common/w32client/install-w32client
deleted file mode 100755
index 0de75a465fa..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-common/w32client/install-w32client
+++ /dev/null
@@ -1,177 +0,0 @@
-#!/usr/bin/env perl
-# $Id$
-# copy this file and install-w32client.bat to the same directory
-# as texmf, texmf-dist etc.
-
-# sample mini-installer to give Windows systems access to an
-# existing TeXLive installation
-
-# it assumes a standard directory layout, which avoids hard-coded paths.
-# if this is not the case, adjustments may be necessary.
-
-$^W = 1;
-
-use TeXLive::TLUtils qw(mkdirhier);
-use TeXLive::TLWinGoo qw(non_admin add_texbindir_to_path setenv_reg
- init_unshortbat add_desktop_shortcut add_menu_shortcut
- register_extension register_file_type
- update_assocs broadcast_env
- create_uninstaller);
-use strict;
-
-# the code below assumes that this script is in $texdir,
-# the directory above texmf, texmf-dist etc.
-
-my $texdir=$0;
-$texdir=~s!\\!/!g;
-$texdir=~s!(.*)/.*$!$1!;
-
-# private runtime-generated files
-$::texlive_release = '2008';
-my $texdirw = $ENV{'USERPROFILE'}.'/.texlive'.$::texlive_release;
-$texdirw=~s!\\!/!g;
-my $private_var = $texdirw.'/texmf-var';
-my $private_var_bsl = $private_var;
-$private_var_bsl =~ s!/!\\!g;
-
-# make only per-user modifications
-non_admin();
-
-# general
-
-add_texbindir_to_path($texdir.'/bin/win32');
-broadcast_env();
-
-my $mainmenu = "TeX Live 2008";
-my $texbindir_bsl = $texdir.'/bin/win32';
-$texbindir_bsl =~ s!/!\\!g;
-
-mkdirhier("$texdirw/tlpkg/installer");
-create_uninstaller($texdir, $texdirw, $private_var, $texdirw.'/texmf-config');
-init_unshortbat($texdirw);
-
-# if the path can't be fixed globally add command prompt
-# with texbindir prepended to path
-
-if (uc(TeXLive::TLWinGoo::win_which_dir('tex.exe')) ne
- uc($texdir.'/bin/win32') or
- uc(TeXLive::TLWinGoo::win_which_dir('pdftex.exe')) ne
- uc($texdir.'/bin/win32') or
- uc(TeXLive::TLWinGoo::win_which_dir('luatex.exe')) ne
- uc($texdir.'/bin/win32')) {
- add_menu_shortcut(
- $mainmenu,
- 'TeX Live Prompt',
- '',
- $ENV{'COMSPEC'},
- "/k \"path $texbindir_bsl;%path%\"",
- '',
- );
-}
-
-# texlive manual
-
-add_menu_shortcut(
- $mainmenu,
- 'TeX Live Manual (en)',
- '', # default pdf icon
- $texdir.'/texmf-doc/doc/english/texlive-en/texlive-en.pdf',
- '',
- '',
-);
-
-# texdoctk documentation browser
-
-if (-e $texdir.'/bin/win32/texdoctk.bat') {
- add_menu_shortcut(
- $mainmenu,
- 'TeXdoc GUI',
- '', # icon
- $texdir.'/bin/win32/texdoctk.bat',
- '', # arguments
- 'batgui', # any non-null value to hide command-prompt
- )
-}
-
-# psview
-
-add_desktop_shortcut(
- $texdirw,
- 'PS_View',
- $texdir.'/tlpkg/tlpsv/psv.exe', # icon, not prog!
- $texdir.'/bin/win32/psv.bat',
- '', # no args
- 'batgui', # any non-null value to hide command-prompt
-);
-add_menu_shortcut(
- $mainmenu,
- 'PS_View',
- $texdir.'/tlpkg/tlpsv/psv.exe', # icon, not prog!
- $texdir.'/bin/win32/psv.bat',
- '', # no args
- 'batgui', # any non-null value to hide command-prompt
-);
-# comment out if you prefer gsview
-register_extension(".ps", "PostScript");
-register_extension(".eps", "PostScript");
-register_file_type("PostScript",
- '"'.$texdir.'/tlpkg/tlpsv/gswxlua.exe" -g '.
- '"'.$texdir.'/tlpkg/tlgs/bin/gsdll32.dll" -l '.
- '"'.$texdir.'/tlpkg/tlpsv/psv.wx.lua" -p '.
- '"'.$texdir.'/tlpkg/tlpsv/psv_view.ps" -sINPUT="%1"');
-update_assocs();
-
-# dviout
-
-add_menu_shortcut(
- $mainmenu,
- 'DVIOUT',
- $texdir.'/tlpkg/dviout/dviout.exe',
- 'wscript',
- $texdir."/bin/win32/dviout.vbs",
- '',
-);
-
-# xetex
-
-if (-e $texdir.'/bin/win32/xetex.exe') {
- my $xetexmfcnf = $private_var.'/web2c';
- my $texmfcnf = $xetexmfcnf.';'.$texdir.'/texmf/web2c';
- setenv_reg('TEXMFCNF', $texmfcnf);
- broadcast_env();
- mkdirhier($private_var."/fonts");
- system("xcopy", "/e", "/i", "/q", "/y", "\"$texbindir_bsl\\conf\"",
- "\"$private_var_bsl\\fonts\\conf\"");
- system("xcopy", "/e", "/i", "/q", "/y", "\"$texbindir_bsl\\cache\"",
- "\"$private_var_bsl\\fonts\\cache\"");
- if (open(FONTSCONF, "<$texdir/bin/win32/conf/fonts.conf")) {
- my @lines = <FONTSCONF>;
- close(FONTSCONF);
- if (open(FONTSCONF, ">$private_var/fonts/conf/fonts.conf")) {
- my $winfontdir;
- $winfontdir = $ENV{'SystemRoot'}.'/fonts';
- $winfontdir =~ s!\\!/!g;
- foreach (@lines) {
- $_ =~ s!c:/Program Files/texlive/2008!$texdir!;
- $_ =~ s!c:/windows/fonts!$winfontdir!;
- print FONTSCONF;
- }
- close(FONTSCONF);
- } else {
- warn("Cannot open $private_var/fonts/conf/fonts.conf for writing\n");
- }
- } else {
- warn ("Cannot open $texdir/bin/win32/conf/fonts.conf\n");
- }
- mkdirhier($xetexmfcnf);
- if (open(TMF, ">$xetexmfcnf/texmf.cnf")) {
- print TMF "FONTCONFIG_PATH=\$TEXMFVAR/fonts/conf\n";
- print TMF "FC_CACHEDIR=\$TEXMFVAR/fonts/cache\n";
- close TMF;
- } else {
- warn("Cannot open $xetexmfcnf/texmf.cnf for writing\n");
- }
- $ENV{'TEXMFCNF'} = $texmfcnf;
- $ENV{'PATH'} = $texbindir_bsl.';'.$ENV{'PATH'};
- system("\"$texbindir_bsl\\fc-cache.exe\"", "-v", "-r");
-}
diff --git a/Master/texmf-doc/source/texlive/texlive-common/w32client/install-w32client.bat b/Master/texmf-doc/source/texlive/texlive-common/w32client/install-w32client.bat
deleted file mode 100755
index 0d22ada6688..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-common/w32client/install-w32client.bat
+++ /dev/null
@@ -1,28 +0,0 @@
-@echo off
-
-rem copy this file and install-w32client to the same directory
-rem as texmf, texmf-dist etc.
-
-rem TeX Live Root; ends with backslash
-rem This may also work with UNC names
-
-set texdir=%~dp0
-set tldrive=%~d0
-
-%tldrive%
-cd %texdir%
-
-rem use provided Perl
-
-set PERL5SAVE=%PERL5LIB%
-set PERL5LIB=%texdir%tlpkg\tlperl\lib;%texdir%tlpkg
-"%texdir%tlpkg\tlperl\bin\perl" "%~dpn0" %*
-rem pause Done
-
-rem cleanup in case of start from command-line
-
-set PERL5LIB=%PERL5SAVE%
-set PERL5SAVE=
-set tldrive=
-set texdir=
-pause \ No newline at end of file
diff --git a/Master/texmf-doc/source/texlive/texlive-cz/Makefile b/Master/texmf-doc/source/texlive/texlive-cz/Makefile
deleted file mode 100644
index acbed97a89b..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-cz/Makefile
+++ /dev/null
@@ -1,5 +0,0 @@
-include ../texlive-en/Makefile
-doc = texlive-cz
-lang = czechslovak
-
-
diff --git a/Master/texmf-doc/source/texlive/texlive-cz/cs-tex-live.sty b/Master/texmf-doc/source/texlive/texlive-cz/cs-tex-live.sty
deleted file mode 100644
index 7e2569d7776..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-cz/cs-tex-live.sty
+++ /dev/null
@@ -1,458 +0,0 @@
-\NeedsTeXFormat{LaTeX2e}[1995/12/01]
-\ProvidesPackage{cs-tex-live}[2004/11/15 v1.22 TeX Live documentation style]
-\RequirePackage{alltt}
-\RequirePackage{array}
-\RequirePackage{colortbl}
-\RequirePackage{graphicx}
-%\RequirePackage{here}
-\RequirePackage{longtable}
-%\iftrue
-%\def\Hv@scale{.91} % to match x-height of Palatino
-%\RequirePackage{palatino}
-%\else
-\usepackage{lmodern}
-%\fi
-\RequirePackage{tabularx}
-\RequirePackage{shortvrb}
-\RequirePackage[normalem]{ulem}
-\RequirePackage[obeyspaces]{url}
-\RequirePackage{xspace}
-\usepackage[T1]{fontenc}
-\usepackage[latin2]{inputenc}
-\usepackage[czech]{babel}%
-\usepackage{csquote} % do define \uv
-\newcommand{\singleuv}[1]{,#1`}
-\newcommand{\ctt}{\url{news:comp.text.tex}}
-\newcommand{\kB}{KiB}
-\newcommand{\MB}{MiB}
-\newcommand\TKCS{\textsf{\TeX-kolekce}}
-\newcommand\ProTeXt{Pro\TeX t}
-\clubpenalty 10000
-\widowpenalty 10000
-\RequirePackage{europs}
-\let\euro\EUR
-\usepackage{comment}
-%\newcommand\ncs{\protect\NN}
-%\newcommand\NN[1]{\bgroup\color{red}#1\egroup}
-%\def\p.{s.\,}
-\def\p.{na stran\v{e}~}
-% General squeezed itemize.
-\newenvironment{itemize*}%
- {\begin{itemize}%
- \setlength{\itemsep}{0pt}%
- \setlength{\parskip}{0pt}}%
- {\end{itemize}}
-%
-% 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}\@}
-%
-\RequirePackage{fancyvrb}
-\DefineVerbatimEnvironment{verbatim}{Verbatim}{fontsize=\normalsize}
-\DefineVerbatimEnvironment{fverbatim}{Verbatim}{fontsize=\footnotesize}
-\DefineVerbatimEnvironment{sverbatim}{Verbatim}{fontsize=\small}
-\DefineVerbatimEnvironment{boxedverbatim}
- {Verbatim}{fontsize=\scriptsize,frame=single}
-\DefineVerbatimEnvironment{Verbatim}{Verbatim}{fontsize=\normalsize}
-\def\verbatiminput#1{\VerbatimInput[fontsize=\scriptsize]{#1}}
-\def\boxedverbatiminput#1{\VerbatimInput[frame=single,fontsize=\scriptsize]{#1}}
-\def\listinginput#1#2{\VerbatimInput[fontsize=\scriptsize,firstnumber=#1,numbers=left]{#2}}
-\MakeShortVerb\|
-%
-%
-% Done with packages.
-%
-% Page layout.
-\advance\textwidth by 1.1in
-\advance\oddsidemargin by -.55in
-\advance\evensidemargin by -.55in
-%
-\advance\textheight by 1in
-\advance\topmargin by -.5in
-\advance\footskip by -.5in
-\pagestyle{headings}
-%
-% LaTeX parameters.
-\renewcommand{\topfraction}{0.85}
-\renewcommand{\floatpagefraction}{0.86}
-\renewcommand{\textfraction}{0.1}
-\renewcommand{\belowcaptionskip}{4pt}
-\setcounter{tocdepth}{2}
-\setcounter{topnumber}{5}
-\setcounter{totalnumber}{5}
-%
-% linebreaking, etc.
-\pretolerance=1000
-\tolerance=1500
-\hbadness=3000
-\vbadness=3000
-\hyphenpenalty=400
-\emergencystretch=.1\hsize
-\relpenalty=500
-%
-% fonts
-\let\sl\it
-\let\slfamily\itfamily
-\let\textsl\textit
-\def\ttdefault{cmtt}
-%
-% various sorts of names
-\newcommand*{\pkgname}[1]{\textsf{#1}}% package name
-\newcommand*{\optname}[1]{\texttt{#1}}% (package,class) option name
-\newcommand*{\cmdname}[1]{\textsf{#1}}% command name
-\newcommand*{\colname}[1]{\emph{#1}}% collection name
-\newcommand*{\dirname}[1]{\path{#1}}% directory name
-\newcommand*{\filename}[1]{\path{#1}}% file name
-\newcommand*{\envname}[1]{\texttt{#1}}% environment variable name
-\newcommand{\code}[1]{\texttt{#1}}
-\newcommand{\file}[1]{\texttt{#1}}
-\newcommand{\prog}[1]{\texttt{#1}}
-\newcommand{\samp}[1]{\singleuv{\texttt{#1}}}
-\newcommand{\var}[1]{\emph{#1}}
-\newcommand{\ttvar}[1]{\texttt{\var{#1}}}
-% Include an image.
-% #1 - name of image (pictures/#1.jpg, always .jpg please)
-% #2 - bb for html
-% #3 - width for TeX
-%
-\def\tlimage#1#2#3{%
- \ifnum \Status=2 % html
- \includegraphics[#2]{pictures/#1.jpg} \\[5mm]
- \else % not html
- \includegraphics[width=#3]{pictures/#1} \\[5mm]
- \fi
-}
-
-\def\tlpng#1#2{%
- \ifnum \Status=2 % html, want relative path in output
- \includegraphics[bb=0 0 1 1]{#1.png}%
- \else % not html, handled by TEXINPUTS in Makefile
- \includegraphics[width=#2]{#1.png}%
- \fi
-}
-
-% underlined command input.
-\def\Ucom#1{%
- \uline{\rule[-.2\baselineskip]{0pt}{.9\baselineskip}\ttfamily #1}}
-\def\CDref#1#2{\href{../../../../#1}{#2}}
-\def\OnCD#1{\href{../../../../#1}{\path{#1}}}
-%\def\OnCD#1{\hyper@linkurl{\path{#1}}{../../../../#1}}
-% GUI menu/button/tab sequence:
-\def\guiseq#1{\textsf{#1}}
-\def\arw{\unskip\discretionary{\hbox{$\rightarrow$}}{\hbox{$\rightarrow$}}{\hbox{$\rightarrow$}}\ignorespaces}
-%
-% Special names.
-\def\dpi{$\,$dpi\xspace}
-\def\bs{{\protect\normalfont\ttfamily\char'134}}
-\DeclareRobustCommand{\cs}[1]{{\normalfont\ttfamily\char`\\#1}}
-\def\Q#1{\par\vskip6pt\leftline{#1}\par}
-\def\hyph{-}
-%
-% many abbreviations.
-\newcommand{\CS}{$\mathcal{C}\kern-.1667em\lower.5ex%
- \hbox{$\mathcal{S}$}\kern-.075em $}
-\def\AFMtoTFM{\cmdname{AFM2TFM}\null}
-\def\bv{\emph{Baskerville}}
-\let\BV=\bv
-\def\Dash{\unskip\nobreak\thinspace--\thinspace\ignorespaces}
-\def\dvicopy{\cmdname{dvicopy}}
-\def\dvidvi{\cmdname{dvidvi}}
-\def\dvips{\cmdname{dvips}}
-\def\eTeX{$\varepsilon$-\TeX}
-\def\fpTeX{\textrm{fp}\TeX\xspace}
-\def\GFtoDVI{\cmdname{GFtoDVI}\null}
-\def\GFtoPK{\cmdname{GFtoPK}\null}
-\def\GFtype{\cmdname{GFtype}}
-\def\GUI{\acro{GUI}\xspace}
-\def\KPS{Kpathsea}
-\def\La{La}
-\def\OMEGA{$\Omega$}
-\def\OzMF{OzMF}
-\def\OzMP{OzMP}
-\def\OzTeX{O\kern-.03em z\kern-.15em\TeX}
-\def\PKtype{\cmdname{PKtype}}
-\def\PLtoTF{\cmdname{PLtoTF}\null}
-\def\teTeX{\textrm{te}\TeX\xspace}
-\def\TeXLive{\TeX{} Live\xspace}
-\let\TL=\TeXLive
-\def\TFtoPL{\cmdname{TFtoPL}\null}
-\def\TK{\textsf{\TeX-Collection}}
-\def\TypeI{Type~1}
-\def\VFtoVP{\cmdname{VFtoVP}\null}
-\def\VPtoVF{\cmdname{VPtoVF}\null}
-\def\Thanh{H\`an~Th\^e\llap{\raise 0.5ex\hbox{\'{}}}~Th\`anh}
-\def\XEmTeX{\textrm{XEm}\TeX\xspace}
-\def\XEmacs{\textrm{XEmacs}\xspace}
-\def\Webc{Web2C}
-\providecommand*{\CD}{\acro{CD}\xspace}
-\providecommand*{\CTAN}{\acro{CTAN}\xspace}
-\providecommand*{\DVD}{\acro{DVD}\xspace}
-\providecommand*{\GNU}{\acro{GNU}\xspace}
-\providecommand*{\HTML}{\acro{HTML}\xspace}
-\providecommand*{\ISO}{\acro{ISO}\xspace}
-%\providecommand*{\MacOSX}{Mac\-\acro{OSX}\xspace}
-\providecommand*{\MacOSX}{Mac\,\acro{OS\,X}\xspace}
-\providecommand*{\PS}{Post\-Script\xspace}
-\providecommand*{\GS}{Ghost\-script\xspace}
-\providecommand*{\TDS}{\acro{TDS}\xspace}
-\providecommand*{\dvi}{\acro{DVI}\xspace}
-\providecommand*{\web}{\texttt{web}\xspace}
-%
-% description-like environment that uses tt instead of bf, and doesn't
-% go to the left margin. Without the \hfil, get an underfull box.
-% Don't why \descriptionlabel doesn't.
-\newenvironment{ttdescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt % these lists tend to have short descriptions
- \let\makelabel=\ttdescriptionlabel}}%
- {\end{list}}
-\newcommand*\ttdescriptionlabel[1]{\hspace\labelsep
- \normalfont\ttfamily #1\hfil}
-%
-% Likewise, for commands using sans serif.
-\newenvironment{cmddescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt
- \let\makelabel=\cmddescriptionlabel}}%
- {\end{list}}
-\newcommand*\cmddescriptionlabel[1]{%%\hspace\labelsep
- \normalfont\sffamily #1\hfil}
-%
-\newlength\tmplen
-\newsavebox{\wbox}
-\newenvironment{warningbox}%
- {\fboxsep .017\textwidth
- \begin{lrbox}{\wbox}
- \setlength{\tmplen}{\textwidth}%
- \addtolength{\tmplen}{-2\fboxsep}%
- \addtolength{\tmplen}{-.8pt}% twolines
- \begin{minipage}{\tmplen}}
- {\end{minipage}\end{lrbox}%
- \bgroup\centering\fbox{\usebox{\wbox}}\egroup}
-%
-% lrbox is used as a representation marking. I changed it to
-% lrBox in tne source file, to get closer to logical marking
-\newsavebox{\mylrbox}
-\newenvironment{lrBox}
- {\begin{lrbox}{\mylrbox}}
- {\end{lrbox}}
-%
-%
-% output setup
-%
-\newif\ifSingleColumn
-\providecommand{\Status}{0}
-\typeout{Status is \Status, e.g.: }
-%
-% By default, we won't be creating hyperlinks.
-\def\href#1#2{#2}
-\def\hypertarget#1#2{}
-\def\email#1{\href{mailto:#1}{\path{#1}}} % \path comes from url
-\RequirePackage{texnames}
-\ifx\PiC\undefined \def\PiC{P\kern-.12em\lower.5ex\hbox{I}\kern-.075emC} \fi
-\ifx\PiCTeX\undefined \def\PiCTeX{\PiC\kern-.11em\TeX} \fi
-%
-%
-\ifcase\Status
- % \Status = 0
- \typeout{TeX Live documentation for printing}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 1
- \typeout{TeX Live documentation in PDF format}
- \RequirePackage[colorlinks,bookmarksopen,
- pdfstartview={FitBH -320000},hyperindex]{hyperref}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 2
- \typeout{TeX Live documentation in HTML format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- % read our config file, live4ht.cfg; q.v., for more definitions.
- % hyperref load must come after the tex4ht load.
- \RequirePackage[live4ht]{tex4ht}
- \RequirePackage[tex4ht]{hyperref} \hyperlinkfileprefix{}
- \def\CDref#1#2{\href{../../../../#1}{#2}}
- \def\OnCD#1{\href{../../../../#1}{#1}}
- \or
- % \Status = 3
- \typeout{TeX Live documentation as a Zpravodaj issue!}
- \RequirePackage{zpravodaj}% outline of Zpravodaj
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 4
- \typeout{TeX Live documentation as a TUB article}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \SingleColumnfalse
- \newenvironment{multicols}[1]{}{}
-\fi
-%
-\ifnum \Status=4
-\else
- %\RequirePackage{texnames}
- \newcommand\ConTeXt{C\kern-.0333emon\-\kern-.0667em\TeX\kern-.0333emt}
- \newcommand\MIKTEX{MiK\kern-.025em \TeX}% per www.miktex.org
- \providecommand\TeXXeT{\TeX-{}-%
- \kern-.1emX\kern-.125em\lower.5ex\hbox{E}\kern-.1667emT\@}
-\fi
-%
-% hacking at sections etc., to pay attention to baskerville status
-\newcommand{\@condend@multicols}{%
- \ifSingleColumn
- \else
- \def\@tempa{multicols}%
- \ifx\@tempa\@currenvir
- \end{multicols}%
- \fi
- \fi
-}
-\let\Section\section
-\renewcommand{\section}{%
- \@ifstar
- {\Section*}%
- {%
- \@condend@multicols
- \@dblarg\@full@section
- }%
-}
-\def\@full@section[#1]#2{%
- \Section[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-\let\SubSection\subsection
-\renewcommand{\subsection}{%
- \@ifstar{\SubSection*}%
- {%
- \@condend@multicols
- \@dblarg\@full@subsection
- }
-}
-\def\@full@subsection[#1]#2{%
- \SubSection[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-
-% calm things down a bit if we're in a multiple-column version
-\ifSingleColumn
-\else
- \def\@listI{\leftmargin\leftmargini
- \parsep \z@
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \itemsep \z@ \@plus .1\p@
- }
- \let\@listi\@listI
- \@listi
- \def\@listii{\leftmargin\leftmarginii
- \labelwidth\leftmarginii\advance\labelwidth-\labelsep
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \itemsep \z@ \@plus .1\p@
- }
- \def\@listiii{\leftmargin\leftmarginiii
- \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
- \topsep 1\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \partopsep \z@
- \itemsep \topsep
- }
- \def\@listiv{\leftmargin\leftmarginiv
- \labelwidth\leftmarginiv\advance\labelwidth-\labelsep
- }
- \def\@listv{\leftmargin\leftmarginv
- \labelwidth\leftmarginv\advance\labelwidth-\labelsep
- }
- \def\@listvi{\leftmargin\leftmarginvi
- \labelwidth\leftmarginvi\advance\labelwidth-\labelsep
- }
-\fi
-%
-% array package stuff
-\def\arraybackslash{\let\\=\@arraycr}
-\newcolumntype{P}[1]{>{\raggedright\arraybackslash}p{#1}}
-%
-% shaded rows (using facilities of colortbl)
-%
-\definecolor{pale}{gray}{.9}
-\newcount\colrow
-\gdef\RowColor{pale}
-\def\SetRowColor{%
- \rowcolor{\RowColor}%
- \global\advance\colrow by1\relax
- \ifodd\colrow
- \gdef\RowColor{pale}%
- \else
- \gdef\RowColor{white}%
- \fi
-}
-% redefine to hack up a reference even though we don't need it...
-\renewcommand\@bibitem[1]{\if@filesw \immediate\write\@auxout
- {\string\bibcite{#1}{?}}\fi\ignorespaces}
-%
-% \unknownTeXlive is a dummy texlive entry for the biblio
-\newcommand\unknownTeXlive[2][\relax]{\textbf{\textsc{unknown}}%
- \global\@all@unknown\expandafter{\the\@all@unknown{#2}}%
-}
-\newtoks\@all@unknown
-\global\@all@unknown{}
-\AtEndDocument{\@message@unknowns}
-\def\@message@unknowns{\edef\@tempa{\the\@all@unknown}%
- \ifx\@tempa\@empty
- \else
- \def\@tempa{*** TeX live package location of }%
- \expandafter\@output@unknowns\the\@all@unknown\@empty
- \fi
-}
-\def\@output@unknowns#1{\edef\@tempb{#1}%
- \ifx\@tempb\@empty
- \typeout{ unknown}%
- \else
- \message{\@tempa#1,}%
- \def\@tempa{}%
- \expandafter\@output@unknowns
- \fi
-}
-%
-% a hack for the bibliography
-\bibliographystyle{tex-live}
-\newif\iffirstbibentry
-\global\firstbibentrytrue
-\let\@@bibitem\bibitem
-\renewcommand\bibitem{\iffirstbibentry
- \global\firstbibentryfalse
- \else
- \\\SetRowColor
- \fi
- \@@bibitem
-}
-
-
-% for \Dings
-\RequirePackage{pifont}
-% available for inter-article dinglines
-\def\Dings{\nopagebreak{\footnotesize\dingline{167}}}
-
-\ifnum \Status=3
-\newfont\fontmanual{logo10} % font used for the METAFONT logo, etc.
-\renewcommand\MF{{\fontmanual META}\-{\fontmanual FONT}\spacefactor1000 }
-\renewcommand\MP{{\fontmanual META}\-{\fontmanual POST}\spacefactor1000 }
-\else
-\RequirePackage{mflogo}
-%\newfont\fontmanual{logo10} % font used for the METAFONT logo, etc.
-%\newcommand\MF{{\fontmanual META}\-{\fontmanual FONT}\spacefactor1000 }
-%\newcommand\MP{{\fontmanual META}\-{\fontmanual POST}\spacefactor1000 }
-\fi
-
-% Silence font warnings about no bold typewriter in LM.
-\def\@font@warning#1{}%
-
-% Silence hyperref warnings about \kern.
-\def\HyPsd@Warning#1{}%
-
-\endinput
diff --git a/Master/texmf-doc/source/texlive/texlive-cz/csquote.sty b/Master/texmf-doc/source/texlive/texlive-cz/csquote.sty
deleted file mode 100644
index 3644143647b..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-cz/csquote.sty
+++ /dev/null
@@ -1,181 +0,0 @@
-%%%%%%%%%%%%%%%%%%%%%% cut here %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%
-% File: CSQUOTE.TEX/STY
-% Version: 1.1
-%
-% Authors: Hunter Goatley <goathunter@wkuvx1.bitnet>
-% (parts from QUOTE.TEX/STY)
-% Petr Sojka <sojka@ics.muni.cs>
-%
-% Warranty:
-%
-% Copyright (c) 1992 by Hunter Goatley, Petr Sojka
-% Permission to copy all or part of this work is granted, provided
-% that the copies are not made or distributed for resale, and that
-% the copyright notice and this notice are retained.
-%
-% THIS WORK IS PROVIDED ON AN "AS IS" BASIS. THE AUTHOR PROVIDES NO
-% WARRANTY WHATSOEVER, EITHER EXPRESS OR IMPLIED, REGARDING THE WORK,
-% INCLUDING WARRANTIES WITH RESPECT TO ITS MERCHANTABILITY OR FITNESS
-% FOR ANY PARTICULAR PURPOSE.
-%
-% If you make any improvements, I'd like to hear about them.
-%
-% History:
-%
-% Oct 26, 92 - V1.0 first release
-% Dec 14, 92 - V1.1 \uv added
-%
-% Abstract:
-%
-% This file defines the macros \csdoublequoteson and \csdoublequotesoff.
-% These macros allows switching between standard and following behaviour:
-% TeX replace the double-quote character (") with Czech
-% left and right double-quotes. For example:
-%
-% "This is a test." ---> ,,This is a test.''
-%
-% The double-quote character is still available via \dq.
-% \" is still treated as the umlaut accent.
-%
-% This macro makes a couple of assumptions about the double-quotes:
-%
-% 1. Double-quotes are assumed to come in pairs. When replacing
-% double-quotes, the macro alternates between ,, and ''. The only
-% exception to this is noted in (2) below.
-% 2. A double-quote at the beginning of a paragraph is always treated
-% as ,,. This correctly handles the case where a quotation is
-% continued into a second paragraph:
-%
-% "This is the first paragraph.\par
-% "This is the second paragraph of the same quote."
-%
-% Normal TeX spacing after ,, and '' is maintained by saving and
-% restoring the \spacefactor.
-%
-% Macros work both with plainTex and LaTeX.
-%
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%
-% HOW IT WORKS:
-%
-% The double-quote character (") is made active by \csdoublequoteson.
-% The " macro keeps track of left-quote/right-quote pairs and inserts
-% the appropriate ,, and '' in its place.
-%
-% Each character has a \spacefactor associated with it, which specifies
-% the amount of stretch or shrink that a space following the character
-% can have. Most characters have a factor of 1000, but some punctuation
-% marks have higher spacefactors, most notably the period, which has a
-% \spacefactor of 3000. This means the space following a period can
-% stretch up to 3 times more than the space after a regular character,
-% accounting for the increased space at the end of sentences.
-%
-% The ,, and '' ligatures are assigned \spacefactor's of 0, so that the
-% \spacefactor that is applied to the next character is the same as that
-% of the character preceding the quotes. Because " has been redefined as
-% a macro, any spaces following " are swallowed by TeX. It was necessary
-% to have this macro re-insert any needed space so that the following
-% cases worked correctly:
-%
-% "This is a test," she said. --> ,,This is a test,'' she said.
-% "This is in a list"; etc. --> ,,This is in a list''; etc.
-%
-% Without the added space, the first example becomes:
-%
-% ,,This is a test,''she said.
-%
-% The solution was to save the current \spacefactor before inserting a
-% right double-quote, then resetting the \spacefactor after the
-% insertion. The net effect was that the " macro has a \spacefactor
-% of 0, which matches the way TeX treats ,, and ''.
-%
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-{% % Begin a group for which " is active
-\catcode`\"=\active % Make " an active character
-\catcode`\@=11 % Make @ an active character
-%
-% \csdoublequoteson
-%
-% This macro makes " an active character, resets the control sequence
-% \dblqu@te to L (left), and defines \dq as a replacement for ".
-%
-\gdef\csdoublequoteson{% % \csdoublequoteson enables "
- \gdef"{\czechquotes}% % Define " as \czechquotes
- \global\catcode`\"=\active% % Make " an active character
- \global\chardef\dq=`\"% % Double-quote char. via \dq
- \global\let\dblqu@te=L% % Always start with a left double-quote
- } % End of macro
-%
-% \bq, \eq
-%
-% These macros define default characters for czech left and right
-% double quotes. Czech opening quote is created from two commas with
-% kerning depending on fontdimen four parameter of current font.
-% Better solution should be specially designed character with
-% proper kernings; if you have such characters in fonts
-% (e.g. in DC-fonts), use it instead. (e.g. define
-% macros \bq and \eq e.g. \def\bq{\char"130 }
-% in your document/style file-- not in csquote.sty!)
-% Similar solution is used for czech right quote.
-%
-% \cs existence test, stolen from TeXbook exercise 7.7
-\def\ifundefined#1{\expandafter\ifx\csname#1\endcsname\relax }%
-%
-% another macro to be more efficient in time and space
-\global\chardef\f@@r=4
-%
-\ifundefined{bq}%
-\gdef\bq{\kern-.25\fontdimen\f@@r\font,\kern-.8\fontdimen\f@@r\font,%
- \kern-.35\fontdimen\f@@r\font}%
-\fi
-\ifundefined{eq}%
-\gdef\eq{\kern-.35\fontdimen\f@@r\font`\kern-.8\fontdimen\f@@r\font`%
- \kern-.25\fontdimen\f@@r\font}
-\fi
-%
-% Macro \uv for other usage of \bq and \eq.
-%
-\ifundefined{uv}%
- \gdef\uv#1{\bq #1\eq}
-\fi
-%
-% Define the macro that will be executed whenever " is encountered.
-%
-\gdef\czechquotes{%
- % If the double-quote is the first character in a new paragraph,
- % make sure it becomes a left double-quote. This case can be
- % detected by checking to see if TeX is currently in vertical mode.
- % If so, the double-quote is at the beginning of the paragraph
- % (since " hasn't actually generated any horizontal mode tokens
- % yet, TeX is still in vertical mode). If the mode is vertical,
- % set \dblqu@te equal to L.
- %
- \ifinner\else\ifvmode\let\dblqu@te=L\fi\fi%
- %
- % Now insert the appropriate left or right double-quote.
- %
- % If \dblqu@te is L, insert an opening quote and set \dblqu@te to R.
- %
- \if L\dblqu@te\bq\global\let\dblqu@te=R%
- %
- % Otherwise, save the current \spacefactor, insert '', set \dblqu@te
- % to L, and reset the original \spacefactor.
- %
- \else%
- \let\xxx=\spacefactor% % Save the \spacefactor
- \eq% % Insert ending quote
- \global\let\dblqu@te=L% % and reset \dblqu@te
- \spacefactor\xxx% % Reset the \spacefactor
- \fi% % End of \if L\dblqu@te...
- } % End of " macro
-} % End of group
-
-\gdef\csdoublequotesoff{%
- \catcode`\"=12% % Set " back to other
- }
-%
-% Czech quotes are default
-%
-\csdoublequoteson
-
diff --git a/Master/texmf-doc/source/texlive/texlive-cz/live4ht.cfg b/Master/texmf-doc/source/texlive/texlive-cz/live4ht.cfg
deleted file mode 100644
index 3fa6506696b..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-cz/live4ht.cfg
+++ /dev/null
@@ -1,47 +0,0 @@
-% tex4ht configuration file for the TeX Live documentation.
-% Accumulated over many years. Public domain.
-%
-% html specifies the main output format.
-% info for extra debugging info in the log files.
-
-% better approach is to have html in one piece (including footnotes).
-% also the newest TeX4ht could produce UTF-8 output (-utf8 option)
-\Preamble{charset=iso-8859-2,html,info,fn-in}
-
-% add extra stylesheet
-\Configure{@HEAD}{\HCode{%
-<link rel="stylesheet" type="text/css" href="\jobname.css" />\Hnewline
-<link rel="stylesheet" type="text/css" href="tex-live.css" />\Hnewline
-}}
-
-% or LaTeX complains it is missing.
-\begin{document}
-
-\EndPreamble
-
-% simplify output for HTML. We leave TeX and LaTeX alone, since tex4ht
-% actually does the lowered E (and raised A) in CSS.
-\def\OMEGA{Omega}
-\def\LaTeXe{LaTeX2e}
-\def\eTeX{e-\TeX}
-\def\acro#1{#1}
-\def\MF{Metafont}
-\def\BibTeX{BibTeX}
-\def\warningbox{}
-\def\endwarningbox{}
-
-\newif\ifhackliterals
-\ifx\tldocenglish\undefined \else \hackliteralstrue \fi
-\ifx\tldocrussian\undefined \else \hackliteralstrue \fi
-\ifx\tldocgerman\undefined \else \hackliteralstrue \fi
-%
-\ifhackliterals
- % these definitions cause "missing } inserted" at \end{tabularx} in
- % French and Czech. don't know why.
- %
- % don't make these into links, as happens with \path. We only have a couple
- % special characters that actually occur.
- \def\dirname{\texttt\bgroup\catcode`\$=12 \catcode`\_=12 \finishliteral}
- \def\finishliteral#1{#1\egroup}
- \let\filename=\dirname
-\fi
diff --git a/Master/texmf-doc/source/texlive/texlive-cz/texlive-cz.tex b/Master/texmf-doc/source/texlive/texlive-cz/texlive-cz.tex
deleted file mode 100644
index 77d8ed9ea5e..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-cz/texlive-cz.tex
+++ /dev/null
@@ -1,3030 +0,0 @@
-%
-% czechslovak/live.tex - TeXlive 2008 documentation -- Czech/Slovak translation
-%
-% TeX Live documentation. Originally written by Sebastian Rahtz and
-% Michel Goossens, now maintained by Karl Berry and others.
-% Public domain.
-%
-% 2008/08/12: v1.34 prvni korektury prekladu 2008
-% 2008/08/02: v1.33 aktualizacia prekladu 2008
-% 2007/01/24: v1.32 XeTeX URL and HH (config.manpath) change
-% 2007/01/22: v1.31 last minute corrections by Staszek (2x) and ZW
-% 2007/01/15: v1.30 corrections and typos
-% 2007/01/14: v1.29 texlive2007 version (JB&PS)
-% 2005/11/01: v1.28 last minute Staszek additions
-% 2005/10/31: v1.27 texlive2005 version (JB&PS)
-% 2004/11/18: v1.26 final release cleanup, latest changes by Staszek
-% 2004/11/17: v1.24,25 typos corrected
-% 2004/11/15: v1.21,22,23 corrections by KB, JB and others entered
-% 2004/11/14: v1.20 first texlive2004 version (JB&PS)
-% 2004/01/30: v1.19 postbulletin version release for CSTUG web
-% 2004/01/22: v1.18 minor changes before final-2003 source release
-% 2004/01/19: v1.16, v1.17 last-minute corrections before sending
-% Bulletin to print
-% 2004/01/18: modifications for CS bulletin by Z. Wagner
-% 2004/01/07: version 1.15
-% 2003/12/08-10: Slovak and other Czech typos corrected
-% 2003/12/06: Czech language typos/errors entered
-% 2003/09/23: prepositions checked, v1.03
-% 2003/09/23: some typos, jch's email, v1.02
-% 2003/09/22: further error corrections, v1.01
-% 2003/09/18: final checking and error corrections, v1.0 release
-% 2003/09/17: another changes in English version incorporated
-% 2003/09/08: changes in English version from 09/04 to 09/06 incorporated
-% 2003/09/06: fixes from Staszek
-% 2003/09/05: touched by Karl
-% 2003/09/04: fixes from Staszek and Fabrice
-% 2003/09/05: translation started from english version as of Sep 1st by
-% Petra & Petr S.
-% 2003/09/01: fixes from Volker.
-% 2003/08/12: fixes from Christer Gustafsson <gustaf@powertech.no>.
-% 2003/07/07: substantial revisions by karl.
-% ... deleted
-%
-% TODO
-%
-% -- Priklady ve slovenske casti aktualizovat z~anglicke verze
-% (zustaly dosud z verze TeXlive 6).
-%
-% Translations:
-% Copyright (c) 2003--2008 Petr Sojka
-% Copyright (c) 2004--2008 Jn Bua
-% Copyright (c) 2003 Petra Sojkov
-% Copyright (c) 2001 Janka Chlebkov
-% Permission is granted to copy, distribute and/or modify this document
-% under the terms of the GNU Free Documentation License, Version 1.2
-% or any later version published by the Free Software Foundation;
-% with no Invariant Sections, no Front-Cover Texts, and no
-% Back-Cover Texts. A copy of the license is included in
-% the section entitled "GNU Free Documentation License".
-
-\newif\ifforbulletin
-\forbulletinfalse
-%\forbulletintrue
-\newcommand\cstlversion{1.34}
-\newcommand\cstldate{12.\ srpna 2008}
-\ifforbulletin
- \providecommand\Status{3} % version for CSTUG bulletin Zpravodaj
- \else
- \providecommand\Status{1} % 2 html alebo 1 pdf
-\fi
-%
-\ifnum\Status=2 % e.g. html generation via tex4ht
- \def\classname{article} % need different doc class for html
- \def\classoptions{11pt}
-\else
- \ifnum\Status=3 % Zpravodaj
- \def\classname{article}
- \def\classoptions{twoside,a5paper}
-% \pdfpaperwidth=147.5mm
-% \pdfpaperheight=210mm
- \else \def\classname{artikel1}
- \def\classoptions{11pt}
- \fi
-\fi
-
-\listfiles
-\documentclass[\classoptions,slovak,english,czech]{\classname}
-\usepackage{cs-tex-live}
-\makeatletter
-\newcommand\tubreflect[1]{%
- \@ifundefined{reflectbox}{%
- \message{A graphics package must be loaded for \string\XeTeX}%
- }{%
- \ifdim \fontdimen1\font>0pt
- \raise 1.75ex \hbox{\kern.1em\rotatebox{180}{#1}}\kern-.1em
- \else
- \reflectbox{#1}%
- \fi
- }%
-}
-\def\tubhideheight#1{\setbox0=\hbox{#1}\ht0=0pt \dp0=0pt \box0 }
-\def\XeTeX{\leavevmode
- \tubhideheight{\hbox{X%
- \lower.5ex \hbox{\kern-.125em\tubreflect{E}}%
- \kern-.1667em \TeX}}}
-\makeatother
-
-\begin{document}
-\ifnum\Status=2
- % this ugliness is because the normal definition of ' for tex4ht
- % tries to go into math mode. I don't under
- \def'{\char`\'}
-\fi
-
-\selectlanguage{czech}
-\title{{\huge\textsf{\TL{} 2008}}\\[3mm]
- Pruka \protect\TeXLive{}, CS verze \cstlversion}
-\date{\cstldate}
-
-\author{Karl Berry, editor \\[3mm]
- \url{http://tug.org/texlive/}\\[3mm]
-%B% \ifnum \Status=2
-%B% \includegraphics[bb=0 0 824 741]{../pictures/front} \\[5mm]
-%B%\else
-%B%\ifnum \Status=3
-%B% \includegraphics[width=.5\linewidth]{../pictures/bw-front2} \\[5mm]
-%B%\else
-%B% \includegraphics[width=.5\linewidth]{../pictures/front} \\[5mm]
-%B%\fi \fi
-%B% \small \textit{Kontaktn osoby pro tuto dokumentaci:}\\[3mm]
-%B% \small \begin{tabular}{lcr}
-%B% Czech/Slovak & Petr Sojka & \email{sojka (at) fi.muni.cz} \\
-%B% & Janka Chlebkov & \email{chlebikj (at) dcs.fmph.uniba.sk} \\
-%B% & Jn Bua & \email{jan.busa (at) tuke.sk} \\
-%B% English & Karl Berry & \email{karl (at) freefriends.org} \\
-%B% French & Fabrice Popineau & \email{fabrice.popineau (at) supelec.fr} \\
-%B% German & Volker R.\,W.\ Schaa & \email{volker (at) dante.de} \\
-%B% Polish & Staszek Wawrykiewicz & \email{staw (at) gust.org.pl} \\
-%B% Russian & Boris Veytsman & \email{borisv (at) lk.net}
-%B% \end{tabular}
-% \tlimage{front}{bb=0 0 824 741}{.7\linewidth}
- }
-
-% comes out too close to the toc, and we know it's page one anyway.
-\thispagestyle{empty}
-\maketitle
-
-\ifnum\Status=3
- \thispagestyle{csbul}
- \ifforbulletin \setcounter{page}{113} % valid for 3-4/2003
- \else \raggedbottom
- \fi
-\fi
-
- Peklad
- 2004--2008 J\'an Bu\v{s}a,
- 2001 Janka Chleb\'\i kov\'a,
- 2003--2008 Petr Sojka a
- 2003 Petra Sojkov\'a
- je en pod GNU FDL licenc.
-
- Permission is granted to copy, distribute and/or modify this document
- under the terms of the GNU Free Documentation License, Version 1.2
- or any later version published by the Free Software Foundation;
- with no Invariant Sections, no Front-Cover Texts, and no
- Back-Cover Texts.
-
-\begin{multicols}{2}
-\tableofcontents
-\listoftables
-\end{multicols}
-
-\section{vodem}
-\label{sec:intro}
-
-\subsection{\TeX\ Live a kolekce \TeX{}u}
-
-Tento dokument popisuje zkladn vlastnosti distribuce \TeXLive{} 2008,
-co je instalace \TeX{}u a pbuznch program pro \acro{GNU}/Linux a dal
-unixov systmy, \MacOSX{} a (32bitov) systmy Windows.
-
-
-\TL{} mete zskat staenm z~internetu, nebo na \TKCS{} \DVD,
-kter skupiny uivatel \TeX{}u distribuuj mezi svmi leny.
-Obsah tohto \DVD je strun popsn v~oddle~\ref{sec:tl-coll.dists}.
-\TL{} a \TKCS{} spolu jsou vsledkem spolenho sil
-skupin uivatel \TeX u. Tento dokument popisuje pevn samotn
-\TL{}.
-
-\TL{} obsahuje \file{.exe} soubory pro \TeX{}, \LaTeXe{}, \ConTeXt,
-\MF, \MP, \BibTeX{} a mnoho dalch program vetn obshlho
-seznamu maker, font a dokumentace spolu s~podporou
-sazby v~mnoha rznch svtovch jazycch.
-
-Aktuln verze pouitho software je v~archvu
-\acro{CTAN} na \url{http://www.ctan.org/}.
-
-Krtk seznam hlavnch zmn v~tto verzi \TL{}
-najdete na konci tohoto dokumentu, v~oddlu~\ref{sec:history}
-na stran~\pageref{sec:history}.
-
-\subsection{Podpora operanch systm}
-\label{sec:os.support}
-
-\TL{} obsahuje binrky pro etn architektury na bzi Unixu,
-vetn \MacOSX. Obsaen zdrojov texty by mly umonit instalaci
-pro platformy, pro kter nejsou k~dispozici binrky.
-
-Co se te Windows: podporovny jsou jenom Windows 2000 a pozdj verze. Upustili jsme
-od podpory Windows 9\textit{x}, ME a NT. V~dsledku tto zmny si Windows
-vyaduje mnohem mn zvltnho zachzen ve srovnn s~Unixovmi
-systmy. Pro Windows nejsou k~dispozici 64bitov \file{.exe} soubory, ale
-32bitov binrky by mly bet na 64bitovch systmech.
-
-Alternativn een pro Windows a \MacOSX{} najdete
-v~oddle~\ref{sec:tl-coll.dists}.
-
-\subsection{Zkladn instalace \protect\TL{}}
-\label{sec:basic}
-
-\TL{} mete nainstalovat bu z~\DVD{} nebo z~internetu. Samotn sov
-instalan program je mal a ve poadovan sthne z~internetu. Sov
-instalan program je vhodn pout, kdy potebujete jenom st
-z~kompletn instalace \TL.
-
-Instalan program na \DVD{} vm umon instalaci na loklnm disku, avak \TL{} mete spustit pmo z~\DVD{}
-(nebo z~obrazu \DVD{}, kdy to v systm podporuje).
-
-\noindent Toto je popsan detailn
-v~nsledujcch sekcch, zde jen souhrn:
-
-\begin{itemize*}
-\item Instalan dvka se jmenuje \filename{install-tl}\,.
-Funguje v~reimu \GUI{} (pedvolba pro Windows) i v~textovm reimu (pedvolenm pro vechny ostatn systmy).
-Jednotliv reimy doshnete volbou \code{-gui} nebo \code{-no-gui}.
-
-\item Jednou soust instalace je nov program, `\TL\ Manager', nazvan \prog{tlmgr}.
- Podobn jako instalan program me bt pouit v~reimu \GUI{} nebo v~textovm reimu.
- Mete ho pout k~nainstalovn nebo odinstalovn balk a na rzn konfiguran innosti.
-\end{itemize*}
-
-\subsection{Npovda}
-\label{sec:help}
-
-\TeX{}ovsk komunita je aktivn, vstcn a vtina
-seriznch otzek je obvykle zodpovzena. Podpora je
-neformln, je provdna pleitostnmi teni a dobrovolnky,
-a proto je dleit, abyste odpov na svj dotaz hledali nejdve sami,
-ne ho vznesete na fru. (Pokud toute po garantovan komern podpoe,
-mete na \TL{} zapomenout a zakoupit komern distribuci; viz
-seznam prodejc\r u na \url{http://tug.org/interest.html#vendors}.)
-
-Ne je uveden seznam informanch zdroj, piblin v~poad, ve kterm
-ho doporuujeme k~pouit:
-
-\begin{description}
-\item [prvn kroky] Pokud jste \TeX ovsk novek, na strnce
-\url{http://tug.org/begin.html} najdete krtk vod do systmu.
-\item [\TeX{} \acro{FAQ}] \TeX{} \acro{FAQ} je obrovsk studnice
- znalost obsahuj\'ic\'i vechny druhy otzek, od tch zkladnch a po
- ty nejobskurnj.
- Dokument najdete na \TL{} v~adresi \OnCD{texmf-doc/doc/english/FAQ-en/html/index.html}
- nebo na internetu na \url{http://www.tex.ac.uk/faq}. Prosme, zante
- sv hledn odpovdi zde.
-
-\item [\TeX{} Catalogue] Pokud hledte konkrtn balk,
- font, program ap., \TeX{} Catalogue je msto, kde zat.
- Je to obshl sbrka \TeX{}ovch poloek. Viz
- \OnCD{http://www.ctan.org/help/Catalogue/}.
-
-\item [\TeX{}ov\'e odkazy na Webu] Na \url{http://tug.org/interest.html}
- najdete mnoho relevantnch odkaz na rzn pruky,
- knihy, manuly a lnky o vech aspektech systmu \TeX{}.
-
-\item [archvy diskusnch skupin]
- \sloppypar Dv zkladn fra pro hledn een problm jsou
- newsov skupina \ctt{} a emailov diskusn
- skupina \email{texhax@tug.org}. V~archvech tchto zdroj
- najdete tisce pedchozch dotaz a odpovd ekajcch na vae
- hledn. Nahldnte na
- \url{http://groups.google.com/groups?group=comp.text.tex},
- res\-pek\-ti\-ve na
- \url{http://tug.org/mail-archives/texhax}. Dotazem do obecnho
- vyhledvacho stroje jako \url{http://google.com/} tak nic nepokazte
- a pro specifika etiny a sloventiny najdete dal zdroje
- odkazovan na \url{http://www.cstug.cz/}.
-
-\item [kladen dotaz] Pokud nemete najt odpov na svou otzku,
- mete ji poloit na \ctt{} pes Google nebo
- newsovho klienta nebo emailem na \email{texhax@tug.org}.
- Ale dve, ne tak uinte, \emph{prosm,} pette
- si toto doporuen, abyste maximalizovali vyhldky na
- zskn uiten odpovdi:
- \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}.
-
-\item [podpora \TL{}] Pokud chcete poslat
- chybov hlen, pipomnku nebo poznmku k~distribuci
- \TL{}, jej instalaci nebo dokumentaci,
- diskusn skupina k~tomu uren je \email{tex-live@tug.org}.
- Pokud vak je vae otzka specifick pro program na
- \TL{} umstn, napite prosm pmo autorovi nebo do diskusn
- skupiny uren pro tento program. Sputn programu
- s~volbou \code{-{}-help} nezdka
- poskytuje adresu pro chybov hlen.
-\end{description}
-
-\noindent
-Druhou stranou mince je odpovdn na dotazy tch, kdo kladou otzky.
-\ctt{} i~list \code{texhax} jsou oteveny pro kohokoliv.
-Pihlaste se, naslouchejte a zante odpovdat tam, kde mete.
-
-% don't use \TL so the \uppercase in the headline works. Also so
-% tex4ht ends up with the right TeX. Likewise the \protect's.
-\section{Pehled \protect\TeX\protect\ Live}
-\label{sec:overview.tl}
-
-Tento oddl popisuje obsah \TL{} a \TKCS{}, jej\'\i\v z~je st.
-
-%Dv hlavn instalan dvky pro Unix a \MacOSX{} jsou
-%\texttt{install-tl.sh} a \texttt{install-pkg.sh}. Jsou
-%popsny v~oddle~\ref{sec:unix.install} na
-%stran~\pageref{sec:unix.install}.
-%V~dalm oddle popeme strukturu a obsah \TL{}.
-
-
-\subsection{Kolekce \protect\TeX{}u: \TL, pro\TeX{}t, Mac\TeX}
-\label{sec:tl-coll.dists}
-
-\DVD{} \TKCS{} zahrnuje nsledujc:
-
-\begin{description}
-
-\item [\TL] pln systm \TeX{}, kter me bt spouten pmo nebo nainstalovn na disk.
-
-\item [Mac\TeX] pro \MacOSX, pidv pirozen \MacOSX\ instalan program a jin aplikace Mac k~\TL{}. Jeho domovsk strnka je
-\url{http://www.tug.org/mactex/}.
-
-\item [pro\TeX{}t] Rozen systmu \MIKTEX\ pro Windows.
-\ProTeXt\ pidv k~\MIKTEX u nov doplkov nstroje
-a zjednoduuje instalaci. Je pln nezvisl na \TL{}
-a m sv vlastn pkazy.
-Domovsk strnka projektu \ProTeXt\ je na \url{http://tug.org/protext}.
-
-\item [CTAN] Vpis obrazovky skladit \CTAN{}.
-
-\item [\texttt{texmf-extra}] Adres s~rozmanitmi doplkovmi balky.
-
-%\item [demo] systm spustiteln pmo z~\CD. Aby to bylo mon,
-%byli jsme nuceni vypustit velk kolekce pro sazbu
-%ntiny, japontiny a korejtiny \acro{CJK},
-%podporu sazby not, nkter mn asto pouvan psma.
-%Distribuce funguje jen pod Linuxem, \MacOSX{} a systmy Windows.
-
-\end{description}
-
-
-\CTAN{}, \pkgname{protext} a \dirname{texmf-extra} nemus mt stejn podmnky
-pro koprovn jako \TL{}, proto bute pozorn pi en nebo modifikaci.
-
-\subsection{Popis koenovch adres \TL{}}
-\label{sec:tld}
-
-V~koenovm adresi distribuce \TL{} najdete nsledujc
-podadrese. Na \pkgname{live} \DVD\ je cel \TL{} hierarchie v~podaresi
-\dirname{texlive}, a ne v~koenovm adresi disku.
-
-\begin{ttdescription}
-\item[bin] Binrky systmu \TeX{}, s~podadresi dle platforem.
-%
-\item[readme.html] Webovsk strnky se strunmi vody a uitenmi
-odkazy, v~rznch jazycch.
-%
-\item[source] Zdrojov kdy vech program, vetn distribuce
- \Webc{} \TeX{}u a \MF{}u.
-%
-\item[support] Rzn pomocn balky a programy. Automaticky %Implicitn
- \emph{nejsou} instalovny. Toto zahrnuje editory
- a \TeX{}ov vvojov prosted rznch druh.
-
-%
-\item[texmf] Viz \dirname{TEXMFMAIN} ne.
-%
-\item[texmf-dist] Viz \dirname{TEXMFDIST} ne.
-%
-\item[texmf-doc] Strom samostatn ist dokumentace, uspodn podle jazyk.
-%
-\item[tlpkg] Skripty, programy a daje pro sprvu instalace. Obsahuje
-rovn neveejn kopie Perlu a Ghostscriptu pro Windows, kter jsou mimo
-\TL{} neviditeln, a nov prohle PostScriptu pro Windows PSView.
-\end{ttdescription}
-
-\smallskip
-
-V~koenovm adresi distribuce jsou navc instalan dvky a soubory
-\filename{README} (v~rznch jazycch).
-
-Adres \dirname{texmf-doc} obsahuje dokumentaci, kter nen
-soust njakho konkrtnho balku nebo programu.
-Dokumentace program (manuly,
-man-strnky, info-soubory) jsou v~\dirname{texmf/doc},
-protoe programy jsou v~adresi \dirname{texmf}.
-Dokumentace \TeX ovch balk a formt je
-v~\dirname{texmf-dist/doc}.
-K~vyhledn veker dokumentace na libovolnm mst mete
-pout programy \cmdname{texdoc} nebo \cmdname{texdoctk}.
-Souhrnn\'e odkazy v~koenovm souboru \OnCD{doc.html} mohou
-bt tak uiten.
-
-Samotn tato pruka \TL\ je v~adresi \dirname{texmf-doc}
-a je k~dispozici v~nkolika jazycch:
-
-\begin{itemize*}
-\item{zjednoduen ntina:} \OnCD{texmf-doc/doc/chinese/texlive-zh-cn}
-\item{esko-slovensk:} \OnCD{texmf-doc/doc/czechslovak/texlive-cz}
-\item{anglick:} \OnCD{texmf-doc/doc/english/texlive-en}
-\item{francouzsk:} \OnCD{texmf-doc/doc/french/texlive-fr}
-\item{nmeck:} \OnCD{texmf-doc/doc/german/texlive-de}
-\item{polsk:} \OnCD{texmf-doc/doc/polish/texlive-pl}
-\item{rusk:} \OnCD{texmf-doc/doc/russian/texlive-ru}
-\end{itemize*}
-
-
-\subsection{Pehled peddefinovanch strom texmf}
-\label{sec:texmftrees}
-
-Tento oddl uvd seznam vech peddefinovanch promnnch
-urujcch stromy texmf, pouvanch systmem, a jejich zamlen el, a standardn uspodn systmu \TL.
-Povel \texttt{texconfig
-conf} vm uke hodnoty tchto promnnch, tedy mete jednodue zjistit,
-jak tyto odpovdaj nzvm adres ve va instalaci.
-
-\begin{ttdescription}
-\item [TEXMFMAIN] Strom obsahujc ivotn dleit sti systmu, jako pomocn skripty
-(nap. \verb+web2c/mktexdir+) a jin podprn soubory a jejich dokumentaci.
-Neobsahuje \TeX ovsk formty a balky.
-\item [TEXMFDIST] Strom obsahujc hlavn sadu balk maker,
- font\r u, atd. z~pvodn distribuce.
-\item [TEXMFLOCAL] Strom, kter mohou pout administrtoi na instalaci
-doplkovch nebo upravench maker, font, atd., pro cel systm.
-\item [TEXMFHOME] Strom, kter mohou pout uivatel na svoje osobn instalace
-doplkovch nebo upravench maker, font, atd.
- Rozen tto promnn se dynamicky nastav pro kadho uivatele na jeho vlastn osobn adres.
-\item [TEXMFCONFIG]
-Strom pouvan\'y nstroji
- \verb+texconfig+, \verb+updmap+ a \verb+fmtutil+ na uloen
- modifikovanch konfiguranch daj. Implicitn pod \envname{TEXMFHOME}. %$
-\item [TEXMFSYSCONFIG] Strom pouvan\'y nstroji \verb+texconfig-sys+, \verb+updmap-sys+ a \verb+fmtutil-sys+ na uloen modifikovanch konfiguranch daj.
-\item [TEXMFVAR] Strom pouvan\'y programy \verb+texconfig+,
- \verb+updmap+ a \verb+fmtutil+ na (cache) uloen runtime
- daj jako jsou soubory formt a generovan map-soubory.
- Implicitn pod \envname{TEXMFHOME}. %$
-\item [TEXMFSYSVAR] Strom pouvan\'y programy \verb+texconfig-sys+,
- \verb+updmap-sys+, \verb+fmtutil-sys+ a tak \verb+tlmgr+, na (cache) uloen runtime
- daj jako jsou soubory formt a generovan map-soubory.
-\end{ttdescription}
-
-
-\noindent
-Standardn struktura je:
-\begin{description}
- \item[system-wide root] me obshnout vcensobn vydn \TL{}:
- \begin{ttdescription}
- \item[2007] Pedchoz vydn.
- \begin{ttdescription}
- \item [...]
- \end{ttdescription}
- \item[2008] Nynj vydn.
- \begin{ttdescription}
- \item [bin] ~
- \begin{ttdescription}
- \item [i386-linux] binrky systmu \GNU/Linux
- \item [...]
- \item [universal-darwin] binrky systmu \MacOSX
- \item [win32] binrky systmu Windows
- \end{ttdescription}
- \item [texmf] Toto je \envname{TEXMFMAIN}.
- \item [texmf-dist] \envname{TEXMFDIST}
- \item [texmf-doc] \envname{TEXMFDOC}
- \item [texmf-var] \envname{TEXMFSYSVAR}
- \item [texmf-config] \envname{TEXMFSYSCONFIG}
- \end{ttdescription}
- \item [texmf-local] \envname{TEXMFLOCAL}, zamlen bt zachovn od vydn k~vydn.
- \end{ttdescription}
- \item[domovsk adres uivatele] (\texttt{\$HOME} nebo
- \texttt{\%USERPROFILE\%})
- \begin{ttdescription}
- \item[.texlive2007] Soukrom generovan a konfiguran daje pedchozho vydn.
- \item[.texlive2008] Soukrom generovan a konfiguran daje aktulnho vydn.
- \begin{ttdescription}
- \item [texmf-var] \envname{TEXMFVAR}
- \item [texmf-config] \envname{TEXMFCONFIG}
- \end{ttdescription}
- \item[texmf] \envname{TEXMFHOME} Osobn makra
- \textit{atd.}
- \end{ttdescription}
-\end{description}
-
-
-\subsection{Rozen \protect\TeX{}u}
-\label{sec:tex.extensions}
-
-Samotn \TeX{} je zmrazen, krom ojedinlch oprav chyb. Stle je v~\TL\ ptomen jako program \prog{tex} a tak to zstane v~dohledn budoucnosti. \TL{} obsahuje nkolik rozench verz \TeX{}u:
-
-\begin{description}
-
-\item [\eTeX] pidv mnoinu novch
-pkaz (nazvanch \TeX{}ov primitivy).
-\label{text:etex}
-Nov pkazy se napklad tkaj makroexpanze, natn znak,
-td znaek (marks), rozench ladicch monost
-a rozen \TeXXeT{} pro obousmrnou sazbu. Implicitn
-je \eTeX{} 100\% kompatibiln se standardnm \TeX{}em.
-Viz~\OnCD{texmf-dist/doc/etex/base/etex_man.pdf}.
-%B% \eTeX{} je nyn szecm programem pro \LaTeX{} i pdf\LaTeX{}.
-
-\item [pdf\TeX] vybudovn na rozench \eTeX{}u pidv podporu
-zpisu ve formtu \acro{PDF} stejn jako v~\dvi{}.
-
-%% This is the program
-%% invoked for most formats, e.g., \prog{etex}, \prog{latex},
-%% \prog{pdflatex}.
-%% See \url{http://www.pdftex.org/}.
-%% \OnCD{texmf/doc/pdftex/manual/} for the manual, and
-%% \OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex} for example usage
-%% of some of its features.
-
-Toto je program pouvan pro vtinu formt, napklad, \prog{etex}, \prog{latex},
-\prog{pdflatex}. Viz \url{http://www.pdftex.org/},
-nvod v~adresi \OnCD{texmf/doc/pdftex/manual/} a pklady pouit nkterch jeho vlastnost v~adresi
-\OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex}.
-
-\item [Lua\TeX] je oznaovn za nstupce pdf\TeX/{}u, se kterm by ml bt zptn kompatibiln. Ml by tak nahradit Aleph, viz dle. Zabudovan interpret Lua (viz
-\url{http://www.lua.org/}) umouje elegantn9 een mnoha oehavch
-\TeX ovskch problm. Volan povelem \filename{texlua}, funguje jako samostatn interpret Lua, a jako tak je ji pouit v~rmci \TL. Viz \url{http://www.luatex.org/} a
-\OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}.
-
-\item [\XeTeX] pidv podporu vstupnho kdovn
-Unicode a OpenType- a systmovch font, implementovanch pouitm zejmna knihoven tetch stran.
-Viz \OnCD{texmf-dist/doc/xetex/XeTeX-reference.pdf}.
-
-\item [\OMEGA\ (Omega)] je zaloena na Unicode. Umouje szet v~tm vech
-svtovch jazycch zrove. Dociluje toho tzv.
-pekladovmi procesy (\OMEGA{} Translation Processes,
-\acro{OTP}) pro realizaci sloitch transformac na jakmkoliv vstupu. Viz
-\OnCD{texmf/doc-dist/omega/base/doc-1.8.tex}
-(dokumentace vak nen zcela aktuln).
-
-\item [Aleph] kombinuje rozen \OMEGA\ a \eTeX.
-Pro minimln dokumentaci viz \OnCD{texmf-dist/doc/aleph/base}.
-\end{description}
-
-
-\subsection{Dal za zmnku stojc programy na \protect\TeXLive}
-
-Na \TL{} najdete nkolik asto pouvanch program:
-
-\begin{cmddescription}
-
-\item [bibtex] podpora prce se seznamem literatury.
-
-\item [makeindex] vytven rejstku. Pro etinu a sloventinu
-vak potebujete verzi programu s~nzvem \texttt{csindex} (nen zatm
-soust distribuce, je poteba instalovat zvlṻ).
-
-\item [dvips] pro konverzi \dvi{} do \PS{}.
-
-\item [xdvi] prohle \dvi{} pro systm X~Window.
-
-\item [dvilj] \dvi{} ovlada tiskren HP Laser\-Jet.
-
-\item [dv2dt, dt2dv] pro konverzi \dvi{} do/z~ascii textu.
-
-\item [dviconcat, dviselect] pro kopii a vkldn strnek
-do/z \dvi{} soubor.
-
-\item [dvipdfmx] konvertor \dvi{} do \acro{PDF}, alternativn
-pstup vedle pdf\TeX{}u zmnnho ve. Srovnej balky
-\pkgname{ps4pdf} a \pkgname{pdftricks} pro dal
-alternativy.
-
-\item [psselect, psnup, \ldots] programy pro prci s~\PS{}em.
-
-\item [lacheck] pro kontrolu syntaxe \LaTeX{}u.
-
-\item [texexec, texmfstart] wrapper pro Con\TeX{}t a prci s~\acro{PDF}.
-
-\item [tex4ht] konvertor \TeX{}u do \acro{HTML}.
-
-\end{cmddescription}
-
-
-\subsection{Fonty v~\protect\TL}
-\label{sec:tl.fonts}
-
-\TL{} pin mnostv vysoce kvalitnch vektorovch % ?scalable fonts.
-font. Viz \url{http://tug.org/fonts} a \OnCD{texmf-doc/english/free-math-fonts-survey}.
-
-
-\section{Instalace}
-\label{sec:install}
-
-\subsection{Sputn instalanho programu}
-\label{sec:inst.start}
-
-Pro zatek si obstarejte \TK{} \DVD{} nebo si sthnte sov instalan program \TL{},
-a najdte instalan skript: \filename{install-tl} pro Unix,
-\filename{install-tl.bat} pro Windows.
-
-\begin{description}
-\item [Sov instaltor:] sthnte z~\CTAN{}u, z~adrese \dirname{systems/texlive/tlnet}; url
-\url{http://mirror.ctan.org/systems/texlive/tlnet} vs automaticky pesmruje na blzk, aktuln mirror.
-Mete zskat \filename{install-tl.zip}, kter me bt pouit pod Unixem a Windows nebo
-\filename{install-unx.tar.gz}, kter je podstatn men, jenom pro Unix. Po rozbalen se \filename{install-tl} a
-\filename{install-tl.bat} objev v~podadresi \dirname{install-tl}.
-
-\item [\DVD{} \TeX{} kolekce:] vejdte do podadrese \dirname{texlive}.
-Pod Windows by se instaltor ml spustit automaticky po vloen \DVD. \DVD\ mete zskat, kdy se stanete lenem
-skupiny uivatel \TeX u (vele doporuujeme,
-\url{http://tug.org/usergroups.html}), nebo si ho zvlṻ zakoupte
-(\url{http://tug.org/store}), anebo si vyplte svoje vlastn z~\ISO\
-obrazu (\url{http://tug.org/texlive/acquire.html}).
-
-\end{description}
-Nsledujc sekce vysvtluj vechno podrobnji.
-
-\subsubsection{Unix}
-
-\begin{figure}[tb]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
-
- Detected platform: Intel x86 with GNU/Linux
-
- <B> binary systems: 1 out of 16
-
- <S> Installation scheme (scheme-full)
-
- Customizing installation scheme:
- <C> standard collections
- <L> language collections
- 83 collections out of 84, disk space required: 1666 MB
-
- <D> directories:
- TEXDIR (the main TeX directory):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
- [X] install macro/font doc tree
- [X] install macro/font source tree
- [ ] create symlinks in standard directories
-
- <V> Install for running from DVD
-
-Other actions:
- <I> start installation to HD
- <H> help
- <Q> quit
-
-Enter command:
-\end{boxedverbatim}
-\caption{Hlavn obrazovka textovho instalanho programu (\GNU/Linux)}\label{fig:text.main}
-\end{figure}
-
-\begin{figure}[tb]
-\tlpng{install-w32-main}{\linewidth}
-\caption{Zkladn obrazovka \GUI{} instalanho programu (Windows)}\label{fig:gui.main}
-\end{figure}
-
-\noindent
-Dle, \texttt{>} oznauje vzvu (prompt shellu); vstup uivatele vstup je \Ucom{\texttt{zvraznn}}.
-Po sputn terminlu v~Unixovskm systmu je nejjednodu zpsob:
-\begin{alltt}
-> \Ucom{cd /path/to/installer}
-> \Ucom{perl install-tl}
-\end{alltt}
-(Nebo mete vyvolat \Ucom{perl /path/to/installer/install-tl}, nebo
-\Ucom{./install-tl} kdy je spustiteln, atd.; nechceme opakovat vechny tyto variace.)
-
-K~instalaci v~reimu \GUI\ (budete potebovat modul \dirname{Perl/TK}), pouijte:
-\begin{alltt}
-> \Ucom{perl install-tl -gui}
-\end{alltt}
-
-pln seznam rznch voleb zskte povelem:
-\begin{alltt}
-> \Ucom{perl install-tl -help}
-\end{alltt}
-
-\textbf{Varovn o oprvnnch Unixu:} Vae nastaven \code{umask} v~ase instalace bude respektovno instalanm programem \TL{}. Proto, kdy chcete, aby byla vae instalace pouiteln i jinmi uivateli ne vmi, ujistte se, e jsou vae nastaven dostaten tolerantn, napklad, \code{umask
-002}. Dal informace o nastaven \code{umask}, hledejte v~dokumentaci k~vaemu systmu.
-
-\subsubsection{Mac\,OS\,X}
-
-Jak ji bylo zmnno v~sekci~\ref{sec:tl-coll.dists}, pro \MacOSX je pipravena samostatn distribuce, nazvan Mac\TeX\ (\url{http://tug.org/mactex}).
-Doporuujeme pout pvodn instalan program Mac\TeX\ u namsto instaltoru \TL\
-pod \MacOSX, protoe pvodn (nativn) instaltor me provst nkolik nastaven specifickch pro Mac, zejmna umouje snadn pepnn mezi rznmi distribucemi \TeX u pro \MacOSX\ (Mac\TeX, gw\TeX,
-Fink, MacPorts, \ldots).
-
-Mac\TeX\ je siln zaloen na \TL, a hlavn \TeX ovsk stromov struktura je pesn stejn. Pidv nkolik dalch adres s~dokumentac a aplikacemi specifickmi pro Mac.
-
-\subsubsection{Windows}
-
-Jestlie pouvte sov instaltor, nebo instalan program \DVD\ se nespust automaticky, kliknte dvakrt na soubor \filename{install-tl.bat}.
-
-Mete tak spustit instalan program z~pkazovho dku. Dle \texttt{>} oznauje prompt shellu; vstup uivatele je \Ucom{\texttt{polotun}}. Pokus jste v~adresi instalanho programu, jenom spuste:
-\begin{alltt}
-> \Ucom{install-tl}
-\end{alltt}
-
-Mete to tak vyvolat zadnm absolutn polohy, jako napklad:
-\begin{alltt}
-> \Ucom{D:\bs{}texlive\bs{}install-tl}
-\end{alltt}
-pro \TKCS\ \DVD, za pedpokladu, e \dirname{D:} je optick disk.
-
-Pro instalaci v~textovm reimu pouijte:
-\begin{alltt}
-> \Ucom{install-tl -no-gui}
-\end{alltt}
-
-Pro pln seznam rznch voleb zadejte:
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-
-\subsubsection{Textov instalan program}
-
-Obrzek~\ref{fig:text.main} ukazuje zkladn obrazovku textovho reimu pod Unixem.
-
-Je to instaltor jenom s~pkazovm dkem; vbec nem kurzorovou podporu. Napklad, nemete se pohybovat v~zatrhvacch rmecch nebo vstupnch polch. Jenom napete nco (s~rozliovnm velikosti psma) na pkazovm dku a stlate klvesu Enter, pot se cel obrazovka pepe s~pizpsobenm obsahem.
-
-Rozhran textovho instaltoru je tak primitivn z~prostho dvodu: je
-navren tak, aby se dalo spustit na tolika platformch jak je to jen
-mon, dokonce i~v~Perlu (pro Windows je zaazena
-podmoina Perlu).
-
-\subsubsection{Grafick instalan program}
-
-Obrzek~\ref{fig:gui.main} ukazuje grafick instaltor pod Windows.
-Vtina rozdl ppustnch voleb je patrn z~obrazovky systmu Windows a z~pedchoz obrazovky systmu \GNU/Linux.
-
-\subsection{Sputn instalanho programu}
-\label{sec:runinstall}
-
-Instaltor je zamlen jako co nejvce samovysvtlujc. Nicmn podme nkolik poznmek o jednotlivch volbch a dlch nabdkch:
-
-\subsubsection{Nabdka binrnch systm (pouze Unix)}
-\label{sec:binary}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Available sets of binaries:
-===============================================================================
-
- a [ ] alpha-linux DEC Alpha with GNU/Linux
- b [ ] amd64-freebsd x86_64 with FreeBSD
- c [ ] hppa-hpux HP-UX
- d [ ] i386-freebsd Intel x86 with FreeBSD
- e [X] i386-linux Intel x86 with GNU/Linux
- f [ ] i386-openbsd Intel x86 with OpenBSD
- g [ ] i386-solaris Intel x86 with Sun Solaris
- h [ ] mips-irix SGI IRIX
- i [ ] powerpc-aix PowerPC with AIX
- j [ ] powerpc-linux PowerPC with GNU/Linux
- k~[ ] sparc-linux Sparc with GNU/Linux
- l [ ] sparc-solaris Sparc with Solaris
- m [ ] universal-darwin universal binaries for MacOSX/Darwin
- o [ ] win32 Windows
- p [ ] x86_64-linux x86_64 with GNU/Linux
-\end{boxedverbatim}
-\caption{Nabdka binrek}\label{fig:bin.text}
-\end{figure}
-
-Obrzek~\ref{fig:bin.text} ukazuje nabdku binrek textovho reimu. Standardn budou nainstalovny jenom binrky va aktuln platformy. Z~tto nabdky si rovn mete vybrat binrky pro jinou architekturu. Toto me bt uiten, pokud sdlte \TeX ovsk strom v~sti heterogennch stroj, nebo na systmu s~dvojitm zavdcm procesem.
-
-\subsubsection{Volba obsahu instalace}
-\label{sec:components}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Select a scheme:
-====================================================================
-
- a [ ] TeX Live basic scheme
- b [ ] TeX Live scheme for ConTeXt
- c [X] TeX Live full scheme
- d [ ] GUST TeX Live scheme
- e [ ] GUTenberg TeX Live scheme
- f [ ] TeX Live medium scheme
- g [ ] TeX Live minimal scheme
- h [ ] TeX Live for Omega users
- i [ ] teTeX scheme
- j [ ] XML typesetting scheme
-\end{boxedverbatim}
-\caption{Nabdka schmat}\label{fig:scheme.text}
-\end{figure}
-
-Obrzek~\ref{fig:scheme.text} ukazuje nabdku schmat \TL; tady
-vybrte ``schma'', co je souhrn kolekc balk.
-Pedvolen schma \optname{full} nainstaluje ve, co je k~dispozici, avak
-mete tak zvolit schma \optname{basic} pro mal systm,
-\optname{minimal} pro ely testovn, a schma \optname{medium} nebo
-\optname{teTeX} pro zskn neho mezi tm. K~dispozici jsou tak rzn
-specializovan schmata a schmata specifick pro nkter zem.
-
-\begin{figure}[tbh]
-\tlpng{stdcoll}{.7\linewidth}
-\caption{Nabdka kolekc (Linux)}\label{fig:collections.gui}
-\end{figure}
-
-Svj vbr schmatu mete upesnit pomoc nabdek `standard collections' a
-`language collections' (obrzek~\ref{fig:collections.gui}, ukzan pro zmnu v~reimu \GUI).
-
-Kolekce jsou o jednu rove podrobnj ne schmata\Dash v~podstat,
-schma je tvoeno nkolika kolekcemi, kolekci tvo jeden nebo vce
-balk, a balk (nejni rove seskupvn v~\TL) obsahuje vlastn
-soubory \TeX ovskch maker, soubory font, atd.
-
-Pokud chcete zskat vt kontrolu ne jakou poskytuje nabdka kolekc, po instalaci mete pout program \prog{tlmgr} (viz sekci~\ref{sec:tlmgr}); jeho pouitm mete dit instalaci na rovni balk.
-
-\subsubsection{Adrese}
-\label{sec:directories}
-
-Standardn uspodn je popsno v~sekci~\ref{sec:texmftrees},
-\p.\pageref{sec:texmftrees}. Standardn umstn adrese \dirname{TEXDIR} se li pro Windows
-(|%PROGRAMFILES%\texlive\2008|) a Unix
-(\dirname{/usr/local/texlive/2008}).
-
-Hlavn dvod pro zmnu tto pedvolby je nedostatek prv
-na zpis pro standardn umstn.
-Nemuste bt zrovna rootem nebo administrtorem, kdy instalujete \TL, ale potebujete oprvnn na zpis do clovho adrese.
-
-Logickou alternativou je adres uvnit vaeho domovskho adrese, zvlṻ kdy chcete bt vhradnm uivatelem. Na naznaen tohoto pouijte `|~|', jako napklad `|~/texlive/2008|'.
-
-Doporuujeme do nzvu zalenit rok, co umon zachovn rznch vydn \TL{} vedle sebe. (Mete chtt vytvoit nzev nezvisl na verzi, napklad \dirname{/usr/local/texlive-cur} pomoc symbolickho odkazu, kter me bt pozdji pepsn po pezkouen novho vydn.)
-
-Zmna \dirname{TEXDIR} v~instalanm programu vyvol tak zmny
-\dirname{TEXMFLOCAL}, \dirname{TEXMFSYSVAR} a
-\dirname{TEXMFSYSCONFIG}.
-
-\dirname{TEXMFHOME} je doporuen umstn osobnch soubor maker nebo balk. Pedvolen hodnota je |~/texmf|. Na rozdl od \dirname{TEXDIR}, je nyn |~| uchovna v~nov vytvoench konfiguranch souborech, protoe to uiten odkazuje na domovsk adres bcho \TeX u. Expanduje se na \dirname{$HOME} pod Unixem a \verb|%USERPROFILE%| pod Windows.
-
-\subsubsection{Volby}
-\label{sec:options}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-<P> use letter size instead of A4 by default: [ ]
-<F> create all format files: [X]
-<D> install font/macro doc tree: [X]
-<S> install font/macro source tree: [X]
-<L> create symlinks in standard directories: [ ]
- binaries to:
- manpages to:
- info to:
-\end{boxedverbatim}
-\caption{Nabdka voleb (Unix)}\label{fig:options.text}
-\end{figure}
-
-Obrzek~\ref{fig:options.text} ukazuje nabdku voleb textovho reimu.
-Zde musme pipomenout ti volby:
-
-\begin{description}
-\item[use letter size instead of A4 by default:] Obvykl vbr standardn velikosti papru.
-Jednotliv dokumenty mohou deklarovat zvltn rozmr papru, pokud je to douc.
-
-\item[create all format files:] Pestoe si vytvoen nepotebnch formt
-vyaduje as a diskov prostor pro uloen, nicmn doporuujeme nechat
-tuto volbu vyznaenou: kdy ji nevyznate, budou formtov soubory
-vytvoen v~osobnch stromech \dirname{TEXMFVAR} uivatel, kdy budou
-zapoteb. Na tomto mst nebudou automaticky aktualizovan, kdy se budou
-napklad obnovovat binrky nebo vzory dlen v~instalaci, co me
-skonit nekompatibilnmi soubory formt.
-
-\item[create symlinks in standard directories] (pouze Unix):
-Tato volba obchz potebu zmny promnnch prosted. Bez tto volby je potebn pidat adrese \TL{} do promnnnch
- \envname{PATH}, \envname{MANPATH} a \envname{INFOPATH}. Budete muset pidlit prva na zpis clovm adresm. Nen rozumn pepsat \TeX ovsk systm, kter piel s~vam systmem s~touto volbou. Toto je v~prvn ad ureno k~vytven odkaz v~standarndch adresch, kter uivatel znaj, jako napklad \dirname{/usr/local/bin}, kter neobsahuj dn \TeX ovsk soubory.
-\end{description}
-
-Te, kdy jsou vechna tyto nastaven podle vaeho vkusu, mete napsat
-`I' a spustit instalan proces. Po dokonen peskote na
-sekci~\ref{sec:postinstall}, kde se dozvte, co se m udlat, pokud vbec
-nco.
-
-
-\subsubsection{Nastaven spoutn z~DVD{} (pouze v~textovm reimu)}
-\label{sec:fromdvd}
-
-K~vbru tto volby napite `|V|'. Toto zmn hlavn nabdku na nco podobnho jako ukazuje obrzek~\ref{fig:main.fromdvd}.
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
- <D> directories:
- TEXDIRW (Writable root):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
-
- <V> set up for installing to hard disk
-
-Other actions:
- <I> start installation for running from DVD
- <H> help
- <Q> quit
-\end{boxedverbatim}
-\caption{Hlavn nabdka s~uspodnm pro volbu \optname{from DVD}}\label{fig:main.fromdvd}
-\end{figure}
-
-Vimnte si zmny: vechny volby k~instalaci zmizely, a st pro adrese se te zmiuje
-o~\dirname{TEXDIRW} nebo zapisovatelnm koenu. Volba pro symbolick linky tak zmizela.
-
-Instalan program bude pod vytvet rzn adrese a konfiguran
-soubory, ale nezkopruje \dirname{texmf},
-\dirname{texmf-dist} nebo \dirname{texmf-doc} na pevn disk.
-
-Poinstalan konfigurace pro Unix bude o nco sloitej,
-protoe te se struktura adres odchyluje od standardu; viz
-sekci~\ref{sec:postinstall}.
-
-V~dsledku asovch ohranien nen tato volba zapracovna do instalanho programu \GUI{}, ale je k~dispozici pro oba systmy Unix a Windows. Uivatel pod systmem Windows mus spustit instaltor z~pkazovho dku, viz sekci~\ref{sec:cmdline}.
-
-Oddl \ref{sec:portable.unix} popisuje schdnj cestu sputn \TL, kter nedl nebo nepoaduje zmny systmov konfigurace, ale ani dnou konfiguraci neumouje.
-
-\subsection{Instalan volby pkazovho dku}
-\label{sec:cmdline}
-
-K~zobrazen voleb pkazovho dku napite
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-K~uveden nzvu volby mohou bt pouity |-| nebo tak |--|.
-Nsleduj nejzajmavj volby:
-
-\begin{ttdescription}
-\item[-gui] Podle monost pouijte \GUI{} instaltor. Toto si vyaduje modul
- Perl/Tk (\url{http://tug.org/texlive/distro.html#perltk});
- pokud Perl/Tk nen k~dispozici, pokrauje instalace v~textovm reimu.
-\item[-no-gui] Vynut si pouit instaltoru v~textovm reimu, dokonce i pod Windows;
- mete to potebovat, pokud chcete spustit instalaci s~volbou `from \DVD', ponvad tato
- nen k~dispozici v~reimu \GUI{}.
-\item[-lang {\sl LL}] Specifikuje jazyk instalanho rozhran jako jeho standarn dvoupsmenov kd \textsl{LL}.
-V~souasn dob jsou podporovny jazyky: anglitina (\texttt{en}, pedvolen), nmina
- (\texttt{de}), francouztina (\texttt{fr}), nizozemtina (\texttt{nl}), poltina
- (\texttt{pl}), slovintina (\texttt{sl}) a vietnamtina
- (\texttt{vi}). Instalan program se sm pokus urit vhodn jazyk, ale kdy sele nebo kdy nen sprvn jazyk k~dispozici, pak pouije anglitinu jako nouzov een.
-\item[-profile {\sl profile}] Instalan program vdycky ulo soubor
- \filename{texlive.profile} do \dirname{2008/tlpkg}- nebo do podadrese
- \dirname{tlpkg} va instalace. Tato volba zpsob, e se pouije
- soubor \filename{texlive.profile}.
- Tady je vpis:
- \begin{fverbatim}
-# texlive.profile written on Wed Jul 9 16:13:44 2008 UTC
-# It will NOT be updated and reflects only the
-# installation profile at installation time.
-selected_scheme scheme-basic
-TEXDIR /usr/local/texlive/2008
-TEXDIRW /usr/local/texlive/2008
-...
-TEXMFSYSVAR /usr/local/texlive/2008/texmf-var
-collection-basic 1
-...
-option_symlinks 0
- \end{fverbatim}
- Takto mete pouitm tto volby v~dvkovm reimu instalovat \TeX\ na
- dal systmy, se stejnmi volbami, jak jste uinili v~pvodn instalaci.
-\item [-location {\sl url/path}] Specifikuje nestandardn zdroj pro balky; viz dle.
-\end{ttdescription}
-
-\subsubsection{Promnn \optname{location}}
-\label{sec:location}
-
-Hondota promnn \optname{location} me bt adresa url s~\texttt{ftp:},
-\texttt{http:} na zatku, nebo \texttt{file:/} url, nebo jednoduch cesta.
-Pokud se dan argument nachz na lokln mechanice (jako cesta nebo \texttt{file:/} url),
-automaticky je uren typ instalace (komprimovan nebo live):
-pokud bude nalezen podadres \dirname{archive} obsahujc soubory \filename{.tar.lzma},
-tak bude pouit, dokonce i kdy budou k~dispozici tak nekomprimovan soubory.
-
-Kdy je zadno \texttt{http:} nebo \texttt{ftp:} umstn, koncov znaky `\texttt{/}' a/nebo koncov sloka `\texttt{/tlpkg}' jsou ignorovny. Napklad, mete si zvolit urit zrcadlo \CTAN u nm jako:
-\url{http://ctan.example.org/tex-archive/texlive/tlnet/2008},
-pochopiteln s~nahrazenm vhodnho jmna hostitele (hostname) a jeho konkrtn koenovou cestou
-\CTAN u (seznam zrcadel \CTAN u je udrovn na \url{http://ctan.org/mirrors})
-namsto |ctan.example.org/tex-archive|. Implicitn je automatick vbr zrcadla, pouitm
-\url{http://mirror.ctan.org}; v~kadm ppad je zvolen hostitel pouit pro veker download.
-
-
-\subsection{Poinstalan innosti}
-\label{sec:postinstall}
-
-Po instalaci se mohou hodit nkter dal pravy.
-
-\subsubsection{Windows}
-
-Avak pod Windows se instalan program o~ve postar.
-
-\subsubsection{Pokud byly vytvoeny symbolick odkazy}
-
-Pokud jste zvolili vytvoen symbolickch odkaz v~standardnch adresch (zmnnch v~sekci~\ref{sec:options}), pak nen poteba editovat promnn prosted.
-
-
-\subsubsection{Promnn prosted pro Unix}
-\label{sec:env}
-
-Adres binrek pro vai platformu mus bt pidn k~vyhledvacm cestm.
-Kad podporovan platforma m svj vlastn podadres pod \dirname{TEXDIR/bin}. Seznam podadres a odpovdajcch platforem viz na obrzku~\ref{fig:bin.text}.
-
-Mete rovn pidat dokumentan manulov strnky (man) a adrese Info k~jejich
-psluejcm vyhledvacm cestm, kdy chcete, aby je naly systmov nstroje.
-
-Napklad pro Bourne-kompatibiln shell, jako je \prog{bash} a pouvan Intel x86
-GNU/Linux se standardnm nastavenm adres, me bt vhodn editovat soubor
- \filename{$HOME/.profile}.
-
-\begin{sverbatim}
-PATH=/usr/local/texlive/2008/bin/i386-linux:$PATH; export PATH
-MANPATH=/usr/local/texlive/2008/texmf/doc/man:$MANPATH; export MANPATH
-INFOPATH=/usr/local/texlive/2008/texmf/doc/info:$INFOPATH; export INFOPATH
-\end{sverbatim}
-
-Pro \prog{csh} nebo \prog{tcsh} je editovan soubor typicky \filename{$HOME/.cshrc} a
-dky k~pidn mou vypadat jako:
-
-\begin{sverbatim}
-setenv PATH /usr/local/texlive/2008/bin/i386-linux:$PATH
-setenv MANPATH /usr/local/texlive/2008/texmf/doc/man:$MANPATH
-setenv INFOPATH /usr/local/texlive/2008/texmf/doc/info:$INFOPATH
-\end{sverbatim}
-
-
-\subsubsection{Promnn prosted: globln konfigurace}
-\label{sec:envglobal}
-
-Volba, zda uinit tyto zmny globln, anebo pro uivatele prv
-pidanho do systmu, je na vs; existuje pli mnoho variac mezi
-systmy, kde a jak se tato nastaven provdj.
-
-Nae dv rady jsou: 1)~mete chtt vyhledat soubor
-\filename{/etc/manpath.config} a pokud existuje, pidejte dky jako
-
-\begin{sverbatim}
-MANPATH_MAP /usr/local/texlive/2008/bin/i386-linux \
- /usr/local/texlive/2008/texmf/doc/man
-\end{sverbatim}
-
-A 2)~vyhledejte soubor \filename{/etc/environment}, kter me definovat vyhledvac cestu a dal standardn promnn prosted.
-
-\subsubsection{Pi sputn \protect\TL{} z~DVD}
-
-Program \TL{} obyejn nahldne do souboru \filename{texmf.cnf} pro
-umstn rznch strom. Hled tento soubor v~ad mst vztahujcch se
-k~jeho vlastnmu umstn. Nicmn, toto schma selhv, kdy je program
-spoutn z~\DVD{}: \DVD{} je pouze ke ten. %read-only.
-Nkter cesty zaznamenan v~\filename{texmf.cnf} jsou znm jen bhem
-instalace, tud tento soubor neme bt na \DVD{} a mus bt umstn
-nkde jinde. To si vynucuje definovat promnnou prosted
-\envname{TEXMFCNF}, kter sdl programm \TL{}, v~kterm adresi je
-mon najt tento soubor \filename{texmf.cnf}.
-Pesto je tak nutn upravit promnnou prosted \envname{PATH}, jak bylo
-popsno dve.
-
-Na konci instalace by instalan program ml vytisknout hlen o~hodnot,
-na kterou se m nastavit promnn \envname{TEXMFCNF}. Jestlie jste ji
-minuli: tato hodnota je \dirname{$TEXMFSYSVAR/web2c}. Na pedvolbu
-\dirname{/usr/local/texlive/2008/texmf-var/web2c} potebujete dky
-\begin{sverbatim}
-TEXMFCNF=/usr/local/texlive/2008/texmf-var/web2c; export TEXMFCNF
-\end{sverbatim}
-nebo, pro [t]csh:
-\begin{sverbatim}
-setenv TEXMFCNF /usr/local/texlive/2008/texmf-var/web2c
-\end{sverbatim}
-
-\subsubsection{\ConTeXt{} Mark IV}
-
-`Star' \ConTeXt{} by ml skonit. %should run out of the box.
-Nov \ConTeXt{} `Mark IV'
-si vyd run nastaven; viz
-\url{http://wiki.contextgarden.net/Running_Mark_IV}.
-
-
-\subsubsection{Zaleovn loklnch a osobnch maker}
-\label{sec:local-personal.macros}
-
-Toto je ji implicitn zmnno v~sekci~\ref{sec:texmftrees}:
-adres \dirname{TEXMFLOCAL} (standardn \dirname{/usr/local/texlive/texmf-local} nebo
-\verb|C:\Program Files\texlive\texmf-local|)
-je uren pro rozshl systmov % system-wide
-lokln fonty a makra; a adres
-\dirname{TEXMFHOME} (standardn \dirname{$HOME/texmf} nebo
-\verb|%USERPROFILE%\texmf|), je pro osobn fonty a makra.
-
-Pro oba stromy mus bt soubory umstn v~patinch podadresch;
-viz \url{http://tug.org/tds} nebo nahldni do souboru
-\filename{texmf/web2c/texmf.cnf}. Napklad, \LaTeX{}ovsk soubor tdy % class file or
-nebo balk by ml bt umstn v~\dirname{TEXMFLOCAL/tex/latex} nebo
-\dirname{TEXMFHOME/tex/latex}, nebo v~jejich podadresi.
-
-\dirname{TEXMFLOCAL} vyaduje aktuln databzi jmen soubor, jinak
-nebudou soubory nalezeny.
-Mete ji obnovit povelem \cmdname{mktexlsr} nebo pout tlatko
-`Reinit file database' na konfiguran zloce \prog{tlmgr} v~reimu \GUI.
-
-\subsubsection{Zaleovn font tetch stran}
-
-Toto je nanetst velice komplikovan a deliktn tma.
-Vyhnte se tomu, pokud nejste expert.
-Prohldnte si nejdve fonty, kter jsou zadarma soust distribuce,
-viz sekci~\ref{sec:tl.fonts}.
-
-Monou alternativou je pouit \XeTeX u (viz sekci~\ref{sec:tex.extensions}), kter vm
-umon pouvat fonty operanho systmu bez jakkoliv instalace v~\TeX u.
-
-
-\subsection{Testovn instalace}
-\label{sec:test.install}
-
-Po nainstalovn \TL{} pirozen chcete
-systm otestovat a zat vytvet ndhern dokumenty nebo fonty.
-
-Tento oddl popisuje zkladn postupy testovn funknosti novho
-systmu pod Unixem. Pod \MacOSX{} a
-Windows budete patrn spoutt testy pes uivatelsk grafick rozhran
-(\acro{GUI}), ale principy jsou stejn.
-
-\begin{enumerate}
-\item Nejprve ovte, zda se spust program \cmdname{tex}:
-
-\begin{alltt}
-> \Ucom{tex -{}-version}
-TeX 3.1415926 (Web2C 7.5.7)
-kpathsea version 3.5.7
-...
-\end{alltt}
-Pokud obdrte hlku s~`command not found' msto ve uvedenho, nebo se
-star verz, patrn nemte nastaven sprvn podadres
-\dirname{bin} v~promnn prosted \envname{PATH}. Vrate se
-k~informacm o~jejich nastavovn na stran~\pageref{sec:env}.
-
-\item Pelote ukzkov soubor \LaTeX{}u:
-\begin{alltt}
-> \Ucom{latex sample2e.tex}
-> This is pdfeTeXk, Version 3.1415926...
-Output written on sample2e.dvi (3 pages, 7484 bytes).
-Transcript written on sample2e.log.
-\end{alltt}
-Pokud sele nalezen souboru \filename{sample2e.tex} nebo jinch
-soubor, nejspe mte aktivn star nastaven promnnch prosted nebo
-konfiguranch soubor; pro zatek doporuujeme zruit nastaven vech promnnch prosted souvisejcch s~\TeX{}em.
-Pro hlub analzu a dohledn problmu mete kdykoliv podat
-\TeX{} o detaily toho, co a kde hled: viz \uv{Ladic innosti}
-na stran~\pageref{sec:debugging}.
-
-\item Prohldnte si vsledek na obrazovce:
-\begin{alltt}
-> \Ucom{xdvi sample2e.dvi}
-\end{alltt}
-(Pod Windows je analogick pkaz \cmdname{dviout}.) Mlo by se
-otevt nov okno s~pknm dokumentem popisujcm zklady
-\LaTeX{}u. (Mimochodem, stoj za peten, pokud zante.)
-Muste mt sputny
-X~Window, aby \cmdname{xdvi} pracovalo. Pokud tomu tak nen nebo mte
-patn nastavenou promnnou prosted
-\envname{DISPLAY}, dostanete chybovou hlku `Can't open display'.
-
-\item Vytvote \PS{}ov soubor pro tisk nebo prohlen:
-\begin{alltt}
-> \Ucom{dvips sample2e.dvi -o sample2e.ps}
-\end{alltt}
-
-\item Vytvote \acro{PDF} soubor msto \dvi{}; tento pkaz
-ze~souboru \filename{.tex} vytvo \acro{PDF} pmo:
-\begin{alltt}
-> \Ucom{pdflatex sample2e.tex}
-\end{alltt}
-
-\item Prohldnte si \acro{PDF} soubor:
-\begin{alltt}
-> \Ucom{gv sample2e.pdf}
-\textrm{nebo:}
-> \Ucom{xpdf sample2e.pdf}
-\end{alltt}
-Bohuel ani \cmdname{gv} ani \cmdname{xpdf} nejsou v~souasn dob na
-\TL{} a muste je instalovat separtn. Viz
-\url{http://www.gnu.org/software/gv} a
-\url{http://www.foolabs.com/xpdf}. (Existuje tak velk mnostv jinch prohle \acro{PDF}.)
-
-\item Standardn testovac soubory, kter mohou bt uiten krom \filename{sample2e.tex}:
-
-\begin{ttdescription}
-%B% \item [docstrip.tex] Vytvoen \TeX{}ovho zdroje i dokumentace ze
-%B% souboru~\samp{.dtx}.
-\item [small2e.tex] Ukzkov dokument, jet krat ne
-\filename{sample2e}.
-\item [testpage.tex] Test, jestli vae tiskrna neposunuje tiskov zrcadlo.
-\item [nfssfont.tex] Pro tisk tabulek font a test font.
-\item [testfont.tex] Pro tot, ale pro plain \TeX{}.
-\item [story.tex] Zkladn (plain) \TeX{}ov testovac soubor.
-Muste napsat \samp{\bs bye} na vzvu \code{*} po \samp{tex
-story.tex}.
-\end{ttdescription}
-\end{enumerate}
-
-Pokud jste \TeX{}ov zatenk nebo potebujete pomoc se psanm
-\TeX{}ovch, respektive \LaTeX{}ovch dokument, navtivte
-\url{http://tug.org/begin.html}, kde najdete vodn informace
-k~instalaci.
-
-\section{Sov instalace}
-\label{sec:netinstall}
-
-\TL{} byl navren pro sdlen mezi rznmi uivateli, nebo dokonce pro rzn systmy na sti.
-Se standardn strukturou adres se nekonfiguruj dn % no hard paths are configured
-pevn cesty: umstn soubor potebnch pro programy \TL{}
-je definovno relativn k~umstnm tchto program. Mete to najt v~innosti v~konfiguranm souboru
-\filename{$TEXMFMAIN/web2c/texmf.cnf}, kter obsahuje dky jako jsou
-\begin{sverbatim}
-TEXMFMAIN = $SELFAUTOPARENT/texmf
-...
-TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local
-\end{sverbatim}
-To znamen, e jin systmy nebo jin uivatel potebuj pouze pidat ke
-sv vyhledvac cest adres binrek \TL{} pro jejich platformu.
-
-%By the same token,
-Stejnm zpsobem mete nainstalovat \TL{} lokln a pak pesunout celou hierarchii pozdji na msto na sti.
-
-Pochopiteln, uivatel pod Windows maj jin oekvn. Adres
-\dirname{texmf-doc/source/texlive/texlive-common/w32client} obsahuje vzorov skript \filename{install-w32client},
-kter vytv nastaven a nabdkov zkratky k~uvn stvajc instalace \TL{} na
-\acro{LAN}. Pouv se to pomoc dvkovho souboru
-\filename{install-w32client.bat} ve stejnm adresi.
-
-Vc o konfiguraci \TL{} a vyhledvn cest si mete pest v~sekci~\ref{sec:kpathsea}.
-
-
-\section{Maximln mobiln \protect\TL{} na DVD a USB}
-\label{sec:portable.unix}
-
-Volba `running from \DVD{}' (spoutn z~\DVD{}) popsan v~sekci~\ref{sec:fromdvd}
-je skvl pro v systm, ale kdy jste hostem na systmu nkoho jinho,
-pak by se vm mon lbilo nco s~nejmenmi vedlejmi inky.
-
-V~koenovm adresi \TL{} \DVD, nebo v~podadresi \dirname{texlive} \TKCS{} \DVD, jsou skripty \filename{tl-portable} (Unix) a dvkov soubory
-\filename{tl-portable.bat} (Windows), kter spout shell s~nastavenm prosted odpovdajcm pmmu pstupu \TL{} na \DVD.
-
-Pi prvnm sputn budou vygenerovny nkter soubory v~adresi
-\dirname{~/.tlportable2008}, co zabere jist krtk as.
-Nicmn, pi nslednch spoutnch zane tm okamit.
-
-Zbytek systmu si \TL{} nebude uvdomovat. Pokud chcete, aby byl v editor informovan o~tomto \TL, pak ho mete spustit z~druh, paraleln, stejn \filename{tl-portable} relace.
-
-Skripty \filename{tl-portable} mete tak pout na sputn \TL{} z~\acro{USB} kle. V~tomto ppad zkoprujte (pinejmenm) vechny soubory na nejvy urovni a obsah adres \dirname{bin}, \dirname{texmf},
-\dirname{texmf-dist} a \dirname{tlpkg} na kl. To me njak as zabrat!
-Pokud koprujete na \acro{USB} kl formtovan jako \acro{FAT}32, nezapomete zruit %dereference
-symbolick odkazy (\code{cp -L}). Adres \dirname{texmf-local} na kli
-bude tak nalezen a pouit.
-
-Pak spuste skript \filename{tl-portable} z~koenovho adrese kle, jak bylo uvedeno ve.
-V~tom ppad bude skript vnmat kl jako zapisovateln a pouije ho pro vytvoen soubory.
-
-
-
-\section{\cmdname{tlmgr}: sprva va instalace}
-\label{sec:tlmgr}
-
-\begin{figure}[tb]
-\tlpng{tlmgr-gui}{\linewidth}
-\caption{\prog{tlmgr} v~reimu \GUI. Seznam balk/kolekc/schmat se uke a po kliknut na tlatko `Load'.}\label{fig:tlmgr.gui}
-\end{figure}
-
-\begin{figure}[tb]
-\tlpng{tlmgr-config}{\linewidth}
-\caption{\texttt{tlmgr} v~reimu GUI: konfiguran zloka}\label{fig:tlmgr.config} % Configuration tab
-\end{figure}
-
-Instalan program nainstaluje program nazvan \prog{tlmgr} pro sprvu \TL{}
-po vchoz instalaci. Programy \prog{updmap},
-\prog{fmtutil} a \prog{texconfig} jsou dosud zahrnut a zstanou i v~budoucnosti, avak preferovanm rozhranm je nyn \prog{tlmgr}.
-Jeho schopnosti zahrnuj:
-
-\begin{itemize*}
-\item vpis seznam schmat, kolekc a balk;
-\item instalaci, aktualizaci, zlohovn, obnoven a odinstalovn jednotlivch balk, voliteln se zapotnm zvislost; % optionally taking dependencies into account;
-\item vyhledvn balk;
-\item vpis seznamu a pidn architektur;
-\item zmna instalanch voleb jako napklad velikosti papru a umstn zdroj (viz sekci~\ref{sec:location}).
-\end{itemize*}
-\textit{Varovn:} \prog{tlmgr} nebyl uren pro nebo testovan s~instalacemi, kter jsou spoutn z~\DVD.
-
-\subsection{GUI reim \cmdname{tlmgr}}
-\prog{tlmgr} me bt sputn v~reimu \GUI{} povelem
-\begin{alltt}
-> \Ucom{tlmgr -gui}
-\end{alltt}
-nebo ve Windows prostednictvm Start menu: \texttt{Start}, \texttt{Programs},
-\texttt{TeX Live 2008}, \texttt{TeX Live Manager}. Po kliknut na `Load'
-se zobraz seznam balk, kter jsou k~dispozici, a nainstalovanch
-balk\Dash posledn zmnn jsou oznaeny `(i)'. Pochopiteln se
-pedpokld, e instalan zdroj je platn a dosaiteln.
-Obrzek~\ref{fig:tlmgr.config} ukazuje konfiguran zloku.
-
-
-\subsection{Vzorov realizace \cmdname{tlmgr} z~pkazovho dku}
-
-Tento pklad pid nkolik balk, vetn novho `motoru' (`engine'), z~nestandardn lokace:
-
-\begin{alltt}
-> \Ucom{tlmgr -location http://172.16.18.1/tldev install collection-xetex xkeyval}
-\end{alltt}
-Vytvo nsledujc vstup:
-\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/2008/texmf/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-config/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-dist/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-doc/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/../texmf-local/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-var/ls-R...
-mktexlsr: Done.
-regenerating fmtutil.cnf
-running fmtutil-sys --missing
-...
-Transcript written on xelatex.log.
-fmtutil: /usr/local/texlive/2008/texmf-var/web2c/xetex/xelatex.fmt installed.
-\end{fverbatim}
-Jak vidte, \prog{tlmgr} nainstaluje zvislosti a postar se o~vechny potebn poinstalan innosti, vetn aktualizace databze nzv soubor a (znovu)vygenerovn formt. (Tady jsme vytvoili nov formty pro \XeTeX.)
-
-Tento pklad instaluje nov jazyk. I toto spust znovuvytvoen formt:
-\begin{alltt}
-> \Ucom{tlmgr install collection-langdutch}
-\end{alltt}
-K~popisu balku zadejte:
-\begin{alltt}
-> \Ucom{tlmgr show collection-wintools}
-\end{alltt}
-co vytvo
-\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
-\end{fverbatim}
-Aktualizace cel vai instalace na nejnovj dostupn verze:
-\begin{alltt}
-> \Ucom{tlmgr update -all}
-\end{alltt}
-Pokud vs to znepokojuje, zkuste nejdve
-\begin{alltt}
-> \Ucom{tlmgr update -all -dry-run}
-\end{alltt}
-nebo
-\begin{alltt}
-> \Ucom{tlmgr update -list}
-\end{alltt}
-Pro plnou dokumentaci:
-\begin{alltt}
-> \Ucom{tlmgr -help}
-\end{alltt}
-
-\section{Poznmky o Windows}
-\label{sec:windows}
-
-\TL\ m jedin instalan program, kter b na obou systmech Windows
-a Unix. Toto bylo mon jenom snenm podpory starch verz Windows,
-proto je mon instalovat \TL{} pouze na Windows 2000 a novj.
-
-
-\subsection{Vlastnosti typick pro Windows} %Windows-specific features
-\label{sec:winfeatures}
-
-Pod Windows dl instalan program nkter dodaten vci:
-\begin{description}
-\item[Nabdky a zkratky.] Je nainstalovna nov poloka `\TL{}' nabdky
- Start, obsahujc vstupy pro nkter programy \GUI{}
- (\prog{tlmgr}, \prog{texdoctk}, prohle PostScriptu PS\_View)
- a trochu dokumentace. PS\_View tak zskv ikonku na pracovn ploe jako %a drag-and-drop
- cl pro PostScriptov soubory.
-\item[Automatick nastaven promnnch prosted.] dn run konfiguran kroky nejsou potebn.
-\item[Odinstaltor.] Instalan program vytvo poloku pro \TL{} pod nabdkou `Add/Remove
- Programs'. Vztahuje se k~tomu zloka `Uninstallation' programu \prog{tlmgr}.
-\end{description}
-
-\subsection{Dodaten obsaen software}
-
-\begin{figure}[tb]
-\tlpng{psview}{.6\linewidth}
-\caption{PS\_View: k~dispozici jsou velmi vysok zvten!}\label{fig:psview}
-\end{figure}
-
-
-Pro plnost, instalace \TL{} potebuje dal balky a programy,
-kter na stroji s~Windows obvykle nenajdete.
-
-\TL{} poskytuje chybjc sousti:
-\begin{description}
-\item[Perl a Ghostscript.] Kvli dleitosti Perlu a Ghostscriptu
- zahrnuje \TL{} `skryt' kopie tchto program.
- Programy \TL{}, kter je potebuj, vd, kde je najdou, ale
- neprozrazuj jejich ptomnost nastavenm promnnch prosted nebo
- registr. Nejsou to pln distribuce a nemly by peket dnm
- systmovm instalacm Perlu nebo Ghostscriptu.
-\item[Nstroje pkazovho dku.] ada bnch Unixovch program zench z~pkazovho dku je nainstalovanch pod Windows spolu s~bnmi binrkami \TL. Tyto zahrnuj programy \cmdname{gzip}, \cmdname{chktex},
- \cmdname{jpeg2ps}, \cmdname{unzip}, \cmdname{wget} a pomcky pkazovho dku %command-line utilities
- ze skupiny \cmdname{xpdf}. (Samotn prohle \cmdname{xpdf} nen k~dispozici pro Windows, ale je na nm zaloen prohle \acro{PDF} Sumatra:
- \url{http://blog.kowalczyk.info/software/sumatrapdf}.)
-\item[\texttt{fc-cache}] pomh \XeTeX{}u efektivnji zachzet s~fonty.
-\item[PS\_View.] PS\_View, nov prohle PostScriptu s~volnou (free) licenc, je tak nainstalovn; viz obrzek~\ref{fig:psview}.
-\end{description}
-\begin{description}
-\item[Podprn adres \texttt{support},] ji zmnn v~sekci~\ref{sec:tld}.
-Tento adres obsahuje rozlin programy, kter mou bt uiten ve spojen s~\TeX{}em, zvlt nkolik editor zamench na \TeX{} %\TeX-aware editors
-a \TeX{}ovskch pomcek (frontends). % frontends.
-Software v~tomto adresi nen pokryt instaltorem. Tento adres obsahuje t prohle \dvi{} \cmdname{dviout}; viz nsledujc sekci.
-\end{description}
-
-
-\subsection{The Dviout previewer}
-
-Bohuel toto vydn \TL{} nenabz nainstalovan prohle \dvi{} soubor pro Windows. Nicmn, mete si nainstalovat \prog{dviout} od
-Toshio Oshimy z~adrese \path{support/dviout/}, kter obsahuje rovn mal soubor \filename{README} popisujc instalaci a konfiguraci \prog{dviout} pro \TL. Pette si ho, prosm, peliv ped instalac.
-
-V~prvn ad, kdy si prohlte soubory pomoc \cmdname{dviout}, vytvo tento fonty, protoe obrazovkov fonty nebyly nainstalovny. Po chvli budete mt vytvoenou vtinu vmi pouvanch font a mlokdy uvidte okno s~vytvenm font.
-Dal informace je mon najt ve (velmi dobr) on-line npovd.
-
-
-\subsection{Odkazy na dodaten software s~monost staen z~internetu}
-
-Url adresy nkterch dalch nstroj, kter mete mt v~myslu instalovat:
-
-\begin{description}
-\item[\GS{}] \url{http://www.cs.wisc.edu/~ghost/}
-\item[Perl] \url{http://www.activestate.com/} s~pomocnmi balky z~\acro{CPAN}u: \url{http://www.cpan.org/}
-\item[ImageMagick] \url{http://www.imagemagick.com/} ke zpracovn a konverzi grafiky
-\item[NetPBM] \url{http://netpbm.sourceforge.net/} tak pro grafiku
-\item[\TeX{}ov editory] Mte irok vbr a je to
- individuln volba. Monosti jsou napklad tyto, bez zvltnho uspodn:
- \begin{itemize*}
- \item \cmdname{GNU Emacs} m pro Windows nativn podporu na
- \url{http://www.gnu.org/software/emacs/windows/ntemacs.html}
- \item \cmdname{Emacs} s~Auc\TeX{}em pro Windows je k~dispozici na \TL{} v~adresi \path{support}; jeho domovsk strnka je \url{http://www.gnu.org/software/auctex}.
- \item \cmdname{WinShell} je dostupn na \TL{} v~adresi
- \path|support|, jeho domovsk strnka je \url{http://www.winshell.de/}
- \item \cmdname{WinEdt} je shareware dostupn na \url{http://www.winedt.com/}
- \item \cmdname{Vim} je voln editor do\-stup\-n z~\url{http://www.vim.org/}
- \item TeXnicCenter je voln softvr, kter zskte na\\ \url{http://www.toolscenter.org/} a v~distribuci pro\TeX t. \item \cmdname{LEd} je dostupn z~\url{http://www.ctan.org/support/LEd}.
- \item \cmdname{SciTE} je dostupn z~\url{http://www.scintilla.org/SciTE.html}.
- \end{itemize*}
-\end{description}
-
-
-\subsection{User Profile je Home}
-\label{sec:winhome}
-
-Windowsovsk protjek domovskho (home) adrese Unixu je adres
-\verb|%USERPROFILE%|. Pod Windows XP a Windows 2000 je to obvykle
-\verb|C:\Documents and Settings\<username>| a pod Windows Vista
-\verb|C:\Users\<username>|. V~souboru
-\filename{texmf.cnf} a obecn pro \KPS{}, se bude \verb|~| expandovat
-pimen v~obou systmech Windows a Unix.
-
-
-\subsection{Registry Windows}
-\label{sec:registry}
-
-Windows ukld tm vechny konfiguran daje do svch registr. Registr
-obsahuje soubor hierarchicky uspodanch kl, s~nkolika koenovmi kli.
-Nejdleitj pro instalan programy jsou strun eeno
-\path{HKEY_CURRENT_USER} a \path{HKEY_LOCAL_MACHINE}, \path{HKCU} a
-\path{HKLM}. st \path{HKCU} registra je v~domovskm adresi uivatele (viz sekci~\ref{sec:winhome}). \path{HKLM} je obvykle v~podadresi adrese Windows.
-
-V~nkterch ppadech je mon zskat systmov informace z~promnnch
-prosted, ale pro dal informace, kupkladu umstn zkratek, je nutn
-nahldnout do registr. Trval nastaven promnnch prosted si rovn
-vyaduje pstup k~registrm.
-
-
-\subsection{Oprvnn Windows}
-\label{sec:winpermissions}
-
-V~novjch verzch Windows se dl rozdl mezi bnmi uivateli a
-administrtory, kdy pouze posledn zmnn maj voln pstup k~celmu
-operanmu systmu. Ve skutenosti mete tyto tdy uivatel radji
-oznait jako neprivilegovan uivatel a normln uivatel: bt
-administrtorem je pravidlo, ne vjimka. Pesto jsme se snaili uinit
-\TL{} instalovatelnm bez administrativnch vsad.
-
-Pokud je uivatel administrtor, odkazy (shortcuts) se vytvej pro
-vechny uivatele a systmov prosted se upravuje. Jinak jsou odkazy a
-poloky nabdky vytveny pro aktulnho uivatele a upravuje se prosted
-uivatele. Pouijte volbu \optname{non-admin} pro \prog{install-tl}, pokud
-upednostujete nastaven podle uivatele dokonce jako administrtor.
-
-Bez ohledu na status administrtora je standardn koenov adres \TL{}
-navren instalanm programem vdycky pod \verb|%PROGRAMFILES%|.
-Instaltor stle testuje, zda je root zapisovateln pro aktulnho
-uivatele.
-
-Problm se me vyskytnout, pokud uivatel nen administrtor a \TeX{} ji
-existuje ve vyhledvac cest. Protoe skuten cesta se sestv ze
-systmov cesty nsledovan uivatelskou cestou, nov \TL{} nikdy nezsk
-pednost.
-Jako dsledek %As a workaround,
-Toto instaltor obchz vytvoenm odkaz na pkazov dek
-(command-prompt), ve kterm je adres binrek novho \TL{}
-pedazen lokln vyhledvac cest. Nov \TL{} bude pouiteln, kdy
-bude bet v~relaci pkazovho dku sputn z~takovho odkazu.
-
-\begin{otherlanguage}{slovak}
-\frenchspacing
-% don't use \Webc so the \uppercase in the headline works.
-\section{Pouvatesk prruka ku systmu Web2C}
-\Webc{} obsahuje mnoinu \TeX-prbuznch programov, t.j.\ samotn \TeX{},
-\MF{}, \MP, \BibTeX{}, at. Je to srdce systmu \TL{}. Domovsk strnka \Webc{},
-s~aktulnou prrukou a almi vecami, je
-\url{http://tug.org/web2c}.
-
-Trochu histrie: originlna implementcia pochdza
-od Thomasa Rokickho, ktor v~roku 1987 vyvinul prv
-\TeX{}-to-C systm zaloen na zmenovch sboroch systmu pre Unix, ktor
-boli v~prvom rade pvodnou prcou Howarda Trickeya a Pavla Curtisa.
-Tim Morgan
-sa stal spravovateom systmu a poas jeho obdobia sa meno zmenilo
-na Web-to-C\@. V~roku 1990 Karl Berry prebral tto prcu,
-asistoval pri tuctoch dodatonch prspevkov a v~roku 1997 podal
-taktovku Olafovi Weberovi, ktor ju v~roku 2006 vrtil Karlovi.
-
-\Webc{} systm be pod Unixom, 32bitovmi Windows,
-\acro{MacOSX} a inmi operanmi systmami. Pouva originlne
-\TeX{} zdrojov sbory od Knutha a ostatn zkladn programy napsan
-v~systme kultivovanho programovania \web{}, ktor s preloen do zdrojovho kdu jazyka C.
-Zkladn programy \TeX{}u s spracovan tmto spsobom:
-\begin{description}
-\renewcommand{\makelabel}[1]{\descriptionlabel{\mdseries\cmdname{#1}}}
-\item[bibtex] Spravovanie bibliografi.
-\item[dmp] Konverzia \cmdname{troff} do MPX (\MP{} obrzky).
-\item[dvicopy] Vytvranie modifikovanej kpie \dvi{} sboru.
-\item[dvitomp] Konverzia \dvi{} do MPX (\MP{} obrzky).
-\item[dvitype] Konverzia \dvi{} do udsky itatenho textu.
-\item[gftodvi] Generovanie fontov pre nhad.
-\item[gftopk] Konverzia gf formtu fontov do pakovanch fontov.
-\item[gftype] Konverzia gf formtu fontov do udsky itatenho textu.
-\item[makempx] \MP{} znakov sdzanie.
-\item[mf] \MF{} -- vytvranie rodn fontov.
-\item[mft] Preddefinovan \MF ov zdrojov sbory.
-\item[mpost] \MP{} -- tvorba technickch diagramov.
-\item[mpto] \MP{} -- znakov vber.
-\item[newer] Porovnanie modifikanch asov.
-\item[patgen] Vytvarnie vzorov rozdeovania slov.
-\item[pktogf] Konverzia pakovanch formtov fontov do
-gf formtov.
-\item[pktype] Konverzia pakovanch psiem do udsky itatenho textu.
-\item[pltotf] Konverzia `Property list' do TFM.
-\item[pooltype] Zobrazovanie \singleuv{\web{} pool} sborov.
-\item[tangle] Konverzia \web{} sborov do Pascalu.
-\item[tex] \TeX{} -- sadzba.
-\item[tftopl] Konverzia TFM do `property list'.
-\item[vftovp] Konverzia virtulneho fontu do virtulneho `property list'.
-\item[vptovf] Konverzia virtulneho `property list' do virtulneho fontu.
-\item[weave] Konverzia \web{} sborov do \TeX u.
-\end{description}
-\noindent Presn funkcie a syntax tchto programov s popsan
-v~dokumentcich jednotlivch balkov alebo v~dokumentcii
-\Webc{}. Napriek tomu, poznanie niekokch princpov, ktor
-platia pre cel balk programov, vm pome vyai o najviac
-z~vaej \Webc{} intalcie.
-
-Vetky programy dodriavaj tandardn \GNU{} voby:
-
-\begin{description}
-\item[\texttt{--help}] Vypisuje prehad zkladnho pouvania.
-\item[\texttt{--verbose}] Vypisuje detailn sprvu spracovania.
-\item[\texttt{--version}] Vypisuje informciu o~verzii, potom skon.
-\end{description}
-
-Na vyhadvanie sborov pouvaj \Webc{} programy prehadvaciu
-kninicu \KPS{} (\url{http://tug.org/kpathsea}).
-Tto kninica pouva kombinciu premennch
-prostredia a niekokch konfiguranch sborov na optimalizciu
-prehadvania adresrovho stromu \TeX u{}. \Webc{} zvldne
-prcu s~viacermi adresrovmi stromami sasne, o je
-uiton, ak niekto chce udriava tandardn distribciu \TeX u a jeho
-loklne a osobn rozrenia v~rozlinch stromoch. Na urchlenie
-vyhadvania sborov, kore kadho stromu obsahuje sbor
-\file{ls-R} so zznamom obsahujcim meno a relatvnu cestu ku
-vetkm sborom umiestnenm pod tmto koreom.
-
-\subsection{Vyhadvanie ciest kninicou Kpathsea}
-\label{sec:kpathsea}
-
-Najprv popeme veobecn mechanizmus vyhadvania ciest
-kninicou \KPS{}.
-
-\emph{Vyhadvacou cestou} nazveme zoznam \emph{elementov cesty},
-ktormi s v~prvom rade men adresrov
-oddelen dvojbodkou alebo bodkoiarkou.
-Vyhadvacia cesta me pochdza z~viacerch zdrojov.
-Pri vyhadvan sboru \samp{my-file} poda cesty \samp{.:/dir},
-\KPS{} skontroluje kad element cesty: najprv \file{./my-file},
-potom \file{/dir/my-file}, vracajc prv zodpovedajci njden
-prvok (alebo prpadne vetky zodpovedajce prvky).
-
-Aby bolo dosiahnut prispsobenie sa konvencim o mono najviac
-operanch systmov, na neunixovch systmoch \KPS{} me pouva
-oddeovae nzvov sborov rzne od dvojbodky (\samp{:}) a
-lomtka (\samp{/}).
-
-Pri kontrolovan uritho elementu cesty \var{p} \KPS{} najprv
-over, i sa na na nevzahuje vopred vybudovan databza (pozri
-\singleuv{Data\-bza nzvov sborov} na
-strane~\pageref{sec:filename.database}), t.\,j., i sa databza nachdza
-v~adresri, ktor je prefixom \var{p}. Ak to tak je, pecifikcia
-cesty sa porovnva s~obsahom databzy.
-
-Ak databza neexistuje, alebo sa nevzahuje na tento element cesty, alebo
-sa v~nej hadan sbor nevyskytuje, cel systm sborov je prehadan
-(pokia to nebolo zakzan pecifikciou zanajcou \samp{!!} a
-hadan sbor mus existova). \KPS{} zostroj zoznam adresrov
-zodpovedajcich tomuto elementu cesty a potom skontroluje kad
-z~nich, i sa v~om nenachdza hadan sbor.
-
-Podmienka \singleuv{sbor mus existova\kern1pt} sa tka napr.\ sborov typu
-\samp{.vf} a vstupnch sborov tanch prkazom \TeX u \cs{openin}.
-Takto sbory nemusia existova (napr.\ \file{cmr10.vf}) a nebolo
-by dobr prehadva kvli nim cel disk. Preto, ak zabudnete
-aktualizova \file{ls-R} pri intalcii novho \samp{.vf} sboru,
-sbor nebude nikdy njden. Kad element cesty sa prekontroluje: najprv
-databza, potom disk. Ke je sbor njden, vyhadvanie sa zastav
-a vsledok je vrten.
-
-Hoci najjednoduch a najbenej element cesty je meno adresru,
-\KPS{} podporuje aj in zdroje vo vyhadvacch cestch: dedin
-(layered) tandardn hodnoty, men premennch prostredia, hodnoty
-sboru \file{config}, domce adresre pouvateov a rekurzvne
-prehadvanie podadresrov. Preto, ak hovorme, e \KPS{}
-\emph{rozbal} element cesty, znamen to, e pretransformuje vetky
-pecifikcie do zkladnho mena alebo mien adresrov. Toto je
-popsan v~nasledujcich odsekoch.
-
-Vimnite si, e ke je meno hadanho sboru vyjadren absoltne
-alebo explicitne relatvne, t.\,j.\ zana \samp{/} alebo \samp{./}
-alebo \samp{../}, \KPS{} jednoducho skontroluje, i tak sbor
-existuje.
-
-\ifSingleColumn
-\else
-\begin{figure*}
-\verbatiminput{examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{Ilustran prklad konfiguranho sboru}
- \label{fig:config.sample}
-\end{figure*}
-\fi
-
-\subsubsection{Zdroje cesty}
-\label{sec:pathsources}
-
-Vyhadvacia cesta me by vytvoren z~rznych zdrojov.
-\KPS{} ich pouva v~tomto porad:
-\begin{enumerate}
-\item
- Pouvateom nastaven premenn prostredia, naprklad \envname{TEXINPUTS}\@.
- Premenn prostredia s~pridanou bodkou a menom programu maj prednos pred
- premennmi rovnakho mena, ale bez prpony.
- Naprklad, ke \samp{latex} je meno prve beiaceho programu, potom
- premenn \envname{TEXINPUTS.latex} prepe \envname{TEXINPUTS}.
-\item
- Programovo-pecifick konfiguran sbor, naprklad riadok
- \singleuv{\texttt{S /a:/b}} v~sbore \file{config.ps} \cmdname{dvips}.
-\item Konfiguran sbor \KPS{} \Dash{} \file{texmf.cnf}, obsahujci riadok
- ako \samp{TEXINPUTS=/c:/d} (pozri alej).
-\item Predvolen hodnoty poas kompilcie.
-\end{enumerate}
-\noindent Vetky tieto hodnoty vyhadvacej cesty mete prezera
-pouitm ladiacch monost (pozri \singleuv{Ladenie} na
-strane~\pageref{sec:debugging}).
-
-\subsubsection{Konfiguran sbory}
-\tolerance=3500
-\KPS{} ta poas behu z~\emph {konfiguranch sborov}
-s~menom \file{texmf.cnf} vyhadvaciu cestu a alie defincie.
-Vyhadvacia cesta pouvan na hadanie tchto sborov sa
-vol \envname{TEXMFCNF} (v~predvolenom nastaven sa tento sbor
-nachdza v~podadresri \file{texmf/web2c}). \emph{Vetky} sbory
-\file{texmf.cnf} vo vyhadvacej ceste bud pretan a defincie
-v~poslednch natanch sborov maj prednos pred definciami
-tanmi predtm. Preto pri vyhadvacej ceste \verb|.:$TEXMF|, hodnoty
-z~\file{./texmf.cnf} prepu hodnoty z~\verb|$TEXMF/texmf.cnf|.
-\tolerance=1500
-
-\begin{itemize}
-\item
- Komentre zanaj znakom \singleuv{\texttt{\%}} a pokrauj do konca
- riadku.
-\item
- Przdne riadky s ignorovan.
-\item
- Znak \bs{} na konci riadku sli ako pokraovac znak, t.j.\
- nasledujci riadok je k~nemu pripojen. Przdne znaky na zaiatku
- pripjanch riadkov nie s ignorovan.
-\item
- Vetky ostatn riadky maj tvar:
-\begin{alltt}
- \var{variable}[.\var{progname}] [=] \var{value}
-\end{alltt}%
- kde \samp{=} a przdne znaky naokolo s nepovinn.
-\item
- Meno premennej \singleuv{\texttt{\var{variable}}} me obsahova
- akkovek znaky okrem przdnych znakov, \samp{=}, alebo \samp{.},
- ale obmedzi sa na znaky \samp{A-Za-z\_} je najbezpenejie.
-\item
- Ak je \singleuv{\texttt{.\var{progname}}} neprzdne, defincia sa
- pouije iba vtedy, ke prve beiaci program m meno
- \texttt{\var{progname}} alebo \texttt{\var{progname}.exe}.
- Toto umouje naprklad ma pre rzne nadstavby \TeX u rzne
- vyhadvacie cesty.
-\item Hodnota \singleuv{\texttt{\var{value}}} me obsahova akkovek
- znaky okrem \singleuv{\texttt{\%}} a \samp{@}. Na pravej strane nie je
- mon poui \singleuv{\texttt{\$\var{var}.\var{prog}}}; namiesto toho
- muste poui aliu premenn. Znak \samp{;} vo
- \singleuv{\texttt{\var{value}}} je preloen do \samp{:} ak sme pod
- operanm systmom Unix. Toto je uiton, ke chceme ma jedin
- \file{texmf.cnf} sbor pre systmy Unix, MSDOS a Windows.
-\item
- Vetky defincie s pretan skr, ako sa expanduj. Preto mu
- existova referencie na premenn skr, ako s tieto definovan.
-\end{itemize}
-Ukkov sek konfiguranho sboru, ilustrujci vinu
-tchto bodov\ifSingleColumn
-\ignorespaces:
-\verbatiminput{examples/ex5.tex}
-\else
-\space je na obrzku~\ref{fig:config.sample}.
-\fi
-
-\subsubsection{Expanzia cesty}
-\label{sec:pathexpansion}
-
-\KPS{} rozpoznva urit zvltne znaky a kontrukcie vo
-vyhadvacch cestch podobn tm, o existuj v~prostrediach
-unixovskch interprtov prkazovho riadku (shells). Ako veobecn
-prklad uvedieme komplexn cestu \verb+~$USER/{foo,bar}//baz+, %$
-ktor sa expanduje do vetkch podadresrov pod adresrmi \file{foo} a \file{bar}
-v~domovskom adresri pouvatea \texttt{\$USER}, ktor obsahuje
-adresr alebo sbor \file{baz}. Tieto kontrukcie s popsan
-v~alch odsekoch.
-
-\subsubsection{Predvolen expanzia}
-\label{sec:defaultexpansion}
-\tolerance=2500
-Ak vyhadvacia cesta s~najvou prioritou (pozri \singleuv{Zdroje cesty}
-na strane~\pageref{sec:pathsources}) obsahuje \emph{dvojbodku
-navye} (t.j.\ zaiaton, koncov, alebo zdvojen), \KPS{} vlo na
-toto miesto vyhadvaciu cestu s~druhou najvyou prioritou, ktor
-je definovan. Ak tto vloen cesta obsahuje dvojbodku navye, to
-ist sa stane s~alou najvznamnejou cestou. Keby sme mali
-naprklad dan takto nastavenie premennej prostredia
-\tolerance=1500
-\begin{alltt}
->> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
-a hodnotu \code{TEXINPUTS} v~sbore \file{texmf.cnf}
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
-potom konen hodnota pouit na vyhadvanie by bola:
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-Kee by bolo zbyton vklada predvolen hodnotu na viac ako jedno
-miesto, \KPS{} men iba nadbyton \samp{:}\ a vetko ostatn
-ponechva na mieste. Najprv kontroluje zaiaton \samp{:}, potom
-koncov \samp{:} a potom zdvojen \samp{:}.
-
-\subsubsection{Expanzia ztvoriek}
-Uiton rta je expanzia ztvoriek, ktor funguje tak, e
-naprklad \verb+v{a,b}w+ sa expanduje na \verb+vaw:vbw+. Vnranie je
-povolen. Toto sa pouva na implementciu viacnsobnch
-\TeX{}ovskch hierarchi, priradenm hodnoty \code{\$TEXMF}
-s~pouitm ztvoriek. Naprklad v~sbore \file{texmf.cnf} njdete
-nasledujcu definciu (pribline,
-v~skutonosti je tam ete viac stromov):
-\begin{verbatim}
- TEXMF = {$HOMETEXMF,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN}
-\end{verbatim}
-Ke potom napete nieo podobn ako
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-%$
-bude to znamena, e po hadan v~aktulnom adresri sa najprv
-prehad cel
-strom \code{\$HOMETEXMF/tex}, \code{\$TEXMFLOCAL/tex},
-\code{\$TEXMFVAR/tex} a \code{\$TEXMFMAIN/tex} (posledn dva
-s~pouitm databzovch sborov \file{ls-R}). Je to vhodn spsob ako
-spa dve paraleln \TeX{} truktry, jednu nemenn
-(naprklad na \CD) a druh neustle aktualizovan novmi
-verziami, akonhle s dostupn. Pouitm premennej
-\code{\$TEXMF} vo vetkch defincich mme istotu, e sa vdy ako
-prv prehad aktulny strom.
-
-\subsubsection{Expanzia podadresrov}
-\label{sec:subdirectory.expansion}
-
-Dva alebo viac za sebou nasledujcich znakov \samp{/}
-v~elemente cesty nasledujcom za adresrom \var{d} je nahradench vetkmi
-podadresrmi \var{d}: najprv podadresrmi priamo pod \var{d}, potom
-podadresrmi pod nimi, at. Poradie, v~akom s prehadvan
-podadresre na kadej rovni, \emph{nie je pecifikovan}.
-
-Ak po \samp{//} pecifikujete akkovek komponenty mena sboru,
-pridaj sa iba pod\-adre\-sre so zodpovedajcimi komponentami.
-Naprklad, \samp{/a//b} sa expanduje do
-adresrov \file{/a/1/b}, \file{/a/2/b},
-\file{/a/1/1/b}, at, ale nie do \file{/a/b/c} alebo \file{/a/1}.
-
-Viacnsobn kontrukcie \samp{//} v~ceste s mon, ale
-pouitie \samp{//} na zaiatku cesty je ignorovan.
-
-\subsubsection{Typy pecilnych znakov a ich vznam: zhrnutie}
-Nasledujci zoznam zaha %B% vznam
-zvltne znaky v~konfiguranch
-sboroch \KPS{}.
-
-% need a wider space for the item labels here. 3em instead of 2em
-\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
-\begin{description}
-\item[\CODE{:}]Oddeova v~pecifikcii cesty; na zaiatku alebo
- na konci cesty nahrdza predvolen expanziu cesty.\par
-\item[\CODE{;}]Oddeova v~neunixovch systmoch (sprva sa ako
- \samp{:}).
-\item[\CODE{\$}]Expanzia premennej.
-\item[\CODE{\string~}] Reprezentuje domovsk adresr pouvatea.
-\item[\CODE{\char`\{...\char`\}}] Expanzia ztvoriek, napr.\
- z~\verb+a{1,2}b+ sa stane \verb+a1b:a2b+.
-\item[\CODE{//}] Expanzia podadresrov. (Me sa
- vyskytn kdekovek v~ceste, okrem jej zaiatku).
-\item[\CODE{\%}] Zaiatok komentru.
-\item[\CODE{\bs}] Znak pokraovania riadku (umouje viacriadkov vstupy).
-\item[\CODE{!!}] Povel na hadanie sboru \emph{iba} v~databze,
- neprehadva disk.
-\end{description}
-
-\subsection{Databzy nzvov sborov}
-\label{sec:filename.database}
-
-\KPS{} minimalizuje prstupy na disk pri vyhadvan. Predsa vak
-pri intalcich s~dostatonm mnostvom adresrov hadanie sboru
-v~kadom monom adresri me zabra prehnane vea asu (toto plat
-zvlṻ vtedy, ke musia by prejden stovky adresrov s~fontami).
-\KPS{} preto pouva externe vytvoren \singleuv{databzov} sbor
-nazvan \file{ls-R}, ktor mapuje sbory v~adresroch a pomha tak
-vyhn sa vyerpvajcemu prehadvaniu disku.
-
-Skratky mien (\file{aliases}) v~druhom databzovom sbore vm
-umouj da dodaton men sborom nachdzajcim sa
-v~zozname \file{ls-R}. Toto me by uiton pri prispsobovan sa
-sborovm konvencim 8.3 DOSu v~zdrojovch sboroch.
-
-\subsubsection{Sborov databza}
-\label{sec:ls.R}
-
-Ako bolo vysvetlen hore, meno hlavnej databzy sborov mus
-by \file{ls-R}. Mete umiestni jednu do korea kadej hierarchie
-\TeX u{} vo svojej intalcii, ktor chcete, aby bola prehadvan
-(predvolen je \code{\$TEXMF}); vinou sa jedn iba o~jednu
-hierarchiu. \KPS{} had \file{ls-R} sbory poda cesty
-v~\code{TEXMFDBS}.
-
-Odporan spsob ako vytvori a udriava \samp{ls-R} je spusti
-skript \code{mktexlsr} zahrnut v~distribcii. Je vyvolvan
-rznymi \samp{mktex...} skriptami. Tento skript v~princpe iba
-spa prkaz
-\begin{alltt}
-cd \var{/your/texmf/root} && \path|\|ls -1LAR ./ >ls-R
-\end{alltt}
-predpokladajc, e \code{ls} vho systmu vytvra sprvny vstup
-(vstup \GNU \code{ls} je v~poriadku). Aby ste sa ubezpeili,
-e databza bude vdy aktulna, najjednoduchie je pravidelne ju
-prebudovva cez \code{cron},
-take po zmench v~intalovanch
-sboroch \Dash\ naprklad pri intalcii alebo aktualizcii balka
-\LaTeX u{} \Dash\ bude sbor \file{ls-R} automaticky aktualizovan.
-
-Ak sbor nie je v~databze njden, poda predvolenho nastavenia
-\KPS{} zane vyhadva na disku. Ak vak urit element cesty
-zana \samp{!!}, bude prehadvan \emph{iba} databza, nikdy nie
-disk.
-
-\subsubsection{kpsewhich: samostatn prehadvanie cesty}
-\label{sec:invoking.kpsewhich}
-
-Program \texttt{kpsewhich} vykonva prehadvanie cesty nezvisl
-od kadej aplikcie. Me by uiton ako vyhadvac \code{find}
-program na njdenie sborov v~hierarchich \TeX u{} (vemi sa
-vyuva v~distribuovanch \samp{mktex}\dots\ skriptoch).
-
-\begin{alltt}
->> \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}}
-\end{alltt}
-Voby pecifikovan v~\singleuv{\texttt{\var{option}}} mu zana bu
-\samp{-} alebo \samp{-{}-} a kad skratka, ktor nie je viacznan, je
-akceptovan.
-
-\KPS{} povauje kad element vstupnho riadku, ktor nie je
-argumentom nejakej voby, za meno sboru, ktor had, a
-vracia prv sbor, ktor njde. Neexistuje voba umoujca
-vrti vetky sbory s~uritm menom (na to mete poui
-nstroj Unixu \samp{find}).
-
-Najbenejie voby s popsan niie.
-\begin{description}
-\item[\CODE{--dpi=num}]\hfill\break
- Nastav rozlenie na \singleuv{\texttt{\var{num}}}; toto m vplyv iba na
- \samp{gf} a \samp{pk} vyhadvanie. \samp{-D} je synonymom, kvli
- kompatibilite s~\cmdname{dvips}. Predvolen hodnota je~600.
-\item[\CODE{--format=name}]\hfill\break
- Nastav formt na vyhadvanie na \singleuv{\texttt{\var{name}}}. Poda
- predvolenho nastavenia je formt uhdnut z~mena sboru. Pre formty,
- ktor nemaj asociovan jednoznan prponu, ako naprklad podporn
- sbory \MP u a konfiguran sbory \cmdname{dvips}, muste
- pecifikova meno ako znme pre \KPS{}, tak ako
- \texttt{tex} alebo \texttt{enc files}. Zoznam zskate spustenm
- \texttt{kpsewhich -{}-help}.
-
-\item[\texttt{--mode=\var{string}}]\mbox{}\\
- Nastav meno mdu na \singleuv{\texttt{\var{string}}}; toto m vplyv iba na
- \samp{gf} a \samp{pk} vyhadvanie. iadna predvolen hodnota:
- kad md bude njden.
-\item[\texttt{--must-exist}]\mbox{}\\
- Urob vetko preto, aby si naiel sbory. Ak je to potrebn,
- vrtane hadania na disku. Normlne je v~zujme efektvnosti
- prehadvan iba databza \file{ls-R}.
-\item[\texttt{--path=\var{string}}]\mbox{}\\
- Vyhadvaj poda cesty \singleuv{\texttt{\var{string}}} (oddeovan dvojbodkou
- ako zvyajne) namiesto hdania vyhadvacej cesty z~mena sboru.
- Podporovan s \samp{//} a vetky ben expanzie. Voby \samp{--path}
- a \samp{--format} sa vzjomne vyluuj.
-\item[\texttt{--progname=\var{name}}]\mbox{}\\
- Nastav meno programu na \singleuv{\texttt{\var{name}}}. Toto nastavenie ovplyvuje
- pouitie vyhadvacej cesty cez nastavenie \singleuv{\texttt{.\var{progname}}}
- v~konfiguranch sboroch. Predvolen hodnota je \samp{kpsewhich}.
-\item[\texttt{--show-path=\var{name}}]\mbox{}\\
- Zobraz cestu pouit na vyhadvanie sboru s~typom
-\singleuv{\texttt{\var{name}}}.
- Me by pouit bu sborov prpona (\samp{.pk}, \samp{.vf} a pod.)
- alebo meno, podobne ako vo vobe \samp{--format}.
-\item[\texttt{--debug=\var{num}}]\mbox{}\\
- Nastav masku vberu ladiacch monost na \singleuv{\texttt{\var{num}}}.
-\end{description}
-
-\subsubsection{Prklady pouitia}
-\label{sec:examples-of.use}
-
-Pozrime sa na \KPS{} v~akcii. Za podiarknutm prkazom nasleduje
-vsledok vyhadvania v~nasledujcich riadkoch.
-\begin{alltt}
-> \Ucom{kpsewhich article.cls}
-/usr/local/texmf-dist/tex/latex/base/article.cls
-\end{alltt}
-Hadme sbor \file{article.cls}. Kee prpona \samp{.cls} je
-jednoznan, nemusme pecifikova, e hadme sbor typu \singleuv{tex}
-(zdrojov sbor \TeX{}). Njdeme ho v~podadresri
-\file{tex/latex/base} pod koreovm adresrom
-\samp{TEXMF-dist}. Podobne, vetky nasledujce sbory bud njden bez
-problmov vaka ich jednoznanej prpone.
-\begin{alltt}
-> \Ucom{kpsewhich array.sty}
- /usr/local/texmf-dist/tex/latex/tools/array.sty
-> \Ucom{kpsewhich latin1.def}
- /usr/local/texmf-dist/tex/latex/base/latin1.def
-> \Ucom{kpsewhich size10.clo}
- /usr/local/texmf-dist/tex/latex/base/size10.clo
-> \Ucom{kpsewhich small2e.tex}
- /usr/local/texmf-dist/tex/latex/base/small2e.tex
-> \Ucom{kpsewhich tugboat.bib}
- /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-Mimochodom, poslednm sborom je bibliografick databza \BibTeX u pre
-lnky \textsl{TUGBoatu}.
-
-\begin{alltt}
-> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
-Bitmapov sbory fontov typu \file{.pk} sa pouvaj zobrazovacmi
-programami ako \cmdname{dvips} a \cmdname{xdvi}. V~tomto prpade
-je vrten przdny vsledok, kee neexistuj iadne vopred
-generovan Computer Modern \samp{.pk} sbory v~naom systme
-(vzhadom na to, e v~\TL{} implicitne pouvame verzie Type1 ).
-\begin{alltt}
-> \Ucom{kpsewhich wsuipa10.pk}
-\ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
-\else /usr/local/texmf-var/fonts/pk/ljfour/public/
-... wsuipa/wsuipa10.600pk
-\fi\end{alltt}
-
-Pre tieto fonty (fonetick abecedu z~University of Washington) sme museli vygenerova\
-\samp{.pk} sbory. Kee predvolen md \MF u v~naej intalcii
-je \texttt{ljfour} so zkladnm rozlenm 600~dpi (dots per inch),
-je vrten tto intancia.
-\begin{alltt}
-> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
-\end{alltt}
-V~tomto prpade po pecifikovan, e ns zaujma rozlenie 300~dpi
-(\texttt{-dpi=300}), vidme, e tak font nie je v~systme
-k~dispozcii. Programy ako \cmdname{dvips} alebo \cmdname{xdvi}
-by v~tomto prpade vytvorili poadovan \texttt{.pk} sbory, pouijc skript \cmdname{mktexpk}.
-
-Teraz obrme nau pozornos na hlavikov a konfiguran sbory
-\cmdname{dvips}. Najprv sa pozrieme na jeden z~bene pouvanch
-sborov, veobecn prolgov \file{tex.pro} na pod\-poru \TeX u{},
-potom pohadme konfiguran sbor (\file{config.ps}) a
-PostScriptov mapu fontov \file{psfonts.map} \Dash %B% as of 2004,
-mapov a kdov sbory maj svoje vlastn cesty na vyhadvanie a nov umiestnenie v~stromoch \dirname{texmf}.
-
-Kee prpona
-\samp{.ps} je ne\-jed\-no\-znan, musme pre sbor \texttt{config.ps}
-pecifikova explicitne, o ktor typ sa zaujmame (\optname{dvips
-config}).
-\begin{alltt}
-> \Ucom{kpsewhich tex.pro}
- /usr/local/texmf/dvips/base/tex.pro
-> \Ucom{kpsewhich --format=`dvips config' config.ps}
- /usr/local/texmf/dvips/config/config.ps
-> \Ucom{kpsewhich psfonts.map}
- /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map
-\end{alltt}
-
-Teraz sa pozrieme na podporn sbory URW Times PostScript.
- V~Berryho schme meno pre
-tieto pomenovania fontov je \uv{\texttt{utm}}. Prv
-sbor, ktor hadme, je konfiguran sbor, ktor obsahuje meno
-mapovho sboru:
-\begin{alltt}
-> \Ucom{kpsewhich --format="dvips config" config.utm}
- /usr/local/texmf-dist/dvips/psnfss/config.utm
-\end{alltt}
-Obsah tohoto sboru je
-\begin{alltt}
- p +utm.map
-\end{alltt}
-o odkazuje na sbor \file{utm.map}, ktor ideme alej hada.
-\begin{alltt}
-> \Ucom{kpsewhich utm.map}
- /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
-\end{alltt}
-Tento mapov sbor definuje men sborov fontov typu Type1
-PostScript v~kolekcii URW. Jeho obsah vyzer takto (zobrazili sme
-iba jeho as):
-\begin{alltt}
- utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
- utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
- utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
- utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
- utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
- utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
-Zoberme naprklad intanciu Times Regular \file{utmr8a.pfb} a
-njdime jej pozciu v~adresrovom strome \file{texmf} pouitm
-vyhadvania fontovch sborov Type1:
-\begin{alltt}
-> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
-\else /usr/local/texmf-dist/fonts/type1/
-... urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
-Z~tchto prkladov by malo by zrejm, ako ahko mete njs
-umiestnenie danho sboru. Toto je zvlṻ dleit, ke mte
-podozrenie, e ste narazili na zl verziu sboru,
-pretoe \cmdname{kpsewhich} emuluje vyhadvanie
-plne rovnakm spsobom ako skuton program (\TeX{}, dvips a pod).
-
-
-\subsubsection{Ladiace innosti}
-\label{sec:debugging}
-
-Niekedy je potrebn vyetri, ako program rozpoznva referencie na
-sbory. Aby toto bolo mon vhodne uskutoni, \KPS{} ponka rzne
-stupne ladenia:
-\begin{itemize}
-\item[\texttt{\ 1}] Volania \texttt{stat} (testy sborov). Pri behu
- s~aktulnou \file{ls-R} databzou by nemal da takmer iaden vstup.
-\item[\texttt{\ 2}] Referencie do haovacch tabuliek (ako \file{ls-R}
- databzy, mapov sbory, konfiguran sbory).
-\item[\texttt{\ 4}] Opercie otvrania a zatvrania sboru.
-\item[\texttt{\ 8}] Veobecn informcia o ceste pre typy sborov
- hadanch \KPS. Toto je uiton pri zisovan, kde bola definovan
- urit cesta pre dan sbor.
-\item[\texttt{16}] Adresrov zoznam pre kad element cesty (vzahuje
- sa iba na vyhadvanie na disku).
-\item[\texttt{32}] Vyhadvanie sborov.
-\item[\texttt{64}] Premenliv hodnoty.
-\end{itemize}
-Hodnota \texttt{-1} nastav vetky horeuveden voby, v~praxi
-pravdepodobne vdy pouijete tieto rovne, ak budete potrebova
-akkovek ladenie.
-
-Podobne s~programom \cmdname{dvips} nastavenm kombincie
-ladiacch prepnaov mete detailne sledova, odkia sa ber
-pouvan sbory. Aktulny popis parametrov je mon njs
-v~\path{../texmf/doc/html/dvips/dvips_2.html}. Alternatvne,
-ke sbor nie je njden,
-ladiaca cesta ukazuje, v~ktorch adresroch program dan sbor
-hadal, o me naznaova, v~om sa asi vyskytol problm.
-
-Veobecne povedan, kee vina programov vol kninicu \KPS{}
-vntorne, ladiace voby je mon nastavi pomocou premennej
-prostredia \envname{KPATHSEA\_DEBUG} na potrebn kombinciu, ako je
-to popsan v~horeuvedenom zozname.
-
-(Poznmka pre pouvateov Windows: nie je jednoduch
-presmerova vetky hlky v~tomto systme do sboru.
-Na diagnostick\'e ely mete doasne priradi\hfill\\
-\texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log}).
-
-
-Uvaujme ako prklad mal zdrojov sbor
-\LaTeX u{}, \file{hello-world.tex}, ktor obsahuje nasledujci vstup.
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
-Tento mal sbor pouva iba font \file{cmr10}, take pozrime sa,
-ako \cmdname{dvips} pripravuje PostScriptov sbor (chceme poui
-Type1 verziu psiem Computer Modern, preto je nastaven
-voba \texttt{-Pcms}\footnote{Od verzie \TL{}~7 nie
-je nutn tto vobu nastavova, pretoe Type~1 fonty s
-natan implicitne.}.
-\begin{alltt}
-> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
-V~tomto prpade sme skombinovali \cmdname{dvips} ladiacu
-triedu~4 (cesty k~fontom) s~expanziou elementu cesty \KPS\
-(pozri Referenn Manul
-\cmdname{dvips}, \OnCD{texmf/doc/html/dvips/dvips_toc.html}).
-%\ifSingleColumn
-%We get something
-%like the following (we have rearranged the output for easier display):
-%\begin{alltt}\small
-%\input{examples/ex6.tex}
-%\end{alltt}
-%\else
-Vstup, trochu preusporiadan, je zobrazen na
-obrzku~\ref{fig:dvipsdbga}.
-
-\begin{figure*}[tp]
-\centering
-\input{examples/ex6a.tex}
-\caption{Hadanie konfiguranch sborov}\label{fig:dvipsdbga}
-
-\bigskip
-
-\input{examples/ex6b.tex}
-\caption{Hadanie \singleuv{prolog} sboru}\label{fig:dvipsdbgb}
-
-\bigskip
-
-\input{examples/ex6c.tex}
-\caption{Hadanie sboru fontu}\label{fig:dvipsdbgc}
-\end{figure*}
-
-
-%\input{examples/ex6skfromtl6.tex} % TODO: Janka -- treba aktualizovat
-% z ../examples/ex6*.tex
-
-\cmdname{dvips} zane lokciou svojich pracovnch sborov. Najprv je
-njden \file{texmf.cnf}, ktor obsahuje defincie vyhadvacch
-ciest ostatnch sborov, potom databza sborov \file{ls-R} (na
-optimalizciu vyhadvania sborov) a skratky mien sborov
-(\file{aliases}), o rob monm deklarova viacero mien (napr.\
-krtke meno typu \singleuv{8.3} ako v~\acro{DOS}e a dlhiu prirodzenejiu
-verziu) pre ten ist sbor. Potom \cmdname{dvips} pokrauje
-v~hadan veobecnho konfiguranho sboru \file{config.ps} skr,
-ako zane hada sbor nastaven \file{.dvipsrc} (ktor, v~tomto
-prpade, \emph{nie je njden}). Nakoniec, \cmdname{dvips} njde
-konfiguran sbor pre font Computer Modern PostScript,
-\file{config.cms} (toto bolo iniciovan vobou\texttt{-Pcms}
-v~prkaze \cmdname{dvips}). Tento sbor obsahuje zoznam \uv{mapovch}
-sborov, ktor definuj vzah medzi menami fontov v~\TeX u,
-PostScripte a systme sborov.
-\begin{alltt}
-> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
- p +ams.map
- p +cms.map
- p +cmbkm.map
- p +amsbkm.map
-\end{alltt}
-\cmdname{dvips} preto pokrauje v~hadan vetkch tchto sborov plus
-veobecnho mapovho sboru \file{psfonts.map}, ktor sa nata
-vdy (obsahuje deklarcie bene pouvanch PostScriptovch fontov;
-pozri posledn as sekcie~\ref{sec:examples-of.use}, kde sa nachdza
-viac detailov o narban s~mapovmi sbormi PostScriptu).
-
-V~tomto bode sa \cmdname{dvips} identifikuje
-pouvateovi\,\ldots
-\begin{alltt}\ifSingleColumn
-This is dvips 5.78 Copyright 1998 Radical Eye Software
- (www.radicaleye.com)
-\else\small{}This is dvips 5.78 Copyright 1998 Radical Eye ...
-\fi\end{alltt}% decided to accept slight overrun in tub case
-
-\ifSingleColumn
-\noindent\ldots potom pokrauje v~hadan prolgovho sboru
-\file{texc.pro}:
-
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
-potom pokrauje v~hadan prolgovho sboru
-\file{texc.pro} (pozri obrzok~\ref{fig:dvipsdbgb}).
-\fi
-Po njden tohoto sboru, \cmdname{dvips} vype na vstup dtum a
-as a informuje ns, e vygeneruje sbor \file{hello-world.ps}, e
-potrebuje sbor s~fontom \file{cmr10}, ktor bude deklarovan ako
-\uv{rezidentn}:
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
-Teraz sa rozbehne hadanie sboru \file{cmr10.tfm}, ktor je
-njden, potom je referencovanch ete niekoko prolgovch sborov
-(nezobrazen) a nakoniec je njden intancia fontu
-Type1, \file{cmr10.pfb}, ktor je pridan do vstupnho sboru
-(pozri posledn riadok).
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-\subsection{Monosti nastavenia za behu programu}
-alou z~peknch t distribcie \Webc{} je monos kontroly
-mnostva pamovch parametrov (najm vekosti pol) za behu
-prostrednctvom sboru \file{texmf.cnf},
-ktor ta kninica \KPS{}. Nastavenia vetkch parametrov mete
-njs v~asti~3 tohto sboru. Najdleitejie riadiace
-premenn (sla riadkov sa vzahuj na sbor \file{texmf.cnf}):
-
-\begin{description}
-\item[\texttt{main\_memory}]
- Celkov poet dostupnch slov v~pamti pre \TeX{}, \MF{} a \MP.
- Muste vytvori nov formtov sbor pre kad odlin nastavenie.
- Naprklad mete vygenerova \uv{obrovsk} verziu \TeX u{}
- a zavola sbor s~formtom \texttt{hugetex.fmt}. S~po\-uitm
- tandardnej pecifikcie mena programu pouvanho kninicou
- \KPS{}, konkrtna hodnota premennej \texttt{main\_memory} sa nata zo
- sboru \file{texmf.cnf}.
- %B% (porovnaj veobecn hodnotu a \uv{obrovsk} hodnotu, ktor sa intancuje cez \texttt{hugetex}, at.).
-\item[\texttt{extra\_mem\_bot}]
- Dodaton priestor pre \uv{vek} dtov truktry \TeX u{}:
- \uv{boxy}, \uv{glue}, \uv{break\-point(y)} a podobne.
- Je to uiton hlavne ak pouvate \PiCTeX{}.
-%%PS (riadok 300).
-\item[\texttt{font\_mem\_size}]
- Poet dostupnch slov pre informciu o fontoch v~\TeX u. Toto je
- viac-menej celkov vekos vetkch pretanch \acro{TFM} sborov.
-\item[\texttt{hash\_extra}]
- Dodaton priestor pre haovaciu tabuku mien riadiacej sekvencie.
- Len $\approx$10\,000 riadiacich sekvenci me by uloench v~hlavnej
- haovacej tabuke; ak mte vek knihu s~mnohmi krovmi odkazmi,
- toto nemus stai. Implicitn hodnota \texttt{hash\_extra} je \texttt{50000}.
- %B% Vidte, e obidve volania programov \cmdname{hugetex} a \cmdname{pdftex} poaduj
- %B% dodatonch 15\,000 riadiacich sekvenci (preddefinovan hodnota
- %B% hash\_extra je nula).
-\end{description}
-
-Samozrejme, tento prvok neme nahradi naozajstn dynamick polia
-a alokcie pamte, ale kee tieto sa vemi ako implementuj
-v~sasnej verzii \TeX u, tieto parametre poas behu programu
-poskytuj praktick kompromis, ktor dovouje aspo nejak
-flexi\-bilitu.
-\end{otherlanguage}
-
-\begin{comment}
-\section{Peklad pro novou unixovou platformu}
-
-Pokud pouvte platformu, pro kterou neposkytujeme binrky, nezbude vm
-nic jinho, ne si je vytvoit ze zdrojk sami.
-Nen to tak tk, jak se traduje i zd. Ve, co je teba, najdete
-v~adresi \texttt{source} distribuce.
-
-\subsection{Pedpoklady spchu}
-
-Budete potebovat alespo 100~Mebibyt diskovho prostoru na kompilaci
-celho \TeX{}u a podprnch program. Budete tak potebovat kompiltor
-\acro{ANSI}~C, program \cmdname{make}, lexikln analyztor a genertor
-pekladae. Doporuujeme \GNU{} verze tchto program
-(\cmdname{gcc}, \GNU \cmdname{make}, \cmdname{m4}, \cmdname{flex},
-\cmdname{bison}). Mon uspjete i s~jinmi verzemi kompiltoru~C,
-programu \cmdname{make} a dalch program, ale budete potebovat
-dobrou znalost kompilace unixovch program pro een koliz.
-
-Tak pkaz \texttt{uname} mus vracet rozumn hodnoty.
-
-
-\subsection{Konfigurace}
-
-Pro zatek provete normln instalaci \TL{} na v disk (viz
-oddl~\ref{sec:install.disk} na
-stran~\pageref{sec:install.disk}). Mete peskoit instalaci
-vech pedkompilovanch binrek.
-
-Potom rozbalte zdroje z~komprimovanho \texttt{tar} archvu z~adrese
-\dirname{source} na svj disk a pejdte do adrese, kam jste zdroje
-rozbalili.
-
-Potom spuste program \cmdname{configure} napklad takto:
-\begin{alltt}
-> \Ucom{sh configure -prefix=/usr/local/TeX}
-\end{alltt}
-
-Adres udan pepnaem \optname{-prefix} je ten, kam jste instalovali
-pomocn texmf strom; struktura adres bude jak je popsno ne (piem
-\$TEXDIR je adres, kter jste zvolili):
-
-\noindent
-\begin{tabularx}{\textwidth}{@{}>{\ttfamily}lX@{}}
- \dirname{$TEXDIR/share/texmf} & hlavn strom s~fonty, makry, atp.\\
- \dirname{$TEXDIR/man} & unixov manulov strnky\\
- \dirname{$TEXDIR/info} & \GNU style Info manuly\\
- \dirname{$TEXDIR/bin/$PLATFORM} & binrky
-\end{tabularx}
-%$
-
-Pokud chcete zruit extra rove adres \dirname{$PLATFORM} pro kadou
-platformu, t.j.\ uloit binrky do adrese \dirname{$TEXDIR/bin},
-specifikujte volbu \verb|--disable-multiplatform| pro \cmdname{configure}.
-
-Podvejte se na vstup pkazu \verb|./configure --help| pro popis
-dalch pepna, kter mete chtt pout. Napklad mete chtt
-vynechat peklad \OMEGA{}y i \eTeX{}u.
-
-
-\subsection{Sputn \cmdname{make}}
-
-Ovte, zda promnn prosted nebo volba \texttt{noclobber} nen nastavena.
-Potom spuste hlavn \cmdname{make} takto:
-\begin{alltt}
-> \Ucom{make world}
-\end{alltt}
-a dejte si chvli oddechu\ldots
-
-Ppadn si mete zaznamenat vechen vstup takto:
-\begin{alltt}
-> \Ucom{sh -c \string"make world >world.log 2>\&1\string" \&}
-\end{alltt}
-
-Pedtm ne uvte, e vechno je v~podku, zkontrolujte
-logovac soubor na chyby: \GNU \cmdname{make} vdy pouv etzec
-\samp{***}, kdykoliv pkaz sele. Tak zkontrolujte, zda vechny programy
-byly opravdu peloeny:
-
-\begin{alltt}
-> \Ucom{cd \var{TEXDIR}/bin/\var{archname}}
-> \Ucom{ls | wc}
-\end{alltt}
-Vsledkem by mlo bt pes 200 program (mete zkontrolovat pesn
-poet s~adresi \dirname{bin} na~distribunm mdiu).
-
-Pro zvren \texttt{make install} budete potebovat rootovsk
-oprvnn, take mete rozdlit \samp{make world} na dv sti:
-\begin{alltt}
-> \Ucom{make all}
-> \Ucom{su}
-> \Ucom{make install strip}
-\end{alltt}
-
-Pot, co instalujete vechny binrky, mli byste provst
-normln postinstalan proceduru, jak je popsna
-v~oddle~\ref{sec:postinstall}
-na stran~\pageref{sec:postinstall}.
-
-Kdy budete chtt zpstupnit svoje binrky ostatnm,
-prosme kontaktujte ns.
-R\'adi je umstme na webov\'e strnky \TL.
-\end{comment}
-
-\section{Podkovn}
-
-\TL{} je vsledkem spolenho sil tm vech skupin uivatel \TeX u.
-Toto vydn editoval \TL{} Karl Berry.
-Seznam ostatnch hlavnch pisp\v{e}vatel, minulch i souasnch, nsleduje. Dkujeme:
-
-%B% Toto vydn \TL{} je editovno Sebastianem Rahtzem, piem hlavn
-%B% pispvatel byl Fabrice Popineau, kter tvrd pracoval na podpoe
-%B% Windows (zvlt na setupu!) a pispl mnoha rznmi zpsoby a npady,
-%B% radami a kdem. Staszek Wawrykiewicz byl hlavn testr distribuce
-%B% a koordinoval pspvky z~Polska.
-
-%B% Kaja Christiansen provdla nenavn opakovan
-%B% rekompilace na rznch unixovch platformch. Vladimir Volovich odvedl
-%B% vynikajc prci na vyitn zdrojovch text a provedl mnoh
-%B% vylepen, zatmco Gerben Wierda dlal vekerou prci pro \MacOSX.
-
-\begin{itemize*}
-\item Anglickmu, nmeckmu, holandskmu a polskmu sdruen
-uivatel \TeX{}u (\acro{TUG}, \acro{DANTE} e.V.,
-\acro{NTG} resp. \acro{GUST}), kte\v r\'i spolen zajistily
-nezbytnou technickou a administrativn infrastrukturu.
-Pipojte se, prosm, k~\TeX ovskmu sdruen ve va blizkosti!
-(Viz \url{http://tug.org/usergroups.html}.)
-
-\item Tmu \acro{CTAN}u, nejpozoruhodnjm Robinu Fairbairnsovi, Jimu Hef{}feronovi
-a Raineru Sch\"opfovi, kter distribuuje obrazy \TL{} a
-poskytuje spolenou infrastrukturu pro aktualizaci balk,
-na kterch je \TL{} zvisl.
-
-\item Peteru Breitenlohnerovi a \eTeX\ tmu, kte poskytuj
-stabiln zklad budoucnosti \TeX u, a vslovn Peteru za hvzdnou pomoc s~pouvnm osobnch nstroj GNU v~celm \TL..
-
-%B% \item Karlu Berrymu, kter poskytl pvodn distribuci \Webc{}, a
-%B% pokraoval v~poskytovn cennch rad, povzbuzen a pomoc.
-
-%B% \item Mimi Burbankov, kter zajistila na Florida State University
-%B% School of Computational Science and Information Technology pstup
-%B% k~ad rznch pota rznch platforem pro peklad
-%B% \TeX{}ovch binrek a distribuce testovala, kdykoliv to bylo poteba.
-
-\item Thomasi Esserovi, za pekrsn balk \teTeX{}, bez nho by \TL{}
-nikdy neexistovala.
-
-\item Michelu Goossensovi, kter je spoluautorem pvodn dokumentace.
-
-\item Eitanu Gurarimu, jeho \TeX{}4ht bylo pouito pro
-\HTML{} verzi tto dokumentace a kter obratem
-pracoval nenavn na jeho rozench.
-
-\item \Thanh ovi, Martinu Schr\"oderovi a pdf\TeX\ tmu (\url{http://pdftex.org})
-za pokraujc roziovn monost \TeX u.
-
-\item Hansi Hagenovi, za mnoh testovn a ppravu jeho formtu \ConTeXt\
-(\url{http://pragma-ade.com}) pracujcho uvnit systmu \TL.
-
-\item Hartmutu Henkelovi, za vznamn pspvek k~vvoji
-pdf\TeX u, Lua\TeX u a vce.
-
-\item Taco Hoekwaterovi, za sil pi obnoven vvoje \MP u i
-samotnho (Lua)\TeX{}u (\url{http://luatex.org}) a za zalenn \ConTeXt{}u do systmu \TL.
-
-\item Paw{\l}u Jackowsk\'emu, za windowsov instaltor \cmdname{tlpm},
-a Tomaszi {\L}uczakovi, za \cmdname{tlpmgui}, pouvan v~pedchozch vydnch.
-
-\item Akirovi Kakuto, za poskytnut windowsovskch binrek
-z~jeho distribuce \acro{W32TEX} pro japonsk \TeX{}
-(\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}) a za mnostv dalch pspvk.
-
-\item Jonathanu Kew a \acro{SIL}, za vznamn
-nov vvoj \XeTeX{}u a za as a trpen pi jeho integraci do \TL{}, prv tak jako za vchoz verzi instalanho programu Mac\TeX.
-
-\item Dicku Kochovi, za drbu Mac\TeX{}u (\url{http://tug.org/mactex})
-ve velmi blzkm tandemu s~\TL{}, a za jeho skvl vesel pitom. % for his great good cheer in doing so.
-
-\item Reinhardovi Kotuchovi za dleit pspvek k~infrastruktue a instalanmu programu \TL{} 2008, rovn za sil pi vzkumu Windows, za skript \texttt{getnonfreefonts} a dal.
-
-\item Siepu Kroonenbergovi, rovn also za dleit pspvek k~infrastruktue a instalanmu programu \TL{} 2008, zvlt pod Windows a za mnostv prce pi aktualizaci tto pruky, popisujc nov vlastnosti.
-
-\item Petru Olkovi, kter koordinoval a kontroloval velmi peliv
-eskou a slovenskou podporu na \TeXLive.
-
-\item Toshio Oshima za jeho windowsov prohle \cmdname{dviout}.
-
-\item Manueli P\'egouri\'e-Gonnardovi, za pomoc pi aktualizaci balk,
-vylepen dokumentace a rozvoj dokumentu \cmdname{tldoc}.
-
-\item Fabrice Popineau, za pvodn podporu Windows na \TL{} a za francouzskou dokumentaci.
-
-\item Norbertovi Preiningovi, pednmu architektovi infrastruktury a instalanho programu \TL{} 2008 a tak za koordinaci Debian verze \TL{} (spolen s~Frankem K\"usterem),
-za mnoh prbn nvrhy na zlepen.
-
-\item Sebastian Rahtz, za pvodn vytvoen systmu \TL{} a za jeho drbu po mnoho let.
-
-\item Vladimir Volovich, za vznamnou pomoc s~portovnm % with porting
-a jinmi problmy drby, obzvlt za to, e udlal realizovatelnm zahrnut \cmdname{xindy}.
-
-\item Staszku Wawrykiewiczovi, hlavnmu testrovi veho na \TL{} a
-koordintorovi mnoha dleitch polskch pspvk: font, windowsov instalace a dalch.
-
-\item Olafu Weberovi, pro jeho pelivou drbu \Webc.
-
-\item Gerbenu Wierdovi, za vytvoen a drbu podpory \MacOSX\ a
-za mnohou integraci a testovn.
-
-\item Grahamu Williamsovi, na jeho prci na katalogu \TeX{}ovskch balk zvisme.
-
-\end{itemize*}
-
-Tvrci binrek:
-Tigran Aivazian (\pkgname{x86\_64-linux}),
-Tim Arnold (\pkgname{hppa-hpux}),
-Randy Au (\pkgname{amd64-freebsd}),
-Edd Barrett (\pkgname{i386-openbsd}),
-Karl Berry (\pkgname{i386-linux}),
-Akira Kakuto (\pkgname{win32}),
-Dick Koch (\pkgname{universal-darwin}),
-Manfred Lotz (\pkgname{i386-freebsd}),
-Norbert Preining (\pkgname{alpha-linux}),
-Arthur Reutenauer (\pkgname{sparc-linux}),
-Thomas Schmitz (\pkgname{powerpc-linux}),
-Apostolos Syropoulos (\pkgname{i386-solaris}),
-Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-solaris}),
-Olaf Weber (\pkgname{mips-irix}).
-Pro informaci o procesu budovn \TL{}, viz
-\url{http://tug.org/texlive/build.html}.
-
-Obnova dokumentace a peklad:
-Karl Berry (anglick),
-Daniel Flipo (francouzsk),
-Klaus H\"oppner (nmeck),
-Petr Sojka \& Jn Bua (esko\slash slovensk),%
-\footnote{Ke korektue eskho a slovenskho pekladu pispli
-v~letech 2003--2007 krom autor Jaromr Kuben, Milan Matlk, Tom Obva,
-Tom Poleovsk, Libor karvada, Zdenk Wagner a dal.
-Libor \v Skarvada korigoval i leto\v sn\'i verzi.}
-Boris Veytsman (rusk),
-Staszek Wawrykiewicz (polsk).
-Webovsk strnka dokumentace \TL{} je \url{http://tug.org/texlive/doc.html}.
-%B% Dle Gerhard Wilhelms, Volker Schaa, Fabrice Popineau, Janka
-%B% Chlebkov, Petra Sojkov, Staszek Wawrykiewicz,
-%B% Erik Frambach a Ulrik Vieth laskav peloili v~rznch
-%B% obdobch dokumentaci do svch mateskch jazyk a poskytli
-%B% vtanou zptnou reakci.
-
-Samozejm, nejdleitej podkovn pat Donaldu Knuthovi,
-pedevm za vymylen \TeX u a tak za to, e ho vnoval svtu.
-
-\section{Historie vydn}
-\label{sec:history}
-
-\subsection{Minulost}
-
-Diskuse zaala koncem roku 1993, kdy holandsk skupina uivatel \TeX{}u
-NTG zaala prci na \CD{} 4All\TeX{} pro uivatele \acro{MS-DOS}u, doufajc,
-e doba nazrla pro vydn jednoho \CD{} pro vechny
-systmy. Byl to na svou dobu pli ambicizn cl, ale
-nenastartoval jen velmi spn 4All\TeX{} \CD{}, ale tak
-pracovn skupinu \acro{TUG}u o \emph{\TeX{} Directory Structure}
-(\url{http://tug.org/tds}), kter specifikovala,
-jak vytvoit konzistentn a spravovatelnou
-kolekci \TeX{}ovch soubor. Kompletn draft \TDS{} byl publikovn
-v~prosincovm sle asopisu \textsl{TUGboat} v~roce 1995 a
-hned ze zatku bylo jasn, e jednm z~danch produkt bude
-vzorov struktura \CD{}. Distribuce, kterou nyn mte, je pmm
-vstupem prce tto pracovn skupiny. Evidentn spch \CD{} 4All\TeX{}
-ukzal, e i unixov uivatel by touili po podobn jednoduchm
-systmu, a to je tak jedno z~hlavnch aktiv~\TeXLive.
-
-Nejprve jsme vytvoili unixov \TDS{} \CD{} na podzim
-1995 a rychle identifikovali \teTeX{} Thomase Essera
-jako ideln systm, jeliko ji ml multi\-platformn
-podporu a byl koncipovn s~perspektivou
-p\v renositelnosti. Thomas souhlasil s~pomoc a serizn prce zapoala
-zatkem roku 1996. Prvn vydn se uskutenilo
-v~kvtnu 1996. Zatkem 1997 Karl Berry dokonil nov hlavn
-vydn \Webc, kter obsahovalo tm vechny vlastnosti,
-kter Thomas Esser pidal do \teTeX{}u, a tak jsme se rozhodli
-druh vydn \CD{} postavit na standardnm
-\Webc, s~pidnm skriptu \texttt{texconfig} z~\teTeX{}u.
-Tet vydn \CD{} bylo zaloeno na dal revizi
-\Webc, 7.2, proveden Olafem Weberem; a jeliko zrove
-byla hotova nov verze \teTeX{}u, \TL{} obsahoval
-tm vechna jej vylepen.
-Podobn tvrt vydn pouvalo novou
-verzi \teTeX{}u a nov vydn \Webc{} (7.3).
-\TL{} nyn obsahuje i kompletn systm pro Windows.
-
-Pro pt vydn (bezen 2000) bylo mnoho st \CD{} revidovno
-a zkontrolovno a byly aktualizovny stovky
-balk. Detaily o balcch byly uloeny v~souborech \acro{XML}.
-Ale hlavn zmnou pro \TeX\ Live~5 bylo vynt
-softwaru, na kterm byla jakkoliv omezen na en
-(non-free software). Ve uloen na \TL{} je nyn
-sluiteln s~tzv.\ `Debian Free Software Guide\-lines'
-(\url{http://www.debian.org/intro/free}); udlali jsme ve mon,
-abychom zkontrolovali licenn podmnky vech balk,
-ale budeme vdni za upozornn na jakkoli chyby.
-
-est vydn (ervenec 2001) mlo aktualizovanho materilu
-jet vce. Hlavn zmnou byl nov instalan pstup:
-uivatel me volit instalan kolekce.
-Byly kompletn reorganizovny jazykov kolekce,
-take jejich vbrem se instaluj
-nejen makra, fonty, ale je tak pipraven odpovdajc
-soubor \texttt{language.dat}.
-
-Sedm vydn v~roce 2002 mlo podstatn rozen v~pidn
-podpory \MacOSX{}, krom mnostv aktualizac balk a program.
-Dleitm clem byla optn integrace s~\teTeX{}em
-a korekce odchylek z~ptho a estho vydn.
-
-\subsubsection{2003}
-
-V~roce 2003 se neustlou smrt oprav a rozen stalo to, e
-velikost \TL{} ji neumonila jeho smstnn
-na jedno \CD{}, a tak dolo k~rozdlen na ti rzn distribuce
-(viz oddl~\ref{sec:tl-coll.dists} na
-stran~\pageref{sec:tl-coll.dists}). Navc:
-
-\begin{itemize*}
-\item Na dost \LaTeX{} tmu jsme zmnili standardn pkazy
- \cmdname{latex} a \cmdname{pdflatex} tak, e nyn pouvaj
- \eTeX{} (viz strana~\pageref{text:etex}).
-\item Byly pidny a jsou nyn doporuovny k~pouvn
- nov fonty Latin Modern.
-\item Byla zruena podpora OS Alpha \acro{OSF}
- (podpora \acro{HPUX} byla zruena ji dve), jeliko se
- nenael nikdo, kdo by na tchto platformch zkompiloval nov binrky.
-\item Instalan program Windows byl zmnn podstatnm zpsobem; poprv
- bylo integrovno uivatelsk prosted zaloen na XEmacsu.
-\item Dleit pomocn programy pro Windows
- (Perl, \GS{}, Image\-Magick, Ispell) jsou nyn instalovny
- do instalanho adrese \TL{}.
-\item Mapovac soubory jmen font pro \cmdname{dvips}, \cmdname{dvipdfm}
- a \cmdname{pdftex} jsou nyn generovny novm programem
- \cmdname{updmap} a instalovny do \dirname{texmf/fonts/map}.
-%+\item \TeX{}, \MF{}, and \MP{} now output 8-bit input
-%+ characters as themselves in output (e.g., \verb|\write|) files,
-%+ log files, and the terminal, i.e., \emph{not} translated using the
-%+ \verb|^^| notation. In \TL{}~7, this translation was
-%+ dependent on the system locale settings; now, locale settings do
-%+ not influence the \TeX{} programs' behavior. If for some reason
-%+ you need the \verb|^^| output, rename the file
-%+ \verb|texmf/web2c/cp8bit.tcx|. (Future releases will have cleaner
-%+ ways to control this.)
-\item \TeX{}, \MF{} a \MP{} nyn dvaj na vstup %B% 8-bitov
- vtinu vstupnch
- znak (32 a v) bez konverze (napklad do soubor
- zapisovanch pomoc \verb|\write|,
- soubor log, na terminl), a tedy \emph{nejsou pekldny} do
- sedmibitov \verb|^^| notace. V~\TL{}~7 bylo toto mapovn
- zvisl na nastaven systmovch locale; nyn ji nastaven locale
- \emph{neovlivn} chovn \TeX{}u. Pokud z~njakch dvod
- potebujete vstup s~\verb|^^|, pejmenujte soubor
- \verb|texmf/web2c/cp8bit.tcx|. Pt verze bude mt ist een.
-\item Tato dokumentace byla podstatnm zpsobem pepracovna.
-\item Konen, jeliko sla verz \TL{} ji pli narostla,
- verze je nyn identifikovna rokem vydn: \TL{} 2004.
-\end{itemize*}
-
-\subsubsection{2004}
-
-Rok 2004 pinesl mnoho zmn:
-
-\begin{itemize}
-
-\item Pokud mte lokln instalovny fonty, kter
-vyuvaj sv vlastn podp\r urn\'e soubory
-\filename{.map} nebo (mnohem mn pravdpodobn) \filename{.enc},
-mon budete nuceni tyto soubory pesunout.
-
-Soubory \filename{.map} jsou nyn vyhledvny jen v~podaresch
-\dirname{fonts/map} (v~kadm strom \filename{texmf}), podl cesty
-\envname{TEXFONTMAPS}. Podobn, soubory \filename{.enc} jsou hledny jen v~podadresch \dirname{fonts/enc}, podl cesty \envname{ENCFONTS}. \cmdname{updmap} se pokus vypsat varovn o~problematickch souborech.
-%
-O~metodch zpracovn t kter informace, prosme viz
-\url{http://tug.org/texlive/mapenc.html}.
-
-\item \TKCS\ byla rozena pidnm instalovatelnho \CD,
-zaloenho na \MIKTEX u, pro ty, kte dvaj pednost
-tto implementaci ped Web2C.
-%Tak lo\v{n}sk\'e demo \CD{} bylo nahrazeno instalovatelnm \CD{} pro Windows.
-Viz oddl~\ref{sec:overview.tl} (strnka~\pageref{sec:overview.tl}).
-
-\item Uvnit \TL byl velk strom \dirname{texmf} pedelch vydn nahrazen temi: \dirname{texmf},
-\dirname{texmf-dist} a \dirname{texmf-doc}. Viz oddl~\ref{sec:tld} (strnka~\pageref{sec:tld}) a soubory \filename{README} pro kad z~nich.
-
-\item Vechny vstupn soubory tkajci se \TeX u jsou te soustedny v~podadresi \dirname{tex} strom \dirname{texmf*} a nemaj oddlen sourozeneck adrese \dirname{tex}, \dirname{etex},
-\dirname{pdftex}, \dirname{pdfetex} atd. Viz
-\CDref{texmf.doc/doc/english/tds/tds.html\#Extensions}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Extensions}}.
-
-\item Pomocn\'e dvky (nemly by bt volny uivateli) jsou te
-umstny v~novm adresi \dirname{scripts} strom \dirname{texmf*} a jsou vyhledvny prostednictvm \verb|kpsewhich -format=texmfscripts|. Kdy tedy mte programy volajc tyto dvky, budou muset bt nastaveny. Viz
-\CDref{texmf.doc/doc/english/tds/tds.html\#Scripts}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Scripts}}.
-
-\item Tm vechny formty umouj vtinu znak tisknout
-bez konverze pomoc p\v{r}ekladov\'eho souboru
-\filename{cp227.tcx}, msto jejich konverze pomoc
-\verb|^^| notace. Konkrtn, znaky na pozicch 32--256,
-plus \uv{tab}, \uv{vertikln tab} a \uv{form feed} jsou povaovny
-za tisknuteln a nejsou konvertovny. Vjimky tvo plain \TeX\
-(jen 32--127 jsou tisknuteln), \ConTeXt\ (0--255 tisknuteln) a formty
-systmu \OMEGA. Toto implicitn chovn je tm stejn\'e, jak na
-\TL\,2003, ale je implementovno istji, s~vce monostmi pizpsoben.
-Viz \CDref{texmf/doc/web2c/web2c.html\#TCX-files}
-{\texttt{texmf/doc/web2c/web2c.html\#TCX-files}}.
-(Mimochodem, se vstupem Unicode, me \TeX\ na vstupu vypsat posloupnosti
-stench znak pi vpisu chybovch kontext, protoe je bytov
-orientovn.)
-
-\item \textsf{pdfetex} je te implicitn stroj pro vechny formty
-krom samotnho (plain) \textsf{tex}u. (Ten jiste generuje \acro{DVI},
- kdy je sputn jako \textsf{latex} atd.) To znamen, krom jinch
- vc, e mikrotypografick roz\v{s}\'\i\v{r}en\'\i\
-\textsf{pdftex}u jsou dostupn
- v~\LaTeX u, \ConTeXt u atd., stejn\v{e} jako roz\v{s}\'\i\v{r}en\'\i\
-\eTeX u (\OnCD{texmf-dist/doc/etex/base/}).
-
-To tak znamen, e uit balku \pkgname{ifpdf} (pracuje s~plainem
-i \LaTeX em) nebo ekvivalentnho kdu je \emph{dleitej
-ne kdykoliv pedtm}, protoe jednoduch testovn, zda
-je \cs{pdfoutput} nebo njak jin primitiv definovn,
-nen spolehliv zpsob uren, zda je generovn \acro{PDF}
-vstup. Tento zptn krok jsme udlali co nejvc kompatibiln
-letos, ale v~p\v{r}\'\i\v{s}t\'\i m roce \cs{pdfoutput} me
-bt definovn, dokonce i kdy se zapisuje do \acro{DVI}.
-
-\item pdf\TeX\ (\url{http://pdftex.org/}) m mnostv novch vlastnost:
-
- \begin{itemize*}
-
- \item \cs{pdfmapfile} a \cs{pdfmapline} poskytuj podporu mapovn font uvnit dokumentu.
-
- \item Mikrotypografick rozen fontu me bt pouito jednodueji.\\
- \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}
-
- \item Vechny parametry, kter byly pedtm nastavovny ve
- zvltnm konfiguranm souboru \filename{pdftex.cfg}, mus
- te bt nastaveny pomoc primitiv, obyejn
- v~\filename{pdftexconfig.tex}; \filename{pdftex.cfg} nen
- dle podporovn. Vechny existujc \filename{.fmt} soubory
- mus bt znovu vytvoeny pi zmn souboru \filename{pdftexconfig.tex}.
-
- \item Dal informace viz manul pdf\TeX u: \OnCD{texmf/doc/pdftex/manual}.
-
- \end{itemize*}
-
-\item Primitiv \cs{input} v~\cmdname{tex}u (a \cmdname{mf} a
-\cmdname{mpost}) te akceptuje dvojit uvozovky se jm\'eny obsahujcmi
-mezery a s~jin\'ymi zvltnmi znaky. Typick pklady:
-\begin{verbatim}
-\input "filename with spaces" % plain
-\input{"filename with spaces"} % latex
-\end{verbatim}
-Pro dal informace viz manul Web2C: \OnCD{texmf/doc/web2c}.
-
-\item Podpora enc\TeX u je nyn zahrnuta uvnit Web2C,
-v~dsledku toho ve vech \TeX ovch programech, pouitm
-volby \optname{-enc} \Dash \emph{jen v~ppad, e formty
-jsou vytvoeny}. enc\TeX\ podporuje obecn pekdovn
-vstupu a vstupu, m\v{z} umouje plnou podporu kdovn
-Unicode (v~\acro{UTF}-8). Viz \OnCD{texmf-dist/doc/generic/enctex/} a
-\url{http://www.olsak.net/enctex.html}.
-
-\item Aleph, nov stroj kombinujc \eTeX\ a \OMEGA, je nyn k~dispozici.
-Trochu informace najdete na \OnCD{texmf-dist/doc/aleph/base}
-a \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}. Formt pro
-Aleph, zaloen na \LaTeX u se jmenuje \textsf{lamed}.
-
-\item Nejnovj vydn \LaTeX u m novou verzi \acro{LPPL} \Dash te
-oficiln schvlen Debian licence. Rozmanit dal aktualizace najdete
-v~souborech \filename{ltnews} v~\OnCD{texmf-dist/doc/latex/base}.
-
-\item Je dodn \cmdname{dvipng}, nov program pro konvertovn \acro{DVI} na
-obrazov soubory \acro{PNG}. Viz \OnCD{texmf/doc/man/man1/dvipng.1}.
-
-\item Zredukovali jsme balk \pkgname{cbgreek} na \uv{stedn} velkou
-sadu font, se souhlasem a na radu autora (Claudio Beccari).
-Odstrann fonty jsou neviditeln, obrysov, a prhledn,
-relativn zdka se pouvaj a my jsme potebovali msto.
-pln sada je dostupn z~\acro{CTAN}
-(\url{http://www.ctan.org/tex-archive/fonts/greek/cb}).
-
-\item \cmdname{oxdvi} byl odebrn; pouijte jednodue \cmdname{xdvi}.
-
-\item Pkazy \cmdname{ini} a \cmdname{vir} (linky) pro
-\cmdname{tex}, \cmdname{mf} a \cmdname{mpost} se ji nevytvej,
-napklad \cmdname{initex}. Funknost instrukce \cmdname{ini} byla po
-cel lta pstupna prostednictvm volby \optname{-ini} na~pkazovm dku.
-
-\item Podpora platformy \textsf{i386-openbsd} byla zruena.
-Jeliko balek \pkgname{tetex} v~\acro{BSD} Ports systmu
-je dostupn a \acro{GNU/}Linux a Free\acro{BSD} binrky byly
-dostupn, zdlo se nm, e as dobrovolnk me bt vyuit
-lpe nkde jinde.
-
-\item Na \textsf{sparc-solaris} (pinejmenm) jste mon
-museli nastavovat promnn prosted
-\envname{LD\_LIBRARY\_PATH}, aby bely programy \pkgname{t1utils}.
-Je to tm, e jsou kompilovny v~C++,
-a neexistuje standardn umstn \singleuv{runtime} knihoven.
-(To nen novinka roku 2004, ale nebylo to dv zdokumentovno.)
-Podobn, na \textsf{mips-irix}, `runtime' knihovny pro \acro{MIPS}
-7.4 jsou nezbytn.
-\end{itemize}
-
-\subsubsection{2005}
-
-Rok 2005 pinesl jako obvykle mnostv modernizac balk a program.
-Infrastruktura zstala relativn stabiln z~roku 2004, ale nutn tak
-nastaly njak zmny:
-
-\begin{itemize}
-
-\item Byly zavedeny nov skripty \cmdname{texconfig-sys}, \cmdname{updmap-sys} a
- \cmdname{fmtutil-sys}, kter mn konfiguraci v~systmovch stromech.
- Skripty \cmdname{texconfig},
- \cmdname{updmap} a \cmdname{fmtutil} te mn uivatelsk (user-specific) soubory
- v~\dirname{$HOME/.texlive2005}. %$
-
-\item Na specifikaci strom obsahujcch konfiguran soubory (uivatelsk resp. systmov)
- byly zavedeny odpovdajc nov promnn \envname{TEXMFCONFIG} resp.
- \envname{TEXMFSYSCONFIG}. Tedy, mon budete potebovat pesunout osobn verze
- soubor \filename{fmtutil.cnf} a \filename{updmap.cfg} na tato msta; jin volba je
- pedefinovn \envname{TEXMFCONFIG} nebo \envname{TEXMFSYSCONFIG} v~souboru
- \filename{texmf.cnf}. V~kadm ppad skuten pozice tchto soubor a
- hodnoty \envname{TEXMFCONFIG} a \envname{TEXMFSYSCONFIG}
- se musej shodovat. Viz oddl~\ref{sec:texmftrees},
- strana~\pageref{sec:texmftrees}.
-
-\item Loni jsme ponechali \verb|\pdfoutput| a jin primitivy nedefinovny
- pro vstup \dvi, pestoe byl pouvn program \cmdname{pdfetex}.
- Letos, jak jsme slbili, jsme odstranili toto kompatibilitn
- opaten. Tedy kdy v dokument pouv
- \verb|\ifx\pdfoutput\undefined|
- na testovn\'i vstupu do formtu \acro{PDF}, je nutn ho zmnit. Mete
- k~tomu pout balk \pkgname{ifpdf.sty} (kter funguje
- v~plain \TeX u i \LaTeX u), nebo pout jeho logiku.
-
-\item Loni jsme zmnili vtinu formt tak, aby vypisovaly (8bitov) znaky
- tak jak jsou (viz pedchzejc sekci). Nov TCX soubor
- \filename{empty.tcx} te poskytuje jednodu cestu k~dosaen
- pvodnho zpisu \verb|^^| kdy si tak budete pt, jako v~ppad:
-\begin{verbatim}
-latex --translate-file=empty.tcx yourfile.tex
-\end{verbatim}
-
-\item Nov program \cmdname{dvipdfmx} je zaazen pro peveden z~\acro{DVI} do \acro{PDF};
-ten je platnou aktualizac programu
-\cmdname{dvipdfm} (kter je t jet k~dispozici, i kdy ho nedoporuujeme).
-
-\item Nov programy \cmdname{pdfopen} a \cmdname{pdfclose} byly pidny, aby
-poskytly monost znovu otevt \acro{PDF}
-soubory v~programe Adobe Acrobat Reader bez jeho restartu.
-(Jin prohlee \acro{PDF}, pedevm \cmdname{xpdf},
-\cmdname{gv} a \cmdname{gsview}, nikdy netrply tmto problmem.)
-
-\item Kvli dslednosti promnn \envname{HOMETEXMF} a
- \envname{VARTEXMF} byly pejmenovny na \envname{TEXMFHOME} resp. na
- \envname{TEXMFSYSVAR}. Je tu tak \envname{TEXMFVAR}, kter je
- implicitn uivatelsky zvisl (user-specific). Viz prvn bod ve.
-\end{itemize}
-
-\subsubsection{2006--2007}
-
-V~letech 2006--2007 byl rozshlm prustkem na \TL{} program \XeTeX{},
-pstupn jako programy \texttt{xetex} a \texttt{xelatex}; viz
-\url{http://scripts.sil.org/xetex}.
-
-\MP\ byl tak podstatn aktualizovn, s~mnoha plny do budoucnosti
-(\url{http://tug.org/metapost/articles}), podobn pdf\TeX{}
-(\url{http://tug.org/applications/pdftex}).
-
-Formt \TeX\ \filename{.fmt} (vysokorychlostn formt) a podobn soubory
-\MP\ a \MF\ jsou te uloeny v~podadresch \dirname{texmf/web2c},
-namsto pmho uloen v~nm (akoliv je adres stle prohledvn,
-v~zjmu stvajcch formt \filename{.fmt}). Podadrese nesou jmna
-pouvanch program, napklad \filename{tex}
-nebo \filename{pdftex} nebo \filename{xetex}. Tato zmna by mla pi
-bnm pouvn zstat nepostehnuta.
-
-Program (plain) \texttt{tex} ji nete prvn dky \texttt{\%\&} aby
-uril, jak formt m spustit; je to ist knuthovsk \TeX.
-(\LaTeX\ a vechny ostatn programy stle tou dky \texttt{\%\&}).
-
-Pochopiteln se bhem roku (jako obvykle) vyskytly stovky jinch
-aktualizac balk a program. Jako obyejn, zkontrolujte, prosm,
-aktualizace na \acro{CTAN}u (\url{http://www.ctan.org}).
-
-Vnitn, strom zdrojovch text je nyn uloen v~Subversion, se
-standardnm webovskm rozhran\'\i m pro jeho prohlen, kam smruje
-odkaz z~na domovsk strnky. Tebae nen v~konen verzi
-viditeln, oekvme, e to poskytne zklad pro stabiln rozvoj
-v~letech nsledujcch.
-
-Nakonec, v~kvtnu 2006 Thomas Esser oznmil, e u nebude aktualizovat
-te\TeX{} (\url{http://tug.org/tetex}). Vsledkem je nrst zjmu o~\TL{},
-pedevm mezi distributory \GNU/Linuxu.
-(Na \TL{} se nachz nov instalan schma \texttt{tetex}u,
-poskytujc piblin ekvivalent.) Doufme, e to mon povede
-ke zlepen prosted \TeX{}u pro vechny.
-
-\subsection{Sou\v{c}asnost (2008)}
-\label{sec:tlcurrent}
-
-V~roce 2008 byla cel infrastruktura \TL{} pebudovna a znovu
-implementovna. pln informace o~instalaci je nyn
-uloena v~textovm souboru \filename{tlpkg/texlive.tlpdb}.
-
-Mezi dalmi vcmi je konen mon aktualizace instalace \TL{}
-z~internetu po pedchoz instalaci. Tuto vlastnost poskytoval
-MiK\TeX\ ji adu let. Pedpokldme pravidelnou aktualizaci novch
-balk po jejich vydn na \CTAN{}u.
-
-Obsaen je vznamnj nov stroj (engine) Lua\TeX\ (\url{http://luatex.org});
-krom lep pizpsobivosti v~szen je mono tento vynikajc skriptovac jazyk
-pout jak uvnit, tak i~mimo \TeX{}ovsk dokumenty.
-
-Podpora Windows a unixovch platforem je nyn jednotnj.
-Zejmna, vtina skript Perlu a Lua je te k~dispozici pod Windows,
-s~pouitm Perlu distribuovanho na~\TL.
-
-Nov skript \cmdname{tlmgr} (sekce~\ref{sec:tlmgr}) je veobecn rozhran
-pro sprvu \TL{} po pedchoz instalaci. Ovld aktualizaci balk
-a nsledujc znovuvytvoen formt, mapovacch soubor a jazykovch soubor,
-voliteln zahrnujc lokln doplky.
-
-S~pchodem programu \cmdname{tlmgr}, innosti programu
-\cmdname{texconfig} na editaci formt a konfiguranch soubor dlen
-slov jsou nyn blokovan.
-
-Program \cmdname{xindy} pro tvorbu rejstk
-(\url{http://xindy.sourceforge.net/}) je nyn zahrnut na vtin
-platforem.
-
-Nstroj \cmdname{kpsewhich} me nyn ohlsit vechny vskyty
-pro dan soubor
-(option \optname{--all}) a omezen vskyty pro dan podadres
-(option \optname{--subdir}).
-
-Program \cmdname{dvipdfmx} zahrnuje nyn funknost extrakce informace
-o `bounding boxu', pomoc povelu \cmdname{extractbb}; toto
-byl jeden z~poslednch rys, kter poskytoval \cmdname{dvipdfm}, avak ne
-\cmdname{dvipdfmx}.
-
-Fontov pezdvky \filename{Times-Roman}, \filename{Helvetica}, atd.
-byly odstrann. Rzn balky oekvaly jejich rzn chovn (pedevm,
-e budou mt rzn kdovn) a nenalezlo se vhodn een tohoto problmu.
-
-Formt \pkgname{platex} byl odstrann pro konflikt jmen s~japontinou
-\pkgname{platex};
-podporu poltiny nyn zajiuje balk \pkgname{polski}.
-
-Soubory \web{}ovskch etzc (pool) jsou nyn zkompilovan do binrek pro
-usnadnn aktualizac.
-
-A nakonec, v~tomto vydn jsou zahrnuty zmny proveden Donaldem Knuthem
-v~jeho \'Uprav\'ach \TeX u roku 2008 (`\TeX\ tuneup of 2008').
-Viz \url{http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf}.
-
-\subsection{Budoucnost}
-
-\emph{\TL{} nen dokonal!} A~nikdy nebude. Mme v~myslu
-pokraovat v~pravidelnch vydnch a rdi bychom poskytovali
-vce podprnch materil, program, vetn instalanch a jiste
-aktualizovan a lpe zkontrolovan strom maker a font. Tato prce je
-provdna dobrovolnky v~jejich limitovanm volnm ase a mnoho
-potebnho jet zbv udlat. Viz, prosm,
-\url{http://tug.org/texlive/contribute.html}.
-
-Prosme, polete opravy, nvrhy, nmty a nabdky pomoci na:
-\begin{quote}
-\email{tex-live@tug.org}\\
-\url{http://tug.org/texlive}
-\end{quote}
-\smallskip\nobreak
-\noindent \textsl{\kern-.4ptastn \TeX ovn!}
-
-\end{document}
diff --git a/Master/texmf-doc/source/texlive/texlive-de/Makefile b/Master/texmf-doc/source/texlive/texlive-de/Makefile
deleted file mode 100644
index cecbe52710c..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-de/Makefile
+++ /dev/null
@@ -1,3 +0,0 @@
-include ../texlive-en/Makefile
-doc = texlive-de
-lang = german
diff --git a/Master/texmf-doc/source/texlive/texlive-de/live4ht.cfg b/Master/texmf-doc/source/texlive/texlive-de/live4ht.cfg
deleted file mode 100644
index 4d2aa6b940a..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-de/live4ht.cfg
+++ /dev/null
@@ -1,47 +0,0 @@
-% tex4ht configuration file for the TeX Live documentation.
-% Accumulated over many years. Public domain.
-%
-% html specifies the main output format.
-% info for extra debugging info in the log files.
-
-% better approach is to have html in one piece (including footnotes).
-% also the newest TeX4ht could produce UTF-8 output (-utf8 option)
-\Preamble{charset=iso-8859-1,html,info,fn-in}
-
-% add extra stylesheet
-\Configure{@HEAD}{\HCode{%
-<link rel="stylesheet" type="text/css" href="\jobname.css" />\Hnewline
-<link rel="stylesheet" type="text/css" href="tex-live.css" />\Hnewline
-}}
-
-% or LaTeX complains it is missing.
-\begin{document}
-
-\EndPreamble
-
-% simplify output for HTML. We leave TeX and LaTeX alone, since tex4ht
-% actually does the lowered E (and raised A) in CSS.
-\def\OMEGA{Omega}
-\def\LaTeXe{LaTeX2e}
-\def\eTeX{e-\TeX}
-\def\acro#1{#1}
-\def\MF{Metafont}
-\def\BibTeX{BibTeX}
-\def\warningbox{}
-\def\endwarningbox{}
-
-\newif\ifhackliterals
-\ifx\tldocenglish\undefined \else \hackliteralstrue \fi
-\ifx\tldocrussian\undefined \else \hackliteralstrue \fi
-\ifx\tldocgerman\undefined \else \hackliteralstrue \fi
-%
-\ifhackliterals
- % these definitions cause "missing } inserted" at \end{tabularx} in
- % French and Czech. don't know why.
- %
- % don't make these into links, as happens with \path. We only have a couple
- % special characters that actually occur.
- \def\dirname{\texttt\bgroup\catcode`\$=12 \catcode`\_=12 \finishliteral}
- \def\finishliteral#1{#1\egroup}
- \let\filename=\dirname
-\fi
diff --git a/Master/texmf-doc/source/texlive/texlive-de/lmsy10-40.png b/Master/texmf-doc/source/texlive/texlive-de/lmsy10-40.png
deleted file mode 100644
index 55c7772320b..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-de/lmsy10-40.png
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-doc/source/texlive/texlive-de/texlive-de.tex b/Master/texmf-doc/source/texlive/texlive-de/texlive-de.tex
deleted file mode 100644
index 4291b40950e..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-de/texlive-de.tex
+++ /dev/null
@@ -1,3091 +0,0 @@
-% $Id: texlive-de.tex,v 1.81 2008/08/13 20:34:57 hahe Exp hahe $
-% TeX Live documentation. Originally written by Sebastian Rahtz and
-% Michel Goossens, now maintained by Karl Berry and others.
-% Public domain.
-%
-\documentclass{article}
-\ifnum\Status=1
- % Create A4 pdf
- \pdfpageheight297mm
- \pdfpagewidth210mm
-\fi
-\let\tldocgerman=1 % for live4ht.cfg
-\usepackage{ngerman}
-\usepackage{tex-live}
-\usepackage[latin1]{inputenc} % translators: use your preferred encodings.
-\usepackage[T1]{fontenc}
-
-\def\dante{DANTE~e.\,V\kern-0.15em.}
-\begin{document}
-
-\title{%
- {\huge \textit{Anleitung zu \TeX\ Live}\\\smallskip}%
- {\LARGE \textsf{\TL{} 2008}}%
-}
-
-
-\author{Karl Berry (Herausgeber) \\[3mm]
- \url{http://tug.org/texlive/}\\[12mm]
- \small{\textit{Verantwortlich fr die deutsche Ausgabe}}\\[3mm]
- \small{Klaus Hppner, \email{klaus@dante.de}} \\
- \small{(\dante)} \\[3mm]
- }
-\date{August 2008}
-
-
-\maketitle
-\thispagestyle{empty}
-
-\newpage
-
-\begin{multicols}{2}
- \tableofcontents
- \listoffigures
-\end{multicols}
-
-%\renewcommand{\Status}{0}
-%\typeout{Status is \Status}
-
-\clearpage
-
-% ==============================================================
-\section{Einleitung}\label{sec:intro}
-
-Diese Anleitung beschreibt das \TL-System. Die {\TL} Distribution enthlt
-\TeX/\LaTeX-Systeme fr Linux, verschiedene \acro{UNIX}-Plattformen, {\MacOSX}
-und (32-Bit)-Windows.
-
-Wahrscheinlich haben Sie \TL{} auf einem von zwei Wegen bezogen, entweder
-per direktem Download von \TL{} oder als Teil der \DVD{} \TK, die von
-vielen \TeX-Vereinen (u.\,a. \dante) an ihre Mitglieder verschickt werden
-und in Deutschland ber die Fachbuchhandlung Lehmanns (\url{http://www.lob.de})
-vertrieben wird. Abschnitt~\ref{sec:tl-coll-dists} beschreibt kurz den
-Inhalt der \TK-\DVD. Sowohl \TL{} und die \TK{} sind durch das Engagement
-vieler Freiwilliger aus vielen \TeX-Vereinen entstanden. Im brigen
-beschrnkt sich diese Anleitung auf \TL{} an sich.
-
-{\TL} enthlt lauf"|fhige Versionen von \TeX, \LaTeXe, \ConTeXt, \MF, \MP,
-{\BibTeX} und vielen anderen Programmen,
-sowie eine umfassende Auswahl an Makros, Zeichenstzen und
-Beschreibungen, die gem der Standard"=\TeX"=Verzeichnisstruktur (\TDS)
-abgelegt sind.
-
-Wenn Sie neuere Versionen der dort aufgefhrten Pakete zu suchen wollen, gehen Sie am besten zu \acro{CTAN}:
-\url{http://www.ctan.org/}.
-
-Eine kurze Zusammenfassung der wesentlichen nderungen der aktuellen \TL-Version
-gegenber der Vorgngerversion finden Sie im Abschnitt~\ref{sec:history} auf
-Seite~\pageref{sec:history}.
-
-\subsection{Untersttzung verschiedener Betriebssysteme}
-\label{sec:os-support}
-\TL{} enthlt direkt ausfhrbare Programme fr viele Unix-basierte
-Betriebssysteme, inklusive \MacOSX. Selbst wenn Ihr Unix-System wider
-Erwarten nicht untersttzt wird, sollten Sie in der Lage sein, aus
-den mitgelieferten Programm-Quellen ein funktionierendes \TeX-System zu
-kompilieren.
-
-Bezglich Microsoft Windows werden Versionen ab Windows~2000 untersttzt,
-whrend die aktuelle \TL{} unter Windows 95/98, ME und NT nicht
-mehr lauffhig ist. Es existieren zwar keine 64-Bit-Versionen der
-Programme, allerdings sollten die 32-Bit-Programme problemlos auf
-64-Bit-Systemen funktionieren.
-
-% -------------------------------------------------------------
-\subsection{Einsatzmglichkeiten des \TL-Systems der \TK}\label{sec:basic}
-
-Sie knnen das \TL-System wahlweise von der \DVD{} oder ber das
-Internet installieren. Der \emph{Net Installer} ist ein kleines Programm,
-das die bentigten Teile aus dem Internet nachldt. Dieser Weg bietet
-sich an (eine schnelle und stabile Internetverbindung voraus gesetzt),
-wenn Sie kein komplettes \TL{} installieren wollen, sondern Ihr System nur
-mit bestimmten Paketen bestehen soll.
-
-Wenn Sie die \DVD{} besitzen (oder das ISO-Image der \DVD{} herunter
-geladen haben -- dieses kann auf einigen Systemen sogar direkt als
-virtuelles Medium ">gemountet"< werden), knnen Sie \TL{} nach
-Wunsch auf Ihrer Festplatte installieren oder direkt von der \DVD
-benutzen.
-
-Beide Methoden werden in den Abschnitten zur Installation beschrieben.
-Hier daher nur die kurze Zusammenfassung:
-
-\begin{itemize*}
-\item Das Hauptinstallationsskript ist \cmdname{install-tl}. Es existiert
-sowohl im Textmodus als auch in Form einer grafischen Benutzeroberflche (GUI).
-Unter Windows ist der grafische Modus der Standard, auf allen anderen
-Systemen der Textmodus. Durch die Optionen \code{-gui} bzw.\ \code{-no-gui}
-knnen Sie gezielt einen der beiden Modi auswhlen.
-\item \TL installiert u.\,a. den neuen ">\TL Manager"< mit dem Namen
-\prog{tlmgr}. Auch dieser untersttzt Text- und GUI-Mode. Mit diesem
-Programm knnen Sie einerseits Pakete von \TL installieren oder deinstallieren,
-andererseits \TL konfigurieren.
-\end{itemize*}
-
-
-% -------------------------------------------------------------
-\subsection{">Wo bekomme ich Hilfe?"< oder ">Hier werden Sie geholfen!"<}\label{sec:help}
-
-Die \TeX-Gemeinschaft ist ebenso aktiv wie hilfsbereit, und es wird
-praktisch jede ernst gemeinte Frage beantwortet. Diese Hilfe ist allerdings
-nicht formal organisiert, sondern wird von Freiwilligen in ihrer
-Freizeit geleistet. Es ist daher ernst gemeint, dass Sie vor einer
-Fragestellung Ihre ">Hausaufgaben"< gemacht haben. Falls Sie auf
-eine garantierte kommerzielle Untersttzung angewiesen sind oder eine solche
-bevorzugen, sollten Sie die Finger vollstndig vom \TL-System lassen und
-in der Aufstellung unter \url{http://tug.org/interest.html#vendors} nach
-einem geeigneten Hndler suchen.
-
-Die folgende Liste stellt die leicht zugnglichen Quellen in der
-empfohlenen Reihenfolge vor:
-
-\begin{description}
-\item [Einfhrung:]\mbox{}\\
- Wenn Sie \TeX-Anfnger sind und eine englische Einfhrung in das System bentigen,
- sollten Sie das \acro{WWW}-Dokument \url{http://tug.org/begin.html} (Englisch) lesen.
-
- Fr deutschsprachige \LaTeX-Anfnger ist die ">\LaTeXe-Kurzbeschreibung"< von groem Nutzen
- (\OnCD{texmf-doc/doc/german/lshort-german/l2kurz.pdf}).
-\item [\TeX-\acro{FAQ}s:]\mbox{}\\
- Die \TeX-\acro{FAQ} (im Deutschen
- \file{de-tex-faq} ">\emph{Fragen und Antworten [\acro{FAQ}] ber
- das Textsatzsystem TeX und \acro{DANTE}, Deutschsprachige
- Anwendervereinigung TeX e.V.}"<) ist ein riesiges Kompendium
- mit Fragen (und Antworten) aller Art, von der einfachsten
- Anfngerfrage bis zu Expertenwissen.
- % Sie ist Bestandteil
- % des \TL-Systems (\OnCD{texmf-doc/doc/german/FAQ-de/}) und umfasst zur
- % Zeit 182~Seiten als PDF-Datei (\OnCD{texmf-doc/doc/german/FAQ-de/de-tex-faq.pdf}).
- % Darber hinaus ist die
- % \acro{FAQ} als \HTML-Datei (\OnCD{texmf-doc/doc/german/FAQ-de/html/index.html})
- % und als durchsuchbare Textdatei
- % (\OnCD{texmf-doc/doc/german/FAQ-de/text/index.html}) enthalten.
- % Im Internet finden Sie die \acro{FAQ} unter
- Sie finden die deutschsprachige \acro{FAQ} unter
- \url{http://www.dante.de/faq/de-tex-faq/}; zudem wird die
- Text"-ver"-sion regelmig in die News-Gruppe
- \url{news:de.comp.text.tex}
- verschickt. Die \acro{FAQ} besteht aus mehreren Teilen, wobei
- jeder Teil ohne News-Header nicht lnger als ca. 32\,KB ist.
-
- Des Weiteren existiert eine englischsprachige \acro{FAQ}-Sammlung
- (\OnCD{texmf-doc/doc/english/FAQ-en/newfaq.pdf}), die auch im Internet verfgbar ist
- (\url{http://www.tex.ac.uk/faq}).
-
- Bitte nutzen Sie bei Problemen zu allererst diese beiden Mglichkeiten.
-
-\item [\TeX-Catalogue:]\mbox{}\\
- Wenn Sie auf der Suche nach einem bestimmten Paket,
- Font, Programm u.\,. sind, empfiehlt sich ein Blick in den
- \TeX-Catalogue. Dieser Katalog enthlt eine Liste aller verfgbaren
- \TeX-spezifischen Dinge (siehe
- % \OnCD{texmf-doc/doc/english/catalogue} oder
- \url{http://www.ctan.org/tex-archive/help/Catalogue/catalogue.html}).
-
-\item [\TeX-\acro{WWW}-Ressourcen:]\mbox{}\\
- Im \acro{WWW}-Dokument \url{http://tug.org/interest.html} finden Sie eine groe Anzahl \TeX-spezifischer
- Links zu Bchern, Manuals und Artikeln zu allen Aspekten des \TeX-Systems.
-
-\item [Archive:]\mbox{}\\
- Ein Forum fr die Hilfestellung sind die Usenet-News-Gruppen
- \url{news:de.comp.text.tex} (Deutsch), \url{news:comp.text.tex} (Englisch)
- und die Mailing-Liste \email{texhax@tug.org}. In deren Archiven finden
- sich die Fragen und Antworten vieler Jahre. Ihre Suche knnen Sie in Google
- beispielsweise mit \url{http://groups.google.de/group/de.comp.text.tex/topics}
- starten -- oder auch in \url{http://tug.org/mail-archives/texhax/}.
-
- Im Allgemeinen ist es recht Erfolg versprechend, eine generelle Suche ber Google
- \url{http://www.google.de/} durchzufhren (entweder im \emph{WWW} allgemein
- oder in den \emph{News-Gruppen}); dies insbesondere, wenn es sich um Fragen ber
- \PS/PDF, \cmdname{Ghostscript} u.\,. handelt.
-
-\item [Fragen stellen:]\mbox{}\\
- Wenn Sie mit den oben aufgezeigten Mglichkeiten immer noch keine
- Antwort auf Ihre Frage gefunden haben, knnen Sie die Frage auch in einer
- News-Gruppe stellen (neudeutsch: \emph{posten}). Hier bietet sich fr
- den deutschsprachigen Raum die News-Gruppe \url{news:de.comp.text.tex} an.
- Benutzen Sie am besten fr Anfragen Google
- (\url{http://groups.google.de/group/de.comp.text.tex/topics})
- oder einen Newsreader. Fragen an die englischsprachige Gruppe
- \url{news:comp.text.tex}
- (bei Google: \url{http://groups.google.de/group/comp.text.tex/topics})
- sollten Sie bitte nur in Englisch stellen.
-
- Zustzlich existieren E-Mail-Diskussionslisten, wobei hier die deutschsprachige Liste
- \email{TeX-D-L@listserv.dfn.de} zu nennen ist (das englischsprachige quivalent
- ist \email{texhax@tug.org}). Darber hinaus bietet sich fr Mitglieder
- von \acro{DANTE}~e.V. der Beraterkreis an (\email{beraterkreis@dante.de}).
- Wie Sie sich in die E-Mail-Liste \dirname{TeX-D-L} eintragen knnen,
- finden Sie in der \acro{FAQ} unter ">\texttt{1.3.2 Was ist TeX-D-L?}"<.
-
- Bevor Sie aber eine Frage absenden, lesen Sie \emph{bitte} die entsprechenden
- Eintrge der \acro{FAQ} zum Thema ">\emph{Wie stelle ich eine Frage in einer
- Newsgroup, damit ich mit hoher Wahrscheinlichkeit eine Antwort bekomme?}"<. So
- z.\,B. ">\texttt{1.3.1 Was ist `de.comp.text.tex'?}"< und ">\texttt{1.3.7 Was
- sollte ich gelesen haben, bevor ich eine Frage in `de.comp.text.tex' oder der
- Diskussionsliste TeX-D-L stelle?}"< oder auch
- \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}.
-
-\item [Mithilfe:]\mbox{}\\
- Wenn Sie einen Fehler melden wollen oder Empfehlungen und Kommentare
- zur \TL-Verteilung, -Installation oder -Dokumentation geben mchten, sollten Sie die
- E-Mail-Liste \email{tex-live@tug.org} nutzen.
- Korrekturen, Anmerkungen und Erweiterungen fr die deutsche bersetzung knnen Sie auch
- an \email{cdrom@dante.de} oder schriftlich an die Geschftsstelle von
- \acro{DANTE}~e.V. senden.
-
- Fragen zu Programmen, die Sie in der {\TK} finden, sollten Sie besser auf
- einer der oben genannten Mailing-Listen stellen oder direkt an den Programmautor
- richten.
-\end{description}
-
-Auf der anderen Seite knnen auch Sie mit Ihrem Wissen helfen. Die News-Gruppen
-\url{news:de.comp.text.tex} (in Deutsch), \url{news:comp.text.tex} (in Englisch) und
-die Mailing-Liste \email{TeX-D-L@listserv.dfn.de} (Deutsch) und \email{texhax@tug.org} (Englisch)
-stehen allen offen. Wenn Sie also dort mitlesen, scheuen Sie sich nicht, Fragen,
-zu denen Sie eine Antwort wissen, zu beantworten und damit anderen zu helfen.
-
-% ==============================================================
-\section[berblick zum \protect\TeX Live-System]{berblick zum \TL-System}
-\label{sec:overview-tl}
-% don't use \TL so the \uppercase in the headline works. Also so
-% tex4ht ends up with the right TeX. Likewise the \protect's.
-
-In diesem Abschnitt beschreiben wir Struktur und Inhalt des \TL-Systems und der bergeordneten \TK-\DVD.
-
-
-% -------------------------------------------------------------
-\subsection[Die \protect\TeX\protect\ Collection: \TL, pro\TeX{}t, Mac\TeX]%
-{Die \protect\TeX\protect\ Collection: \TL, pro\TeX{}t, Mac\TeX}\label{sec:tl-coll-dists}
-
-Die \DVD ">\TK"< besteht aus:
-\begin{description}
-\item[\TL] Ein komplettes \TeX-System, wahlweise zur Installation auf Festplatte oder zur direkten Benutzung
-von der \DVD.
-\item[Mac\TeX] fr \MacOSX. Dieses enthlt das komplette \TL, bietet zustzlich aber ein Installationsprogramm
-fr Mac und einige Zusatzprogramme. Nhere Informationen finden Sie auf der Homepage von Mac\TeX{} unter
-\url{http://www.tug.org/mactex/}.
-\item[pro\TeX{}t] basiert auf der \MIKTEX-Distribution fr Windows. Es enthlt noch einige Zusatzprogramme und
-stellt eine einfache Installationsanleitung bereit, die Schritt fr Schritt den Weg zu einem kompletten
-\TeX-System beschreibt. Die Homepage von pro\TeX{}t findet sich unter \url{http://tug.org/protext}.
-\item[CTAN] Weiterhin ist auf der \DVD{} ein Ausschnitt der \TeX-bezogenen Software enthalten, die sich
-in CTAN, dem \emph{Comprehensive \TeX{} Archive Network} befinden.
-\item [\texttt{texmf-extra}] In diesem Verzeichnis befinden sich zustzliche Pakete, die kein Teil von
-\TL sind.
-\end{description}
-
-\CTAN{}, \pkgname{protext} und \dirname{texmf-extra} unterliegen nicht den selben Lizenzregeln wie \TL.
-Daher knnen fr Teile hieraus andere Lizenzbedingungen bezglich einer Weiterverteilung oder
-Modifikation gelten, die Sie unbedingt beachten sollten!
-
-% -------------------------------------------------------------
-\subsection{Basisverzeichnisse von \TL}\label{sec:tld}
-
-In diesem Abschnitt beschreiben wir die Basisverzeichnisse der \TL-Distribution.
-
-Auf der \pkgname{live}-\DVD befindet sich die gesamte \TL-Hierarchie im Unterverzeichnis \dirname{texlive}
--- nicht im Wurzelverzeichnis der \DVD.
-
-\begin{center}
-%% \begin{longtable}{@{}>{\ttfamily}lp{.63\hsize}@{}}
-%% \hline
-%% \rm
-%% Verzeichnis & Inhalt \\
-%% \hline
-%% \endfirsthead
-%% \rm
-%% Verzeichnis & Inhalt \\
-%% \hline
-%% \endhead
-%% \hline
-%% \endfoot
-\begin{tabular}{@{}>{\ttfamily}lp{.75\linewidth}@{}}
-bin & ausfhrbare Programme des \TeX-Systems;
- jeweils fr die verschiedenen Rechnerplattformen
- in Unterverzeichnissen zusammengefasst\\
-readme-html.dir & in diesem Verzeichnis (!) befinden sich HTML-Dateien
- in verschiedenen Sprachen, die als schneller
- Einstieg in \TL empfehlenswert sind.\\
-readme-txt.dir & in diesem Verzeichnis (!) befinden sich Text-Dateien
- mit den gleichen Inhalten wie in {\ttfamily readme-html.dir}.\\
-source & Quelldateien aller Programme inklusive der
- \Webc-Quellen fr die \TeX- und \MF-Pakete als
- komprimierte \file{bzip2}"=Archive\\
-support & verschiedene Programme und Hilfspakete, die \emph{nicht} automatisch
- mitinstalliert werden, wie z.\,B. Editoren und \TeX-Shells\\
-texmf & Verzeichnisbaum fr Programme und zugehrigen Hilfsdateien und Anleitungen; enthlt keine \TeX-Formate
- und Pakete (siehe \texttt{TEXMFMAIN} im nchsten Abschnitt)\\
-texmf-dist & Hauptbaum mit Formaten und Paketen (siehe \texttt{TEXMFDIST} im nchsten Abschnitt)\\
-texmf-doc & Verzeichnisbaum mit vollstndigen Dokumentationen (ohne andere installierte Dateien); sortiert nach
- Sprachen \\
-texmf-var & Verzeichnisbaum fr automatisch erzeugte und gespeicherte Dateien
- fr \TeX, {\MF} und andere (siehe \texttt{TEXMFSYSVAR} im nchsten Abschnitt),\\
-%%\end{longtable}
-\end{tabular}
-\end{center}
-%
-Zustzlich zu den oben aufgefhrten Verzeichnissen finden Sie
-im Wurzelverzeichnis der Distribution
-auch noch die Installationsskripte.
-
-Das Verzeichnis \OnCD{texmf-doc} enthlt zwar nur Anleitungen, bei weitem aber nicht die gesamte Dokumentation:
-Die Dokumentation fr Programme (Handbcher, ">man~pages"<, \acro{GNU}-\acro{info}-Dateien) beispielsweise finden Sie
-im Verzeichnis \OnCD{texmf/doc}, da die Programme selbst sich im Verzeichnis \OnCD{texmf} befinden. hnliches
-gilt fr die Dokumentation der \TeX-Pakete und -Formate im Verzeichnis \OnCD{texmf-dist/doc}.
-
-Benutzen Sie die Programme \cmdname{texdoc} oder \cmdname{texdoctk}, wenn Sie auf der Suche nach irgendeiner
-Dokumentationsdatei sind. Hilfreich in diesem Zusammenhang knnte auch die Link-Sammlung \filename{doc.html} im
-Wurzelverzeichnis sein.
-
-Die Anleitung zu \TL ist in verschiedenen Sprachen verfgbar:
-\begin{itemize*}
-\item{Chinesisch:} \OnCD{texmf-doc/doc/chinese/texlive-zh-cn/texlive-zh-cn}
-\item{Tschechisch/Slowakisch:} \OnCD{texmf-doc/doc/czechslovak/texlive-cz/live}
-\item{Englisch:} \OnCD{texmf-doc/doc/english/texlive-en/texlive-en}
-\item{Franzsisch:} \OnCD{texmf-doc/doc/french/texlive-fr/texlive-fr}
-\item{Deutsch:} \OnCD{texmf-doc/doc/german/texlive-de/texlive-de} (dieses Dokument)
-\item{Polnisch:} \OnCD{texmf-doc/doc/polish/texlive-pl/texlive-pl}
-\item{Russisch:} \OnCD{texmf-doc/doc/russian/texlive-ru/texlive-ru}
-\end{itemize*}
-
-% -------------------------------------------------------------
-\subsection{berblick ber die vordefinierten texmf-Bume}
-\label{sec:texmftrees}
-
-Dieser Abschnitt listet alle vordefinierten texmf-Bume, die vom System benutzt
-werden, und deren Bedeutung auf. Das Kommando \cmdname{texconfig conf}
-zeigt Ihnen die aktuellen Einstellungen dieser Variablen an.
-
-\begin{ttdescription}
-\item [TEXMFMAIN] In diesem Baum befinden sich wichtige Teile des Systems,
- Hilfsprogramme (wie \verb+web2c/mktexdir+), pool-Dateien und andere
- Hilfsdateien.
-\item [TEXMFDIST] In diesem Baum befinden sich die wesentlichen Makro-Pakete,
- Fonts usw. Dieser Baum enthlt systemunabhngige Daten, die prinzipiell
- von jedem TDS-kompatiblem \TeX-System nutzbar sein sollten.
-\item [TEXMFLOCAL] Dieser Baum ist fr Ergnzungen oder Aktualisierungen
- von Makros, Fonts etc. gedacht, die Administratoren fr alle Nutzer
- installieren.
-\item [TEXMFHOME] In diesem Baum knnen einzelne Nutzer Ergnzungen oder
- Aktualisierungen von Makros, Fonts etc. ablegen. Standardmig befindet
- sich dieser Baum unterhalb von \verb+$HOME+, so dass andere Nutzer von
- nderungen hier nicht beeinflusst werden.
-\item [TEXMFCONFIG] Dieser Baum wird von den Hilfsprogrammen von te\TeX{}
- wie \verb+texconfig+, \verb+updmap+ und \verb+fmtutil+ verwendet.
- Standardmig befindet sich dieser Baum unterhalb von \verb+$HOME+,
- so dass andere Nutzer von nderungen hier nicht beeinflusst werden.
-\item [TEXMFSYSCONFIG] Dieser Baum wird von den Hilfsprogrammen von te\TeX{}
- wie \verb+texconfig-sys+, \verb+updmap-sys+ und \verb+fmtutil-sys+
- verwendet, so dass hier das Verhalten des \TL-Systems fr alle Nutzer
- beeinflusst werden kann.
-\item [TEXMFVAR] Dieser Baum wird von Hilfsprogrammen wie \verb+texconfig+,
- \verb+updmap+ und \verb+fmtutil+ benutzt, um automatisch generierte
- Konfigurations-Dateien abzulegen.
-\item [TEXMFSYSVAR] Dieser Baum wird von den systemweiten Hilfsprogrammen
- wie \verb+texconfig-sys+, \verb+updmap-sys+ und \verb+fmtutil-sys+
- verwendet, um automatisch generierte Konfigurations-Dateien abzulegen.
-\end{ttdescription}
-
-\noindent
-Der Standard der Verzeichnisstruktur von \TL sieht wie folgt aus:
-\begin{description}
- \item[System-weites Wurzelverzeichnis] kann \TL{}-Versionen aus mehreren Jahren beinhalten:
- \begin{ttdescription}
- \item[2007] Eine Vorversion von \TL.
- \begin{ttdescription}
- \item [...]
- \end{ttdescription}
- \item[2008] Die aktuelle Version.
- \begin{ttdescription}
- \item [bin] ~
- \begin{ttdescription}
- \item [i386-linux] \GNU/Linux binaries
- \item [...]
- \item [universal-darwin] \MacOSX binaries
- \item [win32] Windows binaries
- \end{ttdescription}
- \item [texmf] Hierauf verweist \envname{TEXMFMAIN}.
- \item [texmf-dist] \envname{TEXMFDIST}
- \item [texmf-doc] \envname{TEXMFDOC}
- \item [texmf-var] \envname{TEXMFSYSVAR}
- \item [texmf-config] \envname{TEXMFSYSCONFIG}
- \end{ttdescription}
- \item [texmf-local] \envname{TEXMFLOCAL}, dieses Verzeichnis gilt fr alle installierten \TL-Versionen
- (aktuelle Version und Vorgngerversion), so dass hier durchgefhrte lokale nderungen ber die
- Jahre hinweg erhalten bleiben.
- \end{ttdescription}
- \item[Home-Verzeichnis des Benutzers]
- (\texttt{\$HOME} oder \texttt{\%USERPROFILE\%}):
- \begin{ttdescription}
- \item[.texlive2007] Vom Nutzer privat erzeugte Dateien and Konfigurationsdaten
- der Vorversion.
- \item[.texlive2008] Vom Nutzer privat erzeugte Dateien and Konfigurationsdaten
- fr die aktuelle Version von \TL.
- \begin{ttdescription}
- \item [texmf-var] \envname{TEXMFVAR}
- \item [texmf-config] \envname{TEXMFCONFIG}
- \end{ttdescription}
- \item[texmf] \envname{TEXMFHOME} Persnliche Makros, Fonts usw. des Nutzers.
- \textit{etc.}
- \end{ttdescription}
-\end{description}
-
-% -------------------------------------------------------------
-\subsection{\protect\TeX-Erweiterungen}\label{sec:tex-extensions}
-
-Unter den \TeX-Systemen der {\TL} befinden sich verschiedene
-\TeX"=Erweiterungen:
-
-\begin{description}
-\item [\eTeX]\label{text:etex} stellt bei 100\%-iger Kompatibilitt zum
- normalen {\TeX} einen kleinen, aber mchtigen Satz neuer Befehle
- bereit (fr Makroexpansion, Character-Scanning, zustzliche
- Klassen fr ">marks"<, erweiterte Debug-Mglichkeiten und andere).
- Zustzlich gibt es noch die \TeXXeT-Erweiterungen fr den bidirektionalen Textsatz,
- wie er beispielsweise im Arabischen gebraucht wird.
- Im voreingestellten Modus ist {\eTeX} 100\%-ig kompatibel mit dem ">normalen"< \TeX.
- Die Dokumentation zu {\eTeX} finden Sie in der Datei
- \OnCD{texmf-dist/doc/etex/base/etex_man.pdf}.
-\item [pdf\TeX] enthlt die \eTeX\ Erweiterungen und erlaubt zustzlich
- die Ausgabe in PDF-Dateien sowie {\dvi}-Dateien.
- Die Dokumentation zu pdf\TeX{} finden Sie unter
- \OnCD{texmf-dist/doc/pdftex/manual/pdftex-a.pdf}.
- In der Datei
- \OnCD{texmf-dist/doc/pdftex/manual/samplepdf/samplepdf.tex} finden
- Sie ein Anwendungsbeispiel. Das \LaTeX"=Paket \pkgname{hyperref}
- besitzt die Option \optname{pdftex} mit der Mglichkeit
- fr aktive Querverweise (Hypertext) in PDF-Dateien.
-\item [Lua\TeX] befindet sich noch in Entwicklung
- und ist als zuknftiger Nachfolger von pdf\TeX\ vorgesehen,
- zu dem es abwrtskompatibel bleiben soll.
- Weiterhin soll es auch Aleph ersetzen.
- Durch den enthaltenen Lua-Interpreter (s.\,\url{http://www.lua.org/})
- knnen Probleme, die in \TeX{} nur mhsam lsbar sind,
- einfach und elegant gelst werden.
- Wird es unter dem Namen \filename{texlua} aufgerufen,
- verhlt es sich wie ein eigenstndiger Lua-Interpreter
- -- und wird als solcher in vielen Skripten von \TL bereits benutzt.
- Fr weitere Informationen siehe \url{http://www.luatex.org/} und
- \OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}.
-\item [XeTeX] bietet die Untersttzung von Unicode Zeichenstzen und
- OpenType Schriften durch diverse zustzliche Bibliotheken.
- Mehr Informationen sind unter \url{http://scripts.sil.org/xetex}
- verfgbar.
-\item [\OMEGA] (Omega) ist ein \TeX-System, das intern mit Unicode
- (16-Bit"=Unicode"=Zeichen) arbeitet und damit das gleichzeitige
- Arbeiten mit nahezu allen auf der Welt eingesetzten Schriften
- und deren Zeichenkodierungen erlaubt. Auerdem werden ber dynamisch
- geladene, sogenannte ">{\OMEGA}~Translation~Processes"< (\acro{OTP}s)
- Transformationen zur Verfgung gestellt, die beliebige Eingaben
- vor der Bearbeitung durch {\TeX} nach bestimmten Regeln
- umformen. Die (nicht ganz aktuelle) Anleitung zu {\OMEGA} finden
- Sie in dem \TL-System in der Datei \OnCD{texmf-dist/doc/omega/base/doc-1.8.tex}.
-\item [$\aleph$] (Aleph) vereinigt die \OMEGA- und \eTeX-Erweiterungen.
- Eine Minimaldokumentation finden Sie in \OnCD{texmf-dist/doc/aleph/base}.
-\end{description}
-
-%\clearpage
-
-% -------------------------------------------------------------
-\subsection{Weitere Programme von \TL}
-
-{\TL} enthlt eine ganze Reihe untersttzender Programme wie
-
-\smallskip
-
-\begin{description}
-\item[\cmdname{bibtex}] Verwalten von Bibliographien
-\item[\cmdname{dv2dt, dt2dv}] \file{dvi} nach ASCII und umgekehrt
-\item[\cmdname{dviconcat}] Zusammenfgen von \dvi-Dateien
-\item[\cmdname{dvips}] Konversion von {\dvi} in {\PS}
-\item[\cmdname{dviselect}] Ausschneiden von Seiten aus \dvi-Dateien
-\item[\cmdname{dvipdfmx}] \dvi-nach-PDF-Konverter (erzeugt auch
- \acro{CJK}-konformes PDF aus
- \dvi-Dateien mit \OMEGA"=Erweiterungen), als Alternative
- zu pdf\TeX
-\item[\cmdname{dvilj}] Druckertreiber fr die HP-LaserJet"=Familie
-\item[\cmdname{lacheck}] \LaTeX-Syntax-berprfung
-\item[\cmdname{makeindex}] Erzeugen eines Stichwortverzeichnisses
-\item[\cmdname{mpost}] \MF-hnliches Grafikprogramm
-\item[\cmdname{psnup}] mehrere logische \PS-Seiten auf einem Blatt platzieren
-\item[\cmdname{psselect}] Ausschneiden von Seiten aus \PS-Dateien
-\item[\cmdname{tex4ht}] \TeX-nach-\HTML-Konvertierung
-\item[\cmdname{texexec, texmfstart}] \ConTeXt- und PDF"=Prozessor
-\item[\cmdname{xdvi}] \dvi-Bildschirmausgabe im X-Window-System
-\end{description}
-
-\subsection{Fonts in \protect\TL}
-\label{sec:tl-fonts}
-
-\TL{} enthlt eine Vielzahl qualitativ hochwertiger Vektorschriften. Weitere Informationen hierzu finden sich unter \url{http://tug.org/fonts} und \OnCD{texmf-doc/doc/english/free-math-font-survey/survey}.
-
-% ==============================================================
-\section[Installation von \TeX Live]{Installation von \protect\TL}
-\label{sec:install}
-
-\subsection{Das Installationsprogramms}
-\label{sec:inst-start}
-
-Zur Installation von \TL bentigen Sie die \TK{}-\DVD{} oer den \emph{\TL{} Net Installer} aus dem Internet.
-
-\begin{description}
-\item [Net Installer:] Verfgbar von \CTAN, unter
-\dirname{systems/texlive/tlnet}; die URL
-\url{http://mirror.ctan.org/systems/texlive/tlnet} leitet Sie automatisch
-an einen nahe gelegenen Server des \CTAN-Netzwerks weiter.
-Sie knnen entweder die Datei \filename{install-tl.zip} herunter laden,
-die sowohl fr Unix als auch Windows gedacht ist,
-oder die deutlich kleinere Datei \filename{install-unx.tar.gz},
-die aber nur den Installer fr Unix enthlt.
-Nach dem Auspacken finden Sie die Dateien \filename{install-tl} (Unix)
-bzw.\ \filename{install-tl.bat} (Windows) im Verzeichnis \dirname{install-tl}.
-
-\item [\TeX{} Collection \DVD:] Hier finden Sie die Dateien \filename{install-tl} (Unix)
-bzw.\ \filename{install-tl.bat} (Windows) im Verzeichnis \dirname{texlive}
-der \DVD. Unter Windows startet beim Einlegen der DVD i.\,A. automatisch ein Programm, bei dem Sie u.\,a. das
-Installationsprogramm von \TL auswhlen knnen. Die \DVD\ erhalten Sie als Mitglied eines \TeX-Vereins
-(wie \url{http://www.dante.de} fr den deutschsprachigen Raum, weitere Vereine finden Sie unter
-\url{http://tug.org/usergroups.html}), oder innerhalb Deutschlands von der Fachbuchhandlung Lehmanns
-(\url{http://www.lob.de}) oder international von der \TeX{} Users Group
-(\url{http://tug.org/store}). Alternativ knnen Sie das \ISO-Image der \TL (\url{http://tug.org/texlive/acquire.html}) aus dem Internet laden.
-
-\end{description}
-
-Die folgenden Abschnitte beschreiben die Installation fr die einzelnen Betriebssysteme.
-\subsubsection{Unix}
-
-\begin{figure}[tb]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
-
- Detected platform: Intel x86 with GNU/Linux
-
- <B> binary systems: 1 out of 16
-
- <S> Installation scheme (scheme-full)
-
- Customizing installation scheme:
- <C> standard collections
- <L> language collections
- 83 collections out of 84, disk space required: 1666 MB
-
- <D> directories:
- TEXDIR (the main TeX directory):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
- [X] install macro/font doc tree
- [X] install macro/font source tree
- [ ] create symlinks in standard directories
-
- <V> Install for running from DVD
-
-Other actions:
- <I> start installation to HD
- <H> help
- <Q> quit
-
-Enter command:
-\end{boxedverbatim}
-\caption{Installationsprogramm im Text-Modus (\GNU/Linux)}\label{fig:text-main}
-\end{figure}
-
-\begin{figure}[tb]
-\tlpng{install-w32-main}{\linewidth}
-\caption{Grafische Oberflche des Installationsprogramms (Windows)}\label{fig:gui-main}
-\end{figure}
-
-\noindent
-Im Folgenden werden die Eingaben des
-Benutzers nach dem Kommando-Prompt \samp{>} \Ucom{fett} dargestellt.
-
-ffnen Sie ein Terminalfenster auf Ihrem Unix-System und geben Sie folgende Befehle ein:
-\begin{alltt}
-> \Ucom{cd /pfad/zum/installer}
-> \Ucom{perl install-tl}
-\end{alltt}
-(Sie knnen auch direkt \Ucom{perl /pfad/zum/installer/install-tl} eingeben. Wenn Ihre
-\DVD so gemountet ist, dass als ausfhrbar gekennzeichnete Skripte direkt gestartet werden
-knnen, knnen Sie im Verzeichnis des Installers auch direkt
-\Ucom{./install-tl} eingeben.)
-
-Zum Installieren mit Hilfe einer Benutzeroberflche verwenden Sie
-\begin{alltt}
-> \Ucom{perl install-tl -gui}
-\end{alltt}
-
-Alle Optionen des Installationsprogramms werden mit
-\begin{alltt}
-> \Ucom{perl install-tl -help}
-\end{alltt}
-angezeigt.
-
-\textbf{Wichtiger Hinweis zu den Zugriffsrechten unter Unix:} Ihre aktuelle Einstellung von \code{umask}
-wird bei der Installation von \TL{} bercksichtigt. Daher mssen Sie darauf achten, dass Sie hierfr
-einen sinnvollen Wert einstellen (z.\,B. \code{umask002}), wenn Ihre Installation auch durch andere Nutzer
-als Sie benutzt werden soll. Falls Sie unsicher sind, was dies bedeutet, schauen Sie bitte in die Anleitung
-zu \code{umask} (indem Sie das Kommando \code{man umask} eingeben).
-
-\subsubsection{Mac\,OS\,X}
-
-Wie in Abschnitt~\ref{sec:tl-coll-dists} bereits erwhnt wurde, existiert mit Mac\TeX{} (\url{http://tug.org/mactex}) ein eigenes \TeX-System fr \MacOSX. Dieses enthlt ein
-komplettes \TL mit einem Installationsprogramm, das in Funktionalitt und Aussehen der blichen Installation von Software unter \MacOSX entspricht. Weiterhin sind einige Zusatzprogramme enthalten.
-
-Wenn Sie die \TK-\DVD besitzen, empfiehlt es sich daher, Mac\TeX{} zu verwenden.
-
-\subsubsection{Windows}
-
-Wenn Sie den \emph{Net Installer} verwenden, oder auf Ihrem System beim Einlegen der \DVD das
-Installationsprogramm nicht automatisch gestartet wurde, knnen Sie die Installation von
-\TL im Windows-Explorer durch Doppelklick auf \filename{install-tl.bat} (auf der \DVD befindet
-sich diese Datei im Verzeichnis \texttt{texlive}) starten.
-
-Alternativ knnen Sie eine MS-DOS"=Eingabeaufforderung verwenden, dort in das Verzeichnis wechseln,
-in dem sich das Installationsprogramm befindet und dort
-\begin{alltt}
-D:\bs{}texlive\bs{}> \Ucom{install-tl}
-\end{alltt}
-eingeben -- \texttt{...>} kennzeichnet hierbei den Eingabeprompt;
-Ihre Eingabe ist \Ucom{\texttt{bold/fett}} dargestellt.
-
-Alternativ knnen Sie die Installation auch aus einem beliebigen Verzeichnis heraus starten:
-\begin{alltt}
-> \Ucom{D:\bs{}texlive\bs{}install-tl}
-\end{alltt}
-wobei wir hier annehmen, dass sich ihre \TK-\DVD im Laufwerk D: befindet.
-
-Zur Installation im Textmodus verwenden Sie:
-\begin{alltt}
-> \Ucom{install-tl -no-gui}
-\end{alltt}
-
-Alle vorhandenen Optionen, die beim Starten des Installationsprogramms verwendet werden knnen, werden
-wie folgt angezeigt:
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-
-\subsubsection{Installation im Textmodus}
-
-Abb.~\ref{fig:text-main} zeigt den Eingangsbildschirm des Installationsprogramms im Textmodus.
-Dieser ist ein reiner Textmodus, d.\,h., es gibt somit keine Untersttzung zum Wandern durch die
-einzelnen Menpunkte mit den Cursor-Tasten. Alle Befehle wie z.\,B. die Auswahl von Menpunkten werden
-durch Eingabe der entsprechenden Befehle bzw.\ Menkrzel ber die Tastatur eingegeben und
-dann durch Drcken von \emph{Enter} bernommen. Hierbei wird zwischen Gro- und Kleinschreibung
-unterschieden!
-
-Die Installation im Textmodus ist so spartanisch, weil dieser Modus berall funktionieren soll und daher
-auf die Verwendung von Bibliotheken wie \texttt{ncurses} unter Unix verzichtet wurde.
-
-\subsubsection{Installation mit Benutzeroberflche}
-
-Abb.~\ref{fig:gui-main} stellt den Eingangsbildschirm des Installationsprogramms unter
-Windows dar. Hier ist die Installation im grafischem Modus voreingestellt.
-Der Groteil der Unterschiede in den Menpunkten
-im Vergleich zur Darstellung im Textmodus in Abb.~\ref{fig:text-main}
-ergibt sich aus der Tatsache,
-dass das hier abgebildete GUI-Fenster unter Windows dargestellt wurde.
-
-\subsection{Benutzung des Installationsprogramms}
-\label{sec:runinstall}
-
-Das Installationsprogramm sollte (wenn Sie die vorherigen Abschnitte zum Aufbau von \TL und der
-verwendeten Verzeichnisstruktur gelesen haben) weitgehend selbsterklrend sein. Trotzdem wollen wir
-auf einige Punkte nher eingehen.
-
-\subsubsection{Auswahl der Binaries (nur fr Unix)}
-\label{sec:binary}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Available sets of binaries:
-===============================================================================
-
- a [ ] alpha-linux DEC Alpha with GNU/Linux
- b [ ] amd64-freebsd x86_64 with FreeBSD
- c [ ] hppa-hpux HP-UX
- d [ ] i386-freebsd Intel x86 with FreeBSD
- e [X] i386-linux Intel x86 with GNU/Linux
- f [ ] i386-openbsd Intel x86 with OpenBSD
- g [ ] i386-solaris Intel x86 with Sun Solaris
- h [ ] mips-irix SGI IRIX
- i [ ] powerpc-aix PowerPC with AIX
- j [ ] powerpc-linux PowerPC with GNU/Linux
- k [ ] sparc-linux Sparc with GNU/Linux
- l [ ] sparc-solaris Sparc with Solaris
- m [ ] universal-darwin universal binaries for MacOSX/Darwin
- o [ ] win32 Windows
- p [ ] x86_64-linux x86_64 with GNU/Linux
-\end{boxedverbatim}
-\caption{Auswahlmen fr Binaries}\label{fig:bin-text}
-\end{figure}
-
-Abb.~\ref{fig:bin-text} zeigt das Auswahlmen fr die Binaries der einzelnen Betriebssysteme im Textmodus.
-Im Allgemeinen sollte hier schon das richtige System ausgewhlt sein. Sie knnen aber problemlos Binaries
-fr verschiedene Systeme parallel auswhlen. Dies bietet sich an, wenn Ihre Installation auf verschiedenen
-Rechnern in einem heterogenen Netzwerk sichtbar ist und von dort aus benutzt werden soll.
-
-\subsubsection{Auswahl der zu installierenden Komponenten}
-\label{sec:components}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Select a scheme:
-===============================================================================
-
- a [ ] TeX Live basic scheme
- b [ ] TeX Live scheme for ConTeXt
- c [X] TeX Live full scheme
- d [ ] GUST TeX Live scheme
- e [ ] GUTenberg TeX Live scheme
- f [ ] TeX Live medium scheme
- g [ ] TeX Live minimal scheme
- h [ ] TeX Live for Omega users
- i [ ] teTeX scheme
- j [ ] XML typesetting scheme
-\end{boxedverbatim}
-\caption{Men zur Auswahl des Schemas}\label{fig:scheme-text}
-\end{figure}
-
-Abb.~\ref{fig:scheme-text} zeigt das Auswahlmen fr ein grundstzliches Installationsschema der
-\TL. Durch die Auswahl eines Schemas werden automatisch die Komponenten zur Installation ausgewhlt, die
-fr das gewnschte Schema notwendig bzw.\ sinnvoll sind. Mit einer vollstndigen Installation von \TL
-(\emph{full scheme}) sind Sie auf der sicheren Seite, da hier einfach alles installiert wird. Sie knnen
-aber auch eines der abgespeckten Schemas wie \emph{basic} (fr ein sehr schlankes System), \emph{medium}
-oder \emph{minimal} (dies empfiehlt sich aber nur fr Testsysteme und weniger zum ernsthaften Arbeiten)
-auswhlen. Weiter stehen einige Schemas fr spezielle Zwecke oder Sprachen zur Verfgung.
-
-\begin{figure}[tbh]
-\tlpng{stdcoll}{.7\linewidth}
-\caption{Men zur Aus- oder Abwahl von Collections (hier unter Linux)}\label{fig:collections-gui}
-\end{figure}
-
-Wenn Sie das Schema ausgewhlt haben, knnen Sie dieses in den Menpunkten \emph{standard collections} und
-\emph{language collections} (s.\,Abb.~\ref{fig:collections-gui}, diesmal zur Abwechslung im GUI-Modus)
-individuell nach Ihren Wnschen anpassen.
-
-Whrend das Schema nur den grundlegenden Funktionsumfang vorgibt, ist die Auswahl von Komponenten auf der
-Ebene der \emph{Collections} viel feiner. Eine Collection besteht dabei aus mehreren Paketen zu einem Thema,
-wobei jedes der Pakete aus bestimmten Makrodateien, Fontdateien usw. bestehen kann.
-
-Noch mehr Kontrolle ber die Komponenten Ihres Systems haben Sie nach der Installation mit dem Programm~\prog{tlmgr}, das in Abschnitt~\ref{sec:tlmgr} beschrieben wird. Hier knnen Sie gezielt einzelne
-Pakete installieren oder entfernen.
-
-\subsubsection{Verzeichnisse}
-\label{sec:directories}
-
-Die Verzeichnisstruktur von \TL wurde bereits im Abschnitt~\ref{sec:texmftrees} auf S.~\pageref{sec:texmftrees}
-beschrieben. Als Wurzelverzeichnis fr \TL (\dirname{TEXDIR}) wird unter Windows
-(|%PROGRAMFILES%\texlive\2008|) und unter Unix (\dirname{/usr/local/texlive/2008}) angenommen.
-
-Prinzipiell knnen Sie diesen Pfad problemlos ndern, z.\,B. wenn Sie \TL als normaler Nutzer installieren
-wollen und kein Schreibrecht in dem o.\,a. Verzeichnis besitzen.
-
-Auf Wunsch knnen Sie \TL also auch in Ihrem Home-Verzeichnis installieren, wenn Sie sowieso der einzige
-Verwender von \TL sind. Fr Ihr Home-Verzeichnis knnen Sie den Pfad ">|~|"< verwenden und so
-Beispielsweise \TL nach |~/texlive/2008| installieren.
-
-Wir empfehlen Ihnen, die Jahreszahl im Verzeichnisnamen bei zu behalten. So knnen Sie von Jahr zu Jahr
-einfach die neue Version testen, ohne die alte zu entsorgen. Bei Bedarf knnen Sie einen symbolischen
-Link (z.B. \dirname{/usr/local/texlive-cur}) verwenden, der jeweils auf das Verzeichnis der aktuellen
-Version von \TL verweist.
-
-Wenn Sie die Einstellung \dirname{TEXDIR} im Installationsprogramm ndern, werden die Werte fr
-\dirname{TEXMFLOCAL}, \dirname{TEXMFSYSVAR} und
-\dirname{TEXMFSYSCONFIG} automatisch angepasst.
-
-Das als \dirname{TEXMFHOME} bezeichnete Verzeichnis ist der Ort, in dem persnliche Makrodateien,
-Schriften o.\,. abgelegt werden knnen. Vorgabewert ist |~/texmf|. Im Gegensatz zu \dirname{TEXDIR}
-wird |~| hier nicht direkt zum Pfad des Home-Verzeichnisses aufgelst, sondern unverndert in die
-Konfigurationsdateien von \TL bernommen und erst zur Laufzeit aufgelst. Somit kann jeder Nutzer
-des Systems seinen komplett eigenen Pfad haben, der von \TL verwendet wird, und so nach Wunsch auch
-eigene Konfigurationsnderungen durchfhren.
-Zur Laufzeit wird |~| unter Unix durch \dirname{$HOME} und unter Windows durch \verb|%USERPROFILE%| ersetzt.
-
-\subsubsection{Optionen}
-\label{sec:options}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-<P> use letter size instead of A4 by default: [ ]
-<F> create all format files: [X]
-<D> install font/macro doc tree: [X]
-<S> install font/macro source tree: [X]
-<L> create symlinks in standard directories: [ ]
- binaries to:
- manpages to:
- info to:
-\end{boxedverbatim}
-\caption{Auswahlmen fr weitere Optionen (Unix)}\label{fig:options-text}
-\end{figure}
-
-Abb.~\ref{fig:options-text} zeigt das Men, in dem weitere Einstellungen fr die Installation von
-\TL mglich sind. Drei dieser Optionen erfordern eine Erluterung:
-\begin{description}
-\item[use letter size instead of A4 by default:] Verwendung von Letter statt DIN\,A4 als
-Standard\-papier\-gre. Natrlich knnen Sie spter unabhngig davon fr einzelne Dokumente eine
-beliebige Papiergre whlen.
-
-\item[create all format files:] Auch wenn das Erzeugen von Formatdateien fr Makropakete, die Sie gar
- nicht bentigen, Zeit und Platz kostet, empfehlen wir trotzdem, diese Option ausgewhlt zu belassen.
- Falls Sie diese Option abwhlen, werden Formatdateien jeweils bei Bedarf erzeugt, landen dann aber
- im persnlichen \dirname{TEXMFVAR}-Baum des aktuellen Benutzers. Hier liegende Formate werden allerdings
- nicht automatisch neu gerneriert, wenn z.\,B. Programme oder Silbentrennmuster aktualisiert werden, so dass
- im Extremfall nach einem Update Inkompatibilitten entstehen knnen.
-
-\item[create symlinks in standard directories] (nur unter Unix):
- Mit dieser Option knnen Sie symbolische Links fr Programme und Dokumentation in den Standard\-verzeichnissen
- Ihres Systems anlegen, so dass Sie Ihre Umgebungsvariablen \envname{PATH}, \envname{MANPATH} und
- \envname{INFOPATH} nicht anpassen mssen. Natrlich bentigen Sie fr diese Option Schreibrechte in
- den entsprechenden Verzeichnissen. Diese Option ist nicht dazu gedacht, ein vorhandenes \TeX-System, das
- z.\,B. als Teil Ihrer Linux-Distribution installiert wurde, zu berschreiben. Sie dient vielmehr dazu,
- dass die Links in Verzeichnissen angelegt werden, wo die Nutzer sie erwarten -- beispielsweise
- \dirname{/usr/local/bin} --, aber sich noch keine \TeX-Programme befinden.
-\end{description}
-
-
-\subsubsection[Benutzen von \protect\TL direkt von DVD{}]{Benutzen von \protect\TL direkt von DVD{} (nur im Textmodus verfgbar)}
-\label{sec:fromdvd}
-
-Verwenden Sie die Option ">|V|"<, um die Installation zum Benutzen von \TL direkt von der \DVD einzustellen.
-Ihr Installationsbildschirm sollte nun so aussehen wie in Abb.~\ref{fig:main-fromdvd} dargestellt.
-Tatschlich wechselt die Option~|V| jeweils zwischen Installation auf Festplatte und Installation zur
-Nutzung von \DVD hin- und her, so dass Sie problemlos zur alten Installations"-einstellung zurck kommen,
-wenn Sie diese Option versehentlich ausgewhlt haben.
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
- <D> directories:
- TEXDIRW (Writable root):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
-
- <V> set up for installing to hard disk
-
-Other actions:
- <I> start installation for running from DVD
- <H> help
- <Q> quit
-\end{boxedverbatim}
-\caption{Haupschirm des Installationsprogrmm, wenn die Option \optname{from DVD}
- ausgewhlt wurde}\label{fig:main-fromdvd}
-\end{figure}
-
-Wie Sie sehen, hat sich das Hauptmen an einigen Stellen gendert: Die Menpunkte zur Auswahl eines
-Schemas oder von Collections sowie zum Anlegen symbolischer Links sind verschwunden, und im Abschnitt
-\emph{Directories} wird nun die Angabe eines Verzeichnisses fr \dirname{TEXDIRW} (writable root) verlangt.
-
-Auch beim Verwenden von \TL direkt von \DVD mssen einige Verzeichnisse auf der Festplatte angelegt werden,
-in denen \TL beispielsweise automatisch generierte Dateien (wie Formate oder Fontmaps) ablegen kann.
-Die Verzeichnisse \dirname{texmf}, \dirname{texmf-dist} und \dirname{texmf-doc} werden aber direkt von
-\DVD benutzt und daher nicht auf die Festplatte kopiert.
-
-Die Konfiguration von \TL im Anschluss an die Installation unter Unix ist bei der Verwendung als Live-System
-von \DVD etwas komplexer, da hier an einigen Stellen von der normalen Verzeichnisstruktur von \TL abgewichen
-werden muss, s.~Abschnitt~\ref{sec:postinstall}.
-
-Aus Zeitgrnden ist die Option fr die Benutzung von \TL direkt von \DVD leider nicht im grafischen Modus
-des Installationsprogramms enthalten. Daher muss hierfr zwingend der Textmodus verwendet werden.
-Zu diesem Zweck muss daher unter Windows die Installation innerhalb einer Eingabeaufforderung mit der
-Option~\texttt{-no-gui} gestartet werden (s.\,Abschnitt~\ref{sec:cmdline}).
-
-Abschnitt~\ref{sec:portable-unix} beschreibt einen portableren Weg um \TL zu benutzen, der keine nderungen
-der Systemkonfiguration erfordert, dafr dann aber keine Konfigurationsnderungen an \TL erlaubt.
-
-
-\subsection{Kommandozeilenoptionen fr die Installation}
-\label{sec:cmdline}
-
-Nach Eingabe von
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-erhalten Sie eine Liste der vorhanden Kommando\-zeilen\-optionen. Sie knnen diese entweder mit |-| oder |--|
-verwenden. Die wichtigsten sind:
-
-\begin{ttdescription}
-\item[-gui] Installation im \GUI{}-Modus. Hierfr muss unter Unix Perl/Tk installiert sein
- (\url{http://tug.org/texlive/distro.html#perltk}); falls dies nicht der Fall ist, wird die Installation
- stattdessen im Textmodus durchgefhrt.
-\item[-no-gui] Installation im Textmodus. Da dies unter Unix Standard ist, wirkt sich diese Option nur
- unter Windows aus. Da die Installation zum Benutzen von \TL direkt von \DVD im grafischen Modus nicht
- verfgbar ist, brauchen Sie in diesem Fall unbedingt den Textmodus.
-\item[-lang {\sl LL}] Sprache des Installationsprogramms als Sprach-Code in zwei Buchstaben (\textsl{LL}).
- Derzeit werden englisch (\texttt{en}, Standard), deutsch (\texttt{de}), franzsisch (\texttt{fr}),
- hollndisch (\texttt{nl}), polnisch (\texttt{pl}), slowenisch (\texttt{sl}) und vietnamesisch
- (\texttt{vi}) untersttzt. Das Installationsprogramm versucht, die gewnschte Sprache anhand des
- Systems herauszufinden. Falls dies scheitert oder die betreffende Sprache nicht verfgbar ist, wird als
- Rckfallposition englisch benutzt.
-\item[-profile {\sl profile}] Das Installationsprogramm schreibt die ausgewhlten Optionen in eine Datei
- \filename{texlive.profile} im Unterverzeichnis \dirname{2008/tlpkg}. Mit dieser Option knnen
- Sie eine bereits vorhandene Datei bei der Installation weiter verwenden, z.\,B. wenn Sie quivalente
- Installationen auf mehreren Rechnern realisieren wollen, ohne alle Auswahlschritte der Installation immer
- wieder neu durchfhren zu mssen. Hier ein Beispiel einer solchen Datei:
- \begin{fverbatim}
-# texlive.profile written on Wed Jul 9 16:13:44 2008 UTC
-# It will NOT be updated and reflects only the
-# installation profile at installation time.
-selected_scheme scheme-basic
-TEXDIR /usr/local/texlive/2008
-TEXDIRW /usr/local/texlive/2008
-...
-TEXMFSYSVAR /usr/local/texlive/2008/texmf-var
-collection-basic 1
-...
-option_symlinks 0
- \end{fverbatim}
-\item [-location {\sl url/path}] zur Auswahl eines anderen Verzeichnisses mit den Quellen fr Pakete; zur
- weiteren Erluterung siehe den nchsten Abschnitt.
-\end{ttdescription}
-
-\subsubsection{Die Option \optname{location}}
-\label{sec:location}
-
-Der als \optname{location} angegebene Wert kann neben einem ganz normalen Verzeichnispfad auch eine URL sein,
-die mit \texttt{ftp:}, \texttt{http:} oder \texttt{file:/} beginnt. Falls sich \optname{location} auf einem
-lokalen Laufwerk befindet (Verzeichnispfad oder mit \texttt{file:/} beginnende URL),
-wird die Installationsmethode (aus komprimierten Archiven oder einem echten Live-Dateisystem) automatisch
-bestimmt: falls bezglich der angegebenen \optname{location} ein Unterverzeichnis \dirname{archive} existiert,
-das Dateien vom Typ \filename{.tar.lzma} enthlt, werden diese komprimierte Dateien als Installationsquelle
-benutzt, selbst wenn parallel die Pakete ausgepackt in einem Live-Dateisystem vorhanden sind.
-
-Im Fall einer \optname{location}, die mit \texttt{http:} oder \texttt{ftp:} beginnt, werden
-das Zeichen `\texttt{/}' und/oder die Zeichenkette `\texttt{/tlpkg}' am Ende ignoriert. Sie knnen hier
-z.\,B. einen bestimmten \CTAN-Server auswhlen, was dann in etwa so aussehen wrde:
-\url{http://ctan.example.org/tex-archive/texlive/tlnet/2008}.
-Hier mssen Sie natrlich einen echten Servernamen und den fr diesen Server gltigen Pfad einsetzen
-(eine Liste von \CTAN-Servern finden Sie unter \url{http://ctan.org/mirrors}).
-Die Standardvorgabe ist,
-ber \url{http://mirror.ctan.org} einen Server automatisch auszuwhlen.
-Einmal ausgewhlt, wird dieser allerdings zum Herunterladen aller Komponenten verwendet.
-
-\subsection{Aufgaben im Anschluss an die Installation}
-\label{sec:postinstall}
-
-Je nach System kann es notwendig sein, dass im Anschluss an die Installation noch einige Kleinigkeiten
-erledigt werden mssen.
-
-\subsubsection{Windows}
-Benutzer von Windows sind hier in der glcklichen Position, dass das Installationsprogramm alles komplett
-erledigt haben sollte.
-
-\subsubsection{Unix, falls symbolische Links angelegt wurden}
-
-Wenn Sie bei der Installation angegeben haben, dass und wo symbolische Links angelegt werden sollten
-(s.\,Abschnitt~\ref{sec:options}), sollten hier auch keine Nacharbeiten mehr notwendig sein.
-
-\subsubsection{Umgebungsvariablen fr Unix}
-\label{sec:env}
-
-Das Verzeichnis mit den ausfhrbaren Programmen von \TL muss sich im Suchpfad des Systems befinden.
-Jedes untersttzte System besitzt ein eigenes Verzeichnis unterhalb von \dirname{TEXDIR/bin}, deren
-Namen Sie in Abb.~\ref{fig:bin-text} finden.
-
-Weiterhin knnen Sie die Verzeichnisse mit den Manual-Pages und Info-Dateien zu den entsprechenden
-Suchpfaden fr Dokumentation hinzu fgen, wenn Sie es wnschen.
-
-Fr Systeme mit einer Bourne-kompatiblen Shell wie \prog{bash} ist hier am Beispiel von GNU/Linux
-aufgefhrt, wie die Befehle zum Setzen der Umgebungsvariablen (z.\,B. in \filename{$HOME/.profile})
-aussehen knnten:
-
-\begin{sverbatim}
-export PATH=/usr/local/texlive/2008/bin/i386-linux:$PATH
-export MANPATH=/usr/local/texlive/2008/texmf/doc/man:$MANPATH
-export INFOPATH=/usr/local/texlive/2008/texmf/doc/info:$INFOPATH
-\end{sverbatim}
-
-Fr \prog{csh} oder \prog{tcsh} erfolgt die Konfiguration in der Regel in der Datei~\filename{$HOME/.cshrc}
-und knnte so aussehen:
-
-\begin{sverbatim}
-setenv PATH /usr/local/texlive/2008/bin/i386-linux:$PATH
-setenv MANPATH /usr/local/texlive/2008/texmf/doc/man:$MANPATH
-setenv INFOPATH /usr/local/texlive/2008/texmf/doc/info:$INFOPATH
-\end{sverbatim}
-
-\subsubsection{Systemweites Setzen von Umgebungsvariablen}
-\label{sec:envglobal}
-
-Wenn Sie als Administrator die Umgebungsvariablen global fr das gesamte System setzen wollen,
-gehen wir davon aus, dass Sie sich mit der grundlegenden Systemadministration auskennen.
-
-Daher hier nur zwei Hinweise: 1)~schauen Sie nach einer Datei
-\filename{/etc/manpath.config}. Falls diese vorhanden ist, sollte es reichen, folgende Zeilen
-hinzu zu fgen:
-
-\begin{sverbatim}
-MANPATH_MAP /usr/local/texlive/2008/bin/i386-linux \
- /usr/local/texlive/2008/texmf/doc/man
-\end{sverbatim}
-
-Und 2)~prfen Sie, ob es auf Ihrem System eine Datei \filename{/etc/environment} gibt, in der die
-systemweiten Umgebungsvariablen definiert werden.
-
-\subsubsection{Benutzen von \protect\TL direkt von DVD}
-blicherweise verwendet \TL eine Datei \filename{texmf.cnf}, um die Verzeichnisbume, in denen
-sich die Komponenten von \TL befinden, zu identifizieren. Diese Methode benutzt relative Pfade, so
-dass Ihr \TL-System funktioniert, wo immer Sie es auch hin installieren, solange die Verzeichnisstruktur
-erhalten bleibt.
-
-Diese Methode funktioniert leider nicht mehr, wenn Sie \TL direkt von der \DVD benutzen wollen.
-Da die \DVD ein Nur-Lese-Medium ist, einige der Pfade in \filename{texmf.cnf} aber erst nach der
-Installation fest stehen, muss sich diese Datei auerhalb der \DVD befinden.
-Aus diesem Grund muss eine Umgebungsvariable \envname{TEXMFCNF} gesetzt werden,
-die \TL{} mitteilt, in welchem Verzeichnis sich die Datei \filename{texmf.cnf} befindet.
-Zustzlich muss sich natrlich -- wie im vorigen Abschnitt beschrieben -- das
-Verzeichnis der \DVD, in dem sich die passenden ausfhrbaren Programme befinden, innerhalb des
-Suchpfads des Systems befinden.
-
-Beim Abschluss des Installationsprogramms sollten Sie die notwendigen Informationen erhalten haben,
-wie Sie \envname{TEXMFCNF} setzen mssen. Falls Sie dies bersehen haben, der Wert ist
-\dirname{$TEXMFSYSVAR/web2c}, wobei im Normalfall \dirname{$TEXMFSYSVAR} auf das Verzeichnis
-\dirname{/usr/local/texlive/2008/texmf-var/web2c} verweist. In diesem Fall bentigen Sie also fr
-die \prog{bash} den Befehl
-\begin{sverbatim}
-TEXMFCNF=/usr/local/texlive/2008/texmf-var/web2c; export TEXMFCNF
-\end{sverbatim}
-bzw.\ fr [t]csh:
-\begin{sverbatim}
-setenv TEXMFCNF /usr/local/texlive/2008/texmf-var/web2c
-\end{sverbatim}
-
-\subsubsection{\ConTeXt{} Mark IV}
-Das ">alte"< \ConTeXt{} sollte direkt lauffhig sein. Falls Sie das neue \ConTeXt{} ">Mark IV"<
-verwenden wollen, sind einige manuelle Nacharbeiten notwendig, die unter
-\url{http://wiki.contextgarden.net/Running_Mark_IV} beschrieben sind.
-
-\subsubsection{Integrieren lokaler bzw.\ Nutzer-spezifischer Makros}
-\label{sec:local-personal-macros}
-
-Wie bereits in Abschnitt~\ref{sec:texmftrees} erwhnt, ist der Verzeichnisbaum \dirname{TEXMFLOCAL} (im
-Normalfall \dirname{/usr/local/texlive/texmf-local} oder \verb|C:\Program Files\texlive\texmf-local|)
-fr lokale Ergnzungen wie Makros und Schriften gedacht, die anschlieend allen Benutzern des Systems zur
-Verfgung stehen. Weiterhin knnen Benutzer den Verzeichnisbaum \dirname{TEXMFHOME} (im Normalfall
-\dirname{$HOME/texmf} oder \verb|%USERPROFILE%\texmf|) fr persnliche Ergnzungen verwenden, ohne
-dass andere Benutzer davon beeinflusst werden.
-Diese Verzeichnisse sollen ber verschiedene Versionen von \TL hinweg identisch sein, so dass ein
-Update von \TL auf eine neue Version einfach mglich ist, ohne dass Sie Ihre lokalen Ergnzungen
-verlieren. Wir empfehlen Ihnen daher, von der vorgegebenen Verzeichnisstruktur nicht abzuweichen.
-
-Fr beide oben genannte Verzeichnisbume erwartet \TL eine Verzeichnisstruktur innerhalb des Baums, die
-dem \emph{\TeX{} Directory Standard} entspricht, wie er in \url{http://tug.org/tds} bzw.
-\filename{texmf/web2c/texmf.cnf} definiert ist.
-So gehren Dokumentklassen fr \LaTeX{} z.\,B. in ein Verzeichnis
-unterhalb von \dirname{TEXMFLOCAL/tex/latex} oder \dirname{TEXMFHOME/tex/latex}.
-
-Der Verzeichnisbaum \dirname{TEXMFLOCAL} wird zur Laufzeit nicht direkt nach Dateien durchsucht.
-Stattdessen wird eine Liste von Dateinamen verwendet, sich sich in einer Datei mit dem Namen~\filename{ls-R}
-befindet. Denken Sie also daran, nach nderungen in diesem Baum diese Dateiliste zu aktualisieren,
-entweder mit dem Befehl \cmdname{mktexlsr} oder die Schaltflche \emph{Reinit file database} in
-dem Konfigurationsreiter von \prog{tlmgr} im \GUI-Modus.
-
-\subsubsection{Integrieren von anderen Schriften}
-Die Installation von Schriften, die nicht von \TL sind, ist eine recht komplexe Angelegenheit. Sie sollten
-sich bereits gut mit dem System auskennen, bevor Sie sich an diese Aufgabe wagen. Schauen Sie vielleicht
-vorher in Abschnitt~\ref{sec:tl-fonts} nach, welche Schriften bereits bei \TL mitgeliefert werden.
-
-Eine Alternative besteht im Benutzen von \XeTeX (s.\,Abschnitt~\ref{sec:tex-extensions}), bei dem
-direkt alle vom Betriebssystem installierten Schriften verwendet werden knnen, ohne dass die Installation
-einer \TeX-Untersttzung notwendig ist.
-
-\subsection{Testen der Installation}
-\label{sec:test-install}
-
-Nach der Installation von \TL wollen Sie es natrlich benutzen, um mglichst schne Dokumente zu setzen.
-
-Dieser Abschnitt beschreibt, wie Sie prfen knnen, ob Ihr \TL-System funktioniert.
-Die folgenden Beispiele sind fr Unix, sollten unter Windows und \MacOSX aber sehr hnlich sein, abgesehen
-davon, dass Sie dort eventuell eine grafische Benutzeroberflche verwenden.
-
-\begin{enumerate}
-
-\item Prfen Sie, ob Sie das Programm \cmdname{tex} ausfhren knnen:
-
-\begin{alltt}
-> \Ucom{tex -{}-version}
-TeX 3.1415926 (Web2C 7.5.7)
-kpathsea version 3.5.7
-...
-\end{alltt}
-
-Erhalten Sie als Resultat statt der Versionsnummer die Meldung, dass der Befehl nicht gefunden wurde,
-so haben Sie wahrscheinlich vergessen, das Verzeichnis mit den ausfhrbaren Programmen
-in Ihren \envname{PATH} aufzunehmen, s.\,Abschnitt~\ref{sec:env} auf S.\,\pageref{sec:env}.
-
-\item Eine einfache \LaTeX{}-Datei bersetzen:
-\begin{alltt}
-> \Ucom{latex sample2e.tex}
-This is pdfeTeXk, Version 3.1415926...
-...
-Output written on sample2e.dvi (3 pages, 7484 bytes).
-Transcript written on sample2e.log.
-\end{alltt}
-
-Falls dies schief geht, sind wahrscheinlich noch alte Umgebungsvariablen einer vorigen \TeX-Installation
-brig geblieben. Wir empfehlen, die Umgebungsvariablen, die sich auf \TeX{} beziehen, zu entfernen.
-Fr eine weitere Analyse knnen Sie \TeX{} anzeigen lassen, wo es bestimmte Dateien sucht,
-siehe ">Fehlersuche"< auf Seite~\pageref{sec:debugging}.
-
-\item Ergebnis auf dem Bildschirm anschauen:
-\begin{alltt}
-> \Ucom{xdvi sample2e.dvi}
-\end{alltt}
-(Unter Windows heit der Befehlt fr den Previewer \cmdname{dviout}.) Nun sollte
-sich ein Vorschaufenster mit dem soeben gesetzten Beispieldokument ffnen, das die Grundlagen von
-\LaTeX{} erlutert (und das Anfnger tatschlich auch einmal lesen sollten).
-Unter Unix muss ein X-Server laufen, damit \cmdname{xdvi} funktioniert;
-falls dies nicht der Fall ist oder die Umgebungsvariable \envname{DISPLAY} falsch gesetzt ist,
-erhalten Sie die Fehlermeldung \samp{Can't open display}.
-
-\item Eine \PS{}-Datei erzeugen:
-\begin{alltt}
-> \Ucom{dvips sample2e.dvi -o sample2e.ps}
-\end{alltt}
-
-\item Direkt eine \acro{PDF}-Datei erzeugen (statt \dvi{}):
-\begin{alltt}
-> \Ucom{pdflatex sample2e.tex}
-\end{alltt}
-
-\item Eine \acro{PDF}-Datei anschauen:
-\begin{alltt}
-> \Ucom{gv sample2e.pdf}
-\textrm{or:}
-> \Ucom{xpdf sample2e.pdf}
-\end{alltt}
-Leider sind weder \cmdname{gv} noch \cmdname{xpdf} in \TL{} enthalten, daher mssen diese separat installiert
-werden, siehe \url{http://www.gnu.org/software/gv} bzw.
-\url{http://www.foolabs.com/xpdf}.
-(Sie knnen natrlich auch andere PDF-Viewer verwenden, beispielsweise den Adobe Reader.)
-
-\item Weitere ntzliche Test-Dateien auer
-\filename{sample2e.tex}:
-
-\begin{ttdescription}
-\item [small2e.tex] Einfachere Version von \filename{sample2e}, um den Fehler einzugrenzen, wenn Sie
-beim bersetzen von \filename{sample2e} Probleme haben.
-\item [testpage.tex] Hiermit knnen Sie prfen, ob Ihr Drucker Ihren Ausdruck horizontal oder vertikal verschiebt.
-\item [nfssfont.tex] Zum Testen von Fonts und Erzeugen von Schrifttabellen.
-\item [testfont.tex] Erzeugen von Schrifttabellen, aber mit plain \TeX.
-\item [story.tex] Das einfachste Testdokument von allen (in plain \TeX{}).
-Geben Sie am Ende \samp{\bs bye} ein, wenn nach dem Aufruf von \samp{tex
-story.tex} der \code{*} erscheint.
-\end{ttdescription}
-
-\end{enumerate}
-
-\section{Installation im Netzwerk}
-\label{sec:netinstall}
-
-Bei \TL ist nicht nur vorgesehen, dass es von mehreren Benutzern auf einem System verwendet werden kann,
-sondern auch in einem Netzwerk. In der normalen Konfiguration von \TL werden nur relative, keine absoluten
-Pfade verwendet. Dies erkennt man an Einstellungen in der Datei \filename{$TEXMFMAIN/web2c/texmf.cnf},
-die Zeilen wie die folgenden enthlt,
-in denen Verzeichnisse relativ zu den Verzeichnissen lokalisiert werden,
-in denen sich die Programme befinden:
-\begin{sverbatim}
-TEXMFMAIN = $SELFAUTOPARENT/texmf
-...
-TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local
-\end{sverbatim}
-Daher ist es im Normalfall ausreichend,
-das Programm-Verzeichnis in den Suchpfad des Systems aufzunehmen,
-alles weitere bestimmt \TL dann automatisch.
-
-Daher ist es kein Problem, wenn das Grundverzeichnis von \TL als Netzlaufwerk gemountet ist. Tatschlich
-knnen Sie \TL sogar zunchst lokal installieren und dann auf ein Netzlaufwerk verschieben.
-
-Fr Benutzer von Windows existiert unter \dirname{texmf-doc/source/texlive/texlive-common/w32client}
-ein Beispiel-Skript \filename{install-w32client}, das die Einstellungen im Startmen von Windows
-fr das Verwenden von \TL ber Netzwerk vornimmt. Dieses Skript wird einfach durch Aufruf von
-\filename{install-w32client.bat} im selben Verzeichnis gestartet.
-
-Mehr Informationen zur Konfiguration von \TL und den benutzten Suchpfaden finden Sie im Abschnitt~\ref{sec:kpathsea}.
-
-\section{Portables \protect\TL{} auf DVD oder USB-Stick}
-\label{sec:portable-unix}
-
-Im Abschnitt~\ref{sec:fromdvd} wurde beschrieben, wie \TL direkt von einer \DVD benutzt werden kann.
-Hierbei werden einige Verzeichnisse auf der Festplatte angelegt. Dies ist wahrscheinlich kein Problem,
-wenn Sie dies auf Ihrem eigenen Rechner verwenden, aber es kann anders aussehen, wenn Sie auf einem
-fremden Rechner ">zu Gast"< sind.
-
-Sie knnen die Stellen, an denen beim Benutzen von \TL von \DVD auf der Festplatte Verzeichnisse
-angelegt werden, minimieren. Verwenden Sie unter unter Unix das Skript \filename{tl-portable} oder
-unter Windows die Batch-Datei \filename{tl-portable.bat}, so werden beim ersten Start die
-Konfigurationsdateien fr das Verwenden des Live-Modus von \DVD geschrieben.
-
-Hierzu wird ausschlielich ein Verzeichnis \dirname{~/.tlportable2008} angelegt, in dem diese Dateien
-abgelegt werden. Dies kann einen Moment dauern, aber sobald die Dateien einmal da sind, erfolgt
-der Start des portablen Modus ber die o.\,a. Programme sehr schnell. Die Konfiguration dieses
-Modus erfolgt ausschlielich in dem aktuellen Terminalfenster (bzw.\ fr die aktuelle Eingabeaufforderung),
-der Rest des Systems bleibt davon vllig unberhrt. Sie knnen problemlos in mehreren Sitzungen
-parallel den portablen Modus benutzen.
-
-Wird hier immer ein Verzeichnis auf der Festplatte angelegt, so ist dies komplett berflssig, wenn
-Sie den portablen Modus von USB-Stick verwenden. Kopieren Sie hierfr alle Dateien, die sich direkt im
-Verzeichnis \dirname{texlive} der \DVD befinden, sowie (mindestens) die Verzeichnisse \dirname{bin},
-\dirname{texmf}, \dirname{texmf-dist} und \dirname{tlpkg} komplett auf den USB-Stick (dies kann eine
-Weile dauern!). Beim Kopieren auf einen mit FAT32 formatierten Stick verwenden Sie unbedingt die Option
-zum Auflsen symbolischer Links (\code{cp -L}). Ein auf dem Stick vorhandenes Verzeichnis \dirname{texmf-local}
-wird ebenfalls spter erkannt und benutzt.
-
-Wenn Sie nun das Skript \filename{tl-portable} auf dem USB-Stick (wie oben fr die \DVD beschrieben)
-verwenden, erkennt das Skript, dass der USB-Stick beschreibbar ist und verwendet diesen statt der
-Festplatte fr die Konfigurationsdateien.
-
-\section{\cmdname{tlmgr}: Installation verwalten}
-\label{sec:tlmgr}
-
-\begin{figure}[tb]
-\tlpng{tlmgr-gui}{\linewidth}
-\caption{\prog{tlmgr} im \GUI-Modus. Die Liste der Pakete, Collections und Schemas
- wird erst nach Klicken auf ">Load"< angezeigt.}\label{fig:tlmgr-gui}
-\end{figure}
-
-\begin{figure}[tb]
-\tlpng{tlmgr-config}{\linewidth}
-\caption{\texttt{tlmgr} im \GUI-Modus: Reiter Konfiguration}\label{fig:tlmgr-config}
-\end{figure}
-
-Bei der Installation von \TL wird auch das Programm~\prog{tlmgr} installiert, mit dem Sie anschlieend
-Ihr \TL-System verwalten knnen. Die hierfr bisher verwendeten Programme~\prog{updmap},
-\prog{fmtutil} und \prog{texconfig} sind zwar noch vorhanden, werden aber in der Zukunft durch
-\prog{tlmgr} ersetzt. Verwenden Sie daher heute schon \prog{tlmgr}. Mit \prog{tlmgr} knnen Sie
-folgende Aufgaben erledigen:
-\begin{itemize*}
-\item Verfgbare Schemas, Collections und Pakete anzeigen.
-\item Installieren, aktualisieren, entfernen, Backup und Restore einzelner Pakete, auf Wunsch mit
- Bercksichtigung von Paketabhngigkeiten.
-\item Suchen nach Paketen.
-\item Anzeigen der Systeme, unter denen \TL luft; installieren von Binaries fr weitere Systeme.
-\item Anpassen der Installation, wie ndern der Papiergre oder des Quellverzeichnisses fr Komponenten
- (s.\,Abschnitt~\ref{sec:location}).
-\end{itemize*}
-\textit{Warning:} \prog{tlmgr} ist fr den Live-Modus, bei dem \TL von \DVD genutzt wird, weder gedacht
-noch getestet.
-
-\subsection{\cmdname{tlmgr} im grafischen Modus}
-\prog{tlmgr} im \GUI-Modus wird durch
-\begin{alltt}
-> \Ucom{tlmgr -gui}
-\end{alltt}
-gestartet. Unter Windows finden Sie das Programm im Start menu: \texttt{Start}, \texttt{Programme},
-\texttt{TeX Live 2008}, \texttt{TeX Live Manager}. Nach Klicken auf ">Load"<
-wird eine Liste aller verfgbaren und installierten (letztere durch ">(i)"< gekennzeichnet) angezeigt. Dies
-setzt voraus, dass das Verzeichnis, aus dem \TL die Pakete ldt, vorhanden bzw.\ erreichbar ist.
-
-Abb.~\ref{fig:tlmgr-config} stellt den Reiter zur Konfiguration von \TL dar.
-
-\subsection{Beispiel zur Verwendung von \cmdname{tlmgr} ber Kommandozeile}
-
-Das folgende Beispiel demonstriert, wie mehrere Pakete
-zur Installation hinzu gefgt werden.
-Hierbei wird eine andere Adresse zum Herunterladen verwendet.
-
-\begin{alltt}
-> \Ucom{tlmgr -location http://172.16.18.1/tldev install collection-xetex xkeyval}
-\end{alltt}
-Dies liefert die folgende Ausgabe:
-\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/2008/texmf/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-config/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-dist/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-doc/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/../texmf-local/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-var/ls-R...
-mktexlsr: Done.
-regenerating fmtutil.cnf
-running fmtutil-sys --missing
-...
-Transcript written on xelatex.log.
-fmtutil: /usr/local/texlive/2008/texmf-var/web2c/xetex/xelatex.fmt installed.
-\end{fverbatim}
-
-Wie man sieht, beachtet \prog{tlmgr} die Abhngigkeiten von Paketen und installiert im obigen
-Beispiel von \XeTeX{} bentigte Komponenten nach. Weiterhin werden automatisch im Anschluss
-die Dateilisten der Verzeichnisbume aktualisiert und fehlende Formate generiert.
-
-Im folgenden Beispiel wird die Untersttzung fr eine weitere Sprache installiert. Im Anschluss
-werden automatisch die Formatdateien neu generiert, damit die neuen Trennmuster eingebunden sind.
-\begin{alltt}
-> \Ucom{tlmgr install collection-langdutch}
-\end{alltt}
-
-Eigenschaften eines Pakets anzeigen:
-\begin{alltt}
-> \Ucom{tlmgr show collection-wintools}
-\end{alltt}
-
-Hier erhlt man folgende Ausgabe:
-\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
-\end{fverbatim}
-
-Aktualisieren der kompletten Installation:
-\begin{alltt}
-> \Ucom{tlmgr update -all}
-\end{alltt}
-Wenn Sie erst wissen wollen, was auf Sie zu kommt, knnen Sie zunchst folgendes ausprobieren:
-\begin{alltt}
-> \Ucom{tlmgr update -all -dry-run}
-\end{alltt}
-oder
-\begin{alltt}
-> \Ucom{tlmgr update -list}
-\end{alltt}
-
-Zum Anzeigen aller Optionen:
-\begin{alltt}
-> \Ucom{tlmgr -help}
-\end{alltt}
-
-\section{Hinweise zu Windows}
-\label{sec:windows}
-
-Das Installationsprogramm von \TL\ luft sowohl unter Windows als auch Unix. Dies war nur dadurch mglich,
-dass ltere Versionen von Windows nicht mehr untersttzt werden. Daher kann \TL\ nur noch ab Windows 2000 oder
-spter installiert werden.
-
-
-\subsection{Windows-spezifische Dinge}
-\label{sec:winfeatures}
-
-Unter Windows kmmert sich das Installationsprogramm auch um folgende Dinge:
-\begin{description}
-\item[Mens und Verknpfungen.] Im Startmen wird ein Men ">\TL{}"< hinzu gefgt. Hier sind Eintrge fr
- die grafischen Anwendungen (\prog{tlmgr}, \prog{texdoctk}, den PS\_View PostScript-Previewer)
- und einige Verknpfungen zur Dokumentation vorhanden. Fr PS\_View wird eine Verknpfung auf dem
- Desktop angelegt, auf die Sie \PS-Dateien per Drag~\& Drop ziehen knnen, um diese zu betrachten.
-\item[Automatisches Setzen der UmgebungsVariablen.] Hierdurch ist das Setzen dieser Variablen
- von Hand berflssig geworden.
-\item[Uninstaller.] Es wird ein Eintrag zum Entfernen von \TL in der Systemsteuerung im Punkt Software angelegt.
- Alternativ knnen Sie \TL ber das Programm~\prog{tlmgr} deinstallieren.
-\end{description}
-
-\subsection{Zustzlich enthaltene Programme}
-
-\begin{figure}[tb]
-\tlpng{psview}{.6\linewidth}
-\caption{PS\_View: Anzeige mit hoher Vergrerung}\label{fig:psview}
-\end{figure}
-
-Zustzlich werden unter Windows einige Programme installiert, die unter Windows meist noch nicht verfgbar
-sind:
-\begin{description}
-\item[Perl und Ghostscript.] Da Perl und Ghostscript fr \TL sehr wichtig ist, werden diese
- unter Windows mitgeliefert und werden intern von \TL benutzt. Die in \TL enthaltenen Programme, die
- diese Komponenten bentigen, ">wissen"< wo sich diese befinden, ohne dass diese im System durch
- Umgebungsvariablen oder Eintrge in der Registry sichtbar sind. Es handelt sich um fr \TL abgespeckte
- Versionen, die zu keinen Konflikten mit eventuell bereits vorhandenen Installationen von Perl und Ghostscript
- fhren sollten.
-\item[Tools fr die Kommandozeile.] Fr einige unter Unix bliche Programme werden Portierungen fr Windows
- mitgeliefert. Dies sind z.\,B. \cmdname{gzip}, \cmdname{chktex},
- \cmdname{jpeg2ps}, \cmdname{unzip}, \cmdname{wget} und einige Programme fr die Kommandozeile aus der
- \cmdname{xpdf}-Suite. (Vom
- \cmdname{xpdf}-Viewer selbst gibt es keine Version fr Windows, aber der
- Sumatra \acro{PDF}-Viewer basiert auf \cmdname{xpdf}:
- \url{http://blog.kowalczyk.info/software/sumatrapdf}.)
-\item[\texttt{fc-cache}] dient \XeTeX{} zur effizienteren Benutzung von Schriften.
-\item[PS\_View.] Weiterhin wird PS\_View installiert, ein neuer PostScript-Viewer, der Freie Software ist,
- s.\,Abb.~\ref{fig:psview}.
-%\end{description}
-%
-%\begin{description}
-\item[Das Verzeichnis \texttt{support}] wurde bereits in
- Abschnitt~\ref{sec:tld} erwhnt. Es enthlt einige Programme, die im Zusammenhang mit
- \TeX{} ntzlich sind, insbesondere einige Editoren mit \TeX-Modus und Benutzeroberflchen fr \TeX{}.
- Die in diesem Verzeichnis enthaltene Software wird nicht vom Installationsprogramm mit installiert.
- Weiterhin findet sich dort der \dvi{}-Previewer \cmdname{dviout}, siehe nchster Abschnitt.
-\end{description}
-
-\subsection{Der Dviout-Previewer}
-
-Von dieser Version von \TL{} wird leider kein \dvi{}-Previewer fr Windows mitinstalliert.
-Allerdings knnen Sie das Programm \prog{dviout} von
-Toshio Oshima aus dem Verzeichnis \path{support/dviout/} installieren. Im selben Verzeichnis findet sich
-die Datei \filename{README} mit einer kurzen Anleitung zur Installation und Konfiguration von
-\prog{dviout} fr \TL. Bitte beachten Sie diese Anleitung unbedingt!
-
-Wenn Sie am Anfang Dokumente mit \cmdname{dviout} anschauen, werden hufig noch Fonts generiert, da
-keine fertigen Fontdateien fr den Bildschirm mitgeliefert werden. Je mehr Fonts generiert wurden, desto
-seltener mssen Schriften nachgeneriert werden, so dass dieser Effekt nach einiger Zeit nur noch selten
-auftreten wird. Weitere Informationen finden Sie in der (sehr guten) Online-Hilfe.
-
-\subsection{Link zu zustzlicher Software}
-Hier einige URLs, hinter denen sich ntzliche Software verbirgt:
-\begin{description}
-\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/}
-\item[Perl] \url{http://www.perl.org/} mit
- Zusatzpaketen von \acro{CPAN}, \url{http://www.cpan.org/}.
-\item[ImageMagick] \url{http://www.imagemagick.com}, zum Manipulieren
- und Konvertieren von Grafikdateien.
-\item[NetPBM] \url{http://netpbm.sourceforge.net/}, ebenfalls zum
- Konvertieren von Grafikdateien.
-\item[Editoren mit \TeX-Untersttzung] Dies ist lediglich eine grobe Auswahl,
- und bekanntlich sind die Geschmcker verschieden, bei Editoren wie
- beim Essen.
- \begin{itemize*}
- \item \cmdname{GNU Emacs} gibt es auch fr Windows, siehe
- \url{http://www.gnu.org/software/emacs/windows/ntemacs.html}.
- \item \cmdname{Emacs} mit Auc\TeX\ fr Windows wird im
- \path{support}-Verzeichnis von \TL mitgeliefert. Die Homepage
- findet sich unter
- \url{http://www.gnu.org/software/auctex}.
- \item \cmdname{WinShell} findet sich ebenfalls im \path|support|-Verzeichnis.
- Die Homepage lautet \url{http://www.winshell.de}.
- \item \cmdname{WinEdt} ist Shareware und verfgbar von
- \url{http://www.winedt.com}.
- \item \cmdname{Vim} ist freie Software, verfgbar von
- \url{http://www.vim.org}.
- \item TeXnicCenter ist ebenfalls freie Software, verfgbar von
- \url{http://www.toolscenter.org} und Teil von pro\TeX{}t.
- \item \cmdname{LEd} ist verfgbar von \url{http://www.ctan.org/support/LEd}.
- \item \cmdname{SciTE} ist verfgbar von
- \url{http://www.scintilla.org/SciTE.html}.
- \end{itemize*}
-\end{description}
-
-\subsection{User Profile unter Windows}
-\label{sec:winhome}
-
-Das Gegenstck von Windows zum HOME-Verzeichnis unter Unix ist das
-Verzeichnis \verb|%USERPROFILE%|. Unter Windows XP und Windows 2000 liegt
-es meist im Verzeichnis \verb|C:\Documente und Einstellungen\<username>|, unter
-Windows Vista \verb|C:\Users\<username>|. In der Datei
-\filename{texmf.cnf} und in \KPS{} allgemein wird \verb|~|
-sowohl unter Unix und Windows korrekt aufgelst.
-
-\subsection{Die Windows-Registry}
-\label{sec:registry}
-
-Windows verwaltet fast all seine Konfigurationseinstellungen in der
-Registry. Diese besteht aus einem hierarchisch aufgebauten Baum
-von Schlsseln, wobei mehrere dieser Registry-Bume existieren.
-Die wichtigsten sind \path{HKEY_CURRENT_USER} und \path{HKEY_LOCAL_MACHINE},
-oft abgekrzt als \path{HKCU} bzw.\ \path{HKLM}.
-Der \path{HKCU}-Teil der Registry wird im Home-Verzeichnis des Benutzers
-gespeichert (s.\,Abschnitt~\ref{sec:winhome}). \path{HKLM} liegt im
-Normalfall in einem Unterverzeichnis des Windows-Verzeichnisses.
-
-In einigen Fllen sind Systeminformationen aus Umgebungsvariablen
-ersichtlich, in vielen anderen Fllen liegen diese Informationen
-aber in der Registry.
-
-\subsection{Windows Permissions}
-\label{sec:winpermissions}
-
-In neueren Versionen von Windows wird zwischen normalen Benutzern und
-Administratoren unterschieden, wobei nur letztere freien Zugang auf
-alle Teile des Betriebsystems haben. Im Gegensatz zu Unix ist es in der
-Praxis allerdings hufig so, dass Benutzer zur Klasse der Administratoren
-gehren und daher doch alle Freiheiten haben. Trotzdem haben wir einigen
-Aufwand getrieben, damit \TL auch unter Windows ohne Administrator-Rechte
-installiert werden kann.
-
-Falls der Benutzer, der \TL installiert, Administrator-Rechte besitzt,
-wird \TL fr alle Benutzer des Systems installiert, d.\,h. Verknpfungen,
-Mens und Systemeintrge fr alle Nutzer angelegt. Ansonsten werden diese
-nur fr den aktuellen Benutzer angelegt. Falls Sie Administrator sind,
-\TL aber trotzdem nur fr sich und nicht fr alle installieren wollen,
-knnen Sie dem Programm~\prog{install-tl} die Option~\optname{non-admin}
-mit geben.
-
-Unabhngig davon wird grundstzlich angenommen, dass das Wurzelverzeichnis
-von \TL unter \verb|%PROGRAMFILES%| liegen soll. Allerdings testet das
-Installationsprogramm, ob dieses Verzeichnis fr den aktuellen Benutzer
-schreibbar ist.
-
-Ein Problem entsteht, wenn \TL ohne Administrator-Rechte installiert
-wird und sich bereits ein \TeX{}-System im systemweiten Suchpfad
-befindet. Windows benutzt zuerst den Suchpfad des Systems, erst dann
-den spezifischen Suchpfad des Nutzers, so dass hier immer zuerst
-das alte \TeX-System gefunden wird. Als Workaround wird hier eine
-Verknpfung mit einer Eingabeaufforderung erzeugt, in der das
-Programmverzeichnis von \TL im Suchpfad vor den Standard\-such\-pfad
-geschrieben wird. Dies bedeutet, dass in diesem Fall nur in einer
-Eingabeaufforderung verfgbar ist, die ber diese Verknpfung gestartet
-wird.
-
-% ==============================================================
-% don't use \Webc so the \uppercase in the headline works.
-\section[Anleitung zum Web2C-System]{Anleitung zum \Webc-System}
-
-{\Webc} besteht aus einer Reihe von Programmen, die zusammen ein komplettes
-\TeX-System darstellen. Dazu gehren natrlich \TeX,
-\MF, \MP, {\BibTeX} usw.
-
-Die erste Implementierung eines \TeX-Systems
-in der Programmiersprache C stammt von Tomas~Rokicki und datiert zurck in das
-Jahr 1987. Rokicki benutzte als Basis sog. Change-Files unter \acro{UNIX}, die ursprnglich von
-Howard~Trickey und Pavel~Curtis entwickelt wurden. Tim~Morgan hat dieses
-System, fr das der Name Web-to-C\@ eingefhrt wurde, gepflegt.
-1990 hat Karl~Berry mit Untersttzung vieler Helfer die Weiterentwicklung
-bernommen und 1997 an Olaf~Weber weitergegeben, der es 2006 wieder an
-Karl zurck gab.
-
-\Webc{} luft unter \acro{UNIX}, 32-bit-Versionen von Windows, \MacOSX{}
-und auf weiteren Betriebssystemen. Es benutzt die
-Original-Quelldateien von Donald E.~Knuth und weitere in der
-Sprache {\web} entwickelte Programme als Basis und bersetzt diese
-in C-Quell-Code. Darber hinaus bietet das System viele Makros und
-Funktionen zur Nutzung der originalen \TeX-Software. Hier eine
-Liste der Basisprogramme eines \TeX-Systems:
-
-\begin{description}
-%\renewcommand{\makelabel}[1]{\descriptionlabel{\mdseries\cmdname{#1}}}
-\item[bibtex] Verwalten von Bibliographien
-\item[dmp] \cmdname{troff}-nach-MPX-Konverter (\MP-Bilder)
-\item[dvicopy] Umwandeln von virtuellen Zeichenstzen in DVI-Dateien
-\item[dvitomp] DVI-nach-MPX-Konverter (\MP-Bilder)
-\item[dvitype] Textanzeige aus DVI-Dateien
-\item[gftodvi] Erzeugen von Prfausgaben fr Zeichenstze
-\item[gftopk] Packen von Zeichenstzen
-\item[gftype] Anzeige von Zeichenstzen als ASCII-Graphik
-\item[makempx] Anzeige von \MP-Beschriftungen
-\item[mf] Zeichensatzerzeugung
-\item[mft] formatierte Ausgabe von \MF-Quellen
-\item[mpost] \MF-hnliches Grafikprogramm
-\item[mpto] Extrahieren von \MP-Beschriftungen
-\item[newer] Vergleich von Dateierstellungsdaten
-\item[patgen] Erzeugen von Trennmustern
-\item[pktogf] Entpacken von Zeichenstzen
-\item[pktype] Anzeige gepackter Zeichenstze
-\item[pltotf] Umwandeln von Property-Listen in \file{.tfm}-Dateien
-\item[pooltype] Anzeige der Bildschirmtexte eines WEB-Programms
-\item[tangle] Konverter {\web} nach Pascal
-\item[tex] \TeX-Programm
-\item[tftopl] Umwandeln einer \file{.tfm}-Datei in eine Property-Liste
-\item[vftovp] Umwandeln eines virtuellen Zeichensatzes in eine Property-Liste
-\item[vptovf] Umwandeln einer Property-Liste in einen virtuellen Zeichensatz
-\item[weave] \web-Code als \TeX-Dokumentation
-\end{description}
-
-Die genaue Funktionsweise und die mglichen Parameter sind der
-Beschreibung der jeweiligen Pakete bzw.\ der \Webc-Dokumentation zu entnehmen.
-Trotzdem wird ein berblick ber Zusammenspiel und Funktionsweise der
-\Webc-Programme Ihnen sicherlich helfen, besser mit dem System zurechtzukommen.
-
-Zunchst verstehen alle Programme die grundlegenden Parameter der
-\acro{GNU}-Software:
-
-\begin{description}
-\item[\texttt{-{}-help}] kurzer Hilfstext
-\item[\texttt{-{}-verbose}] ausfhrliche Ausgaben beim Programmablauf
-\item[\texttt{-{}-version}] Ausgabe der Versionsnummer
-\end{description}
-
-Die Programme des \Webc-Systems benutzen zum Lokalisieren der bentigten
-Dateien im Dateisystem die \KPS-Bibliothek (\url{http://tug.org/kpathsea}). Diese Bibliothek optimiert und
-beschleunigt den Suchprozess im Dateisystem. Ihre Arbeitsweise wird durch
-einige Umgebungsvariablen und eine Kon"-fi"-gu"-ra"-tions"-da"-tei gesteuert.
-\Webc~7.5 kann mehr als einen Dateibaum gleichzeitig verwalten und ermglicht
-somit die schon beschriebene \TL-Installation unter Verwendung der
-\acro{CDROM} oder {\DVD} mit der Ablage modifizierter Konfigurationsdateien
-und zustzlicher Zeichenstze in einem zweiten Dateibaum. Die Suche
-nach Dateien wird durch die Analyse der Datei \file{ls-R} beschleunigt,
-die in jedem Wurzelverzeichnis eines \TeX-Dateibaums vorhanden ist.
-Sie enthlt fr jede Datei die genaue Position im Dateibaum relativ
-zum Wurzelverzeichnis.
-
-% -------------------------------------------------------------
-\subsection[Dateisuche mit der Kpathsea-Bibliothek]{Dateisuche mit der \protect\KPS-Bibliothek}
-\label{sec:kpathsea}
-
-Wir beschreiben zunchst den grundlegenden Suchmechanismus der \KPS-Bibliothek.
-
-Ein \emph{Suchpfad} ist eine durch Kommata oder Semikola getrennte Liste von
-\emph{Pfadkomponenten}, die blicherweise Verzeichnisnamen darstellen.
-Ein Suchpfad kann sich aus vielen Komponenten zusammensetzen. Die Suche nach
-einer Datei \samp{my-file} ber den Suchpfad \samp{.:/dir} bewirkt, dass
-{\KPS} jede Komponente nacheinander berprft, also zunchst
-\samp{./my-file} und dann \samp{/dir/my-file}. Als Ergebnis wird entweder die
-erste gefundene Datei oder eine Liste aller passenden Dateien geliefert.
-
-Um auf allen Dateisystemen effizient arbeiten zu knnen, verwendet {\KPS} ggf. andere
-Datei-/""Verzeich"-nis-Separatoren als \samp{:} und \samp{/}.
-
-Beim berprfen einer Pfadkomponente \var{p} berprft {\KPS} zunchst,
-ob eine Dateinamen"=Datenbank (siehe auch Dateinamen"=Datenbank auf
-Seite~\pageref{sec:filename-database}) fr die Pfadkomponente zustndig ist,
-d.\,h. beispielsweise steht die Datenbank in einem Verzeichnis, das im Pfad
-vor der zu berprfenden Komponente \var{p} steht. In diesem Fall wird
-zur Bestimmung der Position der gesuchten Datei die Datenbank herangezogen.
-
-Nur wenn keine passende Datenbank existiert oder wenn die Datei nicht
-in der Datenbank gefunden wird, durchsucht {\KPS} das Dateisystem. Diese
-zeitaufwndige Suche kann ber die Spezifikation der Pfadkomponente \var{p}
-mit dem Prfix \samp{!!}\ unterbunden werden. Zur Suche erzeugt {\KPS} eine
-Liste der Verzeichnisse, die im Pfadelement enthalten sind, und durchsucht
-jedes dieser Verzeichnisse nach der gesuchten Datei.
-
-Fr Dateien kann auch ein Schalter \samp{file~must~exist} gesetzt
-werden (">Datei muss vorhanden sein"<). Wenn dieser Schalter nicht
-gesetzt ist und beispielsweise ber das \TeX-Kommando
-\cs{openin} eine VF-Datei wie \file{cmr10.vf} gelesen werden
-soll, wre es falsch, nach dieser Datei zu suchen, weil es sie gar
-nicht gibt. Speziell fr neu installierte VF-Dateien sollten Sie
-also unbedingt die Dateinamen"=Datenbank (\cmdname{ls-R})
-aktualisieren, weil die Dateien sonst nicht gelesen werden und
-kein Fehler angezeigt wird. Dieser Vorgang wiederholt sich fr jede
-Komponente eines Suchpfades: zunchst wird die Datenbank
-berprft, danach ggf. das Dateisystem. Wird die Datei gefunden,
-stoppt die Suche (normalerweise) und als Ergebnis wird der komplette Pfad zur
-gesuchten Datei ausgegeben.
-
-Auer Verzeichnisnamen drfen Pfadkomponenten fr {\KPS} folgende
-Elemente enthalten: (verschachtelte) Vorgaben, Umgebungsvariablen,
-Werte aus der Konfigurationsdatei, Home-Verzeich"-nisse von
-Benutzern und Startverzeichnisse fr eine rekursive Suche. Diese
-Elemente werden vor einer Dateisuche von {\KPS} in gewhnliche
-Verzeichnis- oder Dateinamen expandiert. Diese Expansion wird in
-den folgenden Abschnitten erklrt, und zwar genau in der
-Reihenfolge, wie die Elemente auch von {\KPS} bearbeitet werden.
-
-Beachten Sie, dass {\KPS} bei absoluten und explizit relativen Komponenten,
-d.\,h. wenn die Komponente mit den Zeichen \samp{/}, \samp{./} oder
-\samp{../} beginnt, nur berprft, ob die Datei existiert.
-
-\ifSingleColumn
-\else
-
-\begin{figure*}[tp]
-\verbatiminput{examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{An illustrative configuration file sample}
- \label{fig:config-sample}
-\end{figure*}
-\fi
-
-% ..............................................................
-\subsubsection{Bestandteile von Pfadkomponenten}\label{Path-sources}
-\label{sec:path-sources}
-
-Ein Suchpfad kann aus vielen verschiedenen Bestandteilen aufgebaut werden.
-Dies sind in der Reihenfolge, wie {\KPS} sie auswertet:
-
-\begin{enumerate}
-\item
- eine benutzerdefinierte Umgebungsvariable, z.\,B. \envname{TEXINPUTS}:
- Wird an den Inhalt der Variablen ein Punkt und ein Programmname angehngt, wie
- beispielsweise bei \envname{TEXINPUTS.latex}, hat diese Form Vorrang
- vor den ">gewhnlichen"< Variablen.
-\item
- Eintrge aus programmspezifischen Konfigurationsdateien,
- beispielsweise zum Programm {\dvips} eine Zeile \samp{S /a:/b}
- in der Konfigurationsdatei \file{config.ps}
-\item
- Eintrge aus der \KPS-Konfigurationsdatei \file{texmf.cnf},
- z.\,B. \samp{TEXINPUTS=/c:/d} (siehe folgenden Text)
-\item
- Einstellung beim bersetzen der Programme
-\end{enumerate}
-
-Unter Verwendung der Parameter zur Fehlersuche knnen Sie sich diese
-Werte fr einen Suchpfad auch anzeigen lassen. (Siehe dazu den Abschnitt
-Fehlersuche auf Seite~\pageref{sec:debugging}.)
-
-% ..............................................................
-\subsubsection{Konfigurationsdateien}
-
-%\tolerance=3500
-Die \KPS-Bibliothek liest zur Laufzeit die \emph{Konfigurationsdateien} mit den Namen
-\file{texmf.cnf}. Der zugehrige Suchpfad zum Auf"|finden dieser
-Konfigurationsdateien steht in der Umgebungsvariablen \envname{TEXMFCNF}
-(die Voreinstellung ist \file{texmf/web2c}). {\KPS} liest \emph{alle}
-Dateien mit den Namen \file{texmf.cnf}, die es in diesem Suchpfad findet.
-Die zuerst gelesenen Definitionen haben dabei Vorrang vor spter gelesenen
-Werten.
-Wenn der Suchpfad auf \dirname{.:\$TEXMF} steht, berschreiben die Einstellungen
-in \file{./texmf.cnf} diejenigen in \dirname{\$TEXMF/texmf.cnf}.
-
-%\tolerance=1500
-
-Im Folgenden wird die Syntax der Datei \file{texmf.cnf} angegeben.
-Konsultieren Sie zum besseren Verstndnis beim Lesen die auf der
-{\acro{CDROM}} oder {\DVD} enthaltene Konfigurationsdatei.
-%, die ab Seite~\pageref{app:texmf.cnf} im Anhang dieser Anleitung
-% abgedruckt ist.
-
-\begin{itemize}
-\item
- Kommentare beginnen mit einem \samp{\%} und erstrecken sich bis zum
- Zeilenende.
-\item
- Leerzeilen werden berlesen.
-\item
- Ein \samp{\bs} am Zeilenende fasst die aktuelle mit der folgenden Zeile
- zusammen. Leerraum in der Folgezeile wird \emph{nicht} berlesen.
-\item
- Sonstige Zeilen haben den folgenden Aufbau:
-
-\begin{alltt}
- \var{Variable}[.\var{Programmname}] [=] \var{Wert}
-\end{alltt}%
-
- Das Zeichen ">="< und umgebender Leerraum drfen entfallen.
-\item
- Der Name von \var{Variable} kann alle Zeichen auer Leerzeichen,
- \samp{=} und \samp{.} enthalten. Verwenden Sie am besten nur die Zeichen
- \samp{A-Za-z\_}.
-\item
- Wenn das Suffix ">\code{.\var{Programmname}}"< angegeben wird, gilt die
- Variable nur fr das entsprechende Programm ">\var{Programmname}"< oder
- ">\code{\var{Programmname}.exe}"<. Auf diese Weise knnen
- beispielsweise verschiedene
- \TeX-Formate mit unterschiedlichen Suchpfaden arbeiten.
-\item
- \texttt{\var{Wert}} darf alle Zeichen auer \texttt{\%} und \texttt{@}
- enthalten.
- Die Einschrnkung der Werte auf bestimmte Programme ber ein Suffix
- ist nicht zulssig. Ein \samp{;} in \texttt{\var{Wert}} wird unter
- \acro{UNIX} in \samp{:} umgewandelt. Dadurch ist die Verwendung der gleichen
- Konfigurationsdateien fr \acro{UNIX} und \acro{DOS}/""Windows"=Systeme mglich.
-\item
- Die Definitionen werden komplett eingelesen, bevor eine Expansion
- stattfindet. Dadurch knnen Sie die Variable schon vor Ihrer Definition
- referieren.
-\end{itemize}
-
-Der Ausschnitt einer Konfigurationsdatei demonstriert diese
-Mglichkeiten.
-\ifSingleColumn
-\verbatiminput{examples/ex5.tex}
-\else
-Betrachten Sie Abbildung~\ref{fig:config-sample}.
-\fi
-
-% ..............................................................
-\subsubsection{Expansion von Pfadkomponenten}
-\label{sec:path-expansion}
-
-{\KPS} verwendet in Suchpfaden hnliche Zeichen und Konstrukte wie
-\acro{UNIX}-Shells. Beispielsweise wird die Definition
-\verb|~$USER/{foo,bar}//baz| in alle Unterverzeichnisse von \file{foo} und
-\file{bar} unterhalb vom Home-Verzeichnis von \dirname{\$USER} expandiert,
-die eine Datei oder ein Unterverzeichnis namens \file{baz} enthalten. Der
-Expansionsmechanismus wird im Folgenden erklrt.
-
-% ..............................................................
-\subsubsection{Expansion der Voreinstellungen}
-\label{sec:default-expansion}
-
-Wenn der Suchpfad mit der hchsten Prioritt (siehe hierzu ">Bestandteile von
-Pfadkomponenten"< auf Seite~\pageref{sec:path-sources}) einen zustzlichen
-(vorangestellten, nachgestellten oder verdoppelten) Doppelpunkt enthlt,
-wird an dieser Stelle der Suchpfad eingefgt, der als nchstes in der
-Hierarchie folgt. Auch bei diesem gilt dieselbe Regel. Wenn beispielsweise
-die Umgebungsvariable
-
-\begin{alltt}
-> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
-
-gesetzt wird (hier: C-Shell) und in \file{texmf.cnf} die Variable
-\code{TEXINPUTS} folgenden Wert erhlt
-
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
-
-dann lautet der Suchpfad schlielich:
-
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-
-Da es sinnlos wre, denselben Pfad mehrfach einzufgen, wird die Ersetzung
-nur einmal vorgenommen, und zwar in der Reihenfolge vorne, hinten und
-Mitte. Mehrfach verdoppelte Doppelpunkte bleiben unverndert.
-
-% ..............................................................
-\subsubsection{Expansion geschweifter Klammern}
-
-Die Expansion geschweifter Klammern ist zur Definition mehrerer
-\TeX-Hierarchien sehr ntzlich. Beispielsweise wird |v{a,b}w|
-zu |vaw:vbw|. Verschachtelungen sind dabei erlaubt.
-Diese Technik wird dazu benutzt, durch eine Zuweisung an
-\code{\$TEXMF} verschiedene \TeX-Hierarchien einzufhren.
-Als Beispiel finden Sie in \file{texmf.cnf} folgende Definition
-(etwas gekrzt, tatschlich ist es etwas komplexer):
-%(Zeile 75): %%%% to be checked !!!! checked&corrected vrws 01.06.05
-
-\begin{verbatim}
- TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN}
-\end{verbatim}
-
-Eine Anwendung wie
-
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-%$
-fhrt dann dazu, dass erst im aktuellen Verzeichnis gesucht wird, dann
-im gesamten Dateibaum \code{\$TEXMFHOME/tex} und \code{\$TEXMFLOCAL/tex}
-(auf der Festplatte) und
-schlielich im gesamten Dateibaum \dirname{\$TEXMFVAR/tex} sowie
-\code{\$TEXMFMAIN/tex} (nur in der Datenbank \file{ls-R})
-durchsucht wird. Dadurch kann man bequem
-zwei parallel installierte \TeX-Hierarchien durchsuchen,
-beispielsweise eine unvernderliche auf \acro{CDROM}/{\DVD} und eine dynamisch
-angepasste auf Festplatte, in der neue Programmversionen und zustzliche
-Zeichenstze installiert werden. Durch die Verwendung der Variablen
-\code{\$TEXMF} in allen Definitionen wird grundstzlich zuerst der
-neuere Dateibaum durchsucht.
-
-% ..............................................................
-\subsubsection{Expansion von Unterverzeichnissen}
-\label{sec:subdirectory-expansion}
-
-Zwei oder mehrere aufeinanderfolgende Schrgstriche (\texttt{//}) in
-einer Pfadkomponente, die auf einen Verzeichnisnamen \var{d} folgen,
-werden expandiert zu allen Unterverzeichnissen von \var{d}. Dieser
-Vorgang findet rekursiv statt, wobei erst alle Verzeichnisse auf
-einer Ebene bearbeitet werden, dann deren Unterverzeichnisse, usw.
-Auf den jeweiligen Ebenen ist nicht beeinflussbar, in welcher
-Reihenfolge die Unterverzeichnisse bearbeitet werden.
-
-Wenn nach den Schrgstrichen Namen angegeben werden, dann werden nur
-Unterverzeichnisse mit passenden Namen in die Suche einbezogen.
-Beispielsweise wird \samp{/a//b} in die Pfade \file{/a/1/b},
-\file{/a/2/b}, \file{/a/1/1/b} usw. expandiert, aber nicht
-zu \file{/a/b/c} oder \file{/a/1}.
-(Jeweils vorausgesetzt, dass die Verzeichnisse existieren.)
-
-Mehrere \samp{//}-Konstruktionen innerhalb einer Pfadkomponente
-sind zulssig, allerdings nicht am Pfadanfang.
-
-% ..............................................................
-\subsubsection{Liste der Sonderzeichen und ihre Bedeutung: eine Zusammenfassung}
-
-Die folgende Zusammenfassung fasst alle Sonderzeichen zusammen, die in den
-\KPS"=Konfigurationsdateien auftreten knnen:
-
-% ++++++++++++++++++++++++
-\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
-% ++++++++++++++++++++++++
-
-\begin{description}
-\item[\CODE{:}] Trennzeichen fr Pfadkomponenten; als erstes
- oder letztes Zeichen im Pfad bewirkt es die
- Expansion der Voreinstellungen.
-\item[\CODE{;}] Trennzeichen fr Pfadkomponenten fr andere
- Rechnerplattformen als \acro{UNIX} (Verwendung wie
- ">\code{:}"<)
-\item[\CODE{\$}] Expansion von Variableninhalten
-\item[\CODE{\string~}] Home-Verzeichnis eines Benutzers (Tilde)
-\item[\CODE{\char`\{...\char`\}}] Expansion geschweifter Klammern:
- beispielsweise wird |a{1,2}b| zu |a1b:a2b|.
-\item[\CODE{//}] Expansion von Unterverzeichnissen: tritt niemals
- am Anfang einer Pfadkomponente auf.
-\item[\CODE{\%}] Kommentar
-\item[\CODE{\bs}] Konkatenation mit Folgezeile(n)
-\item[\CODE{!!}] Einschrnkung der Suche \emph{ausschlielich} auf die
- Dateinamen"=Datenbank: Das Dateisystem wird \emph{nicht}
- durchsucht!
-\end{description}
-
-% -------------------------------------------------------------
-\subsection{Dateinamen"=Datenbanken}
-\label{sec:filename-database}
-
-{\KPS} unternimmt etliche Anstrengungen, um den Zugriff auf Festplatte und
-\acro{CDROM}/{\DVD} zur Suche nach Dateien zu reduzieren. Auf \TeX-Systemen mit
-vielen Unterverzeichnissen kann die Suche in jedem mglichen Verzeichnis
-nach einer bestimmten Datei eine lange Zeit in Anspruch nehmen, besonders
-wenn einige Hundert Zeichensatzverzeichnisse durchforstet werden mssen.
-Um dieses Problem abzumildern, benutzt {\KPS} eine Art Datenbankdatei
-namens \file{ls-R}, die die Zuordnung von Dateinamen auf Verzeichnisse
-enthlt. Dadurch muss nicht jedesmal die Festplatte durchsucht werden.
-
-Eine zweite Datenbank in der Datei \file{aliases} kann eine Zuordnung
-zwischen den Namen in \file{ls-R} und weiteren Namen vornehmen und so
-beispielsweise hilfreich bei der Umsetzung von \samp{8.3}-\acro{DOS}-Dateinamen
-auf die ">echten"<, aussagekrftigen Dateinamen zur Seite stehen.
-
-% ..............................................................
-\subsubsection{Die \texttt{ls-R}-Datenbank}
-\label{sec:ls-R}
-
-Wie schon fters erwhnt, muss die Dateinamen"=Datenbank in der Datei
-\file{ls-R} gespeichert sein. Sie sollten eine solche Datenbank fr jede
-\TeX-Hierarchie (normalerweise in \code{\$TEXMF}) Ihres Systems anlegen.
-Die meisten \TeX-Systeme arbeiten nur mit einer Hierarchie. {\KPS} sucht
-die Datenbanken \file{ls-R} ber den Pfad \code{TEXMFDBS}.
-
-Es wird empfohlen, die Pflege der \code{ls-R}-Dateien dem mitgelieferten
-Skript \cmdname{mktexlsr} zu berlassen. Dieses Skript wird automatisch von den
-verschiedenen \samp{mktex*}-Skripten aufgerufen. Das Skript ruft
-grob gesagt den Befehl
-
-\begin{alltt}
-cd /\var{your}/\var{texmf}/\var{root} && ls -LAR ./ >ls-R
-\end{alltt}
-
-auf, falls das Kommando \code{ls} Ihres Rechners eine Ausgabe im richtigen
-Format liefert. (So wie das \acro{GNU}-\code{ls}.) Wenn Sie ganz sichergehen
-wollen, dass die Datenbank immer auf dem neuesten Stand ist, sollten Sie sie
-in regelmigen Abstnden mit Hilfe eines \cmdname{crontab}-Eintrags
-aktualisieren lassen. Dadurch wird nach einer Installation eines
-Pakets per Hand trotzdem sichergestellt, dass die Datenbank aktuell ist.
-
-Wenn eine Datei nicht ber die Datenbank gefunden wird, sucht
-{\KPS} normalerweise auf der Festplatte weiter. Wenn eine Pfadkomponente
-mit \samp{!!} beginnt, wird dagegen niemals die Festplatte durchsucht.
-
-% ..............................................................
-\subsubsection{\cmdname{kpsewhich}: Dateisuche}
-\label{sec:invoking-kpsewhich}
-
-Mit dem Programm \cmdname{kpsewhich} knnen Sie unabhngig vom Aufruf
-irgendeines \TeX-Programms nach Dateien in der \TeX-Hierarchie suchen
-(als schnellere Alternative zu dem Befehl \cmdname{find}). Dies
-wird von den verschiedenen \samp{mktex\dots}-Skripten bis zum
-Exzess vorexerziert.
-
-\begin{alltt}
-> \Ucom{kpsewhich \var{option}{\dots} \var{filename}{\dots}}
-\end{alltt}
-
-Die Optionen werden entweder mit \samp{-} oder mit \samp{-{}-} eingeleitet.
-Jede eindeutige Abkrzung ist zulssig.
-
-Argumente der Kommandozeile, die keine Optionen darstellen, werden als
-Dateinamen interpretiert. Fr jeden Dateinamen wird der erste passende
-Pfad gemeldet. Um eine Liste aller passenden Pfade zu erhalten, mssen Sie
-das \acro{UNIX}-Kommando \cmdname{find} aufrufen.
-
-Im Folgenden werden die hufiger benutzten Optionen beschrieben.
-
-\begin{description}
-\item[\texttt{-{}-dpi=}\var{num}]\mbox{}\\
- Stellt die Auf"|lsung fr die Suche nach Zeichenstzen
- (nur \file{.gf} oder \file{.pk}) auf \var{num}\,dpi. Alternativ
- kann die Option \optname{-D} (kommt von \dvips) benutzt werden.
- Voreinstellung ist~600.
-\item[\texttt{-{}-format=}\var{name}]\mbox{}\\
- Setzt das Format zur Suche auf \var{name}. Per Voreinstellung
- versucht \cmdname{kpsewhich} das Format ber den Dateinamen
- zu erschlieen. Bei Formaten ohne zugeordnete Namens\-endung wie den
- zu {\MP} gehrenden Dateien und den Konfigurationsdateien zu
- {\dvips} mssen Sie den entsprechenden Namen so eingeben, wie er
- \KPS{} bekannt ist.
-\item[\texttt{-{}-mode=}\var{string}]\mbox{}\\
- Setzt fr die Zeichensatzsuche den Generierungsmodus (betrifft nur
- \file{.gf}- oder \file{.pk}-Dateien). Normalerweise werden alle
- Zeichenstze gemeldet.
-\item[\texttt{-{}-must-exist}]\mbox{}\\
- Es wird versucht, die Dateien notfalls durch eine Suche auf der
- Festplatte zu finden. Normalerweise wird nur die \file{ls-R}-Datenbank
- konsultiert.
-\item[\texttt{-{}-path=}\var{string}]\mbox{}\\
- Sucht entlang des angegebenen Pfads statt des Standardpfads,
- der auf Grund der Endung gewhlt wird. Alle Expansionen sind
- zulssig. Bei Verwendung der Option \texttt{-{}-path} darf nicht
- die Option \texttt{-{}-format} angegeben werden.
-\item[\texttt{-{}-progname=}\var{name}]\mbox{}\\
- Setzt den Programmnamen fr die genauere Variablenspezifikation
- ber \samp{.\var{Programmname}}. Voreinstellung ist \samp{kpsewhich}.
-\item[\texttt{-{}-show-path=}\var{name}]\mbox{}\\
- Zeigt den Suchpfad fr die angegebene Namens\-endung. Diese kann entweder
- als Namens\-endung (\samp{.pk}, \samp{.vf}, usw.) oder als Name (wie bei der
- Option \optname{-{}-format}) spezifiziert werden.
-\item[\texttt{-{}-debug=}\var{num}]\mbox{}\\
- Legt den Umfang fr die Fehlersuche fest.
-\end{description}
-
-% ..............................................................
-\subsubsection{Anwendungsbeispiele}
-\label{sec:examples-of-use}
-
-Wir schauen uns nun die Funktionsweise von {\KPS} anhand einiger Beispiele an.
-
-\begin{alltt}
-> \Ucom{kpsewhich article.cls}
- /usr/local/texmf-dist/tex/latex/base/article.cls
-\end{alltt}
-
-Wir suchen unter den \TeX-Quelldateien nach der Datei \file{article.cls}.
-Da die Namens\-endung \samp{.cls} eindeutig ist, mssen wir den Typ
-\samp{.tex} nicht angeben. Die \samp{texmf-dist}-Hierarchie enthlt die
-Datei im Unterverzeichnis \dirname{tex/latex/base}. hnlich bereiten
-die folgenden Beispiele auf Grund eindeutiger Namens\-endungen keine Probleme.
-
-\begin{alltt}
-> \Ucom{kpsewhich array.sty}
- /usr/local/texmf-dist/tex/latex/tools/array.sty
-> \Ucom{kpsewhich latin1.def}
- /usr/local/texmf-dist/tex/latex/base/latin1.def
-> \Ucom{kpsewhich size10.clo}
- /usr/local/texmf-dist/tex/latex/base/size10.clo
-> \Ucom{kpsewhich small2e.tex}
- /usr/local/texmf-dist/tex/latex/base/small2e.tex
-> \Ucom{kpsewhich tugboat.bib}
- /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-Beim letzten Beispiel handelt es sich brigens um eine \BibTeX-Literaturdatenbank
-fr \textsl{TUGBoat}-Artikel.
-
-\begin{alltt}
-> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
-
-Zeichensatzdateien mit der Namens\-endung \samp{.pk} werden
-von Anzeige- oder Druckaufbereitungsprogrammen wie {\dvips} und
-\cmdname{xdvi} verwendet. Nachdem wir aufgrund der Voreinstellung keine \file{.pk}-Dateien verwenden,
-sondern die \PS-\TypeI-Zeichenstze, die auf der \acro{CDROM}/{\DVD} enthalten
-sind, wird auch keine \file{.pk}-Datei angezeigt.
-
-\begin{alltt}
-> \Ucom{kpsewhich wsuipa10.pk}
-\ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
-\else /usr/local/texmf-var/fonts/pk/ljfour/public/
-... wsuipa/wsuipa10.600pk
-\fi\end{alltt}
-Fr diesen Zeichensatz (Teil der \acro{IPA}-Fonts%
-\footnote{\acro{IPA}: International Phonetic Alphabet}
-von der Universitt von Washington) liegen noch keine
-\TypeI-Umsetzungen vor und \samp{.pk}-Dateien mssen generiert werden. Da unser voreingestellter \MF-Modus
-\samp{ljfour} eine Auf"|lsung von 600\,dpi besitzt,
-finden wir (nachdem er schon einmal gebraucht und automatisch
-erzeugt wurde) eine entsprechende Instanz dieses Zeichensatzes.
-
-\begin{alltt}
-> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
-\end{alltt}
-
-Durch die Angabe ">\optname{-dpi=300}"< interessieren wir uns nur
-fr Zeichenstze mit der Auf"|lsung 300\,dpi. Es wurde keiner gefunden.
-Programme wie {\dvips} oder \cmdname{xdvi} lassen einen solchen fehlenden
-Zeichensatz durch den Aufruf des Skripts \cmdname{mktexpk} mit entsprechenden
-Parametern automatisch erzeugen.
-
-Als nchstes wenden wir uns den Header- und Konfigurationsdateien
-von {\dvips} zu.
-Zunchst suchen wir nach der Konfiguration fr die \TeX-Untersttzung,
-dem Prolog \file{tex.pro}. Danach suchen wir die allgemeine Konfigurationsdatei
-(\file{config.ps}) und schlielich die \PS-Zeichensatzzuordnungsdatei
-\file{psfonts.map}. Dateien dieser Art haben seit der 2004er-Version der {\TL} ihre eigenen Suchpfade und einen neuen Aufbewahrungsort im \OnCD{texmf}-Baum. Da die Namens\-endung \samp{.ps} nicht eindeutig ist,
-mssen wir den gewnschten Typ (\samp{dvips config})
-fr die Datei \file{config.ps} spezifizieren.
-
-\begin{alltt}
-> \Ucom{kpsewhich tex.pro}
- /usr/local/texmf/dvips/base/tex.pro
-> \Ucom{kpsewhich --format="dvips config" config.ps}
- /usr/local/texmf/dvips/config/config.ps
-> \Ucom{kpsewhich psfonts.map}
- /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map
-\end{alltt}
-
-Jetzt suchen wir nach den Dateien fr den \PS-Zeichensatz ">URW Times"<.
-Nach dem Namensschema von Karl~Berry beginnen die Namen mit ">\texttt{utm}"<.
-Zunchst suchen wir die Konfigurationsdatei, die den Namen der
-Zeichensatzzuordnungsdatei enthlt.
-
-\begin{alltt}
-> \Ucom{kpsewhich --format="dvips config" config.utm}
- /usr/local/texmf-dist/dvips/psnfss/config.utm
-\end{alltt}
-
-Diese Datei enthlt folgende Anweisung:
-
-\begin{alltt}
- p +utm.map
-\end{alltt}
-
-Die angegebene Datei \file{utm.map} wollen wir als nchstes suchen:
-
-\begin{alltt}
-> \Ucom{kpsewhich utm.map}
- /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
-\end{alltt}
-
-Diese Zuordnungsdatei wird im Unterverzeichnis \file{urw} bei den
-Hilfsdateien fr {\dvips} gefunden. Sie enthlt die Dateinamen der
-\TypeI-\PS-Zeichenstze, die fr URW Times benutzt werden. Ein
-kleiner Auszug aus dieser Datei:
-
-\begin{alltt}
- utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
- utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
- utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
- utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
- utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
- utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
-
-Wenn wir jetzt beispielsweise nach dem Zeichensatz Times Regular
-(\file{utmr8a.pfb}) suchen, finden wir ihn im
-Verzeichnis \OnCD{texmf} unter den \TypeI-Zeichenstzen:
-
-\begin{alltt}
-> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
-\else /usr/local/texmf-dist/fonts/type1/
-... urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
-Diese Beispiele sollten deutlich gemacht haben, wie leicht bestimmte Dateien
-im \TeX-Dateibaum gefunden werden knnen. Dies ist sehr wichtig, wenn Sie
-den Verdacht haben, dass eine falsche Version einer Datei verwendet wird:
-Sie lassen sich einfach die verwendete Datei von \cmdname{kpsewhich}
-anzeigen.
-
-% ..............................................................
-\subsubsection{Fehlersuche}
-\label{sec:debugging}
-
-Manchmal ist wichtig, bis ins Detail nachzuvollziehen, wie ein Programm eine
-bestimmte Datei findet. Zu diesem Zweck bietet die \KPS-Bibliothek verschiedene
-Stufen fr den Umfang der Fehlersuche an.
-
-\begin{itemize}
-\item[\texttt{\ 1}] \code{stat}-Aufrufe (berprfung, ob Datei
- existiert); mit einer aktuellen \file{ls-R}-Datenbank sollten Sie fast
- keine Meldungen erhalten.
-\item[\texttt{\ 2}] Zugriffe auf Suchlisten (wie \file{ls-R}-Datenbanken,
- Zuordnungsdateien (\texttt{.map}), Konfigurationsdateien)
-\item[\texttt{\ 4}] ffnen und Schlieen von Dateien
-\item[\texttt{\ 8}] Auf"|listen der voreingestellten Pfade fr Extensionen
-\item[\texttt{16}] Verzeichnisliste fr jede Pfadkomponente (nur bei Festplattenzugriff)
-\item[\texttt{32}] Suchaktionen nach Dateien
-\item[\texttt{64}] Werte von Variablen.
-\end{itemize}
-
-Durch die Angabe von \samp{-1} setzen Sie alle Stufen gleichzeitig.
-Fr eine effiziente Fehlersuche sollten Sie sich auf die wichtigsten
-Ausgaben beschrnken.
-
-Fr {\dvips} gibt es einen hnlichen Mechanismus zur Erzeugung
-von Analysemeldungen, um herauszufinden, warum bestimmte Dateien geffnet
-wurden bzw.\ wo vielleicht das Problem liegt, wenn Dateien nicht gefunden
-werden.
-
-Da fast alle Programme die \KPS-Bibliothek benutzen, knnen Sie die
-gewnschte Stufe auch ber die Umgebungsvariable \envname{KPATHSEA\_DEBUG}
-einstellen, indem Sie einen der Werte oder eine additive Kombination
-spezifizieren.
-
-Anmerkung fr Windows-Benutzer: Es ist nicht einfach, alle Meldungen in eine Datei umzulenken. Fr die Fehlersuche
-jedoch ist die folgende (temporre!) Vereinbarung sinnvoll:
-
-\indent\texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log}
-
-Wir betrachten als Beispiel eine kleine \LaTeX-Quelldatei mit dem Namen
-\file{hello-world.tex} mit folgendem Inhalt:
-
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
-
-Diese Datei verwendet nur einen Zeichensatz, nmlich \file{cmr10}. Wir sehen uns
-jetzt einmal genau an, wie {\dvips} die \PS-Datei erzeugt.
-Da wir die \TypeI-Variante der Computer-Modern-Roman-Zeichenstze
-verwenden wollen, haben wir die Option \optname{-Pcms} verwendet.
-
-\begin{alltt}
-> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
-
-Hier haben wir als Stufe zur Fehlersuche eine Kombination der Stufe~\code{4} von
-{\dvips} (siehe \dvips-Handbuch,
-\dirname{texmf/doc/html/dvips/dvips\_toc.html}?).
-%\ifSingleColumn
-%We get something
-%like the following (we have rearranged the output for easier display):
-%\begin{alltt}\small
-%\input{examples/ex6.tex}
-%\end{alltt}
-%\else
-Die Ausgabe sieht ungefhr so wie in
-Abbildung~\ref{fig:dvipsdbga} dargestellt aus (die Ausgabe wurde fr einen besseren berblick
-etwas umgestaltet).
-
-\begin{figure*}[tp]
-\centering
-\input{examples/ex6a.tex}
-\caption{Suche nach Konfigurationsdateien}\label{fig:dvipsdbga}
-
-\bigskip
-
-\input{examples/ex6b.tex}
-\caption{Suche nach Prologdateien}\label{fig:dvipsdbgb}
-
-\bigskip
-
-\input{examples/ex6c.tex}
-\caption{Suche nach Font-Dateien}\label{fig:dvipsdbgc}
-\end{figure*}
-
-Zunchst sucht {\dvips} (bzw.\ \KPS) seine Konfigurationsdateien,
-nmlich \file{texmf.cnf} (das die Pfade der anderen Dateien enthlt),
-dann die Dateinamen"=Datenbank \file{ls-R} (zur Optimierung der Suche)
-und die Datei \file{aliases}, mit deren Hilfe fr eine Datei
-mehrere Namen vereinbart werden knnen, z.\,B. um die kurzen
-\samp{8.3}-\acro{DOS}-Namen mit aussagefhigen, langen Namen zu assoziieren.
-Danach wird die allgemeine \dvips-Konfigurationsdatei
-\file{config.ps}, anschlieend die benutzerspezifische Konfigurationsdatei
-\file{.dvipsrc} (wird hier \emph{nicht} gefunden) gesucht.
-Als letztes sucht {\dvips} die Zuordnungsdatei fr
-Computer-Modern-{\PS}"=Zeichenstze \file{config.cms} (bedingt durch die
-Option \optname{-Pcms} beim Aufruf von \dvips). Diese
-Datei enthlt die Dateinamen der Listen, die die Zuordnung zwischen
-Dateinamen und Zeichensatznamen herstellen.
-
-\begin{alltt}
-> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
- p +ams.map
- p +cms.map
- p +cmbkm.map
- p +amsbkm.map
-\end{alltt}
-
-{\dvips} versucht, diese Dateien und zustzlich die
-allgemeine Zeichensatzzuordnungstabelle \file{psfonts.map} zu
-laden, die immer konsultiert wird; der letzte Teil von
-Abschnitt~\ref{sec:examples-of-use} erklrt diese Tabellen genauer.
-
-Jetzt erfolgt die normale Startmeldung von \dvips:
-
-\begin{alltt}\ifSingleColumn
-dvips(k) 5.94a
-kpathsea version
-Copyright (C) 2003 Radical Eye Software.
-...
-\else\small{}dvips(k) 5.94a
-kpathsea version
-Copyright (C) 2003 Radical Eye Software.
-...
-\fi\end{alltt}% decided to accept slight overrun in tub case
-\ifSingleColumn
-Danach wird nach \file{texc.pro} gesucht:
-
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
-Danach wird nach \file{texc.pro} gesucht (siehe Abbildung~\ref{fig:dvipsdbgb}).
-\fi
-Dann gibt {\dvips} Datum und Uhrzeit aus und meldet den Dateinamen
-der erzeugten \PS-Datei \file{hello-world.ps}. Jetzt wird die
-Zeichensatzdatei \file{cmr10} bentigt, die {\dvips} als
-">resident"< meldet.
-
-\enlargethispage{1ex}
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
-
-Es geht weiter mit \file{cmr10.tfm} und einigen weiteren Prologdateien,
-deren Ausgaben wir hier weglassen. Letztlich wird die \TypeI-Zeichensatzdatei
-\file{cmr10.pfb} gesucht (und gefunden) und in die Ausgabedatei integriert
-(siehe letzte Zeile).
-
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-% -------------------------------------------------------------
-\subsection{Einstellungen zur Laufzeit}
-
-Zu den willkommenen Erweiterungen von {\Webc} zhlt die Mglichkeit,
-zur Laufzeit einige Speicher"-gren ber die Datei \file{texmf.cnf} anpassen
-zu knnen (insbesondere die Gre einiger Stacks). Eine ausfhrliche Liste
-der vernderbaren Parameter finden Sie in der Datei \file{texmf.cnf}.
-Die wichtigsten Werte sind:
-
-\begin{description}
-\item[\texttt{main\_memory}]\mbox{}\\
- Arbeitsspeicher fr \TeX, {\MF} und {\MP} in Worten: Fr jede Einstellung
- muss eine eigene Format-Datei erstellt werden. Allerdings knnen Sie
- mehrere Versionen von {\TeX} unter verschiedenen Namen erzeugen und
- in der Konfigurationsdatei jeweils eigene Eintrge vorsehen. Hier gibt
- es ein Monster-{\TeX} namens \samp{hugetex} mit der zugehrigen Format-Datei
- \file{hugetex.fmt}, wobei der spezielle Wert der
- Variablen \texttt{main\_memory} dann
- aus der Datei \file{texmf.cnf} gelesen wird.
-\item[\texttt{extra\_mem\_bot}]\mbox{}\\
- Extraspeicher fr ">groe"< \TeX-Datenstrukturen wie Boxen, Glue,
- Breakpoints, usw.: Besonders bei Anwendung von {\PiCTeX} sollte dieser
- Wert erhht werden.
-\item[\texttt{font\_mem\_size}]\mbox{}\\
- Anzahl der Worte fr Speicherung von Zeichensatzinformationen: Entspricht
- ungefhr dem Speicherbedarf der gelesenen \acro{TFM}-Dateien.
-\item[\texttt{hash\_extra}]\mbox{}\\
- Zustzlicher Platz fr Suchlisten: In der Hauptliste knnen
- ca. 10000~Eintrge verwaltet werden. Bei einem Buch mit vielen Querverweisen
- reicht dieser Platz unter Umstnden nicht aus.
- Die Voreinstellung fr \texttt{hash\_extra} ist \texttt{50000}.
-\end{description}
-
-Natrlich sind diese Parameter kein Ersatz fr eine wirklich dynamische
-Speicherverwaltung. Mit der gegenwrtigen Version von {\TeX} ist dieses
-Konzept aber nur extrem schwer zu implementieren; darum stellt dieses
-Verfahren eine praktikable Lsung dar.
-
-\begin{comment}
-%\clearpage
-% ==============================================================
-\section{Installation von {\TeX} auf einer neuen \acro{UNIX}-Plattform}
-
-Wenn Sie eine Rechnerplattform einsetzen, fr die wir keine Binrdateien
-zur Verfgung gestellt haben, mssen Sie {\TeX} und die zugehrigen
-Programme mit Hilfe der Quell-Codes selbst bersetzen. Das ist gar nicht so
-schwer, wie es klingt. Alles, was Sie brauchen, finden Sie auf der {\DVD}
-im Verzeichnis \texttt{source}.
-
-Zunchst sollten Sie jedoch die von {\TeX} bentigten Dateien durch
-eine Installation ohne Binrdateien auf die Festplatte kopieren bzw.
-durch ">Mounten"< der {\DVD} verfgbar machen.
-
-% -------------------------------------------------------------
-\subsection{Voraussetzungen}
-
-Zum bersetzen von {\TeX} und allen weiteren bentigten
-Programmen bentigen Sie ca. 100\,MB Festplattenkapazitt.
-Dazu kommen ein \acro{ANSI}-C-Compiler, \cmdname{make} sowie
-ein Scanner- und Parser-Generator. Die \acro{GNU}-Programme
-(\cmdname{gcc}, \acro{GNU}-\cmdname{make}, \cmdname{m4},
-\cmdname{flex} und \cmdname{bison}) sind praxiserprobt
-und auf den meisten Plattformen verfgbar. Eventuell knnen
-Sie auch andere C-Compiler oder \cmdname{make}-Programme einsetzen,
-doch dann sollten Sie sich wirklich gut mit Ihrem System auskennen,
-wenn es Schwierigkeiten whrend des bersetzungsprozesses gibt.
-Der Befehl \cmdname{uname} muss einen gltigen Namen liefern.
-
-% -------------------------------------------------------------
-\subsection{Konfiguration}
-
-\begin{itemize}
-\item Beginnen Sie mit einer ganz normalen \TL-Installation auf
-Festplatte (siehe Abschnitt~\ref{sec:install-disk} auf
-Seite~\pageref{sec:install-disk}). Das Installieren der
-fertigen Binaries knnen Sie getrost berspringen.
-
-\item Dann entpacken Sie das komprimierte Archiv (\cmdname{tar}) in
-\dirname{source} auf Ihre Festplatte und wechseln in dieses Verzeichnis.
-
-\item Legen Sie einen Pfad fest, unter dem das \TeX-System
-installiert werden soll. Natrlich sollte das derselbe Pfad sein,
-den Sie schon zum Kopieren der Daten verwendet haben
-(z.\,B. \dirname{/usr/local} oder \dirname{/usr/local/TeX}).
-\end{itemize}
-
-Die automatische Systemerkennung und -anpassung wird durch
-\textsf{configure} mit folgendem Aufruf gestartet:
-
-\begin{alltt}
-> \Ucom{./configure -prefix=/usr/local/TeX}
-\end{alltt}
-
-Bei der Option \optname{prefix} geben Sie das Verzeichnis an, in dem sich die
-bereits kopierten \TL-Dateien befinden;
-dieses Verzeichnis wird weiter strukturiert (\dirname{\$TEXDIR}
-ist dabei das Installationsverzeichnis):
-
-
-\begin{tabular}{>{\ttfamily}ll@{}}
- \dirname{\$TEXDIR/man} & Anleitungen im
- \acro{UNIX}-\cmdname{man}-Format\\
- \dirname{\$TEXDIR/share/texmf} & \TeX-Daten mit Zeichenstzen,
- Makros, usw.\\
- \dirname{\$TEXDIR/info} & Anleitungen im
- \acro{GNU}-\cmdname{info}-Format\\
- \dirname{\$TEXDIR/bin/\$PLATFORM} & ausfhrbare Programme\\
-\end{tabular}
-%$
-
-Wenn Sie wollen, knnen Sie ">\dirname{share/}"< als Namensbestandteil
-von \OnCD{texmf} weglassen, da sowohl
-\dirname{\$TEXDIR/share/texmf} als auch \dirname{\$TEXDIR/texmf}
-automatisch von \cmdname{configure} erkannt werden. Sollten Sie ein anderes
-Verzeichnis vorziehen, mssen Sie dieses \cmdname{configure} mit dem
-Kommandozeilenparameter \optname{-{}-datadir} mitteilen.
-
-Wenn Sie die erkannte Plattform nicht als \dirname{\$PLATFORM} im
-Pfad der ausfhrbaren Programme haben wollen, sondern z.\,B.
-direkt in \dirname{\$TEXDIR/bin} installieren wollen, verwenden Sie
-die Option \optname{-{}-disable-multiplatform}.
-
-Zum Weglassen spezieller \TeX-Systeme wie {\OMEGA} oder {\eTeX} gibt
-es eine Reihe von Optionen, die Sie durch die Eingabe von
-\samp{./configure --help} angezeigt bekommen.
-
-% -------------------------------------------------------------
-\subsection{Aufruf von \cmdname{make}}
-
-Vergewissern Sie sich, dass die Shell-Variable \envname{noclobber} nicht
-gesetzt ist und geben
-
-\begin{alltt}
-> \Ucom{make world}
-\end{alltt}
-
-ein. Jetzt knnen Sie sich entspannt zurcklehnen oder wie ein
-{\TeX}ie sagt: |\relax|.
-
-Eine gute Idee ist auch das Speichern der Meldungen beim
-bersetzen durch das Anlegen eines Protokolls:
-
-\begin{alltt}
-> \Ucom{sh -c "make world >world.log 2>\&1" \&}
-\end{alltt}
-
-Nehmen Sie nicht flschlicherweise nach dem Durchlauf von \cmdname{make}
-an, dass alles gut gegangen ist, sondern vergewissern sich durch eine
-Kontrolle des Protokolls. (\acro{GNU} \cmdname{make} zeigt Fehler
-z.\,B. immer mit der Zeichenkette ">\texttt{***}"< an.)
-Auerdem sollten Sie sich vergewissern, dass alle ausfhrbaren
-Programme auch erzeugt wurden:
-
-\begin{alltt}
-> \Ucom{cd \var{TEXDIR}/bin/\var{archname}}
-> \Ucom{ls | wc}
-\end{alltt}
-
-Das Ergebnis sollte ber 200 liegen (Sie knnen die exakte Zahl
-mit der Anzahl der lauf"|fhigen Programme [Binaries] im Verzeichnis \OnCD{bin} vergleichen).
-Der Aufruf \samp{make~world} ist brigens quivalent zu
-\samp{make~all~install~strip}.
-
-Wenn fr den Aufruf von \samp{make~install} besondere
-Systemverwalterrechte notwendig sein sollten, knnen Sie die
-Anweisung \samp{make~world} auch in zwei Durchgngen absetzen:
-
-\begin{alltt}
-> \Ucom{make all}
-> \Ucom{su}
-> \Ucom{make install strip}
-\end{alltt}
-
-Nachdem Sie Ihre Binaries installiert haben, sollten Sie die normalen
-Installationsnacharbeiten durchfhren, die im Abschnitt~\ref{sec:postinstall}
-auf Seite~\pageref{sec:postinstall} beschrieben sind.
-
-Wenn Sie lauf"|fhige Programme erstellt haben und diese Anderen zur Verfgung stellen wollen, sollten Sie uns kontaktieren. Wir wrden uns freuen, sie auf den \TL-\acro{WWW}-Seiten anzubieten.
-\end{comment}
-
-% ==============================================================
-\section{Danksagungen}
-
-Die {\TL} ist eine gemeinsame Arbeit faktisch aller {\TeX} Users
-Groups.
-
-Die Entwicklung des vorliegende \TL-Releases wurde Karl~Berry geleitet;
-die brigen Haupt-Mitarbeiter sind im Folgenden aufgelistet.
-
-\begin{itemize}
-\item Den englisch-, deutsch-, niederlndisch-, und polnisch-sprachigen
- \TeX-Anwendervereinigun\-gen (\acro{TUG}, \acro{DANTE} e.V.,
- \acro{NTG}, and \acro{GUST}),
- die zusammen die technische und administrative Infrastruktur
- zur Verfgung stellen. Wir wrden uns freuen wenn Sie bei einer der
- Anwendervereinigungen Mitglied werden.
-\item Dem \acro{CTAN} Team, insbesondere Robin Fairbairns, Jim Hef{}feron,
- und Rainer Schpf, das die \TL{}-CD-Images und die Infrastruktur
- fr Paketupdates zur Verfgung stellt, von denen \TL{} abhngt.
-\item Peter Breitenlohner (und das \eTeX\-Team) fr den stabilen Grundstock zu {\TeX}s Zukunft, und Peter speziell fr wertvolle Hilfe zum Verwenden
- von GNU autotools in \TL;
-\item Thomas~Esser, der mit dem exzellenten {\teTeX} die Basis
- fr dieses {\TL} schuf;
-\item Michel~Goossens, als Coautor der englischen Original-Dokumentation;
-\item Eitan~Gurari, mit dessen {\TeX4ht} die \HTML-Version dieser
- Anleitung erstellt wurde und der unermdlich daran gearbeitet
- hat, es auf Zuruf zu verbessern;
-\item \Thanh, Martin~Schrder und das pdf\TeX-Team (\url{http://pdftex.org}),
- die die Arbeiten zur Erweiterung der Mglichkeiten von
- {\TeX} fortgesetzt haben;
-\item Hans Hagen, fr zahlreiche Tests und Aktivitten, damit \ConTeXt{}
- (\url{http://pragma-ade.com}) ein Teil von \TL sein kann;
-\item Taco Hoekwater, fr neue Entwicklungen von MetaPost und (Lua)\TeX\
- (\url{http://luatex.org}), und ebenfalls fr die Untersttzung beim
- \ConTeXt-Teil von \TL;
-\item Pawe{\l} Jackowski fr das Installationsprogramm \cmdname{tlpm} fr
- Windows,
- Tomasz {\L}uczak fr \cmdname{tlpmgui} in frheren Versionen von \TL;
-\item Akira Kakuto, fr Windows-Programme im Rahmen seines
- \acro{W32TEX} Distribution
- (\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/});
-
-\item Jonathan Kew und \acro{SIL}, fr die
- Neuentwicklung von Xe\TeX{} und die Zeit und Mhe es in \TL{} zu
- integrieren, sowie fr die erste Version des Mac\TeX-Installers;
-
-\item Dick Koch fr die Betreuung von Mac\TeX\ (\url{http://tug.org/mactex});
-
-
-\item Reinhard Kotucha, fr die Untersttzung bei der Infrastruktur von
- \TL{} und das Installationsprogramm, fr seine Windows-Untersuchungen, fr das \texttt{getnonfreefonts}
- Script, und vieles mehr;
-
-\item Siep Kroonenberg, fr wertvolle Beitrge zur Infrastruktur von
- \TL\,2008 und den Installer, insbesondere unter Windows, und fr einen
- Groteil der Arbeit, die Dokumentation dafr zu schreiben;
-
-\item Petr~Olsak, der das tschechische und slowakische Material sehr sorgfltig er- und berarbeitet hat;
-
-\item Toshio Oshima, fr den \cmdname{dviout}-Previewer fr Windows;
-
-\item Manuel P\'egouri\'e-Gonnard, fr die Mithilfe beim Aktualisieren
- von Paketen, der Dokumentation und Arbeit an \cmdname{tldoc};
-
-\item Fabrice Popineau fr die erste Windows-Version von \TL und Mithilfe
- bei der franzsischen Dokumentation;
-
-\item Norbert Preining, Hauptkoordinator fr \TL{}-Infrastruktur und
- den Installer, fr die Koordination der Debian Version von \TL{}
- (zusammen mit Frank Kster), und die daraus resultierenden
- Verbesserungsvorschlge;
-
-\item Sebastian Rahtz fr die Erfindung von \TL und die langjhrige
- Leitung des Projekts;
-
-\item Vladimir Volovich fr viele substanzielle Mithilfe, und dafr, dass
- er es mglich gemacht hat, \cmdname{xindy} in \TL aufzunehmen;
-
-\item Staszek~Wawrykiewicz, der Haupttester fr alles, was mit {\TeX} zusammen hngt, Koordinator der polnischen
- Beitrge, Windows-Installation und mehr;
-
-\item Olaf~Weber fr die Geduld beim Pflegen von \Webc;
-\item Gerben~Wierda fr das Erstellen und Pflegen des \MacOSX-Teils und fr viele Integrations- und Testarbeiten;
-\item Graham~Williams, dessen Arbeit das Makro- und Paketverzeichnis mglich gemacht hat.
-\end{itemize}
-
-\textbf{Lauf"|fhige Programme:}
-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}),
-Akira Kakuto (\pkgname{win32}),
-Dick Koch (\pkgname{universal-darwin}),
-Manfred Lotz (\pkgname{i386-freebsd}),
-Norbert Preining (\pkgname{alpha-linux}),
-Arthur Reutenauer (\pkgname{sparc-linux}),
-Thomas Schmitz (\pkgname{powerpc-linux}),
-Apostolos Syropoulos (\pkgname{i386-solaris}),
-Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-solaris}),
-Olaf Weber (\pkgname{mips-irix}).
-
-Informationen dazu, wie Binaries fr \TL{} erzeugt werden,
-finden sich unter \url{http://tug.org/texlive/build.html}.
-
-\textbf{Dokumentation und Anpassung der bersetzungen:}
-
-\begin{itemize*}
-\item Karl~Berry (Englisch),
-\item Daniel~Flipo (Franzsisch),
-\item Klaus Hppner \& Hartmut~Henkel (Deutsch)
-\item Petr~Sojka \& Jan~Busa (Tschechisch/""Slowakisch),
-\item Boris~Veytsman (Russisch),
-\item Staszek~Wawrykiewicz (Polnisch).
-\end{itemize*}
-
-Natrlich haben wir am meisten Donald~Knuth zu danken, einmal dafr, dass er {\TeX} erfand und dann dafr, dass er es
-der Welt schenkte.
-
-% -------------------------------------------------------------
-\section{Geschichtliches}\label{sec:history}
-
-Diese Ausgabe der {\TL} ist in Zusammenarbeit der \TeX{} Users Group (\acro{TUG}), der
-\acro{UKTUG}, der franzsischen \TeX-Vereinigung GUTenberg
-und der deutschsprachigen \TeX-Anwendervereinigung (DANTE e.\,V.)
-unter Mithilfe der niederlndischen, tschechischen/""slowakischen,
-indischen, polnischen und russischen \TeX-Benutzergruppen
-entstanden.
-
-\subsection{Vergangenheit}
-
-Die niederlndische \TeX-Benutzergruppe hatte Ende 1993 mit der
-Produktion der 4All\TeX-{\acro{CDROM}} fr \acro{MS-DOS} die Diskussion angeregt,
-eine einzige {\acro{CDROM}} fr alle Rechnersysteme zu entwickeln. Zum
-damaligen Zeitpunkt war dieses Ziel zu hoch gesteckt, doch immerhin
-entstand aus dieser Diskussion nicht nur die sehr erfolgreiche
-4All\TeX-{\acro{CDROM}}, sondern auch die \acro{TUG}-Arbeitsgruppe zur Definition
-der {\TeX} Directory Structure \TDS, die die zur Arbeit mit {\TeX}
-notwendigen und hilfreichen Dateien in eine konsistente und
-handhabbare Verzeichnisstruktur einbettet. Das ">Final~Draft"<-Dokument,
-das diese Verzeichnisstruktur festlegt, wurde in der Dezember-Ausgabe
-1995 der TUGBoat verffentlicht. Schon frhzeitig war den Beteiligten
-klar, dass eine {\acro{CDROM}} auf der Basis der {\TDS} sehr zu begren wre.
-Die \TL-{\acro{CDROM}} war das direkte Resultat der Beratungen der
-\TDS-Arbeitsgruppe. Auerdem hat der Erfolg der 4All\TeX-{\acro{CDROM}}
-klargemacht, dass ein hnliches System auch fr \acro{UNIX}-Benutzer eine
-Erleichterung darstellen wrde. Dies war der zweite Beweggrund fr
-die \TL-\acro{CDROM}.
-
-Im Herbst 1995 wurde das Projekt, eine \TDS-basierte \acro{UNIX}-{\acro{CDROM}}
-zu entwickeln, in Angriff genommen. Sehr schnell stieen die
-Verantwortlichen auf das \teTeX-System von Thomas~Esser als
-idealen Ausgangspunkt fr diese Arbeit, weil es verschiedene
-Rechnerplattformen untersttzte und fr die Arbeit mit verschiedenen
-Dateisystemen vorgesehen war. Anfang 1996 wurde in Zusammenarbeit
-mit Thomas~Esser ernsthaft mit der Arbeit begonnen und im Mai~1996
-die erste Ausgabe der {\acro{CDROM}} verffentlicht.
-
-Anfang 1997 stellte
-Karl~Berry eine neue Version seines \Webc-\TeX-Systems vor, das
-schon nahezu alle Ausstattungsmerkmale aufwies, die Thomas~Esser
-mit {\teTeX} verwirklicht hatte. Die \acro{TUG} entschied sich daraufhin,
-die zweite Version der {\acro{CDROM}} auf der Basis von {\Webc} unter
-Verwendung des Installations-Skripts \cmdname{texconfig} aus dem
-\teTeX-Paket zu entwickeln.
-
-Die dritte Ausgabe basierte auf der
-inzwischen von Olaf~Weber gepflegten und weiter entwickelten
-{\Webc}~Version~7.2; {\TL} untersttzte fast alle Eigenschaften
-der zur selben Zeit entstandenen neuen Version von \teTeX.
-
-Die vierte Ausgabe folgte demselben Schema, indem ihr neue
-Versionen von {\teTeX} und {\Webc}~(7.5) zugrunde lagen.
-Fast die gesamte {\acro{CDROM}} wurde einer kritischen berprfung
-unterzogen, wobei besonders darauf geachtet wurde, dass doppelte
-Dateien entfernt wurden und die Einordnung der Pakete konsistent
-erfolgte. Zudem enthielt diese Ausgabe ein komplettes Windows-Setup.
-
-Fr die fnfte Ausgabe im Mrz~2000 wurden wiederum groe Teile der
-{\acro{CDROM}} ersetzt, wobei Hunderte von berarbeiteten Paketen aufgenommen
-wurden. {\OMEGA}, {pdf\TeX} und Teile der \TeX-Support-Programme (hier
-insbesondere \cmdname{xdvi}, \cmdname{dvips} und \cmdname{tex4ht})
-lagen in neuer Version vor.
-Die Hauptnderung bei der \TL\,5 betraf die \samp{non-free}-Software.
-Alles auf dieser {\acro{CDROM}} war nun in bereinstimmung mit den \emph{Debian
-Free Software Guidelines} (\url{http://www.debian.org/intro/free}).
-Wir haben unser Bestes versucht, die Lizenzbedingungen aller Pakete
-zu berprfen, sind aber dankbar, wenn wir auf Fehler hingewiesen werden.
-
-Die sechste Ausgabe der {\TL} vom Juli/August~2001
-enthielt die neuesten Versionen aller Pakete und Programme.
-Das neue Installationskonzept stellte die grte nderung dar:
-Der Benutzer konnte nun viel genauer
-gewnschte bzw.\ nicht erwnschte Sammlungen
-und Pakete auswhlen. Dabei wurden die sprachspezifischen Sammlungen
-komplett berarbeitet, so dass sie jetzt automatisch nicht nur
-Makros, Fonts usw. installierten, sondern zustzlich die notwendigen
-Eintrge in \file{language.dat} vornahmen.
-
-Die siebte Ausgabe vom Mai~2002 enthlt als grte
-nderungen {\MacOSX} und wieder unzhlige Updates aller Pakete und Programme.
-Ein wesentliches Ziel war zudem die Wiedererstellung einer gemeinsamen
-Quelle mit {\teTeX}, um das Auseinanderlaufen seit \TL\,5 und \TL\,6
-zu korrigieren.
-
-\subsection{2003}
-
-Im Jahr 2003 war die Flut von Updates und neuen Paketen so gro geworden,
-dass wir feststellen mussten: ">{\TL} passt nicht mehr auf eine einzelne
-\acro{CDROM}"<. Und so wurde sie in drei verschiedene Distributionen aufgeteilt
-(siehe Abschnitt~\ref{sec:tl-coll-dists} auf Seite~\pageref{sec:tl-coll-dists}).
-Des Weiteren:
-
-\begin{itemize}
-\item Auf Wunsch des \LaTeX-Teams wurde der Standard fr \cmdname{latex}
- und \cmdname{pdflatex} verndert; beide benutzen nun {\eTeX} als Basis
- (siehe Seite~\pageref{text:etex}).
-\item Die neuen ">Latin Modern Fonts"< wurden aufgenommen (und werden
- zur Benutzung empfohlen).
-\item Der Support fr Alpha-\acro{OSF} wurde aufgegeben (den
- \acro{HPUX}-Support hatte es schon zuvor ereilt), da
- niemand mehr in der Lage war, neue Binaries zu kompilieren.
-\item Das Setup fr Windows wurde grundlegend berarbeitet.
- Zum ersten Mal wurde eine integrierte Umgebung eingefhrt,
- die auf \cmdname{XEmacs} basiert.
-\item Wichtige Hilfsprogramme fr Windows (Perl, Ghost\-script,
- Image\-Magick, Ispell) werden nun im \TL-Verzeichnis
- installiert.
-\item Die von \cmdname{dvips}, \cmdname{dvipdfm} und \cmdname{pdftex}
- benutzten Font-Mapfiles werden vom neuen Programm
- \cmdname{updmap} generiert und in \dirname{texmf/fonts/map}
- installiert.
-\item \TeX, {\MF} und {\MP} geben nun die meisten 8"~Bit-Input"~Zeichen (Position 32 und oberhalb) unverndert
- aus in (\verb|\write|)-Files, Logfiles und auf dem Terminal.
- Das bedeutet, dass sie \emph{nicht} mit der \verb|^^|-Notierung
- bersetzt ausgegeben werden. Auf der \TL\,7 war diese
- bersetzung abhngig von der \cmdname{locale}-Einstellung des
- Systems; nun beeinflussen \cmdname{locale}-Einstellung nicht
- {\TeX}s Programmverhalten. Falls Sie aus irgendwelchen
- Grnden die \verb|^^|-Ausgabe bentigen, mssen Sie in Ihrem System
- die Datei \file{texmf/web2c/cp8bit.tcx} umbenennen
- (zuknftige Versionen werden eine sauberere Schnittstelle zur
- Kontrolle dieses Verhaltens anbieten).
-\item Die Dokumentation wurde grundlegend berarbeitet.
-\item Zum Abschluss einigten wir uns auf eine neue Edition-Nummerierung.
- Ab diesem Jahr trgt die {\TL} statt einer fortlaufenden Nummer
- die Jahreszahl: \TL~2003.
-\end{itemize}
-
-\subsection{2004}
-
-\begin{itemize}
-\item Wenn Sie lokal installierte Zeichenstze mit ihren eigenen \filename{.map}- oder (weniger wahrscheinlich)
- \filename{.enc}-Dateien benutzen, mssen Sie mglicherweise diese Dateien verschieben.
-
- Nach den \filename{.map}-Dateien wird jetzt in den \dirname{fonts/map}-Unterverzeichnissen im
- \envname{TEXFONTMAPS}-Pfad gesucht (in jedem \filename{texmf}-Baum).
- Gleichzeitig werden \filename{.enc}-Dateien jetzt in den \dirname{fonts/enc}-Unterverzeichnissen entlang des
- \envname{ENCFONTS}-Pfads gesucht. Das Programm \cmdname{updmap} versucht, bei problematischen Dateien zu warnen.
-
- Informationen darber, wie das gehandhabt wird, und zustzliche Informationen finden Sie unter
- \url{http://tug.org/texlive/mapenc.html}.
-
-\item Die \TK\ wurde fr all diejenigen, die diese Implementierung {\Webc} vorziehen, um eine \MIKTEX-basierte und
- installierbare {\acro{CDROM}} erweitert. Siehe dazu auch Abschnitt~\ref{sec:overview-tl} auf
- Seite~\pageref{sec:overview-tl}.
-
-\item In der {\TL} wurde der umfangreiche \dirname{texmf}-Baum frherer Versionen durch drei Teilbume ersetzt:
- \OnCD{texmf}, \OnCD{texmf-dist} und \OnCD{texmf-doc}. Siehe dazu Abschnitt~\ref{sec:tld} auf
- Seite~\pageref{sec:tld} und die \filename{README}-Dateien in den drei Zweigen.
-
-\item Alle \TeX-relevanten Eingabedateien sind jetzt in den \dirname{tex}-Unterverzeichnissen der
- \dirname{texmf*}-Bume zusammengefasst und nicht mehr in den parallelen Verzeichnissen \dirname{tex},
- \dirname{etex}, \dirname{pdftex}, \dirname{pdfetex}, usw. Siehe dazu
- \CDref{texmf-doc/doc/english/tds/tds.html\#Extensions}{\texttt{texmf-doc/doc/english/tds/tds.html\#Extensions}}.
-
-\item Hilfs-Skripte, die der Anwender nicht selbst aufruft, werden jetzt in den \mbox{neuen}
- \dirname{scripts}-Unterverzeichnissen der \dirname{texmf*}-Bume aufbewahrt. Nach ihnen wird per
- \samp{kpsewhich -format=texmfscripts} gesucht. Wenn Sie Programme einsetzen, die solche Skripte aufrufen, mssen
- sie angepasst werden. Siehe dazu \CDref{texmf-doc/doc/english/tds/tds.html\#Scripts}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Scripts}}.
-
-\item (Fast) alle Formate interpretieren -- an Stelle einer bersetzung durch die \verb|^^|-Notation -- mittels
- des ">translation files"< \filename{cp227.tcx} die meisten Zeichen als direkt ausgebbar. Insbesondere werden
- die Zeichen an den Positionen 32--256, zustzlich \acro{TAB}, \acro{VT} (vertical tab; vertikaler Tab) und
- \acro{FF} (form feed; Seitenvorschub), als druckbar angesehen und daher nicht bersetzt. Ausnahmen sind
- plain \TeX, bei dem nur die Zeichen an den Positionen 32--127 druckbar sind, {\ConTeXt} (mit druckbaren Zeichen an
- den Positionen 0--255) und die \OMEGA-verwandten Formate. Dieses voreingestellte Verhalten ist (fast) identisch
- mit dem in \TL\,2003; es ist aber jetzt klarer und mit umfangreicheren Anpassungsmglichkeiten implementiert.
- Siehe dazu \CDref{texmf/doc/web2c/web2c.html\#TCX-files}
-{\texttt{texmf/doc/web2c/web2c.html\#TCX-files}}.
-
- \textbf{Anmerkung:} Da {\TeX} byte-orientiert ist, knnen bei einer Unicode-Eingabe (2-Byte-Zeichen) im Kontext
- von Fehlermeldungen Folgen von 1-Byte-Zeichen ausgegeben werden.
-
-\item \cmdname{pdfetex} ist jetzt die voreingestellte ">Engine"< fr alle Formate mit Ausnahme von
- \mbox{(plain-)\cmdname{tex}} selbst (natrlich generiert es \dvi-Code, wenn es als \cmdname{latex}, usw.
- aufgerufen wird.). Das bedeutet unter vielen anderen Dingen, dass die mikrotypographischen Fhigkeiten von
- \cmdname{pdftex}
- wie auch die Erweiterungen von {\eTeX} in \LaTeX, \ConTeXt usw. zur Verfgung stehen
- (\OnCD{texmf-dist/doc/etex/base/}).
-
- Das bedeutet, dass es \emph{wichtiger denn je} ist, das Paket \pkgname{ifpdf} zu benutzen (es arbeitet sowohl mit
- {plain \TeX} als auch mit \LaTeX), da der einfache Test, ob \cs{pdfoutput} oder ein anderer \TeX-Grundbefehl
- (primitive) definiert ist, nicht verlsslich genug ist fr die Entscheidung, ob eine PDF-Ausgabe erzeugt wird.
- Wir haben das rckwrts-kompatibel gemacht, so gut wir das dieses Jahr konnten; nchstes Jahr aber soll
- \cs{pdfoutput} so beschaffen sein, dass dieser Befehl auch dann definiert ist, wenn {\dvi}-Code erzeugt wird.
-
-\item pdf\TeX\ (\url{http://pdftex.org/}) hat viele neue Besonderheiten:
- \begin{itemize}
- \item Die Befehle \cs{pdfmapfile} und \cs{pdfmapline} ermglichen einen Font"~Map-Support innerhalb eines
- Dokuments.
- \item Mikrotypografische Zeichensatz-Expansion (font expansion) kann jetzt viel leichter benutzt werden
- \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}.
- \item Alle Parameter, die frher in der speziellen Konfigurationsdatei \filename{pdftex.cfg} definiert wurden,
- mssen jetzt mit Hilfe von pdf\TeX-Grundbefehlen gesetzt werden, typischerweise in
- \filename{pdftexconfig.tex}; die Konfigurationsdatei \filename{pdftex.cfg} wird nicht lnger untersttzt.
- Jede schon bestehende Format-Datei (\filename{.fmt}) muss neu erstellt werden, wenn
- \filename{pdftexconfig.tex} gendert wird.
- \item Fr zustzliche Informationen siehe das pdf\TeX-Handbuch: \OnCD{texmf-dist/doc/pdftex/manual}.
- \end{itemize}
-
-\item Der Grundbefehl \cs{input} in \cmdname{tex} (\cmdname{mf} und \cmdname{mpost}) akzeptiert jetzt doppelte
- Anfhrungszeichen und andere Spezialzeichen. Typische Beispiele:
-
-\begin{verbatim}
-\input "filename with spaces" % plain
-\input{"filename with spaces"} % latex
-\end{verbatim}
-
- Fr zustzliche Informationen siehe das \Webc-Handbuch: \OnCD{texmf/doc/web2c}.
-
-\item enc\TeX\ wird jetzt in {\Webc} und damit auch in allen \TeX-Programmen untersttzt. Dazu wird \emph{beim
- Generieren neuer Formate} die Option \optname{-enc} benutzt. enc\TeX\ untersttzt allgemein die Umkodierung der
- Ein- und Ausgabe und ermglicht eine volle Unicode-Untersttzung (in \acro{UTF}-8).
- Siehe \OnCD{texmf-dist/doc/generic/enctex/} und \url{http://www.olsak.net/enctex.html}.
-
-\item Aleph (\ensuremath{\aleph}), eine neue ">Engine"<, die {\eTeX} und {\OMEGA} vereinigt, ist verfgbar. Ein bisschen
- Information darber finden Sie in \OnCD{texmf-dist/doc/aleph/base} und
- \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}. Das \LaTeX-basierte Aleph-Format heit
- \cmdname{lamed}.
-
-\item Das neueste \LaTeX-Release enthlt eine neue Version der \acro{LPPL}%
- \footnote{LPPL: LaTeX Project Public License},
- die jetzt eine offiziell von Debian anerkannte Lizenz ist. Zusammen mit anderen Updates finden Sie Informationen
- dazu in den \filename{ltnews}-Dateien in \OnCD{texmf-dist/doc/latex/base}.
-
-\item \cmdname{dvipng} -- ein neues Programm zum Konvertieren von \dvi-Dateien in \acro{PNG}-Bilddateien, ist
- Bestandteil von \TL. Siehe \OnCD{texmf/doc/man/man1/dvipng.1}.
-
-\item Auf Vorschlag des Autors (Claudio~Beccari) haben wir das Paket \pkgname{cbgreek} auf einen ">mittelgroen"< Satz
- von Fonts reduziert. Herausgenommen wurden die ">invisible"<, Outline- und ">Transparency"<-Fonts,
- die relativ selten benutzt werden -- denn wir bentigen den Platz. In seinem vollen Umfang ist das Paket natrlich
- weiterhin auf \acro{CTAN} verfgbar (\url{http://www.ctan.org/tex-archive/fonts/greek/cb/}).
-
-\item \cmdname{oxdvi} wurde entfernt; benutzen Sie jetzt \cmdname{xdvi}.
-
-\item Die \cmdname{ini}- und \cmdname{vir}-Befehle (Links) fr \cmdname{tex}, \cmdname{mf} and \cmdname{mpost} sind
- nicht mehr lnger verfgbar, so auch \cmdname{initex}. Das ist kein richtiger Verlust, da die
- \cmdname{ini}-Funktionalitt schon seit mehreren Jahren ber den Aufrufparameter \optname{-ini} zur Verfgung
- steht.
-
-\item Die Untersttzung der Plattform \cmdname{i386-openbsd} wurde entfernt. Da das Paket \pkgname{tetex} im
- \acro{BSD}-Ports-System zur Verfgung steht und Binaries fr \acro{GNU}/""Linux and Free\acro{BSD} erhltlich sind,
- erschien es sinnvoll, die Zeit der Freiwilligen besser zu nutzen.
-
-\item Zumindest auf \cmdname{sparc-solaris} mssen Sie ggf. die En"-viron"-ment-Variable \envname{LD\_LIBRARY\_PATH}
- setzen, um die \pkgname{t1utils}-Programme laufen lassen zu knnen. Ursache dafr ist, dass die Programme mit C++
- kompiliert wurden und dass es keinen Standard-Platz fr Laufzeit-Bibliotheken gibt (das ist zwar auch im Jahre
- 2004 nicht neu, wurde aber bisher nicht dokumentiert.) Unter \cmdname{mips-irix} werden die
- \acro{MIPS}pro-7.4-Laufzeit-Bibliotheken bentigt.
-\end{itemize}
-
-\subsection{2005}
-
-Im Jahr 2005 gab es -- wie blich -- viele aktualisierte Pakete und
-Programme. Die Struktur des Systems blieb weitgehend gleich, mit folgenden
-Ausnahmen:
-
-\begin{itemize}
-\item Die neuen Skripte \cmdname{texconfig-sys}, \cmdname{updmap-sys} und
- \cmdname{fmtutil-sys} fr die systemweite Konfiguration des Systems wurden
- hinzugefgt. Die Skripte \cmdname{texconfig}, \cmdname{updmap} und
- \cmdname{fmtutil} modifizieren nun die Konfiguration fr einen einzelnen
- Nutzer unter \dirname{\$HOME/.texlive2005}.
-\item Analog spezifizieren die Pfade \envname{TEXMFCONFIG} und
- \envname{TEXMFSYSCONFIG} nun, wo die Konfigurationsdateien gefunden
- werden (fr einen einzelnen Nutzer bzw.\ systemweit). Mglicherweise
- mssen Sie daher vorhandene eigene Versionen von
- \filename{fmtutil.cnf} oder \filename{updmap.cfg} in die entsprechenden
- Pfade verschieben. Alternativ knnen Sie \envname{TEXMFCONFIG} und
- \envname{TEXMFSYSCONFIG} in der Datei \filename{texmf.cnf} umdefinieren,
- dass diese auf die Speicherorte Ihrer eigenen Konfigurationsdateien
- verweisen. Siehe Abschnitt~\ref{sec:texmftrees} auf Seite~\pageref{sec:texmftrees}.
-\item Im letzten Jahr wurden fr die Programme, die DVI als Ausgabeformat
- erzeugen, die Primitive wie \verb|PDFoutput| auf undefiniert gesetzt,
- obwohl immer \cmdname{pdfetex} verwendet wurde. In diesem Jahr wurde dies
- wie angekndigt nicht mehr getan. Falls in Dokumenten nun die Abfrage
- \verb|\ifxPDFoutput\undefined| zum Test benutzt wird, ob PDF oder DVI
- erzeugt wird, mssen diese gendert werden! Benutzen Sie das Paket
- \pkgname{ifpdf.sty}, das auch mit dem genderten Verhalten funktioniert,
- oder orientieren Sie sich an dessen Code.
-\item Im letzten Jahr wurden die Formate so gendert, dass sie Zeichen
- als 8-bit ausgeben. Die neue TCX-Datei \filename{empty.tcx} erffnet nun
- einen einfachen Weg, die originale Ausgabe mit \verb|^^|-Notation zu
- erhalten, wenn Sie es wnschen:
-\begin{verbatim}
-latex --translate-file=empty.tcx yourfile.tex
-\end{verbatim}
-\item Das Programm \cmdname{dvipdfmx} fr die Konvertierung von DVI nach
- PDF ist neu hinzugekommen. Dies ist eine aktiv gepflegte Erweiterung von
- \cmdname{dvipdfm}, das zwar noch verfgbar ist, aber als obsolet angesehen
- werden kann.
-\item Ebenso sind die Programme \cmdname{pdfopen} und \cmdname{pdfclose} neu
- hinzugekommen. Diese erlauben ein Reload von PDF-Dateien im Acrobat Reader,
- ohne diesen neu starten zu mssen (andere PDF-Viewer wie \cmdname{xpdf},
- \cmdname{gv} oder \cmdname{gsview} hatten damit nie Probleme).
-\item Aus Konsistenzgrnden wurden die Variablen \envname{HOMETEXMF} und
- \envname{VARTEXMF} in \envname{TEXMFHOME} bzw.\ \envname{TEXMFSYSVAR}
- umbenannt. Weiterhin existiert \envname{TEXMFVAR} fr einen Baum, der
- spezifisch fr einen einzelnen Nutzer ist.
-\end{itemize}
-
-\subsection{2006--2007}
-\label{tlcurrent}
-
-Der wichtigeste Neuzuwachs in der Ausgabe 2006--2007 von \TL{} war das Xe\TeX{}
-Programm, verfgbar durch die \texttt{xetex} und \texttt{xelatex}
-Programme; siehe \url{http://scripts.sil.org/xetex}.
-
-Auch MetaPost erhielt ein bemerkenswertes Update, mit weiteren geplannten
-nderungen (\url{http://tug.org/metapost/articles}), ebenso pdf\TeX{}
-(\url{http://tug.org/applications/pdftex}).
-
-Das (plain) \texttt{tex}-Programm liest nicht mehr erste Zeilen mit
-\texttt{\%\&} um das Format zu bestimmen. Es ist ein reines Knuth-\TeX.
-(\LaTeX\ und alle anderen Formate lesen weiterhin \texttt{\%\&}-Zeilen).
-
-Weiters wurden wie blich hunderte von Paketen und Programmen auf einen
-neueren Stand gebracht. Fr weiter Updates wenden Sie sich bitte an
-\acro{CTAN} (\url{http://www.ctan.org}).
-
-Die Entwicklungsumgebung wurde auf Subversion umgestellt, was ein Webinterface
-fr den Entwicklungsbaum beisteuerte. Dieses Webinterface ist von der
-Homepage verlinkt. Obwohl dieser Umstieg in der Distribution nicht zu
-erkennen ist, erwarten wir uns ein stabiles Fundament fr die Entwicklung
-in den nchsten Jahren.
-
-Schlielich hat im Mai~2006 Thomas Esser das Ende seiner Entwicklung von
-te\TeX{} (\url{http://tug.org/tetex}) angekndigt. Als Konsequenz ist das
-Interesse an \TL{}, besonders unter den \acro{GNU}/Linux-Distributoren
-angestiegen. (\TL{} bietet nun ein \texttt{tetex}-Installationsschema, dass
-annhernd den Umfang von te\TeX{} umfasst.) Wir hoffen dass dies
-schlussendlich zu einer Verbesserung der \TeX-Umgebung fr jederman fhrt.
-
-\medskip\noindent
-Abschlieende Bemerkung zur Vergangenheit: Alle Versionen von \TL,
-inklusive Beimaterial wie CD-Labels, finden sich unter
-\url{ftp://tug.org/historic/systems/texlive}.
-
-\subsection{Gegenwart}
-\label{sec:tlcurrent}
-
-Die komplette Infrastruktur von \TL wurde 2008 neu entwickelt. Die
-gesamten Daten, die fr die Installation bentigt werden, finden sich
-nun in einer einzigen Textdatei mit dem Namen \filename{tlpkg/texlive.tlpdb}.
-
-Dies ermglicht es unter anderem, ein Update einer installierten Version
-von \TL ber das Internet durchzufhren, was fr MiK\TeX{} schon seit
-Jahren mglich ist. Wir planen regelmige Updates bereitzustellen,
-wenn Pakete auf \CTAN{} aktualisiert werden oder neu erscheinen.
-
-Als neues Programm ist Lua\TeX\ (\url{http://luatex.org}) enthalten,
-das neben neuen Mglichkeiten innerhalb des Satzsystems eine
-hervorragende Skriptsprache zur Verfgung stellt, die inner- und
-auerhalb von \TeX{} benutzt werden kann.
-
-Die Untersttzung von \TL fr Windows und Unix ist mittlerweile praktisch
-quivalent. Die meisten Perl- und Lua-Skripte knnen nun auch unter
-Windows verwendet werden, da innerhalb von \TL Perl integriert ist.
-
-Das neue \cmdname{tlmgr}-Programm (Abschnitt~\ref{sec:tlmgr}) ist
-eine komplette Oberflche zum Verwalten von \TL nach der Installation.
-Es ermglicht das Aktualisieren von Paketen, die Neugenerierung von
-Formatdateien, Fontmaps und die Konfiguration der \TeX-Untersttzung
-fr verschiedene Sprachen.
-
-Nach der Einfhrung von \cmdname{tlmgr} sind die Funktionen von
-\cmdname{texconfig} zur Konfiguration von Formatdateien und
-Trennmustern deaktiviert worden.
-
-Der Index-Prozessor \cmdname{xindy} (\url{http://xindy.sourceforge.net/})
-ist nun fr die meisten Betriebssysteme integriert.
-
-Das Programm \cmdname{kpsewhich} kann nun alle Fundstellen fr eine
-gesuchte Datei anzeigen (Option \optname{--all}) oder die Suche
-auf ein bestimmtes Verzeichnis einschrnken (Option \optname{--subdir}).
-
-Das Programm \cmdname{dvipdfmx} kann nun Informationen ber die
-Bounding Box liefern, was ber die Kommandozeile mit dem Befehl
-\cmdname{extractbb} aufgerufen werden kann; dies war die letzte
-Funktion von \cmdname{dvipdfm}, die noch nicht in \cmdname{dvipdfmx}
-vorhanden war.
-
-Die Font-Aliasnamen \filename{Times-Roman}, \filename{Helvetica} usw.
-wurden abgeschafft.
-
-Das Makro-Format \pkgname{platex} wurde entfernt, um den Namenskonflikt
-mit dem japanischen \pkgname{platex} auf zu lsen; Untersttzung
-fr polnisch wird nun vom Paket \pkgname{polski} zur Verfgung gestellt.
-
-Die \web{} string pool files wurden in die Programme einkompiliert,
-um Updates zu vereinfachen.
-
-Und abschlieend sind die nderungen von Donald Knuth in seinem
-\emph{\TeX\ tuneup of 2008} in \TL eingearbeitet,
-\url{http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf}.
-% -------------------------------------------------------------
-\subsection{Zukunft}
-
-\emph{{\TL} ist nicht perfekt! -- und wird es auch nie sein.} Wir planen
-Neuauf"|lagen zu produzieren, die umfangreichere
-Hilfstexte, mehr Hilfsprogramme, mehr Installationshilfen und (natrlich)
-den stndig verbesserten und berprften Satz der Makros und Zeichenstze
-enthalten. Diese Arbeit wird von Freiwilligen in ihrer knappen Freizeit
-geleistet. Viel Arbeit steht noch an. Wenn Sie uns helfen knnen,
-zgern Sie keine Sekunde, sich bei uns zu melden.
-
-Verbesserungen, Anregungen und Erweiterungen fr knftige Ausgaben
-der {\TK} senden Sie bitte an:\hfill\null
-
-\begin{quote}
-\email{tex-live@tug.org}\\
-\url{http://tug.org/texlive/}
-\end{quote}
-
-Neue Versionen, Anmerkungen und zustzliches Material werden ber
-die \CTAN-Server im Verzeichnis \dirname{info/texlive} zur Verfgung gestellt.
-Im \acro{WWW} knnen Sie sich ber die Adresse
-\url{http://www.tug.org/tex-live/} informieren und die Bestellformalitten
-einsehen.
-
-\end{document}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/Makefile b/Master/texmf-doc/source/texlive/texlive-en/Makefile
deleted file mode 100644
index 170161df9c3..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/Makefile
+++ /dev/null
@@ -1,69 +0,0 @@
-# $Id$
-# Makefile for TeX Live documentation. Public domain.
-doc = texlive-en
-lang = english
-
-all: pdf html
-
-env = TEXINPUTS=../texlive-common:../texlive-en:; export TEXINPUTS;
-
-pdf:
- rm -f *.aux *.toc *.lof *.lot *.xref* *.tmp *.out
- $(env) pdflatex '\nonstopmode\def\Status{1}\input $(doc)'
- $(env) pdflatex '\nonstopmode\def\Status{1}\input $(doc)'
- $(env) pdflatex '\nonstopmode\def\Status{1}\input $(doc)'
- $(env) pdflatex '\nonstopmode\def\Status{1}\input $(doc)'
-
-html:
- rm -f *.aux *.toc *.lof *.lot *.xref* *.tmp *.out *.4tc
-# this sequence is equivalent to running "ht latex $(doc)". We do it
-# this way so we can \def\Status for the \ifcase in tex-live.sty.
- $(env) latex '\nonstopmode\def\Status{2}\input $(doc)'
- $(env) latex '\nonstopmode\def\Status{2}\input $(doc)'
- $(env) latex '\nonstopmode\def\Status{2}\input $(doc)'
- $(env) latex '\nonstopmode\def\Status{2}\input $(doc)'
- $(env) tex4ht $(doc)
- $(env) t4ht $(doc)
-
-clean:
- rm -f *.aux *.log *.blg *.toc *.out *.lot tex4ht.ps *.4*
- rm -f *.xref* *.lg *.idv *.out *.otc *.tmp tmp.*
- rm -f $(doc).dvi $(doc).ps
-
-realclean: clean
- rm -f $(doc).pdf
- rm -f *.html *.htm $(doc).css *.gif *.jpg
-
-
-insttop = ../../../doc
-instfiles = $(doc)*html $(doc).css $(doc).pdf
-install:
-# lang=`dirname \`pwd\` | sed 's,.*/,,'`;
- lang=$(lang); \
- tldir=`pwd | sed 's,.*/,,'`; \
- instdir=$(insttop)/$$lang/$$tldir; \
- echo tldoc install to $$instdir; \
- for f in $(instfiles); do \
- cmp -s $$f $$instdir/$$f && rm -v $$f && continue; \
- mv -v $$f $$instdir/$$f; \
- done
-
-
-# don't use these, they don't work.
-dvi:
- rm -f *.aux *.toc
- latex '\nonstopmode\def\Status{0}\input $(doc)'
- latex '\nonstopmode\def\Status{0}\input $(doc)'
- latex '\nonstopmode\def\Status{0}\input $(doc)'
-
-baskerville:
- rm -f *.aux *.toc
- latex '\def\Status{3}\input $(doc)'
- latex '\def\Status{3}\input $(doc)'
- latex '\def\Status{3}\input $(doc)'
-
-tugboat:
- rm -f *.aux *.toc
- latex '\def\Status{4}\input $(doc)'
- latex '\def\Status{4}\input $(doc)'
- latex '\def\Status{4}\input $(doc)'
diff --git a/Master/texmf-doc/source/texlive/texlive-en/README b/Master/texmf-doc/source/texlive/texlive-en/README
deleted file mode 100644
index dc5fb6b124d..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/README
+++ /dev/null
@@ -1,5 +0,0 @@
-$Id$
-TeX Live documentation. This file is public domain.
-
-We only generate the documentation in PDF and HTML formats -- see the
-Makefile. This saves us having to have the images in EPS format too.
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/bv-live.tex b/Master/texmf-doc/source/texlive/texlive-en/archive/bv-live.tex
deleted file mode 100644
index ad044e568cb..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/bv-live.tex
+++ /dev/null
@@ -1,84 +0,0 @@
-% this is the baskerville version of the live documentation
-\providecommand{\Status}{3}
-
-\setcounter{errorcontextlines}{999}
-\documentclass{article}
-\advance\textwidth by 1in
-\advance\oddsidemargin by -1in
-\advance\evensidemargin by -1in
-\newsavebox{\warnbox}
-\def\Q#1{\par\vskip6pt\leftline{#1}\par}
-\setcounter{tocdepth}{2}
-\pretolerance=1000
-\tolerance=1500
-\hbadness=3000
-\vbadness=3000
-\hyphenpenalty=400
-\renewcommand{\topfraction}{0.85}
-\renewcommand{\floatpagefraction}{0.86}
-\renewcommand{\textfraction}{0.1}
-\setcounter{topnumber}{5}
-\setcounter{totalnumber}{5}
-\def\eTeX{$\varepsilon$-\TeX}
-%\def\CTAN{\textsc{ctan}}
-%\def\TUB{\textsc{tub}}
-\def\Dash{---}
-\def\hyph{-}
-%\def\TeXXeT{\TeX-XeT}
-\def\OMEGA{$\Omega$}
-\def\bs{{\protect\normalfont\ttfamily\char'134}}
-\DeclareRobustCommand{\cs}[1]{{\normalfont\ttfamily\char`\\#1}}
-%\def\cs#1{\mbox{\normalfont\ttfamily\bs#1}}
-\def\La{La}
-\let\textsl\textit
-\let\sl\it
-\let\slfamily\itfamily
-\def\ttdefault{cmtt}
-\usepackage{tex-live}
-\begin{document}
-%\author{Sebastian Rahtz\\
-%\texttt{s.rahtz@elsevier.co.uk}\\
-%Michel Goossens\\
-%\texttt{m.goossens@cern.ch}}
-%\title{The \protect\TeX\ Live Guide, 3rd edition}
-%\date{March 1998}
-
-\BASKyear{1998}
-\BASKmonth{April}
-\BASKvol{8}
-\BASKno{2}
-\BASKed*{Robin Fairbairns}
-\BASKfonts{Y\&Y European Modern}
-\makeBSKtitle
-
-\input editorial
-\ifbaskerville
-\end{multicols}
-%\vfill\Dings\vfill
-\fi
-\clearpage
-
-\begin{center}
- \LARGE The \TeX\ Live Guide, 3rd edition
-\end{center}
-\title{\TeX\ Live Guide, 3rd edition}
-
-\ifbaskerville\begin{multicols}{2}\fi
-\tableofcontents
-\listoftables
-\ifbaskerville
-\end{multicols}
-\Dings
-\fi
-
-\input tex-live
-\appendix
-
-\Dings
-
-\input live-app
-
-\vfill\Dings\vfill
-\clearpage
-\input sec
-\end{document}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/bvoutln.sty b/Master/texmf-doc/source/texlive/texlive-en/archive/bvoutln.sty
deleted file mode 100644
index 92f19fd027b..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/bvoutln.sty
+++ /dev/null
@@ -1,193 +0,0 @@
-% extracts of baskerville.cls for use with the tex-live documentation
-% when we're producing a bv issue with it.
-
-% ****************************************
-% * PAGE LAYOUT *
-% ****************************************
-%
-% SIDE MARGINS:
-\oddsidemargin -2.5pc \evensidemargin -2.5pc
-\marginparwidth 4pc % don't use marginal notes...
-\marginparsep 0.5pc % ...in the UK TUG newsletter
-
-% VERTICAL SPACING:
-\topmargin -3pc
-\headheight 12\p@
-\headsep 15\p@
-\topskip 10\p@
-\footskip 15\p@
-
-% DIMENSION OF TEXT:
-
-\textheight 250mm % height of text on a page (A4 paper)
-\textwidth 180mm % total width of a page
-\columnseprule 0.5\p@ % width of line in the inter-column gutter
-\columnsep 10mm % space between columns
-\tolerance 9999 % make those columns justify
-
-% FOOTNOTES:
-\footnotesep 6\p@
-\skip\footins 19.5\p@ plus 12\p@ \@minus 1\p@
-
-% FLOATS:
-\floatsep 12\p@ plus 5.5\p@ \@minus 1\p@
-\textfloatsep 15\p@ plus 4.5\p@ \@minus 3\p@
-\intextsep 12\p@ plus 5.5\p@ \@minus 2\p@
-\dblfloatsep 12\p@ plus 5.5\p@ \@minus 2\p@
-\dbltextfloatsep 15\p@ plus 4.5\p@ \@minus 3\p@
-\@fptop 0\p@ plus 0fil
-\@fpsep 12\p@ plus 0fil
-\@fpbot 0\p@ plus 3fil
-\@dblfptop 0\p@ plus 0fil
-\@dblfpsep 12\p@ plus 0fil
-\@dblfpbot 0\p@ plus 3fil
-\marginparpush 5\p@
-
-% ****************************************
-% * TITLES AND ABSTRACT *
-% ****************************************
-%
-
-%% Volume Number (ie Year - 1990)
-\def\BASKvol#1{\gdef\BASK@vol{#1}}
-\BASKvol{?}
-
-%% Issue Number (ie Month/2, roughly)
-\def\BASKno#1{\gdef\BASK@no{#1}}
-\BASKno{?}
-
-% Editor, Star form for Guest editor
-\def\BASKed{\@ifstar{\BASK@ed{Guest }}{\BASK@ed{}}}
-\def\BASK@ed#1#2{\gdef\BASK@editor{#1Editor: #2}}
-\BASKed{????????}
-
-%% Year (4 digits)
-\def\BASKyear#1{\gdef\thisyear{#1}}
-\BASKyear{????}
-
-% Month (as a Word)
-\def\BASKmonth#1{\gdef\thismonth{#1}}
-\BASKmonth{?????}
-
-\def\makeBSKtitle{\par
- \begingroup
- \vspace*{-\headheight}%
- \@maketitle
- \bigskip\hrule\bigskip
- \thispagestyle{plain}
- \endgroup
- \let\maketitle\relax
- \let\@maketitle\relax
-}
-\newbox\BSKbox
-\def\@maketitle{%
- \centerline{\BASK@titleline}%
- \medskip
- \hbox to \textwidth{\bfseries The Annals of the UK \TeX\ Users
- Group\hfill \BASK@editor\hfill Vol.~\BASK@vol\ No.~\BASK@no}%
- \smallskip\hbox to \textwidth{\bfseries ISSN 1354--5930
- \hfill \thismonth\ \thisyear}%
- \medskip
- \noindent\ignorespaces
- \BASK@headparone}
-
-% The Journal title command.
-% You probably only want to change this if you want to use a design-size
-% font rather than let \scaletowidth scale for some special issue.
-\def\BASKtitle#1{\gdef\BASK@titleline{#1}}
-\let\scaletowidth=\resizebox% added by Sean K. Harbour for Textures
-\BASKtitle{%
- \fontfamily{mbvx}\bfseries
- \scaletowidth{\textwidth}{!}{% modified by Sean K. Harbour
- B\,a\,s\,k\,e\,r\,v\,i\,l\,l\,e}}
-
-
-% The first paragraph. Needs to be reset if a special issue used a
-% different font set.
-\def\BASKheadparone#1{\gdef\BASK@headparone{#1}}
-\BASKheadparone{%
-This issue of \BV\ is set in \@BASKfonts, and printed on a Xerox Docutech. Production and distribution is
-undertaken in Cambridge by Robin Fairbairns. }
-
-
-\def\BASKfonts#1{\gdef\@BASKfonts{#1}}
-\BASKfonts{Monotype Baskerville, with Computer Modern Typewriter for
- literal text}
-
-%
-% for \Dings
-\RequirePackage{pifont}
-%
-% available for inter-article dinglines
-%
-\def\Dings{\nopagebreak{\footnotesize\dingline{167}}}
-
-%
-% hack representation of appendices
-\let\BV@@appendix\appendix
-\renewcommand{\appendix}{\BV@@appendix
- \renewcommand\@seccntformat[1]{\@ifundefined{@seccnt@##1}%
- {\csname the##1\endcsname\quad}%
- {\csname @seccnt@##1\endcsname}}
- \newcommand\@seccnt@section{Appendix~\thesection~}
-}
-
-%
-% page styles
-%
-% \ps@empty defined in LATEX.TEX
-%
-\def\ps@plain{\let\@mkboth\markboth
- \def\@oddhead{}
- \def\@evenhead{}
- \def\@oddfoot{\rm \hfil --\thepage--\hfil}
- \def\@evenfoot{\rm \hfil --\thepage--\hfil}
-}
-\def\ps@headings{\let\@mkboth\markboth
- \def\@oddhead{\hfill\emph{\@title}\hfill}
- \def\@oddfoot{\rm \hfil --\thepage--\hfil}
- \def\@evenhead{\it Baskerville \hfill
- Volume \BASK@vol, Number \BASK@no}
- \def\@evenfoot{\rm \hfil --\thepage--\hfil}
-}
-
-%
-% allow setting of pagehead title
-\def\title{\@ifnextchar [{\@titletwo}{\@titleone}}
-\def\@titletwo[#1]#2{\gdef\@title{#1}\gdef\@longtitle{#2}}
-\def\@titleone#1{\gdef\@title{#1}\gdef\@longtitle{#1}}
-
-%
-% more exciting page parameters
-\@twosidetrue
-\pagestyle{headings}
-
-\providecommand{\ukt}{UK \acro{TUG}}
-
-\newcommand{\standardtitles}{%
- \def\section{%\typeout{** section!}%
- \@startsection {section}{1}{\z@}
- {-12\p@ \@plus -6\p@ \@minus -.1\p@}
- {6\p@}
- {\raggedright\large\bfseries}}
- \def\subsection{\@startsection{subsection}{2}{\z@}
- {-4\p@ \@plus -2\p@ \@minus -.1\p@}
- {0.1\p@ \@plus 2\p@}
- {\raggedright\normalsize\itshape}}
- \def\subsubsection{\@startsection{subsubsection}{3}{\z@}
- {-6\p@ \@plus -3\p@ \@minus -1\p@}
- {0.1\p@ \@plus 2\p@}
- {\raggedright\normalsize\it}}
- \def\paragraph{\@startsection{paragraph}{4}{\z@}
- {12\p@ \@plus 2.25\p@ \@minus -1\p@}
- {-0.5em}
- {\normalsize\bfseries}}
- \def\subparagraph{\@startsection{subparagraph}{5}{\z@}
- {12\p@ \@plus 2.25\p@ \@minus 1\p@}
- {-0.5em}
- {\normalsize\it}}
- \setcounter{secnumdepth}{-1}
-}
-
-\endinput
-
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/changemail b/Master/texmf-doc/source/texlive/texlive-en/archive/changemail
deleted file mode 100644
index dd792a25f78..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/changemail
+++ /dev/null
@@ -1,24 +0,0 @@
-s/J.Smart@ed.ac.uk/??/
-s/gerd@uni-koblenz.de/??/
-s/Meijer@rulfsw.fsw.LeidenUniv.nl/??/
-s/wl@gnu.org/xlwy01@uxp1.hrz.uni-dortmund.de/
-s/weissert@SJUPHIL.SJU.EDU/Tom@Weissert.net/
-s/mehlich@informatik.uni-muenchen.de/mmehlich@semdesigns.com/
-s/eijkhout@math.ucla.edu/victor@eijkhout.net/
-s/ca_rowley@vax.acs.open.ac.uk/c.a.rowley@open.ac.uk/
-s/B.Jackowski@gust.s.org.pl/B.Jackowski@gust.org.pl/
-s/P.Pianowski@gusts.org.pl/P.Pianowski@gust.org.pl/
-s/mittelbach@mzdmza.zdv.uni-mainz.de/Frank.Mittelbach@Uni-Mainz.de/
-s/mcjones@pa.dec.com/paul.mcjones@acm.org/
-s/h.harders@tu-bs.de/Harald.Harders@dlr.de/
-s/pwilson@cme.nist.gov/peter.r.wilson@boeing.com/
-s/wikner@ariel.nac.ac.za/wikner@nac.ac.za/
-s/vitus@agropc.msk.su/vitus@ice.ru/
-s/greg@bic.mni.mcgill.ca/gward@python.net/
-s/mittelbach@mzdmza.zdv.uni-mainz.de/frank.mittelbach@latex-project.org/
-s/fbraun@rz.uni-potsdam.de/fbraun@atdot.org/
-s/david@dcarlisle.demon.co.uk/david.carlisle@latex-project.org/
-s/davidc@nag.co.uk/david.carlisle@latex-project.org/
-s/rf@cl.cam.ac.uk/rf10@cam.ac.uk/
-s/robin.fairbairns@cl.cam.ac.uk/rf10@cam.ac.uk/
-s/robin@lsl.co.uk/rf10@cam.ac.uk/ \ No newline at end of file
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/l.pl b/Master/texmf-doc/source/texlive/texlive-en/archive/l.pl
deleted file mode 100644
index d74f313a5cc..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/l.pl
+++ /dev/null
@@ -1,44 +0,0 @@
-require "status.pl";
-require "texlive.pl";
-while (<>) {
- chop;
- s/,$//;
- if (/^\@TeXIndex/)
- {
- ($nam) = /^\@TeXIndex.(.*)/;
- print "\@TeXIndex\{$nam";
- $Status=1;
- $Texlive=1;
- $Modified=0;
- }
- elsif (/^ *modified/) { s/, *$//; $mod=$_; }
- elsif (/^ *status/) { $Status=0;
- if ($L{$nam})
- { print ",\n status\t= \{$L{$nam}\}";
- $Modified=1;}
- else { print ",\n$_"; }
- }
- elsif (/^ *texlive/) { $Texlive=0;
- if ($texlive{$nam} ne "")
- { print ",\n texlive\t= \{$texlive{$nam}\}";
- $Modified=1;}
- }
- elsif (/^}/) {
- if ($Status) {
- print ",\n status\t= \{unknown\}";
- }
- if ($Texlive && $texlive{$nam} ne "")
- { print ",\n texlive\t= \{$texlive{$nam}\},\n"; }
- if ($Modified)
- { print ",\n modified\t= {1999/03/26 10:00:00 <s.rahtz\@elsevier.co.uk>}\n"; }
- elsif ($M{$nam} ne "")
- { print ",\n modified\t= \{$M{$nam}\}\n"; }
- else
- {print ",\n$mod\n"; }
- print "}\n";
- }
-
- elsif (/= {/) { print ",\n$_"; }
- else { print "\n$_"; }
- }
-
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/live-2003.tex b/Master/texmf-doc/source/texlive/texlive-en/archive/live-2003.tex
deleted file mode 100644
index 55c1551a628..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/live-2003.tex
+++ /dev/null
@@ -1,3937 +0,0 @@
-% $Id$
-% change history (started May 13th 2002)
-% 2003/09/06: fixes from Staszek
-% 2003/09/05: touched by Karl
-% 2003/09/04: fixes from Staszek and Fabrice
-% 2003/09/01: fixes from Volker
-% 2003/08/24: win32 updates, by Fabrice
-% 2003/08/12: fixes from Christer Gustafsson <gustaf@powertech.no>.
-% 2003/07/07: substantial revisions by karl.
-% 2002/05/25: remove mention of sizes, and bsr-interpolated; add Gutenberg
-% 2002/05/18: win32 updates, by Fabrice
-% 2002/05/14: corrected example files, other small errors noted by Volker
-% 2002/05/13: added tex-langafrican to list of collections
-%
-\documentclass{article}
-\usepackage{tex-live}
-%
-%
-\begin{document}
-
-\title{{\huge\textsf{\TK{} 2003}}\\[3mm]
- The \protect\TeXLive{} Guide}
-\date{September 2003}
-
-\author{Sebastian Rahtz, editor \\[3mm]
- \email{tex-live@tug.org}\\
- \url{http://tug.org/texlive/}\\[10mm]
-\ifnum \Status=2
- \includegraphics[bb=0 0 824 741]{../pictures/front.jpg} \\[5mm]
-\else
- \includegraphics[width=.5\linewidth]{../pictures/front} \\[5mm]
-\fi
- \small \textit{Documentation contacts:}\\[3mm]
- \small \begin{tabular}{lcr}
- Czech/Slovak & Petr Sojka & \email{sojka@fi.muni.cz} \\
- & Janka Chleb\'\i kov\'a & \email{chlebikj (at) dcs.fmph.uniba.sk} \\
- English & Karl Berry & \email{karl@freefriends.org} \\
- French & Fabrice Popineau & \email{fabrice.popineau@supelec.fr} \\
- German & Volker RW Schaa & \email{volker@dante.de} \\
- Polish & Staszek Wawrykiewicz & \email{staw@gust.org.pl} \\
- Russian & Boris Veytsman & \email{borisv@lk.net} \\
- \end{tabular}
- }
-
-% comes out too close to the toc, and we know it's page one anyway.
-\thispagestyle{empty}
-
-\maketitle
-\newpage
-
-\begin{multicols}{2}
-\tableofcontents
-\listoftables
-\end{multicols}
-
-\section{Introduction}
-\label{sec:intro}
-
-This document describes the main features of the \TeXLive{} software
-distribution\Dash a \TeX{} and \LaTeX{} distribution for Linux and other
-Unix flavors, \MacOSX, and (32-bit) Windows systems. (Warning: it is
-not especially useful for older Mac or \acro{MS-DOS} systems.) It
-includes precompiled binaries for \TeX{}, \LaTeXe{}, \MF, \MP,
-\BibTeX{} and many other programs; an extensive collection of
-macros, fonts and documentation; and support for typesetting in many
-different scripts from around the~world.
-
-For the 2003 release, the last update of packages and programs was made
-on September 3, 2003. For newer versions, please consult \acro{CTAN},
-\url{http://www.ctan.org}.
-
-For a brief summary of the major changes in this edition of \TeXLive{},
-see section~\ref{sec:history} on p.~\pageref{sec:history}.
-
-
-\subsection{Basic usage of \protect\TeXLive{}}
-\label{sec:basic}
-
-You can use \TeXLive{} in three principal ways:
-
-\begin{enumerate}
-
-\item You can run \TeXLive{} directly from the distribution media
-(except for the \pkgname{inst} distribution; see
-section~\ref{sec:multiple-dist} on p.~\pageref{sec:multiple-dist}).
-This takes almost no disk space, as you might expect, and gives you
-immediate access to everything in \TeXLive{}. Of course performance
-will be worse than running on local disk, but you may well find it
-acceptable.
-
-\item You can install all or part of \TeXLive{} to a local disk. This
-is the most common use of \TeXLive. You will need a minimum of 120
-megabytes, 360 megabytes for a recommended system, and 800 megabytes for
-a full system.
-
-\item You can integrate a particular package or collection into your
-existing \TeX{} system, either a \TeXLive{} system you installed earlier
-or a different system.
-
-\end{enumerate}
-
-\noindent All of these are described in detail in the \acro{OS}-specific
-installation sections.
-
-
-\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
-commercial-style support, you can forego \TeXLive{} completely and
-purchase a vendor's system; see
-\url{http://tug.org/interest.html#vendors} for a list.)
-
-Here is a list of resources, approximately in the order we recommend
-using them:
-
-\begin{description}
-\item [\TeX{} \acro{FAQ}] The \TeX{} \acro{FAQ} is a huge compendium of
-answers to all sorts of questions, from the most basic to the most
-arcane. It is included on \TeXLive{} in \OnCD{FAQ/english}, and is
-available on the Internet through \url{http://faq.tug.org}. Please
-check here first.
-
-\item [\TeX{} Catalogue] If you are specifically looking for a package,
-font, program, etc., the \TeX{} Catalogue is the place to look. It is a
-huge list of all \TeX{}-related items. See
-\OnCD{texmf/doc/html/catalogue}, or
-\url{http://www.ctan.org/tex-archive/help/Catalogue/catalogue.html}.
-
-\item [\TeX{} Web Resources] This web page has many \TeX{}-related
-links, in particular for numerous books, manuals, and articles on all
-aspects of the system: \url{http://tug.org/interest.html}.
-
-\item [support archives] The two principal forums for support are the
-Usenet newsgroup \url{news:comp.text.tex} and the mailing list
-\email{texhax@tug.org}. So, their archives have thousands of past
-questions and answers for your searching pleasure. See
-\url{http://groups.google.com/groups?group=comp.text.tex} and
-\url{http://tug.org/mail-archives/texhax}, respectively. A query on a
-general web search engine, such as \url{http://google.com}, never hurts.
-
-\item [posting questions] If you cannot find an answer, you can post to
-\dirname{comp.text.tex} through Google or your newsreader, or through
-email to \email{texhax@tug.org}. But before you post, \emph{please}
-read this \acro{FAQ} entry for advice on asking questions in such a way
-that you're most likely to get an answer:
-\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}.
-
-\item [\TeXLive{} support] If you want to report a bug or have
-suggestions or comments on the \TeXLive{} 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
-\TeXLive{}, you are better off writing to that program's maintainer or
-mailing list.
-
-\end{description}
-
-The other side of the coin is helping others who have questions. Both
-\dirname{comp.text.tex} and \code{texhax} are open to anyone, so feel
-free to join, start reading, and help out where you can. Welcome to
-\TeX{}!
-
-
-\section{Structure of \protect\TeXLive}
-\label{sec:struct-tl}
-
-The main two installation scripts for Unix and \MacOSX{} are
-\texttt{install-tl.sh} and \texttt{install-pkg.sh}. We discuss them
-in section \ref{sec:unix-install} on p.~\pageref{sec:unix-install}.
-Here, we describe the structure and contents of \TeXLive{}.
-
-
-\subsection{Multiple distributions: \protect\pkgname{live},
- \protect\pkgname{inst}, \protect\pkgname{demo}}
-\label{sec:multiple-dist}
-
-As of 2003, space limitations of \acro{CD-ROM} format have forced us to
-divide \TeXLive{} into three distributions, as follows.
-
-\begin{description}
-
-\item [live] a complete, runnable system on \acro{DVD}; it is too large
-for \acro{CD-ROM}. (The \DVD{} also includes a snapshot of the \CTAN{}
-repository, completely independent of \TeXLive{}.)
-
-\item [inst(allable)] a complete system on \CD; in order to make it fit,
-we had to compress everything we could. Therefore, it is not possible
-to run \TeX\ directly from the installable \CD, you have to install it to
-disk (hence its name). Installation is described in subsequent sections.
-
-\item [demo] a live system runnable directly from \CD; in order to make
-this fit, we omitted the very large collection of \acro{CJK} (Chinese,
-Japanese, Korean) language support, support for typesetting music, some
-less-commonly used fonts, and included executables only for Linux,
-\MacOSX, and Windows systems.
-
-\end{description}
-
-\noindent You can tell which type of distribution you're in by looking
-for a \texttt{00\var{type}.TL} file in this top-level directory.
-
-
-\subsection{Top level directories}
-
-Here is a brief listing and description of the top level directories in
-the \TeXLive{} distribution.
-
-\smallskip
-\begin{tabular}{>{\ttfamily}lp{.8\hsize}}
-bin & The \TeX{} system programs, arranged by platform. \\
-Books & Examples from some of the books about \TeX\ (see
- \filename{Books/README}). \\
-FAQ & Current versions of major FAQ collections. \\
-info & A few manuals in \acro{GNU} Info format, where available. \\
-\MacOSX & Supporting software for \MacOSX (see
- section~\ref{sec:mac-install} on p.~\pageref{sec:mac-install}). \\
-man & Unix man pages. \\
-source & The source of all programs, including the main \Webc{}
- \TeX{} and \MF{} distributions. These are stored in a
- \cmdname{bzip2}-compressed tar archive. \\
-support & assorted auxiliary packages and programs. These are
- \emph{not} installed by default. This includes
- \cmdname{Ghostscript}, \cmdname{netpbm}, and assorted editors and
- \TeX\ shells. \\
-texmf & root of installed packages, fonts, config files, etc. \\
-usergrps & Material about a few of the \TeX\ user groups. (Visit
- \url{http://tug.org/usergroups.html} for a current list.) \\
-xemtex & The \cmdname{XEmacs} editor and other support programs for
- Windows (see section~\ref{sec:win-xemtex} on p.~\pageref{sec:win-xemtex}).
- These programs generally come pre-installed on Unix systems, or are
- at least easy to compile. \\
-\end{tabular}
-
-
-\subsection{Extensions to \TeX}
-\label{sec:tex-extensions}
-
-\TeXLive{} contains three extended versions of \TeX:
-
-\begin{description}
-
-\item [\eTeX] adds a small but powerful set of new primitives
-\label{text:etex}
-(related to macro expansion, character scanning, classes of marks,
-additional debugging features, and more) and the \TeXXeT{} extensions
-for bidirectional typesetting. In default mode, \eTeX{} is 100\%
-compatible with ordinary \TeX. See
-\OnCD{texmf/doc/etex/base/etex_man.pdf}. \eTeX{} is now the default for
-\LaTeX{} and pdf\LaTeX{}.
-
-\item [pdf\TeX] writes Acrobat PDF format as well as \dvi{}. The
-\LaTeX{} \pkgname{hyperref} package has an option `\optname{pdftex}'
-which turns on all the program features. See
-\OnCD{texmf/doc/pdftex/pdftex-l.pdf} and
-\OnCD{texmf/doc/pdftex/base/example.tex}.
-
-\item [\OMEGA\ (Omega)] based on Unicode (16-bit characters), thus
-supports working with almost all the world's scripts simultaneously. It
-also supports so-called `\OMEGA{} Translation Processes' (\acro{OTP}s),
-for performing complex transformations on arbitrary input. See
-\OnCD{texmf/doc/omega/base/doc-1.8.tex} (not completely up-to-date).
-
-\end{description}
-
-
-\subsection{Other notable programs in \protect\TeXLive}
-
-Here are a few other commonly-used programs included in \TeXLive{}:
-
-\begin{cmddescription}
-
-\item [bibtex] bibliography support.
-
-\item [makeindex] index support.
-
-\item [dvips] convert \dvi{} to \PS{}.
-
-\item [xdvi] \dvi{} previewer for the X Window System.
-
-\item [dvilj] HP LaserJet driver.
-
-\item [dv2dt, dt2dv] convert \dvi{} to/from plain text.
-
-\item [dviconcat, dviselect] cut and paste pages
-from \dvi{} files.
-
-\item [dvipdfm] convert \dvi{} to PDF, an alternative approach
-to pdf\TeX\ (mentioned above). See the \pkgname{ps4pdf} and
-\pkgname{pdftricks} packages for still more alternatives.
-
-\item [psselect, psnup, \ldots] \PS{}
-utilities.
-
-\item [lacheck] \LaTeX{} syntax checker.
-
-\item [texexec] Con\TeX{}t and PDF processor.
-
-\item [tex4ht] \TeX{} to HTML converter.
-
-\end{cmddescription}
-
-
-\section{Unix installation}
-\label{sec:unix-install}
-
-As introduced in section~\ref{sec:basic} on p.~\pageref{sec:basic},
-\TeXLive{} has three principal uses:
-
-\begin{enumerate}
-\item Run directly from media.
-\item Install to disk.
-\item Integrate a particular package or collection into your existing
-\TeX{} installation.
-\end{enumerate}
-
-\noindent The following sections describes the Unix-specific procedures
-for each of these.
-
-\ifSingleColumn \begin{figure}[ht]\noindent \fi
-\begin{warningbox}
-\textbf{Warning: } The \TK{} \CD{}s and \DVD{} are in ISO 9660 (High Sierra)
-format, \emph{with} Rock Ridge (and Joliet, for Windows)
-extensions. Therefore, in order to take full advantage of the \TK{}
-under Unix, your system needs to be able to use the Rock Ridge
-extensions. Please consult the documentation for your \cmdname{mount}
-command to see how to do this. If you have several different machines
-on a local network, you may be able to mount the \CD{}s on one which
-does support Rock Ridge, and use this with the others.
-
-\leavevmode\quad Linux, Free\acro{BSD}, Sun, \acro{SGI} and
-Alpha systems should be able to use the \CD{}s without problems. We
-would appreciate receiving detailed advice from users on other systems
-who succeed, for future versions of this documentation.
-
-\leavevmode\quad
-The discussion below assumes you have been able to mount
-the \CD{}s with full Rock Ridge compatibility.
-\end{warningbox}
-\ifSingleColumn\end{figure}\fi
-
-
-%
-\subsection{Running \protect\TeXLive{} directly from media (Unix)}
-
-\def\runlive{% text repeated in windows section
-It is possible to use the \TeX{} system directly from the \pkgname{demo}
-\CD{} or the \pkgname{live} \DVD{}, without installing the distribution
-to disk. (Thus the name `\TeXLive', in fact.) It is \emph{not}
-possible to run \TeX{} directly from the \pkgname{inst} \CD (see
-section~\ref{sec:multiple-dist} on p.~\pageref{sec:multiple-dist}).
-}
-
-Only Linux, \MacOSX, and Windows binaries are included on the demo \CD;
-if you want to run live on other Unix systems, you'll need to use the
-\DVD.
-
-\def\startinst{% repeated in other subsections
-To start, we must mount the \CD{} or \DVD{}, with Rock Ridge extensions
-enabled. The exact command to do this varies from system to system; the
-following works under Linux, except the name of the device
-(\filename{/dev/cdrom}, here) may vary. (All our examples will use
-\texttt{>} as the shell prompt; user input is \underline{underlined}.)
-\begin{alltt}
-> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom}
-\end{alltt}
-
-\noindent Change the current directory to the mount point:
-\begin{alltt}
-> \Ucom{cd /mnt/cdrom}
-\end{alltt}
-
-\noindent Under \MacOSX, the directory is typically under
-\dirname{/Volumes}, and the media will be mounted automatically.
-}
-
-\startinst
-
-Run the installation script \filename{install-tl.sh}:
-\begin{alltt}
-> \Ucom{sh install-tl.sh}
-Welcome to TeX Live...
-\end{alltt}
-
-\def\firstinstcommand{%
-\noindent After various greeting messages and a list of the main menu
-options, the installation will ask you to enter a command. Do this by
-typing the desired character and hitting return; don't type the angle
-brackets. Either uppercase or lowercase is ok; we'll use lowercase in
-our examples.
-}
-\firstinstcommand
-
-For running live, our first command will be \Ucom{d} and then the
-subcommand \Ucom{1} to set directories. Even in this case, we must
-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{/usr/local/texmf-local} in this example. (If the default value
-of \dirname{/usr/TeX} works for you, then you can skip this step.)
-\begin{alltt}
-Enter command: \Ucom{d}
-Current directories setup:
-<1> TEXDIR: /usr/TeX
-...
-Enter command: \Ucom{1}
-New value for TEXDIR [/usr/TeX]: \Ucom{/usr/local/texmf-local}
-...
-Enter command: \Ucom{r}
-\end{alltt}
-
-\noindent Back at the main menu, our second and last command is
-\Ucom{r}, to set up for running live off the media without installing
-to disk:
-\begin{alltt}
-Enter command: \Ucom{r}
-Preparing destination directories...
-...
-Welcome to the TeX Live system!
->
-\end{alltt}
-
-\noindent And we are back at the system prompt, as shown.
-
-Next, it is necessary to alter two environment variables:
-\envname{PATH}, to an architecture-dependent value (so that we can run
-the programs), and \envname{VARTEXMF}, to the value specified above. See
-table~\ref{tab:archlist} for a list of the architecture names for the
-different systems, and whether they are available on the \pkgname{demo}
-\CD. All systems are available in the \pkgname{inst} and \pkgname{live}
-distributions. (In addition to the version-specific names listed here,
-there are generic names without the version numbers. For instance,
-\dirname{sparc-solaris} links to \dirname{sparc-solaris2.7}. The
-generic names can be used to protect against the version numbers
-changing in the future, if you wish.)
-
-\def\runtexconfig{%
-After the main installation has completed, and environment variables
-have been set, the next step is to run \cmdname{texconfig} to customize
-your installation for your needs. This is explained in
-section~\ref{sec:texconfig}, p.~\pageref{sec:texconfig}.
-}
-\runtexconfig
-
-\begin{table*}[ht]
-\caption{Supported system architectures.}
-\label{tab:archlist}
-\begin{tabular}{>{\ttfamily}lll}
-alpha-linux & HP Alpha Linux & \\
-alphaev5-osf4.0d & HP Alphaev5 OSF & \\
-%hppa2.0-hpux10.20 & HP9000 HPUX 10.20 & \\
-i386-freebsd4.8 & Intel x86 FreeBSD & \\
-i386-linux & Intel x86 GNU/Linux & demo \CD\\
-i386-openbsd3.3 & Intel x86 OpenBSD & \\
-i386-solaris2.8 & Intel x86 Solaris & \\
-mips-irix6.5 & SGI IRIX & \\
-powerpc-aix4.3.3.0 & IBM RS/6000 AIX & \\
-powerpc-darwin6.3 & \MacOSX & demo \CD\\
-sparc-solaris2.7 & Sun Sparc Solaris & \\
-sparc64-linux & Sun Sparc Linux & \\
-win32 & Windows (32-bit) & demo \CD\\
-\hline
-\end{tabular}
-\end{table*}
-
-\label{text:path}
-The syntax for setting the environment variables, and the initialization
-file to put them in, depends on the shell you use. If you use a
-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/\Ucom{\emph{archname}}:$PATH; export PATH
-VARTEXMF=/usr/local/texmf-local/texmf-var; export VARTEXMF
-\end{alltt}
-
-\noindent For C shell-compatible shells (csh, tcsh), put the following
-into your \filename{$HOME/.cshrc} file:
-\begin{alltt}
-setenv PATH /mnt/cdrom/bin/\Ucom{\emph{archname}}:$PATH
-setenv VARTEXMF /usr/local/texmf-local/texmf-var
-\end{alltt}
-
-\def\donewithinst{%
-\noindent Then log out, log back in, and test your installation
-(see section~\ref{sec:test-install} on p.~\pageref{sec:test-install}).
-}
-\donewithinst
-
-\def\ifindoubt{%
-If in doubt, please ask any local system gurus to help you with
-problems; for example, the way to mount the \TeXLive{} media, which
-directory or directories to use, and precise details of the changes to
-your personal initialization files can and do vary from site to site.
-}
-\ifindoubt
-
-
-%
-\subsection{Installing \protect\TeXLive{} to disk}
-\label{sec:unix-install-disk}
-
-It is possible, indeed typical, to install the \TeX{} system from the
-\TeXLive{} to disk. This can be done either from the \pkgname{live}
-\DVD, or the \pkgname{inst} \CD. It can also be done from the
-\pkgname{demo} \CD, if you don't need the omitted packages or systems.
-(See section~\ref{sec:multiple-dist} on p.~\pageref{sec:multiple-dist}
-for an explanation of the different distributions.)
-
-\startinst
-
-Run the installation script \filename{install-tl.sh}:
-\begin{alltt}
-> \Ucom{sh install-tl.sh}
-Welcome to TeX Live...
-\end{alltt}
-
-\firstinstcommand
-
-Here is an introductory list of the options in the main menu. The order
-in which you select the options makes little difference, except that
-\Ucom{i} must be last. It's reasonable to go through them in the
-order presented~here.
-
-% apparently here.sty [H] doesn't support table*.
-\begin{table}[H]
-\caption{Main menu options for the installation.}
-\label{tab:main-menu-options}
-\begin{tabular}{>{\ttfamily}ll}
-p & The system you are running on.\\
-b & The architectures to install binaries for.\\
-s & The base installation scheme to use (minimal, recommended,
- full, etc.)\\
-c & Override the installation scheme for individual collections.\\
-l & Override for language collections.\\
-d & Directories in which to install.\\
-o & General options.\\
-i & Perform the installation.\\
-\end{tabular}
-\end{table}
-
-Here are further details on each option.
-
-\textbf{\optname{p} -- Current platform.} Since the installation script
-automatically guesses which platform you're running on, this is
-generally unnecessary to override. It's there in case the automatic
-detection fails.
-
-\textbf{\optname{b} -- Binary architectures.} By default, only the
-binaries for your current platform will be installed. From this menu,
-you can select installation of binaries for other architectures as well
-(or not install the current platforms). This is often useful if you
-are sharing a \TeX\ tree across a network of heterogenous machines. For
-a list of the supported architectures, see table~\ref{tab:archlist},
-p.~\pageref{tab:archlist}.
-
-\textbf{\optname{s} -- Base installation scheme.} From this menu, you
-can choose an overall common set of packages. The default is a
-recommended set for typical needs, but you can also choose a basic set
-to conserve disk space, or a full set to get absolutely everything. The
-\pkgname{Live} scheme is used for creating the \TeXLive{}
-\pkgname{demo} distribution itself, and isn't generally useful to select
-for a particular site. There are also specific sets for Omega and
-\acro{XML} users.
-
-\textbf{\optname{c} -- Individual collections.} From this menu, you can
-override the basic scheme's choice of which collections to install.
-Each collection\Dash TeX macro files, Metafont font families, and so
-on\Dash consists of several packages. In this menu, selection letters
-are case-sensitive.
-
-\textbf{\optname{l} -- Language collections}. This menu has the same
-basic functionality as \Ucom{c}, to override collection choices. In
-this case, the collections are specifically for different languages.
-Selection letters are case-sensitive here. Here is a list of the
-language collections in \TeXLive:
-
-% xx really should generate list from texmf/tpm/collection/tex-lang*
-% a la install-tl.sh.
-\begin{tabbing}
-\hspace{.25\linewidth} \=
-\hspace{.25\linewidth} \=
-\hspace{.25\linewidth} \=
-\hspace{.25\linewidth} \kill
- (some) African scripts \>
- Armenian \>
- Chinese,Japanese,Korean \>
-Croatian \\
- Cyrillic \>
- Czech/Slovak \>
- Danish \>
-Dutch \\
- Finnish \>
- French \>
- German \>
-Greek \\
- Hungarian \>
- Indic \>
- Italian \>
-Latin \\
- Manju \>
- Mongolian \>
- Norwegian \>
-Polish \\
- Portuguese \>
- Spanish \>
- Swedish \>
-Tibetan \\
- \acro{UK} English \>
-Vietnamese \\
-\end{tabbing}
-
-\noindent Language collections typically includes fonts, macros,
-hyphenation patterns, and other support files. (For instance,
-\pkgname{frenchle.sty} is installed if you select the \optname{French}
-collection.) In addition, installing a language collection will alter
-the \filename{language.dat} configuration file controlling which
-hyphenations are loaded.
-
-\textbf{\optname{d} -- Installation directories}. Three directories can
-be changed here:
-\label{text:instdir}
-
-\begin{ttdescription}
-\item [TEXDIR] By default, the top-level directory under which
-everything else will be installed. The default value is
-\dirname{/usr/TeX}, and is often changed. For example, changing to a
-value such as \dirname{/usr/local/texlive2003} would make it possible to
-keep different releases of \TeXLive{} separate. You may then wish to
-make \dirname{/usr/local/texlive} a symbolic link, after testing the new
-release.
-
-Under \MacOSX, the usual frontends look for \TeX{} in
-\dirname{/usr/local/teTeX}, so you may wish to install \TeXLive{} there.
-
-\item [TEXMFLOCAL] This tree is where the \TeX{} system scripts install
-non-version-specific files, primarily fonts. The default value is
-\dirname{TEXDIR/texmf-local}. It's also the recommended location to put
-any local packages or configuration settings. Therefore, it's desirable
-to change it to a location independent of the current \TeXLive{}
-release; for example, \dirname{/usr/local/texmf-local}.
-
-\item [VARTEXMF] This tree is where the scripts install files that
-\emph{are} version-specific, primarily format files and the
-configuration files which are modified by \cmdname{texconfig} (see
-section~\ref{sec:texconfig}, p.~\pageref{sec:texconfig}). The default
-value is \dirname{TEXDIR/texmf-var}, and there's generally no reason to
-change it.
-
-\end{ttdescription}
-
-\textbf{\optname{o} - General options.} From this menu, you can select
-three general options affecting the installation:
-
-\begin{ttdescription}
-\item [a] Specify an alternate directory for generated fonts.
-The default is to use the \envname{VARTEXMF} tree, as explained above.
-Setting this is useful if you plan to mount the main tree read-only, and
-therefore another location (perhaps machine-specific) must be used for
-dynamically created fonts.
-
-\item [l] Create symbolic links for the binaries, man pages,
-and/or \acro{GNU} Info files in other locations. For example, you may
-wish to make the man pages available under \dirname{/usr/local/man} and
-the Info files available under \dirname{/usr/local/info}. (Of course
-you need appropriate privileges to write in the specified directories.)
-
-\item [d] Skip installation of the font/macro documentation tree.
-This is useful to save space, or if you've previously installed the
-documentation elsewhere.
-
-\item [s] Skip installation of the main font/macro source
-tree. This is useful if you are arranging to share that tree between
-machines and/or architectures in some other way, such as \acro{NFS} or
-\cmdname{automount}.
-
-\end{ttdescription}
-
-\textbf{i - Perform installation.} When you're satisfied with your
-configuration options, enter \Ucom{i} to actually do the installation
-from the media to your chosen locations.
-
-The last step is to include the architecture-specific subdirectory of
-\dirname{TEXDIR/bin} in your
-\envname{PATH}, so the newly-installed programs can be found. The
-architecture names are listed in table~\ref{tab:archlist},
-p.~\pageref{tab:archlist}, or you can simply list the directory
-\dirname{TEXDIR/bin}.
-
-The syntax for doing this, and the initialization file to put it in,
-depends on the shell you use. If you use a Bourne-compatible shell
-(\cmdname{sh}, \cmdname{bash}, \cmdname{ksh}, et al.), put the following
-into your \filename{$HOME/.profile} file:
-\begin{alltt}
-PATH=/\Ucom{\emph{TEXDIR}}/bin/\Ucom{\emph{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 /\Ucom{\emph{TEXDIR}}/bin/\Ucom{\emph{archname}}:$PATH
-\end{alltt}
-
-\runtexconfig
-
-Here is a brief annotated example which selects a full installation,
-with binaries for the current system only, with directory changes as
-recommended above. The prompts and \acro{RETURN} keys are omitted for
-brevity.
-
-\begin{alltt}
-> \Ucom{sh install-tl.sh}
-\Ucom{s} \Ucom{b} \Ucom{r} # scheme, full, return to main
-\Ucom{d} # change directories
-\Ucom{1} \Ucom{/usr/local/texlive2003} # top-level dir
-\Ucom{2} \Ucom{/usr/local/texmf-local} # TEXMFLOCAL outside TEXDIR
-\Ucom{r} # return to main
-\Ucom{i} # perform installation
-> \Ucom{texconfig} ...
-# New PATH, assuming Linux:
-> \Ucom{PATH=/usr/local/texlive2003/bin/i386-linux:$PATH; export PATH}
-\end{alltt}
-
-\ifindoubt
-
-
-%
-\subsection{Installing individual packages to disk}
-
-You can add individual packages or collections from the current
-distribution to an existing non-\TeXLive{} setup, or an earlier
-\TeXLive{} installation. You can do this from the \pkgname{demo} \CD{}
-or the \pkgname{live} \DVD{}, but \emph{not} from the \pkgname{inst}
-\CD. (See section~\ref{sec:multiple-dist} on
-p.~\pageref{sec:multiple-dist}.)
-
-\startinst
-
-Run the installation script \filename{install-pkg.sh} (not
-\filename{install-tl.sh}, which is intended for complete installations
-only):
-\begin{alltt}
-> \Ucom{sh install-pkg.sh \emph{options}}
-\end{alltt}
-
-This first set of options controls what gets read:
-
-\begin{ttdescription}
-\item [-{}-package=\emph{pkgname}] The individual package to work on.
-
-\item [-{}-collection=\emph{colname}] The individual collection to work on.
-
-\item [-{}-nodoc] Exclude documentation files from the operation.
-
-\item [-{}-nosrc] Exclude source files from the operation.
-
-\item [-{}-cddir=\emph{dir}] Source directory to read from; defaults
-to the current directory. If you followed the instructions above, that
-will be the distribution directory, and won't need to be changed.
-
-\item [-{}-listdir=\emph{dir}] The so-called `lists' directory within
-\emph{cddir} from which to read the package information. The default is
-\texttt{\emph{cddir}/texmf/tpm/lists}; the only reason to change it is
-if you're making changes to \TeXLive{} yourself.
-
-\end{ttdescription}
-
-What actually happens is controlled by the following options. If
-neither of these are specified, the default action is to install the
-selected files. The main destination tree is found by expanding
-\envname{\$TEXMFMAIN} with \cmdname{kpsewhich}. You can override it by
-setting either the environment variable \envname{TEXMFMAIN} or
-\envname{TEXMF}.
-
-\begin{ttdescription}
-\item [-{}-listonly] List the files that would be installed, but don't
-actually install anything.
-
-\item [-{}-archive=\emph{tarfile}] Instead of installing the files into
-the \TeX{} system, make a \cmdname{tar} archive.
-
-\end{ttdescription}
-
-Additional options:
-
-\begin{ttdescription}
-
-\item [-{}-config] After installation, run \code{texconfig init}.
-
-\item [-{}-nohash] After installation, don't run \cmdname{mktexlsr} to
-rebuild the filename database.
-
-\item [-{}-verbose] Give more information as the script runs.
-
-\end{ttdescription}
-
-Here are some usage examples:
-
-\begin{enumerate}
-
-\item To see the files in the package \pkgname{fancyhdr} without
-installing it:
-
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=fancyhdr --listonly}
-\else> \Ucom{sh install-pkg.sh --package=fancyhdr \bs}
-> \Ucom{--listonly}
-\fi{}
-texmf/doc/latex/fancyhdr/README
-texmf/doc/latex/fancyhdr/fancyhdr.dvi
-texmf/doc/latex/fancyhdr/fancyhdr.pdf
-...
-\end{alltt}
-
-\item Install the \LaTeX{} package \pkgname{natbib}:
-\begin{alltt}
-> \Ucom{sh install-pkg.sh --package=natbib}
-\end{alltt}
-
-\item Install the \LaTeX{} package \pkgname{alg} without source files or
-documentation:
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=alg --nosrc --nodoc}
-\else> \Ucom{sh install-pkg.sh -{}-package=alg \bs}
-> \Ucom{-{}-nosrc -{}-nodoc}
-\fi\end{alltt}
-
-\item Install all the packages in the collection of additional
-plain \TeX\ macros:
-\begin{alltt}
-> \Ucom{sh install-pkg.sh --collection=tex-plainextra}
-\end{alltt}
-
-\item Write all files in the \pkgname{pstricks} package to a
-\cmdname{tar} file in \path|/tmp|:
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=pstricks --archive=/tmp/pstricks.tar}
-\else
-> \Ucom{sh install-pkg.sh -{}-package=pstricks \bs}
-> \Ucom{-{}-archive=/tmp/pstricks.tar}
-\fi\end{alltt}
-
-\end{enumerate}
-
-\ifindoubt
-
-
-%
-\section{Post-installation}
-\label{sec:postinstall}
-
-After the main installation is done, for any operating system, the
-remaining steps are to configure the system for your local needs, and
-perform some basic tests.
-
-Another sort of post-installation is to acquire packages, fonts, or
-programs that were not included in \TeXLive{}. The basic idea is to
-install such additions in the \envname{TEXMFLOCAL} tree (if you
-installed to disk), or \envname{VARTEXMF} (if you are running live).
-See ``Installation directories'' on p.~\pageref{text:instdir}.
-
-Unfortunately, the details can vary widely, and so we do not attempt to
-address them here. Please see
-\url{http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst}
-for a good description, and
-\url{http://www.ctan.org/tex-archive/info/Type1fonts} for font creation
-and installation information in particular.
-
-
-\subsection{The \protect\cmdname{texconfig} program}
-\label{sec:texconfig}
-
-At any time after installation, you can and should use the program
-\cmdname{texconfig} to configure the system to fit your local needs. It
-is installed in the architecture-specific subdirectory
-\texttt{TEXDIR/bin/\emph{arch}} along with everything else.
-
-If you run it without arguments, it will enter full-screen mode and
-allow you to view and change options interactively.
-
-You can also run it with various command-line options. Here are some of
-the most commonly used:
-
-\begin{ttdescription}
-
-\item [texconfig dvips paper letter] Set default paper size for
-\cmdname{dvips} to be letter-size.
-
-\item [texconfig xdvi us] Likewise, for \cmdname{xdvi}.
-
-\item [texconfig rehash] Update all the \TeX{} system filename databases.
-
-\item [texconfig faq] Show the \teTeX{} \acro{FAQ}.
-(See also the main \TeX{} \acro{FAQ} in the \dirname{FAQ} subdirectory
-of \TeXLive.)
-
-\item [texconfig help] Output help information.
-
-\end{ttdescription}
-
-Of course, \cmdname{texconfig} only supports changing a few of the many
-options and configuration parameters in a \TeX{} system. The main
-configuration file for the base \Webc{} programs is named
-\filename{texmf.cnf}. You can find its location by running
-\samp{kpsewhich texmf.cnf}; it contains many comments explaining the
-default settings and useful alternatives.
-
-
-\subsection{Testing the installation}
-\label{sec:test-install}
-
-After installing \TeXLive{} as best you can, you naturally want to test
-it out, so you can start creating beautiful documents and/or fonts.
-
-This section gives some basic procedures for testing that the new system
-is functional. We described the Unix commands; under \MacOSX{} and
-Windows, you're more likely to run the tests through a graphical
-interface, but the principles are the same.
-
-\begin{enumerate}
-
-\item Make sure that you can run the \cmdname{tex} program in the first
-place:
-
-\begin{alltt}
-> \Ucom{tex -{}-version}
-TeX (Web2c 7.5.2) 3.141592
-kpathsea version 3.5.2
-Copyright (C) 1997-2003 D.E. Knuth.
-...
-\end{alltt}
-If this comes back with `command not found' instead of version and
-copyright information, most likely you don't have the correct
-\dirname{bin} subdirectory in your \envname{PATH}. See
-the environment-setting information on p.~\pageref{text:path}.
-
-\item Process a basic \LaTeX{} file:
-\begin{alltt}
-> \Ucom{latex sample2e.tex}
->TeX (Web2c 7.5.2) 3.141592
-...
-Output written on sample2e.dvi (3 pages, 7256 bytes).
-Transcript written on sample2e.log.
-\end{alltt}
-If this fails to find \filename{sample2e.tex} or other files, perhaps
-you have interference from old environment variables or configuration
-files. For a deep analysis, you can always ask \TeX{} to report on
-exactly what it is searching for, and finding; see ``Debugging actions''
-on page~\pageref{Debugging}.
-
-\item Preview the result online:
-\begin{alltt}
-> \Ucom{xdvi sample2e.dvi}
-\end{alltt}
-Under Windows, the analogous command is \cmdname{windvi}. You should
-see a new window with a nice document explaining some of the basics of
-\LaTeX{}. (Well worth reading, if you're new to the system.) You do
-have to be running under X for \cmdname{xdvi} to work; if you're not, or
-your \envname{DISPLAY} environment variable is set incorrectly, you'll
-get an error \samp{Can't open display}.
-
-\item Create a \PS{} file for printing or display:
-\begin{alltt}
-> \Ucom{dvips sample2e.dvi -o sample2e.ps}
-\end{alltt}
-
-\item Create a \acro{PDF} file instead of \dvi{}; this processes the
-\filename{.tex} file and writes \acro{PDF} directly:
-\begin{alltt}
-> \Ucom{pdflatex sample2e.tex}
-\end{alltt}
-
-\item Preview the \acro{PDF} file:
-\begin{alltt}
-> \Ucom{gv sample2e.pdf}
-\textrm{or:}
-> \Ucom{xpdf sample2e.pdf}
-\end{alltt}
-Unfortunately neither \cmdname{gv} nor \cmdname{xpdf} are currently
-included in \TeXLive{}, so you must install them separately. See
-\url{http://wwwthep.physik.uni-mainz.de/~plass/gv} and
-\url{http://www.foolabs.com/xpdf}, respectively.
-
-\item Other standard test files you may find useful:
-
-\begin{ttdescription}
-\item [docstrip.tex] Produce \TeX{} source or documentation from a
-\samp{.dtx} file.
-\item [small2e.tex] A simpler document than \filename{sample2e}, to
-reduce the input size if you're having troubles.
-\item [testpage.tex] Test if your printer introduces any offsets.
-\item [nfssfont.tex] For printing font tables and tests.
-\item [testfont.tex] Also for font tables, but using plain \TeX{}.
-\item [story.tex] The most canonical (plain) \TeX{} test file of all.
-You must type \samp{\bs bye} to the \code{*} prompt after \samp{tex
-story.tex}.
-\end{ttdescription}
-You can process these in the same way as we did with
-\filename{sample2e.tex}.
-
-\end{enumerate}
-
-If you are new to \TeX{}, or otherwise need help with actually
-constructing \TeX{} or \LaTeX{} documents, please visit
-\url{http://tug.org/begin.html}. We especially recommend the
-\textsl{Formatting Information} manual by Peter Flynn, available at
-\url{http://www.ctan.org/tex-archive/documentation/beginlatex}.
-
-
-\section{\MacOSX{} installation}
-\label{sec:mac-install}
-
-\TeXLive{} supports \MacOSX, but no prior Macintosh versions. (If you
-are running an older Mac version, you can view the files by installing
-the Joliet system extension available from
-\url{http://www.tempel.org/joliet}; however, the \TeXLive{} binaries
-will not run.)
-
-Installation of \TeX{} under \MacOSX{} can be done in two ways:
-
-\begin{enumerate}
-\item With the \filename{install*} scripts, as with Unix.
-\item With the \cmdname{i-Installer} included in
-\filename{MacOSX/II2.dmg}.
-\end{enumerate}
-
-\noindent Each of these is described in a following section.
-
-In addition, typical use of \TeX{} under \MacOSX\ goes through a
-\emph{frontend}. This is also described below.
-
-
-\subsection{\protect\cmdname{i-Installer}: Internet installation}
-\label{sec:i-Installer}
-
-The \cmdname{i-Installer} is included in the \TeXLive{} distribution as
-an alternative to normal installation. It does not use the contents of
-the \TeXLive{} distribution at all; instead, the system (approximately
-70 megabytes) is downloaded over the Internet.
-
-One advantage of \cmdname{i-Installer} is that it makes updates
-relatively painless. If you are interested, please see the
-\cmdname{i-Installer} \TeX{} home page at \url{http://www.rna.nl/tex.html}.
-
-To use it, mount \filename{./MacOSX/II2.dmg}. Read the documentation,
-launch it, and install at least \emph{TeX Foundation} and \emph{TeX
-Programs}. The first will finish without configuration, as soon as the
-second is installed you will be presented with a graphical interface to
-setting up your \TeX{} system.
-
-The \cmdname{i-Installer} distribution uses the \teTeX{} \dirname{texmf}
-tree with some additions. Due to differences between \TeXLive{} and
-\teTeX{} you cannot update a \TeXLive{} installation with an
-\cmdname{i-Installer} \emph{TeX Programs} i-Package.
-
-
-\subsection{\protect\cmdname{install*.sh}: \protect\TeXLive{} installation}
-
-In order to run the installation scripts under \MacOSX, you need to have
-the \cmdname{bash} shell installed. If you are running \MacOSX~10.2
-or later, you have \cmdname{bash}, and can proceed. If you're running
-an earlier \MacOSX{} version, however, the default shell is
-\cmdname{zsh}, which won't work; please see the
-subsection~\ref{sec:mac-bash} (p.~\pageref{sec:mac-bash}) below for
-instructions on installing bash \cmdname{bash}.
-
-Once you have \cmdname{bash}, the Unix installation documentation in the
-previous section can be followed. See section~\ref{sec:unix-install} on
-p.~\pageref{sec:unix-install}; \MacOSX-specific notes are included where
-needed.
-
-
-\subsection{\MacOSX{} frontends}
-
-Using \TeX{} on a Macintosh typically goes through a front end program,
-comprising an execution shell, editor, previewer, and other facilities.
-Here are the principal frontends:
-
-\begin{cmddescription}
-\item [TeXShop] Included in \TeXLive{} as
-\filename{./MacOSX/texshop.dmg}. See
-\url{http://www.uoregon.edu/~koch/texshop/texshop.html}.
-
-\item [ITeXMac] Included in \TeXLive{} as
-\filename{./MacOSX/iTeXMac-*.dmg}. See
-\url{http://itexmac.sourceforge.net}.
-
-\item [Mac-emacs] A port of Emacs to \MacOSX{}, integrating
-\pkgname{AucTeX}. See \url{http://www.cs.man.ac.uk/~franconi/mac-emacs}.
-
-\end{cmddescription}
-
-The frontends use \dirname{/usr/local/teTeX} as the default location;
-therefore, you must either install \TeXLive{} there, or change the
-configuration of the frontend.
-
-
-\subsection{\cmdname{bash} installation for older \MacOSX{} versions}
-\label{sec:mac-bash}
-
-\MacOSX{} versions 10.1 and earlier do not include \cmdname{bash} by
-default, and the default shell does not run the \TeXLive{} installation
-scripts properly. This section explains how to install \cmdname{bash}.
-
-First, check if bash is already installed. `Launch Terminal'
-(\filename{/Applications/utilities/Terminal}) and type \code{rehash;
-which bash}. If the answer is a filename (for example,
-\code{/bin/bash}), then \cmdname{bash} is already installed, and you're done
-here; go back to the main installation instructions.
-If the answer is \code{bash: command not found}, proceed here.
-
-There are two ways to install \cmdname{bash} if you need it\Dash via the
-\acro{GUI} or via command line.
-
-To install via \acro{GUI}, double-click the \filename{MacOSX/bash.dmg}
-file in \TeXLive{}. The disk image (volume) will be mounted. Then
-start the \cmdname{i-Installer} application on that volume. You will be
-asked to authenticate; if you have never seen that before, you might not
-have enough privileges to install. Just enter your own user name and
-password. Hit install. Bash will be installed on your system.
-
-To install via command line:
-\begin{enumerate}
-\item ensure you have admin privileges: log in as the
-\code{admin} user, the System Administrator, a user with Admin
-privileges, using \cmdname{sudo}, etc.
-
-\item copy \filename{MacOSX/bash.tar.gz} from the \TeXLive{}
-distribution to your home directory.
-
-\item Launch Terminal, and run:
-\begin{alltt}
-(cd /usr/local/; sudo tar xvzf ~/bash.tar.gz)
-\end{alltt}
-You'll be asked for your password, and then \cmdname{bash} will be
-installed.
-
-\item Quit Terminal.
-
-\end{enumerate}
-
-After using either installation method, be sure to recheck that
-\cmdname{bash} is installed with \code{rehash; which bash} in a new
-Terminal window.
-
-
-\section{Windows installation}
-\label{sec:win-install}
-
-\TeXLive{} can be installed on systems running Windows 9x, \acro{ME},
-\acro{NT}, \acro{2K} or \acro{XP}. Older versions of Windows (3.1x)
-and \acro{MS-DOS} are not supported.
-
-It is necessary to have your Windows set up so that it uses the
-Microsoft Joliet extensions for reading \CD{}s; simply look at the \CD{}
-in Explorer and see whether it shows long, mixed-case, file names. If it
-does not, you must install the Joliet extensions.
-
-The Windows \TeX{} system included in \TeXLive{} is no more and no less
-than the \fpTeX{} distribution. It includes a \texttt{dvi} previewer,
-\textsf{Windvi}, which is similar in usage to the established Unix
-\textsf{xdvi}. The documentation can be found in
-\OnCD{texmf/doc/html/windvi/windvi.html}.
-
-\subsection{The \texttt{TeXLive.exe} program}
-
-\begin{figure*}
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.7\textwidth]{../pictures/Welcome-to-TeXLive}
- \else
- \ifnum \Status=2
- \includegraphics[bb=0 0 551 534]{../pictures/Welcome-to-TeXLive.jpg}
- \else
- \includegraphics[width=.7\textwidth]{../pictures/Welcome-to-TeXLive}
- \fi
- \fi
- \end{center}
- \caption{``Welcome to \TeXLive'' window}\label{graph:welcome}
-\end{figure*}
-
-If your computer is configured to let the \CD{} autostart, then a dialog
-box with a menu bar will popup on the screen, and you will have several
-choices from there:
-
-\begin{itemize}
-\item Install \TeX{} on your hard disk
-\item Do maintenance on your \TeX{} system.
-\item Remove the \TeX{} system.
-\item Use \TeX{} off the \TeXLive{} \CD{} or \DVD{}.
-\item Browse documentation: \TeXLive{} documentation, TUG web
- pages, \fpTeX web pages.
-\item Run the \cmdname{TeXdocTK} application to find specific documentation.
-\end{itemize}
-
-If your \CD{} does not autostart, you can explicitly run the program
-by double clicking on \path|bin/win32/TeXLive.exe| on the \CD{} from
-the explorer window.
-
-\subsection{Running \protect\TeXLive{} directly from media (Windows)}
-
-\runlive
-
-To run live under Windows, from the menu, chose \verb|Explore CD-Rom|, then
-\verb|Run TeX off CD-Rom|. This will launch the \cmdname{XEmacs} editor.
-
-%% To run live under Windows, do the following:
-
-%% \begin{enumerate}
-%% \item from the menu, chose \verb|Explore CD-Rom|, then
-%% \verb|Run TeX off CD-Rom|, that will launch the \cmdname{XEmacs} editor.
-
-%% This program needs to be a \TeX{} oriented editor. It must be able
-%% to run the \TeX{} compiler, previewer and any other needed tool. If
-%% you don't have one already installed on your system, you can install
-%% one from the \CD{}, details section~{\ref{sec:texlive-install}}.
-
-%% \emph{There is no way we can guess if the program you will
-%% select is actually a text editor, so be careful}.
-%% Here is a list of frequently used \TeX{} editors:
-%% \begin{center}
-%% \begin{tabular}[H]{ll}
-%% GNU Emacs & \path|c:\Program Files\NTEmacs\bin\runemacs.exe| \\
-%% XEmacs & \path|c:\Program Files\XEmacs\XEmacs-21.2\i586-pc-win32\xemacs.exe| \\
-%% WinShell & \path|c:\Program Files\WinShell\WinShell.exe| \\
-%% WinEdt & \path|c:\Program Files\WinEdt Team\WinEdt\WinEdt.exe|\\
-%% TeXnicCenter & \path|c:\Program Files\TeXnicCenter\TEXCNTR.exe|
-%% \end{tabular}
-%% \end{center}
-%% The program
-%% selected will be memorized as the editor to use for future runs.
-
-%% \item from the menu, chose \verb|Explore CD-Rom|, then
-%% \verb|Run TeX off CD-Rom|. The environment will be modified, a small
-%% temporary directory created and some configuration files copied
-%% there. Then, the selected editor selected will be launched, and you
-%% will be able to type in some text, let \TeX{} typeset it and the
-%% view it or print it.
-
-%% If Ghostscript is not detected on your machine, you will be warned
-%% that rendering your DVI files might fail. You can install it from
-%% the \path|Install|, \path|Support| menu item. See
-%% section~\ref{sec:texlive-install} for details.
-
-%% \item you can select a different text editor any time you want.
-
-%% \item if you chose \verb|Cleanup CD-Rom setup|, everything \TeX{}
-%% needed will be removed, comprised the selection of your text
-%% editor, but not the extra packages you may have downloaded and
-%% installed. If you installed \cmdname{WinShell} or \cmdname{NTEmacs},
-%% they won't be removed.
-%% \end{enumerate}
-
-XEmacs startup file will set the environment variables needed. XEmacs will also
-setup a temporary \acro{TDS} compliant texmf tree in the temporary area of your
-computer. It is needed to store files that may be built on the fly, such as
-\path|pk| bitmap fonts, or format files. Configuration files are copied from
-the \CD{} to this texmf tree, so that you can edit them if needed. The
-\path|ls-R| database is computed for this texmf tree. The AUC-\TeX{} mode will
-be entered Whenever you will visit or create a \TeX{} file, providing all the
-bells and whistles for \TeX{} support XEmacs is capable of.
-
-If you run 'M-x shell' within XEmacs, then you will have access to all the TeXLive
-tools from the command line provided by XEmacs.
-
-\smallskip {\small\noindent \textbf{[For advanced users:]} You can also
- use the small batch file \path|mkloctex.bat| to be called in a
- directory \path|bin\win32| of the \CD. From the Start menu select
- `Run', then browse the \acro{CD} drive and select
- \path|mkloctex.bat|. Before starting it, you should add two parameters
- separated by a space: the letter of your \acro{CD} drive and the
- letter of the drive where you want to install the \TeX\ directory.
- The whole line should read, e.g., \verb+d:\bin\win32\mkloctex.bat d c+.
- When installation is complete, please read carefully the information
- on screen. If you are running Windows 9x/\acro{ME}, then you will have to
- restart Windows.}
-
-\subsection{Support packages for Windows}
-\label{sec:win-xemtex}
-
-To be complete, a \TeXLive installation needs support packages that are not
-commonly found on a Windows machine.
-Many scripts are written using the Perl language. Some important tools require
-the Ghostscript \PS{} interpreter to render or to convert files. A graphic
-file toolbox is also needed in some cases. Last but not least, a \TeX-oriented
-editor makes it easy to type in your \TeX{} files.
-
-All these tools are quite easy to find for Windows, but in order to try to make
-your life even easier, we have put such a set of tools on \TeXLive:
-\begin{itemize}
-\item \cmdname{Ghostscript} 7.07
-\item a minimal \cmdname{Perl} 5.8, sufficient to run all the \TeXLive{}
-Perl scripts
-\item a subset of \cmdname{ImageMagick} 5.5.6
-\item the \cmdname{ISpell} checker
-\item \cmdname{XEmacs} 21.5.14 with a selection of packages to support
-\TeX{} typesetting.
-\end{itemize}
-
-These packages should be installed only all at once. The bundle is
-known as the \XEmTeX{} bundle.
-
-If you didn't install \XEmTeX{}, \cmdname{Perl} and \cmdname{Ghostscript} are
-installed anyway if they are not detected on your machine. This is because they are
-required by many important tools. The \envname{PERL5LIB} and \verb|GS_LIB|
-environment variables will be set too.
-
-When you are under
-\cmdname{XEmacs}, the tools provided shadow any other version you might
-have installed previously. The point here is that \path|TeXSetup.exe|
-will not install anything outside of the \TeXLive location, neither will
-it run foreign installers, nor will it try to autodetect installed
-products using unreliable rules of thumb. The \XEmTeX{} bundle is
-standalone and is meant to evolve in the future. The reference site is
-\url{http://www.fptex.org/xemtex/}.
-
-If you don't want to install this bundle, then you are on your own to
-install the required tools to complete your \TeXLive{} system. Here is a
-list of places to get those tools:
-
-\begin{description}
-\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/}
-\item[Perl] \url{http://www.activestate.com/} (but you might need some
- supplementary packages from CPAN: \url{http://www.cpan.org/})
-\item[ImageMagick] \url{http://www.imagemagick.com}
-\item[NetPBM] alternatively, you could use NetPBM instead of ImageMagick to
- process or convert your graphic files. NetPBM home page is
- \url{http://netpbm.sourceforge.net/}
-\item[\TeX-oriented editors] There is a wide choice, and it is a matter of the
- user's taste. Here is a selection:
- \begin{itemize}
- \item \cmdname{GNU Emacs} is available natively under Windows, the
- reference url is
- \url{http://www.gnu.org/software/emacs/windows/ntemacs.html}
- \item \cmdname{XEmacs} is available natively under Windows, the
- reference url is \url{http://www.xemacs.org/}
- \item \cmdname{WinShell} is available on \TeXLive in the \path|support|
- directory, the reference url is \url{http://www.winshell.de}
- \item \cmdname{WinEdt} is shareware available from \url{http://www.winedt.com}
- \item TeXnicCenter is available from
- \url{http://www.toolscenter.org/products/texniccenter/}
- \item \cmdname{Vim} is available on \TeXLive{} in the
- \path|support\vim| directory and the
- reference site is \url{http://www.vim.org}
- \item \cmdname{SciTE} is available from \url{http://www.scintilla.org/SciTE.html}
- \end{itemize}
-\end{description}
-
-You might want to install other tools that are not free\footnote{Not
-free, that is, in the sense of freedom to modify and redistribute,
-following Debian's guidelines. This does not mean you can't acquire
-them for no money.} and therefore not included on \TeXLive{}, such as
-\cmdname{GSView}, the \cmdname{Ghostscript} companion to more
-conveniently view PS/PDF files. \cmdname{GSView} is available from
-\url{http://www.cs.wisc.edu/~ghost/gsview/} or any \acro{CTAN} site.
-
-%% \subsection{Installing editors or support packages}
-%% \label{sec:texlive-install}
-
-%% You can use the \path|TeXSetup.exe| program to install a
-%% single (not \TeX{}-dependent) package. This might be an editor
-%% such as \cmdname{WinShell} or \cmdname{NTEmacs},
-%% or a support package like \cmdname{NetPBM}
-%% (graphics formats conversion) or \cmdname{Ghostscript}.
-
-%% Some of the packages are not free, or not with the same meaning as for
-%% the rest of the \CD{}. These packages have been made available through
-%% the Internet. You need to enable an Internet connection in order to
-%% install them. Chosing the \path|Enable Internet access| subitem will
-%% search your system for an active Internet connection, or start one if
-%% possible. \emph{If your computer is not connected to the Internet,
-%% then the timeout might be long, 30s or more}. So try to enable it
-%% only if you know you have a connection.
-
-%% Only a few packages are available from the \CD{}, but the most
-%% important of them: \cmdname{NTEmacs} and \cmdname{WinShell} for the
-%% editors, \cmdname{Ghostscript} and \cmdname{NetPBM} for the other
-%% support packages. \cmdname{NetPBM} is needed for running \TeX{}4ht.
-
-%% The downloadable packages are sometimes huge: \cmdname{Perl} is 10Mb,
-%% \cmdname{XEmacs} is 50Mb, so be warned that it can take a lot of time
-%% to install such things. \path|TeXSetup.exe| does not yet provide an
-%% estimation of the time needed to complete the download.
-
-%% When installing these packages, \path|TeXSetup| is working in
-%% unattended mode. However, the programs that have their own installer
-%% like WinEdt or Ghostscript for example will require human interaction.
-
-%% Those packages who have no specific installer will be unpacked and configured
-%% for your system. You will be required to select some directory where
-%% they will be installed. The directory to select should be the root
-%% directory of the whole installation. Assuming you want to install
-%% NTEmacs and NetPBM, the archive files already contain the
-%% \path|NTEmacs\| and \path|NetPBM\| part, so the directory you have to
-%% select is something like \path|c:\Local| or \path|c:\Program Files|.
-
-\subsection{Installing \TeXLive{} to disk}
-
-\textbf{Warning: Win9x users must ensure they have enough environment
- space before undertaking installation. The \cmdname{TeXSetup.exe}
- program won't change the environment size for them. A few environment
- variables will be created and it is possible you run out of
- environment space. Add "SHELL=<path>COMMAND.COM /E:4096 /P" in the
- config.sys file in order to increase your environment size.}
-
-Installation is started by letting the media autostart. The program run
-is \path|TeXSetup.exe| if you are using the inst disk. If you are using
-the live or the demo disk, you will have to select the item
-\path|TeXLive Software| from the menu, then the subitem \path|Install on
-Hard Disk|. This will invoke \path|TeXSetup.exe|. You can also find it
-in the \path|bin/win32| directory and run it, if the autostart fails for
-any reason. \path|TeXSetup.exe| is a Windows wizard and it will display
-several pages while running.
-
-\begin{description}
-\item[Welcome Page]
- You can choose a \emph{quick} installation from
- here. In this case, the installation will run without any human
- assistance from beginning to end, with all the default settings
- (Figure~\ref{graph:setup-src},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). If you have enough privileges (administrator or power user
- rights) under a Windows version where this is applicable, then you can
- decide to install the \TeXLive{} for all users or for yourself only by
- checking the appropriate box.
- For installing the whole \XEmTeX{} bundle (XEmacs, Ghost\-script,
- Perl, ImageMagick and Ispell) you can check \emph{Install XEmTeX
- Support} box.
- \begin{figure*}[!htb]
- The \cmdname{TeXSetup} Wizard\hfill
- Source directories for the \TeXLive{} files
-
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.48\textwidth]{../pictures/setup-wizard.jpg}\hfill%
- \includegraphics[width=.48\textwidth]{../pictures/source-for-texlive.jpg}
- \else
- \ifnum \Status=2
-\includegraphics[bb=0 0 506 403]{../pictures/setup-wizard.jpg}
-\includegraphics[bb=0 0 506 403]{../pictures/source-for-texlive.jpg}
- \else
- \includegraphics[width=.48\textwidth]{../pictures/setup-wizard}%
- \hfill%
- \includegraphics[width=.48\textwidth]{../pictures/source-for-texlive}
- \fi
- \fi
- \caption{The \TeXLive{} setup wizard}\label{graph:setup-src}
- \end{center}
-\end{figure*}
-\item[Source Page]
- This page is a bit complex. It will allow you to select two source
- directories for your \TeXLive{} system
- (Figure~\ref{graph:setup-src},
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ). You will need a \emph{local
- source directory} and possibly a \emph{remote source directory}.
-
-Why do we need both these directories? The files consisting of the
-\TeXLive{} system are on the \CD{}, of course, but some other useful
-packages are not, either because of space lacking or because their
-license was not compatible with \TeXLive{}. You need to enable Internet
-downloading if you want to install these packages that are marked with a
-specific ``remote'' icon.
-
- However, don't panic: the default parameters of the setup will allow
- you to install a full system using the \CD{} only. Simply, you won't
- have \file{WinEdt} (for example), but you will be able to install it
- later.
-
- So you can take your files from:
- \begin{itemize}
- \item the \CD{} or any similar flat tree of files, available through
- some standard directory (this means the \CD{} can be mounted on
- some remote machine and be made available through network
- sharing),
- \item a set of \file{.zip} files (this is the case when you are
- installing from the demo \CD{} or the \fpTeX{} distribution),
- \item the Internet; in this case, the program takes care of
- downloading the \file{.zip} files it needs for you.
- \end{itemize}
- This option is available only if you enable Internet file
- downloading in the right part of the page. You also need to
- configure this Internet access by selecting to connect either using
- Internet Explorer~5 \file{wininet.dll}, or using a direct connection (\texttt{ftp},
- \texttt{http}).
-% or using a proxy server.
-% Last, you can be assisted in defining the \emph{local source
-% directory} and \emph{remote source directory} which will be used
-% to copy the files onto your hard disk. The \texttt{browse} buttons
-% allow to select a directory for the former, and an url among a list
-% of mirrors for the latter.
-\item[Root Page]
- On this page, you will tell where you want the files to be
- installed (Figure~\ref{graph:root-schm},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). Only the root directory really matters, the other ones
- are set according to the root one. You may want to make
- \path|$TEXMFEXTRA| point to some TDS compliant directory with other
- \TeX{} files or assign a different value to
- \path|$HOMETEXMF|, which is set by default to whatever Windows think
- is your `HOME' location.
-\begin{figure*}[!htb]
- Root and directories\hfill%
- Scheme selection
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.46\textwidth]{../pictures/root-of-installation.jpg}\hfill%
- \includegraphics[width=.46\textwidth]{../pictures/scheme-selection.jpg}
- \else
- \ifnum \Status=2
-\includegraphics[bb=0 0 506 403]{../pictures/root-of-installation.jpg}
-\includegraphics[bb=0 0 506 403]{../pictures/scheme-selection.jpg}
- \else
- \includegraphics[width=.46\textwidth]{../pictures/root-of-installation}%
- \hfill%
- \includegraphics[width=.46\textwidth]{../pictures/scheme-selection}
- \fi
- \fi
- \caption{\TeXLive-Setup: Root and directories / Schemes}\label{graph:root-schm}
- \end{center}
-\end{figure*}
-\item[Get TPM Page]
- This page does not require any manual intervention. The \file{.tpm}
- files which describe collections and packages are retrieved
- (possibly from the Internet), unzipped if needed and parsed.
-\item[Schemes Page]
- On this page, you will select the global scheme of your
- installation (Figure~\ref{graph:root-schm},
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ). A scheme is a large set of files targeted at some kind
- of usage. There are 3 generic schemes for basic, recommended and
- full installation. The other ones are devoted to LUGs (what GUST or
- GUTenberg propose for their members) or applications (XML and
- \TeX{}).
- When a scheme is selected, it is still possible to refine the
- selection by checking the appropriate box. If doing so, you will be
- presented the packages page to change your selection, else you will
- jump to the review page.
-\item[Packages Page]
- Collections and packages are presented in a tree form
- (Figure~\ref{graph:win32-support},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). The links
- in the tree are dependency links. Collections \emph{depend on}
- packages and maybe other collections, and it is the same for each
- package. You can select any package or collection individually, but
- your request will be granted only if the object is not requested by
- another one which is selected. For example, you can't deselect
- \texttt{tex-basic} without deselecting all the collections that
- request it.
-
- The \texttt{tex-xemtex} collection displayed on the picture is Win32 specific. It
- holds a number of bonus packages (Figure~\ref{graph:win32-support},
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ) which can be installed
- automatically and individually: Ghostscript (the \PS{}
- interpreter), XEmacs editor preconfigured for \TeX{}, tools like Perl,
- ImageMagick, Ispell. \emph{None of these packages are selected by
- default}.
-
- On this page, you also have the information about disk space
- needed, for each object, and for the set of those who are selected,
- and also the disk space available on the partition selected for the
- installation. Last, you can choose to install or not the
- documentation files and source files associated with each package.
-\item[Review Page]
- You will find there a summary of your choices
- (Figure~\ref{graph:review},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). It is still possible to
- go back to change them.
-\begin{figure*}[!htb]
- Packages Page\hfill%
- Win32 Support
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.48\textwidth]{../pictures/package-selection}\hfill%
- \includegraphics[width=.48\textwidth]{../pictures/win32-support}
- \else
- \ifnum \Status=2
-\includegraphics[bb=0 0 506 403]{../pictures/package-selection.jpg}\hfill%
-\includegraphics[bb=0 0 506 403]{../pictures/win32-support.jpg}
- \else
- \includegraphics[width=.48\textwidth]{../pictures/package-selection}%
- \hfill%
- \includegraphics[width=.48\textwidth]{../pictures/win32-support}
- \fi
- \fi
- \end{center}
- \caption{Packages Page / Win32 goodies}
- \label{graph:win32-support}
-\end{figure*}
-\item[Files Copy Page]
- The selected files are copied on your hard disk (Figure~\ref{graph:file-copy},
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ). All the files not
- yet available on your local disk are first downloaded from the
- remote source directory on the Internet. Then every package is
- unpacked (if \path|.zip| files), or copied from the \CD{}.
-\item[Configuration Page] Several packages need some configuration
- step to make them usable (Figure~\ref{graph:configuration},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). Also the \TeXLive{} system needs some post-processing step
- (format files generation, ls-R databases generation, environment
- variables, etc.). All these operations are done there, some of them
- can be lengthy.
-\begin{figure*}[!htb]
- \textbf{Review Page}\hfill%
- \textbf{File Copy Page}
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.48\textwidth]{../pictures/review-settings}\hfill%
- \includegraphics[width=.48\textwidth]{../pictures/file-copy}
- \else
- \ifnum \Status=2
- \includegraphics[bb=0 0 506 403]{../pictures/review-settings.jpg}\hfill%
- \includegraphics[bb=0 0 506 403]{../pictures/file-copy.jpg}
- \else
- \includegraphics[width=.48\textwidth]{../pictures/review-settings}\hfill%
- \includegraphics[width=.48\textwidth]{../pictures/file-copy}%
- \fi
- \fi
- \end{center}
- \caption{Review Page / File Copy Page}
- \label{graph:review}\label{graph:file-copy}
-\end{figure*}
-\item[Final Page] The installation being over, you may want to display
- the Windows specific documentation (HTML format) and / or the log
- file of the setup process (Figure~\ref{graph:final}
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ). If it is needed (Win9x/WinME), you will
- be asked to reboot your computer.
-\end{description}
-
-\begin{figure*}[!htb]
- \textbf{Configuration Page}\hfill%
- \textbf{Final Page}
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.48\textwidth]{../pictures/configuration}\hfill%
- \includegraphics[width=.48\textwidth]{../pictures/congratulations}
- \else
- \ifnum \Status=2
- \includegraphics[bb=0 0 506 403]{../pictures/configuration.jpg}\hfill%
- \includegraphics[bb=0 0 506 403]{../pictures/congratulations.jpg}
- \else
- \includegraphics[width=.48\textwidth]{../pictures/configuration}\hfill%
- \includegraphics[width=.48\textwidth]{../pictures/congratulations}%
- \fi
- \fi
- \end{center}
- \caption{Configuration Page / Final page}
-\label{graph:configuration}\label{graph:final}
-\end{figure*}
-
-Please be aware that the choice of cluster size on DOS disk
-partitions can radically affect the size of your \TeX\
-installation. The support tree has hundreds of small files, and it is
-not unusual for a complete installation to take up to four times the
-amount of space used on the \CD.
-
-
-\section{Windows maintenance and post-installation}
-
-\subsection{What's different in Windows?}
-
-The Windows version of \Webc{} has some specific features that should be
-pointed out.
-
-\begin{description}
-\item[\KPS{}] The hash-tables that \KPS{} builds are quite large for
- the \TeXLive{}. In order to cut down the starting time of any
- \KPS{}-enabled program, these hash-tables have been put in shared
- memory. This way, when you chain the execution of several such
- programs, like \path|tex| calling \path|mpost| calling \path|tex|,
- the overhead when starting each of the subprograms is
- reduced. This change is hidden to the user, except if you set the
- debug flag of kpathsea to the \path|-1| value: you will then trace
- access to the shared memory, which is not what you want (it is
- accessed very often!). What is useful in a log trace of the shared
- memory access is still to be defined, so the situation might evolve
- in the future.
-\item[\cmdname{kpsecheck}] This command provides some options that did
- not fit well into \cmdname{kpsewhich}. It will allow you to list all
- the files that occur multiple times across your texmf trees. This
- could be handy, but most of the time you will also get unwanted
- output (like dozens of \path|README| files)\footnote{It is noticeable
- that all these files result in clashes inside the \KPS{}-hashing
- mechanism; fortunately, \KPS{} never looks for these files.}. For
- this reason, you can combine the \path|-multiple-occurences| with 2
- other options for including or excluding any filename that match
- some pattern (you can request for several patterns).
-
- The \cmdname{kpsecheck} command will also report the status of shared
- memory: in use or not used. That might be useful to know because if
- the status reported is \samp{in use}, that means one or several
- processes are working, and the effect of any \cmdname{mktexlsr}
- command will be delayed until the next time where no \KPS{} linked
- process will be running.
-
- Last, this same command will report about the location it thinks
- Ghostscript can be found. Under Win32, for many programs, it is
- easier to use the Ghostscript dll, and find it by using the
- Ghostscript registry key than to change the \path|PATH|, which has a
- limited length anyway.
-\item[\Webc{}] The engines have a few more options than in Unix
- \Webc{}, and one option with a different behaviour:
- \begin{itemize}
-%% \item the \path|-fmt| option behaves differently. Previously and
-%% with the regular \Webc{} distribution, this option has 2 different
-%% meanings when you are in ``ini'' or ``vir'' mode. Under Win32, it
-%% has the same meaning: preload the format file specified with the
-%% argument. The meaning of building a format of such name in ini
-%% mode is obtained by the new \path|-job-name| option.
-%% \item \path|-job-name| option: allows to set the name of the file
-%% resulting from the compilation process. In normal mode, it will
-%% change the base name of all files produced (\path|.dvi|,
-%% \path|.aux|, etc.), while in ini mode, it will set the name of
-%% the format file written.
- \item \path|-halt-on-error| stop the compilation at the first error.
- \item \path|-job-time| set the job time to the same timestamp as the
- file given in argument.
-\item \path|-oem| use the DOS codepage for console output.
- \item \path|-output-directory| allow to write all the output files in the
- specified directory.
- \item \path|-time-statistics| print statistics about the job run
- time. It is to be noted that Win9x not being a true multitasking
- operating system, it has no reliable timer for short periods, so
- the value printed is an approximation. Under NT/2K/XP, the result
- is quite accurate with user time and system time values allocated
- for this run. For Unix
- users: the \path|time| command is not usually available to Windows
- users.
- \end{itemize}
-\end{description}
-
-\subsection{Adding packages to your installation}
-
-You will find an option in the \guiseq{TeXLive} menu (or go to
-\guiseq{Start\arw Programs \arw TeXLive \arw Add TeX package} menu) to
-run \file{TeXSetup.exe} in maintenance mode. The steps are almost the
-same as in the initial installation.
-
-We'll discuss differences below, but first, whatever changes you make,
-\textbf{do not forget to rebuild the ls-R database files}. Otherwise,
-your new files will not be found. You can do this either via the
-\acro{GUI} (\guiseq{Start \arw Programs \arw TeXLive \arw Maintenance
-\arw Rebuild ls-R}), or manually running the \file{mktexlsr} command.
-
-The main difference is in the packages selection page. In maintenance
-mode, the list of installed packages is compared to the list of packages
-available from your source directories. Packages that are not installed
-will be displayed in green, out of date packages will be displayed in
-red and up-to-date, installed packages are displayed in black.
-
-This way, you can choose to add or upgrade components, either from
-\TeXLive{} or from the Internet, where you are likely to find some more
-recent version of your packages.
-
-It is up to you to select which packages you want to install. The rest
-of the process is similar to the first installation.
-
-If you want to add files that are not provided by the \TeXLive{} (or
-\fpTeX{}) distribution, it is recommended to put them in the
-\path|$TEXMFLOCAL| directory. This way, you will be safe against
-upgrades of the \TeXLive{} 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:\Program Files\TeXLive\texmf-local\tex\latex\maple\|\\ and the
-documentation files in:\\ \path|c:\Program
-Files\TeXLive\texmf-local\doc\latex\maple\|
-
-\subsection{Uninstalling \protect\TeXLive{}}
-
-The uninstall procedure is available either from the \file{TeXLive.exe}
-program, from the \path|TeXLive| menu or from the control panel
-(\guiseq{Start \arw Control Panel, Add/Remove Programs}). This procedure
-will cleanup your hard disk of most of the \TeXLive{} files. However,
-\TeX{} is a system that is creating files and there is no mechanism to
-keep track of all of them. Moreover, Win32 support packages have their
-own uninstall procedure, which you will have to run separately (provided
-you want to get rid of them). Last, the files you may have stored in
-\path|$TEXMFLOCAL| won't be removed. So, even if the vast majority of
-files are automatically removed by the uninstall procedure, you will
-have to do some manual cleanup to actually remove all of them.
-
-\subsection{Running \texttt{TeXSetup.exe} from the command line}
-
-The \path|TeXSetup.exe| program has a number of other useful
-options. You can get the list by running:
-\begin{verbatim}
-c:\>TeXSetup --help
-\end{verbatim}
-
-Here is the description:
-\begin{description}
-\item[\path|--automatic-reboot|] reboot without waiting user
- confirmation once installation is over;
-\item[\path|--dry-run|] do nothing, just log everything that will be
- done without this option;
-\item[\path|--quick|] use the recommended installation and default
- directories, ask nothing up to rebooting;
-\item[\path|--with-xemtex|] selects the \XEmTeX{} bundle;
-\item[\path|--net-method (=ie5/direct)|] enable to download components with
- restricted licenses from the Internet (either using direct
- connection of Internet Explorer 5 DLLs): you need to have an available
- network connection and some of the packages are huge;
-\item[\path|--remote-source-directory <url>|] this is the base url for the remote packages;
-\item[\path|--local-source-directory <dir>|] by default, \path|TeXSetup.exe|
- will guess the root directory of the set of files you want it to act on, if you ever
- upgrade \path|TeXSetup.exe|, you won't be able to copy the new version
- onto your \CD{}, so you will need to use this option to specify the
- root of the \CD{};
-\item[\path|--installation-directory <dir>|] this is the root of your
- installation, all files will be copied under this location. The
- default value is \verb+c:\Program Files\TeXLive+;
-\item[\path|--texmfmain-directory <dir>|]
-\item[\path|--texmflocal-directory <dir>|]
-\item[\path|--texmfextra-directory <dir>|]
-\item[\path|--texmfhome-directory <dir>|]
-\item[\path|--vartexmf-directory <dir>|]
-\item[\path|--vartexfonts-directory <dir>|] these are the directories
- used to configure the location of your files. They map directly to
- the \path|texmf.cnf| variables.
-\item[\path|--with-source-files(=yes/no)|] copy the source files
- for \TeX{} packages, default value is no;
-\item[\path|--with-documentation-files(=yes/no)|] copy documentation files for \TeX{}
- packages. Default value is yes. Beware: this is only documentation about specific
- packages, general documentation will be installed anyway;
-\item[\path|--program-folder <folder>|] the name of the folder under
- which you will find the menus;
-\item[\path|--add-package <pkg>|] this is used to add or update a specific
- package after a first regular installation;
-\item[\path|--scheme <pkg>|] install the named scheme instead of the
- default \path|texlive-recommended| scheme;
-\item[\path|--maintenance|] mostly the same as \path|--add-package|
- without specifying a package to add;
-\item[\path|--uninstall|] this option will remove anything \TeX{} related coming from
- the \CD{}, which means there can be files left if you added style
- files or format files, and also that supplementary tools will not be
- removed. This option is still a bit crude in this release;
-\item[\path|--help|] this option opens up a box with the list of options.
-\end{description}
-
-\subsection{Network installation}
-
-\KPS{} knows about UNC names, so you can use them to get your TEXMF
-tree from the network. But there is better than this.
-All the support files and configuration files, everything except the files in the
-\path|bin/win32| are shareable with a \teTeX{} or Unix \TeXLive{} installation. That means
-you can use Samba either to mount from an NT server to a Unix
-workstation or the converse. Several strategies are possible:
-\begin{itemize}
-\item Put everything on the server. Just add each set of files for the os and
-architecture you want to use in the \path|bin| directory. That means
-for example \path|bin/win32| and \path|bin/i386-linux|. Next configure
-your main variables. You can use UNC names to
-point to the right directories under Win32.
-\item Install a local copy for the binaries and format files. In this
- case, assign \path|$TEXMFMAIN| to the main \path|texmf| tree that
- will be accessed remotely. Set \path|$VARTEXMF| to be a local
- directory which will hold local configuration files and on-the-fly
- generated files.
-\end{itemize}
-
-\subsection{Personal configurations}
-
-\subsubsection{Dvips}
-
-The configuration file for dvips can be found in\\
-\verb+C:\Program Files\TeXLive\texmf-var\dvips\config\config.ps+\\
-You may open it with any editor
- %(\cmdname{WinShell} will do fine)
- and change some parameters:
-
-\begin{description}
-\item [fonts] you can change the default printer \MF{} mode or printer
- resolution in case \cmdname{dvips} needs to generate PK fonts. By default it
- is configured to use Type~1 versions of the CM fonts, so it should
- not call \cmdname{mktexpk} too often;
-\item[printer] you can tell dvips where you want to print by default. If
- the \optname{o} option is not followed by a printer name, then a
- \file{.ps} \PS{} file is written. You can give dvips a printer
- name such as:
-\begin{verbatim}
-o lpt1:
-% o | lpr -S server -P myprinter
-% o \\server\myprinter
-\end{verbatim}
-\item[paper] Next, you might want
- to change the paper size from European (A4) to US letter
- by making the US letter the first paper size mentioned in the file.
- Scroll to the group of lines beginning with \code{@}. Move
- the appropriate lines so that this section begins with the lines:\\
-\hspace*{1em} @ letterSize 8.5in 11in\\
-\hspace*{1em} @ letter 8.5in 11in\\
-\hspace*{1em} @+ \%\%BeginPaperSize: Letter\\
-\hspace*{1em} @+ letter\\
-\hspace*{1em} @+ \%\%EndPaperSize
-\end{description}
-
-The current \TeXLive{} distribution implements the procedure of making
-always up-to-date fontmaps files for Dvips and Pdftex. This is done by
-the \cmdname{updmap} program during installation, as well as during any
-font package addition. If you add new packages by hand, edit the file
-\verb+updmap.cfg+ in \path|$VARTEXMF/web2c|.
-
-\subsubsection{Pdftex}
-
-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:\Program Files\TeXLive\texmf-var\pdftex\config\pdftex.cfg+ and
-change \samp{page\_width} and \samp{page\_height}. These entries should read:
-\begin{alltt}
-page_width 8.5 true in
-page_height 11 true in
-\end{alltt}
-Save the file and exit the editor.
-
-\subsubsection{GSView}
-GSView is now distributed under the Aladdin License, and therefore is no longer included in
-\TeXLive{}.
-
-If you may want to change the page size to US letter size. If so, open
-GSView from the \guiseq{Start} menu, and select \guiseq{Media\arw Letter}.
-
-Also, there are menu settings that are supposed to give you the most
-readable screen image. On \guiseq{Media \arw Display Settings}, set both
-\optname{Text Alpha} and \optname{Graphics Alpha} to 4~bits.
-
-Note that the installation process has set all \code{.ps} and
-\code{.eps} files to automatically open with \cmdname{GSView}.
-
-For printing instructions, see section~\ref{printing} below.
-
-\subsubsection{WinDvi}
-\label{sub:windvi}
-
-The \file{TeXSetup.exe} program takes care of associating the files
-with the \file{.dvi} extension with \file{Windvi}.
-
-Open it with \guiseq{Start\arw Programs\arw TeXLive\arw DVI Viewer}.
-
-You can set it for US letter-size paper by going to \guiseq{View\arw
-Options\arw Papertype} and selecting US (8.5\verb+"+ x 11\verb+"+) (and
-then \optname{OK}. Exit \cmdname{windvi}.
-
-You can change other parameters from there as well, such as the ability
-to execute system commands specified by the document (disabled by
-default for security reasons). Also, the first time you view any .dvi
-file, you may find the magnification too large. Zoom out until you get
-an appropriate size.
-
-%There are two important parameters related to printing that can't yet
-%be set from the dialog boxes, namely the resolution and the \MF{} mode
-%for the printer. You can set them once for all by specifying them on
-%the command line:
-%\begin{verbatim}
-%c:\>windvi -p 360 -mfmode canonbjc foo.dvi
-%\end{verbatim}
-%When you will exit Windvi, these parameters will be stored in the
-%configuration file. The available modes are found in this file:\\
-%\path|c:\Program Files\TeXLive\texmf\metafont\misc\modes.mf|
-
-All configuration settings for \cmdname{Windvi} are stored in a file
-named \path|windvi.cnf| file. You can find it by running this command at
-the prompt:
-\begin{verbatim}
-c:\>kpsewhich --expand-var $HOME/windvi.cnf
-\end{verbatim}
-
-Should you have problems with \cmdname{Windvi}, please remove the configuration
-file and test your problem against a vanilla configuration.
-
-\subsection{Testing}
-
-For generic verification procedures, see section~\ref{sec:test-install}
-on p.~\pageref{sec:test-install}. This section describes
-Windows-specific tests.
-
-Open the file \verb+sample2e.tex+ in your editor (Xemacs, WinShell),
-found in \path|C:\Local\TeX\texmf\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}
-menu (XEmacs) or Preview (Windvi) icon (WinShell).
-
-At first, when you preview files with Windvi, 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.
-
-\textbf{Hint for the future:} If a \LaTeX\ run stops because \LaTeX\
-cannot find a file, you can press Ctrl-z to quit.
-
-
-\subsection{Printing}
-\label{printing}
-
-It is possible to print from Windvi. In this case, printing will be done
-using the Windows unified printer driver. By definition, it is
-compatible with all printers. However, there is some drawback: it can
-generate some huge spool files, and some (older) versions of Windows
-just don't like them. The advantage is that you can use features like
-embedding BMP or WMF images. You also need to make sure that the printer
-parameters are correctly set (subsection~\ref{sub:windvi}), else you
-will get scaled printing (printing at 600\dpi{} on a 300\dpi{} printer
-will give you only one quadrant of your page).
-
-
-Printing is faster and more reliable if you run \cmdname{dvips} to make
-a \filename{.ps} file and then print from \cmdname{GSView}. In
-\cmdname{GSview}, select \guiseq{File\arw Print\ldots}. A \guiseq{Print}
-window will appear.
-
-If you are using a \PS{} printer, \textit{be sure to select
-\guiseq{\PS{} Printer}}. This is done in the \guiseq{Print Method} box
-at the bottom left of the \guiseq{Print} window. You can then select any
-of the printers that you have previously installed. If you fail to
-check the box for \optname{\PS{} Printer}, printing will not work.
-
-If you will be using your own non-\PS{} printer, select
-\guiseq{Ghostscript device} in the \guiseq{Print Method} box, then click
-on the button to the right labelled \guiseq{djet500} and select your
-printer type from the list that pops up. (In the older version of
-\cmdname{GSView}, make sure \optname{\PS{} Printer} is \textit{not}
-selected, then select your printer type from the \guiseq{Device} list.)
-
-%If you use \cmdname{WinShell} and a \PS{} printer, probably the
-%most convenient way to print is to add an icon to the \cmdname{WinShell}
-%toolbar that invokes dvips in a way that sends the output directly to a
-%default printer. For detailed instructions on how to do this, see
-%the next section.
-
-%% \subsection{\cmdname{WinShell}}
-%% \label{winshell:more}
-
-%% \subsubsection{Configuring \cmdname{WinShell}}
-%% \label{sec:winshell}
-
-%% Start this program from the Start menu or from the Desktop shortcut.
-%% Go to \guiseq{Options \arw Program Calls}.
-
-%% \begin{itemize}\itemsep 0pt
-%% \item In the DVIWin tab, if the filename is \filename{yap}, replace it
-%% with \filename{windvi.exe}.
-%% \item In the Ghostview tab, make sure it gives the correct path for
-%% gsview32.exe:\\
-%% \hspace*{1em} \verb+C:\ghostgum\gsview\gsview32.exe+ (for 3.6, the
-%% current version)\\
-%% or \\
-%% \hspace*{1em} \verb+C:\gstools\gsview\gsview32.exe+ (for the older
-%% version)
-
-%% \end{itemize}
-
-%% Click \guiseq{OK}.
-
-%% Note that the install process sets all files with the \texttt{.tex}
-%% extension to open with \cmdname{WinShell}. Unless you plan to use another editor
-%% (such as WinEdt or Emacs), this is appropriate.
-
-%% Unfortunately, \cmdname{WinShell} does not have a spell-checking
-%% feature. However, if you have installed the \path|tex-extrabin|
-%% collection, your installation includes \cmdname{Ispell} (a spell
-%% checking program found on most Unix systems). The executable is in your
-%% PATH so \verb+ispell.exe+ will be found if you invoke it from a DOS
-%% window. If you installed documentation, look at \path|C:\Program
-%% Files\TeXLive\texmf\doc\html\manpages\ispell.html|for information on
-%% Ispell. (Otherwise, you can find \verb+ispell.html+ on the CD.) If you
-%% rely on spell checking, you may want to add an Ispell icon to
-%% \cmdname{WinShell}. See subsection~\ref{winshell:ispell} of this
-%% document for how to do that.
-
-%% For an excellent commercial (but inexpensive) spelling checker,
-%% see \url{http://www.microspell.com}.
-
-%% \cmdname{WinShell} also has on-line help, which you can access via the
-%% $\textbf{\underbar{?}}$ on the menu bar.
-
-%% Other information about using \cmdname{WinShell} can be found in
-%% section \ref{winshell:more} on p.~\pageref{winshell:more}.
-
-
-%% \subsubsection{Installing Bug Fixes}
-
-%% \cmdname{WinShell}'s author (\href{mailto:idb@winshell.de}{Ingo de Boer},
-%% thanks to him) sometimes releases beta versions of the next \cmdname{WinShell}
-%% version which are also bug fixes. You can grab them from
-%% \url{http://www.winshell.de}. Usually they are \file{.zip} files that
-%% only require to be unpacked in \cmdname{WinShell} directory (\path|c:\Program
-%% Files\WinShell| by default), either using WinZip or a similar tool, or
-%% by using \file{unzip} on the command line. If you got some
-%% \file{winshellbugfix.zip} file and that you saved it in the \cmdname{WinShell}
-%% directory, then you need to run:
-%% \begin{verbatim}
-%% c:\>cd c:\"Program Files"\WinShell
-%% c:\>c:\local\bin\unzip winshellbugfix.zip
-%% \end{verbatim}
-%% Say \optname{yes} if you are asked if some files should be overwritten. The
-%% \path|unzip.exe| programme can be found in the
-%% \path|support/gnu-utils| package. If you
-%% do not have it on your machine, you can use any archiver tool like
-%% WinZip to achieve the same effect.
-
-%% \subsubsection{The \cmdname{Project} feature: organizing many files}
-
-%% If your document is split into several files (for example a thesis),
-%% look into \cmdname{WinShell}'s \cmdname{Project} feature. From the
-%% \guiseq{Project} menu, you give the project a name (e.g., \code{Thesis}),
-%% supply the name of the main (or root) file, and then \code{add} other
-%% files. These filenames display on the left of the screen where you can
-%% double click the names to view and switch between them. Clicking the
-%% \guiseq{\LaTeX} icon always processes the main file.
-
-%% Note the icons on the toolbar for toggling the project space (on the left)
-%% and the log space (at the bottom). If you are not using the Project
-%% feature, you may want to toggle off the space on the left, using the full
-%% screen width to display your file.
-
-%% \subsubsection{Printing from \cmdname{WinShell} to a \PS{} Printer}
-%% \label{winshell:print}
-
-%% The Dvips icon on the \cmdname{WinShell} toolbar puts the \PS{} output
-%% in a file, which you can then view with GSView and print from there if
-%% you choose. However, it's convenient to add a \cmdname{WinShell}
-%% ``program call'' to dvips which sends the output directly to a
-%% designated \PS{} printer. The steps below show how to do this for the
-%% printer \optname{vclw}; you should substitute the name of your most
-%% frequently-used printer.
-%% \begin{enumerate}
-%% \item Make the program aware of the printer:
-%% \begin{itemize}
-
-%% \item Open \cmdname{WinShell}, go to \guiseq{Options\arw Program
-%% Calls\arw User defined}.
-
-%% \item Click on \guiseq{Tool 1} in the list on the right and fill in the
-%% fields to the left as follows:\vspace{-6pt}
-%% \begin{quote}
-%% Name: \verb+Print+\\
-%% exe file: \verb+dvips+\\
-%% cmd-line: \verb+ -D600 %m -o vclw+\\
-%% Uncheck the box for \guiseq{DVIPS first}
-%% \end{quote}%\vspace{-12pt}
-%% \item Click \guiseq{OK}
-%% \end{itemize}
-%% \item Add \guiseq{Print} to the toolbar:
-%% \begin{itemize}
-%% \item Go to \guiseq{Options\arw View\arw Customize}.
-%% \item In the \guiseq{Category} box, select \guiseq{User-Programs}.
-%% \item Select \guiseq{Print} and drag it to the toolbar, placing it just to
-%% the right of the \cmdname{GSView} icon.
-%% \item You then have a choice of \guiseq{Image only}, \guiseq{Text only},
-%% or \guiseq{Image and Text}. The easiest is to select \guiseq{Text only}
-%% and click \guiseq{OK}. You should then see \guiseq{Print} on the
-%% toolbar. (If you prefer, you can select \guiseq{Image only\arw Edit},
-%% and edit the displayed picture to your satisfaction.)
-%% \end{itemize}
-%% \end{enumerate}
-%% Now, to print a \LaTeX\ document, just click on the \guiseq{Print} icon
-%% to send to your selected printer. To use a different printer, you will
-%% need to click on the \guiseq{Dvips} icon to print to a file. Then click
-%% on the \cmdname{GSView} icon and use \cmdname{GSView} to send to any
-%% printer you have installed on your \acro{PC}.
-
-%% \subsubsection{Adding Ispell to \cmdname{WinShell}}
-%% \label{winshell:ispell}
-%% \begin{enumerate}
-%% \item Add Ispell to User Tools:
-%% \begin{itemize}
-%% \item Open \cmdname{WinShell}, go to \guiseq{Options\arw Program
-%% Calls\arw User defined}.
-%% \item In the list on the right, click on \guiseq{Tool~1} (or
-%% \guiseq{Tool~2} if you have already used \guiseq{Tool~1}) and fill in
-%% the fields to the left as follows:\vspace{-6pt}
-%% \begin{quote}
-%% Name: \verb+Ispell+\\
-%% exe file: \verb+ispell+\\
-%% cmd-line: \verb+ -t -d american %c.tex+\\
-%% Uncheck the boxes for \guiseq{LaTeX first} and \guiseq{DVIPS first}
-%% \end{quote}
-%% \item Click \guiseq{OK}.
-%% \end{itemize}
-
-%% \item Add Ispell to the toolbar:
-%% \begin{itemize}\itemsep 0pt
-%% \item Go to \guiseq{Options\arw View\arw Customize}.
-%% \item In the \guiseq{Category} box, select \guiseq{User-Programs}.
-%% \item Select \guiseq{Ispell} and drag it to the toolbar, placing it just to
-%% the right of the \cmdname{GSView} icon (or the last icon you added).
-%% \item You then have a choice of `\guiseq{mage only}, \guiseq{Text only},
-%% or \guiseq{Image and Text}. The easiest is to select \guiseq{Text only}
-%% and click \guiseq{OK}. You should then see \guiseq{Ispell} on the
-%% toolbar. (If you prefer, you can select \guiseq{Image only\arw Edit},
-%% and edit the displayed picture to your satisfaction.)
-%% \end{itemize}
-%% \end{enumerate}
-%% Now, when you have a \LaTeX\ document open, you can click on
-%% \guiseq{Ispell} to perform spell checking. Ispell will open another
-%% window and display the first misspelled word on the left with the
-%% filename on the right. Below that you will see the context in which the
-%% misspelling appears; often several suggestions for replacements are also
-%% displayed. To replace the word, enter the number corresponding to the
-%% desired replacement. Other possible responses are listed below; for
-%% example, you can press the space bar to ignore the misspelled word. For
-%% more information on Ispell, read the manual page:
-%% \verb+C:\Program Files\TeXLive\texmf\doc\html\manpages\ispell.html+.
-
-%% Note that when you replace a word, you will not see the correction in
-%% your \cmdname{WinShell} window until you close the file (click the
-%% \guiseq{X} in the upper right corner) and then open it again (use the
-%% \guiseq{File} menu).
-
-\subsection{Tips and tricks for Win32}
-
-\subsubsection{Different flavors of Win32}
-
-What we call Win32 is not an operating system by itself. It is a large
-set of functions (around 12,000 in the header files of the Microsoft
-\acro{SDK}) that you can use to write programs for different operating
-systems of the Windows family.
-
-Windows comes in different flavors:
-\begin{itemize}
-\item Win95, Win98 and Win\acro{ME}, which \emph{are not true multitasking,
- multithreading} environments. They are the latest\Dash and hopefully
- last\Dash metamorphosis of \acro{DOS}. This can be more or less proven
- by the fact that when booting, the PC will load the \path|command.com|
- interpreter, and if you stop the boot process at this point, you can
- ask for the current (\acro{DOS}) version and it will answer something
- like \samp{MS-DOS 7.0} (at least for the old versions of Win9x).
-\item Windows \acro{NT}, which is a new operating system written from
- scratch, capable of true multitasking behaviour, and including many
- high level features.
-\item Windows 2000, based on \acro{NT}, with all the bells and
- whistles of Win98.
-\item Windows \acro{XP}, which comes with Personal and Pro flavors. This is
- the last step in merging both lines of products (Win9x based and
- \acro{NT} based). \acro{XP} is based on \acro{NT}.
-\end{itemize}
-
-Win9x are able to run 32~bits programs and 16~bits programs
-concurrently. But the operating system by itself is not entirely
-written in 32~bits mode, and does not support memory protection: 16bits
-applications can overwrite parts of the operating system memory! Some
-parts of the system like the \acro{GDI} (Graphical Device Interface)
-manage limited resources like bitmaps, fonts, pens and so on for the set
-of all programs that run concurrently. All the bitmaps headers available
-at the same time can't amount for more than 64kB. This explains the
-performance tool and the fact that you can put your system on his knees
-by making intensive use of graphic objects for example.
-
-NT, 2K and XP do not suffer from these limitations, and neither from
-other Win9x limitations. They are true multitasking environments, with
-protected memory. They are much more responsive than Win9x because
-of better memory management, better file system and so on.
-
-\subsubsection{Command line prompt}
-
-You may wonder, ``Why would I need to use a command line prompt when
-I have Windows?''
-
-Good question. The problem is of very general nature. Not all operations
-can be done easily using only a \acro{GUI}. Command line gives you
-programming power\Dash assuming a clever command interpreter.
-
-But the problem here is more fundamental: \TeX{} is \emph{a batch}
-tool. Not an interactive one. \TeX{} needs to compute the best
-layout for each page, resolve cross-references and so on. This can be
-done only by a global processing of the document. It is not (yet) a
-task that can be done interactively.
-
-This means that you should use \TeX{} from a command line. In fact the
-situation is not so bad. There is an advantage to write command line
-tools for complex processing: they are better debugged, because they are
-independent of any \acro{GUI} problems, and \acro{GUI} tools can be
-designed to interface to the command line tools. This is the case for
-\TeX{}, where you will mostly interact with it through a \acro{GUI} text
-editor.
-
-However, you may need to use the command line prompt in a number of
-situations. One is when you are having difficulties and want to debug
-your setup.
-
-\begin{description}
- \item[Win9x] You can open a command line prompt by looking either for
- the \acro{MS-DOS} icon in the \guiseq{Start\arw Programs} menu,
- or by choosing \guiseq{Start\arw Run} menu typing in
- \path|command.com| as the progrm name.
- \item[NT, 2K, XP] You can open a command line prompt by looking for
- \guiseq{Command Prompt} in the \guiseq{Start\arw Accessories} menu.
- You can also choose \guiseq{Start\arw Run} and type in
- \path|cmd.exe|, which is the name of the brand new command
- interpreter for \acro{NT} (thus, it is untrue to call this a
- \emph{DOS} box!).
-\end{description}
-
-These locations may change across different Windows versions.
-
-
-\subsubsection{Path separators}
-
-The Win32 API understands both \path|/| and \path|\| characters as PATH
-separators. But the command interpreters do not! So whenever a path name
-is used programmatically, you can use both separators, and even mix them
-up in the same path name. But on the command line, you must type
-\path|\| as path separator. The reason is compatibility: the command
-processor used \samp{/} to introduce arguments to commands.
-
-All this to say: do not be surprised to read path names written using
-the Unix convention; \fpTeX{} is a port of \Webc, and aims to be compatible
-across platforms. For this reason, all the configuration files that
-need to specify path names use the Unix convention.
-
-\subsubsection{File systems}
-\label{sec:clusters}
-
-The worst feature of Win9x with regard to \TeX{} is probably the
-so-called FAT file system. \TeX{} uses many many small files, with size
-around 1--3kB. The \acro{FAT} file system is old, and predates by
-decades the multi-gigabytes hard disks we have today. As a result, it
-cannot manage efficiently the tens of thousands of \TeX{} files found in
-\TeXLive{}. The \acro{FAT} file system allocates a minimum of 32kB for
-\emph{any} file on a huge partition. It means that \TeX{} will use much
-more disk space than it actually needs.
-
-The other, more modern, file systems available, \acro{FAT32} and
-\acro{NTFS}, do not have this drawback. They manage clusters of 4kB
-only. (You can lower the limit to 512 bytes on \acro{NTFS}.)
-
-\subsubsection{How to add some directory to your PATH}
-
-There are pairs of variables and values which behave much like global
-variables inside your programs. The set of those variables is called the
-environment. Each program is initialized with a copy of the
-environment when it is run. It can request and change the
-value of any variable. The changes happen in the copy of the
-environment, and is not at all propagated to the other running
-programs.
-
-Your PATH is a special environment variable used to search for
-programs you want to run.
-There is a different procedure to change it for Win9x, WinME and NT/2K/XP:
-
-\begin{description}
-\item[Windows 95/98] Edit your \path|autoexec.bat|. In this file should be a line
- starting with \texttt{PATH=} and followed by a list of directories separated
- 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:\"Program Files"\TeXLive\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
- environment variable. From this program, select the `Environment'
- tab, and then add or modify the variable you want. You will be asked to reboot the
- machine upon any change.
-\item[Windows NT/2K/XP]
- Click left on \guiseq{Start \arw Settings \arw Control Panel}. Now the
- window with the control panel icons opens. Double click on System. The
- System Properties window opens. Click on the tab \textsf{Environment}
- or look for a button named \guiseq{Environment Variables} among the
- dialog boxes. Now you can change the environment variables for your
- user account. Note: There are also displayed the environment settings
- for the system. Normally, you can't change the system variables
- unless you have administrator rights on your machine. If you want to
- change the \texttt{PATH} for all users, you will have to contact your
- system administrator or be the system administrator yourself\Dash in
- the latter case you should know what you are doing.
-
- If there is already a \texttt{PATH} setting for your user account,
- left click on \texttt{PATH}. In the field \textsf{Variable} appears
- \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:\Program Files\TeXLive\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
- the \textsf{Apply} button before clicking \textsf{Ok}, otherwise the
- changes to \texttt{PATH} won't apply to your system. Be careful when
- changing the environment settings.
-\end{description}
-
-The best way to be sure that a variable has been properly set is to
-open a console and type:
-\begin{verbatim}
-set VARIABLE
-\end{verbatim}
-which should return the corresponding value.
-
-\subsubsection{\TeX{} engines}
-
-If you have a look at the \Webc{} documentation, you will read that all
-the various \TeX{} derived programs use the same base engine. For
-example, \path|tex.exe| and \path|latex.exe| are exact copies of the
-same program, but each one will use a different format file, based on
-its calling name.
-
-Under Unix, this feature is implemented through \emph{symbolic
-links}. It saves up a bit of disk space, because some engines are
-used with many different format files.
-
-The Win32 API does not know about file links. So to save up almost
-the same amount of memory, all the \TeX{} base engines have been put
-in DLLs (\emph{Dynamic Linked Library}). This means that you will have
-the following layout:
-\begin{alltt}
-13/05/2002 17:06 3 584 latex.exe
-13/05/2002 17:06 266 240 tex.dll
-13/05/2002 17:06 3 584 tex.exe
-\end{alltt}
-and the \path|latex.exe| file is nothing but a rough copy of
-\path|tex.exe| using the same core \path|tex.dll|.
-The same trick has been used for the \path|mktex*.exe| family of programs which are
-linked to the \path|mktex.dll| library.
-
-In fact, a generic tool called \path|lnexe.exe| is provided to build the
-equivalent of Unix hard links for executable files only under Win32.
-
-\subsection{In case of problems}
-\label{sec:troubleshooting}
-
-\subsubsection{What to do if \texttt{latex} does not find your files?}
-
-\begin{itemize}
-
-\item \cmdname{kpsewhich} is the tool of choice to debug any
-problem. Unfortunately, \cmdname{kpsewhich} outputs debug information
-to stderr, and the Windows console does not know how to redirect stderr
-to a file\footnote{Well, NT and Win2k consoles know how to do that. But
-the trick will work for any console.}. For diagnostic purposes you can
-temporarily set an environment variable (in a \acro{DOS} box):
-
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=err.log
-\end{verbatim}
-You can also set the debug level:
-\begin{verbatim}
-SET KPATHSEA_DEBUG=-1
-\end{verbatim}
-
-If you want to redirect stderr to stdout, which is not possible
-Windows, then do:
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=con:
-\end{verbatim}
-This way you can capture both stdout and stderr in the same file.
-
-\item Assuming the installation has been done in \path|c:/Program Files/TeXLive|, check
- the following values: \\
- {\small
- \begin{tabular}{ll}
- \path|kpsewhich -expand-path $SELFAUTOPARENT| & \path|c:/Program Files/TeXLive| \\
- \path|kpsewhich -expand-path $TEXMF| & \path|c:/Program Files/TeXLive/texmf| \\
- \path|kpsewhich -expand-path $TEXMFCNF| &
- \path|.;c:/Program Files/TeXLive/texmf/web2c;| \\
- & \path|c:/Program Files/TeXLive/bin/win32;| \\
- & \path|c:/Program Files/TeXLive/bin;| \\
- & \path|c:/Program Files/TeXLive| \\
- \path|kpsewhich -expand-var $TEXINPUTS| & \path|.;c:/Program Files/TeXLive/texmf/tex//|
- \end{tabular}
-}
-\item If you have other \TeX{}-related values already set in your
- environment, please, remove them. They are overriding the ones in
- texmf.cnf.
-\item Check the values from:\\
-{\small
- \begin{tabular}{ll}
- \texttt{kpsewhich cmr10.tfm} & \path|c:/Program Files/TeXLive/texmf/fonts/tfm/public/cm/cmr10.tfm|\\
- \texttt{kpsewhich latex.fmt}& \path|c:/Program Files/TeXLive/texmf/web2c/latex.fmt|
- \end{tabular}
-}
-\item At this point, if everything is correct, \TeX{} and friends
- should work. If it is not the case, you will need to play with
- the \path|-debug=n| option from \path|kpsewhich|, and check back all
- the values. Try to identify and report the problem.
-\end{itemize}
-
-\subsubsection{What to do if your setup still does not work as expected?}
-
-Here are several questions to investigate:
-
-\begin{enumerate}
-\item Is \file{tex.exe} in my \path|PATH|?
-
-\item Is the \path|TEXMFCNF| variable correctly set to
-\path|c:/Program Files/TeXLive/texmf-var/web2c| (default value)?
-
-\item Are there any errors in the log file generated by the
-\file{TeXSetup.exe} program? You can find this by searching for the
-string \samp{Error}.
-
-\item Are there any relevant bug fixes at \url{http://tug.org/texlive/}?
-(Unlikely, but it doesn't hurt to check.)
-
-\item Check the web pages at
-\url{http://www.fptex.org/}, or consider subscribing to the \fpTeX{}
-mailing list, via \url{http://tug.org/mailman/listinfo/fptex}.
-
-\end{enumerate}
-
-
-The \TeXLive{} software consists of hundreds and programs and tens of
-thousands of files, all from varying sources. So it is quite difficult to
-predict all possible causes for problems. Nevertheless, we will do our
-best to help you. (see section~\ref{sec:help} on p.~\pageref{sec:help}.)
-
-
-\subsection{Compiling the source files}
-
-You have the whole set of source files, in the
-\path|source/source.tar.bz2| archive available in the distribution together with
-a patch file for Win32. To
-be able to compile the whole distribution for Windows, you will need:
-
-\begin{itemize}
-\item Windows 2K/XP
-\item Microsoft Visual Studio .Net 2003
-\item a set of Unix tools (\texttt{sed},
- \texttt{grep}, \texttt{gawk}, etc.) and also Perl, Flex and Bison,
-\item to adjust the paths in the
- \path|win32/make/common.mak| file according to your installation
-\item to adjust the paths in the Perl script file
- \path|win32/perl/build.pl|,
-\item run the compilation from the \path|mswin32/| directory using this
- command:
-\begin{verbatim}
-c:\texlive\source\mswin32>perl ./perl/build.pl --install --log=install.log
-\end{verbatim}
-\end{itemize}
-
-There is a lot of work to do to make this process easier and cleaner.
-
-\subsection{Where to get more information}
-
-The Windows \TeX{} system included on \TeXLive{} is also known as
-\fpTeX. The packaging differs, but \fpTeX{} is no more no less than the
-current \TeXLive\ release for Windows.
-
-The \fpTeX{} home page is \url{http://www.fptex.org}.
-
-The current \fpTeX release is available from any \CTAN site in
-\url{htp://www.ctan.org/tex-archive/systems/win32/fptex}.
-
-The main ftp site for \fpTeX\ is \url{ftp://ftp.dante.de/pub/fptex/}
-from where beta versions of \fpTeX\ and additionnal tools are available.
-This main site is (partially) mirrored daily by all \CTAN{} sites at
-\path|systems/win32/fptex|.
-
-The \TeX{} Users Group is kindly hosting a mailing list dedicated to
-\fpTeX. It is used for announcements, bug reports, enhancement requests,
-and general discussion about \fpTeX. To subscribe, visit
-\url{http://tug.org/mailman/listinfo/fptex}. The mailing list
-address is \email{fptex@tug.org}.
-
-
-\section{A user's guide to \protect\Webc{}}
-
-\Webc{} is an integrated collection of \TeX-related programs: \TeX{}
-itself, \MF{}, \MP, \BibTeX{}, etc. It is the heart of \TeXLive{}.
-
-A bit of history: The original implementation was by Tomas Rokicki who,
-in 1987, developed a first \TeX{}-to-C system adapting change files
-under Unix, which were primarily the work of Howard Trickey and Pavel
-Curtis. Tim Morgan became the maintainer of the system, and during this
-period the name changed to Web-to-C\@. In 1990, Karl Berry took over
-the work, assisted by dozens of additional contributors, and in 1997 he
-handed the baton to Olaf Weber.
-
-The \Webc{} system runs on Unix, 32-bit Windows systems, \MacOSX{}, and
-other operating systems. It uses Knuth's original sources for \TeX{} and
-other basic programs written in \web{} and translates them into C source
-code. The core \TeX{} programs are:
-
-\begin{cmddescription}
-\item[bibtex] Maintaining bibliographies.
-\item[dmp] \cmdname{troff} to MPX (\MP{} pictures).
-\item[dvicopy] Expands virtual font references in \dvi{} files.
-\item[dvitomp] \dvi{} to MPX (MetaPost pictures).
-\item[dvitype] \dvi{} to human-readable text.
-\item[gftodvi] Generic font proofsheets.
-\item[gftopk] Generic to packed fonts.
-\item[gftype] GF to human-readable text.
-\item[makempx] \MP{} label typesetting.
-\item[mf] Creating typeface families.
-\item[mft] Prettyprinting \MF{} source.
-\item[mpost] Creating technical diagrams.
-\item[mpto] MetaPost label extraction.
-\item[newer] Compare modification times.
-\item[patgen] Creating hyphenation patterns.
-\item[pktogf] Packed to generic fonts.
-\item[pktype] PK to human-readable text.
-\item[pltotf] Plain text property list to TFM.
-\item[pooltype] Display \web{} pool files.
-\item[tangle] \web{} to Pascal.
-\item[tex] Typesetting.
-\item[tftopl] TFM to plain text property list.
-\item[vftovp] Virtual font to virtual property list.
-\item[vptovf] Virtual property list to virtual font.
-\item[weave] \web{} to \TeX.
-\end{cmddescription}
-
-\noindent The precise functions and syntax of these programs are
-described in the documentation of the individual packages and of \Webc{}
-itself. However, knowing a few principles governing the whole family of
-programs will help you take advantage of your \Webc{} installation.
-
-All programs honor these standard \acro{GNU} options:
-\begin{ttdescription}
-\item[-{}-help] print basic usage summary.
-\item[-{}-verbose] print detailed progress report.
-\item[-{}-version] print version information, then exit.
-\end{ttdescription}
-
-For locating files the \Webc{} programs use the path searching library
-\KPS{}. This library uses a combination of environment variables and a
-configuration files to optimize searching the (huge) collection of
-\TeX{} files. \Webc{} can look at more than one directory tree
-simultaneously, which is useful in maintaining \TeX's standard
-distribution and local extensions in two distinct trees. To speed up
-file searches the root of each tree has a file \file{ls-R}, containing
-an entry showing the name and relative pathname for all files under that
-root.
-
-\subsection{\protect\KPS\ path searching}
-
-Let us first describe the generic path searching mechanism of the \KPS{}
-library.
-
-We call a \emph{search path} a colon- or semicolon\hyph sepa\-rated list
-of \emph{path elements}, which are basically directory names. A
-search path can come from (a combination of) many sources. To look up
-a file \samp{my-file} along a path \samp{.:/dir}, \KPS{} checks each
-element of the path in turn: first \file{./my-file}, then
-\file{/dir/my-file}, returning the first match (or possibly all
-matches).
-
-In order to adapt optimally to all operating systems' conventions, on
-non-Unix systems \KPS{} can use filename separators different from
-colon (\samp{:}) and slash (\samp{/}).
-
-To check a particular path element \var{p}, \KPS{} first checks if a
-prebuilt database (see ``Filename data\-base'' on
-page~\pageref{Filename-database}) applies to \var{p}, i.e., if the database
-is in a directory that is a prefix of \var{p}. If so, the path
-specification is matched against the contents of the database.
-
-If the database does not exist, or does not apply to this path
-element, or contains no matches, the filesystem is searched (if this
-was not forbidden by a specification starting with \samp{!!}\ and if
-the file being searched for must exist). \KPS{} constructs the list
-of directories that correspond to this path element, and then checks
-in each for the file being sought.
-
-The ``file must exist'' condition comes into play with \samp{.vf} files and
-input files read by \TeX's \cs{openin} command. Such files may not
-exist (e.g., \file{cmr10.vf}), and so it would be wrong to search the
-disk for them. Therefore, if you fail to update \file{ls-R} when you
-install a new \samp{.vf} file, it will never be found.
-Each path element is checked in turn: first the database, then the
-disk. If a match is found, the search stops and the result is
-returned.
-
-Although the simplest and most common path element is a directory
-name, \KPS{} supports additional features in search paths: layered
-default values, environment variable names, config file values, users'
-home directories, and recursive subdirectory searching. Thus, we say
-that \KPS{} \emph{expands} a path element, meaning it transforms all
-the specifications into basic directory name or names. This is
-described in the following sections in the same order as it takes
-place.
-
-Note that if the filename being searched for is absolute or explicitly
-relative, i.e., starts with \samp{/} or \samp{./} or \samp{../},
-\KPS{} simply checks if that file exists.
-
-\ifSingleColumn
-\else
-\begin{figure*}
-\verbatiminput{../examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{An illustrative configuration file sample}
- \label{fig:config-sample}
-\end{figure*}
-\fi
-
-\subsubsection{Path sources}
-\label{Path-sources}
-
-A search path can come from many sources. In the order in which
-\KPS{} uses them:
-
-\begin{enumerate}
-\item
- A user-set environment variable, for instance, \envname{TEXINPUTS}\@.
- Environment variables with a period and a program name appended
- override; e.g., if \samp{latex} is the name of the program being run,
- then \envname{TEXINPUTS.latex} will override \envname{TEXINPUTS}.
-\item
- A program-specific configuration file, for exam\-ple, a line
- \samp{S /a:/b} in \cmdname{dvips}'s \file{config.ps}.
-\item A \KPS{} configuration file \file{texmf.cnf}, containing a line like
- \samp{TEXINPUTS=/c:/d} (see below).
-\item The compile-time default.
-\end{enumerate}
-\noindent You can see each of these values for a given
-search path by using the debugging options (see ``Debugging actions''
-on page~\pageref{Debugging}).
-
-\subsubsection{Config files}
-
-\begingroup\tolerance=3500
-\KPS{} reads \emph{runtime configuration files} named \file{texmf.cnf}
-for search path and other definitions. The search path used to look
-for these files is named \envname{TEXMFCNF} (by default such a file lives
-in the \file{texmf/web2c} subdirectory). \emph{All}
-\file{texmf.cnf} files in the search path will be read and definitions
-in earlier files override those in later files. Thus, with a search
-path of \verb|.:$TEXMF|, values from \file{./texmf.cnf} override those
-from \verb|$TEXMF/texmf.cnf|.
-\endgroup
-
-\begin{itemize}
-\item
- Comments start with \code{\%} and continue to the end of the line.
-\item
- Blank lines are ignored.
-\item
- A \bs{} at the end of a line acts as a continuation character,
- i.e., the next line is appended. Whitespace at the beginning of
- continuation lines is not ignored.
-\item
- Each remaining line has the form:
-\begin{alltt}
- \emph{variable}[.\emph{progname}] [=] \emph{value}
-\end{alltt}%
- where the \samp{=} and surrounding whitespace are optional.
-\item
- The \ttvar{variable} name may contain any character other
- than whitespace, \samp{=}, or \samp{.}, but sticking to
- \samp{A-Za-z\_} is safest.
-\item
- If \samp{.\var{progname}} is present, the definition only
- applies if the program that is running is named
- \texttt{\var{progname}} or \texttt{\var{progname}.exe}. This allows
- different flavors of \TeX{} to have different search paths, for
- example.
-\item \var{value} may contain any characters except
- \code{\%} and \samp{@}. The
- \code{\$\var{var}.\var{prog}} feature is not available on the
- right-hand side; instead, you must use an additional variable. A
- \samp{;}\ in \var{value} is translated to \samp{:}\ if
- running under Unix; this is useful to be able to have a single
- \file{texmf.cnf} for Unix, \acro{MS-DOS} and Windows systems.
-\item
- All definitions are read before anything is expanded, so
- variables can be referenced before they are defined.
-\end{itemize}
-A configuration file fragment illustrating most of these points is
-\ifSingleColumn
-shown below:
-
-\verbatiminput{../examples/ex5.tex}
-\else
-shown in Figure~\ref{fig:config-sample}.
-\fi
-
-\subsubsection{Path expansion}
-\label{Path-expansion}
-
-
-\KPS{} recognizes certain special characters and constructions in
-search paths, similar to those available in Unix shells. As a
-general example, the complex path,
-\verb+~$USER/{foo,bar}//baz+, expands to all subdirectories under
-directories \file{foo} and \file{bar} in \texttt{\$USER}'s home
-directory that contain a directory or file \file{baz}. These
-expansions are explained in the sections below.
-%$
-\subsubsection{Default expansion}
-\label{Default-expansion}
-
-\tolerance=2500
-If the highest-priority search path (see ``Path sources'' on
-page~\pageref{Path-sources}) contains an \emph{extra colon} (i.e.,
-leading, trailing, or doubled), \KPS{} inserts at that point the
-next-highest-prio\-rity search path that is defined. If that inserted
-path has an extra colon, the same happens with the next highest. For
-example, given an environment variable setting
-
-\tolerance=1500
-
-\begin{alltt}
-> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
-and a \code{TEXINPUTS} value from \file{texmf.cnf} of
-
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
-then the final value used for searching will be:
-
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-
-Since it would be useless to insert the default value in more than one
-place, \KPS{} changes only one extra \samp{:}\ and leaves any others in
-place: it checks first for a leading \samp{:}, then a trailing
-\samp{:}, then a doubled \samp{:}.
-
-\subsubsection{Brace expansion}
-
-A useful feature is brace expansion, which means that, for instance,
-\verb+v{a,b}w+ expands to \verb+vaw:vbw+. Nesting is allowed.
-This can be used to implement multiple \TeX{} hierarchies, by
-assigning a brace list to \code{\$TEXMF}.
-For example, in \file{texmf.cnf}, you find
-the following definition:
-\begin{verbatim}
- TEXMF = {$HOMETEXMF,$TEXMFLOCAL,!!$VARTEXMF,!!$TEXMFMAIN}
-\end{verbatim}
-Using this you can then write something like
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-%$
-which means that, after looking in the current directory, the
-\code{\$HOMETEXMF/tex}, \code{\$TEXMFLOCAL/tex}, \code{\$VARTEXMF/tex}
-and \code{\$TEXMFMAIN/tex} trees \emph{only}) will be searched (the
-last two use using \file{ls-R} data base files). It is a convenient
-way for running two parallel \TeX{} structures, one ``frozen'' (on a
-\CD, for instance) and the other being continuously updated with new
-versions as they become available. By using the \code{\$TEXMF}
-variable in all definitions, one is sure to always search the
-up-to-date tree first.
-
-\subsubsection{Subdirectory expansion}
-\label{Subdirectory-expansion}
-
-Two or more consecutive slashes in a path element following a directory
-\var{d} is replaced by all subdirectories of \var{d}: first those
-subdirectories directly under \var{d}, then the subsubdirectories under
-those, and so on. At each level, the order in which the directories are
-searched is \emph{unspecified}.
-
-If you specify any filename components after the \samp{//}, only
-subdirectories with matching components are included. For example,
-\samp{/a//b} expands into directories \file{/a/1/b}, \file{/a/2/b},
-\file{/a/1/1/b}, and so on, but not \file{/a/b/c} or \file{/a/1}.
-
-Multiple \samp{//} constructs in a path are possible, but
-\samp{//} at the beginning of a path is ignored.
-
-\subsubsection{List of special characters and their meaning: a summary}
-
-The following list summarises the meaning of special characters
-in \KPS{} configuration files.
-
-\newcommand{\CODE}[1]{\makebox[2.5em][l]{\code{#1}}}
-\begin{ttdescription}
-\item[\CODE{:}] Separator in path specification; at the beginning or
- the end of a path it substitutes the default path expansion.
-\item[\CODE{;}] Separator on non-Unix systems (acts like \code{:}).
-\item[\CODE{\$}] Variable expansion.
-\item[\CODE{\string~}] Represents the user's home directory.
-\item[\CODE{\char`\{\dots\char`\}}] Brace expansion.
-\item[\CODE{//}] Subdirectory expansion (can occur anywhere in
- a path, except at its beginning).
-\item[\CODE{\%}] Start of comment.
-\item[\CODE{\bs}] Continuation character (allows multi-line entries).
-\item[\CODE{!!}] Search \emph{only} database to locate file, \emph{do
- not} search the disk.
-\end{ttdescription}
-
-
-\subsection{Filename databases}
-\label{Filename-database}
-
-\KPS{} goes to some lengths to minimize disk accesses for searches.
-Nevertheless, at installations with enough directories, searching each
-possible directory for a given file can take an excessively long time
-(this is especially true if many hundreds of font directories have to
-be traversed.) Therefore, \KPS{} can use an externally-built plain text
-``database'' file named \file{ls-R} that maps files to directories,
-thus avoiding the need to exhaustively search the disk.
-
-A second database file \file{aliases} allows you to give additional
-names to the files listed in \file{ls-R}. This can be helpful to
-confirm to \acro{DOS} 8.3 filename conventions in source files.
-
-\subsubsection{The filename database}
-\label{ls-R}
-
-As explained above, the name of the main filename database must be
-\file{ls-R}. You can put one at the root of each \TeX{} hierarchy in
-your installation that you wish to be searched (\code{\$TEXMF} by
-default); most sites have only one hierarchy. \KPS{} looks for
-\file{ls-R} files along the \code{TEXMFDBS} path.
-
-The recommended way to create and maintain \samp{ls-R} is to run the
-\code{mktexlsr} script included with the distribution. It is invoked
-by the various \samp{mktex}\dots\ scripts. In principle, this script
-just runs the command
-\begin{alltt}
-cd \var{/your/texmf/root} && ls -LAR ./ >ls-R
-\end{alltt}
-presuming your system's \code{ls} produces the right output format
-(\acro{GNU}'s \code{ls} is all right). To ensure that the database is always
-up-to-date, it is easiest to rebuild it regularly via \code{cron}, so
-that for changes in the installed files\Dash perhaps after installing or
-updating a \LaTeX{} package\Dash the file \file{ls-R} is automatically
-updated.
-
-If a file is not found in the database, by default \KPS{} goes ahead
-and searches the disk. If a particular path element begins with
-\samp{!!}, however, \emph{only} the database will be searched for that
-element, never the disk.
-
-
-\subsubsection{kpsewhich: Standalone path searching}
-\label{Invoking-kpsewhich}
-
-The \texttt{kpsewhich} program exercises path searching independent of any
-particular application. This can be useful as a sort of \code{find}
-program to locate files in \TeX{} hierarchies (this is used heavily in
-the distributed \samp{mktex}\dots\ scripts).
-
-\begin{alltt}
-> \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}}
-\end{alltt}
-The options specified in \ttvar{option} start with either \samp{-}
-or \samp{-{}-}, and any unambiguous abbreviation is accepted.
-
-\KPS{} looks up each non-option argument on the command line as a
-filename, and returns the first file found. There is no option to
-return all the files with a particular name (you can run the Unix
-\samp{find} utility for that).
-
-The more important options are described next.
-
-\begin{ttdescription}
-\item[\texttt{-{}-dpi=\var{num}}]\mbox{}
- Set the resolution to \ttvar{num}; this only affects \samp{gf}
- and \samp{pk} lookups. \samp{-D} is a synonym, for compatibility
- with \cmdname{dvips}. Default is 600.
-
-\item[\texttt{-{}-format=\var{name}}]\mbox{}\\
- Set the format for lookup to \ttvar{name}. By default, the
- format is guessed from the filename. For formats which do not have
- an associated unambiguous suffix, such as \MP{} support files and
- \cmdname{dvips} configuration files, you have to specify the name as
- found in the first column of Table~\ref{tab:kpathsea}, which lists
- currently recognized names, a description, possible file extensions,
- and associated environment variables.
-\end{ttdescription}
-
-
-\def\KpathKey#1#2#3#4#5{% name, number, description, variables,
- % suffixes
-\SetRowColor#1 & #3 & #4 & #5\\}
-\def\HEAD#1{\multicolumn{1}{l}{\emph{#1}}}
-%
-\begin{small}
-% a footnoterule immediately under a bottom-of-page rule looks dead
-% silly, so we suppress it
-\renewcommand\footnoterule{\relax}
-%
-\begin{longtable}{@{}%
- >{\ttfamily}P{.16\textwidth}% Col.1
- P{.3\textwidth}% Col 2
- >{\ttfamily\footnotesize}P{.29\textwidth}% Col 3
- >{\ttfamily}P{.14\textwidth}% Col 4
-@{}}
-\caption{Kpathsea file types.}\label{tab:kpathsea}\\
-\emph{Name} & \HEAD{Description} & \HEAD{Variables}
-& \HEAD{Suffixes}\\
-\hline
-\endfirsthead
-\multicolumn{3}{l}{Kpathsea file types \emph{continued}}\\
-\emph{Name} & \HEAD{Description} & \HEAD{Variables}
-& \HEAD{Suffixes}\\
-\hline
-\noalign{\vspace{2pt}}
-\endhead
-\mbox{}\\
-\hline
-\endfoot
-\KpathKey
- {afm}
- {4}
- {Adobe font metrics}
- {AFMFONTS}
- {.afm}
-\KpathKey
- {base}
- {5}
- {Metafont memory dump}
- {MFBASES, TEXMFINI}
- {.base}
-\KpathKey
- {bib}
- {6}
- {\BibTeX{} bibliography source}
- {BIBINPUTS, TEXBIB}
- {.bib}
-\KpathKey
- {}
- {2}
- {bitmap fonts}
- {GLYPHFONTS, TEXFONTS}
- {}
-\KpathKey
- {bst}
- {7}
- {\BibTeX{} style files}
- {BSTINPUTS}
- {.bst}
-\KpathKey
- {cnf}
- {8}
- {Runtime configuration files}
- {TEXMFCNF}
- {.cnf}
-\KpathKey
- {dvips config}
- {34}
- {\textsf{dvips} configuration files, e.g., \file{config.ps}
- and \file{psfonts.map}}
- {TEXCONFIG}
- {.map}
-\KpathKey
- {fmt}
- {10}
- {\TeX{} memory dump}
- {TEXFORMATS, TEXMFINI}
- {.fmt, .efmt, .efm}
-\KpathKey
- {gf}
- {0}
- {generic font bitmap}
- {GFFONTS}
- {.gf}
-\KpathKey
- {graphic/figure}
- {25}
- {Encapsulated \PS{} figures}
- {TEXPICTS, TEXINPUTS}
- {.eps, .epsi}
-\KpathKey
- {ist}
- {35}
- {\textsf{makeindex} style files}
- {TEXINDEXSTYLE, INDEXSTYLE}
- {.ist}
-\KpathKey
- {ls-R}
- {9}
- {Filename databases}
- {TEXMFDBS}
- {}
-\KpathKey
- {map}
- {11}
- {Fontmaps}
- {TEXFONTMAPS}
- {.map}
-\KpathKey
- {mem}
- {12}
- {MetaPost memory dump}
- {MPMEMS, TEXMFINI}
- {.mem}
-\KpathKey
- {mf}
- {13}
- {Metafont source}
- {MFINPUTS}
- {.mf}
-\KpathKey
- {mfpool}
- {14}
- {Metafont program strings}
- {MFPOOL, TEXMFINI}
- {.pool}
-\KpathKey
- {mft}
- {15}
- {MFT style file}
- {MFTINPUTS}
- {.mft}
-\KpathKey
- {}
- {41}
- {miscellaneous fonts}
- {MISCFONTS}
- {}
-\KpathKey
- {mp}
- {16}
- {MetaPost source}
- {MPINPUTS}
- {.mp}
-\KpathKey
- {mppool}
- {17}
- {MetaPost program strings}
- {MPPOOL, TEXMFINI}
- {.pool}
-\KpathKey
- {MetaPost support}
- {18}
- {MetaPost support files, used by DMP}
- {MPSUPPORT}
- {}
-\KpathKey
- {ocp}
- {19}
- {\OMEGA{} compiled process files}
- {OCPINPUTS}
- {.ocp}
-\KpathKey
- {ofm}
- {20}
- {\OMEGA{} font metrics}
- {OFMFONTS, TEXFONTS}
- {.ofm, .tfm}
-\KpathKey
- {opl}
- {21}
- {\OMEGA{} property lists}
- {OPLFONTS, TEXFONTS}
- {.opl}
-\KpathKey
- {otp}
- {22}
- {\OMEGA{} translation process files}
- {OTPINPUTS}
- {.otp}
-\KpathKey
- {ovf}
- {23}
- {\OMEGA{} virtual fonts}
- {OVFFONTS, TEXFONTS}
- {.ovf}
-\KpathKey
- {ovp}
- {24}
- {\OMEGA{} virtual property lists}
- {OVPFONTS, TEXFONTS}
- {.ovp}
-\KpathKey
- {pk}
- {1}
- {packed bitmap fonts}
- {\emph{program}FONTS \textrm{(\texttt{\emph{program}} being
- \textsmaller{\cmdname{XDVI}},
- etc.)}, PKFONTS, TEXPKS, GLYPHFONTS, TEXFONTS}
- {.pk}
-\KpathKey
- {\PS{} header}
- {30}
- {downloadable \PS{}}
- {TEXPSHEADERS, PSHEADERS}
- {.pro, .enc}
-\KpathKey
- {tex}
- {26}
- {\TeX{} source}
- {TEXINPUTS}
- {.tex, .cls, .sty, .clo, .def}
-\KpathKey
- {TeX system documentation}
- {27}
- {Documentation files for the \TeX{} system}
- {TEXDOCS}
- {}
-\KpathKey
- {TeX system sources}
- {29}
- {Source files for the \TeX{} system}
- {TEXSOURCES}
- {}
-\KpathKey
- {texpool}
- {28}
- {\TeX{} program strings}
- {TEXPOOL, TEXMFINI}
- {.pool}
-\KpathKey
- {tfm}
- {3}
- {\TeX{} font metrics}
- {TFMFONTS, TEXFONTS}
- {.tfm}
-\KpathKey
- {Troff fonts}
- {31}
- {Troff fonts, used by DMP}
- {TRFONTS}
- {}
-\KpathKey
- {truetype fonts}
- {36}
- {TrueType outline fonts}
- {TTFONTS}
- {.ttf, .ttc}
-\KpathKey
- {Type~1 fonts}
- {32}
- {Type 1 \PS{} outline fonts}
- {T1FONTS, T1INPUTS, TEXPSHEADERS, DVIPSHEADERS}
- {.pfa, .pfb}
-\KpathKey
- {type42 fonts}
- {37}
- {Type 42 \PS{} outline fonts}
- {T42FONTS}
- {}
-\KpathKey
- {vf}
- {33}
- {virtual fonts}
- {VFFONTS, TEXFONTS}
- {.vf}
-\KpathKey
- {web2c files}
- {38}
- {\Webc{} support files}
- {WEB2C}
- {}
-\KpathKey
- {other text files}
- {39}
- {text files used by `\textsf{foo}'}
- {FOOINPUTS}
- {}
-\KpathKey
- {other binary files}
- {40}
- {binary files used by `\textsf{foo}'}
- {FOOINPUTS}
- {}
-\end{longtable}
-\end{small}
-
-
-\begin{multicols}{2}
-
- The last two entries in Table~\ref{tab:kpathsea} are special
- cases, where the paths and environment variables depend on the name
- of the program: the variable name is constructed by converting the
- program name to upper case, and then appending \texttt{INPUTS}.
-
- The environment variables are set by default in the configuration
- file \file{texmf.cnf}. It is only when you want to override one or
- more of the values specified in that file that you might want to set
- them explicitly in your execution environment.
-
- The \samp{-{}-format} and \samp{-{}-path} options are mutually
- exclusive.
-
-\begin{ttdescription}
-
-\item[\texttt{-{}-mode=\var{string}}]\mbox{}\\
- Set the mode name to \ttvar{string}; this only affects \samp{gf}
- and \samp{pk} lookups. No default: any mode will be found.
-\item[\texttt{-{}-must-exist}]\mbox{}\\
- Do everything possible to find the files, notably including
- searching the disk. By default, only the \file{ls-R} database is
- checked, in the interest of efficiency.
-\item[\texttt{-{}-path=\var{string}}]\mbox{}\\
- Search along the path \ttvar{string} (colon-separated as usual),
- instead of guessing the search path from the filename. \samp{//} and
- all the usual expansions are supported. The options \samp{-{}-path}
- and \samp{-{}-format} are mutually exclusive.
-\item[\texttt{-{}-progname=\var{name}}]\mbox{}\\
- Set the program name to \texttt{\var{name}}.
- This can affect the search paths via the \texttt{.\var{progname}}
- feature.
- The default is \cmdname{kpsewhich}.
-\item[\texttt{-{}-show-path=\var{name}}]\mbox{}\\
- shows the path used for file lookups of file type \texttt{\var{name}}.
- Either a filename extension (\code{.pk}, \code{.vf}, etc.) or a
- name can be used, just as with \samp{-{}-format} option.
-\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\
- sets the debugging options to \texttt{\var{num}}.
-\end{ttdescription}
-
-
-\subsubsection{Examples of use}
-\label{SExamplesofuse}
-
-Let us now have a look at \KPS{} in action. Here's a straightforward search:
-
-\begin{alltt}
-> \Ucom{kpsewhich article.cls}
-/usr/local/texmf/tex/latex/base/article.cls
-\end{alltt}
-We are looking for the file \file{article.cls}. Since the \samp{.cls}
-suffix is unambiguous we do not need to specify that we want to look for a
-file of type \optname{tex} (\TeX{} source file directories). We find it in
-the subdirectory \file{tex/latex/base} below the \samp{TEXMF} root
-directory. Similarly, all of the following are found without problems
-thanks to their unambiguous suffix.
-\begin{alltt}
-> \Ucom{kpsewhich array.sty}
- /usr/local/texmf/tex/latex/tools/array.sty
-> \Ucom{kpsewhich latin1.def}
- /usr/local/texmf/tex/latex/base/latin1.def
-> \Ucom{kpsewhich size10.clo}
- /usr/local/texmf/tex/latex/base/size10.clo
-> \Ucom{kpsewhich small2e.tex}
- /usr/local/texmf/tex/latex/base/small2e.tex
-> \Ucom{kpsewhich tugboat.bib}
- /usr/local/texmf/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-The latter is a \BibTeX{} bibliography database for \textsl{TUGBoat} articles.
-
-\begin{alltt}
-> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
-Font bitmap glyph files of type \file{.pk} are used by display
-programs like \cmdname{dvips} and \cmdname{xdvi}. Nothing is returned in
-this case since there are no pre-generated Computer Modern \samp{.pk}
-files on our system (since we use the Type~1 versions included in \TeXLive{}).
-\begin{alltt}
-> \Ucom{kpsewhich ecrm1000.pk}
-\ifSingleColumn /usr/local/texmf/fonts/pk/ljfour/jknappen/ec/ecrm1000.600pk
-\else
-/usr/local/texmf/fonts/pk/ljfour/jknappen/
-... ec/ecrm1000.600pk
-\fi\end{alltt}
-For the extended Computer Modern files we had to generate \samp{.pk}
-files, and since the default \MF{} mode on our installation is
-\texttt{ljfour} with a base resolution of 600\dpi{} (dots per inch),
-this instantiation is returned.
-\begin{alltt}
-> \Ucom{kpsewhich -dpi=300 ecrm1000.pk}
-\end{alltt}
-In this case, when specifying that we are interested in a resolution
-of 300\dpi{} (\texttt{-dpi=300}) we see that no such font is available on
-the system. In fact, a program like \cmdname{dvips} or \cmdname{xdvi} would
-go off and actually build the \texttt{.pk} files at the required
-resolution using the script \cmdname{mktexpk}.
-
-Next we turn our attention to \cmdname{dvips}'s header and configuration
-files. We first look at one of the commonly used files, the general
-prolog \file{tex.pro} for \TeX{} support, before turning our attention
-to the generic configuration file (\file{config.ps}) and the
-\PS{} font map \file{psfonts.map}. As the \samp{.ps} suffix is
-ambiguous we have to specify explicitly which type we are considering
-(\optname{dvips config}) for the file \texttt{config.ps}.
-\begin{alltt}
-> \Ucom{kpsewhich tex.pro}
- /usr/local/texmf/dvips/base/tex.pro
-> \Ucom{kpsewhich --format="dvips config" config.ps}
- /usr/local/texmf/config/config.ps
-> \Ucom{kpsewhich psfonts.map}
- /usr/local/texmf/dvips/base/psfonts.map
-\end{alltt}
-
-We now take a closer look at the \acro{URW} Times \PS{} support
-files. The prefix for these in the standard font naming scheme is
-\samp{utm}. The first file we look at is the configuration file,
-which contains the name of the map file:
-\begin{alltt}
-> \Ucom{kpsewhich --format="dvips config" config.utm}
-/usr/local/texmf/dvips/psnfss/config.utm
-\end{alltt}
-The contents of that file is
-\begin{alltt}
- p +utm.map
-\end{alltt}
-which points to the file \file{utm.map}, which we want to
-locate next.
-\begin{alltt}
-> \Ucom{kpsewhich --format="dvips config" utm.map}
-/usr/local/texmf/dvips/psnfss/utm.map
-\end{alltt}
-This map file defines the file names of the Type~1 \PS{} fonts in
-the URW collection. Its contents look like (we only show part of the
-lines):
-\begin{alltt}
-utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
-utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
-utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
-Let us, for instance, take the Times Roman instance
-\file{utmr8a.pfb} and find its position in the \file{texmf} directory
-tree with a search for Type~1 font files:
-\begin{alltt}
-> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf/fonts/type1/urw/utm/utmr8a.pfb
-\else /usr/local/texmf/fonts/type1/
-...urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
-It should be evident from these few examples how you can easily locate
-the whereabouts of a given file. This is especially important if you
-suspect that the wrong version of a file is picked up somehow, since
-\cmdname{kpsewhich} will show you the first file encountered.
-
-\subsubsection{Debugging actions}
-\label{Debugging}
-
-Sometimes it is necessary to investigate how a program resolves file
-references. To make this practical, \KPS{} offers various levels of
-debugging output:
-
-\begin{ttdescription}
-\item[\texttt{\ 1}] \texttt{stat} calls (disk lookups). When running
- with an up-to-date \file{ls-R} database this should almost give no
- output.
-\item[\texttt{\ 2}] References to hash tables (such as the \file{ls-R}
- database, map files, configuration files).
-\item[\texttt{\ 4}] File open and close operations.
-\item[\texttt{\ 8}] General path information for file types
- searched by \KPS. This is useful to find out where a particular
- path for the file was defined.
-\item[\texttt{16}] Directory list for each path element (only relevant
- for searches on disk).
-\item[\texttt{32}] File searches.
-\end{ttdescription}
-A value of \texttt{-1} will set all the above options; in practice,
-this is usually the most convenient value touse.
-
-Similarly, with the \cmdname{dvips} program, by setting a combination of
-debug switches, one can follow in detail where files are being picked up
-from. Alternatively, when a file is not found, the debug trace shows in
-which directories the program looks for the given file, so that one can
-get an indication what the problem~is.
-
-Generally speaking, as most programs call the \KPS{} library
-internally, one can select a debug option by using the
-\envname{KPATHSEA\_DEBUG} environment variable, and setting it to (a
-combination of) values as described in the above list.
-
-(Note for Windows users: it is not easy to redirect
-all messages to a file in this system. For diagnostic purposes
-you can temporarily \texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log}).
-
-Let us consider, as an example, a small \LaTeX{} source file,
-\file{hello-world.tex}, which contains the following input.
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
-This little file only uses the font \file{cmr10}, so let us look
-how \cmdname{dvips} prepares the \PS{} file (we want to use the Type~1
-version of the Computer Modern fonts, hence the option \texttt{-Pcms}).
-\begin{alltt}
-> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
-In this case we have combined \cmdname{dvips}'s debug class 4 (font
-paths) with \KPS's path element expansion (see \cmdname{dvips} Reference
-Manual, \OnCD{texmf/doc/html/dvips/dvips_toc.html}).
-The output (slightly rearranged) appears in
-Figure~\ref{fig:dvipsdbga}.
-\begin{figure*}[tp]
-\centering
-\input{../examples/ex6a.tex}
-\caption{Finding configuration files}\label{fig:dvipsdbga}
-
-\bigskip
-
-\input{../examples/ex6b.tex}
-\caption{Finding the prolog file}\label{fig:dvipsdbgb}
-
-\bigskip
-
-\input{../examples/ex6c.tex}
-\caption{Finding the font file}\label{fig:dvipsdbgc}
-\end{figure*}
-
-\cmdname{dvips} starts by locating its working files. First,
-\file{texmf.cnf} is found, which gives the definitions of the search
-paths for the other files, then the file database \file{ls-R} (to
-optimize file searching) and the file \file{aliases}, which makes it
-possible to declare several names (e.g., a short \acro{DOS}-like 8.3 and
-a more natural longer version) for the same file. Then \cmdname{dvips}
-goes on to find the generic configuration file \file{config.ps}
-before looking for the customization file \file{.dvipsrc} (which, in
-this case is \emph{not found}). Finally, \cmdname{dvips} locates the
-config file for the Computer Modern \PS{} fonts \file{config.cms}
-(this was initiated with the \texttt{-Pcms} option on the \cmdname{dvips}
-command). This file contains the list of the map files which
-define the relation between the \TeX{}, \PS{} and file system
-names of the fonts.
-\begin{alltt}
-> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
- p +ams.map
- p +cms.map
- p +cmbkm.map
- p +amsbkm.map
-\end{alltt}
-\cmdname{dvips} thus goes on to find all these files, plus the generic
-map file \file{psfonts.map}, which is always loaded (it contains
-declarations for commonly used \PS{} fonts; see the last part of
-Section \ref{SExamplesofuse} for more details about \PS{} map
-file handling).
-
-At this point \cmdname{dvips} identifies itself to the user:
-\begin{alltt}
-This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com)
-\end{alltt}
-\ifSingleColumn
-Then it goes on to look for the prolog file \file{texc.pro}:
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
-Then it goes on to look for the prolog file \file{texc.pro} (see
-Figure~\ref{fig:dvipsdbgb}).
-\fi
-
-After having found the file in question, \cmdname{dvips} outputs
-date and time, and informs us that it will generate the
-file \file{hello-world.ps}, then that it needs the font file
-\file{cmr10}, and that the latter is declared as ``resident'' (no
-bitmaps needed):
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
-Now the search is on for the file \file{cmr10.tfm}, which is found,
-then a few more prolog files (not shown) are referenced, and finally
-the Type~1 instance \file{cmr10.pfb} of the font is located and
-included in the output file (see last line).
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-\subsection{Runtime options}
-
-Another useful feature of \Webc{} is its possibility to control a number
-of memory parameters (in particular, array sizes) via the runtime file
-\file{texmf.cnf} read by \KPS{}. The memory settings can be found in
-Part 3 of that file in the \TeXLive{} distribution. The more important
-are:
-
-\begin{ttdescription}
-\item[\texttt{main\_memory}]
- Total words of memory available, for
- \TeX{}, \MF{} and \MP. You must make a new format file for each
- different setting. For instance, you could generate a ``huge''
- version of \TeX{}, and call the format file \texttt{hugetex.fmt}.
- Using the standard way of specifying the program name used by \KPS{},
- the particular value of the \texttt{main\_memory} variable will then
- be read from \file{texmf.cnf} (compare the generic value
- and the huge one instantiated by \texttt{hugetex},
- etc.).
-\item[\texttt{extra\_mem\_bot}]
- Extra space for ``large'' \TeX{} data structures:
- boxes, glue, breakpoints, etc. Especially useful if you use
- \PiCTeX{}.
-\item[\texttt{font\_mem\_size}]
- Number of words for font information available for \TeX. This
- is more or less the total size of all TFM files read.
-\item[\texttt{hash\_extra}]
- Additional space for the hash table of control sequence names.
- Approximately 10,000 control sequences can be stored in the main
- hash table; if you have a large book with numerous cross-references,
- this might not be enough. You can see that both the
- \cmdname{hugetex} and \cmdname{pdflatex} program invocations ask for
- an extra 15,000 control sequences (the default value of
- \texttt{hash\_extra} is zero).
-\end{ttdescription}
-
-\noindent Of course, this facility is no substitute for truly dynamic
-arrays and memory allocation, but since this is extremely difficult to
-implement in the present \TeX{} source, these runtime parameters provide
-a practical compromise allowing some flexibility.
-
-
-\section{Building on a new Unix platform}
-
-If you have a platform for which we have not created executables, you
-will need to compile \TeX{} and friends from scratch. This is not as
-hard as it sounds. What you need is all in the directory \texttt{source}
-in the distribution.
-
-\subsection{Prerequisites}
-
-You will need at least 100 megabytes of disk space to compile all of
-\TeX{} and its support programs. You'll also need an \acro{ANSI} C
-compiler, a \cmdname{make} utility, a lexical scanner, and a parser
-generator. We recommend the \acro{GNU} version of these programs
-(\cmdname{gcc}, \acro{GNU} \cmdname{make}, \cmdname{m4}, \cmdname{flex},
-\cmdname{bison}). You may be able to work with other C compilers and
-\cmdname{make} programs, but you will need a good understanding of
-building Unix programs to sort out problems.
-
-Also, the command \texttt{uname} must return a sensible value.
-
-
-\subsection{Configuration}
-
-To begin, perform a normal installation of \TeXLive{} to your disk (see
-section~\ref{sec:unix-install-disk} on
-p.~\pageref{sec:unix-install-disk}). You may wish to skip installing
-any of the prebuilt binaries.
-
-Then, unpack the source from the compressed \texttt{tar} file in the
-directory \dirname{source} to your disk and change directory to where
-you placed it.
-
-Next, run \cmdname{configure} with a command line like this:
-\begin{alltt}
-> \Ucom{sh configure -prefix=/usr/local/TeX}
-\end{alltt}
-
-The \optname{-prefix} directory is the one where you installed the
-support tree; the directory layout will be as follows (where \$TEXDIR
-stands for the directory you chose):
-
-\noindent
-\begin{tabular}{>{\ttfamily}ll@{}}
- \dirname{$TEXDIR/share/texmf} & main tree with fonts,\\
- & \qquad macros, etc\\
- \dirname{$TEXDIR/man} & Unix manual pages\\
- \dirname{$TEXDIR/info} & \acro{GNU} style Info manuals\\
- \dirname{$TEXDIR/bin/$PLATFORM} & binaries\\
-\end{tabular}
-%$
-
-If you want to leave out the \dirname{$PLATFORM} directory level,
-i.e., put the binaries directly into \dirname{$TEXDIR/bin}, specify
-the \verb|--disable-multiplatform| option to \cmdname{configure}.
-
-Have a look at the output of \verb|./configure --help| for more
-options you can use. For example, you can skip building of \OMEGA{} and
-\eTeX{}.
-
-
-\subsection{Running \cmdname{make}}
-
-Make sure the shell variable or option \texttt{noclobber} is not set.
-Then, run the main \cmdname{make} like this:
-\begin{alltt}
-> \Ucom{make world}
-\end{alltt}
-and relax\ldots
-
-Alternatively, you want to log all the output, as in:
-\begin{alltt}
-> \Ucom{sh -c "make world >world.log 2>\&1" \&}
-\end{alltt}
-
-Before you believe that everything went ok, please check the log file
-for errors: \acro{GNU} \cmdname{make} always uses the string \samp{***}
-whenever a command fails. Also, check if all the programs were built:
-
-\begin{alltt}
-> \Ucom{cd \emph{TEXDIR}/bin/\emph{archname}}
-> \Ucom{ls | wc}
-\end{alltt}
-The result should be over 200 (you can check the exact number with the
-\dirname{bin} directory contents in the distribution).
-
-If you need special privileges for \texttt{make install}, you can
-separate the \samp{make world} into two different runs, like this:
-\begin{alltt}
-> \Ucom{make all}
-> \Ucom{su}
-> \Ucom{make install strip}
-\end{alltt}
-
-After you've installed your new binaries, you should follow the normal
-post-installation procedures, given in section~\ref{sec:postinstall}
-on p.~\pageref{sec:postinstall}.
-
-
-\section{Last words}
-
-This edition of \TeXLive{} is edited by Sebastian Rahtz, with the major
-contributors being Fabrice Popineau, who has worked away unceasingly at
-the Windows part of the package (especially the setup!)\ and contributed
-in many different ways with ideas, advice and code, and Staszek
-Wawrykiewicz, who provided great testing feedback, and co-ordinated the
-Polish contributions.
-
-Kaja Christiansen performed a vital role in endless recompilations on
-assorted Unix platforms. Vladimir Volovich did great work on cleaning
-the source and making other improvements, while Gerben Wierda did all
-the work for \MacOSX.
-
-\subsection{Acknowledgements}
-
-\TeXLive{} is a joint effort by virtually all \TeX{} Users Groups. In
-particular, we are very grateful for past and present help from:
-
-\begin{itemize}
-
-\item The German-speaking \TeX{} Users (\acro{DANTE} e.V.), who provide
-the hardware the \TeXLive{} source repository; and Rainer Sch\"opf and
-Reinhard Zierke who look after it. \acro{DANTE} president Volker Schaa
-coordinated production with the Lehmann's Bookstore
-(\url{http://www.lob.de}).
-
-\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.
-
-\item Karl Berry, who provided the original \Webc{} distribution, and
-has continued to give invaluable advice, encouragement, and help.
-
-\item Mimi Burbank, who arranged access at the Florida State University
-School of Computational Science and Information Technology to a slew of
-different computers to compile \TeX{} on, and acted as an essential
-guinea-pig whenever asked.
-
-\item Thomas Esser, without whose marvellous \teTeX{} package \TeXLive{}
-would certainly not exist, and whose continual help makes it a better
-product.
-
-\item Michel Goossens, who co-authored the documentation.
-
-\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.
-
-\item Petr Olsak, who coordinated and checked all the Czech and Slovak
-material very carefully.
-
-\item Olaf Weber, for his patient assembly and maintenance of Web2c.
-
-\item Graham Williams, on whose work the catalogue of packages depends.
-
-\end{itemize}
-
-In addition, Gerhard Wilhelms, Volker Schaa, Fabrice Popineau, Janka
-Chleb\'\i{}kov\'a, Staszek Wawrykiewicz, Erik Frambach, and Ulrik Vieth
-kindly translated documentation at various times into their respective
-languages, checked other documentation, and provided very welcome
-feedback.
-
-
-\subsection{Release history}
-\label{sec:history}
-
-Discussion began in late 1993 when the Dutch \TeX{} Users Group was
-starting work on its 4All\TeX{} \CD{} for \acro{MS-DOS} users, and it
-was hoped at that time to issue a single, rational, \CD{} for all
-systems. This was too ambitious a target for the time, but it did spawn
-not only the very successful 4All\TeX{} \CD{}, but also the \acro{TUG}
-Technical Council working group on a \emph{\TeX{} Directory Structure}
-(\url{http://tug.org/tds}), which specified how to create consistent and
-manageable collections of \TeX{} support files. A complete draft of the
-\TDS{} was published in the December 1995 issue of \textsl{TUGboat}, and
-it was clear from an early stage that one desirable product would be a
-model structure on \CD{}. The distribution you now have is a very direct
-result of the working group's deliberations. It was also clear that the
-success of the 4All\TeX{} \CD{} showed that Unix users would benefit
-from a similarly easy system, and this is the other main strand of
-\TeXLive.
-
-We first undertook to make a new Unix-based \TDS{} \CD{} in the autumn
-of 1995, and quickly identified Thomas Esser's \teTeX{} as the ideal
-setup, as it already had multi-platform support and was built with
-portability across file systems in mind. Thomas agreed to help, and work
-began seriously at the start of 1996. The first edition was released in
-May 1996. At the start of 1997, Karl Berry completed a major new release
-of Web2c, which included nearly all the features which Thomas Esser had
-added in \teTeX, and we decided to base the 2nd edition of the \CD{} on
-the standard \Webc, with the addition of \teTeX's \texttt{texconfig}
-script. The 3rd edition of the \CD{} was based on a major revision of
-\Webc, 7.2, by Olaf Weber; at the same time, a new revision of \teTeX
-was being made, and \TeXLive{} included almost all of its features. The
-4th edition followed the same pattern, using a new version of \teTeX,
-and a new release of \Webc{} (7.3). The system now included a complete
-Windows setup.
-
-For the 5th edition (March 2000) many parts of the \CD{} were revised
-and checked, updating hundreds of packages. Package details were stored
-in XML files. But the major change for \TeX\ Live 5 was that all
-non-free software was removed. Everything in \TeXLive{} is now intended
-to be compatible with the Debian Free Software Guidelines
-(\url{http://www.debian.org/intro/free}); we have done our best to check
-the license conditions of all packages, but we would very much
-appreciate hearing of any mistakes.
-
-The 6th edition (July 2001) had much more material updated. The major
-change was a new install concept: the user could select a more exact set
-of needed collections. Language-related collections were completely
-reorganized, so selecting any of them installs not only macros, fonts,
-etc., but also prepares an appropriate \texttt{language.dat}.
-
-The 7th edition of 2002 had the notable addition of \MacOSX{} support,
-and the usual myriad of updates to all sorts of packages and
-programs. An important goal was integration of the source back with
-\teTeX, to correct the drift apart in versions~5 and~6.
-
-In 2003, with the continuing flood of updates and additions, we found
-that \TeXLive{} had grown so large it could no longer be contained on a
-single \CD, so we split it into three different distributions (see
-section~\ref{sec:multiple-dist} on p.~\pageref{sec:multiple-dist}). In
-addition:
-
-\begin{itemize}
-\item At the request of the \LaTeX{} team, we changed the standard
- \cmdname{latex} and \cmdname{pdflatex} commands to now use \eTeX{} (see
- p.~\pageref{text:etex}).
-\item The new Latin Modern fonts were included (and are recommended).
-\item Support for Alpha \acro{OSF} was removed
- (\acro{HPUX} support was removed previously), since no one had (or
- volunteered) hardware available on which to compile new binaries.
-\item Windows setup was substantially changed; for the first time
- an integrated environment based on XEmacs was introduced.
-\item Important supplementary programs for Windows
- (Perl, Ghost\-script, Image\-Magick, Ispell) are now installed
- in the \TeXLive{} installation directory.
-\item Font map files used by \cmdname{dvips}, \cmdname{dvipdfm}
- and \cmdname{pdftex} are now generated by the new program
- \cmdname{updmap} and installed into \dirname{texmf/fonts/map}.
-\item \TeX{}, \MF{}, and \MP{} now, by default, output 8-bit input
- characters as themselves in output (e.g., \verb|\write|) files,
- log files, and the terminal, i.e., \emph{not} translated using the
- \verb|^^| notation. In \TeXLive{}~7, this translation was
- dependent on the system locale settings; now, locale settings do
- not influence the \TeX{} programs' behavior. If for some reason
- you need the \verb|^^| output, rename the file
- \verb|texmf/web2c/cp8bit.tcx|. (Future releases will have cleaner
- ways to control this.)
-\item This documentation was substantially revised.
-\item Finally, since the edition numbers had grown unwieldy,
- the version is now simply identified by the year: \TeXLive{} 2003.
-\end{itemize}
-
-
-\subsection{Future releases}
-
-\emph{\TeXLive{} is not perfect!} (And never will be.) We intend to
-continue to release new versions yearly, 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
-a great deal remains to be done. If you can help, don't hesitate to put
-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}
-
-\medskip
-\noindent \textsl{Happy \TeX'ing!}
-
-\end{multicols}
-\end{document}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/live-2004.tex b/Master/texmf-doc/source/texlive/texlive-en/archive/live-2004.tex
deleted file mode 100644
index 10e50ee5832..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/live-2004.tex
+++ /dev/null
@@ -1,3854 +0,0 @@
-% $Id$
-% TeX Live documentation. Originally written by Sebastian Rahtz and
-% Michel Goossens, now maintained by Karl Berry and others.
-% Public domain.
-%
-\documentclass{article}
-\let\tldocenglish=1 % for live4ht.cfg
-\usepackage{tex-live}
-\begin{document}
-
-\title{%
- {\huge \textit{The \protect\TL{} Guide}\\\strut}
- {\LARGE \textsf{\TK{} 2004}}
-}
-
-\author{Sebastian Rahtz \& Karl Berry, editors \\[3mm]
- \url{http://tug.org/texlive/}
- }
-
-\date{November 2004}
-
-\maketitle
-
-\begin{multicols}{2}
-\tableofcontents
-\listoftables
-\end{multicols}
-
-\section{Introduction}
-\label{sec:intro}
-
-This document describes the main features of the \TL{} software
-distribution\Dash a \TeX{} and \LaTeX{} distribution for Linux and other
-Unix flavors, \MacOSX, and (32-bit) Windows systems. (Warning: it is
-not especially useful for older Mac or \acro{MS-DOS} systems.)
-
-\TL{} includes precompiled binaries for \TeX{}, \LaTeXe{}, \MF, \MP,
-\BibTeX{} and many other programs; an extensive collection of macros,
-fonts and documentation; and support for typesetting in many different
-scripts from around the world. It is part of the even larger \TK{}
-(briefly described below in section~\ref{sec:struct-tl},
-\p.\pageref{sec:struct-tl}), a cooperative effort by the \TeX\ user
-groups.
-
-For newer versions of the packages included here, please check
-\acro{CTAN}: \url{http://www.ctan.org}
-
-For a brief summary of the major changes in this edition of \TL{},
-see section~\ref{sec:history} (\p.\pageref{sec:history}).
-
-
-\subsection{Basic usage of \protect\TL{}}
-\label{sec:basic}
-
-You can use \TL{} in three principal ways:
-
-\begin{enumerate}
-
-\item You can run \TL{} directly from the \DVD
-(see section~\ref{sec:multiple-dist}, \p.\pageref{sec:multiple-dist}).
-This takes almost no disk space, as you might expect, and gives you
-immediate access to everything in \TL{}. Of course performance
-will be worse than running on local disk, but you may well find it
-acceptable.
-
-\item You can install all or part of \TL{} to a local disk. This
-is the most common use of \TL. You will need (approximately) a
-minimum of 100 megabytes, 310 megabytes for a recommended system, and
-730 megabytes for a full system.
-
-\item You can integrate a particular package or collection into your
-existing \TeX{} system, either a \TL{} system you installed
-earlier, or a different system.
-
-\end{enumerate}
-
-\noindent All of these are described in detail in the \acro{OS}-specific
-installation sections following, but here is a quick start:
-
-\begin{itemize*}
-
-\item The main installation script for Unix and \MacOSX{} is
-\texttt{install-tl.sh};
-
-\item The single package installation script is \texttt{install-pkg.sh}.
-
-\item Unfortunately, this version of \TL{} has no Windows installer, due
-to technical difficulties. See section~\ref{sec:win-install} below
-for more information.
-
-\end{itemize*}
-
-
-\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.)
-
-Here is a list of resources, approximately in the order we recommend
-using them:
-
-\begin{description}
-\item [Getting Started] If you are new to \TeX, the web page
-\url{http://tug.org/begin.html} gives a brief introduction to the system.
-
-\item [\TeX{} \acro{FAQ}] The \TeX{} \acro{FAQ} is a huge compendium of
-answers to all sorts of questions, from the most basic to the most
-arcane. It is included on \TL{} in \OnCD{texmf-doc/doc/english/FAQ-en}, and is
-available on the Internet through \url{http://www.tex.ac.uk/faq}.
-Please check here first.
-
-\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 list of all \TeX{}-related items. See
-\OnCD{texmf-doc/doc/english/catalogue}, or
-\url{http://www.ctan.org/tex-archive/help/Catalogue}.
-
-\item [\TeX{} Web Resources] The web page
-\url{http://tug.org/interest.html} has many \TeX{}-related links, in
-particular for numerous books, manuals, and articles on all aspects of
-the system.
-
-\item [support archives] The two principal support forums are the
-Usenet newsgroup \url{news:comp.text.tex} and the mailing list
-\email{texhax@tug.org}. Their archives have years of past
-questions and answers for your searching pleasure, via
-\url{http://groups.google.com/groups?group=comp.text.tex} and
-\url{http://tug.org/mail-archives/texhax}, respectively. And a general web
-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 for advice on asking questions
-in such a way that you're most likely to get an 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.
-
-\end{description}
-
-The other side of the coin is helping others who have questions. Both
-\dirname{comp.text.tex} and \code{texhax} are open to anyone, so feel
-free to join, start reading, and help out where you can. Welcome to
-\TeX{}!
-
-
-% don't use \TL so the \uppercase in the headline works. Also so
-% tex4ht ends up with the right TeX. Likewise the \protect's.
-\section{Structure of \protect\TeX\protect\ Live}
-\label{sec:struct-tl}
-
-This section describes the structure and contents of \TL{} and the
-\TK{} of which it is a part.
-
-\subsection{Multiple distributions: \protect\pkgname{live},
- \protect\pkgname{inst},
- \protect\pkgname{protext}}
-\label{sec:multiple-dist}
-
-Space limitations of \acro{CD-ROM} format have forced us to divide
-\TK{} into several distributions, as follows.
-
-\begin{description}
-
-\item [live] A complete system on \acro{DVD}; it is too large
-for \acro{CD}. It can be run live or installed to disk. It also
-includes a snapshot of the \CTAN{} repository, entirely independent of
-\TL{}, as well as assorted other packages in a
-\texttt{texmf-extra} directory.
-
-Unfortunately, this release of \TL{} does not include a Windows
-installer, due to technical difficulties. (We hope there will be an
-installer again in a few months.) Therefore, when the \DVD{} is mounted
-on Windows, the setup program offers to start the \pkgname{protext}
-installation (see below), and also mentions \CTAN{} and \TL{}, which are
-in subdirectories of the top level of the \DVD{}.
-
-\CTAN{} and \texttt{texmf-extra} do not follow the same copying
-conditions as \TL{}, so be careful when redistributing or
-modifying.
-
-\item [inst(allable)] A complete system on \CD; in order to make this fit,
-the packages and programs are compressed. Therefore, it is not possible
-to run \TeX\ directly from the installable \CD, you have to install it
-to disk (hence its name). Furthermore, it can only be installed on Unix
-(including Linux, \MacOSX, etc.)\ systems, not Windows, although a set
-of experimental Windows binaries is included (for sharing across
-platforms). Installation is described in subsequent sections.
-
-\item [protext] An enhancement of the \MIKTEX\ system, 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}.
-
-\ProTeXt\ is provided as both the top level of the \pkgname{live} \DVD\
-and on its own \CD\ (for those who cannot use the \DVD).
-
-\end{description}
-
-\noindent You can tell which type of distribution you're in by looking
-for a \texttt{00\var{type}.TL} file at the top of the \TL{} directory.
-This file also contains the \TL{} release date.
-
-Naturally, each user group chooses what to distribute, at its own
-discretion. (\acro{TUG} is sending all three discs above to all of its
-members.)
-
-
-\subsection{Top level directories}
-\label{sec:tld}
-
-Here is a brief listing and description of the top level directories in
-the \TL{} distribution. This has changed considerably in 2004: the
-single \texttt{texmf} tree has been split into several smaller trees.
-
-Also, on the \pkgname{live} \DVD, the entire \TL{} hierarchy is in a
-subdirectory \dirname{texlive2004}, not at the top level of the disc.
-
-\smallskip
-\begingroup
- \renewcommand{\arraystretch}{1.3} % open up interrow spacing
-\begin{tabular}{>{\ttfamily}lp{.78\hsize}}
-bin & The \TeX{} system programs, arranged by platform. \\
-MacOSX & Supporting software for \MacOSX (see
- section~\ref{sec:mac-install}, \p.\pageref{sec:mac-install}). \\
-source & The source of all programs, including the main \Webc{}
- \TeX{} and \MF{} distributions. These are stored in a
- \cmdname{bzip2}-compressed tar archive. \\
-support & Assorted auxiliary packages and programs. These are
- \emph{not} installed automatically. This includes
- assorted editors and \TeX\ shells. \\
-texmf & Tree for the programs, along with their support files and
- documentation. Does not include \TeX\ formats and packages. \\
-texmf-dist & The main tree of formats and packages. \\
-texmf-doc & Tree for self-contained pure documentation, with no other
- installed files.\hfil\break Arranged by language. \\
-texmf-var & Tree for files automatically generated and stored. \\
-xemtex & The \cmdname{XEmacs} editor and other support programs for
- Windows.
- These programs generally come pre-installed on Unix systems, or are
- at least easy to compile. \\
-\end{tabular}
-\endgroup
-
-\smallskip
-
-In addition to the directories above, the installation scripts and
-\filename{README} files (in various languages) are at the top level of
-the distribution.
-
-The (new) \dirname{texmf-doc} directory contains only documentation, but
-it does not contain all the documentation. The documentation for the
-programs (manuals, man pages, Info files) is in \dirname{texmf/doc},
-since the programs are in \dirname{texmf}. Similarly, the documentation
-for \TeX\ packages and formats is in \dirname{texmf-dist/doc}. You can
-use the \cmdname{texdoc} or \cmdname{texdoctk} programs to find any
-documentation wherever it's located. The comprehensive links in the
-top-level file \OnCD{doc.html} may also be helpful.
-
-
-\subsection{Extensions to \protect\TeX}
-\label{sec:tex-extensions}
-
-\TL{} contains several extended versions of \TeX:
-
-\begin{description}
-
-\item [\eTeX] adds a small but powerful set of new primitives
-\label{text:etex} (related to macro expansion, character scanning,
-classes of marks, additional debugging features, and more) and the
-\TeXXeT{} extensions for bidirectional typesetting. In default mode,
-\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
-\OnCD{texmf/doc/pdftex/manual/pdftex-a.pdf} (A4 paper) or
-\OnCD{texmf/doc/pdftex/manual/pdftex-l.pdf} (letter paper), and
-\OnCD{texmf/doc/pdftex/examples/example.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 [\OMEGA\ (Omega)] is based on Unicode (16-bit characters), thus
-supports working with almost all the world's scripts simultaneously. It
-also supports so-called `\OMEGA{} Translation Processes' (\acro{OTP}s),
-for performing complex transformations on arbitrary input. See
-\OnCD{texmf-dist/doc/omega/base/doc-1.8.tex} (not completely up-to-date).
-
-\item [Aleph] combines the \OMEGA\ and \eTeX\ extensions.
-See \OnCD{texmf-dist/doc/aleph/base} for some minimal documentation.
-
-\end{description}
-
-
-\subsection{Other notable programs in \protect\TL}
-
-Here are a few other commonly-used programs included in \TL{}:
-
-\begin{cmddescription}
-
-\item [bibtex] bibliography support.
-
-\item [makeindex] index support.
-
-\item [dvips] convert \dvi{} to \PS{}.
-
-\item [xdvi] \dvi{} previewer for the X Window System.
-
-\item [dvilj] \dvi{} drive for the HP LaserJet family.
-
-\item [dv2dt, dt2dv] convert \dvi{} to/from plain text.
-
-\item [dviconcat, dviselect] cut and paste pages
-from \dvi{} files.
-
-\item [dvipdfm] convert \dvi{} to \acro{PDF}, an alternative approach
-to pdf\TeX\ (mentioned above). See the \pkgname{ps4pdf} and
-\pkgname{pdftricks} packages for still more alternatives.
-
-\item [psselect, psnup, \ldots] \PS{}
-utilities.
-
-\item [lacheck] \LaTeX{} syntax checker.
-
-\item [texexec] Con\TeX{}t and \acro{PDF} processor.
-
-\item [tex4ht] \TeX{} to \acro{HTML} converter.
-
-\end{cmddescription}
-
-
-\section{Unix installation}
-\label{sec:unix-install}
-
-As introduced in section~\ref{sec:basic} (\p.\pageref{sec:basic}),
-\TL{} has three principal uses:
-
-\begin{enumerate}
-\item Run directly from media.
-\item Install to disk.
-\item Integrate a particular package or collection into your existing
-\TeX{} installation.
-\end{enumerate}
-
-\noindent The following sections describes the Unix-specific procedures
-for each of these.
-
-\ifSingleColumn \begin{figure}[ht]\noindent \fi
-\begin{warningbox}
-\textbf{Warning: } The \TK{} \CD{}s and \DVD{} are in ISO 9660 (High Sierra)
-format, \emph{with} Rock Ridge (and Joliet, for Windows)
-extensions. Therefore, in order to take full advantage of the \TK{}
-under Unix, your system needs to be able to use the Rock Ridge
-extensions. Please consult the documentation for your \cmdname{mount}
-command to see how to do this. If you have several different machines
-on a local network, you may be able to mount the \CD{}s on one which
-does support Rock Ridge, and use this with the others.
-
-\leavevmode\quad Linux, \acro{BSD}, Sun, and \acro{SGI}
-systems should be able to use the \CD{}s without problems. We
-would appreciate receiving detailed advice from users on other systems
-who succeed, for future versions of this documentation.
-
-\leavevmode\quad
-The discussion below assumes you have been able to mount
-the \CD{}s with full Rock Ridge compatibility.
-\end{warningbox}
-\ifSingleColumn\end{figure}\fi
-
-
-%
-\subsection{Running \protect\TL{} directly from media (Unix)}
-
-\def\runlive{% text repeated in windows section
-It is possible to use the \TeX{} system directly from the \pkgname{live}
-\DVD{}, without installing the distribution to disk. (Thus the name
-\TeX\ `Live', in fact.) It is \emph{not} possible to run \TeX{}
-directly from the other \CD s (see section~\ref{sec:multiple-dist},
-\p.\pageref{sec:multiple-dist}).
-}
-
-\def\startinst{% repeated in other subsections
-To start, you mount the \CD{} or \DVD{}, with Rock Ridge extensions
-enabled. The exact command to do this varies from system to system; the
-following works under Linux, except the name of the device
-(\filename{/dev/cdrom}, here) may vary. (All our examples will use
-\texttt{>} as the shell prompt; user input is
-\Ucom{\texttt{underlined}}.)
-\begin{alltt}
-> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom}
-\end{alltt}
-
-\noindent Change the current directory to the mount point:
-\begin{alltt}
-> \Ucom{cd /mnt/cdrom}
-\end{alltt}
-
-\noindent Under \MacOSX, the directory is typically under
-\dirname{/Volumes}, and the media will be mounted automatically.
-
-Run the installation script \filename{install-tl.sh}:
-\begin{alltt}
-> \Ucom{sh install-tl.sh}\\
-Welcome to TeX Live...
-\end{alltt}
-
-\noindent After various greeting messages and a list of the main menu
-options, the installation will ask you to enter a command. Do this by
-typing the desired character and hitting return; don't type the angle
-brackets. Either uppercase or lowercase is ok; we'll use lowercase in
-our examples.
-}
-
-\runlive
-\startinst
-
-For running live, our first command will be \Ucom{d} and then the
-subcommand \Ucom{1} to set directories. Even in this case, we must
-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{/usr/local/texmf-local} in this example. (If the default value
-of \dirname{/usr/TeX} works for you, then you can skip this step.)
-\begin{alltt}
-Enter command: \Ucom{d}
-Current directories setup:
-<1> TEXDIR: /usr/TeX
-...
-Enter command: \Ucom{1}
-New value for TEXDIR [/usr/TeX]: \Ucom{/usr/local/texmf-local}
-...
-Enter command: \Ucom{r}
-\end{alltt}
-
-\noindent Back at the main menu, our second and last command is
-\Ucom{r}, to set up for running live off the media without installing
-to disk:
-\begin{alltt}
-Enter command: \Ucom{r}
-Preparing destination directories...
-...
-Welcome to TeX Live!
->
-\end{alltt}
-
-\noindent And we are back at the system prompt, as shown.
-
-Next, it is necessary to alter two environment variables:
-\envname{PATH}, to an architecture-dependent value (so that we can run
-the programs), and \envname{VARTEXMF}, to the value specified above. See
-table~\ref{tab:archlist} for a list of the architecture names for the
-different systems.
-
-
-\def\textruntexconfig{%
-After the main installation has completed, and environment variables
-have been set, the last step is to run \cmdname{texconfig} to customize
-your installation for your needs. This is explained in
-section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig}.
-}
-\textruntexconfig
-
-\begin{table*}[ht]
-\caption[Supported system architectures.]{Supported system
-architectures. In addition to the version-specific names listed here,
-there are generic names without the version numbers. For instance,
-\texttt{sparc-solaris} links to \texttt{sparc-solaris2.7}. The generic
-names can be used to protect against the version numbers changing in the
-future, if you wish.}
-\label{tab:archlist}
-\begin{tabular}{>{\ttfamily}ll}
-alpha-linux & HP Alpha GNU/Linux \\
-%alphaev5-osf4.0d & HP Alphaev5 OSF \\
-%hppa2.0-hpux10.20 & HP9000 HPUX 10.20 \\
-i386-freebsd4.10 & Intel x86 FreeBSD \\
-i386-linux & Intel x86 GNU/Linux \\
-%i386-openbsd3.3 & Intel x86 OpenBSD \\
-%i386-solaris2.8 & Intel x86 Solaris \\
-mips-irix6.5 & SGI IRIX \\
-powerpc-aix4.3.3.0 & IBM RS/6000 AIX \\
-powerpc-darwin6.8 & \MacOSX \\
-sparc-solaris2.7 & Sun Sparc Solaris \\
-sparc64-linux & Sun Sparc GNU/Linux \\
-win32 & Windows (32-bit) \\
-x86\_64-linux & Intel/AMD 64-bit GNU/Linux \\
-\hline
-\end{tabular}
-\end{table*}
-
-\label{text:path}
-The syntax for setting the environment variables, and the initialization
-file to put them in, depends on the shell you use. If you use a
-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
-VARTEXMF=/usr/local/texmf-local/texmf-var; export VARTEXMF
-\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 VARTEXMF /usr/local/texmf-local/texmf-var
-\end{alltt}
-
-\noindent Then log out, log back in, and test your installation
-(see section~\ref{sec:test-install}, \p.\pageref{sec:test-install}).
-
-\def\textifindoubt{%
-If in doubt, please ask any local system gurus to help you with
-problems; for example, the way to mount the \TL{} media, which
-directory or directories to use, and precise details of the changes to
-your personal initialization files can and do vary from site to site.
-}
-\textifindoubt
-
-
-%
-\subsection{Installing \protect\TeX\protect\ Live to disk}
-\label{sec:unix-install-disk}
-
-It is possible, indeed typical, to install the \TeX{} system from the
-\TL{} to disk. This can be done either from any of the \TK{} discs.
-(See section~\ref{sec:multiple-dist}, \p.\pageref{sec:multiple-dist},
-for an explanation of the different distributions.)
-
-\startinst
-
-Table~\ref{tab:main-menu-options} briefly lists the options in the main
-menu. The order in which you select the options makes little
-difference, except that \Ucom{i} must be last. It's reasonable to go
-through them in the order presented here.
-
-% apparently here.sty [H] doesn't support table*.
-\begin{table}[H]
-\caption{Main menu options for the installation.}
-\label{tab:main-menu-options}
-\begin{tabular}{>{\ttfamily}ll}
-p & The platform you are running on.\\
-b & The architectures for which to install binaries.\\
-s & The base installation scheme to use (minimal, recommended,
- full, etc.)\\
-c & Override the base scheme for individual collections.\\
-l & Override for language collections.\\
-d & Directories in which to install.\\
-o & Other options.\\
-i & Perform the installation.\\
-\end{tabular}
-\end{table}
-
-Here are further details on each option.
-
-\textbf{\optname{p} -- Current platform.} Since the installation script
-automatically guesses which platform you're running on, it is generally
-unnecessary to use this option. It's there in case you need to override
-the automatic detection.
-
-\textbf{\optname{b} -- Binary architectures.} By default, only the
-binaries for your current platform will be installed. From this menu,
-you can select installation of binaries for other architectures as well
-(or not install the current platforms). This can be useful if you are
-sharing a \TeX\ tree across a network of heterogenous machines. For a
-list of the supported architectures, see table~\ref{tab:archlist},
-\p.\pageref{tab:archlist}.
-
-\textbf{\optname{s} -- Base installation scheme.} From this menu, you
-can choose an overall common set of packages, called a ``scheme''. The
-default \optname{recommended} scheme suffices for typical needs, but you
-can also choose the \optname{basic} scheme if you are low on disk space,
-or \optname{full} to get absolutely everything. There are also specific
-sets for Omega and \acro{XML}.
-
-\textbf{\optname{c} -- Individual collections.} From this menu, you can
-override the base scheme's set of collections to install. Collections
-are one level lower than schemes\Dash collections consist of
-one or more packages, where packages (the lowest level grouping in \TL)
-contain the actual \TeX\ macro files, font families, and so on.
-In this menu, selection letters are case-sensitive.
-
-\textbf{\optname{l} -- Language collections}. This menu has the same
-basic purpose as \Ucom{c}, to override the base scheme. In this case,
-the collections are specifically for different languages. Selection
-letters are case-sensitive here. Here is a list of the language
-collections in \TL:
-
-% xx really should generate list from texmf/tpm/collection/tex-lang*
-% a la install-tl.sh.
-\begin{tabbing}
-\hspace{.25\linewidth} \=
-\hspace{.25\linewidth} \=
-\hspace{.25\linewidth} \=
-\hspace{.25\linewidth} \kill
-(some) African scripts \>
-Arabic \>
-Armenian \>
-Chinese\,Japanese\,Korean \\
-Croatian \>
-Cyrillic \>
-Czech/Slovak \>
-Danish \\
-Dutch \>
-Finnish \>
-French \>
-German \\
-Greek \>
-Hungarian \>
-Indic \>
-Italian \\
-Latin \>
-Manju \>
-Mongolian \>
-Norwegian \\
-Polish \>
-Portuguese \>
-Spanish \>
-Swedish \\
-Tibetan \>
-\acro{UK} English \>
-Vietnamese \\
-\end{tabbing}
-
-\noindent Language collections typically include fonts, macros,
-hyphenation patterns, and other support files. (For instance,
-\pkgname{frenchle.sty} is installed if you select the \optname{French}
-collection.) In addition, installing a language collection will alter
-the \filename{language.dat} configuration file controlling which
-hyphenation patterns are loaded.
-
-\textbf{\optname{d} -- Installation directories}. Three directories can
-be changed here:
-\label{text:instdir}
-
-\begin{ttdescription}
-\item [TEXDIR] The top-level directory under which
-everything else will be installed. The default value is
-\dirname{/usr/TeX}, and is often changed. For example, changing to a
-value such as \dirname{/usr/local/texlive2003} would make it possible to
-keep different releases of \TL{} separate. (You may then wish to make
-\dirname{/usr/local/texlive} a symbolic link, after testing the new
-release.)
-
-Under \MacOSX, the usual frontends look for \TeX{} in
-\dirname{/usr/local/teTeX}, so you may wish to install \TL{} there.
-
-\item [TEXMFLOCAL] This tree is where the \TeX{} system (not as part of
-installation, but rather over time) puts non-version-specific files,
-primarily fonts. The default value is \dirname{TEXDIR/texmf-local}.
-However, it's also the recommended location to put any local packages or
-configuration settings. Therefore, it's desirable to change it to a
-location independent of the current \TL{} release; for example,
-\dirname{/usr/local/texmf-local}.
-
-\item [VARTEXMF] This tree is where the system puts files that
-\emph{are} version-specific, primarily format files and the
-configuration files which are modified by \cmdname{texconfig} (see
-section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig}). The default
-value is \dirname{TEXDIR/texmf-var}, and there's generally no reason to
-change it.
-
-\end{ttdescription}
-
-\textbf{\optname{o} -- Other options.} From this menu, you can select
-the following general options:
-
-\begin{ttdescription}
-\item [a] Specify an alternate directory for generated fonts.
-The default is to use the \envname{VARTEXMF} tree, as explained above.
-Setting this is useful if you plan to mount the main tree read-only, and
-therefore you need another location (perhaps host-specific) for
-dynamically created fonts.
-
-\item [l] Create symbolic links for the binaries, man pages,
-and\slash or \acro{GNU} Info files in other locations. For example, you may
-wish to make the man pages available under \dirname{/usr/local/man} and
-the Info files available under \dirname{/usr/local/info}. (Of course
-you need appropriate privileges to write in the specified directories.)
-
-It is not advisable to overwrite a \TeX\ system that came with your
-system with this option. It's intended more for having the links in
-standard directories known to users, such as \dirname{/usr/local/bin},
-which don't already contain any \TeX\ files.
-
-\item [d] Skip installation of the font/macro documentation tree.
-This is useful if you need to save space, or if you've previously
-installed the documentation elsewhere.
-
-\item [s] Skip installation of the main font/macro source
-tree. This is useful if you are arranging to share that tree between
-machines and\slash or architectures in some other way, such as \acro{NFS}.
-
-\end{ttdescription}
-
-\textbf{i -- Perform installation.} When you're satisfied with your
-configuration options, enter \Ucom{i} to actually do the installation
-from the media to your chosen locations.
-
-% text is similar to above, but no VARTEXMF, so we have to write out.
-After the installation completes, your next step is to include the
-architecture-specific subdirectory of \dirname{TEXDIR/bin} in your
-\envname{PATH}, so the newly-installed programs can be found. The
-architecture names are listed in table~\ref{tab:archlist},
-\p.\pageref{tab:archlist}, or you can simply list the directory
-\dirname{TEXDIR/bin}.
-
-The syntax for doing this, and the initialization file to use, depends
-on your shell. If you use a 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
-\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
-\end{alltt}
-
-\textruntexconfig
-
-Here is a brief annotated example which selects a full installation,
-with binaries for the current system only, with directory changes as
-recommended above. The prompts and \acro{RETURN}s are omitted for
-brevity.
-
-\begin{alltt}
-> \Ucom{sh install-tl.sh}
-\Ucom{s} \Ucom{b} \Ucom{r} # scheme, full, return to main
-\Ucom{d} # change directories
-\Ucom{1} \Ucom{/usr/local/texlive2003} # top-level dir
-\Ucom{2} \Ucom{/usr/local/texmf-local} # TEXMFLOCAL outside TEXDIR
-\Ucom{r} # return to main
-\Ucom{i} # perform installation
-> \Ucom{texconfig} ...
-# New PATH, with Linux as the example:
-> \Ucom{PATH=/usr/local/texlive2003/bin/i386-linux:$PATH; export PATH}
-\end{alltt}
-
-\textifindoubt
-
-
-%
-\subsection{Installing individual packages to disk}
-
-You can add individual packages or collections from the current
-distribution to an existing non-\TL{} setup, or an earlier
-\TL{} installation.
-
-\startinst
-
-Run the installation script \filename{install-pkg.sh} (not
-\filename{install-tl.sh}, which is intended for complete installations
-only):
-\begin{alltt}
-> \Ucom{sh install-pkg.sh \var{options}}
-\end{alltt}
-
-The first set of options controls what gets read:
-
-\begin{ttdescription}
-\item [-{}-package=\var{pkgname}] The individual package to work on.
-
-\item [-{}-collection=\var{colname}] The individual collection to work on.
-
-\item [-{}-nodoc] Exclude documentation files from the operation.
-
-\item [-{}-nosrc] Exclude source files from the operation.
-
-\item [-{}-cddir=\var{dir}] Source directory to read from; defaults
-to the current directory. If you followed the instructions above, that
-will be the distribution directory, and won't need to be changed.
-
-\item [-{}-listdir=\var{dir}] The so-called `lists' directory within
-\var{cddir} from which to read the package information. The only
-reason to change the default is if you're making changes to \TL{}
-yourself.
-
-\end{ttdescription}
-
-What actually happens is controlled by the following options. If
-neither of these are specified, the default action is to install the
-selected files. The main destination tree is found by expanding
-\envname{\$TEXMFMAIN} with \cmdname{kpsewhich}. You can override it by
-setting either the environment variable \envname{TEXMFMAIN} or
-\envname{TEXMF}.
-
-\begin{ttdescription}
-\item [-{}-listonly] List the files that would be installed, but don't
-actually install anything.
-
-\item [-{}-archive=\var{tarfile}] Instead of installing the files into
-the \TeX{} system, make a \cmdname{tar} archive.
-
-\end{ttdescription}
-
-Additional options:
-
-\begin{ttdescription}
-
-\item [-{}-config] After installation, run \code{texconfig init}.
-
-\item [-{}-nohash] After installation, don't run \cmdname{mktexlsr} to
-rebuild the filename database.
-
-\item [-{}-verbose] Give more information as the script runs.
-
-\end{ttdescription}
-
-Here are some usage examples:
-
-\begin{enumerate}
-
-\item To see the files in the package \pkgname{fancyhdr} without
-installing it:
-
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=fancyhdr --listonly}
-\else> \Ucom{sh install-pkg.sh --package=fancyhdr \bs}
-> \Ucom{--listonly}
-\fi{}
-texmf/doc/latex/fancyhdr/README
-texmf/doc/latex/fancyhdr/fancyhdr.dvi
-texmf/doc/latex/fancyhdr/fancyhdr.pdf
-...
-\end{alltt}
-
-\item Install the \LaTeX{} package \pkgname{natbib}:
-\begin{alltt}
-> \Ucom{sh install-pkg.sh --package=natbib}
-\end{alltt}
-
-\item Install the \LaTeX{} package \pkgname{alg} without source files or
-documentation:
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=alg --nosrc --nodoc}
-\else> \Ucom{sh install-pkg.sh -{}-package=alg \bs}
-> \Ucom{-{}-nosrc -{}-nodoc}
-\fi\end{alltt}
-
-\item Install all the packages in the collection of additional
-plain \TeX\ macros:
-\begin{alltt}
-> \Ucom{sh install-pkg.sh --collection=tex-plainextra}
-\end{alltt}
-
-\item Write all files in the \pkgname{pstricks} package to a
-\cmdname{tar} file in \path|/tmp|:
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=pstricks --archive=/tmp/pstricks.tar}
-\else
-> \Ucom{sh install-pkg.sh -{}-package=pstricks \bs}
-> \Ucom{-{}-archive=/tmp/pstricks.tar}
-\fi\end{alltt}
-
-\end{enumerate}
-
-\textifindoubt
-
-
-%
-\section{Post-installation}
-\label{sec:postinstall}
-
-After the main installation is done, for any operating system, the
-remaining steps are to configure the system for your local needs, and
-perform some basic tests.
-
-Another sort of post-installation is to acquire packages, fonts, or
-programs that were not included in \TL{}. The basic idea is to
-install such additions in the \envname{TEXMFLOCAL} tree (if you
-installed to disk), or \envname{VARTEXMF} (if you are running live).
-See the ``Installation directories'' option on \p.\pageref{text:instdir}.
-
-Unfortunately, the details can and do vary widely, and so we do not attempt to
-address them here. Here are some external links to descriptions:
-\begin{itemize*}
-\item
-\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages}
-\item
-\url{http://www.ctan.org/installationadvice}
-\item
-\url{http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst}
-\item
-\url{http://www.ctan.org/tex-archive/info/Type1fonts} for font creation
-and installation information in particular.
-\end{itemize*}
-
-
-\subsection{The \protect\cmdname{texconfig} program}
-\label{sec:texconfig}
-
-At any time after installation, you can and should use the program
-\cmdname{texconfig} to configure the system to fit your local needs. It
-is installed in the architecture-specific subdirectory
-\texttt{TEXDIR/bin/\var{arch}} along with everything else.
-
-If you run it without arguments, it will enter full-screen mode and
-allow you to view and change options interactively.
-
-You can also run it with various command-line options. Here are some of
-the most common (a \TL{} installation is configured for the A4 paper
-size by default):
-
-\begin{ttdescription}
-
-\item [texconfig paper letter] Set default paper size for
-various programs and drivers (\cmdname{pdftex}, \cmdname{dvips},
-\cmdname{dvipdfm}, \cmdname{xdvi}) to be \acro{US} letter. The other
-allowable size is \optname{a4}, which is the default.
-
-\item [texconfig localsetup] Verify that paths are set ok.
-
-\item [texconfig rehash] Update all the \TeX{} system filename databases.
-
-\item [texconfig faq] Show the \teTeX{} \acro{FAQ}.
-(See also the main \TeX{} \acro{FAQ} in \OnCD{texmf-doc/doc/english/FAQ-en}.)
-
-\item [texconfig help] Output help information for \cmdname{texconfig}.
-
-\end{ttdescription}
-
-Of course, \cmdname{texconfig} can only support changing a few of the
-many options and configuration parameters in a \TeX{} system. The main
-configuration file for the base \Webc{} programs is named
-\filename{texmf.cnf}. You can find its location by running
-\samp{kpsewhich texmf.cnf}; it contains many comments explaining the
-default settings and useful alternatives.
-
-
-\subsection{Testing the installation}
-\label{sec:test-install}
-
-After installing \TL{} as best you can, you naturally want to test
-it out, so you can start creating beautiful documents and\slash or fonts.
-
-This section gives some basic procedures for testing that the new system
-is functional. We give Unix commands; under \MacOSX{} and Windows,
-you're more likely to run the tests through a graphical interface, but
-the principles are the same.
-
-\begin{enumerate}
-
-\item Make sure that you can run the \cmdname{tex} program in the first
-place:
-
-\begin{alltt}
-> \Ucom{tex -{}-version}
-TeX 3.141592 (Web2C 7.5.3)
-kpathsea version 3.5.3
-Copyright (C) 1997-2004 D.E. Knuth.
-...
-\end{alltt}
-If this comes back with `command not found' instead of version and
-copyright information, most likely you don't have the correct
-\dirname{bin} subdirectory in your \envname{PATH}. See
-the environment-setting information on \p.\pageref{text:path}.
-
-\item Process a basic \LaTeX{} file:
-\begin{alltt}
-> \Ucom{latex sample2e.tex}
-This is pdfeTeXk, Version 3.141592...
-...
-Output written on sample2e.dvi (3 pages, 7496 bytes).
-Transcript written on sample2e.log.
-\end{alltt}
-If this fails to find \filename{sample2e.tex} or other files, perhaps
-you have interference from old environment variables or configuration
-files. For a deep analysis, you can always ask \TeX{} to report on
-exactly what it is searching for, and finding; see ``Debugging actions''
-on page~\pageref{Debugging}.
-
-\item Preview the result online:
-\begin{alltt}
-> \Ucom{xdvi sample2e.dvi}
-\end{alltt}
-(Under Windows, the analogous command is \cmdname{windvi}.) You should
-see a new window with a nice document explaining some of the basics of
-\LaTeX{}. (Well worth reading, by the way if you're new to the system.)
-You do have to be running under X for \cmdname{xdvi} to work; if you're
-not, or your \envname{DISPLAY} environment variable is set incorrectly,
-you'll get an error \samp{Can't open display}.
-
-\item Create a \PS{} file for printing or display:
-\begin{alltt}
-> \Ucom{dvips sample2e.dvi -o sample2e.ps}
-\end{alltt}
-
-\item Create a \acro{PDF} file instead of \dvi{}; this processes the
-\filename{.tex} file and writes \acro{PDF} directly:
-\begin{alltt}
-> \Ucom{pdflatex sample2e.tex}
-\end{alltt}
-
-\item Preview the \acro{PDF} file:
-\begin{alltt}
-> \Ucom{gv sample2e.pdf}
-\textrm{or:}
-> \Ucom{xpdf sample2e.pdf}
-\end{alltt}
-Unfortunately neither \cmdname{gv} nor \cmdname{xpdf} are currently
-included in \TL{}, so you must install them separately. See
-\url{http://wwwthep.physik.uni-mainz.de/~plass/gv} and
-\url{http://www.foolabs.com/xpdf}, respectively.
-
-\item Other standard test files you may find useful:
-
-\begin{ttdescription}
-\item [small2e.tex] A simpler document than \filename{sample2e}, to
-reduce the input size if you're having troubles.
-\item [testpage.tex] Test if your printer introduces any offsets.
-\item [nfssfont.tex] For printing font tables and tests.
-\item [testfont.tex] Also for font tables, but using plain \TeX{}.
-\item [story.tex] The most canonical (plain) \TeX{} test file of all.
-You must type \samp{\bs bye} to the \code{*} prompt after \samp{tex
-story.tex}.
-\end{ttdescription}
-You can process these in the same way as we did with
-\filename{sample2e.tex}.
-
-\end{enumerate}
-
-If you are new to \TeX{}, or otherwise need help with actually
-constructing \TeX{} or \LaTeX{} documents, please visit
-\url{http://tug.org/begin.html}. We especially recommend the
-\textsl{Formatting Information} manual by Peter Flynn, available at
-\url{http://www.ctan.org/tex-archive/documentation/beginlatex}.
-
-
-\section{\MacOSX{} installation}
-\label{sec:mac-install}
-
-\TL{} supports \MacOSX, but no prior Macintosh versions. (If you
-are running an older Mac version, you can view the files by installing
-the Joliet system extension available from
-\url{http://www.tempel.org/joliet}; however, the \TL{} binaries
-will not run.)
-
-Installation of \TeX{} under \MacOSX{} can be done in two ways:
-
-\begin{enumerate}
-\item With the \filename{install*} scripts, as with Unix.
-\item With the \cmdname{i-Installer} included in
-\filename{MacOSX/II2.dmg}.
-\end{enumerate}
-
-\noindent Each of these is described in a following section.
-
-In addition, \TeX{} under \MacOSX\ typically uses a ``frontend''. This
-is also described below.
-
-
-\subsection{\protect\cmdname{i-Installer}: Internet installation}
-\label{sec:i-Installer}
-
-The \cmdname{i-Installer} is included in the \TL{} distribution as
-an alternative to normal installation. It does not use the contents of
-the \TL{} distribution at all; instead, the system (approximately
-70 megabytes) is downloaded over the Internet.
-
-One advantage of \cmdname{i-Installer} is that it makes updates
-relatively painless. If you are interested, please see the
-\cmdname{i-Installer} \TeX{} home page at \url{http://www.rna.nl/tex.html}.
-
-To use it, mount \filename{./MacOSX/II2.dmg}. Read the documentation,
-launch it, and install at least \texttt{TeX Foundation} and \texttt{TeX
-Programs}. The first will finish without configuration, as soon as the
-second is installed you will be presented with a graphical interface to
-setting up your \TeX{} system.
-
-The \cmdname{i-Installer} distribution uses the \teTeX{} \dirname{texmf}
-tree with some additions. Due to differences between \TL{} and
-\teTeX{} you cannot update a \TL{} installation with an
-\cmdname{i-Installer} \texttt{TeX Programs} i-Package.
-
-
-\subsection{\protect\cmdname{install*.sh}: \protect\TL{} installation}
-
-In order to run the installation scripts under \MacOSX, you need to have
-the \cmdname{bash} shell installed. If you are running \MacOSX~10.2
-or later, you have \cmdname{bash}, and can proceed. If you're running
-an earlier \MacOSX{} version, however, the default shell is
-\cmdname{zsh}, which won't work; you'll need to get \cmdname{bash} from
-the Internet, or more likely upgrade your system.
-
-Once you have \cmdname{bash}, the Unix installation documentation in the
-previous section can be followed. See section~\ref{sec:unix-install} on
-\p.\pageref{sec:unix-install}; \MacOSX-specific notes are included there
-where needed.
-
-
-\subsection{\MacOSX{} frontends}
-
-Using \TeX{} on a Macintosh typically goes through a front end program,
-comprising an execution shell, editor, previewer, and other facilities,
-with a graphical interface. Here are the principal frontends:
-
-\begin{cmddescription}
-\item [TeXShop] Included in \TL{} as \filename{./MacOSX/texshop.dmg}.
- \\See \url{http://www.uoregon.edu/~koch/texshop/texshop.html}.
-
-\item [ITeXMac] Included in \TL{} as \filename{./MacOSX/iTM-*.dmg}.
- \\See \url{http://itexmac.sourceforge.net}.
-
-\item [Mac-emacs] A port of Emacs to \MacOSX{}, integrating \pkgname{AucTeX}.
- \\See \url{http://www.cs.man.ac.uk/~franconi/mac-emacs}.
-
-\end{cmddescription}
-
-The frontends use \dirname{/usr/local/teTeX} as the default location;
-therefore, you must either install \TL{} there, or change the
-configuration of the frontend.
-
-
-\section{Windows installation}
-\label{sec:win-install}
-
-Unfortunately, this release of \TL{} does not include a Windows
-installer, due to technical difficulties. We hope that an installer
-will be available again in a few months. (It is being completely
-rewritten to use standard Microsoft libraries, instead of the homegrown
-\filename{TeXSetup.exe}.)
-
-A set of experimental Windows binaries is included, nevertheless. You
-can install them with the Unix \filename{install-tl.sh} script: select
-the \optname{win32} system from the \optname{S} option of the top-level
-menu. The \pkgname{XEmacs} package is not included, however, due to
-space.
-
-(Meanwhile, if you are an experienced Windows programmer and would like
-to help with the project, email us!)
-
-
-\begin{comment}
-\TL{} can be installed on systems running Windows 9x, \acro{ME},
-\acro{NT}, \acro{2K} or \acro{XP}. Older versions of Windows (3.1x)
-and \acro{MS-DOS} are not supported.
-
-It is necessary to have your Windows set up so that it uses the
-Microsoft Joliet extensions for reading \CD{}s; simply look at the \CD{}
-in Explorer and see whether it shows long, mixed-case, file names. If it
-does not, you must install the Joliet extensions.
-
-The Windows \TeX{} system included in \TL{} is no more and no less
-than the \fpTeX{} distribution. It includes a \texttt{dvi} previewer,
-\textsf{Windvi}, which is similar in usage to the established Unix
-\textsf{xdvi}. The documentation can be found in
-\OnCD{texmf/doc/html/windvi/windvi.html}.
-
-\subsection{The \texttt{TeXLive.exe} program}
-
-\begin{figure*}
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.7\textwidth]{pictures/Welcome-to-TeXLive}
- \else
- \ifnum \Status=2
- \includegraphics[bb=0 0 551 534]{pictures/Welcome-to-TeXLive.jpg}
- \else
- \includegraphics[width=.7\textwidth]{pictures/Welcome-to-TeXLive}
- \fi
- \fi
- \end{center}
- \caption{``Welcome to \TL'' window}\label{graph:welcome}
-\end{figure*}
-
-If your computer is configured to let the \CD{} autostart, then a dialog
-box with a menu bar will popup on the screen, and you will have several
-choices from there:
-
-\begin{itemize*}
-\item Install \TeX{} on your hard disk
-\item Do maintenance on your \TeX{} system.
-\item Remove the \TeX{} system.
-\item Use \TeX{} off the \TL{} \CD{} or \DVD{}.
-\item Browse documentation: \TL{} documentation, TUG web
- pages, \fpTeX web pages.
-\item Run the \cmdname{TeXdocTK} application to find specific documentation.
-\end{itemize*}
-
-If your \CD{} does not autostart, you can explicitly run the program
-by double clicking on \path|bin/win32/TeXLive.exe| on the \CD{} from
-the explorer window.
-
-\subsection{Running \protect\TL{} directly from media (Windows)}
-
-\runlive
-
-To run live under Windows, from the menu, chose \verb|Explore CD-Rom|, then
-\verb|Run TeX off CD-Rom|. This will launch the \cmdname{XEmacs} editor.
-
-XEmacs startup file will set the environment variables needed. XEmacs will also
-setup a temporary \acro{TDS} compliant texmf tree in the temporary area of your
-computer. It is needed to store files that may be built on the fly, such as
-\path|pk| bitmap fonts, or format files. Configuration files are copied from
-the \CD{} to this texmf tree, so that you can edit them if needed. The
-\path|ls-R| database is computed for this texmf tree. The AUC-\TeX{} mode will
-be entered Whenever you will visit or create a \TeX{} file, providing all the
-bells and whistles for \TeX{} support XEmacs is capable of.
-
-If you run 'M-x shell' within XEmacs, then you will have access to all the TeXLive
-tools from the command line provided by XEmacs.
-
-\smallskip {\small\noindent \textbf{[For advanced users:]} You can also
- use the small batch file \path|mkloctex.bat| to be called in a
- directory \path|bin\win32| of the \CD. From the Start menu select
- `Run', then browse the \acro{CD} drive and select
- \path|mkloctex.bat|. Before starting it, you should add two parameters
- separated by a space: the letter of your \acro{CD} drive and the
- letter of the drive where you want to install the \TeX\ directory.
- The whole line should read, e.g., \verb+d:\bin\win32\mkloctex.bat d c+.
- When installation is complete, please read carefully the information
- on screen. If you are running Windows 9x/\acro{ME}, then you will have to
- restart Windows.}
-
-\subsection{Support packages for Windows}
-\label{sec:win-xemtex}
-
-To be complete, a \TL installation needs support packages that are not
-commonly found on a Windows machine.
-Many scripts are written using the Perl language. Some important tools require
-the Ghostscript \PS{} interpreter to render or to convert files. A graphic
-file toolbox is also needed in some cases. Last but not least, a \TeX-oriented
-editor makes it easy to type in your \TeX{} files.
-
-All these tools are quite easy to find for Windows, but in order to try to make
-your life even easier, we have put such a set of tools on \TL:
-\begin{itemize*}
-\item \cmdname{Ghostscript} 7.07
-\item a minimal \cmdname{Perl} 5.8, sufficient to run all the \TL{}
-Perl scripts
-\item a subset of \cmdname{ImageMagick} 5.5.6
-\item the \cmdname{ISpell} checker
-\item \cmdname{XEmacs} 21.5.14 with a selection of packages to support
-\TeX{} typesetting.
-\end{itemize*}
-
-These packages should be installed only all at once. The bundle is
-known as the \XEmTeX{} bundle.
-
-If you didn't install \XEmTeX{}, \cmdname{Perl} and \cmdname{Ghostscript} are
-installed anyway if they are not detected on your machine. This is because they are
-required by many important tools. The \envname{PERL5LIB} and \verb|GS_LIB|
-environment variables will be set too.
-
-When you are under
-\cmdname{XEmacs}, the tools provided shadow any other version you might
-have installed previously. The point here is that \path|TeXSetup.exe|
-will not install anything outside of the \TL location, neither will
-it run foreign installers, nor will it try to autodetect installed
-products using unreliable rules of thumb. The \XEmTeX{} bundle is
-standalone and is meant to evolve in the future. The reference site is
-\url{http://www.fptex.org/xemtex/}.
-
-If you don't want to install this bundle, then you are on your own to
-install the required tools to complete your \TL{} system. Here is a
-list of places to get those tools:
-
-\begin{description}
-\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/}
-\item[Perl] \url{http://www.activestate.com/} (but you might need some
- supplementary packages from CPAN: \url{http://www.cpan.org/})
-\item[ImageMagick] \url{http://www.imagemagick.com}
-\item[NetPBM] alternatively, you could use NetPBM instead of ImageMagick to
- process or convert your graphic files. NetPBM home page is
- \url{http://netpbm.sourceforge.net/}
-\item[\TeX-oriented editors] There is a wide choice, and it is a matter of the
- user's taste. Here is a selection:
- \begin{itemize*}
- \item \cmdname{GNU Emacs} is available natively under Windows, the
- reference url is
- \url{http://www.gnu.org/software/emacs/windows/ntemacs.html}
- \item \cmdname{XEmacs} is available natively under Windows, the
- reference url is \url{http://www.xemacs.org/}
- \item \cmdname{WinShell} is available on \TL in the \path|support|
- directory, the reference url is \url{http://www.winshell.de}
- \item \cmdname{WinEdt} is shareware available from \url{http://www.winedt.com}
- \item TeXnicCenter is available from\\
- \url{http://www.toolscenter.org}
- \item \cmdname{Vim} is available on \TL{} in the
- \path|support\vim| directory and the
- reference site is \url{http://www.vim.org}
- \item \cmdname{SciTE} is available from \url{http://www.scintilla.org/SciTE.html}
- \end{itemize*}
-\end{description}
-
-You might want to install other tools that are not free\footnote{Not
-free, that is, in the sense of freedom to modify and redistribute,
-following free software guidelines. This does not mean you can't acquire
-them for no money.} and therefore not included on \TL{}, such as
-\cmdname{GSView}, the \cmdname{Ghostscript} companion to more
-conveniently view PS/PDF files. \cmdname{GSView} is available from
-\url{http://www.cs.wisc.edu/~ghost/gsview/} or any \acro{CTAN} site.
-
-\subsection{Installing \protect\TeX\protect\ Live to disk}
-
-\textbf{Warning: Win9x users must ensure they have enough environment
- space before undertaking installation. The \cmdname{TeXSetup.exe}
- program won't change the environment size for them. A few environment
- variables will be created and it is possible you run out of
- environment space. Add \texttt{SHELL=<path>COMMAND.COM /E:4096 /P} in the
- config.sys file in order to increase your environment size.}
-
-Installation is started by letting the media autostart. The program run
-is \path|TeXSetup.exe| if you are using the inst disk. If you are using
-the live or the demo disk, you will have to select the item
-\path|TeXLive Software| from the menu, then the subitem \path|Install on
-Hard Disk|. This will invoke \path|TeXSetup.exe|. You can also find it
-in the \path|bin/win32| directory and run it, if the autostart fails for
-any reason. \path|TeXSetup.exe| is a Windows wizard and it will display
-several pages while running.
-
-\begin{description}
-\item[Welcome Page]
- You can choose a \emph{quick} installation from
- here. In this case, the installation will run without any human
- assistance from beginning to end, with all the default settings
- (Figure~\ref{graph:setup-src},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). If you have enough privileges (administrator or power user
- rights) under a Windows version where this is applicable, then you can
- decide to install the \TL{} for all users or for yourself only by
- checking the appropriate box.
- For installing the whole \XEmTeX{} bundle (XEmacs, Ghost\-script,
- Perl, ImageMagick and Ispell) you can check \emph{Install XEmTeX
- Support} box.
- \begin{figure*}[!htb]
- The \cmdname{TeXSetup} Wizard\hfill
- Source directories for the \TL{} files
-
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.48\textwidth]{pictures/setup-wizard.jpg}\hfill%
- \includegraphics[width=.48\textwidth]{pictures/source-for-texlive.jpg}
- \else
- \ifnum \Status=2
-\includegraphics[bb=0 0 506 403]{pictures/setup-wizard.jpg}
-\includegraphics[bb=0 0 506 403]{pictures/source-for-texlive.jpg}
- \else
- \includegraphics[width=.48\textwidth]{pictures/setup-wizard}%
- \hfill%
- \includegraphics[width=.48\textwidth]{pictures/source-for-texlive}
- \fi
- \fi
- \caption{The \TL{} setup wizard}\label{graph:setup-src}
- \end{center}
-\end{figure*}
-\item[Source Page]
- This page is a bit complex. It will allow you to select two source
- directories for your \TL{} system
- (Figure~\ref{graph:setup-src},
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ). You will need a \emph{local
- source directory} and possibly a \emph{remote source directory}.
-
-Why do we need both these directories? The files consisting of the
-\TL{} system are on the \CD{}, of course, but some other useful
-packages are not, either because of space lacking or because their
-license was not compatible with \TL{}. You need to enable Internet
-downloading if you want to install these packages that are marked with a
-specific ``remote'' icon.
-
- However, don't panic: the default parameters of the setup will allow
- you to install a full system using the \CD{} only. Simply, you won't
- have \file{WinEdt} (for example), but you will be able to install it
- later.
-
- So you can take your files from:
- \begin{itemize}
- \item the \CD{} or any similar flat tree of files, available through
- some standard directory (this means the \CD{} can be mounted on
- some remote machine and be made available through network
- sharing),
- \item a set of \file{.zip} files (this is the case when you are
- installing from the demo \CD{} or the \fpTeX{} distribution),
- \item the Internet; in this case, the program takes care of
- downloading the \file{.zip} files it needs for you.
- \end{itemize}
- This option is available only if you enable Internet file
- downloading in the right part of the page. You also need to
- configure this Internet access by selecting to connect either using
- Internet Explorer~5 \file{wininet.dll}, or using a direct connection (\texttt{ftp},
- \texttt{http}).
-% or using a proxy server.
-% Last, you can be assisted in defining the \emph{local source
-% directory} and \emph{remote source directory} which will be used
-% to copy the files onto your hard disk. The \texttt{browse} buttons
-% allow to select a directory for the former, and an url among a list
-% of mirrors for the latter.
-\item[Root Page]
- On this page, you will tell where you want the files to be
- installed (Figure~\ref{graph:root-schm},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). Only the root directory really matters, the other ones
- are set according to the root one. You may want to make
- \path|$TEXMFEXTRA| point to some TDS compliant directory with other
- \TeX{} files or assign a different value to
- \path|$HOMETEXMF|, which is set by default to whatever Windows think
- is your `HOME' location.
-\begin{figure*}[!htb]
- Root and directories\hfill%
- Scheme selection
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.46\textwidth]{pictures/root-of-installation.jpg}\hfill%
- \includegraphics[width=.46\textwidth]{pictures/scheme-selection.jpg}
- \else
- \ifnum \Status=2
-\includegraphics[bb=0 0 506 403]{pictures/root-of-installation.jpg}
-\includegraphics[bb=0 0 506 403]{pictures/scheme-selection.jpg}
- \else
- \includegraphics[width=.46\textwidth]{pictures/root-of-installation}%
- \hfill%
- \includegraphics[width=.46\textwidth]{pictures/scheme-selection}
- \fi
- \fi
- \caption{\TL-Setup: Root and directories / Schemes}\label{graph:root-schm}
- \end{center}
-\end{figure*}
-\item[Get TPM Page]
- This page does not require any manual intervention. The \file{.tpm}
- files which describe collections and packages are retrieved
- (possibly from the Internet), unzipped if needed and parsed.
-\item[Schemes Page]
- On this page, you will select the global scheme of your
- installation (Figure~\ref{graph:root-schm},
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ). A scheme is a large set of files targeted at some kind
- of usage. There are 3 generic schemes for basic, recommended and
- full installation. The other ones are devoted to LUGs (what GUST or
- GUTenberg propose for their members) or applications (XML and
- \TeX{}).
- When a scheme is selected, it is still possible to refine the
- selection by checking the appropriate box. If doing so, you will be
- presented the packages page to change your selection, else you will
- jump to the review page.
-\item[Packages Page]
- Collections and packages are presented in a tree form
- (Figure~\ref{graph:win32-support},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). The links
- in the tree are dependency links. Collections \emph{depend on}
- packages and maybe other collections, and it is the same for each
- package. You can select any package or collection individually, but
- your request will be granted only if the object is not requested by
- another one which is selected. For example, you can't deselect
- \texttt{tex-basic} without deselecting all the collections that
- request it.
-
- The \texttt{tex-xemtex} collection displayed on the picture is Win32 specific. It
- holds a number of bonus packages (Figure~\ref{graph:win32-support},
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ) which can be installed
- automatically and individually: Ghostscript (the \PS{}
- interpreter), XEmacs editor preconfigured for \TeX{}, tools like Perl,
- ImageMagick, Ispell. \emph{None of these packages are selected by
- default}.
-
- On this page, you also have the information about disk space
- needed, for each object, and for the set of those who are selected,
- and also the disk space available on the partition selected for the
- installation. Last, you can choose to install or not the
- documentation files and source files associated with each package.
-\item[Review Page]
- You will find there a summary of your choices
- (Figure~\ref{graph:review},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). It is still possible to
- go back to change them.
-\begin{figure*}[!htb]
- Packages Page\hfill%
- Win32 Support
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.48\textwidth]{pictures/package-selection}\hfill%
- \includegraphics[width=.48\textwidth]{pictures/win32-support}
- \else
- \ifnum \Status=2
-\includegraphics[bb=0 0 506 403]{pictures/package-selection.jpg}\hfill%
-\includegraphics[bb=0 0 506 403]{pictures/win32-support.jpg}
- \else
- \includegraphics[width=.48\textwidth]{pictures/package-selection}%
- \hfill%
- \includegraphics[width=.48\textwidth]{pictures/win32-support}
- \fi
- \fi
- \end{center}
- \caption{Packages Page / Win32 goodies}
- \label{graph:win32-support}
-\end{figure*}
-\item[Files Copy Page]
- The selected files are copied on your hard disk (Figure~\ref{graph:file-copy},
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ). All the files not
- yet available on your local disk are first downloaded from the
- remote source directory on the Internet. Then every package is
- unpacked (if \path|.zip| files), or copied from the \CD{}.
-\item[Configuration Page] Several packages need some configuration
- step to make them usable (Figure~\ref{graph:configuration},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). Also the \TL{} system needs some post-processing step
- (format files generation, ls-R databases generation, environment
- variables, etc.). All these operations are done there, some of them
- can be lengthy.
-\begin{figure*}[!htb]
- \textbf{Review Page}\hfill%
- \textbf{File Copy Page}
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.48\textwidth]{pictures/review-settings}\hfill%
- \includegraphics[width=.48\textwidth]{pictures/file-copy}
- \else
- \ifnum \Status=2
- \includegraphics[bb=0 0 506 403]{pictures/review-settings.jpg}\hfill%
- \includegraphics[bb=0 0 506 403]{pictures/file-copy.jpg}
- \else
- \includegraphics[width=.48\textwidth]{pictures/review-settings}\hfill%
- \includegraphics[width=.48\textwidth]{pictures/file-copy}%
- \fi
- \fi
- \end{center}
- \caption{Review Page / File Copy Page}
- \label{graph:review}\label{graph:file-copy}
-\end{figure*}
-\item[Final Page] The installation being over, you may want to display
- the Windows specific documentation (HTML format) and / or the log
- file of the setup process (Figure~\ref{graph:final}
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ). If it is needed (Win9x/WinME), you will
- be asked to reboot your computer.
-\end{description}
-
-\begin{figure*}[!htb]
- \textbf{Configuration Page}\hfill%
- \textbf{Final Page}
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.48\textwidth]{pictures/configuration}\hfill%
- \includegraphics[width=.48\textwidth]{pictures/congratulations}
- \else
- \ifnum \Status=2
- \includegraphics[bb=0 0 506 403]{pictures/configuration.jpg}\hfill%
- \includegraphics[bb=0 0 506 403]{pictures/congratulations.jpg}
- \else
- \includegraphics[width=.48\textwidth]{pictures/configuration}\hfill%
- \includegraphics[width=.48\textwidth]{pictures/congratulations}%
- \fi
- \fi
- \end{center}
- \caption{Configuration Page / Final page}
-\label{graph:configuration}\label{graph:final}
-\end{figure*}
-
-Please be aware that the choice of cluster size on DOS disk
-partitions can radically affect the size of your \TeX\
-installation. The support tree has hundreds of small files, and it is
-not unusual for a complete installation to take up to four times the
-amount of space used on the \CD.
-
-\end{comment}
-
-
-\section{Windows maintenance and post-installation}
-
-Although this version of \TL{} cannot be installed on Windows, enough of
-this section is relevant to existing installations or cross-mounted
-installations that it seemed worth leaving in.
-
-It will be thoroughly updated when a complete \TL{} Windows distribution
-is released. For now, please ignore references to
-\filename{TeXSetup.exe}, etc.
-
-
-\subsection{What's different in Windows?}
-
-The Windows version of \Webc{} has some specific features that should be
-pointed out.
-
-\begin{description}
-\item[\KPS{}] The hash-tables that \KPS{} builds are quite large for
- the \TL{}. In order to cut down the starting time of any
- \KPS{}-enabled program, these hash-tables have been put in shared
- memory. This way, when you chain the execution of several such
- programs, like \path|tex| calling \path|mpost| calling \path|tex|,
- the overhead when starting each of the subprograms is
- reduced. This change is hidden to the user, except if you set the
- debug flag of kpathsea to the \path|-1| value: you will then trace
- access to the shared memory, which is not what you want (it is
- accessed very often!). What is useful in a log trace of the shared
- memory access is still to be defined, so the situation might evolve
- in the future.
-\item[\cmdname{kpsecheck}] This command provides some options that did
- not fit well into \cmdname{kpsewhich}. It will allow you to list all
- the files that occur multiple times across your texmf trees. This
- could be handy, but most of the time you will also get unwanted
- output (like dozens of \path|README| files)\footnote{It is noticeable
- that all these files result in clashes inside the \KPS{}-hashing
- mechanism; fortunately, \KPS{} never looks for these files.}. For
- this reason, you can combine the \path|-multiple-occurrences| with 2
- other options for including or excluding any filename that match
- some pattern (you can request for several patterns).
-
- The \cmdname{kpsecheck} command will also report the status of shared
- memory: in use or not used. That might be useful to know because if
- the status reported is \samp{in use}, that means one or several
- processes are working, and the effect of any \cmdname{mktexlsr}
- command will be delayed until the next time where no \KPS{} linked
- process will be running.
-
- Last, this same command will report about the location it thinks
- Ghostscript can be found. Under Win32, for many programs, it is
- easier to use the Ghostscript dll, and find it by using the
- Ghostscript registry key than to change the \path|PATH|, which has a
- limited length anyway.
-\item[\Webc{}] The engines have a few more options than in Unix
- \Webc{}, and one option with a different behavior:
- \begin{itemize}
- \item \path|-halt-on-error| stop the compilation at the first error.
- \item \path|-job-time| set the job time to the same timestamp as the
- file given in argument.
-\item \path|-oem| use the DOS codepage for console output.
- \item \path|-output-directory| allow to write all the output files in the
- specified directory.
- \item \path|-time-statistics| print statistics about the job run
- time. It is to be noted that Win9x not being a true multitasking
- operating system, it has no reliable timer for short periods, so
- the value printed is an approximation. Under NT/2K/XP, the result
- is quite accurate with user time and system time values allocated
- for this run. For Unix
- users: the \path|time| command is not usually available to Windows
- users.
- \end{itemize}
-\end{description}
-
-\subsection{Adding packages to your installation}
-
-You will find an option in the \guiseq{TeXLive} menu (or go to
-\guiseq{Start\arw Programs \arw TeXLive \arw Add TeX package} menu) to
-run \file{TeXSetup.exe} in maintenance mode. The steps are almost the
-same as in the initial installation.
-
-We'll discuss differences below, but first, whatever changes you make,
-\textbf{do not forget to rebuild the ls-R database files}. Otherwise,
-your new files will not be found. You can do this either via the
-\acro{GUI} (\guiseq{Start \arw Programs \arw TeXLive \arw Maintenance
-\arw Rebuild ls-R}), or manually running the \file{mktexlsr} command.
-
-The main difference is in the packages selection page. In maintenance
-mode, the list of installed packages is compared to the list of packages
-available from your source directories. Packages that are not installed
-will be displayed in green, out of date packages will be displayed in
-red and up-to-date, installed packages are displayed in black.
-
-This way, you can choose to add or upgrade components, either from
-\TL{} or from the Internet, where you are likely to find some more
-recent version of your packages.
-
-It is up to you to select which packages you want to install. The rest
-of the process is similar to the first installation.
-
-If you want to add files that are not provided by the \TL{} (or
-\fpTeX{}) distribution, it is recommended to put them in the
-\path|$TEXMFLOCAL| directory. This 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:\Program Files\TeXLive\texmf-local\tex\latex\maple\|\\ and the
-documentation files in:\\ \path|c:\Program
-Files\TeXLive\texmf-local\doc\latex\maple\|
-
-\subsection{Uninstalling \protect\TL{}}
-
-The uninstall procedure is available either from the \file{TeXLive.exe}
-program, from the \path|TeXLive| menu or from the control panel
-(\guiseq{Start \arw Control Panel, Add/Remove Programs}). This procedure
-will cleanup your hard disk of most of the \TL{} files. However,
-\TeX{} is a system that is creating files and there is no mechanism to
-keep track of all of them. Moreover, Win32 support packages have their
-own uninstall procedure, which you will have to run separately (provided
-you want to get rid of them). Last, the files you may have stored in
-\path|$TEXMFLOCAL| won't be removed. So, even if the vast majority of
-files are automatically removed by the uninstall procedure, you will
-have to do some manual cleanup to actually remove all of them.
-
-\subsection{Running \texttt{TeXSetup.exe} from the command line}
-
-The \path|TeXSetup.exe| program has a number of other useful
-options. You can get the list by running:
-\begin{verbatim}
-c:\>TeXSetup --help
-\end{verbatim}
-
-Here is the description:
-\begin{description}
-\item[\path|--automatic-reboot|] reboot without waiting user
- confirmation once installation is over;
-\item[\path|--dry-run|] do nothing, just log everything that will be
- done without this option;
-\item[\path|--quick|] use the recommended installation and default
- directories, ask nothing up to rebooting;
-\item[\path|--with-xemtex|] selects the \XEmTeX{} bundle;
-\item[\path|--net-method (=ie5/direct)|] enable to download components with
- restricted licenses from the Internet (either using direct
- connection of Internet Explorer 5 DLLs): you need to have an available
- network connection and some of the packages are huge;
-\item[\path|--remote-source-directory <url>|] this is the base url for the remote packages;
-\item[\path|--local-source-directory <dir>|] by default, \path|TeXSetup.exe|
- will guess the root directory of the set of files you want it to act on, if you ever
- upgrade \path|TeXSetup.exe|, you won't be able to copy the new version
- onto your \CD{}, so you will need to use this option to specify the
- root of the \CD{};
-\item[\path|--installation-directory <dir>|] this is the root of your
- installation, all files will be copied under this location. The
- default value is \verb+c:\Program Files\TL+;
-\item[\path|--texmfmain-directory <dir>|]
-\item[\path|--texmflocal-directory <dir>|]
-\item[\path|--texmfextra-directory <dir>|]
-\item[\path|--texmfhome-directory <dir>|]
-\item[\path|--vartexmf-directory <dir>|]
-\item[\path|--vartexfonts-directory <dir>|] these are the directories
- used to configure the location of your files. They map directly to
- the \path|texmf.cnf| variables.
-\item[\path|--with-source-files(=yes/no)|] copy the source files
- for \TeX{} packages, default value is no;
-\item[\path|--with-documentation-files(=yes/no)|] copy documentation files for \TeX{}
- packages. Default value is yes. Beware: this is only documentation about specific
- packages, general documentation will be installed anyway;
-\item[\path|--program-folder <folder>|] the name of the folder under
- which you will find the menus;
-\item[\path|--add-package <pkg>|] this is used to add or update a specific
- package after a first regular installation;
-\item[\path|--scheme <pkg>|] install the named scheme instead of the
- default \path|texlive-recommended| scheme;
-\item[\path|--maintenance|] mostly the same as \path|--add-package|
- without specifying a package to add;
-\item[\path|--uninstall|] this option will remove anything \TeX{} related coming from
- the \CD{}, which means there can be files left if you added style
- files or format files, and also that supplementary tools will not be
- removed. This option is still a bit crude in this release;
-\item[\path|--help|] this option opens up a box with the list of options.
-\end{description}
-
-\subsection{Network installation}
-
-\KPS{} knows about UNC names, so you can use them to get your TEXMF
-tree from the network. But there is better than this.
-All the support files and configuration files, everything except the files in the
-\path|bin/win32| are shareable with a \teTeX{} or Unix \TL{} installation. That means
-you can use Samba either to mount from an NT server to a Unix
-workstation or the converse. Several strategies are possible:
-\begin{itemize}
-\item Put everything on the server. Just add each set of files for the os and
-architecture you want to use in the \path|bin| directory. That means
-for example \path|bin/win32| and \path|bin/i386-linux|. Next configure
-your main variables. You can use UNC names to
-point to the right directories under Win32.
-\item Install a local copy for the binaries and format files. In this
- case, assign \path|$TEXMFMAIN| to the main \path|texmf| tree that
- will be accessed remotely. Set \path|$VARTEXMF| to be a local
- directory which will hold local configuration files and on-the-fly
- generated files.
-\end{itemize}
-
-\subsection{Personal configurations}
-
-\subsubsection{Dvips}
-
-The configuration file for dvips can be found in\\
-\verb+C:\Program Files\TeXLive\texmf-var\dvips\config\config.ps+\\
-You may open it with any editor
- %(\cmdname{WinShell} will do fine)
- and change some parameters:
-
-\begin{description}
-\item [fonts] you can change the default printer \MF{} mode or printer
- resolution in case \cmdname{dvips} needs to generate PK fonts. By default it
- is configured to use Type~1 versions of the CM fonts, so it should
- not call \cmdname{mktexpk} too often;
-\item[printer] you can tell dvips where you want to print by default. If
- the \optname{o} option is not followed by a printer name, then a
- \file{.ps} \PS{} file is written. You can give dvips a printer
- name such as:
-\begin{verbatim}
-o lpt1:
-% o | lpr -S server -P myprinter
-% o \\server\myprinter
-\end{verbatim}
-\item[paper] Next, you might want
- to change the paper size from European (A4) to US letter
- by making the US letter the first paper size mentioned in the file.
- Scroll to the group of lines beginning with \code{@}. Move
- the appropriate lines so that this section begins with the lines:\\
-\hspace*{1em} @ letterSize 8.5in 11in\\
-\hspace*{1em} @ letter 8.5in 11in\\
-\hspace*{1em} @+ \%\%BeginPaperSize: Letter\\
-\hspace*{1em} @+ letter\\
-\hspace*{1em} @+ \%\%EndPaperSize
-\end{description}
-
-The current \TL{} distribution implements the procedure of making
-always up-to-date fontmaps files for Dvips and Pdftex. This is done by
-the \cmdname{updmap} program during installation, as well as during any
-font package addition. If you add new packages by hand, edit the file
-\verb+updmap.cfg+ in \path|$VARTEXMF/web2c|.
-
-\subsubsection{Pdftex}
-
-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:\Program Files\TeXLive\texmf-var\tex\generic\config\pdftexconfig.tex+ and
-change \samp{\bs pdfpagewidth} and \samp{\bs pdfpageheight}. These entries should read:
-\begin{alltt}
-\bs{}pdfpagewidth=8.5 true in
-\bs{}pdfpageheight=11 true in
-\end{alltt}
-Save the file and exit the editor.
-
-\subsubsection{GSView}
-GSView is now distributed under the Aladdin License, and therefore is no longer included in
-\TL{}.
-
-If you may want to change the page size to US letter size. If so, open
-GSView from the \guiseq{Start} menu, and select \guiseq{Media\arw Letter}.
-
-Also, there are menu settings that are supposed to give you the most
-readable screen image. On \guiseq{Media \arw Display Settings}, set both
-\optname{Text Alpha} and \optname{Graphics Alpha} to 4~bits.
-
-Note that the installation process has set all \code{.ps} and
-\code{.eps} files to automatically open with \cmdname{GSView}.
-
-For printing instructions, see section~\ref{printing} below.
-
-\subsubsection{WinDvi}
-\label{sub:windvi}
-
-The \file{TeXSetup.exe} program takes care of associating the files
-with the \file{.dvi} extension with \file{Windvi}.
-
-Open it with \guiseq{Start\arw Programs\arw TeXLive\arw DVI Viewer}.
-
-You can set it for US letter-size paper by going to \guiseq{View\arw
-Options\arw Papertype} and selecting US (8.5\verb+"+ x 11\verb+"+) (and
-then \optname{OK}. Exit \cmdname{windvi}.
-
-You can change other parameters from there as well, such as the ability
-to execute system commands specified by the document (disabled by
-default for security reasons). Also, the first time you view any .dvi
-file, you may find the magnification too large. Zoom out until you get
-an appropriate size.
-
-%There are two important parameters related to printing that can't yet
-%be set from the dialog boxes, namely the resolution and the \MF{} mode
-%for the printer. You can set them once for all by specifying them on
-%the command line:
-%\begin{verbatim}
-%c:\>windvi -p 360 -mfmode canonbjc foo.dvi
-%\end{verbatim}
-%When you will exit Windvi, these parameters will be stored in the
-%configuration file. The available modes are found in this file:\\
-%\path|c:\Program Files\TeXLive\texmf\metafont\misc\modes.mf|
-
-All configuration settings for \cmdname{Windvi} are stored in a file
-named \path|windvi.cnf| file. You can find it by running this command at
-the prompt:
-\begin{verbatim}
-c:\>kpsewhich --expand-var $HOME/windvi.cnf
-\end{verbatim}
-
-Should you have problems with \cmdname{Windvi}, please remove the configuration
-file and test your problem against a vanilla configuration.
-
-\subsection{Testing}
-
-For generic verification procedures, see section~\ref{sec:test-install}
-(\p.\pageref{sec:test-install}). This section describes
-Windows-specific tests.
-
-Open the file \verb+sample2e.tex+ in your editor (Xemacs, WinShell),
-found in \path|C:\Local\TeX\texmf\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}
-menu (XEmacs) or Preview (Windvi) icon (WinShell).
-
-At first, when you preview files with Windvi, 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.
-
-\textbf{Hint for the future:} If a \LaTeX\ run stops because \LaTeX\
-cannot find a file, you can press Ctrl-z to quit.
-
-
-\subsection{Printing}
-\label{printing}
-
-It is possible to print from Windvi. In this case, printing will be done
-using the Windows unified printer driver. By definition, it is
-compatible with all printers. However, there is some drawback: it can
-generate some huge spool files, and some (older) versions of Windows
-just don't like them. The advantage is that you can use features like
-embedding BMP or WMF images. You also need to make sure that the printer
-parameters are correctly set (subsection~\ref{sub:windvi}), else you
-will get scaled printing (printing at 600\dpi{} on a 300\dpi{} printer
-will give you only one quadrant of your page).
-
-
-Printing is faster and more reliable if you run \cmdname{dvips} to make
-a \filename{.ps} file and then print from \cmdname{GSView}. In
-\cmdname{GSview}, select \guiseq{File\arw Print\ldots}. A \guiseq{Print}
-window will appear.
-
-If you are using a \PS{} printer, \textit{be sure to select
-\guiseq{\PS{} Printer}}. This is done in the \guiseq{Print Method} box
-at the bottom left of the \guiseq{Print} window. You can then select any
-of the printers that you have previously installed. If you fail to
-check the box for \optname{\PS{} Printer}, printing will not work.
-
-If you will be using your own non-\PS{} printer, select
-\guiseq{Ghostscript device} in the \guiseq{Print Method} box, then click
-on the button to the right labelled \guiseq{djet500} and select your
-printer type from the list that pops up. (In the older version of
-\cmdname{GSView}, make sure \optname{\PS{} Printer} is \textit{not}
-selected, then select your printer type from the \guiseq{Device} list.)
-
-\subsection{Tips and tricks for Win32}
-
-\subsubsection{Different flavors of Win32}
-
-What we call Win32 is not an operating system by itself. It is a large
-set of functions (around 12,000 in the header files of the Microsoft
-\acro{SDK}) that you can use to write programs for different operating
-systems of the Windows family.
-
-Windows comes in different flavors:
-\begin{itemize}
-\item Win95, Win98 and Win\acro{ME}, which \emph{are not true multitasking,
- multithreading} environments. They are the latest\Dash and hopefully
- last\Dash metamorphosis of \acro{DOS}. This can be more or less proven
- by the fact that when booting, the PC will load the \path|command.com|
- interpreter, and if you stop the boot process at this point, you can
- ask for the current (\acro{DOS}) version and it will answer something
- like \samp{MS-DOS 7.0} (at least for the old versions of Win9x).
-\item Windows \acro{NT}, which is a new operating system written from
- scratch, capable of true multitasking behavior, and including many
- high level features.
-\item Windows 2000, based on \acro{NT}, with all the bells and
- whistles of Win98.
-\item Windows \acro{XP}, which comes with Personal and Pro flavors. This is
- the last step in merging both lines of products (Win9x based and
- \acro{NT} based). \acro{XP} is based on \acro{NT}.
-\end{itemize}
-
-Win9x are able to run 32~bits programs and 16~bits programs
-concurrently. But the operating system by itself is not entirely
-written in 32~bits mode, and does not support memory protection: 16bits
-applications can overwrite parts of the operating system memory! Some
-parts of the system like the \acro{GDI} (Graphical Device Interface)
-manage limited resources like bitmaps, fonts, pens and so on for the set
-of all programs that run concurrently. All the bitmaps headers available
-at the same time can't amount for more than 64kB. This explains the
-performance tool and the fact that you can put your system on his knees
-by making intensive use of graphic objects for example.
-
-NT, 2K and XP do not suffer from these limitations, and neither from
-other Win9x limitations. They are true multitasking environments, with
-protected memory. They are much more responsive than Win9x because
-of better memory management, better file system and so on.
-
-\subsubsection{Command line prompt}
-
-You may wonder, ``Why would I need to use a command line prompt when
-I have Windows?''
-
-Good question. The problem is of very general nature. Not all operations
-can be done easily using only a \acro{GUI}. Command line gives you
-programming power\Dash assuming a clever command interpreter.
-
-But the problem here is more fundamental: \TeX{} is \emph{a batch}
-tool. Not an interactive one. \TeX{} needs to compute the best
-layout for each page, resolve cross-references and so on. This can be
-done only by a global processing of the document. It is not (yet) a
-task that can be done interactively.
-
-This means that you should use \TeX{} from a command line. In fact the
-situation is not so bad. There is an advantage to write command line
-tools for complex processing: they are better debugged, because they are
-independent of any \acro{GUI} problems, and \acro{GUI} tools can be
-designed to interface to the command line tools. This is the case for
-\TeX{}, where you will mostly interact with it through a \acro{GUI} text
-editor.
-
-However, you may need to use the command line prompt in a number of
-situations. One is when you are having difficulties and want to debug
-your setup.
-
-\begin{description}
- \item[Win9x] You can open a command line prompt by looking either for
- the \acro{MS-DOS} icon in the \guiseq{Start\arw Programs} menu,
- or by choosing \guiseq{Start\arw Run} menu typing in
- \path|command.com| as the progrm name.
- \item[NT, 2K, XP] You can open a command line prompt by looking for
- \guiseq{Command Prompt} in the \guiseq{Start\arw Accessories} menu.
- You can also choose \guiseq{Start\arw Run} and type in
- \path|cmd.exe|, which is the name of the brand new command
- interpreter for \acro{NT} (thus, it is untrue to call this a
- \emph{DOS} box!).
-\end{description}
-
-These locations may change across different Windows versions.
-
-
-\subsubsection{Path separators}
-
-The Win32 API understands both \path|/| and \path|\| characters as PATH
-separators. But the command interpreters do not! So whenever a path name
-is used programmatically, you can use both separators, and even mix them
-up in the same path name. But on the command line, you must type
-\path|\| as path separator. The reason is compatibility: the command
-processor used \samp{/} to introduce arguments to commands.
-
-All this to say: do not be surprised to read path names written using
-the Unix convention; \fpTeX{} is a port of \Webc, and aims to be compatible
-across platforms. For this reason, all the configuration files that
-need to specify path names use the Unix convention.
-
-\subsubsection{File systems}
-\label{sec:clusters}
-
-The worst feature of Win9x with regard to \TeX{} is probably the
-so-called FAT file system. \TeX{} uses very many small files, with size
-around 1--3kB. The \acro{FAT} file system is old, and predates by
-decades the multi-gigabytes hard disks we have today. As a result, it
-cannot manage efficiently the tens of thousands of \TeX{} files found in
-\TL{}. The \acro{FAT} file system allocates a minimum of 32kB for
-\emph{any} file on a huge partition. It means that \TeX{} will use much
-more disk space than it actually needs.
-
-The other, more modern, file systems available, \acro{FAT32} and
-\acro{NTFS}, do not have this drawback. They manage clusters of 4kB
-only. (You can lower the limit to 512 bytes on \acro{NTFS}.)
-
-\subsubsection{How to add some directory to your PATH}
-
-There are pairs of variables and values which behave much like global
-variables inside your programs. The set of those variables is called the
-environment. Each program is initialized with a copy of the
-environment when it is run. It can request and change the
-value of any variable. The changes happen in the copy of the
-environment, and is not at all propagated to the other running
-programs.
-
-Your PATH is a special environment variable used to search for
-programs you want to run.
-There is a different procedure to change it for Win9x, WinME and NT/2K/XP:
-
-\begin{description}
-\item[Windows 95/98] Edit your \path|autoexec.bat|. In this file should be a line
- starting with \texttt{PATH=} and followed by a list of directories separated
- 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:\"Program Files"\TL\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
- environment variable. From this program, select the `Environment'
- tab, and then add or modify the variable you want. You will be asked to reboot the
- machine upon any change.
-\item[Windows NT/2K/XP]
- Click left on \guiseq{Start \arw Settings \arw Control Panel}. Now the
- window with the control panel icons opens. Double click on System. The
- System Properties window opens. Click on the tab \textsf{Environment}
- or look for a button named \guiseq{Environment Variables} among the
- dialog boxes. Now you can change the environment variables for your
- user account. Note: There are also displayed the environment settings
- for the system. Normally, you can't change the system variables
- unless you have administrator rights on your machine. If you want to
- change the \texttt{PATH} for all users, you will have to contact your
- system administrator or be the system administrator yourself\Dash in
- the latter case you should know what you are doing.
-
- If there is already a \texttt{PATH} setting for your user account,
- left click on \texttt{PATH}. In the field \textsf{Variable} appears
- \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:\Program Files\TeXLive\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
- the \textsf{Apply} button before clicking \textsf{Ok}, otherwise the
- changes to \texttt{PATH} won't apply to your system. Be careful when
- changing the environment settings.
-\end{description}
-
-The best way to be sure that a variable has been properly set is to
-open a console and type:
-\begin{verbatim}
-set VARIABLE
-\end{verbatim}
-which should return the corresponding value.
-
-\subsubsection{\TeX{} engines}
-
-If you have a look at the \Webc{} documentation, you will read that all
-the various \TeX{} derived programs use the same base engine. For
-example, \path|tex.exe| and \path|latex.exe| are exact copies of the
-same program, but each one will use a different format file, based on
-its calling name.
-
-Under Unix, this feature is implemented through \emph{symbolic
-links}. It saves up a bit of disk space, because some engines are
-used with many different format files.
-
-The Win32 API does not know about file links. So to save up almost
-the same amount of memory, all the \TeX{} base engines have been put
-in DLLs (\emph{Dynamic Linked Library}). This means that you will have
-the following layout:
-\begin{alltt}
-13/05/2002 17:06 3 584 latex.exe
-13/05/2002 17:06 266 240 tex.dll
-13/05/2002 17:06 3 584 tex.exe
-\end{alltt}
-and the \path|latex.exe| file is nothing but a rough copy of
-\path|tex.exe| using the same core \path|tex.dll|.
-The same trick has been used for the \path|mktex*.exe| family of programs which are
-linked to the \path|mktex.dll| library.
-
-In fact, a generic tool called \path|lnexe.exe| is provided to build the
-equivalent of Unix hard links for executable files only under Win32.
-
-\subsection{In case of problems}
-\label{sec:troubleshooting}
-
-\subsubsection{What to do if \texttt{latex} does not find your files?}
-
-\begin{itemize}
-
-\item \cmdname{kpsewhich} is the tool of choice to debug any
-problem. Unfortunately, \cmdname{kpsewhich} outputs debug information
-to stderr, and the Windows console does not know how to redirect stderr
-to a file\footnote{Well, NT and Win2k consoles know how to do that. But
-the trick will work for any console.}. For diagnostic purposes you can
-temporarily set an environment variable (in a \acro{DOS} box):
-
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=err.log
-\end{verbatim}
-You can also set the debug level:
-\begin{verbatim}
-SET KPATHSEA_DEBUG=-1
-\end{verbatim}
-
-If you want to redirect stderr to stdout, which is not possible
-Windows, then do:
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=con:
-\end{verbatim}
-This way you can capture both stdout and stderr in the same file.
-
-\item Assuming the installation has been done in \path|c:/Program Files/TeXLive|, check
- the following values: \\
- {\small
- \begin{tabular}{ll}
- \path|kpsewhich -expand-path $SELFAUTOPARENT| & \path|c:/Program Files/TeXLive| \\
- \path|kpsewhich -expand-path $TEXMF| & \path|c:/Program Files/TeXLive/texmf| \\
- \path|kpsewhich -expand-path $TEXMFCNF| &
- \path|.;c:/Program Files/TeXLive/texmf/web2c;| \\
- & \path|c:/Program Files/TeXLive/bin/win32;| \\
- & \path|c:/Program Files/TeXLive/bin;| \\
- & \path|c:/Program Files/TeXLive| \\
- \path|kpsewhich -expand-var $TEXINPUTS| & \path|.;c:/Program Files/TeXLive/texmf/tex//|
- \end{tabular}
-}
-\item If you have other \TeX{}-related values already set in your
- environment, please, remove them. They are overriding the ones in
- texmf.cnf.
-\item Check the values from:\\
-{\small
- \begin{tabular}{ll}
- \texttt{kpsewhich cmr10.tfm} & \path|c:/Program Files/TeXLive/texmf/fonts/tfm/public/cm/cmr10.tfm|\\
- \texttt{kpsewhich latex.fmt}& \path|c:/Program Files/TeXLive/texmf/web2c/latex.fmt|
- \end{tabular}
-}
-\item At this point, if everything is correct, \TeX{} and friends
- should work. If it is not the case, you will need to play with
- the \path|-debug=n| option from \path|kpsewhich|, and check back all
- the values. Try to identify and report the problem.
-\end{itemize}
-
-\subsubsection{What to do if your setup still does not work as expected?}
-
-Here are several questions to investigate:
-
-\begin{enumerate}
-\item Is \file{tex.exe} in my \path|PATH|?
-
-\item Is the \path|TEXMFCNF| variable correctly set to
-\path|c:/Program Files/TeXLive/texmf-var/web2c| (default value)?
-
-\item Are there any errors in the log file generated by the
-\file{TeXSetup.exe} program? You can find this by searching for the
-string \samp{Error}.
-
-\item Are there any relevant bug fixes at \url{http://tug.org/texlive/}?
-(Unlikely, but it doesn't hurt to check.)
-
-\item Check the web pages at
-\url{http://www.fptex.org/}, or consider subscribing to the \fpTeX{}
-mailing list, via \url{http://tug.org/mailman/listinfo/fptex}.
-
-\end{enumerate}
-
-
-The \TL{} software consists of hundreds of programs and tens of
-thousands of files, all from varying sources. So it is quite difficult to
-predict all possible causes for problems. Nevertheless, we will do our
-best to help you. (See section~\ref{sec:help}, \p.\pageref{sec:help}.)
-
-
-\subsection{Compiling the source files}
-
-The whole set of source files is available in the distribution as the
-\path|source/source.tar.bz2| archive, together with a separate source
-archive for Windows. To be able to compile the whole distribution for
-Windows, you will need:
-
-\begin{itemize*}
-\item Windows 2K/XP
-\item Microsoft Visual Studio .Net 2003
-\item a set of Unix tools (\texttt{sed},
- \texttt{grep}, \texttt{gawk}, etc.) and also Perl, Flex and Bison,
-\item to adjust the paths in the
- \path|win32/make/common.mak| file according to your installation
-\item to adjust the paths in the Perl script file
- \path|win32/perl/build.pl|,
-\item run the compilation from the \path|mswin32/| directory using this
- command:
-\begin{verbatim}
-c:\texlive\source\mswin32>perl ./perl/build.pl --install --log=install.log
-\end{verbatim}
-\end{itemize*}
-
-There is a lot of work to do to make this process easier and cleaner.
-
-\subsection{Where to get more information}
-
-The Windows \TeX{} system included on \TL{} is also known as
-\fpTeX. The packaging differs, but \fpTeX{} is no more no less than the
-current \TL\ release for Windows.
-
-The \fpTeX{} home page is \url{http://www.fptex.org}.
-
-The current \fpTeX release is available from any \CTAN site in
-\url{htp://www.ctan.org/tex-archive/systems/win32/fptex}.
-
-The main ftp site for \fpTeX\ is \url{ftp://ftp.dante.de/pub/fptex/}
-from where beta versions of \fpTeX\ and additionnal tools are available.
-This main site is (partially) mirrored daily by all \CTAN{} sites at
-\path|systems/win32/fptex|.
-
-The \TeX{} Users Group is kindly hosting a mailing list dedicated to
-\fpTeX. It is used for announcements, bug reports, enhancement requests,
-and general discussion about \fpTeX. To subscribe, visit
-\url{http://tug.org/mailman/listinfo/fptex}. The mailing list
-address is \email{fptex@tug.org}.
-
-
-% don't use \Webc so the \uppercase in the headline works.
-\section{A user's guide to Web2C}
-
-\Webc{} is an integrated collection of \TeX-related programs: \TeX{}
-itself, \MF{}, \MP, \BibTeX{}, etc. It is the heart of \TL{}.
-
-A bit of history: The original implementation was by Tomas Rokicki who,
-in 1987, developed a first \TeX{}-to-C system based on change files
-under Unix, which were primarily the original work of Howard Trickey and
-Pavel Curtis. Tim Morgan became the maintainer of the system, and
-during this period the name changed to Web-to-C\@. In 1990, Karl Berry
-took over the work, assisted by dozens of additional contributors, and
-in 1997 he handed the baton to Olaf Weber.
-
-The \Webc{} system runs on Unix, 32-bit Windows systems, \MacOSX{}, and
-other operating systems. It uses Knuth's original sources for \TeX{} and
-other basic programs written in \web{} and translates them into C source
-code. The core \TeX{} programs are:
-
-\begin{cmddescription}
-\item[bibtex] Maintaining bibliographies.
-\item[dmp] \cmdname{troff} to MPX (\MP{} pictures).
-\item[dvicopy] Expands virtual font references in \dvi{} files.
-\item[dvitomp] \dvi{} to MPX (MetaPost pictures).
-\item[dvitype] \dvi{} to human-readable text.
-\item[gftodvi] Generic font proofsheets.
-\item[gftopk] Generic to packed fonts.
-\item[gftype] GF to human-readable text.
-\item[makempx] \MP{} label typesetting.
-\item[mf] Creating typeface families.
-\item[mft] Prettyprinting \MF{} source.
-\item[mpost] Creating technical diagrams.
-\item[mpto] MetaPost label extraction.
-\item[newer] Compare modification times.
-\item[patgen] Creating hyphenation patterns.
-\item[pktogf] Packed to generic fonts.
-\item[pktype] PK to human-readable text.
-\item[pltotf] Plain text property list to TFM.
-\item[pooltype] Display \web{} pool files.
-\item[tangle] \web{} to Pascal.
-\item[tex] Typesetting.
-\item[tftopl] TFM to plain text property list.
-\item[vftovp] Virtual font to virtual property list.
-\item[vptovf] Virtual property list to virtual font.
-\item[weave] \web{} to \TeX.
-\end{cmddescription}
-
-\noindent The precise functions and syntax of these programs are
-described in the documentation of the individual packages and of \Webc{}
-itself. However, knowing a few principles governing the whole family of
-programs will help you take advantage of your \Webc{} installation.
-
-All programs honor these standard \acro{GNU} options:
-\begin{ttdescription}
-\item[-{}-help] print basic usage summary.
-\item[-{}-verbose] print detailed progress report.
-\item[-{}-version] print version information, then exit.
-\end{ttdescription}
-
-For locating files the \Webc{} programs use the path searching library
-\KPS{}. This library uses a combination of environment variables and a
-configuration files to optimize searching the (huge) collection of
-\TeX{} files. \Webc{} can look at more than one directory tree
-simultaneously, which is useful in maintaining \TeX's standard
-distribution and local extensions in two distinct trees. To speed up
-file searches the root of each tree has a file \file{ls-R}, containing
-an entry showing the name and relative pathname for all files under that
-root.
-
-\subsection{Kpathsea path searching}
-
-Let us first describe the generic path searching mechanism of the \KPS{}
-library.
-
-We call a \emph{search path} a colon- or semicolon\hyph sepa\-rated list
-of \emph{path elements}, which are basically directory names. A
-search path can come from (a combination of) many sources. To look up
-a file \samp{my-file} along a path \samp{.:/dir}, \KPS{} checks each
-element of the path in turn: first \file{./my-file}, then
-\file{/dir/my-file}, returning the first match (or possibly all
-matches).
-
-In order to adapt optimally to all operating systems' conventions, on
-non-Unix systems \KPS{} can use filename separators different from
-colon (\samp{:}) and slash (\samp{/}).
-
-To check a particular path element \var{p}, \KPS{} first checks if a
-prebuilt database (see ``Filename data\-base'' on
-page~\pageref{Filename-database}) applies to \var{p}, i.e., if the database
-is in a directory that is a prefix of \var{p}. If so, the path
-specification is matched against the contents of the database.
-
-If the database does not exist, or does not apply to this path
-element, or contains no matches, the filesystem is searched (if this
-was not forbidden by a specification starting with \samp{!!}\ and if
-the file being searched for must exist). \KPS{} constructs the list
-of directories that correspond to this path element, and then checks
-in each for the file being sought.
-
-The ``file must exist'' condition comes into play with \samp{.vf} files and
-input files read by \TeX's \cs{openin} command. Such files may not
-exist (e.g., \file{cmr10.vf}), and so it would be wrong to search the
-disk for them. Therefore, if you fail to update \file{ls-R} when you
-install a new \samp{.vf} file, it will never be found.
-Each path element is checked in turn: first the database, then the
-disk. If a match is found, the search stops and the result is
-returned.
-
-Although the simplest and most common path element is a directory
-name, \KPS{} supports additional features in search paths: layered
-default values, environment variable names, config file values, users'
-home directories, and recursive subdirectory searching. Thus, we say
-that \KPS{} \emph{expands} a path element, meaning it transforms all
-the specifications into basic directory name or names. This is
-described in the following sections in the same order as it takes
-place.
-
-Note that if the filename being searched for is absolute or explicitly
-relative, i.e., starts with \samp{/} or \samp{./} or \samp{../},
-\KPS{} simply checks if that file exists.
-
-\ifSingleColumn
-\else
-\begin{figure*}
-\verbatiminput{examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{An illustrative configuration file sample}
- \label{fig:config-sample}
-\end{figure*}
-\fi
-
-\subsubsection{Path sources}
-\label{Path-sources}
-
-A search path can come from many sources. In the order in which
-\KPS{} uses them:
-
-\begin{enumerate}
-\item
- A user-set environment variable, for instance, \envname{TEXINPUTS}\@.
- Environment variables with a period and a program name appended
- override; e.g., if \samp{latex} is the name of the program being run,
- then \envname{TEXINPUTS.latex} will override \envname{TEXINPUTS}.
-\item
- A program-specific configuration file, for exam\-ple, a line
- \samp{S /a:/b} in \cmdname{dvips}'s \file{config.ps}.
-\item A \KPS{} configuration file \file{texmf.cnf}, containing a line like
- \samp{TEXINPUTS=/c:/d} (see below).
-\item The compile-time default.
-\end{enumerate}
-\noindent You can see each of these values for a given
-search path by using the debugging options (see ``Debugging actions''
-on page~\pageref{Debugging}).
-
-\subsubsection{Config files}
-
-\begingroup\tolerance=3500
-\KPS{} reads \emph{runtime configuration files} named \file{texmf.cnf}
-for search path and other definitions. The search path used to look
-for these files is named \envname{TEXMFCNF} (by default such a file lives
-in the \file{texmf/web2c} subdirectory). \emph{All}
-\file{texmf.cnf} files in the search path will be read and definitions
-in earlier files override those in later files. Thus, with a search
-path of \verb|.:$TEXMF|, values from \file{./texmf.cnf} override those
-from \verb|$TEXMF/texmf.cnf|.
-\endgroup
-
-\begin{itemize}
-\item
- Comments start with \code{\%} and continue to the end of the line.
-\item
- Blank lines are ignored.
-\item
- A \bs{} at the end of a line acts as a continuation character,
- i.e., the next line is appended. Whitespace at the beginning of
- continuation lines is not ignored.
-\item
- Each remaining line has the form:
-\begin{alltt}
- \var{variable}[.\var{progname}] [=] \var{value}
-\end{alltt}%
- where the \samp{=} and surrounding whitespace are optional.
-\item
- The \ttvar{variable} name may contain any character other
- than whitespace, \samp{=}, or \samp{.}, but sticking to
- \samp{A-Za-z\_} is safest.
-\item
- If \samp{.\var{progname}} is present, the definition only
- applies if the program that is running is named
- \texttt{\var{progname}} or \texttt{\var{progname}.exe}. This allows
- different flavors of \TeX{} to have different search paths, for
- example.
-\item \var{value} may contain any characters except
- \code{\%} and \samp{@}. The
- \code{\$\var{var}.\var{prog}} feature is not available on the
- right-hand side; instead, you must use an additional variable. A
- \samp{;}\ in \var{value} is translated to \samp{:}\ if
- running under Unix; this is useful to be able to have a single
- \file{texmf.cnf} for Unix, \acro{MS-DOS} and Windows systems.
-\item
- All definitions are read before anything is expanded, so
- variables can be referenced before they are defined.
-\end{itemize}
-A configuration file fragment illustrating most of these points is
-\ifSingleColumn
-shown below:
-
-\verbatiminput{examples/ex5.tex}
-\else
-shown in Figure~\ref{fig:config-sample}.
-\fi
-
-\subsubsection{Path expansion}
-\label{Path-expansion}
-
-
-\KPS{} recognizes certain special characters and constructions in
-search paths, similar to those available in Unix shells. As a
-general example, the complex path,
-\verb+~$USER/{foo,bar}//baz+, expands to all subdirectories under
-directories \file{foo} and \file{bar} in \texttt{\$USER}'s home
-directory that contain a directory or file \file{baz}. These
-expansions are explained in the sections below.
-%$
-\subsubsection{Default expansion}
-\label{Default-expansion}
-
-\tolerance=2500
-If the highest-priority search path (see ``Path sources'' on
-page~\pageref{Path-sources}) contains an \emph{extra colon} (i.e.,
-leading, trailing, or doubled), \KPS{} inserts at that point the
-next-highest-prio\-rity search path that is defined. If that inserted
-path has an extra colon, the same happens with the next highest. For
-example, given an environment variable setting
-
-\tolerance=1500
-
-\begin{alltt}
-> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
-and a \code{TEXINPUTS} value from \file{texmf.cnf} of
-
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
-then the final value used for searching will be:
-
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-
-Since it would be useless to insert the default value in more than one
-place, \KPS{} changes only one extra \samp{:}\ and leaves any others in
-place. It checks first for a leading \samp{:}, then a trailing
-\samp{:}, then a doubled \samp{:}.
-
-\subsubsection{Brace expansion}
-
-A useful feature is brace expansion, which means that, for instance,
-\verb+v{a,b}w+ expands to \verb+vaw:vbw+. Nesting is allowed.
-This can be used to implement multiple \TeX{} hierarchies, by
-assigning a brace list to \code{\$TEXMF}.
-For example, in \file{texmf.cnf}, you find
-the following definition:
-\begin{verbatim}
- TEXMF = {$HOMETEXMF,$TEXMFLOCAL,!!$VARTEXMF,!!$TEXMFMAIN}
-\end{verbatim}
-Using this you can then write something like
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-%$
-which means that, after looking in the current directory, the
-\code{\$HOMETEXMF/tex}, \code{\$TEXMFLOCAL/tex}, \code{\$VARTEXMF/tex}
-and \code{\$TEXMFMAIN/tex} trees \emph{only}) will be searched (the
-last two use using \file{ls-R} data base files). It is a convenient
-way for running two parallel \TeX{} structures, one ``frozen'' (on a
-\CD, for instance) and the other being continuously updated with new
-versions as they become available. By using the \code{\$TEXMF}
-variable in all definitions, one is sure to always search the
-up-to-date tree first.
-
-\subsubsection{Subdirectory expansion}
-\label{Subdirectory-expansion}
-
-Two or more consecutive slashes in a path element following a directory
-\var{d} is replaced by all subdirectories of \var{d}: first those
-subdirectories directly under \var{d}, then the subsubdirectories under
-those, and so on. At each level, the order in which the directories are
-searched is \emph{unspecified}.
-
-If you specify any filename components after the \samp{//}, only
-subdirectories with matching components are included. For example,
-\samp{/a//b} expands into directories \file{/a/1/b}, \file{/a/2/b},
-\file{/a/1/1/b}, and so on, but not \file{/a/b/c} or \file{/a/1}.
-
-Multiple \samp{//} constructs in a path are possible, but
-\samp{//} at the beginning of a path is ignored.
-
-\subsubsection{List of special characters and their meaning: a summary}
-
-The following list summarizes the special characters in \KPS{}
-configuration files.
-
-% need a wider space for the item labels here.
-\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
-\begin{ttdescription}
-\item[\CODE{:}] Separator in path specification; at the beginning or
- the end of a path it substitutes the default path expansion.\par
-\item[\CODE{;}] Separator on non-Unix systems (acts like \code{:}).
-\item[\CODE{\$}] Variable expansion.
-\item[\CODE{\string~}] Represents the user's home directory.
-\item[\CODE{\char`\{...\char`\}}] Brace expansion.
-\item[\CODE{//}] Subdirectory expansion (can occur anywhere in
- a path, except at its beginning).
-\item[\CODE{\%}] Start of comment.
-\item[\CODE{\bs}] Continuation character (allows multi-line entries).
-\item[\CODE{!!}] Search \emph{only} database to locate file, \emph{do
- not} search the disk.
-\end{ttdescription}
-
-
-\subsection{Filename databases}
-\label{Filename-database}
-
-\KPS{} goes to some lengths to minimize disk accesses for searches.
-Nevertheless, at installations with enough directories, searching each
-possible directory for a given file can take an excessively long time
-(this is especially true if many hundreds of font directories have to
-be traversed.) Therefore, \KPS{} can use an externally-built plain text
-``database'' file named \file{ls-R} that maps files to directories,
-thus avoiding the need to exhaustively search the disk.
-
-A second database file \file{aliases} allows you to give additional
-names to the files listed in \file{ls-R}. This can be helpful to
-confirm to \acro{DOS} 8.3 filename conventions in source files.
-
-\subsubsection{The filename database}
-\label{ls-R}
-
-As explained above, the name of the main filename database must be
-\file{ls-R}. You can put one at the root of each \TeX{} hierarchy in
-your installation that you wish to be searched (\code{\$TEXMF} by
-default); most sites have only one hierarchy. \KPS{} looks for
-\file{ls-R} files along the \code{TEXMFDBS} path.
-
-The recommended way to create and maintain \samp{ls-R} is to run the
-\code{mktexlsr} script included with the distribution. It is invoked
-by the various \samp{mktex}\dots\ scripts. In principle, this script
-just runs the command
-\begin{alltt}
-cd \var{/your/texmf/root} && \path|\|ls -1LAR ./ >ls-R
-\end{alltt}
-presuming your system's \code{ls} produces the right output format
-(\acro{GNU} \code{ls} is all right). To ensure that the database is
-always up-to-date, it is easiest to rebuild it regularly via
-\code{cron}, so that it is automatically updated when the installed
-files change, such as after installing or updating a \LaTeX{} package.
-
-If a file is not found in the database, by default \KPS{} goes ahead
-and searches the disk. If a particular path element begins with
-\samp{!!}, however, \emph{only} the database will be searched for that
-element, never the disk.
-
-
-\subsubsection{kpsewhich: Standalone path searching}
-\label{Invoking-kpsewhich}
-
-The \texttt{kpsewhich} program exercises path searching independent of any
-particular application. This can be useful as a sort of \code{find}
-program to locate files in \TeX{} hierarchies (this is used heavily in
-the distributed \samp{mktex}\dots\ scripts).
-
-\begin{alltt}
-> \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}}
-\end{alltt}
-The options specified in \ttvar{option} start with either \samp{-}
-or \samp{-{}-}, and any unambiguous abbreviation is accepted.
-
-\KPS{} looks up each non-option argument on the command line as a
-filename, and returns the first file found. There is no option to
-return all the files with a particular name (you can run the Unix
-\samp{find} utility for that).
-
-The more important options are described next.
-
-\begin{ttdescription}
-\item[\texttt{-{}-dpi=\var{num}}]\mbox{}
- Set the resolution to \ttvar{num}; this only affects \samp{gf}
- and \samp{pk} lookups. \samp{-D} is a synonym, for compatibility
- with \cmdname{dvips}. Default is 600.
-
-\item[\texttt{-{}-format=\var{name}}]\mbox{}\\
- Set the format for lookup to \ttvar{name}. By default, the
- format is guessed from the filename. For formats which do not have
- an associated unambiguous suffix, such as \MP{} support files and
- \cmdname{dvips} configuration files, you have to specify the name as
- found in the first column of table~\ref{tab:kpathsea}, which lists
- currently recognized names, a description, possible file extensions,
- and associated environment variables.
-\end{ttdescription}
-
-
-\def\KpathKey#1#2#3#4#5{% name, number, description, variables,
- % suffixes
-\SetRowColor#1 & #3 & #4 & #5\\}
-\def\HEAD#1{\multicolumn{1}{l}{\emph{#1}}}
-%
-\begin{small}
-% a footnoterule immediately under a bottom-of-page rule looks dead
-% silly, so we suppress it
-\renewcommand\footnoterule{\relax}
-%
-\begin{longtable}{@{}%
- >{\ttfamily}P{.16\textwidth}% Col.1
- P{.3\textwidth}% Col 2
- >{\ttfamily\footnotesize}P{.29\textwidth}% Col 3
- >{\ttfamily}P{.14\textwidth}% Col 4
-@{}}
-\caption{Kpathsea file types.}\label{tab:kpathsea}\\
-\emph{Name} & \HEAD{Description} & \HEAD{Variables}
-& \HEAD{Suffixes}\\
-\hline
-\endfirsthead
-\multicolumn{3}{l}{Kpathsea file types \emph{continued}}\\
-\emph{Name} & \HEAD{Description} & \HEAD{Variables}
-& \HEAD{Suffixes}\\
-\hline
-\noalign{\vspace{2pt}}
-\endhead
-\mbox{}\\
-\hline
-\endfoot
-\KpathKey
- {afm}
- {4}
- {Adobe font metrics}
- {AFMFONTS}
- {.afm}
-\KpathKey
- {base}
- {5}
- {Metafont memory dump}
- {MFBASES, TEXMFINI}
- {.base}
-\KpathKey
- {bib}
- {6}
- {\BibTeX{} bibliography source}
- {BIBINPUTS, TEXBIB}
- {.bib}
-\KpathKey
- {}
- {2}
- {bitmap fonts}
- {GLYPHFONTS, TEXFONTS}
- {}
-\KpathKey
- {bst}
- {7}
- {\BibTeX{} style files}
- {BSTINPUTS}
- {.bst}
-\KpathKey
- {cnf}
- {8}
- {Runtime configuration files}
- {TEXMFCNF}
- {.cnf}
-\KpathKey
- {dvips config}
- {34}
- {\textsf{dvips} configuration files, e.g., \file{config.ps}}
- {TEXCONFIG}
- {}
-\KpathKey
- {enc}
- {34}
- {Font encoding files}
- {ENCFONTS}
- {.enc}
-\KpathKey
- {fmt}
- {10}
- {\TeX{} memory dump}
- {TEXFORMATS, TEXMFINI}
- {.fmt, .efmt, .efm}
-\KpathKey
- {gf}
- {0}
- {generic font bitmap}
- {GFFONTS}
- {.gf}
-\KpathKey
- {graphic/figure}
- {25}
- {Encapsulated \PS{} figures}
- {TEXPICTS, TEXINPUTS}
- {.eps, .epsi}
-\KpathKey
- {ist}
- {35}
- {\textsf{makeindex} style files}
- {TEXINDEXSTYLE, INDEXSTYLE}
- {.ist}
-\KpathKey
- {ls-R}
- {9}
- {Filename databases}
- {TEXMFDBS}
- {}
-\KpathKey
- {map}
- {11}
- {Fontmaps}
- {TEXFONTMAPS}
- {.map}
-\KpathKey
- {mem}
- {12}
- {MetaPost memory dump}
- {MPMEMS, TEXMFINI}
- {.mem}
-\KpathKey
- {mf}
- {13}
- {Metafont source}
- {MFINPUTS}
- {.mf}
-\KpathKey
- {mfpool}
- {14}
- {Metafont program strings}
- {MFPOOL, TEXMFINI}
- {.pool}
-\KpathKey
- {mft}
- {15}
- {MFT style file}
- {MFTINPUTS}
- {.mft}
-\KpathKey
- {}
- {41}
- {miscellaneous fonts}
- {MISCFONTS}
- {}
-\KpathKey
- {mp}
- {16}
- {MetaPost source}
- {MPINPUTS}
- {.mp}
-\KpathKey
- {mppool}
- {17}
- {MetaPost program strings}
- {MPPOOL, TEXMFINI}
- {.pool}
-\KpathKey
- {MetaPost support}
- {18}
- {MetaPost support files, used by DMP}
- {MPSUPPORT}
- {}
-\KpathKey
- {ocp}
- {19}
- {\OMEGA{} compiled process files}
- {OCPINPUTS}
- {.ocp}
-\KpathKey
- {ofm}
- {20}
- {\OMEGA{} font metrics}
- {OFMFONTS, TEXFONTS}
- {.ofm, .tfm}
-\KpathKey
- {opl}
- {21}
- {\OMEGA{} property lists}
- {OPLFONTS, TEXFONTS}
- {.opl}
-\KpathKey
- {otp}
- {22}
- {\OMEGA{} translation process files}
- {OTPINPUTS}
- {.otp}
-\KpathKey
- {ovf}
- {23}
- {\OMEGA{} virtual fonts}
- {OVFFONTS, TEXFONTS}
- {.ovf}
-\KpathKey
- {ovp}
- {24}
- {\OMEGA{} virtual property lists}
- {OVPFONTS, TEXFONTS}
- {.ovp}
-\KpathKey
- {pdftex config}
- {18}
- {\textsf{pdftex} configuration files}
- {PDFTEXCONFIG}
- {}
-\KpathKey
- {pk}
- {1}
- {packed bitmap fonts}
- {\var{program}FONTS \textrm{(\texttt{\var{program}} being
- \textsmaller{\cmdname{XDVI}},
- etc.)}, PKFONTS, TEXPKS, GLYPHFONTS, TEXFONTS}
- {.pk}
-\KpathKey
- {\PS{} header}
- {30}
- {downloadable \PS{}}
- {TEXPSHEADERS, PSHEADERS}
- {.pro, .enc}
-\KpathKey
- {tex}
- {26}
- {\TeX{} source}
- {TEXINPUTS}
- {.tex, .cls, .sty, .clo, .def}
-\KpathKey
- {texmfscripts}
- {20}
- {Scripts distributed in the \file{texmf} tree}
- {TEXMFSCRIPTS}
- {}
-\KpathKey
- {TeX system documentation}
- {27}
- {Documentation files for the \TeX{} system}
- {TEXDOCS}
- {}
-\KpathKey
- {TeX system sources}
- {29}
- {Source files for the \TeX{} system}
- {TEXSOURCES}
- {}
-\KpathKey
- {texpool}
- {28}
- {\TeX{} program strings}
- {TEXPOOL, TEXMFINI}
- {.pool}
-\KpathKey
- {tfm}
- {3}
- {\TeX{} font metrics}
- {TFMFONTS, TEXFONTS}
- {.tfm}
-\KpathKey
- {Troff fonts}
- {31}
- {Troff fonts, used by DMP}
- {TRFONTS}
- {}
-\KpathKey
- {truetype fonts}
- {36}
- {TrueType outline fonts}
- {TTFONTS}
- {.ttf, .ttc}
-\KpathKey
- {Type~1 fonts}
- {32}
- {Type 1 \PS{} outline fonts}
- {T1FONTS, T1INPUTS, TEXPSHEADERS, DVIPSHEADERS}
- {.pfa, .pfb}
-\KpathKey
- {type42 fonts}
- {37}
- {Type 42 \PS{} outline fonts}
- {T42FONTS}
- {}
-\KpathKey
- {vf}
- {33}
- {virtual fonts}
- {VFFONTS, TEXFONTS}
- {.vf}
-\KpathKey
- {web2c files}
- {38}
- {\Webc{} support files}
- {WEB2C}
- {}
-\KpathKey
- {other text files}
- {39}
- {text files used by `\textsf{foo}'}
- {FOOINPUTS}
- {}
-\KpathKey
- {other binary files}
- {40}
- {binary files used by `\textsf{foo}'}
- {FOOINPUTS}
- {}
-\end{longtable}
-\end{small}
-
-
-\begin{multicols}{2}
-
- The last two entries in table~\ref{tab:kpathsea} are special
- cases, where the paths and environment variables depend on the name
- of the program: the variable name is constructed by converting the
- program name to upper case, and then appending \texttt{INPUTS}.
-
- The environment variables are set by default in the configuration
- file \file{texmf.cnf}. It is only when you want to override one or
- more of the values specified in that file that you might want to set
- them explicitly in your execution environment.
-
- The \samp{-{}-format} and \samp{-{}-path} options are mutually
- exclusive.
-
-\begin{ttdescription}
-
-\item[\texttt{-{}-mode=\var{string}}]\mbox{}\\
- Set the mode name to \ttvar{string}; this only affects \samp{gf}
- and \samp{pk} lookups. No default: any mode will be found.
-\item[\texttt{-{}-must-exist}]\mbox{}\\
- Do everything possible to find the files, notably including
- searching the disk. By default, only the \file{ls-R} database is
- checked, in the interest of efficiency.
-\item[\texttt{-{}-path=\var{string}}]\mbox{}\\
- Search along the path \ttvar{string} (colon-separated as usual),
- instead of guessing the search path from the filename. \samp{//} and
- all the usual expansions are supported. The options \samp{-{}-path}
- and \samp{-{}-format} are mutually exclusive.
-\item[\texttt{-{}-progname=\var{name}}]\mbox{}\\
- Set the program name to \texttt{\var{name}}.
- This can affect the search paths via the \texttt{.\var{progname}}
- feature.
- The default is \cmdname{kpsewhich}.
-\item[\texttt{-{}-show-path=\var{name}}]\mbox{}\\
- shows the path used for file lookups of file type \texttt{\var{name}}.
- Either a filename extension (\code{.pk}, \code{.vf}, etc.) or a
- name can be used, just as with \samp{-{}-format} option.
-\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\
- sets the debugging options to \texttt{\var{num}}.
-\end{ttdescription}
-
-
-\subsubsection{Examples of use}
-\label{SExamplesofuse}
-
-Let us now have a look at \KPS{} in action. Here's a straightforward search:
-
-\begin{alltt}
-> \Ucom{kpsewhich article.cls}
- /usr/local/texmf-dist/tex/latex/base/article.cls
-\end{alltt}
-We are looking for the file \file{article.cls}. Since the \samp{.cls}
-suffix is unambiguous we do not need to specify that we want to look for a
-file of type \optname{tex} (\TeX{} source file directories). We find it in
-the subdirectory \file{tex/latex/base} below the \samp{texmf-dist} \TL\
-directory. Similarly, all of the following are found without problems
-thanks to their unambiguous suffix.
-\begin{alltt}
-> \Ucom{kpsewhich array.sty}
- /usr/local/texmf-dist/tex/latex/tools/array.sty
-> \Ucom{kpsewhich latin1.def}
- /usr/local/texmf-dist/tex/latex/base/latin1.def
-> \Ucom{kpsewhich size10.clo}
- /usr/local/texmf-dist/tex/latex/base/size10.clo
-> \Ucom{kpsewhich small2e.tex}
- /usr/local/texmf-dist/tex/latex/base/small2e.tex
-> \Ucom{kpsewhich tugboat.bib}
- /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-That last is a \BibTeX{} bibliography database for \textsl{TUGBoat} articles.
-
-\begin{alltt}
-> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
-Font bitmap glyph files of type \file{.pk} are used by display
-programs like \cmdname{dvips} and \cmdname{xdvi}. Nothing is returned in
-this case since there are no pre-generated Computer Modern \samp{.pk}
-files in \TL{}\Dash the Type~1 variants are used by default.
-\begin{alltt}
-> \Ucom{kpsewhich wsuipa10.pk}
-\ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
-\else /usr/local/texmf-var/fonts/pk/ljfour/public/
-... wsuipa/wsuipa10.600pk
-\fi\end{alltt}
-
-For these fonts (a phonetic alphabet from the University of Washington)
-we had to generate \samp{.pk} files, and since the default \MF{} mode on
-our installation is \texttt{ljfour} with a base resolution of 600\dpi{}
-(dots per inch), this instantiation is returned.
-\begin{alltt}
-> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
-\end{alltt}
-In this case, when specifying that we are interested in a resolution
-of 300\dpi{} (\texttt{-dpi=300}) we see that no such font is available on
-the system. A program like \cmdname{dvips} or \cmdname{xdvi} would
-go off and actually build the required \texttt{.pk} files
-using the script \cmdname{mktexpk}.
-
-Next we turn our attention to \cmdname{dvips}'s header and configuration
-files. We first look at one of the commonly used files, the general
-prolog \file{tex.pro} for \TeX{} support, before turning our attention
-to the generic configuration file (\file{config.ps}) and the \PS{} font
-map \file{psfonts.map}\Dash as of 2004, map and encoding files have
-their own search paths and new location in \dirname{texmf} trees. As
-the \samp{.ps} suffix is ambiguous we have to specify explicitly which
-type we are considering (\optname{dvips config}) for the file
-\texttt{config.ps}.
-\begin{alltt}
-> \Ucom{kpsewhich tex.pro}
- /usr/local/texmf/dvips/base/tex.pro
-> \Ucom{kpsewhich --format="dvips config" config.ps}
- /usr/local/texmf/dvips/config/config.ps
-> \Ucom{kpsewhich psfonts.map}
- /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map
-\end{alltt}
-
-We now take a closer look at the \acro{URW} Times \PS{} support
-files. The prefix for these in the standard font naming scheme is
-\samp{utm}. The first file we look at is the configuration file,
-which contains the name of the map file:
-\begin{alltt}
-> \Ucom{kpsewhich --format="dvips config" config.utm}
- /usr/local/texmf-dist/dvips/psnfss/config.utm
-\end{alltt}
-The contents of that file is
-\begin{alltt}
- p +utm.map
-\end{alltt}
-which points to the file \file{utm.map}, which we want to
-locate next.
-\begin{alltt}
-> \Ucom{kpsewhich utm.map}
- /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
-\end{alltt}
-This map file defines the file names of the Type~1 \PS{} fonts in
-the URW collection. Its contents look like (we only show part of the
-lines):
-\begin{alltt}
-utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
-utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
-utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
-Let us, for instance, take the Times Roman instance
-\file{utmr8a.pfb} and find its position in the \file{texmf} directory
-tree with a search for Type~1 font files:
-\begin{alltt}
-> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
-\else /usr/local/texmf-dist/fonts/type1/
-... urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
-It should be evident from these examples how you can easily locate the
-whereabouts of a given file. This is especially important if you suspect
-that the wrong version of a file is picked up somehow, since
-\cmdname{kpsewhich} will show you the first file encountered.
-
-\subsubsection{Debugging actions}
-\label{Debugging}
-
-Sometimes it is necessary to investigate how a program resolves file
-references. To make this practical, \KPS{} offers various levels of
-debugging output:
-
-\begin{ttdescription}
-\item[\texttt{\ 1}] \texttt{stat} calls (disk lookups). When running
- with an up-to-date \file{ls-R} database this should almost give no
- output.
-\item[\texttt{\ 2}] References to hash tables (such as \file{ls-R}
- databases, map files, configuration files).
-\item[\texttt{\ 4}] File open and close operations.
-\item[\texttt{\ 8}] General path information for file types
- searched by \KPS. This is useful to find out where a particular
- path for the file was defined.
-\item[\texttt{16}] Directory list for each path element (only relevant
- for searches on disk).
-\item[\texttt{32}] File searches.
-\end{ttdescription}
-A value of \texttt{-1} will set all the above options; in practice,
-this is usually the most convenient.
-
-Similarly, with the \cmdname{dvips} program, by setting a combination of
-debug switches, one can follow in detail where files are being picked up
-from. Alternatively, when a file is not found, the debug trace shows in
-which directories the program looks for the given file, so that one can
-get an indication what the problem~is.
-
-Generally speaking, as most programs call the \KPS{} library
-internally, one can select a debug option by using the
-\envname{KPATHSEA\_DEBUG} environment variable, and setting it to (a
-combination of) values as described in the above list.
-
-(Note for Windows users: it is not easy to redirect
-all messages to a file in this system. For diagnostic purposes
-you can temporarily \texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log}).
-
-Let us consider, as an example, a small \LaTeX{} source file,
-\file{hello-world.tex}, which contains the following input.
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
-This little file only uses the font \file{cmr10}, so let us look
-how \cmdname{dvips} prepares the \PS{} file (we want to use the Type~1
-version of the Computer Modern fonts, hence the option \texttt{-Pcms}).
-\begin{alltt}
-> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
-In this case we have combined \cmdname{dvips}'s debug class 4 (font
-paths) with \KPS's path element expansion (see \cmdname{dvips} Reference
-Manual, \OnCD{texmf/doc/html/dvips/dvips_toc.html}).
-The output (slightly rearranged) appears in
-Figure~\ref{fig:dvipsdbga}.
-\begin{figure*}[tp]
-\centering
-\input{examples/ex6a.tex}
-\caption{Finding configuration files}\label{fig:dvipsdbga}
-
-\bigskip
-
-\input{examples/ex6b.tex}
-\caption{Finding the prolog file}\label{fig:dvipsdbgb}
-
-\bigskip
-
-\input{examples/ex6c.tex}
-\caption{Finding the font file}\label{fig:dvipsdbgc}
-\end{figure*}
-
-\cmdname{dvips} starts by locating its working files. First,
-\file{texmf.cnf} is found, which gives the definitions of the search
-paths for the other files, then the file database \file{ls-R} (to
-optimize file searching) and the file \file{aliases}, which makes it
-possible to declare several names (e.g., a short \acro{DOS}-like 8.3 and
-a more natural longer version) for the same file. Then \cmdname{dvips}
-goes on to find the generic configuration file \file{config.ps}
-before looking for the customization file \file{.dvipsrc} (which, in
-this case is \emph{not found}). Finally, \cmdname{dvips} locates the
-config file for the Computer Modern \PS{} fonts \file{config.cms}
-(this was initiated with the \texttt{-Pcms} option on the \cmdname{dvips}
-command). This file contains the list of the map files which
-define the relation between the \TeX{}, \PS{} and file system
-names of the fonts.
-\begin{alltt}
-> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
- p +ams.map
- p +cms.map
- p +cmbkm.map
- p +amsbkm.map
-\end{alltt}
-\cmdname{dvips} thus goes on to find all these files, plus the generic
-map file \file{psfonts.map}, which is always loaded (it contains
-declarations for commonly used \PS{} fonts; see the last part of
-Section \ref{SExamplesofuse} for more details about \PS{} map
-file handling).
-
-At this point \cmdname{dvips} identifies itself to the user:
-\begin{alltt}
-This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com)
-\end{alltt}
-\ifSingleColumn
-Then it goes on to look for the prolog file \file{texc.pro}:
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
-Then it goes on to look for the prolog file \file{texc.pro} (see
-Figure~\ref{fig:dvipsdbgb}).
-\fi
-
-After having found the file in question, \cmdname{dvips} outputs
-date and time, and informs us that it will generate the
-file \file{hello-world.ps}, then that it needs the font file
-\file{cmr10}, and that the latter is declared as ``resident'' (no
-bitmaps needed):
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
-Now the search is on for the file \file{cmr10.tfm}, which is found,
-then a few more prolog files (not shown) are referenced, and finally
-the Type~1 instance \file{cmr10.pfb} of the font is located and
-included in the output file (see last line).
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-\subsection{Runtime options}
-
-Another useful feature of \Webc{} is its possibility to control a number
-of memory parameters (in particular, array sizes) via the runtime file
-\file{texmf.cnf} read by \KPS{}. The memory settings can be found in
-Part 3 of that file in the \TL{} distribution. The more important
-are:
-
-\begin{ttdescription}
-\item[\texttt{main\_memory}]
- Total words of memory available, for
- \TeX{}, \MF{} and \MP. You must make a new format file for each
- different setting. For instance, you could generate a ``huge''
- version of \TeX{}, and call the format file \texttt{hugetex.fmt}.
- Using the standard way of specifying the program name used by \KPS{},
- the particular value of the \texttt{main\_memory} variable will then
- be read from \file{texmf.cnf}.
- etc.).
-\item[\texttt{extra\_mem\_bot}]
- Extra space for ``large'' \TeX{} data structures:
- boxes, glue, breakpoints, etc. Especially useful if you use
- \PiCTeX{}.
-\item[\texttt{font\_mem\_size}]
- Number of words for font information available for \TeX. This
- is more or less the total size of all TFM files read.
-\item[\texttt{hash\_extra}]
- Additional space for the hash table of control sequence names.
- Approximately 10,000 control sequences can be stored in the main
- hash table; if you have a large book with numerous cross-references,
- this might not be enough. The default value of
- \texttt{hash\_extra} is \texttt{50000}.
-\end{ttdescription}
-
-\noindent Of course, this facility is no substitute for truly dynamic
-arrays and memory allocation, but since these are extremely difficult to
-implement in the present \TeX{} source, these runtime parameters provide
-a practical compromise allowing some flexibility.
-
-
-\section{Building on a new Unix platform}
-
-If you have a platform for which executables are not included, you will
-need to compile \TeX{} and friends. This is not as hard as it
-sounds. What you need is all in the directory \texttt{source} in the
-distribution.
-
-\subsection{Prerequisites}
-
-You will need at least 100 megabytes of disk space to compile all of
-\TeX{} and its support programs. You'll also need an \acro{ANSI} C
-compiler, a \cmdname{make} utility, a lexical scanner, and a parser
-generator. We recommend the \acro{GNU} version of these programs
-(\cmdname{gcc}, \acro{GNU} \cmdname{make}, \cmdname{m4}, \cmdname{flex},
-\cmdname{bison}). You may be able to work with other C compilers and
-\cmdname{make} programs, but you will need a good understanding of
-building Unix programs to sort out problems.
-
-Also, the command \texttt{uname} must return a sensible value.
-
-
-\subsection{Configuration}
-
-To begin, perform a normal installation of \TL{} to your disk (see
-section~\ref{sec:unix-install-disk} on
-\p.\pageref{sec:unix-install-disk}). You may wish to skip installing
-all of the prebuilt binaries.
-
-Then, unpack the source from the compressed \texttt{tar} file in the
-directory \dirname{source} to your disk and change directory to where
-you placed it.
-
-Next, run \cmdname{configure} with a command line like this:
-\begin{alltt}
-> \Ucom{sh configure -prefix=/usr/local/TeX}
-\end{alltt}
-
-The \optname{-prefix} directory is the one where you installed the
-support tree; the directory layout will be as follows (where \$TEXDIR
-stands for the directory you chose):
-
-\noindent
-\begin{tabular}{>{\ttfamily}ll@{}}
- \dirname{$TEXDIR/share/texmf} & main tree with fonts,\\
- & \qquad macros, etc\\
- \dirname{$TEXDIR/man} & Unix manual pages\\
- \dirname{$TEXDIR/info} & \acro{GNU} style Info manuals\\
- \dirname{$TEXDIR/bin/$PLATFORM} & binaries\\
-\end{tabular}
-%$
-
-If you want to leave out the \dirname{$PLATFORM} directory level,
-i.e., put the binaries directly into \dirname{$TEXDIR/bin}, specify
-the \verb|--disable-multiplatform| option to \cmdname{configure}.
-
-Have a look at the output of \verb|./configure --help| for more
-options you can use. For example, you can skip building of \OMEGA{} and
-\eTeX{}.
-
-
-\subsection{Running \cmdname{make}}
-
-Make sure the shell variable or option \texttt{noclobber} is not set.
-Then, run the main \cmdname{make} like this:
-\begin{alltt}
-> \Ucom{make world}
-\end{alltt}
-and relax\ldots
-
-Alternatively, you want to log all the output, as in:
-\begin{alltt}
-> \Ucom{sh -c "make world >world.log 2>\&1" \&}
-\end{alltt}
-
-Before you believe that everything went ok, please check the log file
-for errors: \acro{GNU} \cmdname{make} always uses the string \samp{***}
-whenever a command fails. Also, check if all the programs were built:
-
-\begin{alltt}
-> \Ucom{cd \var{TEXDIR}/bin/\var{archname}}
-> \Ucom{ls | wc}
-\end{alltt}
-The result should be over 200 (you can check the exact number with the
-\dirname{bin} directory contents in the distribution).
-
-If you need special privileges for \texttt{make install}, you can
-separate the \samp{make world} into two different runs, like this:
-\begin{alltt}
-> \Ucom{make all}
-> \Ucom{su}
-> \Ucom{make install strip}
-\end{alltt}
-
-After you've installed your new binaries, you should follow the normal
-post-installation procedures, given in section~\ref{sec:postinstall}
-(\p.\pageref{sec:postinstall}).
-
-Also, if you'd like to make your binaries available to others, please
-contact us. We'll be happy to put them on the \TL\ web pages.
-
-
-\section{Acknowledgements}
-
-\TL{} is a joint effort by virtually all of the \TeX{} user groups.
-This edition of \TL{} was overseen by Sebastian Rahtz and Karl Berry.
-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 Hoeppner coordinated production with the Lehmann's Bookstore
-(\url{http://www.lob.de}).
-
-\item The Perforce corporation (\url{http://www.perforce.com}), for providing
-a free copy of their excellent change management system, which we used
-to manage the \TL{} sources.
-
-\item Peter Breitenlohner and the \eTeX\ team for the stable foundation
-of future \TeX's.
-
-\item Thomas Esser, without whose marvelous \teTeX{} package \TL{}
-would certainly not exist, and whose continual help makes it a better
-product.
-
-\item Michel Goossens, who co-authored the original documentation.
-
-\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.
-
-\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 Petr Olsak, who coordinated and checked all the Czech and Slovak
-material very carefully.
-
-\item Fabrice Popineau, for the Windows side of \TL{} and devising the
-new directory layout.
-
-\item Staszek Wawrykiewicz, the principal tester for all of \TL{}, and
-coordinator of the Polish contributions.
-
-\item Olaf Weber, for his patient assembly and maintenance of Web2C,
-upon which all else depends.
-
-\item Gerben Wierda, for creating and maintaining the \MacOSX\ support,
-and much integration and testing.
-
-\item Graham Williams, on whose work the catalogue of packages depends.
-
-\end{itemize*}
-
-Builders of the binaries:
-Tigran Aivazian (\pkgname{x86\_64-linux}),
-Manfred Lotz (\pkgname{i386-freebsd}),
-Maksym Polyakov (\pkgname{sparc-solaris}),
-Fabrice Popineau (\pkgname{win32}),
-Norbert Preining (\pkgname{alpha-linux}),
-Vladimir Volovich (\pkgname{powerpc-aix} and \pkgname{sparc64-linux}),
-Staszek Wawrykiewicz (\pkgname{i386-linux}),
-Olaf Weber (\pkgname{mips-irix}),
-Gerben Wierda (\pkgname{powerpc-darwin}).
-
-Documentation and translation updates:
-Karl Berry (English),
-Daniel Flipo \& Fabrice Popineau (French),
-G\"unter Partosch \& Hartmut Henkel (German),
-Petr Sojka \& Jan Busa (Czech\slash Slovak),
-Boris Veytsman (Russian),
-Staszek Wawrykiewicz (Polish).
-
-Of course the most important acknowledgement must go to Donald Knuth, first
-for inventing \TeX, and then for giving it to the world.
-
-
-\section{Release history}
-\label{sec:history}
-
-\subsection{Past}
-
-Discussion began in late 1993 when the Dutch \TeX{} Users Group was
-starting work on its 4All\TeX{} \CD{} for \acro{MS-DOS} users, and it
-was hoped at that time to issue a single, rational, \CD{} for all
-systems. This was too ambitious a target for the time, but it did spawn
-not only the very successful 4All\TeX{} \CD{}, but also the \acro{TUG}
-Technical Council working group on a \emph{\TeX{} Directory Structure}
-(\url{http://tug.org/tds}), which specified how to create consistent and
-manageable collections of \TeX{} support files. A complete draft of the
-\TDS{} was published in the December 1995 issue of \textsl{TUGboat}, and
-it was clear from an early stage that one desirable product would be a
-model structure on \CD{}. The distribution you now have is a very direct
-result of the working group's deliberations. It was also clear that the
-success of the 4All\TeX{} \CD{} showed that Unix users would benefit
-from a similarly easy system, and this is the other main strand of
-\TL.
-
-We first undertook to make a new Unix-based \TDS{} \CD{} in the autumn
-of 1995, and quickly identified Thomas Esser's \teTeX{} as the ideal
-setup, as it already had multi-platform support and was built with
-portability across file systems in mind. Thomas agreed to help, and work
-began seriously at the start of 1996. The first edition was released in
-May 1996. At the start of 1997, Karl Berry completed a major new release
-of Web2c, which included nearly all the features which Thomas Esser had
-added in \teTeX, and we decided to base the 2nd edition of the \CD{} on
-the standard \Webc, with the addition of \teTeX's \texttt{texconfig}
-script. The 3rd edition of the \CD{} was based on a major revision of
-\Webc, 7.2, by Olaf Weber; at the same time, a new revision of \teTeX
-was being made, and \TL{} included almost all of its features. The
-4th edition followed the same pattern, using a new version of \teTeX,
-and a new release of \Webc{} (7.3). The system now included a complete
-Windows setup.
-
-For the 5th edition (March 2000) many parts of the \CD{} were revised
-and checked, updating hundreds of packages. Package details were stored
-in XML files. But the major change for \TeX\ Live 5 was that all
-non-free software was removed. Everything in \TL{} is now intended
-to be compatible with the Debian Free Software Guidelines
-(\url{http://www.debian.org/intro/free}); we have done our best to check
-the license conditions of all packages, but we would very much
-appreciate hearing of any mistakes.
-
-The 6th edition (July 2001) had much more material updated. The major
-change was a new install concept: the user could select a more exact set
-of needed collections. Language-related collections were completely
-reorganized, so selecting any of them installs not only macros, fonts,
-etc., but also prepares an appropriate \texttt{language.dat}.
-
-The 7th edition of 2002 had the notable addition of \MacOSX{} support,
-and the usual myriad of updates to all sorts of packages and
-programs. An important goal was integration of the source back with
-\teTeX, to correct the drift apart in versions~5 and~6.
-
-In 2003, with the continuing flood of updates and additions, we found
-that \TL{} had grown so large it could no longer be contained on a
-single \CD, so we split it into three different distributions (see
-section~\ref{sec:multiple-dist}, \p.\pageref{sec:multiple-dist}). In
-addition:
-
-\begin{itemize*}
-\item At the request of the \LaTeX{} team, we changed the standard
- \cmdname{latex} and \cmdname{pdflatex} commands to now use \eTeX{} (see
- \p.\pageref{text:etex}).
-\item The new Latin Modern fonts were included (and are recommended).
-\item Support for Alpha \acro{OSF} was removed
- (\acro{HPUX} support was removed previously), since no one had (or
- volunteered) hardware available on which to compile new binaries.
-\item Windows setup was substantially changed; for the first time
- an integrated environment based on XEmacs was introduced.
-\item Important supplementary programs for Windows
- (Perl, Ghost\-script, Image\-Magick, Ispell) are now installed
- in the \TL{} installation directory.
-\item Font map files used by \cmdname{dvips}, \cmdname{dvipdfm}
- and \cmdname{pdftex} are now generated by the new program
- \cmdname{updmap} and installed into \dirname{texmf/fonts/map}.
-\item \TeX{}, \MF{}, and \MP{} now, by default, output most input
- characters (32 and above) as themselves in output (e.g.,
- \verb|\write|) files,
- log files, and the terminal, i.e., \emph{not} translated using the
- \verb|^^| notation. In \TL{}~7, this translation was
- dependent on the system locale settings; now, locale settings do
- not influence the \TeX{} programs' behavior. If for some reason
- you need the \verb|^^| output, rename the file
- \verb|texmf/web2c/cp8bit.tcx|. (Future releases will have cleaner
- ways to control this.)
-\item This documentation was substantially revised.
-\item Finally, since the edition numbers had grown unwieldy,
- the version is now simply identified by the year: \TL{} 2003.
-\end{itemize*}
-
-\subsection{Present}
-\label{tlcurrent}
-
-2004 saw the usual huge number of updates to packages and programs.
-Here are the most notable changes, including one important backward
-incompatibility:
-
-\begin{itemize}
-
-\item If you have locally-installed fonts which use their own
-\filename{.map} or (much less likely) \filename{.enc} support files, you
-may need to move those support files.
-
-\filename{.map} files are now searched for in subdirectories of
-\dirname{fonts/map} only (in each \filename{texmf} tree), along the
-\envname{TEXFONTMAPS} path. Similarly, \filename{.enc} files are now
-searched for in subdirectories of \dirname{fonts/enc} only, along the
-\envname{ENCFONTS} path. \cmdname{updmap} will attempt to warn about
-problematic files.
-
-For methods of handling this and other information, please see
-\url{http://tug.org/texlive/mapenc.html}.
-
-\item The \TK\ has been expanded with the addition of a \MIKTEX-based
-installable \CD, for those who prefer that implementation to Web2C.
-See section~\ref{sec:struct-tl} (\p.\pageref{sec:struct-tl}).
-
-\item Within \TL, the single large \dirname{texmf} tree of previous
-releases has been replaced by three: \dirname{texmf},
-\dirname{texmf-dist}, and \dirname{texmf-doc}. See
-section~\ref{sec:tld} (\p.\pageref{sec:tld}), and the \filename{README}
-files for each.
-
-\item All \TeX-related input files are now collected in
-the \dirname{tex} subdirectory of \dirname{texmf*} trees, rather than
-having separate sibling directories \dirname{tex}, \dirname{etex},
-\dirname{pdftex}, \dirname{pdfetex}, etc. See
-\CDref{texmf-doc/doc/english/tds/tds.html\#Extensions}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Extensions}}.
-
-\item Helper scripts (not meant to be invoked by users) are now located
-in a new \dirname{scripts} directory of \dirname{texmf*} trees, and
-searched for via \verb|kpsewhich -format=texmfscripts|. So if you have
-programs which call such scripts, they'll need to be adjusted. See
-\CDref{texmf-doc/doc/english/tds/tds.html\#Scripts}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Scripts}}.
-
-\item Almost all formats leave most characters printable as
-themselves via the ``translation file'' \filename{cp227.tcx}, instead of
-translating them with the \verb|^^| notation. Specifically, characters
-at positions 32--256, plus tab, vertical tab, and form feed are
-considered printable and not translated. The exceptions are plain \TeX\
-(only 32--126 printable), \ConTeXt\ (0--255 printable), and the
-\OMEGA-related formats. This default behavior is almost the same as in
-\TL\,2003, but it's implemented more cleanly, with more possibilities
-for customization. See \CDref{texmf/doc/web2c/web2c.html\#TCX-files}
-{\texttt{texmf/doc/web2c/web2c.html\#TCX-files}}.
-(By the way, with Unicode input, \TeX\ may output partial character
-sequences when showing error contexts, since it is byte-oriented.)
-
-\item \textsf{pdfetex} is now the default engine for all formats
-except (plain) \textsf{tex} itself. (Of course it generates \acro{DVI}
-when run as \textsf{latex}, etc.) This means, among other things, that
-the microtypographic features of \textsf{pdftex} are available in
-\LaTeX, \ConTeXt, etc., as well as the \eTeX\ features
-(\OnCD{texmf-dist/doc/etex/base/}).
-
-It also means it's \emph{more important than ever} to use the
-\pkgname{ifpdf} package (works with both plain and \LaTeX) or equivalent
-code, because simply testing whether \cs{pdfoutput} or some other
-primitive is defined is not a reliable way to determine if \acro{PDF}
-output is being generated. We made this backward compatible as best we
-could this year, but next year, \cs{pdfoutput} may be defined even when
-\acro{DVI} is being written.
-
-\item pdf\TeX\ (\url{http://pdftex.org}) has many new features:
-
- \begin{itemize*}
-
- \item \cs{pdfmapfile} and \cs{pdfmapline} provide font map support
- from within a document.
-
- \item Microtypographic font expansion can be used more easily.\\
- \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}
-
- \item All parameters previously set through the special configuration
- file \filename{pdftex.cfg} must now be set through primitives,
- typically in \filename{pdftexconfig.tex}; \filename{pdftex.cfg} is no
- longer supported. Any extant \filename{.fmt} files must be redumped
- when \filename{pdftexconfig.tex} is changed.
-
- \item See the pdf\TeX\ manual for more: \OnCD{texmf/doc/pdftex/manual}.
-
- \end{itemize*}
-
-\item The \cs{input} primitive in \cmdname{tex} (and \cmdname{mf} and
-\cmdname{mpost}) now accepts double quotes containing spaces and other
-special characters. Typical examples:
-\begin{verbatim}
-\input "filename with spaces" % plain
-\input{"filename with spaces"} % latex
-\end{verbatim}
-See the Web2C manual for more: \OnCD{texmf/doc/web2c}.
-
-\item enc\TeX\ support is now included within Web2C and consequently all
-\TeX\ programs, via the \optname{-enc} option\Dash \emph{only when
-formats are built}. enc\TeX\ supports general re-encoding of input and
-output, enabling full support of Unicode (in \acro{UTF}-8). See
-\OnCD{texmf-dist/doc/generic/enctex/} and
-\url{http://www.olsak.net/enctex.html}.
-
-\item Aleph, a new engine combining \eTeX\ and \OMEGA, is available.
-A little information is available in \OnCD{texmf-dist/doc/aleph/base}
-and \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}. The
-\LaTeX-based format for Aleph is named \textsf{lamed}.
-
-\item The latest \LaTeX\ release has a new version of the
-\acro{LPPL}\Dash now officially a Debian-approved license. Assorted
-other updates, see the \filename{ltnews} files in
-\OnCD{texmf-dist/doc/latex/base}.
-
-\item \cmdname{dvipng}, a new program for converting \acro{DVI} to
-\acro{PNG} image files, is included. See \OnCD{texmf/doc/man/man1/dvipng.1}.
-
-\item We reduced the \pkgname{cbgreek} package to a ``medium'' sized set
-of fonts, with the assent and advice of the author (Claudio Beccari).
-The excised fonts are the invisible, outline, and transparency ones,
-which are relatively rarely used, and we needed the space. The full set
-is of course available from \acro{CTAN}
-(\url{http://www.ctan.org/tex-archive/fonts/greek/cb}).
-
-\item \cmdname{oxdvi} has been removed; just use \cmdname{xdvi}.
-
-\item The \cmdname{ini} and \cmdname{vir} commands (links) for
-\cmdname{tex}, \cmdname{mf}, and \cmdname{mpost} are no longer created,
-such as \cmdname{initex}. The \cmdname{ini} functionality has been
-available through the command-line option \optname{-ini} for years now.
-
-\item \textsf{i386-openbsd} platform support was removed. Since the
-\pkgname{tetex} package in the \acro{BSD} Ports system is available, and
-\acro{GNU/}Linux and Free\acro{BSD} binaries were available, it seemed
-volunteer time could be better spent elsewhere.
-
-\item On \textsf{sparc-solaris} (at least), you may have to set the
-\envname{LD\_LIBRARY\_PATH} environment variable to run the
-\pkgname{t1utils} programs. This is because they are compiled with C++,
-and there is no standard location for the runtime libraries. (This is
-not new in 2004, but wasn't previously documented.) Similarly, on
-\textsf{mips-irix}, the \acro{MIPS}pro 7.4 runtimes are required.
-
-\end{itemize}
-
-
-\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
-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
-a great deal remains to be done. If you can help, don't hesitate to put
-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}
-
-\medskip
-\noindent \textsl{Happy \TeX ing!}
-
-\end{multicols}
-\end{document}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/live-2005.tex b/Master/texmf-doc/source/texlive/texlive-en/archive/live-2005.tex
deleted file mode 100644
index 5b525535c63..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/live-2005.tex
+++ /dev/null
@@ -1,3174 +0,0 @@
-% $Id: live.tex 1513 2006-02-13 00:22:35Z karl $
-% TeX Live documentation. Originally written by Sebastian Rahtz and
-% Michel Goossens, now maintained by Karl Berry and others.
-% Public domain.
-%
-\documentclass{article}
-\let\tldocenglish=1 % for live4ht.cfg
-\usepackage{tex-live}
-\begin{document}
-
-\title{%
- {\huge \textit{The \protect\TL{} Guide}\\\strut}
- {\LARGE \textsf{\TK{} 2005}}
-}
-
-\author{Sebastian Rahtz \& Karl Berry, editors \\[3mm]
- \url{http://tug.org/texlive/}
- }
-
-\date{October 2005}
-
-\maketitle
-
-\begin{multicols}{2}
-\tableofcontents
-\listoftables
-\end{multicols}
-
-\section{Introduction}
-\label{sec:intro}
-
-This document describes the main features of the \TL{} software
-distribution\Dash \TeX{} and friends for \acro{GNU}/Linux and other Unix
-flavors, \MacOSX, and (32-bit) Windows systems. (Warning: it is not
-especially useful for older Mac or \acro{MS-DOS} systems.)
-
-\TL{} includes executables for \TeX{}, \LaTeXe{}, \ConTeXt, \MF, \MP,
-\BibTeX{} and many other programs; an extensive collection of macros,
-fonts and documentation; and support for typesetting in many different
-scripts from around the world. It is part of the even larger \TK{}
-(briefly described below in section~\ref{sec:struct-tl},
-\p.\pageref{sec:struct-tl}). Both are cooperative efforts by the \TeX\
-user groups.
-
-For newer versions of the packages included here, please check
-\acro{CTAN}: \url{http://www.ctan.org}.
-
-For a brief summary of the major changes in this edition of \TL{},
-see the end of the document, section~\ref{sec:history}
-(\p.\pageref{sec:history}).
-
-
-\subsection{Basic usage of \protect\TL{}}
-\label{sec:basic}
-
-You can use \TL{} in three principal ways:
-
-\begin{enumerate}
-
-\item You can run \TL{} directly from the \pkgname{live} \DVD
-(see section~\ref{sec:multiple-dist}, \p.\pageref{sec:multiple-dist}).
-This takes almost no disk space, and gives you immediate access to
-everything in \TL{}. Of course performance will be worse than running
-on local disk, but you may well find it useful.
-
-\item You can install all or part of \TL{} to a local disk, from either
-the \DVD\ or the \pkgname{inst} \acro{CD}. This is the most common use
-of \TL. You will need (approximately) 100 megabytes for the most
-minimal system, and upwards of 1.3 gigabytes for a full system.
-
-\item You can integrate a particular package or collection into your
-existing \TeX{} system, either a \TL{} system you installed
-earlier, or a different system.
-
-\end{enumerate}
-
-\noindent All of these are described in detail in the \acro{OS}-specific
-installation sections following, but here is a quick start:
-
-\begin{itemize*}
-
-\item The main installation script for Unix and \MacOSX{} is
-\texttt{install-tl.sh}.
-
-\item The single package installation script is \texttt{install-pkg.sh}.
-
-\item The installation program for Windows is \texttt{tlpmgui.exe}.
-It can be used also for adding or removing the packages.
-See section~\ref{sec:win-install} below for more information.
-
-\end{itemize*}
-
-
-\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.)
-
-Here is a list of resources, approximately in the order we recommend
-using them:
-
-\begin{description}
-\item [Getting Started] If you are new to \TeX, the web page
-\url{http://tug.org/begin.html} gives a brief introduction to the system.
-
-\item [\TeX{} \acro{FAQ}] The \TeX{} \acro{FAQ} is a huge compendium of
-answers to all sorts of questions, from the most basic to the most
-arcane. It is included on \TL{} in \OnCD{texmf-doc/doc/english/FAQ-en}, and is
-available on the Internet through \url{http://www.tex.ac.uk/faq}.
-Please check here first.
-
-\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://www.ctan.org/tex-archive/help/Catalogue}.
-
-\item [\TeX{} Web Resources] The web page
-\url{http://tug.org/interest.html} has many \TeX{}-related links, in
-particular for numerous books, manuals, and articles on all aspects of
-the system.
-
-\item [support archives] The two principal support forums are the
-Usenet newsgroup \url{news:comp.text.tex} and the mailing list
-\email{texhax@tug.org}. Their archives have years of past
-questions and answers for your searching pleasure, via
-\url{http://groups.google.com/groups?group=comp.text.tex} and
-\url{http://tug.org/mail-archives/texhax}, respectively. And a general web
-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:
-\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.
-
-\end{description}
-
-The other side of the coin is helping others who have questions. Both
-\dirname{comp.text.tex} and \code{texhax} are open to anyone, so feel
-free to join, start reading, and help out where you can. Welcome to
-\TeX{}!
-
-
-% don't use \TL so the \uppercase in the headline works. Also so
-% tex4ht ends up with the right TeX. Likewise the \protect's.
-\section{Structure of \protect\TeX\protect\ Live}
-\label{sec:struct-tl}
-
-This section describes the structure and contents of \TL{} and the
-\TK{} of which it is a part.
-
-\subsection{Multiple distributions: \protect\pkgname{live},
- \protect\pkgname{inst},
- \protect\pkgname{protext}}
-\label{sec:multiple-dist}
-
-Space limitations of \acro{CD-ROM} format have forced us to divide
-\TK{} into several distributions, as follows.
-
-\begin{description}
-
-\item [live] A complete system on \acro{DVD}; it is too large
-for \acro{CD}. It can be run live or installed to disk. It also
-includes a snapshot of the \CTAN{} repository, the \pkgname{protext}
-distribution for Windows and the Mac\TeX\ distribution for \MacOSX, entirely
-independent of \TL{}, as well as assorted other packages in a
-\texttt{texmf-extra} directory.
-
-\CTAN{}, \pkgname{protext}, Mac\TeX, and \texttt{texmf-extra} do not follow
-the same copying conditions as \TL{}, so be careful when redistributing or
-modifying.
-
-\item [inst(allable)] A complete system on \CD; in order to make this fit,
-the packages and programs are compressed. Therefore, it is not possible
-to run \TeX\ directly from the installable \CD, you have to install it
-to disk (hence its name). Installation is described in subsequent sections.
-
-\item [protext] 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}.
-
-\ProTeXt\ is provided as both the top level of the \pkgname{live} \DVD\
-and on its own \CD\ (for those who cannot use the \DVD).
-
-\end{description}
-
-\noindent You can tell which type of distribution you're in by looking
-for a \texttt{00\var{type}.TL} file at the top of the \TL{} directory.
-This file also contains the \TL{} release date.
-
-Naturally, each user group chooses what to distribute, at its own
-discretion. (\acro{TUG} is sending all three discs above to all of its
-members.)
-
-
-\subsection{Top level directories}
-\label{sec:tld}
-
-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
-level of the disc.
-
-\smallskip
-\begingroup
- \renewcommand{\arraystretch}{1.3} % open up interrow spacing
-\begin{tabular}{>{\ttfamily}lp{.78\hsize}}
-bin & The \TeX{} system programs, arranged by platform. \\
-source & The source of all programs, including the main \Webc{}
- \TeX{} and \MF{} distributions. These are stored in a
- \cmdname{bzip2}-compressed tar archive. \\
-support & Assorted auxiliary packages and programs. These are
- \emph{not} installed automatically. This includes
- assorted editors and \TeX\ shells. \\
-texmf & Tree for the programs, along with their support files and
- documentation. Does not include \TeX\ formats and packages.
- (\texttt{TEXMFMAIN} in the next section.) \\
-texmf-dist & The main tree of formats and packages.
- (\texttt{TEXMFDIST} in the next section.) \\
-texmf-doc & Tree for self-contained pure documentation, arranged by
- language. \\
-texmf-var & Tree for files automatically generated and stored.
- (\texttt{TEXMFSYSVAR} in the next section.) \\
-xemtex & Tree for supporting programs used only in Windows.
- These programs generally come pre-installed on Unix systems, or are
- at least easy to compile. \\
-\end{tabular}
-\endgroup
-
-\smallskip
-
-In addition to the directories above, the installation scripts and
-\filename{README} files (in various languages) are at the top level of
-the distribution.
-
-The \dirname{texmf-doc} directory contains only documentation, but
-it does not contain all the documentation. The documentation for the
-programs (manuals, man pages, Info files) is in \dirname{texmf/doc},
-since the programs are in \dirname{texmf}. Similarly, the documentation
-for \TeX\ packages and formats is in \dirname{texmf-dist/doc}. You can
-use the \cmdname{texdoc} or \cmdname{texdoctk} programs to find any
-documentation wherever it's located. The comprehensive links in the
-top-level file \OnCD{doc.html} may also be helpful.
-
-
-\subsection{Overview of the predefined texmf trees}
-\label{sec:texmftrees}
-
-This section lists all predefined variables specifying texmf trees used
-by the system, and their intended purpose. The command \texttt{texconfig
-conf} shows you the values of these variables, so that you can easily
-find out how they map to directory names in your installation.
-
-\begin{ttdescription}
-\item [TEXMFMAIN] The tree which holds vital parts of the system
- such as helper scripts (e.g., \verb+web2c/mktexdir+), pool files and
- other support files.
-\item [TEXMFDIST] The tree which holds the main set of macro packages,
- fonts, etc., as originally distributed.
-\item [TEXMFLOCAL] The tree which administrators can use for system-wide
- installation of additional or updated macros, fonts, etc.
-\item [TEXMFHOME] The tree which users can use for their own individual
- installations of additional or updated macros, fonts, etc.
- The expansion of this variable depends on \verb+$HOME+ by default, % $
- which dynamically adjusts for each user to an individual
- directory.
-\item [TEXMFCONFIG] The tree used by te\TeX's utilities
- \verb+texconfig+, \verb+updmap+, and \verb+fmtutil+ to store modified
- configuration data. Under \verb+$HOME+ by default. %$
-\item [TEXMFSYSCONFIG] The tree used by te\TeX's utilities
- \verb+texconfig-sys+, \verb+updmap-sys+, and \verb+fmtutil-sys+ to
- store modified configuration data.
-\item [TEXMFVAR] The tree used by \verb+texconfig+, \verb+updmap+ and
- \verb+fmtutil+ to store (cached) runtime data such as format files and
- generated map files. Under \verb+$HOME+ by default. %$
-\item [TEXMFSYSVAR] The tree used by \verb+texconfig-sys+,
- \verb+updmap-sys+ and \verb+fmtutil-sys+ to store (cached) runtime
- data such as format files and generated map files.
-\end{ttdescription}
-
-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}
-
-\TL{} contains several extended versions of \TeX:
-
-\begin{description}
-
-\item [\eTeX] adds a small but powerful set of new primitives
-\label{text:etex} (related to macro expansion, character scanning,
-classes of marks, additional debugging features, and more) and the
-\TeXXeT{} extensions for bidirectional typesetting. In default mode,
-\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
-\OnCD{texmf/doc/pdftex/manual/} for the manual, and
-\OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.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 [\OMEGA\ (Omega)] is based on Unicode (16-bit characters), thus
-supports working with almost all the world's scripts simultaneously. It
-also supports so-called `\OMEGA{} Translation Processes' (\acro{OTP}s),
-for performing complex transformations on arbitrary input. See
-\OnCD{texmf-dist/doc/omega/base/doc-1.8.tex} (not completely up-to-date).
-
-\item [Aleph] combines the \OMEGA\ and \eTeX\ extensions.
-See \OnCD{texmf-dist/doc/aleph/base} for some minimal documentation.
-
-\end{description}
-
-
-\subsection{Other notable programs in \protect\TL}
-
-Here are a few other commonly-used programs included in \TL{}:
-
-\begin{cmddescription}
-
-\item [bibtex] bibliography support.
-
-\item [makeindex] index support.
-
-\item [dvips] convert \dvi{} to \PS{}.
-
-\item [xdvi] \dvi{} previewer for the X Window System.
-
-\item [dvilj] \dvi{} drive for the HP LaserJet family.
-
-\item [dv2dt, dt2dv] convert \dvi{} to/from plain text.
-
-\item [dviconcat, dviselect] cut and paste pages
-from \dvi{} files.
-
-\item [dvipdfmx] convert \dvi{} to \acro{PDF}, an alternative approach
-to pdf\TeX\ (mentioned above). See the \pkgname{ps4pdf} and
-\pkgname{pdftricks} packages for still more alternatives.
-
-\item [psselect, psnup, \ldots] \PS{}
-utilities.
-
-\item [lacheck] \LaTeX{} syntax checker.
-
-\item [texexec] Con\TeX{}t and \acro{PDF} processor.
-
-\item [tex4ht] \TeX{} to \acro{HTML} converter.
-
-\end{cmddescription}
-
-
-\section{Unix installation}
-\label{sec:unix-install}
-
-As introduced in section~\ref{sec:basic} (\p.\pageref{sec:basic}),
-\TL{} has three principal uses:
-
-\begin{enumerate}
-\item Run directly from media.
-\item Install to disk.
-\item Integrate a particular package or collection into your existing
-\TeX{} installation.
-\end{enumerate}
-
-\noindent The following sections describes the Unix-specific procedures
-for each of these.
-
-\ifSingleColumn \begin{figure}[ht]\noindent \fi
-\begin{warningbox}
-\textbf{Warning: } The \TK{} \CD{}s and \DVD{} are in ISO 9660 (High Sierra)
-format, \emph{with} Rock Ridge (and Joliet, for Windows)
-extensions. Therefore, in order to take full advantage of the \TK{}
-under Unix, your system needs to be able to use the Rock Ridge
-extensions. Please consult the documentation for your \cmdname{mount}
-command to see how to do this. If you have several different machines
-on a local network, you may be able to mount the discs on one which
-does support Rock Ridge, and use this with the others.
-
-\leavevmode\quad Modern systems should be able to use the discs without
-problems. If troubles, let us know. The discussion below assumes you
-have been able to mount the \CD{}s with full Rock Ridge compatibility.
-\end{warningbox}
-\ifSingleColumn\end{figure}\fi
-
-
-%
-\subsection{Running \protect\TL{} directly from media (Unix)}
-
-\def\runlive{% text repeated in windows section
-It is possible to use the \TeX{} system directly from the \pkgname{live}
-\DVD{}, without installing the distribution to disk. (Thus the name
-\TeX\ `Live', in fact.) It is \emph{not} possible to run \TeX{}
-directly from the other \CD{}s (see section~\ref{sec:multiple-dist},
-\p.\pageref{sec:multiple-dist}).
-}
-
-\def\startinst{% repeated in other subsections
-To start, you mount the \CD{} or \DVD{}, with Rock Ridge extensions
-enabled. The exact command to do this varies from system to system; the
-following works under Linux, except the name of the device
-(\filename{/dev/cdrom}, here) may vary. (All our examples will use
-\texttt{>} as the shell prompt; user input is
-\Ucom{\texttt{underlined}}.)
-\begin{alltt}
-> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom}
-\end{alltt}
-
-\noindent Change the current directory to the mount point:
-\begin{alltt}
-> \Ucom{cd /mnt/cdrom}
-\end{alltt}
-
-\noindent Under \MacOSX, the directory is typically under
-\dirname{/Volumes}, and the media will be mounted automatically.
-}
-
-\def\installtlsh{
-Run the installation script \filename{install-tl.sh}:
-\begin{alltt}
-> \Ucom{sh install-tl.sh}\\
-Welcome to TeX Live...
-\end{alltt}
-
-\noindent After various greeting messages and a list of the main menu
-options, the installation will ask you to enter a command. Do this by
-typing the desired character and hitting return; don't type the angle
-brackets shown. Either uppercase or lowercase is ok; we'll use
-lowercase in our examples.
-}
-
-\runlive
-\startinst
-\installtlsh
-
-For running live, our first command will be \Ucom{d} and then the
-subcommand \Ucom{1} to set directories. Even in this case, we must
-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
-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
-step.)
-
-\begin{alltt}
-Enter command: \Ucom{d}
-Current directories setup:
-<1> TEXDIR: /usr/local/texlive/2005
-...
-Enter command: \Ucom{1}
-New value for TEXDIR [/usr/local/texlive/TeX]: \Ucom{/opt/texlive2005}
-...
-Enter command: \Ucom{r}
-\end{alltt}
-
-\noindent Back at the main menu, our second and last command is
-\Ucom{r}, to set up for running live off the media without installing
-to disk:
-\begin{alltt}
-Enter command: \Ucom{r}
-Preparing destination directories...
-...
-Welcome to TeX Live!
->
-\end{alltt}
-
-\noindent And we are back at the system prompt, as shown.
-
-Next, it is necessary to alter two environment variables:
-\envname{PATH}, to an architecture-dependent value (so that we can run
-the programs), and \envname{TEXMFSYSVAR}, to the value specified above.
-See table~\ref{tab:archlist} for a list of the architecture names for
-the different systems.
-
-
-\def\textruntexconfig{%
-After the main installation has completed, and environment variables
-have been set, the last step is to run \cmdname{texconfig} or
-\cmdname{texconfig-sys} to customize your installation to your needs.
-This is explained in section~\ref{sec:texconfig},
-\p.\pageref{sec:texconfig}.
-}
-\textruntexconfig
-
-\begin{table*}[ht]
-\caption[Supported system architectures.]{Supported system
-architectures.}
-\label{tab:archlist}
-\begin{tabular}{>{\ttfamily}ll}
-alpha-linux & HP Alpha GNU/Linux \\
-%alphaev5-osf4.0d & HP Alphaev5 OSF \\
-%hppa2.0-hpux10.20 & HP9000 HPUX 10.20 \\
-i386-darwin & Intel x86 \MacOSX \\
-i386-freebsd & Intel x86 FreeBSD \\
-i386-linux & Intel x86 GNU/Linux \\
-%i386-openbsd3.3 & Intel x86 OpenBSD \\
-%i386-solaris2.8 & Intel x86 Solaris \\
-mips-irix & SGI IRIX \\
-powerpc-aix & IBM RS/6000 AIX \\
-powerpc-darwin & PowerPC \MacOSX \\
-sparc-linux & Sun Sparc GNU/Linux \\
-sparc-solaris & Sun Sparc Solaris \\
-win32 & Windows (32-bit) \\
-x86\_64-linux & Intel x86 64-bit GNU/Linux \\
-\hline
-\end{tabular}
-\end{table*}
-
-\label{text:path}
-The syntax for setting the environment variables, and the initialization
-file to put them in, depends on the shell you use. If you use a
-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
-\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
-\end{alltt}
-
-\noindent Then log out, log back in, and test your installation
-(see section~\ref{sec:test-install}, \p.\pageref{sec:test-install}).
-
-\def\textifindoubt{%
-If in doubt, please ask any local system gurus to help you with
-problems; for example, the way to mount the \TL{} media, which
-directory or directories to use, and precise details of the changes to
-your personal initialization files can and do vary from site to site.
-}
-\textifindoubt
-
-
-%
-\subsection{Installing \protect\TeX\protect\ Live to disk}
-\label{sec:unix-install-disk}
-
-It is possible, indeed typical, to install the \TL{} distribution to
-hard disk. This can be done from either the \pkgname{live} or
-\pkgname{inst} distributions. (See section~\ref{sec:multiple-dist},
-\p.\pageref{sec:multiple-dist}, for an explanation of the different
-distributions.)
-
-\startinst
-\installtlsh
-
-Table~\ref{tab:main-menu-options} briefly lists the options in the main
-menu. The order in which you select the options makes little
-difference, except that \Ucom{i} must be last. It's reasonable to go
-through them in the order presented here.
-
-% apparently here.sty [H] doesn't support table*.
-\begin{table}[H]
-\caption{Main menu options for the installation.}
-\label{tab:main-menu-options}
-\begin{tabular}{>{\ttfamily}ll}
-p & The platform you are running on.\\
-b & The architectures for which to install binaries.\\
-s & The base installation scheme to use (minimal, recommended,
- full, etc.)\\
-c & Override the base scheme for individual collections.\\
-l & Override for language collections.\\
-d & Directories in which to install.\\
-o & Other options.\\
-i & Perform the installation.\\
-\end{tabular}
-\end{table}
-
-Here are further details on each option.
-
-\textbf{\optname{p} -- Current platform.} Since the installation script
-automatically guesses which platform you're running on, it is usually
-unnecessary to use this option. It's there in case you need to override
-the automatic detection.
-
-\textbf{\optname{b} -- Binary architectures.} By default, only the
-binaries for your current platform will be installed. From this menu,
-you can select installation of binaries for other architectures as well
-(or omit installing the current platform). This can be useful if you are
-sharing a \TeX\ tree across a network of heterogenous machines. For a
-list of the supported architectures, see table~\ref{tab:archlist},
-\p.\pageref{tab:archlist}.
-
-\textbf{\optname{s} -- Base installation scheme.} From this menu, you
-can choose an overall set of package collections, called a ``scheme''.
-The default \optname{full} scheme installs everything available, but you
-can also choose the \optname{basic} scheme for a minimal system, or
-\optname{medium} to get something in between. There are also specific
-sets for Omega and \acro{XML}.
-
-\textbf{\optname{c} -- Individual collections.} From this menu, you can
-override the scheme's set of collections to install. Collections are
-one level more detailed than schemes\Dash collections consist of one or
-more packages, where packages (the lowest level grouping in \TL) contain
-the actual \TeX\ macro files, font families, and so on. In this menu,
-selection letters are case-sensitive.
-
-\textbf{\optname{l} -- Language collections}. This menu has the same
-basic purpose as \Ucom{c}, to override the collection set in the chosen
-scheme. In this case, the collections are specifically for different
-languages. Selection letters are case-sensitive here too. Here is a
-list of the language collections in \TL:
-
-% xx really should generate list from texmf/tpm/collection/tex-lang*
-% a la install-tl.sh.
-\begin{tabbing}
-\hspace{.25\linewidth} \=
-\hspace{.25\linewidth} \=
-\hspace{.25\linewidth} \=
-\hspace{.25\linewidth} \kill
-(some) African scripts \>
-Arabic \>
-Armenian \>
-Chinese\,Japanese\,Korean \\
-Croatian \>
-Cyrillic \>
-Czech/Slovak \>
-Danish \\
-Dutch \>
-Finnish \>
-French \>
-German \\
-Greek \>
-Hebrew \>
-Hungarian \>
-Indic \\
-Italian \>
-Latin \>
-Manju \>
-Mongolian \\
-Norwegian \>
-Polish \>
-Portuguese \>
-Spanish \\
-Swedish \>
-Tibetan \>
-\acro{UK} English \>
-Vietnamese \\
-\end{tabbing}
-
-\noindent Language collections typically include fonts, macros,
-hyphenation patterns, and other support files. (For instance,
-\pkgname{frenchle.sty} is installed if you select the \optname{French}
-collection.) In addition, installing a language collection will alter
-the \filename{language.dat} configuration file controlling which
-hyphenation patterns are loaded.
-
-\textbf{\optname{d} -- Installation directories}. Three directories can
-be changed here:
-\label{text:instdir}
-
-\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
-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
-update after testing the new release.)
-
-Under \MacOSX, the usual frontends look for \TeX{} in
-\dirname{/usr/local/teTeX}, so you may wish to install \TL{} there.
-
-\item [TEXMFLOCAL] This tree is where the \TeX{} system (not as part of
-the initial installation, but rather as time goes by) puts
-non-version-specific files, primarily fonts. The default value is
-\dirname{/usr/local/texlive/texmf-local}, independent of the current
-\TL{} release, because it's also the recommended location to put any
-local packages or configuration settings.
-
-\item [TEXMFSYSVAR] This tree is where \cmdname{texconfig-sys} puts
-files that \emph{are} version-specific. The default value is
-\dirname{TEXDIR/texmf-var}, and there's generally no reason to change
-it. There is also \envname{TEXMFSYSCONFIG}, which is where
-\cmdname{texconfig} looks for modified configuration data. See
-section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig} for more
-information.
-
-\end{ttdescription}
-
-\textbf{\optname{o} -- Other options.} From this menu, you can select
-the following general options:
-
-\begin{ttdescription}
-\item [a] Specify an alternate directory for generated fonts.
-The default is to use the \envname{TEXMFVAR} tree, as explained above.
-Setting this is useful if you plan to mount the main tree read-only, and
-therefore you need another location (perhaps host-specific) for
-dynamically created fonts.
-
-\item [l] Create symbolic links for the binaries, man pages,
-and\slash or \acro{GNU} Info files in other locations. For example, you may
-wish to make the man pages available under \dirname{/usr/local/man} and
-the Info files available under \dirname{/usr/local/info}. (Of course
-you need appropriate privileges to write in the specified directories.)
-
-It is not advisable to overwrite a \TeX\ system that came with your
-system with this option. It's intended primarily for creating the links
-in standard directories that are known to users, such as
-\dirname{/usr/local/bin}, which don't already contain any \TeX\ files.
-
-\item [d] Skip installation of the font/macro documentation tree.
-This is useful if you need to save space, or if you've previously
-installed the documentation elsewhere.
-
-\item [s] Skip installation of the main font/macro source
-tree. This is useful if you are arranging to share that tree between
-machines and\slash or architectures in some other way, such as \acro{NFS}.
-
-\end{ttdescription}
-
-\textbf{i -- Perform installation.} When you're satisfied with your
-configuration options, enter \Ucom{i} to actually do the installation
-from the media to your chosen locations.
-
-% text is similar to above, but no TEXMFSYSVAR, so we have to write out.
-After the installation completes, your next step is to include the
-architecture-specific subdirectory of \dirname{TEXDIR/bin} in your
-\envname{PATH}, so the newly-installed programs can be found. The
-architecture names are listed in table~\ref{tab:archlist},
-\p.\pageref{tab:archlist}, or you can simply list the directory
-\dirname{TEXDIR/bin}.
-
-The syntax for doing this, and the initialization file to use, depends
-on your shell. If you use a Bourne-compatible shell (\cmdname{sh},
-\cmdname{bash}, \cmdname{ksh}, et al.), put the following into your
-\filename{$HOME/.profile} file:
-
-\begin{alltt}
-PATH=/usr/local/texlive/2005/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
-\end{alltt}
-
-\textruntexconfig
-
-Here is a minimal annotated example which accepts the default
-directories and installs binaries for the current system only. Thus,
-only one command is needed, \Ucom{i} for install. The \texttt{>} is the
-shell prompt as usual.
-
-\begin{alltt}
-> \Ucom{sh install-tl.sh}
-\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}
-\end{alltt}
-
-\textifindoubt
-
-
-%
-\subsection{Installing individual packages to disk}
-
-You can add individual packages or collections from the current
-distribution to an existing non-\TL{} setup, or an earlier
-\TL{} installation.
-
-\startinst
-
-Run the installation script \filename{install-pkg.sh} (not
-\filename{install-tl.sh}, which is intended for complete installations
-only):
-\begin{alltt}
-> \Ucom{sh install-pkg.sh \var{options}}
-\end{alltt}
-
-The first set of options controls what gets read:
-
-\begin{ttdescription}
-\item [-{}-package=\var{pkgname}] The individual package to work on.
-
-\item [-{}-collection=\var{colname}] The individual collection to work on.
-
-\item [-{}-nodoc] Exclude documentation files from the operation.
-
-\item [-{}-nosrc] Exclude source files from the operation.
-
-\item [-{}-cddir=\var{dir}] Source directory to read from; defaults
-to the current directory. If you followed the instructions above, that
-will be the distribution directory, and won't need to be changed.
-
-\item [-{}-listdir=\var{dir}] The so-called `lists' directory within
-\var{cddir} from which to read the package information. The only
-reason to change the default is if you're making changes to \TL{}
-yourself.
-
-\end{ttdescription}
-
-What actually happens is controlled by the following options. If
-neither of these are specified, the default action is to install the
-selected files. The main destination tree is found by expanding
-\envname{\$TEXMFMAIN} with \cmdname{kpsewhich}. You can override it by
-setting either the environment variable \envname{TEXMFMAIN} or
-\envname{TEXMF}.
-
-\begin{ttdescription}
-\item [-{}-listonly] List the files that would be installed, but don't
-actually install anything.
-
-\item [-{}-archive=\var{tarfile}] Instead of installing the files into
-the \TeX{} system, make a \cmdname{tar} archive.
-
-\end{ttdescription}
-
-Additional options:
-
-\begin{ttdescription}
-
-\item [-{}-config] After installation, run \code{texconfig init}.
-
-\item [-{}-nohash] After installation, don't run \cmdname{mktexlsr} to
-rebuild the filename database.
-
-\item [-{}-verbose] Give more information as the script runs.
-
-\end{ttdescription}
-
-Here are some usage examples:
-
-\begin{enumerate}
-
-\item To see the files in the package \pkgname{fancyhdr} without
-installing it:
-
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=fancyhdr --listonly}
-\else> \Ucom{sh install-pkg.sh --package=fancyhdr \bs}
-> \Ucom{--listonly}
-\fi{}
-texmf/doc/latex/fancyhdr/README
-texmf/doc/latex/fancyhdr/fancyhdr.pdf
-...
-\end{alltt}
-
-\item Install the \LaTeX{} package \pkgname{natbib}:
-\begin{alltt}
-> \Ucom{sh install-pkg.sh --package=natbib}
-\end{alltt}
-
-\item Install the \LaTeX{} package \pkgname{alg} without source files or
-documentation:
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=alg --nosrc --nodoc}
-\else> \Ucom{sh install-pkg.sh -{}-package=alg \bs}
-> \Ucom{-{}-nosrc -{}-nodoc}
-\fi\end{alltt}
-
-\item Install all the packages in the collection of additional
-plain \TeX\ macros:
-\begin{alltt}
-> \Ucom{sh install-pkg.sh --collection=tex-plainextra}
-\end{alltt}
-
-\item Write all files in the \pkgname{pstricks} package to a
-\cmdname{tar} file in \path|/tmp|:
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=pstricks --archive=/tmp/pstricks.tar}
-\else
-> \Ucom{sh install-pkg.sh -{}-package=pstricks \bs}
-> \Ucom{-{}-archive=/tmp/pstricks.tar}
-\fi\end{alltt}
-
-\end{enumerate}
-
-\textifindoubt
-
-
-%
-\section{Post-installation}
-\label{sec:postinstall}
-
-After the main installation is done, for any operating system, the
-remaining steps are to configure the system for your local needs, and
-perform some basic tests.
-
-Another sort of post-installation is to acquire packages, fonts, or
-programs that were not included in \TL{}. The basic idea is to
-install such additions in the \envname{TEXMFLOCAL} tree (if you
-installed to disk), or \envname{TEXMFSYSVAR} (if you are running live).
-See the ``Installation directories'' option on \p.\pageref{text:instdir}.
-
-Unfortunately, the details can and do vary widely, and so we do not attempt to
-address them here. Here are some external links to descriptions:
-\begin{itemize*}
-\item
-\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages}
-\item
-\url{http://www.ctan.org/installationadvice}
-\item
-\url{http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst}
-\item
-\url{http://www.ctan.org/tex-archive/info/Type1fonts} for
-installation information for fonts in particular.
-\end{itemize*}
-
-
-\subsection{The \protect\cmdname{texconfig} program}
-\label{sec:texconfig}
-
-At any time after installation, you can and should use the program
-\cmdname{texconfig} to configure the system to fit your local needs. It
-is installed in the architecture-specific subdirectory
-\texttt{TEXDIR/bin/\var{arch}} along with everything else.
-
-If you run it without arguments, it will enter full-screen mode and
-allow you to view and change options interactively.
-
-You can also run it with various command-line options. Here are some of
-the most common (\TL{} is configured for the A4 paper size by default):
-
-\begin{ttdescription}
-
-\item [texconfig paper letter] Set default paper size for
-various programs and drivers (\cmdname{pdftex}, \cmdname{dvips},
-\cmdname{dvipdfm}, \cmdname{xdvi}) to be \acro{US} letter. The other
-allowable size is \optname{a4}, which is the default.
-
-\item [texconfig rehash] Update all the \TeX{} ``filename databases'',
-after adding or removing files.
-
-\item [texconfig faq] Show the \teTeX{} \acro{FAQ}.
-(See also the main \TeX{} \acro{FAQ} in \OnCD{texmf-doc/doc/english/FAQ-en}.)
-
-\item [texconfig help] Output help information for \cmdname{texconfig}.
-
-\end{ttdescription}
-
-Of course, \cmdname{texconfig} can only support changing a few of the
-many options and configuration parameters in a \TeX{} system. The main
-configuration file for the base \Webc{} programs is named
-\filename{texmf.cnf}. You can find its location by running
-\samp{kpsewhich texmf.cnf}; it contains many comments explaining the
-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\
-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
-directories, use \cmdname{updmap-sys} and \cmdname{fmtutil-sys}.
-
-In particular, for multi-user systems, you will probably want to
-pregenerate the standard formats with \texttt{fmtutil-sys --missing}.
-Otherwise, each user will end up with their own formats.
-
-Also, if you have a personally-modified copy of \filename{fmtutil.cnf}
-or \filename{updmap.cfg}, instead of using the ones generated by
-installation, they must be installed in the tree referenced by the
-variable \envname{TEXMFSYSCONFIG}.
-
-The variables specifying the directories altered by these commands are
-listed in section~\ref{sec:texmftrees}, \p.\pageref{sec:texmftrees}.
-You can see the actual directories by running \texttt{texconfig conf},
-and you can change them by editing \filename{texmf.cnf}.
-
-
-\subsection{Testing the installation}
-\label{sec:test-install}
-
-After installing \TL{} as best you can, you naturally want to test
-it out, so you can start creating beautiful documents and\slash or fonts.
-
-This section gives some basic procedures for testing that the new system
-is functional. We give Unix commands; under \MacOSX{} and Windows,
-you're more likely to run the tests through a graphical interface, but
-the principles are the same.
-
-\begin{enumerate}
-
-\item Make sure that you can run the \cmdname{tex} program in the first
-place:
-
-\begin{alltt}
-> \Ucom{tex -{}-version}
-TeX 3.141592 (Web2C 7.5.5)
-kpathsea version 3.5.5
-...
-\end{alltt}
-If this comes back with `command not found' instead of version and
-copyright information, most likely you don't have the correct
-\dirname{bin} subdirectory in your \envname{PATH}. See
-the environment-setting information on \p.\pageref{text:path}.
-
-\item Process a basic \LaTeX{} file:
-\begin{alltt}
-> \Ucom{latex sample2e.tex}
-This is pdfeTeXk, Version 3.141592...
-...
-Output written on sample2e.dvi (3 pages, 7496 bytes).
-Transcript written on sample2e.log.
-\end{alltt}
-If this fails to find \filename{sample2e.tex} or other files, perhaps
-you have interference from old environment variables or configuration
-files. For a deep analysis, you can always ask \TeX{} to report on
-exactly what it is searching for, and finding; see ``Debugging actions''
-on page~\pageref{Debugging}.
-
-\item Preview the result online:
-\begin{alltt}
-> \Ucom{xdvi sample2e.dvi}
-\end{alltt}
-(Under Windows, the analogous command is \cmdname{windvi}.) You should
-see a new window with a nice document explaining some of the basics of
-\LaTeX{}. (Well worth reading, by the way if you're new to the system.)
-You do have to be running under X for \cmdname{xdvi} to work; if you're
-not, or your \envname{DISPLAY} environment variable is set incorrectly,
-you'll get an error \samp{Can't open display}.
-
-\item Create a \PS{} file for printing or display:
-\begin{alltt}
-> \Ucom{dvips sample2e.dvi -o sample2e.ps}
-\end{alltt}
-
-\item Create a \acro{PDF} file instead of \dvi{}; this processes the
-\filename{.tex} file and writes \acro{PDF} directly:
-\begin{alltt}
-> \Ucom{pdflatex sample2e.tex}
-\end{alltt}
-
-\item Preview the \acro{PDF} file:
-\begin{alltt}
-> \Ucom{gv sample2e.pdf}
-\textrm{or:}
-> \Ucom{xpdf sample2e.pdf}
-\end{alltt}
-Unfortunately neither \cmdname{gv} nor \cmdname{xpdf} are currently
-included in \TL{}, so you must install them separately. See
-\url{http://www.gnu.org/software/gv} and
-\url{http://www.foolabs.com/xpdf}, respectively.
-
-\item Other standard test files you may find useful:
-
-\begin{ttdescription}
-\item [small2e.tex] A simpler document than \filename{sample2e}, to
-reduce the input size if you're having troubles.
-\item [testpage.tex] Test if your printer introduces any offsets.
-\item [nfssfont.tex] For printing font tables and tests.
-\item [testfont.tex] Also for font tables, but using plain \TeX{}.
-\item [story.tex] The most canonical (plain) \TeX{} test file of all.
-You must type \samp{\bs bye} to the \code{*} prompt after \samp{tex
-story.tex}.
-\end{ttdescription}
-You can process these in the same way as we did with
-\filename{sample2e.tex}.
-
-\end{enumerate}
-
-If you are new to \TeX{}, or otherwise need help with actually
-constructing \TeX{} or \LaTeX{} documents, please visit
-\url{http://tug.org/begin.html} for some introductory resources.
-
-
-\section{\MacOSX{} installation}
-\label{sec:mac-install}
-
-The recommended way to install \TeX\ on \MacOSX\ is from the Mac\TeX\
-distribution, new in 2005. This is provided on the \pkgname{live}
-\DVD{} in the top-level \dirname{mactex/} directory. It contains its
-own (native) installer for a full \TeX\ distribution, based on a
-combination of te\TeX\ and \TL, along with many additional applications
-and documentation. The project web page is \url{http://tug.org/mactex}.
-
-If you prefer, installation of \TeX{} under \MacOSX{} can also be done
-directly from \TL, using the \filename{install*} scripts, as follows.
-
-In order to run the installation scripts under \MacOSX, you need to have
-the \cmdname{bash} shell installed. If you are running \MacOSX~10.2
-or later, you have \cmdname{bash}, and can proceed. If you're running
-an earlier \MacOSX{} version, however, the default shell is
-\cmdname{zsh}, which won't work; you'll need to get \cmdname{bash} from
-the Internet, or more likely upgrade your system.
-
-Once you have \cmdname{bash}, the Unix installation documentation in the
-previous section can be followed. See section~\ref{sec:unix-install} on
-\p.\pageref{sec:unix-install}; \MacOSX-specific notes are included there
-where needed.
-
-\section{Windows installation}
-\label{sec:win-install}
-
-In this release of \TL{}, happily, the distribution once
-again has a native Windows installer, named \cmdname{tlpmgui.exe}. (See
-section~\ref{sec:multiple-dist}, \p.\pageref{sec:multiple-dist}, for an
-explanation of the different distributions.)
-
-\cmdname{tlpmgui} has essentially the same options as the Unix
-installer, only done through a GUI interface: selecting schemes,
-individual collections, installation directories, and so on.
-Section~\ref{sec:unix-install-disk} on
-\p.\pageref{sec:unix-install-disk} describes the basic elements. It
-also allows some post-installation activities such as adding/removing
-packages, updating the filename database and building formats.
-Moreover, \cmdname{tlpmgui} can setup the system for running
-programs directly from the \DVD.
-
-For those who like to look underneath the hood, \cmdname{tlpmgui} uses
-as its ``engine'' a command-line Windows program named \cmdname{tlpm}.
-
-The Windows \TeX{} system included in \TL{} is based on new binaries
-borrowed from the \XEmTeX{} project, formerly known as \fpTeX{} (see
-\url{http://www.metz.supelec.fr/~popineau/xemtex-1.html}).
-It also includes some older (but still working) tools, notably
-a \texttt{dvi} previewer, \textsf{Windvi}, which is similar in usage to
-the established Unix \textsf{xdvi}. The documentation can be found in
-\OnCD{texmf/doc/html/windvi/windvi.html}.
-
-\TL{} can be installed on systems running Windows 98, \acro{ME},
-\acro{NT}, \acro{2K} or \acro{XP}. Older versions of Windows (3.1x)
-and \acro{MS-DOS} are not supported.
-
-\textbf{Warning:} Win9.x users must ensure they have enough environment
- space before undertaking installation. The \cmdname{tlpmgui.exe}
- program won't change the environment size for them. A few environment
- variables will be created and it is possible you run out of
- environment space. Add \texttt{SHELL=<path>COMMAND.COM /E:4096 /P} in the
- config.sys file in order to increase your environment size.
-
-\subsection{Installing \protect\TeX\protect\ Live to disk}
-
-After inserting the \TL{} CD into the \acro{CD} drive, autostart should
-activate \cmdname{tlpmgui}. If it does not, click \guiseq{Start\arw Run},
-then type \verb|<drive letter>:\setup-win32\tplmgui.exe| (or
-\verb|<drive letter>:\texlive\setup-win32\tplmgui.exe| if you are
-installing from the TeX Collection DVD), where \verb|<drive letter>|
-is the drive letter with the TeX Live CD (or TeX Collection DVD), and
-then click OK.
-
-The installation window titled \guiseq{TeX Live installation and maintenance
-utility} should open. It contains the following sections: \guiseq{Main
-customization}, \guiseq{Install}, \guiseq{Select a scheme}, \guiseq{Select
-systems}, \guiseq{Directories} and \guiseq{Options}.
-
-In the \guiseq{Directories} section the installation drive (directory) next
-to the \guiseq{CD/DVD} button should be displayed (e.g., \texttt{F:/} or \texttt{F:/texlive/} for the DVD), but
-if it is not, then click the \guiseq{CD/DVD} button and select the \acro{CD/DVD}
-drive, with the \TL{} CD (or TeX Collection DVD).
-
-The directory in which you wish to install the software can be set by
-clicking the \guiseq{TLroot} button. This directory will be set as
-\path|TLroot| environment variable for later usage. The \path|TEXMFTEMP| and
-\path|TEXMFCNF| environment variables as displayed next to the
-\guiseq{TEXMFTEMP} and \guiseq{TEXMFCNF} buttons will be adjusted
-automatically and set during installation, but they can also be adjusted
-manually now to suit special needs.
-
-In the \guiseq{Select a scheme} section the desired \TL{} installation scheme
-should be chosen by clicking the radio button labelled with the installation
-scheme name (e.g., \guiseq{scheme-gust}). Each scheme is accompanied by an
-\guiseq{Info} button which, when clicked, displays a short description of the
-relevant scheme.
-
-A scheme is a large set of files targeted at some kind of usage. There are
-generic schemes for basic, medium and full installations. The remaining ones
-are either targeted at certain LUGs (i.e., what GUST or GUTenberg propose
-for their members) or application targeted (e.g., for XML and \TeX{}
-cooperation). A preselected scheme can be refined. This is done in the
-\guiseq{Main customization} section by choosing additional collections from
-\guiseq{Standard collections} or \guiseq{Language collections}. For example,
-by clicking the \guiseq{Select} button labelled \guiseq{Standard
-collections}, additional collections like Metapost, Omega or documentation
-in different languages can be selected.
-
-\textbf{Note:} The \guiseq{Ghostscript}, \guiseq{Perl} and \guiseq{Wintools}
-collections are selected by default and should be installed unless they are
-already installed and you really know what you are doing. This is because
-they are required by many important tools. The \verb|PERL5LIB| and
-\verb|GS_LIB| environment variables will be set too.
-
-Next, clicking the \guiseq{Select} button labelled \guiseq{Language
-Collections} in the \guiseq{Main customization} section opens the
-\guiseq{Language collections} window in which the installation language can
-be chosen by ticking the box next to the language.
-
-Next, click the \guiseq{Install} button in the \guiseq{Install} section to
-start the installation proper process.
-
-The \TL{} system needs some post-processing steps (format files
-generation, ls-R databases generation, environment variables, etc.). All
-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.
-
-If it is needed (Win9x/WinME), you will be asked to reboot your computer.
-
-\subsection{Support packages for Windows}
-\label{sec:win-xemtex}
-
-To be complete, a \TL installation needs support packages that are not
-commonly found on a Windows machine. Many scripts are written using the Perl
-language. Some important tools require the Ghostscript \PS{} interpreter to
-render or to convert files. A graphic file toolbox is also needed in some
-cases. Last but not least, a \TeX-oriented editor makes it easy to type in
-your \TeX{} files.
-
-All these tools are quite easy to find for Windows, but in order to try to
-make your life even easier, we have put such a set of tools on \TL:
-\begin{itemize*}
-\item GNU \cmdname{Ghostscript} 7.07
-\item a minimal \cmdname{Perl} 5.8, sufficient to run all the \TL{}
- Perl scripts.
-\item win-tools is a set of small programs (bzip2, gzip, jpeg2ps
- and tiff2png)
-%\item a subset of \cmdname{ImageMagick} 5.5.6
-%\item the \cmdname{ISpell} checker
-%\item \cmdname{XEmacs} 21.5.14 with a selection of packages to support
-%\TeX{} typesetting.
-\end{itemize*}
-
-These packages are borrowed from the \XEmTeX{} distribution
-(the successor of fp\TeX).
-
-Perl and Ghostscript are installed by default; you may explicitly
-deselect them during installation if you already have them.
-
-If you don't want to install this bundle, then you are on your own to
-install the required tools to complete your \TL{} system. Here is a
-list of places to get those tools:
-
-\begin{description}
-\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/}
-\item[Perl] \url{http://www.activestate.com/} (but you might need some
- supplementary packages from CPAN: \url{http://www.cpan.org/})
-\item[ImageMagick] \url{http://www.imagemagick.com}
-\item[NetPBM] alternatively, you could use NetPBM instead of ImageMagick to
- process or convert your graphic files. NetPBM home page is
- \url{http://netpbm.sourceforge.net/}
-\item[\TeX-oriented editors] There is a wide choice, and it is a matter of the
- 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{XEmacs} is available natively under Windows, see
- \url{http://www.xemacs.org/}
- \item \cmdname{WinShell} is available on \TL in the \path|support|
- directory, see \url{http://www.winshell.de}
- \item \cmdname{WinEdt} is shareware available from \url{http://www.winedt.com}
- \item \cmdname{Vim} is available on \TL{} in the
- \path|support\vim| directory and the
- reference site is \url{http://www.vim.org}
- \item TeXnicCenter is free software, available from
- \url{http://www.toolscenter.org} and in the proTeXt 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}
- \end{itemize*}
-\end{description}
-
-You might want to install other tools that are not free\footnote{Not
-free, that is, in the sense of freedom to modify and redistribute,
-following free software guidelines. This does not mean you can't acquire
-them for no money.} and therefore not included on \TL{}, such as
-\cmdname{GSView}, the \cmdname{Ghostscript} companion to more
-conveniently view PS/PDF files. \cmdname{GSView} is available from
-\url{http://www.cs.wisc.edu/~ghost/gsview/} or any \acro{CTAN} site.
-
-\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.
-
-\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
-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}.
-
-Click the tab labelled \guiseq{Add packages} or \guiseq{Remove packages}
-to enter the relevant functionality and then:
-
-\begin{itemize}
-\item In the first tab select the proper \CD{} drive (or \DVD with
- \texttt{texlive} directory) by pressing the \guiseq{CD/DVD} button.
-\item Click the \guiseq{Search} button in the \guiseq{Buttons} section to
-display or refresh in the \guiseq{Select packages to\dots} section the
-list of packages to install or remove.
-
-When adding packages, the list of installed packages is compared to the list
-of packages available from your \CD/\DVD. Only packages not already installed are
-displayed. It is up to you to select which packages you want to
-install.
-
-When removing individual packages, only a list of installed packages
-will be displayed.
-
-Please note that for both \guiseq{Add packages} and \guiseq{Remove packages}
-the collections are listed first.
-
-\item Select a package by clicking on the name of the package. Clicking the
-\guiseq{Info} button in the \guiseq{Buttons} section displays a short
-description of the selected package in the window located in the \guiseq{Info
-about the selected item} section. To select several packages at once hold
-down one of the Ctrl or Shift keys at your keyboard while holding down the
-left mouse button or drag the mouse pointer while holding down the left mouse
-button.
-
-\item Click the \guiseq{Install} or \guiseq{Remove} button in the
-\guiseq{Buttons} section to perform the appropriate action.
-\end{itemize}
-
-\subsection{Configuring and other management tasks}
-
-The functions available in the tab labelled \guiseq{Manage the installation}
-are helpful in performing actions needed when you want to add support for a
-language which was not selected during the installation, or add/regenerate a
-format which was not selected during the installation or was modified after
-the installation.
-
-The following actions can be performed:
-
-\begin{itemize}
-\item Refresh the \filename{ls-R} database
-\item Create formats (All or Missing)
-\item Edit \filename{language.dat}
-\item Edit \filename{fmtutil.cnf}
-\item Edit \filename{updmap.cfg}
-\end{itemize}
-
-Note: you can close the Edit\dots{} window with the \guiseq{Cancel} or
-\guiseq{Done} button; the latter will start rebuilding the format files
-(or the fontmap files if you have edited \filename{updmap.cfg}), followed by a
-\filename{ls-R} database files refresh.
-
-For more information about the configuration see section~\ref{sec:persconf},
-\p.\pageref{sec:persconf}.
-
-\subsection{Uninstalling \protect\TL{}}
-
-The tab labelled \guiseq{Remove the TeX Live installation} opens a window
-which contains functionality not worth describing and we do not know who would
-need it and what it is for\dots :-)
-
-Anyway, if you have the \path|texmf-local| directory for your local additions,
-the removal procedure will not wipe it out or delete things in it. The \path|setup-win32|
-directory containing \cmdname{tlpmgui} and related files will not be deleted. You will have to do some manual cleanup to
-actually remove them.
-
-\subsection{Adding your own packages to the installation}
-
-First, whatever changes you make, \textbf{do not forget to rebuild the ls-R
-database files}. Otherwise, your new files will not be found. You can do this
-either via the \cmdname{tlpmgui} run and selection of the appropriate action
-from the \guiseq{Manage the installation} tab, or manually running the
-\file{mktexlsr} command.
-
-If you want to add files that are not provided by the \TL{} distribution,
-it is recommended to put them in the \path|$TEXMFLOCAL| directory. This
-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\|
-
-\subsection{Running \texttt{tlmp.exe} from the command line}
-The \cmdname{tlpm.exe} program which is used as engine by \cmdname{tlpmgui}
-has a number of other useful options. You can get the list by running:
-\begin{verbatim}
-tlpm --help
-\end{verbatim}
-
-More information and examples of use can be found in \path|tlpm.readme|.
-
-\subsection{Network installation}
-
-\KPS{} knows about UNC names, so you can use them to get your TEXMF
-tree from the network. But there is better than this.
-All the support files and configuration files, everything except the files in the
-\path|bin/win32| are shareable with a \teTeX{} or Unix \TL{} installation. That means
-you can use Samba either to mount from an NT server to a Unix
-workstation or the converse. Several strategies are possible:
-\begin{itemize}
-\item Put everything on the server. Just add each set of files for the OS and
-architecture you want to use in the \path|bin| directory. That means
-for example \path|bin/win32| and \path|bin/i386-linux|. Next configure
-your main variables. You can use UNC names to
-point to the right directories under Win32.
-\item Install a local copy for the binaries and format files. In this
- case, assign \path|$TEXMFMAIN| to the main \path|texmf| tree that
- will be accessed remotely. Set \path|$TEXMFVAR| to be a local
- directory which will hold local configuration files and on-the-fly
- generated files.
-\end{itemize}
-
-\subsection{What's different in Windows?}
-
-The Windows version of \Webc{} has some specific features that should be
-pointed out.
-
-\begin{description}
-\item[\KPS{}] The hash-tables that \KPS{} builds are quite large for
- the \TL{}. In order to cut down the starting time of any
- \KPS{}-enabled program, these hash-tables have been put in shared
- memory. This way, when you chain the execution of several such
- programs, like \path|tex| calling \path|mpost| calling \path|tex|,
- the overhead when starting each of the subprograms is
- reduced. This change is hidden to the user, except if you set the
- debug flag of kpathsea to the \path|-1| value: you will then trace
- access to the shared memory, which is not what you want (it is
- accessed very often!). What is useful in a log trace of the shared
- memory access is still to be defined, so the situation might evolve
- in the future.
-\item[\cmdname{kpsecheck}] This command provides some options that did
- not fit well into \cmdname{kpsewhich}. It will allow you to list all
- the files that occur multiple times across your texmf trees. This
- could be handy, but most of the time you will also get unwanted
- output (like dozens of \path|README| files). It is noticeable
- that all these files result in clashes inside the \KPS{}-hashing
- mechanism; fortunately, \KPS{} never looks for these files. For
- this reason, you can combine the \path|-multiple-occurrences| with 2
- other options for including or excluding any filename that match
- some pattern (you can request for several patterns).
-
- The \cmdname{kpsecheck} command will also report the status of shared
- memory: in use or not used. That might be useful to know because if
- the status reported is \samp{in use}, that means one or several
- processes are working, and the effect of any \cmdname{mktexlsr}
- command will be delayed until the next time where no \KPS{} linked
- process will be running.
-
- Last, this same command will report about the location it thinks
- Ghostscript can be found. Under Win32, for many programs, it is
- easier to use the Ghostscript dll, and find it by using the
- Ghostscript registry key than to change the \path|PATH|, which has a
- limited length anyway.
-\item[\Webc{}] The engines have a few more options than in Unix
- \Webc{}, and one option with a different behavior:
- \begin{itemize}
- \item \path|-halt-on-error| stop the compilation at the first error.
- \item \path|-job-time| set the job time to the same timestamp as the
- file given in argument.
-\item \path|-oem| use the DOS codepage for console output.
- \item \path|-output-directory| allow to write all the output files in the
- specified directory.
- \item \path|-time-statistics| print statistics about the job run
- time. It is to be noted that Win9x not being a true multitasking
- operating system, it has no reliable timer for short periods, so
- the value printed is an approximation. Under NT/2K/XP, the result
- is quite accurate with user time and system time values allocated
- for this run. For Unix
- users: the \path|time| command is not usually available to Windows
- users.
- \end{itemize}
-\end{description}
-
-\subsection{Personal configurations}
-\label{sec:persconf}
-
-\subsubsection{Dvips}
-
-The configuration file for dvips can be found in\\
-\verb+C:\TeXLive2005\texmf-var\dvips\config\config.ps+\\
-You may open it with any editor
- %(\cmdname{WinShell} will do fine)
- and change some parameters:
-
-\begin{description}
-\item [fonts] you can change the default printer \MF{} mode or printer
- resolution in case \cmdname{dvips} needs to generate PK fonts. By default it
- is configured to use Type~1 versions of the CM fonts, so it should
- not call \cmdname{mktexpk} too often;
-\item[printer] you can tell dvips where you want to print by default. If
- the \optname{o} option is not followed by a printer name, then a
- \file{.ps} \PS{} file is written. You can give dvips a printer
- name such as:
-\begin{verbatim}
-o lpt1:
-% o | lpr -S server -P myprinter
-% o \\server\myprinter
-\end{verbatim}
-\item[paper] Next, you might want
- to change the paper size from European (A4) to US letter
- by making the US letter the first paper size mentioned in the file.
- Scroll to the group of lines beginning with \code{@}. Move
- the appropriate lines so that this section begins with the lines:\\
-\hspace*{1em} @ letterSize 8.5in 11in\\
-\hspace*{1em} @ letter 8.5in 11in\\
-\hspace*{1em} @+ \%\%BeginPaperSize: Letter\\
-\hspace*{1em} @+ letter\\
-\hspace*{1em} @+ \%\%EndPaperSize
-\end{description}
-
-The current \TL{} distribution implements the procedure of making
-always up-to-date fontmaps files for Dvips and Pdftex. This is done by
-the \cmdname{updmap} program during installation, as well as during any
-font package addition. If you add new packages by hand, edit the file
-\verb+updmap.cfg+ in \path|$TEXMFVAR/web2c|.
-
-\subsubsection{PdfTeX}
-
-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
-change \samp{\bs pdfpagewidth} and \samp{\bs pdfpageheight}. These entries
-should read:
-\begin{alltt}
-\bs{}pdfpagewidth=8.5 true in
-\bs{}pdfpageheight=11 true in
-\end{alltt}
-Save the file and exit the editor.
-
-\subsubsection{GSView}
-GSView is now distributed under the Aladdin License, and therefore is no
-longer included in \TL{}.
-
-If you may want to change the page size to US letter size. If so, open
-GSView from the \guiseq{Start} menu, and select \guiseq{Media\arw Letter}.
-
-Also, there are menu settings that are supposed to give you the most
-readable screen image. On \guiseq{Media \arw Display Settings}, set both
-\optname{Text Alpha} and \optname{Graphics Alpha} to 4~bits.
-
-Note that the installation process has set all \code{.ps} and
-\code{.eps} files to automatically open with \cmdname{GSView}.
-
-For printing instructions, see section~\ref{printing} below.
-
-\subsubsection{WinDvi}
-\label{sub:windvi}
-
-The \file{tlpmgui.exe} program takes care of associating the files
-with the \file{.dvi} extension with \file{Windvi}, but it doesn't make an icon
-on the desktop, so please do it yourself.
-
-Open \cmdname{windvi} by clicking an icon or from the command line.
-
-You can set it for US letter-size paper by going to \guiseq{View\arw
-Options\arw Papertype} and selecting US (8.5\verb+"+ x 11\verb+"+) (and
-then \optname{OK}. Exit \cmdname{windvi}.
-
-You can change other parameters from there as well, such as the ability
-to execute system commands specified by the document (disabled by
-default for security reasons). Also, the first time you view any .dvi
-file, you may find the magnification too large. Zoom out until you get
-an appropriate size.
-
-All configuration settings for \cmdname{windvi} are stored in a file
-named \path|windvi.cnf| file. You can find it by running this command at
-the prompt:
-\begin{verbatim}
-c:\>kpsewhich --expand-var $HOME/windvi.cnf
-\end{verbatim}
-
-Should you have problems with \cmdname{windvi}, please remove the
-configuration file and test your problem against a vanilla configuration.
-
-\subsection{Testing}
-
-For generic verification procedures, see section~\ref{sec:test-install}
-(\p.\pageref{sec:test-install}). This section describes
-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
-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}
-menu (XEmacs) or Preview (Windvi) icon (WinShell).
-
-At first, when you preview files with Windvi, 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.
-
-\textbf{Hint for the future:} If a \LaTeX\ run stops because \LaTeX\
-cannot find a file, you can press Ctrl-z to quit.
-
-
-\subsection{Printing}
-\label{printing}
-
-It is possible to print from Windvi. In this case, printing will be done
-using the Windows unified printer driver. By definition, it is
-compatible with all printers. However, there is some drawback: it can
-generate some huge spool files, and some (older) versions of Windows
-just don't like them. The advantage is that you can use features like
-embedding BMP or WMF images. You also need to make sure that the printer
-parameters are correctly set (subsection~\ref{sub:windvi}), else you
-will get scaled printing (printing at 600\dpi{} on a 300\dpi{} printer
-will give you only one quadrant of your page).
-
-Printing is faster and more reliable if you run \cmdname{dvips} to make
-a \filename{.ps} file and then print from \cmdname{GSView}. In
-\cmdname{GSview}, select \guiseq{File\arw Print\ldots}. A \guiseq{Print}
-window will appear.
-
-If you are using a \PS{} printer, \textit{be sure to select
-\guiseq{\PS{} Printer}}. This is done in the \guiseq{Print Method} box
-at the bottom left of the \guiseq{Print} window. You can then select any
-of the printers that you have previously installed. If you fail to
-check the box for \optname{\PS{} Printer}, printing will not work.
-
-If you will be using your own non-\PS{} printer, select
-\guiseq{Ghostscript device} in the \guiseq{Print Method} box, then click
-on the button to the right labelled \guiseq{djet500} and select your
-printer type from the list that pops up. (In the older version of
-\cmdname{GSView}, make sure \optname{\PS{} Printer} is \textit{not}
-selected, then select your printer type from the \guiseq{Device} list.)
-
-\subsection{Tips and tricks for Win32}
-
-\subsubsection{Different flavors of Win32}
-
-What we call Win32 is not an operating system by itself. It is a large
-set of functions (around 12,000 in the header files of the Microsoft
-\acro{SDK}) that you can use to write programs for different operating
-systems of the Windows family.
-
-Windows comes in different flavors:
-\begin{itemize}
-\item Win95, Win98 and Win\acro{ME}, which \emph{are not true multitasking,
- multithreading} environments. They are the latest\Dash and hopefully
- last\Dash metamorphosis of \acro{DOS}. This can be more or less proven
- by the fact that when booting, the PC will load the \path|command.com|
- interpreter, and if you stop the boot process at this point, you can
- ask for the current (\acro{DOS}) version and it will answer something
- like \samp{MS-DOS 7.0} (at least for the old versions of Win9x).
-\item Windows \acro{NT}, which is a new operating system written from
- scratch, capable of true multitasking behavior, and including many
- high level features.
-\item Windows 2000, based on \acro{NT}, with all the bells and
- whistles of Win98.
-\item Windows \acro{XP}, which comes with Personal and Pro flavors. This is
- the last step in merging both lines of products (Win9x based and
- \acro{NT} based). \acro{XP} is based on \acro{NT}.
-\end{itemize}
-
-Win9x are able to run 32~bits programs and 16~bits programs
-concurrently. But the operating system by itself is not entirely
-written in 32~bits mode, and does not support memory protection: 16bits
-applications can overwrite parts of the operating system memory! Some
-parts of the system like the \acro{GDI} (Graphical Device Interface)
-manage limited resources like bitmaps, fonts, pens and so on for the set
-of all programs that run concurrently. All the bitmaps headers available
-at the same time can't amount for more than 64kB. This explains the
-performance tool and the fact that you can put your system on his knees
-by making intensive use of graphic objects for example.
-
-NT, 2K and XP do not suffer from these limitations, and neither from
-other Win9x limitations. They are true multitasking environments, with
-protected memory. They are much more responsive than Win9x because
-of better memory management, better file system and so on.
-
-\subsubsection{Command line prompt}
-
-You may wonder, ``Why would I need to use a command line prompt when
-I have Windows?''
-
-Good question. The problem is of very general nature. Not all operations
-can be done easily using only a \acro{GUI}. Command line gives you
-programming power\Dash assuming a clever command interpreter.
-
-But the problem here is more fundamental: \TeX{} is \emph{a batch}
-tool. Not an interactive one. \TeX{} needs to compute the best
-layout for each page, resolve cross-references and so on. This can be
-done only by a global processing of the document. It is not (yet) a
-task that can be done interactively.
-
-This means that you should use \TeX{} from a command line. In fact the
-situation is not so bad. There is an advantage to write command line
-tools for complex processing: they are better debugged, because they are
-independent of any \acro{GUI} problems, and \acro{GUI} tools can be
-designed to interface to the command line tools. This is the case for
-\TeX{}, where you will mostly interact with it through a \acro{GUI} text
-editor.
-
-However, you may need to use the command line prompt in a number of
-situations. One is when you are having difficulties and want to debug
-your setup.
-
-\begin{description}
- \item[Win9x] You can open a command line prompt by looking either for
- the \acro{MS-DOS} icon in the \guiseq{Start\arw Programs} menu,
- or by choosing \guiseq{Start\arw Run} menu typing in
- \path|command.com| as the progrm name.
- \item[NT, 2K, XP] You can open a command line prompt by looking for
- \guiseq{Command Prompt} in the \guiseq{Start\arw Accessories} menu.
- You can also choose \guiseq{Start\arw Run} and type in
- \path|cmd.exe|, which is the name of the brand new command
- interpreter for \acro{NT} (thus, it is untrue to call this a
- \emph{DOS} box!).
-\end{description}
-
-These locations may change across different Windows versions.
-
-\subsubsection{Path separators}
-
-The Win32 API understands both \path|/| and \path|\| characters as PATH
-separators. But the command interpreters do not! So whenever a path name
-is used programmatically, you can use both separators, and even mix them
-up in the same path name. But on the command line, you must type
-\path|\| as path separator. The reason is compatibility: the command
-processor used \samp{/} to introduce arguments to commands.
-
-All this to say: do not be surprised to read path names written using
-the Unix convention; \fpTeX{} is a port of \Webc, and aims to be compatible
-across platforms. For this reason, all the configuration files that
-need to specify path names use the Unix convention.
-
-\subsubsection{File systems}
-\label{sec:clusters}
-
-The worst feature of Win9x with regard to \TeX{} is probably the
-so-called FAT file system. \TeX{} uses very many small files, with size
-around 1--3kB. The \acro{FAT} file system is old, and predates by
-decades the multi-gigabytes hard disks we have today. As a result, it
-cannot manage efficiently the tens of thousands of \TeX{} files found in
-\TL{}. The \acro{FAT} file system allocates a minimum of 32kB for
-\emph{any} file on a huge partition. It means that \TeX{} will use much
-more disk space than it actually needs.
-
-The other, more modern, file systems available, \acro{FAT32} and
-\acro{NTFS}, do not have this drawback. They manage clusters of 4kB
-only. (You can lower the limit to 512 bytes on \acro{NTFS}.)
-
-\subsubsection{How to add some directory to your PATH}
-
-There are pairs of variables and values which behave much like global
-variables inside your programs. The set of those variables is called the
-environment. Each program is initialized with a copy of the
-environment when it is run. It can request and change the
-value of any variable. The changes happen in the copy of the
-environment, and is not at all propagated to the other running
-programs.
-
-Your PATH is a special environment variable used to search for
-programs you want to run.
-There is a different procedure to change it for Win9x, WinME and NT/2K/XP:
-
-\begin{description}
-\item[Windows 95/98] Edit your \path|autoexec.bat|. In this file should be a line
- starting with \texttt{PATH=} and followed by a list of directories separated
- 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
-\end{verbatim}
-\item[Windows ME] You need to run the special program
- \path|c:\windows\system\msconfig.exe| to be able to change any
- environment variable. From this program, select the `Environment'
- tab, and then add or modify the variable you want. You will be asked to reboot the
- machine upon any change.
-\item[Windows NT/2K/XP]
- Click left on \guiseq{Start \arw Settings \arw Control Panel}. Now the
- window with the control panel icons opens. Double click on System. The
- System Properties window opens. Click on the tab \textsf{Environment}
- or look for a button named \guiseq{Environment Variables} among the
- dialog boxes. Now you can change the environment variables for your
- user account. Note: There are also displayed the environment settings
- for the system. Normally, you can't change the system variables
- unless you have administrator rights on your machine. If you want to
- change the \texttt{PATH} for all users, you will have to contact your
- system administrator or be the system administrator yourself\Dash in
- the latter case you should know what you are doing.
-
- If there is already a \texttt{PATH} setting for your user account,
- left click on \texttt{PATH}. In the field \textsf{Variable} appears
- \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
- 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
- the \textsf{Apply} button before clicking \textsf{Ok}, otherwise the
- changes to \texttt{PATH} won't apply to your system. Be careful when
- changing the environment settings.
-\end{description}
-
-The best way to be sure that a variable has been properly set is to
-open a console and type:
-\begin{verbatim}
-set VARIABLE
-\end{verbatim}
-which should return the corresponding value.
-
-\subsubsection{\TeX{} engines}
-
-If you have a look at the \Webc{} documentation, you will read that all
-the various \TeX{} derived programs use the same base engine. For
-example, \path|tex.exe| and \path|latex.exe| are exact copies of the
-same program, but each one will use a different format file, based on
-its calling name.
-
-Under Unix, this feature is implemented through \emph{symbolic
-links}. It saves up a bit of disk space, because some engines are
-used with many different format files.
-
-The Win32 API does not know about file links. So to save up almost
-the same amount of memory, all the \TeX{} base engines have been put
-in DLLs (\emph{Dynamic Linked Library}). This means that you will have
-the following layout:
-\begin{alltt}
-18/09/2005 14:19 3 584 latex.exe
-18/09/2005 14:19 3 584 pdfetex.exe
-18/09/2005 14:19 524 288 tl90pdfetex.dll
-\end{alltt}
-and the \path|latex.exe| file is nothing but a rough copy of
-\path|pdfetex.exe| using the same core \path|tl90pdfetex.dll|.
-The same trick has been used for the \path|mktex*.exe| family of programs
-which are linked to the \path|mktex.dll| library.
-
-In fact, a generic tool called \path|irun.exe| is provided to build the
-equivalent of Unix hard links for executable files only under Win32.
-
-\subsection{In case of problems}
-\label{sec:troubleshooting}
-
-\subsubsection{What to do if \texttt{latex} does not find your files?}
-
-\begin{itemize}
-
-\item \cmdname{kpsewhich} is the tool of choice to debug any
-problem. Unfortunately, \cmdname{kpsewhich} outputs debug information
-to stderr, and the older Windows consoles do not know how to redirect stderr
-to a file. (NT and Windows 2000 consoles know how to do that. But
-the trick will work for any console.) For diagnostic purposes you can
-temporarily set an environment variable (in a \acro{DOS} box):
-
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=err.log
-\end{verbatim}
-You can also set the debug level:
-\begin{verbatim}
-SET KPATHSEA_DEBUG=-1
-\end{verbatim}
-
-If you want to redirect stderr to stdout, which is not possible
-Windows, then do:
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=con:
-\end{verbatim}
-This way you can capture both stdout and stderr in the same file.
-
-\item Assuming the installation has been done in \path|c:/TeX|, check
- the following values: \\
- {\small
- \begin{tabular}{ll}
- \path|kpsewhich -expand-path $SELFAUTOPARENT| & \path|c:/TeX| \\
- \path|kpsewhich -expand-path $TEXMF| & \path|c:/TeX/texmf....| \\
- \path|kpsewhich -expand-path $TEXMFCNF| &
- \path|.;c:/TeX/texmf-var/web2c;| \\
- \path|kpsewhich -expand-var $TEXINPUTS| & \path|.;c:/TeX/texmf/tex//|
- \end{tabular}
-}
-\item If you have other \TeX{}-related values already set in your
- environment, please, remove them. They are overriding the ones in
- texmf.cnf.
-\item Check the values from:\\
-{\small
- \begin{tabular}{ll}
- \texttt{kpsewhich cmr10.tfm} & \path|c:/TeX/texmf/fonts/tfm/public/cm/cmr10.tfm|\\
- \texttt{kpsewhich latex.fmt}& \path|c:/TeX/texmf/web2c/latex.fmt|
- \end{tabular}
-}
-\item At this point, if everything is correct, \TeX{} and friends
- should work. If it is not the case, you will need to play with
- the \path|-debug=n| option from \path|kpsewhich|, and check back all
- the values. Try to identify and report the problem.
-\end{itemize}
-
-\subsubsection{What to do if your setup still does not work as expected?}
-
-Here are several questions to investigate:
-
-\begin{enumerate}
-\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)?
-
-\item Are there any errors in the log file generated by the
-\file{tlmpgui.exe} program?
-\file{tlmpgui.log} can be found in your
-\file{TEMP} directory. You can find this by searching for the
-string \samp{Error}. Hint: the log file can show some errors after
-building all format files. Please do not panic: perhaps some formats
-weren't already installed.
-
-\item Are there any relevant bug fixes at \url{http://tug.org/texlive/}?
-(Unlikely, but it doesn't hurt to check.)
-
-\end{enumerate}
-
-The \TL{} software consists of hundreds of programs and tens of
-thousands of files, all from varying sources. So it is quite difficult to
-predict all possible causes for problems. Nevertheless, we will do our
-best to help you. (See section~\ref{sec:help}, \p.\pageref{sec:help}.)
-
-% don't use \Webc so the \uppercase in the headline works.
-\section{A user's guide to Web2C}
-
-\Webc{} is an integrated collection of \TeX-related programs: \TeX{}
-itself, \MF{}, \MP, \BibTeX{}, etc. It is the heart of \TL{}.
-
-A bit of history: The original implementation was by Tomas Rokicki who,
-in 1987, developed a first \TeX{}-to-C system based on change files
-under Unix, which were primarily the original work of Howard Trickey and
-Pavel Curtis. Tim Morgan became the maintainer of the system, and
-during this period the name changed to Web-to-C\@. In 1990, Karl Berry
-took over the work, assisted by dozens of additional contributors, and
-in 1997 he handed the baton to Olaf Weber.
-
-The \Webc{} system runs on Unix, 32-bit Windows systems, \MacOSX{}, and
-other operating systems. It uses Knuth's original sources for \TeX{} and
-other basic programs written in \web{} and translates them into C source
-code. The core \TeX{} programs are:
-
-\begin{cmddescription}
-\item[bibtex] Maintaining bibliographies.
-\item[dmp] \cmdname{troff} to MPX (\MP{} pictures).
-\item[dvicopy] Expands virtual font references in \dvi{} files.
-\item[dvitomp] \dvi{} to MPX (MetaPost pictures).
-\item[dvitype] \dvi{} to human-readable text.
-\item[gftodvi] Generic font proofsheets.
-\item[gftopk] Generic to packed fonts.
-\item[gftype] GF to human-readable text.
-\item[makempx] \MP{} label typesetting.
-\item[mf] Creating typeface families.
-\item[mft] Prettyprinting \MF{} source.
-\item[mpost] Creating technical diagrams.
-\item[mpto] MetaPost label extraction.
-\item[newer] Compare modification times.
-\item[patgen] Creating hyphenation patterns.
-\item[pktogf] Packed to generic fonts.
-\item[pktype] PK to human-readable text.
-\item[pltotf] Plain text property list to TFM.
-\item[pooltype] Display \web{} pool files.
-\item[tangle] \web{} to Pascal.
-\item[tex] Typesetting.
-\item[tftopl] TFM to plain text property list.
-\item[vftovp] Virtual font to virtual property list.
-\item[vptovf] Virtual property list to virtual font.
-\item[weave] \web{} to \TeX.
-\end{cmddescription}
-
-\noindent The precise functions and syntax of these programs are
-described in the documentation of the individual packages and of \Webc{}
-itself. However, knowing a few principles governing the whole family of
-programs will help you take advantage of your \Webc{} installation.
-
-All programs honor these standard \acro{GNU} options:
-\begin{ttdescription}
-\item[-{}-help] print basic usage summary.
-\item[-{}-verbose] print detailed progress report.
-\item[-{}-version] print version information, then exit.
-\end{ttdescription}
-
-For locating files the \Webc{} programs use the path searching library
-\KPS{}. This library uses a combination of environment variables and a
-configuration files to optimize searching the (huge) collection of
-\TeX{} files. \Webc{} can look at more than one directory tree
-simultaneously, which is useful in maintaining \TeX's standard
-distribution and local extensions in two distinct trees. To speed up
-file searches the root of each tree has a file \file{ls-R}, containing
-an entry showing the name and relative pathname for all files under that
-root.
-
-\subsection{Kpathsea path searching}
-
-Let us first describe the generic path searching mechanism of the \KPS{}
-library.
-
-We call a \emph{search path} a colon- or semicolon\hyph sepa\-rated list
-of \emph{path elements}, which are basically directory names. A
-search path can come from (a combination of) many sources. To look up
-a file \samp{my-file} along a path \samp{.:/dir}, \KPS{} checks each
-element of the path in turn: first \file{./my-file}, then
-\file{/dir/my-file}, returning the first match (or possibly all
-matches).
-
-In order to adapt optimally to all operating systems' conventions, on
-non-Unix systems \KPS{} can use filename separators different from
-colon (\samp{:}) and slash (\samp{/}).
-
-To check a particular path element \var{p}, \KPS{} first checks if a
-prebuilt database (see ``Filename data\-base'' on
-page~\pageref{Filename-database}) applies to \var{p}, i.e., if the database
-is in a directory that is a prefix of \var{p}. If so, the path
-specification is matched against the contents of the database.
-
-If the database does not exist, or does not apply to this path
-element, or contains no matches, the filesystem is searched (if this
-was not forbidden by a specification starting with \samp{!!}\ and if
-the file being searched for must exist). \KPS{} constructs the list
-of directories that correspond to this path element, and then checks
-in each for the file being sought.
-
-The ``file must exist'' condition comes into play with \samp{.vf} files and
-input files read by \TeX's \cs{openin} command. Such files may not
-exist (e.g., \file{cmr10.vf}), and so it would be wrong to search the
-disk for them. Therefore, if you fail to update \file{ls-R} when you
-install a new \samp{.vf} file, it will never be found.
-Each path element is checked in turn: first the database, then the
-disk. If a match is found, the search stops and the result is
-returned.
-
-Although the simplest and most common path element is a directory
-name, \KPS{} supports additional features in search paths: layered
-default values, environment variable names, config file values, users'
-home directories, and recursive subdirectory searching. Thus, we say
-that \KPS{} \emph{expands} a path element, meaning it transforms all
-the specifications into basic directory name or names. This is
-described in the following sections in the same order as it takes
-place.
-
-Note that if the filename being searched for is absolute or explicitly
-relative, i.e., starts with \samp{/} or \samp{./} or \samp{../},
-\KPS{} simply checks if that file exists.
-
-\ifSingleColumn
-\else
-\begin{figure*}
-\verbatiminput{examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{An illustrative configuration file sample}
- \label{fig:config-sample}
-\end{figure*}
-\fi
-
-\subsubsection{Path sources}
-\label{Path-sources}
-
-A search path can come from many sources. In the order in which
-\KPS{} uses them:
-
-\begin{enumerate}
-\item
- A user-set environment variable, for instance, \envname{TEXINPUTS}\@.
- Environment variables with a period and a program name appended
- override; e.g., if \samp{latex} is the name of the program being run,
- then \envname{TEXINPUTS.latex} will override \envname{TEXINPUTS}.
-\item
- A program-specific configuration file, for exam\-ple, a line
- \samp{S /a:/b} in \cmdname{dvips}'s \file{config.ps}.
-\item A \KPS{} configuration file \file{texmf.cnf}, containing a line like
- \samp{TEXINPUTS=/c:/d} (see below).
-\item The compile-time default.
-\end{enumerate}
-\noindent You can see each of these values for a given
-search path by using the debugging options (see ``Debugging actions''
-on page~\pageref{Debugging}).
-
-\subsubsection{Config files}
-
-\begingroup\tolerance=3500
-\KPS{} reads \emph{runtime configuration files} named \file{texmf.cnf}
-for search path and other definitions. The search path used to look
-for these files is named \envname{TEXMFCNF} (by default such a file lives
-in the \file{texmf/web2c} subdirectory). \emph{All}
-\file{texmf.cnf} files in the search path will be read and definitions
-in earlier files override those in later files. Thus, with a search
-path of \verb|.:$TEXMF|, values from \file{./texmf.cnf} override those
-from \verb|$TEXMF/texmf.cnf|.
-\endgroup
-
-\begin{itemize}
-\item
- Comments start with \code{\%} and continue to the end of the line.
-\item
- Blank lines are ignored.
-\item
- A \bs{} at the end of a line acts as a continuation character,
- i.e., the next line is appended. Whitespace at the beginning of
- continuation lines is not ignored.
-\item
- Each remaining line has the form:
-\begin{alltt}
- \var{variable}[.\var{progname}] [=] \var{value}
-\end{alltt}%
- where the \samp{=} and surrounding whitespace are optional.
-\item
- The \ttvar{variable} name may contain any character other
- than whitespace, \samp{=}, or \samp{.}, but sticking to
- \samp{A-Za-z\_} is safest.
-\item
- If \samp{.\var{progname}} is present, the definition only
- applies if the program that is running is named
- \texttt{\var{progname}} or \texttt{\var{progname}.exe}. This allows
- different flavors of \TeX{} to have different search paths, for
- example.
-\item \var{value} may contain any characters except
- \code{\%} and \samp{@}. The
- \code{\$\var{var}.\var{prog}} feature is not available on the
- right-hand side; instead, you must use an additional variable. A
- \samp{;}\ in \var{value} is translated to \samp{:}\ if
- running under Unix; this is useful to be able to have a single
- \file{texmf.cnf} for Unix, \acro{MS-DOS} and Windows systems.
-\item
- All definitions are read before anything is expanded, so
- variables can be referenced before they are defined.
-\end{itemize}
-A configuration file fragment illustrating most of these points is
-\ifSingleColumn
-shown below:
-
-\verbatiminput{examples/ex5.tex}
-\else
-shown in Figure~\ref{fig:config-sample}.
-\fi
-
-\subsubsection{Path expansion}
-\label{Path-expansion}
-
-
-\KPS{} recognizes certain special characters and constructions in
-search paths, similar to those available in Unix shells. As a
-general example, the complex path,
-\verb+~$USER/{foo,bar}//baz+, expands to all subdirectories under
-directories \file{foo} and \file{bar} in \texttt{\$USER}'s home
-directory that contain a directory or file \file{baz}. These
-expansions are explained in the sections below.
-%$
-\subsubsection{Default expansion}
-\label{Default-expansion}
-
-\tolerance=2500
-If the highest-priority search path (see ``Path sources'' on
-page~\pageref{Path-sources}) contains an \emph{extra colon} (i.e.,
-leading, trailing, or doubled), \KPS{} inserts at that point the
-next-highest-prio\-rity search path that is defined. If that inserted
-path has an extra colon, the same happens with the next highest. For
-example, given an environment variable setting
-
-\tolerance=1500
-
-\begin{alltt}
-> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
-and a \code{TEXINPUTS} value from \file{texmf.cnf} of
-
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
-then the final value used for searching will be:
-
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-
-Since it would be useless to insert the default value in more than one
-place, \KPS{} changes only one extra \samp{:}\ and leaves any others in
-place. It checks first for a leading \samp{:}, then a trailing
-\samp{:}, then a doubled \samp{:}.
-
-\subsubsection{Brace expansion}
-
-A useful feature is brace expansion, which means that, for instance,
-\verb+v{a,b}w+ expands to \verb+vaw:vbw+. Nesting is allowed.
-This is used to implement multiple \TeX{} hierarchies, by
-assigning a brace list to \code{\$TEXMF}.
-For example, in \file{texmf.cnf}, the following definition
-(appproximately; there are actually even more trees) is made:
-\begin{verbatim}
- TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN}
-\end{verbatim}
-Using this you can then write something like
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-%$
-which means that, after looking in the current directory, the
-\code{\$TEXMFHOME/tex}, \code{\$TEXMFLOCAL/tex}, \code{\$TEXMFVAR/tex}
-and \code{\$TEXMFMAIN/tex} trees \emph{only}) will be searched (the
-last two use using \file{ls-R} data base files). It is a convenient
-way for running two parallel \TeX{} structures, one ``frozen'' (on a
-\CD, for instance) and the other being continuously updated with new
-versions as they become available. By using the \code{\$TEXMF}
-variable in all definitions, one is sure to always search the
-up-to-date tree first.
-
-\subsubsection{Subdirectory expansion}
-\label{Subdirectory-expansion}
-
-Two or more consecutive slashes in a path element following a directory
-\var{d} is replaced by all subdirectories of \var{d}: first those
-subdirectories directly under \var{d}, then the subsubdirectories under
-those, and so on. At each level, the order in which the directories are
-searched is \emph{unspecified}.
-
-If you specify any filename components after the \samp{//}, only
-subdirectories with matching components are included. For example,
-\samp{/a//b} expands into directories \file{/a/1/b}, \file{/a/2/b},
-\file{/a/1/1/b}, and so on, but not \file{/a/b/c} or \file{/a/1}.
-
-Multiple \samp{//} constructs in a path are possible, but
-\samp{//} at the beginning of a path is ignored.
-
-\subsubsection{List of special characters and their meaning: a summary}
-
-The following list summarizes the special characters in \KPS{}
-configuration files.
-
-% need a wider space for the item labels here.
-\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
-\begin{ttdescription}
-\item[\CODE{:}] Separator in path specification; at the beginning or
- the end of a path it substitutes the default path expansion.\par
-\item[\CODE{;}] Separator on non-Unix systems (acts like \code{:}).
-\item[\CODE{\$}] Variable expansion.
-\item[\CODE{\string~}] Represents the user's home directory.
-\item[\CODE{\char`\{...\char`\}}] Brace expansion.
-\item[\CODE{//}] Subdirectory expansion (can occur anywhere in
- a path, except at its beginning).
-\item[\CODE{\%}] Start of comment.
-\item[\CODE{\bs}] Continuation character (allows multi-line entries).
-\item[\CODE{!!}] Search \emph{only} database to locate file, \emph{do
- not} search the disk.
-\end{ttdescription}
-
-
-\subsection{Filename databases}
-\label{Filename-database}
-
-\KPS{} goes to some lengths to minimize disk accesses for searches.
-Nevertheless, at installations with enough directories, searching each
-possible directory for a given file can take an excessively long time
-(this is especially true if many hundreds of font directories have to
-be traversed.) Therefore, \KPS{} can use an externally-built plain text
-``database'' file named \file{ls-R} that maps files to directories,
-thus avoiding the need to exhaustively search the disk.
-
-A second database file \file{aliases} allows you to give additional
-names to the files listed in \file{ls-R}. This can be helpful to
-confirm to \acro{DOS} 8.3 filename conventions in source files.
-
-\subsubsection{The filename database}
-\label{ls-R}
-
-As explained above, the name of the main filename database must be
-\file{ls-R}. You can put one at the root of each \TeX{} hierarchy in
-your installation that you wish to be searched (\code{\$TEXMF} by
-default); most sites have only one hierarchy. \KPS{} looks for
-\file{ls-R} files along the \code{TEXMFDBS} path.
-
-The recommended way to create and maintain \samp{ls-R} is to run the
-\code{mktexlsr} script included with the distribution. It is invoked
-by the various \samp{mktex}\dots\ scripts. In principle, this script
-just runs the command
-\begin{alltt}
-cd \var{/your/texmf/root} && \path|\|ls -1LAR ./ >ls-R
-\end{alltt}
-presuming your system's \code{ls} produces the right output format
-(\acro{GNU} \code{ls} is all right). To ensure that the database is
-always up-to-date, it is easiest to rebuild it regularly via
-\code{cron}, so that it is automatically updated when the installed
-files change, such as after installing or updating a \LaTeX{} package.
-
-If a file is not found in the database, by default \KPS{} goes ahead
-and searches the disk. If a particular path element begins with
-\samp{!!}, however, \emph{only} the database will be searched for that
-element, never the disk.
-
-
-\subsubsection{kpsewhich: Standalone path searching}
-\label{Invoking-kpsewhich}
-
-The \texttt{kpsewhich} program exercises path searching independent of any
-particular application. This can be useful as a sort of \code{find}
-program to locate files in \TeX{} hierarchies (this is used heavily in
-the distributed \samp{mktex}\dots\ scripts).
-
-\begin{alltt}
-> \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}}
-\end{alltt}
-The options specified in \ttvar{option} start with either \samp{-}
-or \samp{-{}-}, and any unambiguous abbreviation is accepted.
-
-\KPS{} looks up each non-option argument on the command line as a
-filename, and returns the first file found. There is no option to
-return all the files with a particular name (you can run the Unix
-\samp{find} utility for that).
-
-The more important options are described next.
-
-\begin{ttdescription}
-\item[\texttt{-{}-dpi=\var{num}}]\mbox{}
- Set the resolution to \ttvar{num}; this only affects \samp{gf}
- and \samp{pk} lookups. \samp{-D} is a synonym, for compatibility
- with \cmdname{dvips}. Default is 600.
-
-\item[\texttt{-{}-format=\var{name}}]\mbox{}\\
- Set the format for lookup to \ttvar{name}. By default, the
- format is guessed from the filename. For formats which do not have
- an associated unambiguous suffix, such as \MP{} support files and
- \cmdname{dvips} configuration files, you have to specify the name as
- known to \KPS{}, such as \texttt{tex} or \texttt{enc files}. Run
- \texttt{kpsewhich -{}-help} for a list.
-
-\item[\texttt{-{}-mode=\var{string}}]\mbox{}\\
- Set the mode name to \ttvar{string}; this only affects \samp{gf}
- and \samp{pk} lookups. No default: any mode will be found.
-\item[\texttt{-{}-must-exist}]\mbox{}\\
- Do everything possible to find the files, notably including
- searching the disk. By default, only the \file{ls-R} database is
- checked, in the interest of efficiency.
-\item[\texttt{-{}-path=\var{string}}]\mbox{}\\
- Search along the path \ttvar{string} (colon-separated as usual),
- instead of guessing the search path from the filename. \samp{//} and
- all the usual expansions are supported. The options \samp{-{}-path}
- and \samp{-{}-format} are mutually exclusive.
-\item[\texttt{-{}-progname=\var{name}}]\mbox{}\\
- Set the program name to \texttt{\var{name}}.
- This can affect the search paths via the \texttt{.\var{progname}}
- feature.
- The default is \cmdname{kpsewhich}.
-\item[\texttt{-{}-show-path=\var{name}}]\mbox{}\\
- shows the path used for file lookups of file type \texttt{\var{name}}.
- Either a filename extension (\code{.pk}, \code{.vf}, etc.) or a
- name can be used, just as with \samp{-{}-format} option.
-\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\
- sets the debugging options to \texttt{\var{num}}.
-\end{ttdescription}
-
-
-\subsubsection{Examples of use}
-\label{SExamplesofuse}
-
-Let us now have a look at \KPS{} in action. Here's a straightforward search:
-
-\begin{alltt}
-> \Ucom{kpsewhich article.cls}
- /usr/local/texmf-dist/tex/latex/base/article.cls
-\end{alltt}
-We are looking for the file \file{article.cls}. Since the \samp{.cls}
-suffix is unambiguous we do not need to specify that we want to look for a
-file of type \optname{tex} (\TeX{} source file directories). We find it in
-the subdirectory \file{tex/latex/base} below the \samp{texmf-dist} \TL\
-directory. Similarly, all of the following are found without problems
-thanks to their unambiguous suffix.
-\begin{alltt}
-> \Ucom{kpsewhich array.sty}
- /usr/local/texmf-dist/tex/latex/tools/array.sty
-> \Ucom{kpsewhich latin1.def}
- /usr/local/texmf-dist/tex/latex/base/latin1.def
-> \Ucom{kpsewhich size10.clo}
- /usr/local/texmf-dist/tex/latex/base/size10.clo
-> \Ucom{kpsewhich small2e.tex}
- /usr/local/texmf-dist/tex/latex/base/small2e.tex
-> \Ucom{kpsewhich tugboat.bib}
- /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-That last is a \BibTeX{} bibliography database for \textsl{TUGBoat} articles.
-
-\begin{alltt}
-> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
-Font bitmap glyph files of type \file{.pk} are used by display
-programs like \cmdname{dvips} and \cmdname{xdvi}. Nothing is returned in
-this case since there are no pre-generated Computer Modern \samp{.pk}
-files in \TL{}\Dash the Type~1 variants are used by default.
-\begin{alltt}
-> \Ucom{kpsewhich wsuipa10.pk}
-\ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
-\else /usr/local/texmf-var/fonts/pk/ljfour/public/
-... wsuipa/wsuipa10.600pk
-\fi\end{alltt}
-
-For these fonts (a phonetic alphabet from the University of Washington)
-we had to generate \samp{.pk} files, and since the default \MF{} mode on
-our installation is \texttt{ljfour} with a base resolution of 600\dpi{}
-(dots per inch), this instantiation is returned.
-\begin{alltt}
-> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
-\end{alltt}
-In this case, when specifying that we are interested in a resolution
-of 300\dpi{} (\texttt{-dpi=300}) we see that no such font is available on
-the system. A program like \cmdname{dvips} or \cmdname{xdvi} would
-go off and actually build the required \texttt{.pk} files
-using the script \cmdname{mktexpk}.
-
-Next we turn our attention to \cmdname{dvips}'s header and configuration
-files. We first look at one of the commonly used files, the general
-prolog \file{tex.pro} for \TeX{} support, before turning our attention
-to the generic configuration file (\file{config.ps}) and the \PS{} font
-map \file{psfonts.map}\Dash as of 2004, map and encoding files have
-their own search paths and new location in \dirname{texmf} trees. As
-the \samp{.ps} suffix is ambiguous we have to specify explicitly which
-type we are considering (\optname{dvips config}) for the file
-\texttt{config.ps}.
-\begin{alltt}
-> \Ucom{kpsewhich tex.pro}
- /usr/local/texmf/dvips/base/tex.pro
-> \Ucom{kpsewhich --format="dvips config" config.ps}
- /usr/local/texmf/dvips/config/config.ps
-> \Ucom{kpsewhich psfonts.map}
- /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map
-\end{alltt}
-
-We now take a closer look at the \acro{URW} Times \PS{} support
-files. The prefix for these in the standard font naming scheme is
-\samp{utm}. The first file we look at is the configuration file,
-which contains the name of the map file:
-\begin{alltt}
-> \Ucom{kpsewhich --format="dvips config" config.utm}
- /usr/local/texmf-dist/dvips/psnfss/config.utm
-\end{alltt}
-The contents of that file is
-\begin{alltt}
- p +utm.map
-\end{alltt}
-which points to the file \file{utm.map}, which we want to
-locate next.
-\begin{alltt}
-> \Ucom{kpsewhich utm.map}
- /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
-\end{alltt}
-This map file defines the file names of the Type~1 \PS{} fonts in
-the URW collection. Its contents look like (we only show part of the
-lines):
-\begin{alltt}
-utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
-utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
-utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
-Let us, for instance, take the Times Roman instance
-\file{utmr8a.pfb} and find its position in the \file{texmf} directory
-tree with a search for Type~1 font files:
-\begin{alltt}
-> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
-\else /usr/local/texmf-dist/fonts/type1/
-... urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
-It should be evident from these examples how you can easily locate the
-whereabouts of a given file. This is especially important if you suspect
-that the wrong version of a file is picked up somehow, since
-\cmdname{kpsewhich} will show you the first file encountered.
-
-\subsubsection{Debugging actions}
-\label{Debugging}
-
-Sometimes it is necessary to investigate how a program resolves file
-references. To make this practical, \KPS{} offers various levels of
-debugging output:
-
-\begin{ttdescription}
-\item[\texttt{\ 1}] \texttt{stat} calls (disk lookups). When running
- with an up-to-date \file{ls-R} database this should almost give no
- output.
-\item[\texttt{\ 2}] References to hash tables (such as \file{ls-R}
- databases, map files, configuration files).
-\item[\texttt{\ 4}] File open and close operations.
-\item[\texttt{\ 8}] General path information for file types
- searched by \KPS. This is useful to find out where a particular
- path for the file was defined.
-\item[\texttt{16}] Directory list for each path element (only relevant
- for searches on disk).
-\item[\texttt{32}] File searches.
-\end{ttdescription}
-A value of \texttt{-1} will set all the above options; in practice,
-this is usually the most convenient.
-
-Similarly, with the \cmdname{dvips} program, by setting a combination of
-debug switches, one can follow in detail where files are being picked up
-from. Alternatively, when a file is not found, the debug trace shows in
-which directories the program looks for the given file, so that one can
-get an indication what the problem~is.
-
-Generally speaking, as most programs call the \KPS{} library
-internally, one can select a debug option by using the
-\envname{KPATHSEA\_DEBUG} environment variable, and setting it to (a
-combination of) values as described in the above list.
-
-(Note for Windows users: it is not easy to redirect
-all messages to a file in this system. For diagnostic purposes
-you can temporarily \texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log}).
-
-Let us consider, as an example, a small \LaTeX{} source file,
-\file{hello-world.tex}, which contains the following input.
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
-This little file only uses the font \file{cmr10}, so let us look at
-how \cmdname{dvips} prepares the \PS{} file (we want to use the Type~1
-version of the Computer Modern fonts, hence the option \texttt{-Pcms}).
-\begin{alltt}
-> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
-In this case we have combined \cmdname{dvips}'s debug class 4 (font
-paths) with \KPS's path element expansion (see \cmdname{dvips} Reference
-Manual, \OnCD{texmf/doc/html/dvips/dvips_toc.html}).
-The output (slightly rearranged) appears in
-Figure~\ref{fig:dvipsdbga}.
-\begin{figure*}[tp]
-\centering
-\input{examples/ex6a.tex}
-\caption{Finding configuration files}\label{fig:dvipsdbga}
-
-\bigskip
-
-\input{examples/ex6b.tex}
-\caption{Finding the prolog file}\label{fig:dvipsdbgb}
-
-\bigskip
-
-\input{examples/ex6c.tex}
-\caption{Finding the font file}\label{fig:dvipsdbgc}
-\end{figure*}
-
-\cmdname{dvips} starts by locating its working files. First,
-\file{texmf.cnf} is found, which gives the definitions of the search
-paths for the other files, then the file database \file{ls-R} (to
-optimize file searching) and the file \file{aliases}, which makes it
-possible to declare several names (e.g., a short \acro{DOS}-like 8.3 and
-a more natural longer version) for the same file. Then \cmdname{dvips}
-goes on to find the generic configuration file \file{config.ps}
-before looking for the customization file \file{.dvipsrc} (which, in
-this case is \emph{not found}). Finally, \cmdname{dvips} locates the
-config file for the Computer Modern \PS{} fonts \file{config.cms}
-(this was initiated with the \texttt{-Pcms} option on the \cmdname{dvips}
-command). This file contains the list of the map files which
-define the relation between the \TeX{}, \PS{} and file system
-names of the fonts.
-\begin{alltt}
-> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
- p +ams.map
- p +cms.map
- p +cmbkm.map
- p +amsbkm.map
-\end{alltt}
-\cmdname{dvips} thus goes on to find all these files, plus the generic
-map file \file{psfonts.map}, which is always loaded (it contains
-declarations for commonly used \PS{} fonts; see the last part of
-Section \ref{SExamplesofuse} for more details about \PS{} map
-file handling).
-
-At this point \cmdname{dvips} identifies itself to the user:
-\begin{alltt}
-This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com)
-\end{alltt}
-\ifSingleColumn
-Then it goes on to look for the prolog file \file{texc.pro}:
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
-Then it goes on to look for the prolog file \file{texc.pro} (see
-Figure~\ref{fig:dvipsdbgb}).
-\fi
-
-After having found the file in question, \cmdname{dvips} outputs
-date and time, and informs us that it will generate the
-file \file{hello-world.ps}, then that it needs the font file
-\file{cmr10}, and that the latter is declared as ``resident'' (no
-bitmaps needed):
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
-Now the search is on for the file \file{cmr10.tfm}, which is found,
-then a few more prolog files (not shown) are referenced, and finally
-the Type~1 instance \file{cmr10.pfb} of the font is located and
-included in the output file (see last line).
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-\subsection{Runtime options}
-
-Another useful feature of \Webc{} is its possibility to control a number
-of memory parameters (in particular, array sizes) via the runtime file
-\file{texmf.cnf} read by \KPS{}. The memory settings can be found in
-Part 3 of that file in the \TL{} distribution. The more important
-are:
-
-\begin{ttdescription}
-\item[\texttt{main\_memory}]
- Total words of memory available, for
- \TeX{}, \MF{} and \MP. You must make a new format file for each
- different setting. For instance, you could generate a ``huge''
- version of \TeX{}, and call the format file \texttt{hugetex.fmt}.
- Using the standard way of specifying the program name used by \KPS{},
- the particular value of the \texttt{main\_memory} variable will then
- be read from \file{texmf.cnf}.
- etc.).
-\item[\texttt{extra\_mem\_bot}]
- Extra space for ``large'' \TeX{} data structures:
- boxes, glue, breakpoints, etc. Especially useful if you use
- \PiCTeX{}.
-\item[\texttt{font\_mem\_size}]
- Number of words for font information available for \TeX. This
- is more or less the total size of all TFM files read.
-\item[\texttt{hash\_extra}]
- Additional space for the hash table of control sequence names.
- Approximately 10,000 control sequences can be stored in the main
- hash table; if you have a large book with numerous cross-references,
- this might not be enough. The default value of
- \texttt{hash\_extra} is \texttt{50000}.
-\end{ttdescription}
-
-\noindent Of course, this facility is no substitute for truly dynamic
-arrays and memory allocation, but since these are extremely difficult to
-implement in the present \TeX{} source, these runtime parameters provide
-a practical compromise allowing some flexibility.
-
-
-\begin{comment}
-\section{Building on a new Unix platform}
-
-If you have a platform for which executables are not included, you will
-need to compile \TeX{} and friends. This is not as hard as it
-sounds. What you need is all in the directory \texttt{source} in the
-distribution.
-
-\subsection{Prerequisites}
-
-You will need at least 100 megabytes of disk space to compile all of
-\TeX{} and its support programs. You'll also need an \acro{ANSI} C
-compiler, a \cmdname{make} utility, a lexical scanner, and a parser
-generator. We recommend the \acro{GNU} version of these programs
-(\cmdname{gcc}, \acro{GNU} \cmdname{make}, \cmdname{m4}, \cmdname{flex},
-\cmdname{bison}). You may be able to work with other C compilers and
-\cmdname{make} programs, but you will need a good understanding of
-building Unix programs to sort out problems.
-
-Also, the command \texttt{uname} must return a sensible value.
-
-
-\subsection{Configuration}
-
-To begin, perform a normal installation of \TL{} to your disk (see
-section~\ref{sec:unix-install-disk} on
-\p.\pageref{sec:unix-install-disk}). You may wish to skip installing
-all of the prebuilt binaries.
-
-Then, unpack the source from the compressed \texttt{tar} file in the
-directory \dirname{source} to your disk and change directory to where
-you placed it.
-
-Next, run \cmdname{configure} with a command line like this:
-\begin{alltt}
-> \Ucom{sh configure -prefix=/usr/local/TeX}
-\end{alltt}
-
-The \optname{-prefix} directory is the one where you installed the
-support tree; the directory layout will be as follows (where \$TEXDIR
-stands for the directory you chose):
-
-\noindent
-\begin{tabular}{>{\ttfamily}ll@{}}
- \dirname{$TEXDIR/share/texmf} & main tree with fonts,\\
- & \qquad macros, etc\\
- \dirname{$TEXDIR/man} & Unix manual pages\\
- \dirname{$TEXDIR/info} & \acro{GNU} style Info manuals\\
- \dirname{$TEXDIR/bin/$PLATFORM} & binaries\\
-\end{tabular}
-%$
-
-If you want to leave out the \dirname{$PLATFORM} directory level,
-i.e., put the binaries directly into \dirname{$TEXDIR/bin}, specify
-the \verb|--disable-multiplatform| option to \cmdname{configure}.
-
-Have a look at the output of \verb|./configure --help| for more
-options you can use. For example, you can skip building of \OMEGA{} and
-\eTeX{}.
-
-
-\subsection{Running \cmdname{make}}
-
-Make sure the shell variable or option \texttt{noclobber} is not set.
-Then, run the main \cmdname{make} like this:
-\begin{alltt}
-> \Ucom{make world}
-\end{alltt}
-and relax\ldots
-
-Alternatively, you want to log all the output, as in:
-\begin{alltt}
-> \Ucom{sh -c "make world >world.log 2>\&1" \&}
-\end{alltt}
-
-Before you believe that everything went ok, please check the log file
-for errors: \acro{GNU} \cmdname{make} always uses the string \samp{***}
-whenever a command fails. Also, check if all the programs were built:
-
-\begin{alltt}
-> \Ucom{cd \var{TEXDIR}/bin/\var{archname}}
-> \Ucom{ls | wc}
-\end{alltt}
-The result should be over 200 (you can check the exact number with the
-\dirname{bin} directory contents in the distribution).
-
-If you need special privileges for \texttt{make install}, you can
-separate the \samp{make world} into two different runs, like this:
-\begin{alltt}
-> \Ucom{make all}
-> \Ucom{su}
-> \Ucom{make install strip}
-\end{alltt}
-
-After you've installed your new binaries, you should follow the normal
-post-installation procedures, given in section~\ref{sec:postinstall}
-(\p.\pageref{sec:postinstall}).
-
-Also, if you'd like to make your binaries available to others, please
-contact us. We'll be happy to put them on the \TL\ web pages.
-\end{comment}
-
-\section{Acknowledgements}
-
-\TL{} is a joint effort by virtually all of the \TeX{} user groups.
-This edition of \TL{} was overseen by Sebastian Rahtz and Karl Berry.
-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 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 Peter Breitenlohner and the \eTeX\ team for the stable foundation
-of future \TeX's.
-
-\item Thomas Esser, without whose marvelous \teTeX{} package \TL{}
-would certainly not exist, and whose continual help makes it a better
-product.
-
-\item Michel Goossens, who co-authored the original documentation.
-
-\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.
-
-\item Hans Hagen, for major testing and making the \ConTeXt\ format
-conform to \TL's needs.
-
-\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 Petr Olsak, who coordinated and checked all the Czech and Slovak
-material very carefully.
-
-\item Fabrice Popineau, for the Windows binaries in \TL{}.
-
-\item Staszek Wawrykiewicz, the principal tester for all of \TL{},
-and coordinator of the many major Polish contributions: fonts, Windows
-installation, and more.
-
-\item Olaf Weber, for his patient assembly and maintenance of Web2C,
-upon which all else depends.
-
-\item Gerben Wierda, for creating and maintaining the \MacOSX\ support,
-and much integration and testing.
-
-\item Graham Williams, on whose work the catalogue of packages depends.
-
-\end{itemize*}
-
-Builders of the binaries:
-Tigran Aivazian (\pkgname{x86\_64-linux}),
-Manfred Lotz (\pkgname{i386-freebsd}),
-Fabrice Popineau (\pkgname{win32}),
-Norbert Preining (\pkgname{alpha-linux}),
-Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-linux},
- \pkgname{sparc-solaris}),
-Staszek Wawrykiewicz (\pkgname{i386-linux}),
-Olaf Weber (\pkgname{mips-irix}),
-Gerben Wierda (\pkgname{i386-darwin}, \pkgname{powerpc-darwin}).
-
-Documentation and translation updates:
-Karl Berry (English),
-Daniel Flipo \& Fabrice Popineau (French),
-G\"unter Partosch \& Hartmut Henkel (German),
-Petr Sojka \& Jan Busa (Czech\slash Slovak),
-Boris Veytsman (Russian),
-Staszek Wawrykiewicz (Polish).
-
-Of course the most important acknowledgement must go to Donald Knuth, first
-for inventing \TeX, and then for giving it to the world.
-
-
-\section{Release history}
-\label{sec:history}
-
-\subsection{Past}
-
-Discussion began in late 1993 when the Dutch \TeX{} Users Group was
-starting work on its 4All\TeX{} \CD{} for \acro{MS-DOS} users, and it
-was hoped at that time to issue a single, rational, \CD{} for all
-systems. This was too ambitious a target for the time, but it did spawn
-not only the very successful 4All\TeX{} \CD{}, but also the \acro{TUG}
-Technical Council working group on a \emph{\TeX{} Directory Structure}
-(\url{http://tug.org/tds}), which specified how to create consistent and
-manageable collections of \TeX{} support files. A complete draft of the
-\TDS{} was published in the December 1995 issue of \textsl{TUGboat}, and
-it was clear from an early stage that one desirable product would be a
-model structure on \CD{}. The distribution you now have is a very direct
-result of the working group's deliberations. It was also clear that the
-success of the 4All\TeX{} \CD{} showed that Unix users would benefit
-from a similarly easy system, and this is the other main strand of
-\TL.
-
-We first undertook to make a new Unix-based \TDS{} \CD{} in the autumn
-of 1995, and quickly identified Thomas Esser's \teTeX{} as the ideal
-setup, as it already had multi-platform support and was built with
-portability across file systems in mind. Thomas agreed to help, and work
-began seriously at the start of 1996. The first edition was released in
-May 1996. At the start of 1997, Karl Berry completed a major new release
-of Web2c, which included nearly all the features which Thomas Esser had
-added in \teTeX, and we decided to base the 2nd edition of the \CD{} on
-the standard \Webc, with the addition of \teTeX's \texttt{texconfig}
-script. The 3rd edition of the \CD{} was based on a major revision of
-\Webc, 7.2, by Olaf Weber; at the same time, a new revision of \teTeX
-was being made, and \TL{} included almost all of its features. The
-4th edition followed the same pattern, using a new version of \teTeX,
-and a new release of \Webc{} (7.3). The system now included a complete
-Windows setup.
-
-For the 5th edition (March 2000) many parts of the \CD{} were revised
-and checked, updating hundreds of packages. Package details were stored
-in XML files. But the major change for \TeX\ Live 5 was that all
-non-free software was removed. Everything in \TL{} is now intended
-to be compatible with the Debian Free Software Guidelines
-(\url{http://www.debian.org/intro/free}); we have done our best to check
-the license conditions of all packages, but we would very much
-appreciate hearing of any mistakes.
-
-The 6th edition (July 2001) had much more material updated. The major
-change was a new install concept: the user could select a more exact set
-of needed collections. Language-related collections were completely
-reorganized, so selecting any of them installs not only macros, fonts,
-etc., but also prepares an appropriate \texttt{language.dat}.
-
-The 7th edition of 2002 had the notable addition of \MacOSX{} support,
-and the usual myriad of updates to all sorts of packages and
-programs. An important goal was integration of the source back with
-\teTeX, to correct the drift apart in versions~5 and~6.
-
-\subsubsection{2003}
-
-In 2003, with the continuing flood of updates and additions, we found
-that \TL{} had grown so large it could no longer be contained on a
-single \CD, so we split it into three different distributions (see
-section~\ref{sec:multiple-dist}, \p.\pageref{sec:multiple-dist}). In
-addition:
-
-\begin{itemize*}
-\item At the request of the \LaTeX{} team, we changed the standard
- \cmdname{latex} and \cmdname{pdflatex} commands to now use \eTeX{} (see
- \p.\pageref{text:etex}).
-\item The new Latin Modern fonts were included (and are recommended).
-\item Support for Alpha \acro{OSF} was removed
- (\acro{HPUX} support was removed previously), since no one had (or
- volunteered) hardware available on which to compile new binaries.
-\item Windows setup was substantially changed; for the first time
- an integrated environment based on XEmacs was introduced.
-\item Important supplementary programs for Windows
- (Perl, Ghost\-script, Image\-Magick, Ispell) are now installed
- in the \TL{} installation directory.
-\item Font map files used by \cmdname{dvips}, \cmdname{dvipdfm}
- and \cmdname{pdftex} are now generated by the new program
- \cmdname{updmap} and installed into \dirname{texmf/fonts/map}.
-\item \TeX{}, \MF{}, and \MP{} now, by default, output most input
- characters (32 and above) as themselves in output (e.g.,
- \verb|\write|) files,
- log files, and the terminal, i.e., \emph{not} translated using the
- \verb|^^| notation. In \TL{}~7, this translation was
- dependent on the system locale settings; now, locale settings do
- not influence the \TeX{} programs' behavior. If for some reason
- you need the \verb|^^| output, rename the file
- \verb|texmf/web2c/cp8bit.tcx|. (Future releases will have cleaner
- ways to control this.)
-\item This documentation was substantially revised.
-\item Finally, since the edition numbers had grown unwieldy,
- the version is now simply identified by the year: \TL{} 2003.
-\end{itemize*}
-
-
-\subsubsection{2004}
-
-2004 saw many changes:
-
-\begin{itemize}
-
-\item If you have locally-installed fonts which use their own
-\filename{.map} or (much less likely) \filename{.enc} support files, you
-may need to move those support files.
-
-\filename{.map} files are now searched for in subdirectories of
-\dirname{fonts/map} only (in each \filename{texmf} tree), along the
-\envname{TEXFONTMAPS} path. Similarly, \filename{.enc} files are now
-searched for in subdirectories of \dirname{fonts/enc} only, along the
-\envname{ENCFONTS} path. \cmdname{updmap} will attempt to warn about
-problematic files.
-
-For methods of handling this and other information, please see
-\url{http://tug.org/texlive/mapenc.html}.
-
-\item The \TK\ has been expanded with the addition of a \MIKTEX-based
-installable \CD, for those who prefer that implementation to Web2C.
-See section~\ref{sec:struct-tl} (\p.\pageref{sec:struct-tl}).
-
-\item Within \TL, the single large \dirname{texmf} tree of previous
-releases has been replaced by three: \dirname{texmf},
-\dirname{texmf-dist}, and \dirname{texmf-doc}. See
-section~\ref{sec:tld} (\p.\pageref{sec:tld}), and the \filename{README}
-files for each.
-
-\item All \TeX-related input files are now collected in
-the \dirname{tex} subdirectory of \dirname{texmf*} trees, rather than
-having separate sibling directories \dirname{tex}, \dirname{etex},
-\dirname{pdftex}, \dirname{pdfetex}, etc. See
-\CDref{texmf-doc/doc/english/tds/tds.html\#Extensions}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Extensions}}.
-
-\item Helper scripts (not meant to be invoked by users) are now located
-in a new \dirname{scripts} directory of \dirname{texmf*} trees, and
-searched for via \verb|kpsewhich -format=texmfscripts|. So if you have
-programs which call such scripts, they'll need to be adjusted. See
-\CDref{texmf-doc/doc/english/tds/tds.html\#Scripts}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Scripts}}.
-
-\item Almost all formats leave most characters printable as
-themselves via the ``translation file'' \filename{cp227.tcx}, instead of
-translating them with the \verb|^^| notation. Specifically, characters
-at positions 32--256, plus tab, vertical tab, and form feed are
-considered printable and not translated. The exceptions are plain \TeX\
-(only 32--126 printable), \ConTeXt\ (0--255 printable), and the
-\OMEGA-related formats. This default behavior is almost the same as in
-\TL\,2003, but it's implemented more cleanly, with more possibilities
-for customization. See \CDref{texmf/doc/web2c/web2c.html\#TCX-files}
-{\texttt{texmf/doc/web2c/web2c.html\#TCX-files}}.
-(By the way, with Unicode input, \TeX\ may output partial character
-sequences when showing error contexts, since it is byte-oriented.)
-
-\item \textsf{pdfetex} is now the default engine for all formats
-except (plain) \textsf{tex} itself. (Of course it generates \acro{DVI}
-when run as \textsf{latex}, etc.) This means, among other things, that
-the microtypographic features of \textsf{pdftex} are available in
-\LaTeX, \ConTeXt, etc., as well as the \eTeX\ features
-(\OnCD{texmf-dist/doc/etex/base/}).
-
-It also means it's \emph{more important than ever} to use the
-\pkgname{ifpdf} package (works with both plain and \LaTeX) or equivalent
-code, because simply testing whether \cs{pdfoutput} or some other
-primitive is defined is not a reliable way to determine if \acro{PDF}
-output is being generated. We made this backward compatible as best we
-could this year, but next year, \cs{pdfoutput} may be defined even when
-\acro{DVI} is being written.
-
-\item pdf\TeX\ (\url{http://pdftex.org}) has many new features:
-
- \begin{itemize*}
-
- \item \cs{pdfmapfile} and \cs{pdfmapline} provide font map support
- from within a document.
-
- \item Microtypographic font expansion can be used more easily.\\
- \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}
-
- \item All parameters previously set through the special configuration
- file \filename{pdftex.cfg} must now be set through primitives,
- typically in \filename{pdftexconfig.tex}; \filename{pdftex.cfg} is no
- longer supported. Any extant \filename{.fmt} files must be redumped
- when \filename{pdftexconfig.tex} is changed.
-
- \item See the pdf\TeX\ manual for more: \OnCD{texmf/doc/pdftex/manual}.
-
- \end{itemize*}
-
-\item The \cs{input} primitive in \cmdname{tex} (and \cmdname{mf} and
-\cmdname{mpost}) now accepts double quotes containing spaces and other
-special characters. Typical examples:
-\begin{verbatim}
-\input "filename with spaces" % plain
-\input{"filename with spaces"} % latex
-\end{verbatim}
-See the Web2C manual for more: \OnCD{texmf/doc/web2c}.
-
-\item enc\TeX\ support is now included within Web2C and consequently all
-\TeX\ programs, via the \optname{-enc} option\Dash \emph{only when
-formats are built}. enc\TeX\ supports general re-encoding of input and
-output, enabling full support of Unicode (in \acro{UTF}-8). See
-\OnCD{texmf-dist/doc/generic/enctex/} and
-\url{http://www.olsak.net/enctex.html}.
-
-\item Aleph, a new engine combining \eTeX\ and \OMEGA, is available.
-A little information is available in \OnCD{texmf-dist/doc/aleph/base}
-and \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}. The
-\LaTeX-based format for Aleph is named \textsf{lamed}.
-
-\item The latest \LaTeX\ release has a new version of the
-\acro{LPPL}\Dash now officially a Debian-approved license. Assorted
-other updates, see the \filename{ltnews} files in
-\OnCD{texmf-dist/doc/latex/base}.
-
-\item \cmdname{dvipng}, a new program for converting \acro{DVI} to
-\acro{PNG} image files, is included. See \OnCD{texmf/doc/man/man1/dvipng.1}.
-
-\item We reduced the \pkgname{cbgreek} package to a ``medium'' sized set
-of fonts, with the assent and advice of the author (Claudio Beccari).
-The excised fonts are the invisible, outline, and transparency ones,
-which are relatively rarely used, and we needed the space. The full set
-is of course available from \acro{CTAN}
-(\url{http://www.ctan.org/tex-archive/fonts/greek/cb}).
-
-\item \cmdname{oxdvi} has been removed; just use \cmdname{xdvi}.
-
-\item The \cmdname{ini} and \cmdname{vir} commands (links) for
-\cmdname{tex}, \cmdname{mf}, and \cmdname{mpost} are no longer created,
-such as \cmdname{initex}. The \cmdname{ini} functionality has been
-available through the command-line option \optname{-ini} for years now.
-
-\item \textsf{i386-openbsd} platform support was removed. Since the
-\pkgname{tetex} package in the \acro{BSD} Ports system is available, and
-\acro{GNU/}Linux and Free\acro{BSD} binaries were available, it seemed
-volunteer time could be better spent elsewhere.
-
-\item On \textsf{sparc-solaris} (at least), you may have to set the
-\envname{LD\_LIBRARY\_PATH} environment variable to run the
-\pkgname{t1utils} programs. This is because they are compiled with C++,
-and there is no standard location for the runtime libraries. (This is
-not new in 2004, but wasn't previously documented.) Similarly, on
-\textsf{mips-irix}, the \acro{MIPS}pro 7.4 runtimes are required.
-
-\end{itemize}
-
-\subsection{Present}
-\label{tlcurrent}
-
-2005 saw the usual huge number of updates to packages and programs.
-The infrastructure stayed relatively stable from 2004, but inevitably
-there were some changes there as well:
-
-\begin{itemize}
-
-\item New scripts \cmdname{texconfig-sys}, \cmdname{updmap-sys}, and
- \cmdname{fmtutil-sys} were introduced, which modify the
- 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
- files (user or system, respectively) are found. Thus, you may
- need to move personal versions of \filename{fmtutil.cnf} and
- \filename{updmap.cfg} to these places; another option is to
- redefine \envname{TEXMFCONFIG} or \envname{TEXMFSYSCONFIG} in
- \filename{texmf.cnf}. In any case the real location of these files
- and the values of \envname{TEXMFCONFIG} and \envname{TEXMFSYSCONFIG}
- must agree.
- 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
- 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
- can use the package \pkgname{ifpdf.sty} (which works under both
- plain \TeX\ and \LaTeX) to do this, or steal its logic.
-
-\item Last year, we changed most formats to output (8-bit) characters as
- themselves (see previous section). The new TCX file
- \filename{empty.tcx} now provides an easier way to get the
- original \verb|^^| notation if you so desire, as in:
-\begin{verbatim}
-latex --translate-file=empty.tcx yourfile.tex
-\end{verbatim}
-
-\item The new program \cmdname{dvipdfmx} is included for translation of
- DVI to PDF; this is an actively maintained update of
- \cmdname{dvipdfm} (which is also still available for now, though
- no longer recommended).
-
-\item The new programs \cmdname{pdfopen} and \cmdname{pdfclose} are included
- to allow reloading of pdf files in the Adobe Acrobat Reader without
- restarting the program. (Other pdf readers, notably \cmdname{xpdf},
- \cmdname{gv}, and \cmdname{gsview}, have never suffered from this
- problem.)
-
-\item For consistency, the variables \envname{HOMETEXMF} and
- \envname{VARTEXMF} have been renamed to \envname{TEXMFHOME} and
- \envname{TEXMFSYSVAR}, respectively. There is also
- \envname{TEXMFVAR}, which is by default user-specific. See the
- first point above.
-
-\end{itemize}
-
-\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
-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
-a great deal remains to be done. If you can help, don't hesitate to put
-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}
-
-\medskip
-\noindent \textsl{Happy \TeX ing!}
-
-\end{document}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/live-2007.tex b/Master/texmf-doc/source/texlive/texlive-en/archive/live-2007.tex
deleted file mode 100644
index 8232db8becf..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/live-2007.tex
+++ /dev/null
@@ -1,3264 +0,0 @@
-% $Id: live.tex 3938 2007-02-06 01:49:45Z karl $
-% TeX Live documentation. Originally written by Sebastian Rahtz and
-% Michel Goossens, now maintained by Karl Berry and others.
-% Public domain.
-%
-\documentclass{article}
-\let\tldocenglish=1 % for live4ht.cfg
-\usepackage{tex-live}
-\begin{document}
-
-\title{%
- {\huge \textit{The \protect\TL{} Guide}\\\strut}
- {\LARGE \textsf{\TL{} 2007}}
-}
-
-\author{Karl Berry, editor \\[3mm]
- \url{http://tug.org/texlive/}
- }
-
-\date{January 2007}
-
-\maketitle
-
-\begin{multicols}{2}
-\tableofcontents
-\listoftables
-\end{multicols}
-
-\section{Introduction}
-\label{sec:intro}
-
-This document describes the main features of the \TL{} software
-distribution\Dash \TeX{} and friends for \acro{GNU}/Linux and other Unix
-flavors, \MacOSX, and (32-bit) Windows systems. (Warning: it is not
-especially useful for older Mac or \acro{MS-DOS} systems.)
-
-\TL{} includes executables for \TeX{}, \LaTeXe{}, \ConTeXt, \MF, \MP,
-\BibTeX{} and many other programs; an extensive collection of macros,
-fonts and documentation; and support for typesetting in many different
-scripts from around the world. It is part of the even larger \TK{}
-(briefly described below in section~\ref{sec:struct-tl},
-\p.\pageref{sec:struct-tl}). Both are cooperative efforts by the \TeX\
-user groups.
-
-For newer versions of the packages included here, please check
-\acro{CTAN}: \url{http://www.ctan.org}.
-
-For a brief summary of the major changes in this edition of \TL{},
-see the end of the document, section~\ref{sec:history}
-(\p.\pageref{sec:history}).
-
-
-\subsection{Basic usage of \protect\TL{}}
-\label{sec:basic}
-
-You can use \TL{} in three principal ways:
-
-\begin{enumerate}
-
-\item You can run \TL{} directly from the \pkgname{live} \DVD
-(see section~\ref{sec:multiple-dist}, \p.\pageref{sec:multiple-dist}).
-This takes almost no disk space, and gives you immediate access to
-everything in \TL{}. Of course performance will be worse than running
-on local disk, but you may well find it useful.
-
-\item You can install all or part of \TL{} to a local disk, from either
-the \DVD\ or the \pkgname{inst} \acro{CD}. This is the most common use
-of \TL. You will need (approximately) 100 megabytes for the most
-minimal system, and upwards of 1.3 gigabytes for a full system.
-
-\item You can integrate a particular package or collection into your
-existing \TeX{} system, either a \TL{} system you installed
-earlier, or a different system.
-
-\end{enumerate}
-
-\noindent All of these are described in detail in the \acro{OS}-specific
-installation sections following, but here is a quick start:
-
-\begin{itemize*}
-
-\item The main installation script for Unix and \MacOSX{} is
-\texttt{install-tl.sh}.
-GNU/Linux users can also try a new GUI installation program:
-run \texttt{setuptl/tlpmgui}. More information
-can be found in section \ref{sec:win-install} on
-p.~\pageref{sec:win-install}.
-
-\item The single package installation script is \texttt{install-pkg.sh}.
-(After installation on Linux with \texttt{tlpmgui}, you can also try
-running \texttt{tlpmgui} again to add or remove individual packages or
-collections.)
-
-\item The installation program for Windows is \texttt{tlpmgui.exe}.
-It can be used also for adding or removing the packages.
-See section~\ref{sec:win-install} below for more information.
-
-\end{itemize*}
-
-
-\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.)
-
-Here is a list of resources, approximately in the order we recommend
-using them:
-
-\begin{description}
-\item [Getting Started] If you are new to \TeX, the web page
-\url{http://tug.org/begin.html} gives a brief introduction to the system.
-
-\item [\TeX{} \acro{FAQ}] The \TeX{} \acro{FAQ} is a huge compendium of
-answers to all sorts of questions, from the most basic to the most
-arcane. It is included on \TL{} in \OnCD{texmf-doc/doc/english/FAQ-en}, and is
-available on the Internet through \url{http://www.tex.ac.uk/faq}.
-Please check here first.
-
-\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://www.ctan.org/tex-archive/help/Catalogue}.
-
-\item [\TeX{} Web Resources] The web page
-\url{http://tug.org/interest.html} has many \TeX{}-related links, in
-particular for numerous books, manuals, and articles on all aspects of
-the system.
-
-\item [support archives] The two principal support forums are the
-Usenet newsgroup \url{news:comp.text.tex} and the mailing list
-\email{texhax@tug.org}. Their archives have years of past
-questions and answers for your searching pleasure, via
-\url{http://groups.google.com/groups?group=comp.text.tex} and
-\url{http://tug.org/mail-archives/texhax}, respectively. And a general web
-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:
-\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.
-
-\end{description}
-
-The other side of the coin is helping others who have questions. Both
-\dirname{comp.text.tex} and \code{texhax} are open to anyone, so feel
-free to join, start reading, and help out where you can. Welcome to
-\TeX{}!
-
-
-% don't use \TL so the \uppercase in the headline works. Also so
-% tex4ht ends up with the right TeX. Likewise the \protect's.
-\section{Structure of \protect\TeX\protect\ Live}
-\label{sec:struct-tl}
-
-This section describes the structure and contents of \TL{} and the
-\TK{} of which it is a part.
-
-\subsection{Multiple distributions: \protect\pkgname{live},
- \protect\pkgname{inst},
- \protect\pkgname{protext}}
-\label{sec:multiple-dist}
-
-Space limitations of \acro{CD-ROM} format have forced us to divide
-\TK{} into several distributions, as follows.
-
-\begin{description}
-
-\item [live] A complete system on \acro{DVD}; it is too large
-for \acro{CD}. It can be run live or installed to disk. It also
-includes a snapshot of the \CTAN{} repository, the \pkgname{protext}
-distribution for Windows and the Mac\TeX\ distribution for \MacOSX, entirely
-independent of \TL{}, as well as assorted other packages in a
-\texttt{texmf-extra} directory.
-
-\CTAN{}, \pkgname{protext}, Mac\TeX, and \texttt{texmf-extra} do not follow
-the same copying conditions as \TL{}, so be careful when redistributing or
-modifying.
-
-\item [inst(allable)] A complete system on \CD; in order to make this fit,
-the packages and programs are compressed. Therefore, it is not possible
-to run \TeX\ directly from the installable \CD, you have to install it
-to disk (hence its name). Installation is described in subsequent sections.
-
-\item [protext] 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}.
-
-\ProTeXt\ is provided as both the top level of the \pkgname{live} \DVD\
-and on its own \CD\ (for those who cannot use the \DVD).
-
-\end{description}
-
-\noindent You can tell which type of distribution you're in by looking
-for a \texttt{00\var{type}.TL} 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}
-\label{sec:tld}
-
-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{texliveYYYY}, not at the top
-level of the disc.
-
-\smallskip
-\begingroup
- \renewcommand{\arraystretch}{1.3} % open up interrow spacing
-\begin{tabular}{>{\ttfamily}lp{.78\hsize}}
-bin & The \TeX{} system programs, arranged by platform. \\
-source & The source of all programs, including the main \Webc{}
- \TeX{} and \MF{} distributions. These are stored in a
- \cmdname{bzip2}-compressed tar archive. \\
-setuptl & Installation programs for Linux and Windows. \\
-support & Assorted auxiliary packages and programs. These are
- \emph{not} installed automatically. This includes
- assorted editors and \TeX\ shells. \\
-texmf & Tree for the programs, along with their support files and
- documentation. Does not include \TeX\ formats and packages.
- (\texttt{TEXMFMAIN} in the next section.) \\
-texmf-dist & The main tree of formats and packages.
- (\texttt{TEXMFDIST} in the next section.) \\
-texmf-doc & Tree for self-contained pure documentation, arranged by
- language. \\
-texmf-var & Tree for files automatically generated and stored.
- (\texttt{TEXMFSYSVAR} in the next section.) \\
-\end{tabular}
-\endgroup
-
-\smallskip
-
-In addition to the directories above, the installation scripts and
-\filename{README} files (in various languages) are at the top level of
-the distribution.
-
-The \dirname{texmf-doc} directory contains only documentation, but
-it does not contain all the documentation. The documentation for the
-programs (manuals, man pages, Info files) is in \dirname{texmf/doc},
-since the programs are in \dirname{texmf}. Similarly, the documentation
-for \TeX\ packages and formats is in \dirname{texmf-dist/doc}. You can
-use the \cmdname{texdoc} or \cmdname{texdoctk} programs to find any
-documentation wherever it's located. The comprehensive links in the
-top-level file \OnCD{doc.html} may also be helpful.
-
-
-\subsection{Overview of the predefined texmf trees}
-\label{sec:texmftrees}
-
-This section lists all predefined variables specifying texmf trees used
-by the system, and their intended purpose. The command \texttt{texconfig
-conf} shows you the values of these variables, so that you can easily
-find out how they map to directory names in your installation.
-
-\begin{ttdescription}
-\item [TEXMFMAIN] The tree which holds vital parts of the system
- such as helper scripts (e.g., \verb+web2c/mktexdir+), pool files and
- other support files.
-\item [TEXMFDIST] The tree which holds the main set of macro packages,
- fonts, etc., as originally distributed.
-\item [TEXMFLOCAL] The tree which administrators can use for system-wide
- installation of additional or updated macros, fonts, etc.
-\item [TEXMFHOME] The tree which users can use for their own individual
- installations of additional or updated macros, fonts, etc.
- The expansion of this variable depends on \verb+$HOME+ by default, % $
- which dynamically adjusts for each user to an individual
- directory.
-\item [TEXMFCONFIG] The tree used by te\TeX's utilities
- \verb+texconfig+, \verb+updmap+, and \verb+fmtutil+ to store modified
- configuration data. Under \verb+$HOME+ by default. %$
-\item [TEXMFSYSCONFIG] The tree used by te\TeX's utilities
- \verb+texconfig-sys+, \verb+updmap-sys+, and \verb+fmtutil-sys+ to
- store modified configuration data.
-\item [TEXMFVAR] The tree used by \verb+texconfig+, \verb+updmap+ and
- \verb+fmtutil+ to store (cached) runtime data such as format files and
- generated map files. Under \verb+$HOME+ by default. %$
-\item [TEXMFSYSVAR] The tree used by \verb+texconfig-sys+,
- \verb+updmap-sys+ and \verb+fmtutil-sys+ to store (cached) runtime
- data such as format files and generated map files.
-\end{ttdescription}
-
-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}
-
-\TL{} contains several extended versions of \TeX:
-
-\begin{description}
-
-\item [\eTeX] adds a small but powerful set of new primitives
-\label{text:etex} (related to macro expansion, character scanning,
-classes of marks, additional debugging features, and more) and the
-\TeXXeT{} extensions for bidirectional typesetting. In default mode,
-\eTeX{} is 100\% compatible with ordinary \TeX. See
-\OnCD{texmf-dist/doc/etex/base/etex_man.pdf}.
-
-\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}. This is the
-default program for all formats except plain \TeX.
-
-\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
-also supports so-called `\OMEGA{} Translation Processes' (\acro{OTP}s),
-for performing complex transformations on arbitrary input. See
-\OnCD{texmf-dist/doc/omega/base/doc-1.8.tex} (not completely up-to-date).
-
-\item [Aleph] combines the \OMEGA\ and \eTeX\ extensions.
-See \OnCD{texmf-dist/doc/aleph/base} for some minimal documentation.
-
-\end{description}
-
-
-\subsection{Other notable programs in \protect\TL}
-
-Here are a few other commonly-used programs included in \TL{}:
-
-\begin{cmddescription}
-
-\item [bibtex] bibliography support.
-
-\item [makeindex] index support.
-
-\item [dvips] convert \dvi{} to \PS{}.
-
-\item [xdvi] \dvi{} previewer for the X Window System.
-
-\item [dvilj] \dvi{} drive for the HP LaserJet family.
-
-\item [dv2dt, dt2dv] convert \dvi{} to/from plain text.
-
-\item [dviconcat, dviselect] cut and paste pages
-from \dvi{} files.
-
-\item [dvipdfmx] convert \dvi{} to \acro{PDF}, an alternative approach
-to pdf\TeX\ (mentioned above). See the \pkgname{ps4pdf} and
-\pkgname{pdftricks} packages for still more alternatives.
-
-\item [psselect, psnup, \ldots] \PS{}
-utilities.
-
-\item [lacheck] \LaTeX{} syntax checker.
-
-\item [texexec] Con\TeX{}t and \acro{PDF} processor.
-
-\item [tex4ht] \TeX{} to \acro{HTML} converter.
-
-\end{cmddescription}
-
-
-\section{Unix installation}
-\label{sec:unix-install}
-
-As introduced in section~\ref{sec:basic} (\p.\pageref{sec:basic}),
-\TL{} has three principal uses:
-
-\begin{enumerate}
-\item Run directly from media.
-\item Install to disk.
-\item Integrate a particular package or collection into your existing
-\TeX{} installation.
-\end{enumerate}
-
-\noindent The following sections describes the Unix-specific procedures
-for each of these.
-
-\ifSingleColumn \begin{figure}[ht]\noindent \fi
-\begin{warningbox}
-\textbf{Warning: } The \TK{} \CD{}s and \DVD{} are in ISO 9660 (High Sierra)
-format, \emph{with} Rock Ridge (and Joliet, for Windows)
-extensions. Therefore, in order to take full advantage of the \TK{}
-under Unix, your system needs to be able to use the Rock Ridge
-extensions. Please consult the documentation for your \cmdname{mount}
-command to see how to do this. If you have several different machines
-on a local network, you may be able to mount the discs on one which
-does support Rock Ridge, and use this with the others.
-
-\leavevmode\quad Modern systems should be able to use the discs without
-problems. If troubles, let us know. The discussion below assumes you
-have been able to mount the \CD{}s with full Rock Ridge compatibility.
-\end{warningbox}
-\ifSingleColumn\end{figure}\fi
-
-
-%
-\subsection{Running \protect\TL{} directly from media (Unix)}
-
-\def\runlive{% text repeated in windows section
-It is possible to use the \TeX{} system directly from the \pkgname{live}
-\DVD{}, without installing the distribution to disk. (Thus the name
-\TeX\ `Live', in fact.) It is \emph{not} possible to run \TeX{}
-directly from the other \CD{}s (see section~\ref{sec:multiple-dist},
-\p.\pageref{sec:multiple-dist}).
-}
-
-\def\startinst{% repeated in other subsections
-To start, you mount the \CD{} or \DVD{}, with Rock Ridge extensions
-enabled. The exact command to do this varies from system to system; the
-following works under Linux, except the name of the device
-(\filename{/dev/cdrom}, here) may vary. (All our examples will use
-\texttt{>} as the shell prompt; user input is
-\Ucom{\texttt{underlined}}.)
-\begin{alltt}
-> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom}
-\end{alltt}
-
-\noindent Change the current directory to the mount point:
-\begin{alltt}
-> \Ucom{cd /mnt/cdrom}
-\end{alltt}
-
-\noindent Under \MacOSX, the directory is typically under
-\dirname{/Volumes}, and the media will be mounted automatically.
-}
-
-\def\installtlsh{
-Run the installation script \filename{install-tl.sh}:
-\begin{alltt}
-> \Ucom{sh install-tl.sh}\\
-Welcome to TeX Live...
-\end{alltt}
-
-\noindent After various greeting messages and a list of the main menu
-options, the installation will ask you to enter a command. Do this by
-typing the desired character and hitting return; don't type the angle
-brackets shown. Either uppercase or lowercase is ok; we'll use
-lowercase in our examples.
-}
-
-\runlive
-\startinst
-\installtlsh
-
-For running live, our first command will be \Ucom{d} and then the
-subcommand \Ucom{1} to set directories. Even in this case, we must
-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/texlive2007} in this example. It's good to
-include the year in the name, as these generated files are not
-in general compatible from release to release. (If the default value of
-\dirname{/usr/local/texlive/2007} works for you, then you can skip this
-step.)
-
-\begin{alltt}
-Enter command: \Ucom{d}
-Current directories setup:
-<1> TEXDIR: /usr/local/texlive/2007
-...
-Enter command: \Ucom{1}
-New value for TEXDIR [/usr/local/texlive/TeX]: \Ucom{/opt/texlive2007}
-...
-Enter command: \Ucom{r}
-\end{alltt}
-
-\noindent Back at the main menu, our second and last command is
-\Ucom{r}, to set up for running live off the media without installing
-to disk:
-\begin{alltt}
-Enter command: \Ucom{r}
-Preparing destination directories...
-...
-Welcome to TeX Live!
->
-\end{alltt}
-
-\noindent And we are back at the system prompt, as shown.
-
-Next, it is necessary to alter two environment variables:
-\envname{PATH}, to an architecture-dependent value (so that we can run
-the programs), and \envname{TEXMFSYSVAR}, to the value specified above.
-See table~\ref{tab:archlist} for a list of the architecture names for
-the different systems.
-
-
-\def\textruntexconfig{%
-After the main installation has completed, and environment variables
-have been set, the last step is to run \cmdname{texconfig} or
-\cmdname{texconfig-sys} to customize your installation to your needs.
-This is explained in section~\ref{sec:texconfig},
-\p.\pageref{sec:texconfig}.
-}
-\textruntexconfig
-
-\begin{table*}[ht]
-\caption[Supported system architectures.]{Supported system
-architectures.}
-\label{tab:archlist}
-\begin{tabular}{>{\ttfamily}ll}
-alpha-linux & HP Alpha GNU/Linux \\
-hppa-hpux & HPPA HP-UX \\
-i386-darwin & x86 \MacOSX \\
-i386-freebsd & x86 FreeBSD \\
-i386-linux & x86 GNU/Linux \\
-i386-openbsd & x86 OpenBSD \\
-i386-solaris & x86 Solaris \\
-mips-irix & SGI IRIX \\
-powerpc-aix & IBM RS/6000 AIX \\
-powerpc-darwin & PowerPC \MacOSX \\
-powerpc-linux & PowerPC GNU/Linux \\
-sparc-linux & Sun Sparc GNU/Linux \\
-sparc-solaris & Sun Sparc Solaris \\
-win32 & Windows (32-bit) \\
-x86\_64-linux & x86 64-bit GNU/Linux \\
-\hline
-\end{tabular}
-\end{table*}
-
-\label{text:path}
-The syntax for setting the environment variables, and the initialization
-file to put them in, depends on the shell you use. If you use a
-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/texlive2007/texmf-var; export TEXMFSYSVAR
-\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/texlive2007/texmf-var
-\end{alltt}
-
-\noindent Then log out, log back in, and test your installation
-(see section~\ref{sec:test-install}, \p.\pageref{sec:test-install}).
-
-\def\textifindoubt{%
-If in doubt, please ask any local system gurus to help you with
-problems; for example, the way to mount the \TL{} media, which
-directory or directories to use, and precise details of the changes to
-your personal initialization files can and do vary from site to site.
-}
-\textifindoubt
-
-
-%
-\subsection{Installing \protect\TeX\protect\ Live to disk}
-\label{sec:unix-install-disk}
-
-It is possible, indeed typical, to install the \TL{} distribution to
-hard disk. This can be done from either the \pkgname{live} or
-\pkgname{inst} distributions. (See section~\ref{sec:multiple-dist},
-\p.\pageref{sec:multiple-dist}, for an explanation of the different
-distributions.)
-
-\startinst
-\installtlsh
-
-Table~\ref{tab:main-menu-options} briefly lists the options in the main
-menu. The order in which you select the options makes little
-difference, except that \Ucom{i} must be last. It's reasonable to go
-through them in the order presented here.
-
-% apparently here.sty [H] doesn't support table*.
-\begin{table}[H]
-\caption{Main menu options for the installation.}
-\label{tab:main-menu-options}
-\begin{tabular}{>{\ttfamily}ll}
-p & The platform you are running on.\\
-b & The architectures for which to install binaries.\\
-s & The base installation scheme to use (minimal, recommended,
- full, etc.)\\
-c & Override the base scheme for individual collections.\\
-l & Override for language collections.\\
-d & Directories in which to install.\\
-o & Other options.\\
-i & Perform the installation.\\
-\end{tabular}
-\end{table}
-
-Here are further details on each option.
-
-\textbf{\optname{p} -- Current platform.} Since the installation script
-automatically guesses which platform you're running on, it is usually
-unnecessary to use this option. It's there in case you need to override
-the automatic detection.
-
-\textbf{\optname{b} -- Binary architectures.} By default, only the
-binaries for your current platform will be installed. From this menu,
-you can select installation of binaries for other architectures as well
-(or omit installing the current platform). This can be useful if you are
-sharing a \TeX\ tree across a network of heterogenous machines. For a
-list of the supported architectures, see table~\ref{tab:archlist},
-\p.\pageref{tab:archlist}.
-
-\textbf{\optname{s} -- Base installation scheme.} From this menu, you
-can choose an overall set of package collections, called a ``scheme''.
-The default \optname{full} scheme installs everything available, but you
-can also choose the \optname{basic} scheme for a minimal system, or
-\optname{medium} to get something in between. There are also specific
-sets for Omega and \acro{XML}.
-
-\textbf{\optname{c} -- Individual collections.} From this menu, you can
-override the scheme's set of collections to install. Collections are
-one level more detailed than schemes\Dash collections consist of one or
-more packages, where packages (the lowest level grouping in \TL) contain
-the actual \TeX\ macro files, font families, and so on. In this menu,
-selection letters are case-sensitive.
-
-\textbf{\optname{l} -- Language collections}. This menu has the same
-basic purpose as \Ucom{c}, to override the collection set in the chosen
-scheme. In this case, the collections are specifically for different
-languages. Selection letters are case-sensitive here too. Here is a
-list of the language collections in \TL:
-
-% xx really should generate list from texmf/tpm/collection/tex-lang*
-% a la install-tl.sh.
-\begin{tabbing}
-\hspace{.25\linewidth} \=
-\hspace{.25\linewidth} \=
-\hspace{.25\linewidth} \=
-\hspace{.25\linewidth} \kill
-(some) African scripts \>
-Arabic \>
-Armenian \>
-Chinese\,Japanese\,Korean \\
-Croatian \>
-Cyrillic \>
-Czech/Slovak \>
-Danish \\
-Dutch \>
-Finnish \>
-French \>
-German \\
-Greek \>
-Hebrew \>
-Hungarian \>
-Indic \\
-Italian \>
-Latin \>
-Manju \>
-Mongolian \\
-Norwegian \>
-Polish \>
-Portuguese \>
-Spanish \\
-Swedish \>
-Tibetan \>
-\acro{UK} English \>
-Vietnamese \\
-\end{tabbing}
-
-\noindent Language collections typically include fonts, macros,
-hyphenation patterns, and other support files. (For instance,
-\pkgname{frenchle.sty} is installed if you select the \optname{French}
-collection.) In addition, installing a language collection will alter
-the \filename{language.dat} configuration file controlling which
-hyphenation patterns are loaded.
-
-\textbf{\optname{d} -- Installation directories}. Three directories can
-be changed here:
-\label{text:instdir}
-
-\begin{ttdescription}
-\item [TEXDIR] The top-level directory under which
-everything else will be installed. The default value is
-\dirname{/usr/local/texlive/2007}, 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
-update after testing the new release.)
-
-Under \MacOSX, the usual frontends look for \TeX{} in
-\dirname{/usr/local/teTeX}, so you may wish to install \TL{} there.
-
-\item [TEXMFLOCAL] This tree is where the \TeX{} system (not as part of
-the initial installation, but rather as time goes by) puts
-non-version-specific files, primarily fonts. The default value is
-\dirname{/usr/local/texlive/texmf-local}, independent of the current
-\TL{} release, because it's also the recommended location to put any
-local packages or configuration settings.
-
-\item [TEXMFSYSVAR] This tree is where \cmdname{texconfig-sys} puts
-files that \emph{are} version-specific. The default value is
-\dirname{TEXDIR/texmf-var}, and there's generally no reason to change
-it. There is also \envname{TEXMFSYSCONFIG}, which is where
-\cmdname{texconfig} looks for modified configuration data. See
-section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig} for more
-information.
-
-\end{ttdescription}
-
-\textbf{\optname{o} -- Other options.} From this menu, you can select
-the following general options:
-
-\begin{ttdescription}
-\item [a] Specify an alternate directory for generated fonts.
-The default is to use the \envname{TEXMFVAR} tree, as explained above.
-Setting this is useful if you plan to mount the main tree read-only, and
-therefore you need another location (perhaps host-specific) for
-dynamically created fonts.
-
-\item [l] Create symbolic links for the binaries, man pages,
-and\slash or \acro{GNU} Info files in other locations. For example, you may
-wish to make the man pages available under \dirname{/usr/local/man} and
-the Info files available under \dirname{/usr/local/info}. (Of course
-you need appropriate privileges to write in the specified directories.)
-
-It is not advisable to overwrite a \TeX\ system that came with your
-system with this option. It's intended primarily for creating the links
-in standard directories that are known to users, such as
-\dirname{/usr/local/bin}, which don't already contain any \TeX\ files.
-
-\item [d] Skip installation of the font/macro documentation tree.
-This is useful if you need to save space, or if you've previously
-installed the documentation elsewhere.
-
-\item [s] Skip installation of the main font/macro source
-tree. This is useful if you are arranging to share that tree between
-machines and\slash or architectures in some other way, such as \acro{NFS}.
-
-\end{ttdescription}
-
-\textbf{i -- Perform installation.} When you're satisfied with your
-configuration options, enter \Ucom{i} to actually do the installation
-from the media to your chosen locations.
-
-% text is similar to above, but no TEXMFSYSVAR, so we have to write out.
-After the installation completes, your next step is to include the
-architecture-specific subdirectory of \dirname{TEXDIR/bin} in your
-\envname{PATH}, so the newly-installed programs can be found. The
-architecture names are listed in table~\ref{tab:archlist},
-\p.\pageref{tab:archlist}, or you can simply list the directory
-\dirname{TEXDIR/bin}.
-
-The syntax for doing this, and the initialization file to use, depends
-on your shell. If you use a Bourne-compatible shell (\cmdname{sh},
-\cmdname{bash}, \cmdname{ksh}, et al.), put the following into your
-\filename{$HOME/.profile} file:
-
-\begin{alltt}
-PATH=/usr/local/texlive/2007/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/2007/bin/\var{archname}:$PATH
-\end{alltt}
-
-\textruntexconfig
-
-Here is a minimal annotated example which accepts the default
-directories and installs binaries for the current system only. Thus,
-only one command is needed, \Ucom{i} for install. The \texttt{>} is the
-shell prompt as usual.
-
-\begin{alltt}
-> \Ucom{sh install-tl.sh}
-\Ucom{i} # perform installation
-> \Ucom{texconfig} ... # see section \ref{sec:texconfig}
-# New PATH element, with Linux as the example:
-> \Ucom{PATH=/usr/local/texlive/2007/bin/i386-linux:$PATH; export PATH}
-\end{alltt}
-
-If your Unix system supports the \cmdname{manpath} command (type \code{man
-manpath} to learn more), you can make the \TL\ manual pages available
-system-wide via the normal \cmdname{man} command by editing the file
-\filename{/etc/manpath.config}; you might need root permissions for this.
-With the following entry in \filename{/etc/manpath.config} the \TL\
-manual pages will be found at their original places within the \TL\ tree
-(adapt the binary path for your system architecture):
-
-\begin{verbatim}
-MANPATH_MAP /usr/local/texlive/2007/bin/i386-linux \
- /usr/local/texlive/2007/texmf/doc/man
-\end{verbatim}
-
-\textifindoubt
-
-
-\subsubsection{Non-interactive installation}
-\label{sec:noninteractive-install}
-
-It is possible to override the default directories with environment
-variables, and then install non-interactively. Example:
-\begin{alltt}
-> \Ucom{TEXLIVE_INSTALL_PREFIX=/opt/texlive}
-> \Ucom{export TEXLIVE_INSTALL_PREFIX}
-> \Ucom{echo i | sh install-tl.sh}
-\end{alltt}
-
-The \envname{TEXLIVE\_INSTALL\_PREFIX} variable overrides the default
-location of \dirname{/usr/local/texlive}, leaving all else
-unchanged---so with the above invocation, the main installation will go
-to \dirname{/opt/texlive/2007}.
-
-In the usual Unix way, the final \Ucom{echo i} can be replaced by any
-sequence of input commands via a here document, so any sequence of
-commands can be scripted.
-
-Here are all the possible overrides:
-
-\begin{ttdescription}
-\item [TEXLIVE\_INSTALL\_PREFIX]
- Override \dirname{/usr/local/texlive}.
-\item [TEXLIVE\_INSTALL\_TEXDIR]
- Override \dirname{\$TEXLIVE_INSTALL_PREFIX}/2007.
-\item [TEXLIVE\_INSTALL\_TEXMFLOCAL]
- Override \dirname{\$TEXLIVE_INSTALL_PREFIX/texmf-var}.
-\item [TEXLIVE\_INSTALL\_TEXMFSYSVAR]
- Override \dirname{\$TEXLIVE_INSTALL_TEXDIR/texmf-var}.
-\item [TEXLIVE\_INSTALL\_TEXMFHOME]
- Override \dirname{\$HOME/texmf}.
-\end{ttdescription}
-
-It would be better to support a standard \acro{GNU}-style
-\filename{configure} with options, instead of these environment
-variables. Volunteers are welcome!
-
-
-%
-\subsection{Installing individual packages to disk}
-
-You can add individual packages or collections from the current
-distribution to an existing non-\TL{} setup, or an earlier
-\TL{} installation.
-
-\startinst
-
-Run the installation script \filename{install-pkg.sh} (not
-\filename{install-tl.sh}, which is intended for complete installations
-only):
-\begin{alltt}
-> \Ucom{sh install-pkg.sh \var{options}}
-\end{alltt}
-
-The first set of options controls what gets read:
-
-\begin{ttdescription}
-\item [-{}-package=\var{pkgname}] The individual package to work on.
-
-\item [-{}-collection=\var{colname}] The individual collection to work on.
-
-\item [-{}-nodoc] Exclude documentation files from the operation.
-
-\item [-{}-nosrc] Exclude source files from the operation.
-
-\item [-{}-cddir=\var{dir}] Source directory to read from; defaults
-to the current directory. If you followed the instructions above, that
-will be the distribution directory, and won't need to be changed.
-
-\item [-{}-listdir=\var{dir}] The so-called `lists' directory within
-\var{cddir} from which to read the package information. The only
-reason to change the default is if you're making changes to \TL{}
-yourself.
-
-\end{ttdescription}
-
-What actually happens is controlled by the following options. If
-neither of these are specified, the default action is to install the
-selected files. The main destination tree is found by expanding
-\envname{\$TEXMFMAIN} with \cmdname{kpsewhich}. You can override it by
-setting either the environment variable \envname{TEXMFMAIN} or
-\envname{TEXMF}.
-
-\begin{ttdescription}
-\item [-{}-listonly] List the files that would be installed, but don't
-actually install anything.
-
-\item [-{}-archive=\var{tarfile}] Instead of installing the files into
-the \TeX{} system, make a \cmdname{tar} archive.
-
-\end{ttdescription}
-
-Additional options:
-
-\begin{ttdescription}
-
-\item [-{}-config] After installation, run \code{texconfig init}.
-
-\item [-{}-nohash] After installation, don't run \cmdname{mktexlsr} to
-rebuild the filename database.
-
-\item [-{}-verbose] Give more information as the script runs.
-
-\end{ttdescription}
-
-Here are some usage examples:
-
-\begin{enumerate}
-
-\item To see the files in the package \pkgname{fancyhdr} without
-installing it:
-
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=fancyhdr --listonly}
-\else> \Ucom{sh install-pkg.sh --package=fancyhdr \bs}
-> \Ucom{--listonly}
-\fi{}
-texmf/doc/latex/fancyhdr/README
-texmf/doc/latex/fancyhdr/fancyhdr.pdf
-...
-\end{alltt}
-
-\item Install the \LaTeX{} package \pkgname{natbib}:
-\begin{alltt}
-> \Ucom{sh install-pkg.sh --package=natbib}
-\end{alltt}
-
-\item Install the \LaTeX{} package \pkgname{alg} without source files or
-documentation:
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=alg --nosrc --nodoc}
-\else> \Ucom{sh install-pkg.sh -{}-package=alg \bs}
-> \Ucom{-{}-nosrc -{}-nodoc}
-\fi\end{alltt}
-
-\item Install all the packages in the collection of additional
-plain \TeX\ macros:
-\begin{alltt}
-> \Ucom{sh install-pkg.sh --collection=tex-plainextra}
-\end{alltt}
-
-\item Write all files in the \pkgname{pstricks} package to a
-\cmdname{tar} file in \path|/tmp|:
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=pstricks --archive=/tmp/pstricks.tar}
-\else
-> \Ucom{sh install-pkg.sh -{}-package=pstricks \bs}
-> \Ucom{-{}-archive=/tmp/pstricks.tar}
-\fi\end{alltt}
-
-\end{enumerate}
-
-\textifindoubt
-
-
-%
-\section{Post-installation}
-\label{sec:postinstall}
-
-After the main installation is done, for any operating system, the
-remaining steps are to configure the system for your local needs, and
-perform some basic tests.
-
-Another sort of post-installation is to acquire packages, fonts, or
-programs that were not included in \TL{}. The basic idea is to
-install such additions in the \envname{TEXMFLOCAL} tree (if you
-installed to disk), or \envname{TEXMFSYSVAR} (if you are running live).
-See the ``Installation directories'' option on \p.\pageref{text:instdir}.
-
-Unfortunately, the details can and do vary widely, and so we do not attempt to
-address them here. Here are some external links to descriptions:
-\begin{itemize*}
-\item
-\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages}
-\item
-\url{http://www.ctan.org/installationadvice}
-\item
-\url{http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst}
-\item
-\url{http://www.ctan.org/tex-archive/info/Type1fonts} for
-installation information for fonts in particular.
-\end{itemize*}
-
-
-\subsection{The \protect\cmdname{texconfig} program}
-\label{sec:texconfig}
-
-At any time after installation, you can and should use the program
-\cmdname{texconfig} to configure the system to fit your local needs. It
-is installed in the architecture-specific subdirectory
-\texttt{TEXDIR/bin/\var{arch}} along with everything else.
-
-If you run it without arguments, it will enter full-screen mode and
-allow you to view and change options interactively.
-
-You can also run it with various command-line options. Here are some of
-the most common (\TL{} is configured for the A4 paper size by default):
-
-\begin{ttdescription}
-
-\item [texconfig paper letter] Set default paper size for
-various programs and drivers (\cmdname{pdftex}, \cmdname{dvips},
-\cmdname{dvipdfm}, \cmdname{xdvi}) to be \acro{US} letter. The other
-allowable size is \optname{a4}, which is the default.
-
-\item [texconfig rehash] Update all the \TeX{} ``filename databases'',
-after adding or removing files.
-
-\item [texconfig faq] Show the \teTeX{} \acro{FAQ}.
-(See also the main \TeX{} \acro{FAQ} in \OnCD{texmf-doc/doc/english/FAQ-en}.)
-
-\item [texconfig help] Output help information for \cmdname{texconfig}.
-
-\end{ttdescription}
-
-Of course, \cmdname{texconfig} can only support changing a few of the
-many options and configuration parameters in a \TeX{} system. The main
-configuration file for the base \Webc{} programs is named
-\filename{texmf.cnf}. You can find its location by running
-\samp{kpsewhich texmf.cnf}; it contains many comments explaining the
-default settings and useful alternatives.
-
-\cmdname{texconfig} alters files in a user-specific directory, as in
-\dirname{$HOME/.texlive2007}. 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/.texliveYYYY}. To alter system
-directories, use \cmdname{updmap-sys} and \cmdname{fmtutil-sys}.
-
-In particular, for multi-user systems, you will probably want to
-pregenerate the standard formats with \texttt{fmtutil-sys --missing}.
-Otherwise, each user will end up with their own formats.
-
-Also, if you have a personally-modified copy of \filename{fmtutil.cnf}
-or \filename{updmap.cfg}, instead of using the ones generated by
-installation, they must be installed in the tree referenced by the
-variable \envname{TEXMFSYSCONFIG}.
-
-The variables specifying the directories altered by these commands are
-listed in section~\ref{sec:texmftrees}, \p.\pageref{sec:texmftrees}.
-You can see the actual directories by running \texttt{texconfig conf},
-and you can change them by editing \filename{texmf.cnf}.
-
-
-\subsection{Testing the installation}
-\label{sec:test-install}
-
-After installing \TL{} as best you can, you naturally want to test
-it out, so you can start creating beautiful documents and\slash or fonts.
-
-This section gives some basic procedures for testing that the new system
-is functional. We give Unix commands; under \MacOSX{} and Windows,
-you're more likely to run the tests through a graphical interface, but
-the principles are the same.
-
-\begin{enumerate}
-
-\item Make sure that you can run the \cmdname{tex} program in the first
-place:
-
-\begin{alltt}
-> \Ucom{tex -{}-version}
-TeX 3.141592 (Web2C 7.5.5)
-kpathsea version 3.5.5
-...
-\end{alltt}
-If this comes back with `command not found' instead of version and
-copyright information, most likely you don't have the correct
-\dirname{bin} subdirectory in your \envname{PATH}. See
-the environment-setting information on \p.\pageref{text:path}.
-
-\item Process a basic \LaTeX{} file:
-\begin{alltt}
-> \Ucom{latex sample2e.tex}
-This is pdfeTeXk, Version 3.141592...
-...
-Output written on sample2e.dvi (3 pages, 7496 bytes).
-Transcript written on sample2e.log.
-\end{alltt}
-If this fails to find \filename{sample2e.tex} or other files, perhaps
-you have interference from old environment variables or configuration
-files. For a deep analysis, you can always ask \TeX{} to report on
-exactly what it is searching for, and finding; see ``Debugging actions''
-on page~\pageref{Debugging}.
-
-\item Preview the result online:
-\begin{alltt}
-> \Ucom{xdvi sample2e.dvi}
-\end{alltt}
-(Under Windows, the analogous command is \cmdname{dviout}.) You should
-see a new window with a nice document explaining some of the basics of
-\LaTeX{}. (Well worth reading, by the way if you're new to the system.)
-You do have to be running under X for \cmdname{xdvi} to work; if you're
-not, or your \envname{DISPLAY} environment variable is set incorrectly,
-you'll get an error \samp{Can't open display}.
-
-\item Create a \PS{} file for printing or display:
-\begin{alltt}
-> \Ucom{dvips sample2e.dvi -o sample2e.ps}
-\end{alltt}
-
-\item Create a \acro{PDF} file instead of \dvi{}; this processes the
-\filename{.tex} file and writes \acro{PDF} directly:
-\begin{alltt}
-> \Ucom{pdflatex sample2e.tex}
-\end{alltt}
-
-\item Preview the \acro{PDF} file:
-\begin{alltt}
-> \Ucom{gv sample2e.pdf}
-\textrm{or:}
-> \Ucom{xpdf sample2e.pdf}
-\end{alltt}
-Unfortunately neither \cmdname{gv} nor \cmdname{xpdf} are currently
-included in \TL{}, so you must install them separately. See
-\url{http://www.gnu.org/software/gv} and
-\url{http://www.foolabs.com/xpdf}, respectively.
-
-\item Other standard test files you may find useful:
-
-\begin{ttdescription}
-\item [small2e.tex] A simpler document than \filename{sample2e}, to
-reduce the input size if you're having troubles.
-\item [testpage.tex] Test if your printer introduces any offsets.
-\item [nfssfont.tex] For printing font tables and tests.
-\item [testfont.tex] Also for font tables, but using plain \TeX{}.
-\item [story.tex] The most canonical (plain) \TeX{} test file of all.
-You must type \samp{\bs bye} to the \code{*} prompt after \samp{tex
-story.tex}.
-\end{ttdescription}
-You can process these in the same way as we did with
-\filename{sample2e.tex}.
-
-\end{enumerate}
-
-If you are new to \TeX{}, or otherwise need help with actually
-constructing \TeX{} or \LaTeX{} documents, please visit
-\url{http://tug.org/begin.html} for some introductory resources.
-
-
-\section{\MacOSX{} installation}
-\label{sec:mac-install}
-
-The recommended way to install \TeX\ on \MacOSX\ is from the Mac\TeX\
-distribution, new in 2005. This is provided on the \pkgname{live}
-\DVD{} in the top-level \dirname{mactex/} directory. It contains its
-own (native) installer for a full \TeX\ distribution, based on a
-combination of te\TeX\ and \TL, along with many additional applications
-and documentation. The project web page is \url{http://tug.org/mactex}.
-
-If you prefer, installation of \TeX{} under \MacOSX{} can also be done
-directly from \TL, using the \filename{install*} scripts, as follows.
-
-In order to run the installation scripts under \MacOSX, you need to have
-the \cmdname{bash} shell installed. If you are running \MacOSX~10.2
-or later, you have \cmdname{bash}, and can proceed. If you're running
-an earlier \MacOSX{} version, however, the default shell is
-\cmdname{zsh}, which won't work; you'll need to get \cmdname{bash} from
-the Internet, or more likely upgrade your system.
-
-Once you have \cmdname{bash}, the Unix installation documentation in the
-previous section can be followed. See section~\ref{sec:unix-install} on
-\p.\pageref{sec:unix-install}; \MacOSX-specific notes are included there
-where needed.
-
-\section{Windows installation}
-\label{sec:win-install}
-
-In this release of \TL{}, happily, the distribution once
-again has a native Windows installer, named \cmdname{tlpmgui.exe}. (See
-section~\ref{sec:multiple-dist}, \p.\pageref{sec:multiple-dist}, for an
-explanation of the different distributions.)
-
-\cmdname{tlpmgui} has essentially the same options as the Unix
-installer, only done through a GUI interface: selecting schemes,
-individual collections, installation directories, and so on.
-Section~\ref{sec:unix-install-disk} on
-\p.\pageref{sec:unix-install-disk} describes the basic elements. It
-also allows some post-installation activities such as adding/removing
-packages, updating the filename database and building formats.
-Moreover, \cmdname{tlpmgui} can setup the system for running
-programs directly from the \DVD.
-
-For those who like to look underneath the hood, \cmdname{tlpmgui} uses
-as its ``engine'' a command-line Windows program named \cmdname{tlpm}.
-
-The Windows \TeX{} system included in \TL{} is based on new binaries
-borrowed from the \acro{W32TEX} distribution, kindly provided by Akira Kakuto.
-It also includes some older (but still working) tools made by Fabrice
-Popineau, and also a new \texttt{dvi} previewer, \textsf{dviout} by
-Toshio Oshima.
-
-\TL{} can be installed on systems running Windows 98, \acro{ME},
-\acro{NT}, \acro{2K} or \acro{XP}. Older versions of Windows (3.1x)
-and \acro{MS-DOS} are not supported.
-
-\textbf{Warning:} Win9.x users must ensure they have enough environment
- space before undertaking installation. The \cmdname{tlpmgui.exe}
- program won't change the environment size for them. A few environment
- variables will be created and it is possible you run out of
- environment space. Add \texttt{SHELL=<path>COMMAND.COM /E:4096 /P} in the
- config.sys file in order to increase your environment size.
-
-\subsection{Installing \protect\TeX\protect\ Live to disk}
-
-After inserting the \TL{} \acro{CD} into the \acro{CD} drive, autostart should
-activate \cmdname{tlpmgui}. If it does not, click \guiseq{Start\arw Run},
-then type \verb|<drive letter>:\setuptl\tplmgui.exe| (or
-\verb|<drive letter>:\texlive\setuptl\tplmgui.exe| if you are
-installing from the \TeX\ Collection \acro{DVD}), where \verb|<drive letter>|
-is the drive letter with the \TeX\ Live \acro{CD} (or TeX Collection
-\acro{DVD}), and then click \acro{OK}.
-
-The installation window titled \guiseq{TeX Live installation and maintenance
-utility} should open. It contains the following sections: \guiseq{Main
-customization}, \guiseq{Install}, \guiseq{Select a scheme}, \guiseq{Select
-systems}, \guiseq{Directories} and \guiseq{Options}.
-
-By default, \cmdname{tlpmgui} tries to detect if \TeX{} is already
-installed and depending on the result starts either in fresh
-installation or maintenance mode. If you have \TeX{} already installed
-but want to install the new version nevertheless, you can use
-\texttt{tlpmgui~--install-mode} to force installation mode; but you
-should know what you are doing, as the new \TL{} installation will
-override the environment variables and other settings of the existing
-installation; reverting to your old installation is not automatically
-supported.
-
-Diagnostic information is collected by \cmdname{tlpmgui} in a log file
-which is deleted at the end of the run, along with any other temporary
-files. Invoking with \texttt{--debug} displays the names and contents
-of all \cmdname{tlpmgui} temporary files in a separate window.
-
-In the \guiseq{Directories} section the installation drive (directory)
-next to the \guiseq{CD/DVD} button should be displayed (e.g.,
-\texttt{F:/} or \texttt{F:/texlive/} for the \acro{DVD}), but if it is not,
-then click the \guiseq{CD/DVD} button and select the \acro{CD/DVD}
-drive, with the \TL{} \acro{CD} (or \TeX\ Collection \acro{DVD}).
-
-The directory in which you wish to install the software can be set by
-clicking the \guiseq{TLroot} button. This directory will be set as
-\path|TLroot| environment variable for later usage.
-
-In the \guiseq{Select a scheme} section the desired \TL{} installation scheme
-should be chosen by clicking the radio button labelled with the installation
-scheme name (e.g., \guiseq{scheme-gust}). Each scheme is accompanied by an
-\guiseq{Info} button which, when clicked, displays a short description of the
-relevant scheme.
-
-A scheme is a large set of files targeted at some kind of usage. There are
-generic schemes for basic, medium and full installations. The remaining ones
-are either targeted at certain LUGs (i.e., what GUST or GUTenberg propose
-for their members) or application targeted (e.g., for XML and \TeX{}
-cooperation). A preselected scheme can be refined. This is done in the
-\guiseq{Main customization} section by choosing additional collections from
-\guiseq{Standard collections} or \guiseq{Language collections}. For example,
-by clicking the \guiseq{Select} button labelled \guiseq{Standard
-collections}, additional collections like Metapost, Omega or documentation
-in different languages can be selected.
-
-\guiseq{Wintools} collection is selected by default as it contains many small
-programs, usually absent in Windows, which can be handy, like graphics
-converters: \cmdname{sam2p}, \cmdname{jpeg2ps}, \cmdname{tiff2png};
-(de)compression programs: \cmdname{bzip2}, \cmdname{gzip}, \cmdname{unzip},
-and \cmdname{wget} which is needed for \cmdname{getnonfreefonts} (new)
-utility.
-
-Next, clicking the \guiseq{Select} button labelled \guiseq{Language
-Collections} in the \guiseq{Main customization} section opens the
-\guiseq{Language collections} window in which the installation language can
-be chosen by ticking the box next to the language.
-
-Next, click the \guiseq{Install} button in the \guiseq{Install} section to
-start the installation proper process.
-
-\textbf{Note:} The \guiseq{Perl} and \guiseq{Ghostscript} are installed only
-on demand. They should be installed unless they are already installed and you
-really know what you are doing. Both programs are required by many important
-tools. The \verb|PERL5LIB| and \verb|GS_LIB| environment variables will be
-set too, as well the path to Ghostscript binaries will be added to the
-\verb|PATH| variable.
-
-The \TL{} system needs some post-processing steps (format files
-generation, ls-R databases generation, environment variables, etc.). All
-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} (and also \cmdname{dviout}, if installed)
-will be added to the menu \guiseq{Start\arw Programs\arw TeXLive2007}.
-
-If it is needed (Win9x/WinME), you will be asked to reboot your computer.
-
-\subsection{Support packages for Windows}
-\label{sec:win-xemtex}
-
-To be complete, a \TL installation needs support packages that are not
-commonly found on a Windows machine. Many scripts are written using the Perl
-language. Some important tools require the Ghostscript \PS{} interpreter to
-render or to convert files. A graphic file toolbox is also needed in some
-cases. Last but not least, a \TeX-oriented editor makes it easy to type in
-your \TeX{} files.
-
-All these tools are quite easy to find for Windows, but in order to try to
-make your life even easier, we have put such a set of tools on \TL:
-\begin{itemize*}
-\item GNU \cmdname{Ghostscript} 8.54
-\item a minimal \cmdname{Perl} 5.8, sufficient to run all the \TL{}
- Perl scripts.
-\item win-tools is a set of small programs (bzip2, gzip, jpeg2ps
- and tiff2png)
-%\item a subset of \cmdname{ImageMagick} 5.5.6
-%\item the \cmdname{ISpell} checker
-%\item \cmdname{XEmacs} 21.5.14 with a selection of packages to support
-%\TeX{} typesetting.
-\end{itemize*}
-
-Perl and Ghostscript are installed upon request; you may explicitly
-deselect them during installation if you already have them.
-
-If you don't want to install this bundle, then you are on your own to
-install the required tools to complete your \TL{} system. Here is a
-list of places to get those tools:
-
-\begin{description}
-\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/}
-\item[Perl] \url{http://www.activestate.com/} (but you might need some
- supplementary packages from CPAN: \url{http://www.cpan.org/})
-\item[ImageMagick] \url{http://www.imagemagick.com}
-\item[NetPBM] alternatively, you could use NetPBM instead of ImageMagick to
- process or convert your graphic files. NetPBM home page is
- \url{http://netpbm.sourceforge.net/}
-\item[\TeX-oriented editors] There is a wide choice, and it is a matter of the
- 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 AucTeX is available natively under Windows, see
- \url{ftp://alpha.gnu.org/gnu/auctex}
- \item \cmdname{WinShell} is available on \TL in the \path|support|
- directory, see \url{http://www.winshell.de}
- \item \cmdname{WinEdt} is shareware available from \url{http://www.winedt.com}
- \item \cmdname{Vim} is available from \url{http://www.vim.org}
- \item TeXnicCenter is free software, available from
- \url{http://www.toolscenter.org} and in the proTeXt 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}
- \end{itemize*}
-\end{description}
-
-You might want to install other tools that are not free\footnote{Not
-free, that is, in the sense of freedom to modify and redistribute,
-following free software guidelines. This does not mean you can't acquire
-them for no money.} and therefore not included on \TL{}, such as
-\cmdname{GSView}, the \cmdname{Ghostscript} companion to more
-conveniently view PS/PDF files. \cmdname{GSView} is available from
-\url{http://www.cs.wisc.edu/~ghost/gsview/} or any \acro{CTAN} site.
-
-\section{Maintenance of the installation in Windows}
-
-If you have \TeX\ Live installed, you can use \cmdname{tlpmgui} again
-for modifying and maintaining your installation.
-
-\subsection{Adding/removing packages}
-
-As the \cmdname{tlpmgui} shortcut is available in the \guiseq{Start\arw
-Programs\arw TeXLive2007} 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}.
-
-Click the tab labelled \guiseq{Add packages} or \guiseq{Remove packages}
-to enter the relevant functionality and then:
-
-\begin{itemize}
-\item In the first tab select the proper \CD{} drive (or \DVD with
- \texttt{texlive} directory) by pressing the \guiseq{CD/DVD} button.
-\item Click the \guiseq{Search} button in the \guiseq{Buttons} section to
-display or refresh in the \guiseq{Select packages to\dots} section the
-list of packages to install or remove.
-
-When adding packages, the list of installed packages is compared to the list
-of packages available from your \CD/\DVD. Only packages not already installed are
-displayed. It is up to you to select which packages you want to
-install.
-
-When removing individual packages, only a list of installed packages
-will be displayed.
-
-Please note that for both \guiseq{Add packages} and \guiseq{Remove packages}
-the collections are listed first.
-
-\item Select a package by clicking on the name of the package. Clicking the
-\guiseq{Info} button in the \guiseq{Buttons} section displays a short
-description of the selected package in the window located in the \guiseq{Info
-about the selected item} section. To select several packages at once hold
-down one of the Ctrl or Shift keys at your keyboard while holding down the
-left mouse button or drag the mouse pointer while holding down the left mouse
-button.
-
-\item Click the \guiseq{Install} or \guiseq{Remove} button in the
-\guiseq{Buttons} section to perform the appropriate action.
-\end{itemize}
-
-\subsection{Configuring and other management tasks}
-
-The functions available in the tab labelled \guiseq{Manage the installation}
-are helpful in performing actions needed when you want to add support for a
-language which was not selected during the installation, or add/regenerate a
-format which was not selected during the installation or was modified after
-the installation.
-
-The following actions can be performed:
-
-\begin{itemize}
-\item Refresh the \filename{ls-R} database
-\item Create formats (All or Missing)
-\item Edit \filename{language.dat}
-\item Edit \filename{fmtutil.cnf}
-\item Edit \filename{updmap.cfg}
-\end{itemize}
-
-Note: you can close the Edit\dots{} window with the \guiseq{Cancel} or
-\guiseq{Done} button; the latter will start rebuilding the format files
-(or the fontmap files if you have edited \filename{updmap.cfg}), followed by a
-\filename{ls-R} database files refresh.
-
-For more information about the configuration see section~\ref{sec:persconf},
-\p.\pageref{sec:persconf}.
-
-\subsection{Uninstalling \protect\TL{}}
-
-The tab labelled \guiseq{Remove the TeX Live installation} opens a window
-which contains functionality not worth describing and we do not know who would
-need it and what it is for\dots :-)
-
-Anyway, if you have the \path|texmf-local| directory for your local additions,
-the removal procedure will not wipe it out or delete things in it. However,
-it will be done only if you select it explicitly. The \path|setuptl|
-directory containing \cmdname{tlpmgui} and related files will not be deleted.
-You will have to do some manual cleanup to actually remove them.
-
-\subsection{Adding your own packages to the installation}
-
-First, whatever changes you make, \textbf{do not forget to rebuild the ls-R
-database files}. Otherwise, your new files will not be found. You can do this
-either via the \cmdname{tlpmgui} run and selection of the appropriate action
-from the \guiseq{Manage the installation} tab, or manually running the
-\file{mktexlsr} command.
-
-If you want to add files that are not provided by the \TL{} distribution,
-it is recommended to put them in the \path|$TEXMFLOCAL| directory. This
-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:\TeXLive2007\texmf-local\tex\latex\maple\|\\ and the
-documentation files in:\\ \path|c:\TeXLive2007\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}
-has a number of other useful options. You can get the list by running:
-\begin{verbatim}
-tlpm --help
-\end{verbatim}
-
-More information and examples of use can be found in \path|tlpm.readme|.
-
-\subsection{Network installation}
-
-\KPS{} knows about UNC names, so you can use them to get your TEXMF
-tree from the network. But there is better than this.
-All the support files and configuration files, everything except the files in the
-\path|bin/win32| are shareable with a \teTeX{} or Unix \TL{} installation. That means
-you can use Samba either to mount from an NT server to a Unix
-workstation or the converse. Several strategies are possible:
-\begin{itemize}
-\item Put everything on the server. Just add each set of files for the OS and
-architecture you want to use in the \path|bin| directory. That means
-for example \path|bin/win32| and \path|bin/i386-linux|. Next configure
-your main variables. You can use UNC names to
-point to the right directories under Win32.
-\item Install a local copy for the binaries and format files. In this
- case, assign \path|$TEXMFMAIN| to the main \path|texmf| tree that
- will be accessed remotely. Set \path|$TEXMFVAR| to be a local
- directory which will hold local configuration files and on-the-fly
- generated files.
-\end{itemize}
-
-\subsection{What's different in Windows?}
-
-The Windows version of \Webc{} has some specific features that should be
-pointed out.
-
-\begin{description}
-\item[\cmdname{kpsecheck}] This command provides some options that did
- not fit well into \cmdname{kpsewhich}. It will allow you to list all
- the files that occur multiple times across your texmf trees. This
- could be handy, but most of the time you will also get unwanted
- output (like dozens of \path|README| files). It is noticeable
- that all these files result in clashes inside the \KPS{}-hashing
- mechanism; fortunately, \KPS{} never looks for these files. For
- this reason, you can combine the \path|-multiple-occurrences| with 2
- other options for including or excluding any filename that match
- some pattern (you can request for several patterns).
-
- The \cmdname{kpsecheck} command will also report the status of shared
- memory: in use or not used. That might be useful to know because if
- the status reported is \samp{in use}, that means one or several
- processes are working, and the effect of any \cmdname{mktexlsr}
- command will be delayed until the next time where no \KPS{} linked
- process will be running.
-
- Last, this same command will report about the location it thinks
- Ghostscript can be found. Under Win32, for many programs, it is
- easier to use the Ghostscript dll, and find it by using the
- Ghostscript registry key than to change the \path|PATH|, which has a
- limited length anyway.
-\item[\Webc{}] The engines have one more option than in Unix \Webc:
- \begin{itemize}
- \item \path|-proctimes| print statistics about the job run
- time. It is to be noted that Win9x not being a true multitasking
- operating system, it has no reliable timer for short periods, so
- the value printed is an approximation. Under NT/2K/XP, the result
- is quite accurate with user time and system time values allocated
- for this run. For Unix
- users: the \path|time| command is not usually available to Windows
- users.
- \end{itemize}
-\end{description}
-
-\subsection{Personal configurations}
-\label{sec:persconf}
-
-\subsubsection{Dvips}
-
-The configuration file for dvips can be found in\\
-\verb+C:\TeXLive2007\texmf-var\dvips\config\config.ps+\\
-You may open it with any editor
- %(\cmdname{WinShell} will do fine)
- and change some parameters:
-
-\begin{description}
-\item [fonts] you can change the default printer \MF{} mode or printer
- resolution in case \cmdname{dvips} needs to generate PK fonts. By default it
- is configured to use Type~1 versions of the CM fonts, so it should
- not call \cmdname{mktexpk} too often;
-\item[printer] you can tell dvips where you want to print by default. If
- the \optname{o} option is not followed by a printer name, then a
- \file{.ps} \PS{} file is written. You can give dvips a printer
- name such as:
-\begin{verbatim}
-o lpt1:
-% o | lpr -S server -P myprinter
-% o \\server\myprinter
-\end{verbatim}
-\item[paper] Next, you might want
- to change the paper size from European (A4) to US letter
- by making the US letter the first paper size mentioned in the file.
- Scroll to the group of lines beginning with \code{@}. Move
- the appropriate lines so that this section begins with the lines:\\
-\hspace*{1em} @ letterSize 8.5in 11in\\
-\hspace*{1em} @ letter 8.5in 11in\\
-\hspace*{1em} @+ \%\%BeginPaperSize: Letter\\
-\hspace*{1em} @+ letter\\
-\hspace*{1em} @+ \%\%EndPaperSize
-\end{description}
-
-The current \TL{} distribution implements the procedure of making always
-up-to-date fontmaps files for Dvips and Pdftex. This is done by the
-\cmdname{updmap} program during installation.
-If you add new font packages using the installation program or by hand,
-edit the file \verb+updmap.cfg+ in \path|$TEXMFVAR/web2c|.
-
-\subsubsection{PdfTeX}
-
-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:\TeXLive2007\texmf-var\tex\generic\config\pdftexconfig.tex+ and
-change \samp{\bs pdfpagewidth} and \samp{\bs pdfpageheight}. These entries
-should read:
-\begin{alltt}
-\bs{}pdfpagewidth=8.5 true in
-\bs{}pdfpageheight=11 true in
-\end{alltt}
-Save the file and exit the editor.
-
-\subsubsection{Xe\TeX}
-Xe\TeX{} for Windows is linked statically with fontconfig 2.4.2.
-A configuration file for fontconfig is \verb+fonts.conf+. For details,
-see the file \verb+fonts.conf+ itself which is in a directory shown by
-the command \texttt{kpsewhich --var-value=FONTCONFIG\_PATH}.
-
-\subsubsection{GSView}
-GSView is now distributed under the Aladdin License, and therefore is no
-longer included in \TL{}.
-
-You may want to change the page size to US letter size. If so, open
-GSView from the \guiseq{Start} menu, and select \guiseq{Media\arw Letter}.
-
-Also, there are menu settings that are supposed to give you the most
-readable screen image. On \guiseq{Media \arw Display Settings}, set both
-\optname{Text Alpha} and \optname{Graphics Alpha} to 4~bits.
-
-Note that the installation process has set all \code{.ps} and
-\code{.eps} files to automatically open with \cmdname{GSView}.
-
-For printing instructions, see section~\ref{printing} below.
-
-
-\subsection{Testing}
-
-For generic verification procedures, see section~\ref{sec:test-install}
-(\p.\pageref{sec:test-install}). This section describes
-Windows-specific tests.
-
-Open the file \verb+sample2e.tex+ in your editor (Xemacs, WinShell),
-found in \path|C:\TeXLive2007\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}
-menu (XEmacs) or Preview (dviout) icon (WinShell).
-
-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.
-
-\textbf{Hint for the future:} If a \LaTeX\ run stops because \LaTeX\
-cannot find a file, you can press Ctrl-z to quit.
-
-
-\subsection{Printing}
-\label{printing}
-
-It is possible to print from \cmdname{dviout}. In this case, printing
-will be done using the Windows unified printer driver. By definition, it is
-compatible with all printers. However, there is some drawback: it can
-generate some huge spool files, and some (older) versions of Windows
-just don't like them. The advantage is that you can use features like
-embedding BMP or WMF images. You also need to make sure that the printer
-parameters are correctly set, else you
-will get scaled printing (printing at 600\dpi{} on a 300\dpi{} printer
-will give you only one quadrant of your page).
-
-Printing is faster and more reliable if you run \cmdname{dvips} to make
-a \filename{.ps} file and then print from \cmdname{GSView}. In
-\cmdname{GSview}, select \guiseq{File\arw Print\ldots}. A \guiseq{Print}
-window will appear.
-
-If you are using a \PS{} printer, \textit{be sure to select
-\guiseq{\PS{} Printer}}. This is done in the \guiseq{Print Method} box
-at the bottom left of the \guiseq{Print} window. You can then select any
-of the printers that you have previously installed. If you fail to
-check the box for \optname{\PS{} Printer}, printing will not work.
-
-If you will be using your own non-\PS{} printer, select
-\guiseq{Ghostscript device} in the \guiseq{Print Method} box, then click
-on the button to the right labelled \guiseq{djet500} and select your
-printer type from the list that pops up. (In the older version of
-\cmdname{GSView}, make sure \optname{\PS{} Printer} is \textit{not}
-selected, then select your printer type from the \guiseq{Device} list.)
-
-\subsection{Tips and tricks for Win32}
-
-\subsubsection{Different flavors of Win32}
-
-What we call Win32 is not an operating system by itself. It is a large
-set of functions (around 12,000 in the header files of the Microsoft
-\acro{SDK}) that you can use to write programs for different operating
-systems of the Windows family.
-
-Windows comes in different flavors:
-\begin{itemize}
-\item Win95, Win98 and Win\acro{ME}, which \emph{are not true multitasking,
- multithreading} environments, but rather updated incarnations of
- \acro{DOS}. This can be more or less proven by the fact that when
- booting, the PC will load the \path|command.com| interpreter, and if
- you stop the boot process at this point, you can ask for the current
- (\acro{DOS}) version and it will answer something like \samp{MS-DOS
- 7.0} (at least for the old versions of Win9x).
-\item Windows \acro{NT}, which is a new operating system written from
- scratch, capable of true multitasking behavior, and including many
- high level features.
-\item Windows 2000, based on \acro{NT}, with all the bells and
- whistles of Win98.
-\item Windows \acro{XP}, which comes with Personal and Pro flavors. This is
- the last step in merging both lines of products (Win9x based and
- \acro{NT} based). \acro{XP} is based on \acro{NT}.
-\end{itemize}
-
-Win9x are able to run 32~bits programs and 16~bits programs
-concurrently. But the operating system by itself is not entirely
-written in 32~bits mode, and does not support memory protection: 16bits
-applications can overwrite parts of the operating system memory! Some
-parts of the system like the \acro{GDI} (Graphical Device Interface)
-manage limited resources like bitmaps, fonts, pens and so on for the set
-of all programs that run concurrently. All the bitmaps headers available
-at the same time can't amount for more than 64kB. This explains the
-performance tool and the fact that you can put your system on his knees
-by making intensive use of graphic objects for example.
-
-NT, 2K and XP do not suffer from these limitations, and neither from
-other Win9x limitations. They are true multitasking environments, with
-protected memory. They are much more responsive than Win9x because
-of better memory management, better file system and so on.
-
-\subsubsection{Command line prompt}
-
-You may wonder, ``Why would I need to use a command line prompt when
-I have Windows?''
-
-Good question! The problem is of very general nature. Not all operations
-can be done easily using only a \acro{GUI}. Command line gives you
-programming power\Dash assuming a clever command interpreter.
-
-But the problem here is more fundamental: \TeX{} is \emph{a batch}
-tool. Not an interactive one. \TeX{} needs to compute the best
-layout for each page, resolve cross-references and so on. This can be
-done only by a global processing of the document. It is not (yet) a
-task that can be done interactively.
-
-This means that you should use \TeX{} from a command line. In fact the
-situation is not so bad. There is an advantage to write command line
-tools for complex processing: they are better debugged, because they are
-independent of any \acro{GUI} problems, and \acro{GUI} tools can be
-designed to interface to the command line tools. This is the case for
-\TeX{}, where you will mostly interact with it through a \acro{GUI} text
-editor.
-
-However, you may need to use the command line prompt in a number of
-situations. One is when you are having difficulties and want to debug
-your setup.
-
-\begin{description}
- \item[Win9x] You can open a command line prompt by looking either for
- the \acro{MS-DOS} icon in the \guiseq{Start\arw Programs} menu,
- or by choosing \guiseq{Start\arw Run} menu typing in
- \path|command.com| as the program name.
- \item[NT, 2K, XP] You can open a command line prompt by looking for
- \guiseq{Command Prompt} in the \guiseq{Start\arw Accessories} menu.
- You can also choose \guiseq{Start\arw Run} and type in
- \path|cmd.exe|, which is the name of the brand new command
- interpreter for \acro{NT} (thus, it is untrue to call this a
- \emph{DOS} box!).
-\end{description}
-
-These locations may change across different Windows versions.
-
-\subsubsection{Path separators}
-
-The Win32 API understands both \path|/| and \path|\| characters as PATH
-separators. But the command interpreters do not! So whenever a path name
-is used programmatically, you can use both separators, and even mix them
-up in the same path name. But on the command line, you must type
-\path|\| as path separator. The reason is compatibility: the command
-processor used \samp{/} to introduce arguments to commands.
-
-All this to say: do not be surprised to read path names written using
-the Unix convention; Windows-\TL{} is a port of \Webc, and aims to be
-compatible across platforms. For this reason, all the configuration files
-that need to specify path names use the Unix convention.
-
-\subsubsection{File systems}
-\label{sec:clusters}
-
-The worst feature of Win9x with regard to \TeX{} is probably the
-so-called FAT file system. \TeX{} uses very many small files, with size
-around 1--3kB. The \acro{FAT} file system is old, and predates by
-decades the multi-gigabytes hard disks we have today. As a result, it
-cannot manage efficiently the tens of thousands of \TeX{} files found in
-\TL{}. The \acro{FAT} file system allocates a minimum of 32kB for
-\emph{any} file on a huge partition. It means that \TeX{} will use much
-more disk space than it actually needs.
-
-The other, more modern, file systems available, \acro{FAT32} and
-\acro{NTFS}, do not have this drawback. They manage clusters of 4kB
-only. (You can lower the limit to 512 bytes on \acro{NTFS}.)
-
-\subsubsection{How to add some directory to your PATH}
-
-There are pairs of variables and values which behave much like global
-variables inside your programs. The set of those variables is called the
-environment. Each program is initialized with a copy of the
-environment when it is run. It can request and change the
-value of any variable. The changes happen in the copy of the
-environment, and is not at all propagated to the other running
-programs.
-
-Your PATH is a special environment variable used to search for
-programs you want to run.
-There is a different procedure to change it for Win9x, WinME and NT/2K/XP:
-
-\begin{description}
-\item[Windows 95/98] Edit your \path|autoexec.bat|. In this file should be a line
- starting with \texttt{PATH=} and followed by a list of directories separated
- 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:\TeXLive2007\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
- environment variable. From this program, select the `Environment'
- tab, and then add or modify the variable you want. You will be asked to reboot the
- machine upon any change.
-\item[Windows NT/2K/XP]
- Click left on \guiseq{Start \arw Settings \arw Control Panel}. Now the
- window with the control panel icons opens. Double click on System. The
- System Properties window opens. Click on the tab \textsf{Environment}
- or look for a button named \guiseq{Environment Variables} among the
- dialog boxes. Now you can change the environment variables for your
- user account. Note: There are also displayed the environment settings
- for the system. Normally, you can't change the system variables
- unless you have administrator rights on your machine. If you want to
- change the \texttt{PATH} for all users, you will have to contact your
- system administrator or be the system administrator yourself\Dash in
- the latter case you should know what you are doing.
-
- If there is already a \texttt{PATH} setting for your user account,
- left click on \texttt{PATH}. In the field \textsf{Variable} appears
- \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:\TeXLive2007\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
- the \textsf{Apply} button before clicking \textsf{Ok}, otherwise the
- changes to \texttt{PATH} won't apply to your system. Be careful when
- changing the environment settings.
-\end{description}
-
-The best way to be sure that a variable has been properly set is to
-open a console and type:
-\begin{verbatim}
-set VARIABLE
-\end{verbatim}
-which should return the corresponding value.
-
-\subsubsection{\TeX{} engines}
-
-If you have a look at the \Webc{} documentation, you will read that all
-the various \TeX{} derived programs use the same base engine. For
-example, \path|tex.exe| and \path|latex.exe| are exact copies of the
-same program, but each one will use a different format file, based on
-its calling name.
-
-Under Unix, this feature is implemented through \emph{symbolic
-links}. It saves up a bit of disk space, because some engines are
-used with many different format files.
-
-The Win32 API does not know about file links. So to save up almost
-the same amount of memory, all the \TeX{} base engines have been put
-in DLLs (\emph{Dynamic Linked Library}). This means that you will have
-the following layout:
-\begin{alltt}
-2006-11-23 07:06 2 560 latex.exe
-2007-01-06 23:54 1 073 664 pdftex.dll
-2006-01-28 08:05 2 560 pdftex.exe
-\end{alltt}
-and the \path|latex.exe| file is nothing but a rough copy of
-\path|pdftex.exe| using the same core \path|pdftex.dll|.
-The same trick has been used for the \path|mktex*.exe| family of programs
-which are linked to the \path|mktex.dll| library.
-
-In fact, a generic tool called \path|irun.exe| is provided to build the
-equivalent of Unix hard links for executable files only under Win32.
-
-\subsection{In case of problems}
-\label{sec:troubleshooting}
-
-\subsubsection{What to do if \texttt{latex} does not find your files?}
-
-\begin{itemize}
-
-\item \cmdname{kpsewhich} is the tool of choice to debug any
-problem. However, \cmdname{kpsewhich} outputs debug information to
-stderr, and the older Windows consoles do not know how to redirect
-stderr to a file. (Windows NT and later do support redirections, but
-the trick below will work for any console.) For diagnostic purposes you
-can temporarily set an environment variable (in a \acro{DOS}/\acro{cmd} box):
-
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=err.log
-\end{verbatim}
-You can also set the debug level:
-\begin{verbatim}
-SET KPATHSEA_DEBUG=-1
-\end{verbatim}
-
-Similarly, to redirect stderr to stdout:
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=con:
-\end{verbatim}
-This way you can capture both stdout and stderr in the same file.
-\item Assuming the installation has been done in \path|c:/TeX|, check
- the following values: \\
- {\small
- \begin{tabular}{ll}
- \path|kpsewhich -expand-path $SELFAUTOPARENT| & \path|c:/TeX| \\
- \path|kpsewhich -expand-path $TEXMF| & \path|c:/TeX/texmf....| \\
- \path|kpsewhich -expand-path $TEXMFCNF| &
- \path|.;c:/TeX/texmf-var/web2c;| \\
- \path|kpsewhich -expand-var $TEXINPUTS| & \path|.;c:/TeX/texmf/tex//|
- \end{tabular}
-}
-\item If you have other \TeX{}-related values already set in your
- environment, please, remove them. They are overriding the ones in
- texmf.cnf.
-\item Check the values from:\\
-{\small
- \begin{tabular}{ll}
- \texttt{kpsewhich cmr10.tfm} & \path|c:/TeX/texmf-dist/fonts/tfm/public/cm/cmr10.tfm|\\
- \texttt{kpsewhich latex.fmt}& \path|c:/TeX/texmf-var/web2c/latex.fmt|
- \end{tabular}
-}
-\item At this point, if everything is correct, \TeX{} and friends
- should work. If it is not the case, you will need to play with
- the \path|-debug=n| option from \path|kpsewhich|, and check back all
- the values. Try to identify and report the problem.
-\end{itemize}
-
-\subsubsection{What to do if your setup still does not work as expected?}
-
-Here are several questions to investigate:
-
-\begin{enumerate}
-\item Is \file{tex.exe} in my \path|PATH|?
-
-\item Is the \path|TEXMFCNF| variable correctly set to
-\path|c:/TeXLive2007/texmf-var/web2c| (default value)?
-
-\item Are there any errors in the log file generated by the
-\file{tlmpgui.exe} program?
-\file{tlmpgui.log} can be found in your
-\file{TEMP} directory. You can find this by searching for the
-string \samp{Error}. Hint: the log file can show some errors after
-building all format files. Please do not panic: perhaps some formats
-weren't already installed.
-
-\item Are there any relevant bug fixes at \url{http://tug.org/texlive/}?
-(Unlikely, but it doesn't hurt to check.)
-
-\end{enumerate}
-
-The \TL{} software consists of hundreds of programs and tens of
-thousands of files, all from varying sources. So it is quite difficult to
-predict all possible causes for problems. Nevertheless, we will do our
-best to help you. (See section~\ref{sec:help}, \p.\pageref{sec:help}.)
-
-% don't use \Webc so the \uppercase in the headline works.
-\section{A user's guide to Web2C}
-
-\Webc{} is an integrated collection of \TeX-related programs: \TeX{}
-itself, \MF{}, \MP, \BibTeX{}, etc. It is the heart of \TL{}.
-
-A bit of history: The original implementation was by Tomas Rokicki who,
-in 1987, developed a first \TeX{}-to-C system based on change files
-under Unix, which were primarily the original work of Howard Trickey and
-Pavel Curtis. Tim Morgan became the maintainer of the system, and
-during this period the name changed to Web-to-C\@. In 1990, Karl Berry
-took over the work, assisted by dozens of additional contributors, and
-in 1997 he handed the baton to Olaf Weber.
-
-The \Webc{} system runs on Unix, 32-bit Windows systems, \MacOSX{}, and
-other operating systems. It uses Knuth's original sources for \TeX{} and
-other basic programs written in \web{} and translates them into C source
-code. The core \TeX{} programs are:
-
-\begin{cmddescription}
-\item[bibtex] Maintaining bibliographies.
-\item[dmp] \cmdname{troff} to MPX (\MP{} pictures).
-\item[dvicopy] Expands virtual font references in \dvi{} files.
-\item[dvitomp] \dvi{} to MPX (MetaPost pictures).
-\item[dvitype] \dvi{} to human-readable text.
-\item[gftodvi] Generic font proofsheets.
-\item[gftopk] Generic to packed fonts.
-\item[gftype] GF to human-readable text.
-\item[makempx] \MP{} label typesetting.
-\item[mf] Creating typeface families.
-\item[mft] Prettyprinting \MF{} source.
-\item[mpost] Creating technical diagrams.
-\item[mpto] MetaPost label extraction.
-\item[newer] Compare modification times.
-\item[patgen] Creating hyphenation patterns.
-\item[pktogf] Packed to generic fonts.
-\item[pktype] PK to human-readable text.
-\item[pltotf] Plain text property list to TFM.
-\item[pooltype] Display \web{} pool files.
-\item[tangle] \web{} to Pascal.
-\item[tex] Typesetting.
-\item[tftopl] TFM to plain text property list.
-\item[vftovp] Virtual font to virtual property list.
-\item[vptovf] Virtual property list to virtual font.
-\item[weave] \web{} to \TeX.
-\end{cmddescription}
-
-\noindent The precise functions and syntax of these programs are
-described in the documentation of the individual packages and of \Webc{}
-itself. However, knowing a few principles governing the whole family of
-programs will help you take advantage of your \Webc{} installation.
-
-All programs honor these standard \acro{GNU} options:
-\begin{ttdescription}
-\item[-{}-help] print basic usage summary.
-\item[-{}-verbose] print detailed progress report.
-\item[-{}-version] print version information, then exit.
-\end{ttdescription}
-
-For locating files the \Webc{} programs use the path searching library
-\KPS{}. This library uses a combination of environment variables and a
-configuration files to optimize searching the (huge) collection of
-\TeX{} files. \Webc{} can look at more than one directory tree
-simultaneously, which is useful in maintaining \TeX's standard
-distribution and local extensions in two distinct trees. To speed up
-file searches the root of each tree has a file \file{ls-R}, containing
-an entry showing the name and relative pathname for all files under that
-root.
-
-\subsection{Kpathsea path searching}
-
-Let us first describe the generic path searching mechanism of the \KPS{}
-library.
-
-We call a \emph{search path} a colon- or semicolon\hyph sepa\-rated list
-of \emph{path elements}, which are basically directory names. A
-search path can come from (a combination of) many sources. To look up
-a file \samp{my-file} along a path \samp{.:/dir}, \KPS{} checks each
-element of the path in turn: first \file{./my-file}, then
-\file{/dir/my-file}, returning the first match (or possibly all
-matches).
-
-In order to adapt optimally to all operating systems' conventions, on
-non-Unix systems \KPS{} can use filename separators different from
-colon (\samp{:}) and slash (\samp{/}).
-
-To check a particular path element \var{p}, \KPS{} first checks if a
-prebuilt database (see ``Filename data\-base'' on
-page~\pageref{Filename-database}) applies to \var{p}, i.e., if the database
-is in a directory that is a prefix of \var{p}. If so, the path
-specification is matched against the contents of the database.
-
-If the database does not exist, or does not apply to this path
-element, or contains no matches, the filesystem is searched (if this
-was not forbidden by a specification starting with \samp{!!}\ and if
-the file being searched for must exist). \KPS{} constructs the list
-of directories that correspond to this path element, and then checks
-in each for the file being sought.
-
-The ``file must exist'' condition comes into play with \samp{.vf} files and
-input files read by \TeX's \cs{openin} command. Such files may not
-exist (e.g., \file{cmr10.vf}), and so it would be wrong to search the
-disk for them. Therefore, if you fail to update \file{ls-R} when you
-install a new \samp{.vf} file, it will never be found.
-Each path element is checked in turn: first the database, then the
-disk. If a match is found, the search stops and the result is
-returned.
-
-Although the simplest and most common path element is a directory
-name, \KPS{} supports additional features in search paths: layered
-default values, environment variable names, config file values, users'
-home directories, and recursive subdirectory searching. Thus, we say
-that \KPS{} \emph{expands} a path element, meaning it transforms all
-the specifications into basic directory name or names. This is
-described in the following sections in the same order as it takes
-place.
-
-Note that if the filename being searched for is absolute or explicitly
-relative, i.e., starts with \samp{/} or \samp{./} or \samp{../},
-\KPS{} simply checks if that file exists.
-
-\ifSingleColumn
-\else
-\begin{figure*}
-\verbatiminput{examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{An illustrative configuration file sample}
- \label{fig:config-sample}
-\end{figure*}
-\fi
-
-\subsubsection{Path sources}
-\label{Path-sources}
-
-A search path can come from many sources. In the order in which
-\KPS{} uses them:
-
-\begin{enumerate}
-\item
- A user-set environment variable, for instance, \envname{TEXINPUTS}\@.
- Environment variables with a period and a program name appended
- override; e.g., if \samp{latex} is the name of the program being run,
- then \envname{TEXINPUTS.latex} will override \envname{TEXINPUTS}.
-\item
- A program-specific configuration file, for exam\-ple, a line
- \samp{S /a:/b} in \cmdname{dvips}'s \file{config.ps}.
-\item A \KPS{} configuration file \file{texmf.cnf}, containing a line like
- \samp{TEXINPUTS=/c:/d} (see below).
-\item The compile-time default.
-\end{enumerate}
-\noindent You can see each of these values for a given
-search path by using the debugging options (see ``Debugging actions''
-on page~\pageref{Debugging}).
-
-\subsubsection{Config files}
-
-\begingroup\tolerance=3500
-\KPS{} reads \emph{runtime configuration files} named \file{texmf.cnf}
-for search path and other definitions. The search path used to look
-for these files is named \envname{TEXMFCNF} (by default such a file lives
-in the \file{texmf/web2c} subdirectory). \emph{All}
-\file{texmf.cnf} files in the search path will be read and definitions
-in earlier files override those in later files. Thus, with a search
-path of \verb|.:$TEXMF|, values from \file{./texmf.cnf} override those
-from \verb|$TEXMF/texmf.cnf|.
-\endgroup
-
-\begin{itemize}
-\item
- Comments start with \code{\%} and continue to the end of the line.
-\item
- Blank lines are ignored.
-\item
- A \bs{} at the end of a line acts as a continuation character,
- i.e., the next line is appended. Whitespace at the beginning of
- continuation lines is not ignored.
-\item
- Each remaining line has the form:
-\begin{alltt}
- \var{variable}[.\var{progname}] [=] \var{value}
-\end{alltt}%
- where the \samp{=} and surrounding whitespace are optional.
-\item
- The \ttvar{variable} name may contain any character other
- than whitespace, \samp{=}, or \samp{.}, but sticking to
- \samp{A-Za-z\_} is safest.
-\item
- If \samp{.\var{progname}} is present, the definition only
- applies if the program that is running is named
- \texttt{\var{progname}} or \texttt{\var{progname}.exe}. This allows
- different flavors of \TeX{} to have different search paths, for
- example.
-\item \var{value} may contain any characters except
- \code{\%} and \samp{@}. The
- \code{\$\var{var}.\var{prog}} feature is not available on the
- right-hand side; instead, you must use an additional variable. A
- \samp{;}\ in \var{value} is translated to \samp{:}\ if
- running under Unix; this is useful to be able to have a single
- \file{texmf.cnf} for Unix, \acro{MS-DOS} and Windows systems.
-\item
- All definitions are read before anything is expanded, so
- variables can be referenced before they are defined.
-\end{itemize}
-A configuration file fragment illustrating most of these points is
-\ifSingleColumn
-shown below:
-
-\verbatiminput{examples/ex5.tex}
-\else
-shown in Figure~\ref{fig:config-sample}.
-\fi
-
-\subsubsection{Path expansion}
-\label{Path-expansion}
-
-
-\KPS{} recognizes certain special characters and constructions in
-search paths, similar to those available in Unix shells. As a
-general example, the complex path,
-\verb+~$USER/{foo,bar}//baz+, expands to all subdirectories under
-directories \file{foo} and \file{bar} in \texttt{\$USER}'s home
-directory that contain a directory or file \file{baz}. These
-expansions are explained in the sections below.
-%$
-\subsubsection{Default expansion}
-\label{Default-expansion}
-
-\tolerance=2500
-If the highest-priority search path (see ``Path sources'' on
-page~\pageref{Path-sources}) contains an \emph{extra colon} (i.e.,
-leading, trailing, or doubled), \KPS{} inserts at that point the
-next-highest-prio\-rity search path that is defined. If that inserted
-path has an extra colon, the same happens with the next highest. For
-example, given an environment variable setting
-
-\tolerance=1500
-
-\begin{alltt}
-> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
-and a \code{TEXINPUTS} value from \file{texmf.cnf} of
-
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
-then the final value used for searching will be:
-
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-
-Since it would be useless to insert the default value in more than one
-place, \KPS{} changes only one extra \samp{:}\ and leaves any others in
-place. It checks first for a leading \samp{:}, then a trailing
-\samp{:}, then a doubled \samp{:}.
-
-\subsubsection{Brace expansion}
-
-A useful feature is brace expansion, which means that, for instance,
-\verb+v{a,b}w+ expands to \verb+vaw:vbw+. Nesting is allowed.
-This is used to implement multiple \TeX{} hierarchies, by
-assigning a brace list to \code{\$TEXMF}.
-For example, in \file{texmf.cnf}, the following definition
-(appproximately; there are actually even more trees) is made:
-\begin{verbatim}
- TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN}
-\end{verbatim}
-Using this you can then write something like
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-%$
-which means that, after looking in the current directory, the
-\code{\$TEXMFHOME/tex}, \code{\$TEXMFLOCAL/tex}, \code{\$TEXMFVAR/tex}
-and \code{\$TEXMFMAIN/tex} trees \emph{only}) will be searched (the
-last two use using \file{ls-R} data base files). It is a convenient
-way for running two parallel \TeX{} structures, one ``frozen'' (on a
-\CD, for instance) and the other being continuously updated with new
-versions as they become available. By using the \code{\$TEXMF}
-variable in all definitions, one is sure to always search the
-up-to-date tree first.
-
-\subsubsection{Subdirectory expansion}
-\label{Subdirectory-expansion}
-
-Two or more consecutive slashes in a path element following a directory
-\var{d} is replaced by all subdirectories of \var{d}: first those
-subdirectories directly under \var{d}, then the subsubdirectories under
-those, and so on. At each level, the order in which the directories are
-searched is \emph{unspecified}.
-
-If you specify any filename components after the \samp{//}, only
-subdirectories with matching components are included. For example,
-\samp{/a//b} expands into directories \file{/a/1/b}, \file{/a/2/b},
-\file{/a/1/1/b}, and so on, but not \file{/a/b/c} or \file{/a/1}.
-
-Multiple \samp{//} constructs in a path are possible, but
-\samp{//} at the beginning of a path is ignored.
-
-\subsubsection{List of special characters and their meaning: a summary}
-
-The following list summarizes the special characters in \KPS{}
-configuration files.
-
-% need a wider space for the item labels here.
-\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
-\begin{ttdescription}
-\item[\CODE{:}] Separator in path specification; at the beginning or
- the end of a path it substitutes the default path expansion.\par
-\item[\CODE{;}] Separator on non-Unix systems (acts like \code{:}).
-\item[\CODE{\$}] Variable expansion.
-\item[\CODE{\string~}] Represents the user's home directory.
-\item[\CODE{\char`\{...\char`\}}] Brace expansion.
-\item[\CODE{//}] Subdirectory expansion (can occur anywhere in
- a path, except at its beginning).
-\item[\CODE{\%}] Start of comment.
-\item[\CODE{\bs}] Continuation character (allows multi-line entries).
-\item[\CODE{!!}] Search \emph{only} database to locate file, \emph{do
- not} search the disk.
-\end{ttdescription}
-
-
-\subsection{Filename databases}
-\label{Filename-database}
-
-\KPS{} goes to some lengths to minimize disk accesses for searches.
-Nevertheless, at installations with enough directories, searching each
-possible directory for a given file can take an excessively long time
-(this is especially true if many hundreds of font directories have to
-be traversed.) Therefore, \KPS{} can use an externally-built plain text
-``database'' file named \file{ls-R} that maps files to directories,
-thus avoiding the need to exhaustively search the disk.
-
-A second database file \file{aliases} allows you to give additional
-names to the files listed in \file{ls-R}. This can be helpful to
-confirm to \acro{DOS} 8.3 filename conventions in source files.
-
-\subsubsection{The filename database}
-\label{ls-R}
-
-As explained above, the name of the main filename database must be
-\file{ls-R}. You can put one at the root of each \TeX{} hierarchy in
-your installation that you wish to be searched (\code{\$TEXMF} by
-default); most sites have only one hierarchy. \KPS{} looks for
-\file{ls-R} files along the \code{TEXMFDBS} path.
-
-The recommended way to create and maintain \samp{ls-R} is to run the
-\code{mktexlsr} script included with the distribution. It is invoked
-by the various \samp{mktex}\dots\ scripts. In principle, this script
-just runs the command
-\begin{alltt}
-cd \var{/your/texmf/root} && \path|\|ls -1LAR ./ >ls-R
-\end{alltt}
-presuming your system's \code{ls} produces the right output format
-(\acro{GNU} \code{ls} is all right). To ensure that the database is
-always up-to-date, it is easiest to rebuild it regularly via
-\code{cron}, so that it is automatically updated when the installed
-files change, such as after installing or updating a \LaTeX{} package.
-
-If a file is not found in the database, by default \KPS{} goes ahead
-and searches the disk. If a particular path element begins with
-\samp{!!}, however, \emph{only} the database will be searched for that
-element, never the disk.
-
-
-\subsubsection{kpsewhich: Standalone path searching}
-\label{Invoking-kpsewhich}
-
-The \texttt{kpsewhich} program exercises path searching independent of any
-particular application. This can be useful as a sort of \code{find}
-program to locate files in \TeX{} hierarchies (this is used heavily in
-the distributed \samp{mktex}\dots\ scripts).
-
-\begin{alltt}
-> \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}}
-\end{alltt}
-The options specified in \ttvar{option} start with either \samp{-}
-or \samp{-{}-}, and any unambiguous abbreviation is accepted.
-
-\KPS{} looks up each non-option argument on the command line as a
-filename, and returns the first file found. There is no option to
-return all the files with a particular name (you can run the Unix
-\samp{find} utility for that).
-
-The more important options are described next.
-
-\begin{ttdescription}
-\item[\texttt{-{}-dpi=\var{num}}]\mbox{}
- Set the resolution to \ttvar{num}; this only affects \samp{gf}
- and \samp{pk} lookups. \samp{-D} is a synonym, for compatibility
- with \cmdname{dvips}. Default is 600.
-
-\item[\texttt{-{}-format=\var{name}}]\mbox{}\\
- Set the format for lookup to \ttvar{name}. By default, the
- format is guessed from the filename. For formats which do not have
- an associated unambiguous suffix, such as \MP{} support files and
- \cmdname{dvips} configuration files, you have to specify the name as
- known to \KPS{}, such as \texttt{tex} or \texttt{enc files}. Run
- \texttt{kpsewhich -{}-help} for a list.
-
-\item[\texttt{-{}-mode=\var{string}}]\mbox{}\\
- Set the mode name to \ttvar{string}; this only affects \samp{gf}
- and \samp{pk} lookups. No default: any mode will be found.
-\item[\texttt{-{}-must-exist}]\mbox{}\\
- Do everything possible to find the files, notably including
- searching the disk. By default, only the \file{ls-R} database is
- checked, in the interest of efficiency.
-\item[\texttt{-{}-path=\var{string}}]\mbox{}\\
- Search along the path \ttvar{string} (colon-separated as usual),
- instead of guessing the search path from the filename. \samp{//} and
- all the usual expansions are supported. The options \samp{-{}-path}
- and \samp{-{}-format} are mutually exclusive.
-\item[\texttt{-{}-progname=\var{name}}]\mbox{}\\
- Set the program name to \texttt{\var{name}}.
- This can affect the search paths via the \texttt{.\var{progname}}
- feature.
- The default is \cmdname{kpsewhich}.
-\item[\texttt{-{}-show-path=\var{name}}]\mbox{}\\
- shows the path used for file lookups of file type \texttt{\var{name}}.
- Either a filename extension (\code{.pk}, \code{.vf}, etc.) or a
- name can be used, just as with \samp{-{}-format} option.
-\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\
- sets the debugging options to \texttt{\var{num}}.
-\end{ttdescription}
-
-
-\subsubsection{Examples of use}
-\label{SExamplesofuse}
-
-Let us now have a look at \KPS{} in action. Here's a straightforward search:
-
-\begin{alltt}
-> \Ucom{kpsewhich article.cls}
- /usr/local/texmf-dist/tex/latex/base/article.cls
-\end{alltt}
-We are looking for the file \file{article.cls}. Since the \samp{.cls}
-suffix is unambiguous we do not need to specify that we want to look for a
-file of type \optname{tex} (\TeX{} source file directories). We find it in
-the subdirectory \file{tex/latex/base} below the \samp{texmf-dist} \TL\
-directory. Similarly, all of the following are found without problems
-thanks to their unambiguous suffix.
-\begin{alltt}
-> \Ucom{kpsewhich array.sty}
- /usr/local/texmf-dist/tex/latex/tools/array.sty
-> \Ucom{kpsewhich latin1.def}
- /usr/local/texmf-dist/tex/latex/base/latin1.def
-> \Ucom{kpsewhich size10.clo}
- /usr/local/texmf-dist/tex/latex/base/size10.clo
-> \Ucom{kpsewhich small2e.tex}
- /usr/local/texmf-dist/tex/latex/base/small2e.tex
-> \Ucom{kpsewhich tugboat.bib}
- /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-That last is a \BibTeX{} bibliography database for \textsl{TUGBoat} articles.
-
-\begin{alltt}
-> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
-Font bitmap glyph files of type \file{.pk} are used by display
-programs like \cmdname{dvips} and \cmdname{xdvi}. Nothing is returned in
-this case since there are no pre-generated Computer Modern \samp{.pk}
-files in \TL{}\Dash the Type~1 variants are used by default.
-\begin{alltt}
-> \Ucom{kpsewhich wsuipa10.pk}
-\ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
-\else /usr/local/texmf-var/fonts/pk/ljfour/public/
-... wsuipa/wsuipa10.600pk
-\fi\end{alltt}
-
-For these fonts (a phonetic alphabet from the University of Washington)
-we had to generate \samp{.pk} files, and since the default \MF{} mode on
-our installation is \texttt{ljfour} with a base resolution of 600\dpi{}
-(dots per inch), this instantiation is returned.
-\begin{alltt}
-> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
-\end{alltt}
-In this case, when specifying that we are interested in a resolution
-of 300\dpi{} (\texttt{-dpi=300}) we see that no such font is available on
-the system. A program like \cmdname{dvips} or \cmdname{xdvi} would
-go off and actually build the required \texttt{.pk} files
-using the script \cmdname{mktexpk}.
-
-Next we turn our attention to \cmdname{dvips}'s header and configuration
-files. We first look at one of the commonly used files, the general
-prolog \file{tex.pro} for \TeX{} support, before turning our attention
-to the generic configuration file (\file{config.ps}) and the \PS{} font
-map \file{psfonts.map}\Dash as of 2004, map and encoding files have
-their own search paths and new location in \dirname{texmf} trees. As
-the \samp{.ps} suffix is ambiguous we have to specify explicitly which
-type we are considering (\optname{dvips config}) for the file
-\texttt{config.ps}.
-\begin{alltt}
-> \Ucom{kpsewhich tex.pro}
- /usr/local/texmf/dvips/base/tex.pro
-> \Ucom{kpsewhich --format="dvips config" config.ps}
- /usr/local/texmf/dvips/config/config.ps
-> \Ucom{kpsewhich psfonts.map}
- /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map
-\end{alltt}
-
-We now take a closer look at the \acro{URW} Times \PS{} support
-files. The prefix for these in the standard font naming scheme is
-\samp{utm}. The first file we look at is the configuration file,
-which contains the name of the map file:
-\begin{alltt}
-> \Ucom{kpsewhich --format="dvips config" config.utm}
- /usr/local/texmf-dist/dvips/psnfss/config.utm
-\end{alltt}
-The contents of that file is
-\begin{alltt}
- p +utm.map
-\end{alltt}
-which points to the file \file{utm.map}, which we want to
-locate next.
-\begin{alltt}
-> \Ucom{kpsewhich utm.map}
- /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
-\end{alltt}
-This map file defines the file names of the Type~1 \PS{} fonts in
-the URW collection. Its contents look like (we only show part of the
-lines):
-\begin{alltt}
-utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
-utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
-utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
-Let us, for instance, take the Times Roman instance
-\file{utmr8a.pfb} and find its position in the \file{texmf} directory
-tree with a search for Type~1 font files:
-\begin{alltt}
-> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
-\else /usr/local/texmf-dist/fonts/type1/
-... urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
-It should be evident from these examples how you can easily locate the
-whereabouts of a given file. This is especially important if you suspect
-that the wrong version of a file is picked up somehow, since
-\cmdname{kpsewhich} will show you the first file encountered.
-
-\subsubsection{Debugging actions}
-\label{Debugging}
-
-Sometimes it is necessary to investigate how a program resolves file
-references. To make this practical, \KPS{} offers various levels of
-debugging output:
-
-\begin{ttdescription}
-\item[\texttt{\ 1}] \texttt{stat} calls (disk lookups). When running
- with an up-to-date \file{ls-R} database this should almost give no
- output.
-\item[\texttt{\ 2}] References to hash tables (such as \file{ls-R}
- databases, map files, configuration files).
-\item[\texttt{\ 4}] File open and close operations.
-\item[\texttt{\ 8}] General path information for file types
- searched by \KPS. This is useful to find out where a particular
- path for the file was defined.
-\item[\texttt{16}] Directory list for each path element (only relevant
- for searches on disk).
-\item[\texttt{32}] File searches.
-\end{ttdescription}
-A value of \texttt{-1} will set all the above options; in practice,
-this is usually the most convenient.
-
-Similarly, with the \cmdname{dvips} program, by setting a combination of
-debug switches, one can follow in detail where files are being picked up
-from. Alternatively, when a file is not found, the debug trace shows in
-which directories the program looks for the given file, so that one can
-get an indication what the problem~is.
-
-Generally speaking, as most programs call the \KPS{} library
-internally, one can select a debug option by using the
-\envname{KPATHSEA\_DEBUG} environment variable, and setting it to (a
-combination of) values as described in the above list.
-
-(Note for Windows users: it is not easy to redirect
-all messages to a file in this system. For diagnostic purposes
-you can temporarily \texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log}).
-
-Let us consider, as an example, a small \LaTeX{} source file,
-\file{hello-world.tex}, which contains the following input.
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
-This little file only uses the font \file{cmr10}, so let us look at
-how \cmdname{dvips} prepares the \PS{} file (we want to use the Type~1
-version of the Computer Modern fonts, hence the option \texttt{-Pcms}).
-\begin{alltt}
-> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
-In this case we have combined \cmdname{dvips}'s debug class 4 (font
-paths) with \KPS's path element expansion (see \cmdname{dvips} Reference
-Manual, \OnCD{texmf/doc/html/dvips/dvips_toc.html}).
-The output (slightly rearranged) appears in
-Figure~\ref{fig:dvipsdbga}.
-\begin{figure*}[tp]
-\centering
-\input{examples/ex6a.tex}
-\caption{Finding configuration files}\label{fig:dvipsdbga}
-
-\bigskip
-
-\input{examples/ex6b.tex}
-\caption{Finding the prolog file}\label{fig:dvipsdbgb}
-
-\bigskip
-
-\input{examples/ex6c.tex}
-\caption{Finding the font file}\label{fig:dvipsdbgc}
-\end{figure*}
-
-\cmdname{dvips} starts by locating its working files. First,
-\file{texmf.cnf} is found, which gives the definitions of the search
-paths for the other files, then the file database \file{ls-R} (to
-optimize file searching) and the file \file{aliases}, which makes it
-possible to declare several names (e.g., a short \acro{DOS}-like 8.3 and
-a more natural longer version) for the same file. Then \cmdname{dvips}
-goes on to find the generic configuration file \file{config.ps}
-before looking for the customization file \file{.dvipsrc} (which, in
-this case is \emph{not found}). Finally, \cmdname{dvips} locates the
-config file for the Computer Modern \PS{} fonts \file{config.cms}
-(this was initiated with the \texttt{-Pcms} option on the \cmdname{dvips}
-command). This file contains the list of the map files which
-define the relation between the \TeX{}, \PS{} and file system
-names of the fonts.
-\begin{alltt}
-> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
- p +ams.map
- p +cms.map
- p +cmbkm.map
- p +amsbkm.map
-\end{alltt}
-\cmdname{dvips} thus goes on to find all these files, plus the generic
-map file \file{psfonts.map}, which is always loaded (it contains
-declarations for commonly used \PS{} fonts; see the last part of
-Section \ref{SExamplesofuse} for more details about \PS{} map
-file handling).
-
-At this point \cmdname{dvips} identifies itself to the user:
-\begin{alltt}
-This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com)
-\end{alltt}
-\ifSingleColumn
-Then it goes on to look for the prolog file \file{texc.pro}:
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
-Then it goes on to look for the prolog file \file{texc.pro} (see
-Figure~\ref{fig:dvipsdbgb}).
-\fi
-
-After having found the file in question, \cmdname{dvips} outputs
-date and time, and informs us that it will generate the
-file \file{hello-world.ps}, then that it needs the font file
-\file{cmr10}, and that the latter is declared as ``resident'' (no
-bitmaps needed):
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
-Now the search is on for the file \file{cmr10.tfm}, which is found,
-then a few more prolog files (not shown) are referenced, and finally
-the Type~1 instance \file{cmr10.pfb} of the font is located and
-included in the output file (see last line).
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-\subsection{Runtime options}
-
-Another useful feature of \Webc{} is its possibility to control a number
-of memory parameters (in particular, array sizes) via the runtime file
-\file{texmf.cnf} read by \KPS{}. The memory settings can be found in
-Part 3 of that file in the \TL{} distribution. The more important
-are:
-
-\begin{ttdescription}
-\item[\texttt{main\_memory}]
- Total words of memory available, for
- \TeX{}, \MF{} and \MP. You must make a new format file for each
- different setting. For instance, you could generate a ``huge''
- version of \TeX{}, and call the format file \texttt{hugetex.fmt}.
- Using the standard way of specifying the program name used by \KPS{},
- the particular value of the \texttt{main\_memory} variable will then
- be read from \file{texmf.cnf}.
-\item[\texttt{extra\_mem\_bot}]
- Extra space for ``large'' \TeX{} data structures:
- boxes, glue, breakpoints, etc. Especially useful if you use
- \PiCTeX{}.
-\item[\texttt{font\_mem\_size}]
- Number of words for font information available for \TeX. This
- is more or less the total size of all TFM files read.
-\item[\texttt{hash\_extra}]
- Additional space for the hash table of control sequence names.
- Approximately 10,000 control sequences can be stored in the main
- hash table; if you have a large book with numerous cross-references,
- this might not be enough. The default value of
- \texttt{hash\_extra} is \texttt{50000}.
-\end{ttdescription}
-
-\noindent Of course, this facility is no substitute for truly dynamic
-arrays and memory allocation, but since these are extremely difficult to
-implement in the present \TeX{} source, these runtime parameters provide
-a practical compromise allowing some flexibility.
-
-
-\begin{comment}
-\section{Building on a new Unix platform}
-
-If you have a platform for which executables are not included, you will
-need to compile \TeX{} and friends. This is not as hard as it
-sounds. What you need is all in the directory \texttt{source} in the
-distribution.
-
-\subsection{Prerequisites}
-
-You will need at least 100 megabytes of disk space to compile all of
-\TeX{} and its support programs. You'll also need an \acro{ANSI} C
-compiler, a \cmdname{make} utility, a lexical scanner, and a parser
-generator. We recommend the \acro{GNU} version of these programs
-(\cmdname{gcc}, \acro{GNU} \cmdname{make}, \cmdname{m4}, \cmdname{flex},
-\cmdname{bison}). You may be able to work with other C compilers and
-\cmdname{make} programs, but you will need a good understanding of
-building Unix programs to sort out problems.
-
-Also, the command \texttt{uname} must return a sensible value.
-
-
-\subsection{Configuration}
-
-To begin, perform a normal installation of \TL{} to your disk (see
-section~\ref{sec:unix-install-disk} on
-\p.\pageref{sec:unix-install-disk}). You may wish to skip installing
-all of the prebuilt binaries.
-
-Then, unpack the source from the compressed \texttt{tar} file in the
-directory \dirname{source} to your disk and change directory to where
-you placed it.
-
-Next, run \cmdname{configure} with a command line like this:
-\begin{alltt}
-> \Ucom{sh configure -prefix=/usr/local/TeX}
-\end{alltt}
-
-The \optname{-prefix} directory is the one where you installed the
-support tree; the directory layout will be as follows (where \$TEXDIR
-stands for the directory you chose):
-
-\noindent
-\begin{tabular}{>{\ttfamily}ll@{}}
- \dirname{$TEXDIR/share/texmf} & main tree with fonts,\\
- & \qquad macros, etc\\
- \dirname{$TEXDIR/man} & Unix manual pages\\
- \dirname{$TEXDIR/info} & \acro{GNU} style Info manuals\\
- \dirname{$TEXDIR/bin/$PLATFORM} & binaries\\
-\end{tabular}
-%$
-
-If you want to leave out the \dirname{$PLATFORM} directory level,
-i.e., put the binaries directly into \dirname{$TEXDIR/bin}, specify
-the \verb|--disable-multiplatform| option to \cmdname{configure}.
-
-Have a look at the output of \verb|./configure --help| for more
-options you can use. For example, you can skip building of \OMEGA{} and
-\eTeX{}.
-
-
-\subsection{Running \cmdname{make}}
-
-Make sure the shell variable or option \texttt{noclobber} is not set.
-Then, run the main \cmdname{make} like this:
-\begin{alltt}
-> \Ucom{make world}
-\end{alltt}
-and relax\ldots
-
-Alternatively, you want to log all the output, as in:
-\begin{alltt}
-> \Ucom{sh -c "make world >world.log 2>\&1" \&}
-\end{alltt}
-
-Before you believe that everything went ok, please check the log file
-for errors: \acro{GNU} \cmdname{make} always uses the string \samp{***}
-whenever a command fails. Also, check if all the programs were built:
-
-\begin{alltt}
-> \Ucom{cd \var{TEXDIR}/bin/\var{archname}}
-> \Ucom{ls | wc}
-\end{alltt}
-The result should be over 200 (you can check the exact number with the
-\dirname{bin} directory contents in the distribution).
-
-If you need special privileges for \texttt{make install}, you can
-separate the \samp{make world} into two different runs, like this:
-\begin{alltt}
-> \Ucom{make all}
-> \Ucom{su}
-> \Ucom{make install strip}
-\end{alltt}
-
-After you've installed your new binaries, you should follow the normal
-post-installation procedures, given in section~\ref{sec:postinstall}
-(\p.\pageref{sec:postinstall}).
-
-Also, if you'd like to make your binaries available to others, please
-contact us. We'll be happy to put them on the \TL\ web pages.
-\end{comment}
-
-\section{Acknowledgements}
-
-\TL{} is a joint effort by virtually all of the \TeX{} user groups.
-This edition of \TL{} was overseen by Sebastian Rahtz and Karl Berry.
-The other principal contributors are listed below.
-
-\begin{itemize*}
-
-\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 \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.
-
-\item Thomas Esser, without whose marvelous \teTeX{} package \TL{}
-would certainly not exist, and whose continual help makes it a better
-product.
-
-\item Michel Goossens, who co-authored the original documentation.
-
-\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.
-
-\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 Akira Kakuto, for great assistance in incorporating the Windows
-binaries from his \acro{W32TEX} distribution
-(\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 Ol\v{s}ak, who coordinated and checked all the Czech and Slovak
-material very carefully.
-
-\item Toshio Oshima, for his \cmdname{dviout} previewer for Windows.
-
-\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
-installation, and more.
-
-\item Olaf Weber, for his patient assembly and maintenance of Web2C,
-upon which all else depends.
-
-\item Gerben Wierda, for creating and maintaining the \MacOSX\ support,
-and much integration and testing.
-
-\item Graham Williams, on whose work the catalogue of packages depends.
-
-\end{itemize*}
-
-Builders of the binaries:
-Tigran Aivazian and Hartmut Henkel (\pkgname{x86\_64-linux}),
-Akira Kakuto and Fabrice Popineau (\pkgname{win32}),
-Manfred Lotz (\pkgname{i386-freebsd}),
-Norbert Preining (\pkgname{alpha-linux}),
-Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-linux},
- \pkgname{sparc-solaris}),
-Karl Berry (\pkgname{i386-linux}),
-Olaf Weber (\pkgname{mips-irix}),
-Gerben Wierda (\pkgname{i386-darwin}, \pkgname{powerpc-darwin}).
-
-Documentation and translation updates:
-Karl Berry (English),
-Daniel Flipo \& Fabrice Popineau (French),
-G\"unter Partosch \& Hartmut Henkel (German),
-Petr Sojka \& Jan Busa (Czech\slash Slovak),
-Boris Veytsman (Russian),
-Staszek Wawrykiewicz (Polish).
-
-Of course the most important acknowledgement must go to Donald Knuth, first
-for inventing \TeX, and then for giving it to the world.
-
-
-\section{Release history}
-\label{sec:history}
-
-\subsection{Past}
-
-Discussion began in late 1993 when the Dutch \TeX{} Users Group was
-starting work on its 4All\TeX{} \CD{} for \acro{MS-DOS} users, and it
-was hoped at that time to issue a single, rational, \CD{} for all
-systems. This was too ambitious a target for the time, but it did spawn
-not only the very successful 4All\TeX{} \CD{}, but also the \acro{TUG}
-Technical Council working group on a \emph{\TeX{} Directory Structure}
-(\url{http://tug.org/tds}), which specified how to create consistent and
-manageable collections of \TeX{} support files. A complete draft of the
-\TDS{} was published in the December 1995 issue of \textsl{TUGboat}, and
-it was clear from an early stage that one desirable product would be a
-model structure on \CD{}. The distribution you now have is a very direct
-result of the working group's deliberations. It was also clear that the
-success of the 4All\TeX{} \CD{} showed that Unix users would benefit
-from a similarly easy system, and this is the other main strand of
-\TL.
-
-We first undertook to make a new Unix-based \TDS{} \CD{} in the autumn
-of 1995, and quickly identified Thomas Esser's \teTeX{} as the ideal
-setup, as it already had multi-platform support and was built with
-portability across file systems in mind. Thomas agreed to help, and work
-began seriously at the start of 1996. The first edition was released in
-May 1996. At the start of 1997, Karl Berry completed a major new release
-of Web2c, which included nearly all the features which Thomas Esser had
-added in \teTeX, and we decided to base the 2nd edition of the \CD{} on
-the standard \Webc, with the addition of \teTeX's \texttt{texconfig}
-script. The 3rd edition of the \CD{} was based on a major revision of
-\Webc, 7.2, by Olaf Weber; at the same time, a new revision of \teTeX
-was being made, and \TL{} included almost all of its features. The
-4th edition followed the same pattern, using a new version of \teTeX,
-and a new release of \Webc{} (7.3). The system now included a complete
-Windows setup.
-
-For the 5th edition (March 2000) many parts of the \CD{} were revised
-and checked, updating hundreds of packages. Package details were stored
-in XML files. But the major change for \TeX\ Live 5 was that all
-non-free software was removed. Everything in \TL{} is now intended
-to be compatible with the Debian Free Software Guidelines
-(\url{http://www.debian.org/intro/free}); we have done our best to check
-the license conditions of all packages, but we would very much
-appreciate hearing of any mistakes.
-
-The 6th edition (July 2001) had much more material updated. The major
-change was a new install concept: the user could select a more exact set
-of needed collections. Language-related collections were completely
-reorganized, so selecting any of them installs not only macros, fonts,
-etc., but also prepares an appropriate \texttt{language.dat}.
-
-The 7th edition of 2002 had the notable addition of \MacOSX{} support,
-and the usual myriad of updates to all sorts of packages and
-programs. An important goal was integration of the source back with
-\teTeX, to correct the drift apart in versions~5 and~6.
-
-\subsubsection{2003}
-
-In 2003, with the continuing flood of updates and additions, we found
-that \TL{} had grown so large it could no longer be contained on a
-single \CD, so we split it into three different distributions (see
-section~\ref{sec:multiple-dist}, \p.\pageref{sec:multiple-dist}). In
-addition:
-
-\begin{itemize*}
-\item At the request of the \LaTeX{} team, we changed the standard
- \cmdname{latex} and \cmdname{pdflatex} commands to now use \eTeX{} (see
- \p.\pageref{text:etex}).
-\item The new Latin Modern fonts were included (and are recommended).
-\item Support for Alpha \acro{OSF} was removed
- (\acro{HPUX} support was removed previously), since no one had (or
- volunteered) hardware available on which to compile new binaries.
-\item Windows setup was substantially changed; for the first time
- an integrated environment based on XEmacs was introduced.
-\item Important supplementary programs for Windows
- (Perl, Ghost\-script, Image\-Magick, Ispell) are now installed
- in the \TL{} installation directory.
-\item Font map files used by \cmdname{dvips}, \cmdname{dvipdfm}
- and \cmdname{pdftex} are now generated by the new program
- \cmdname{updmap} and installed into \dirname{texmf/fonts/map}.
-\item \TeX{}, \MF{}, and \MP{} now, by default, output most input
- characters (32 and above) as themselves in output (e.g.,
- \verb|\write|) files,
- log files, and the terminal, i.e., \emph{not} translated using the
- \verb|^^| notation. In \TL{}~7, this translation was
- dependent on the system locale settings; now, locale settings do
- not influence the \TeX{} programs' behavior. If for some reason
- you need the \verb|^^| output, rename the file
- \verb|texmf/web2c/cp8bit.tcx|. (Future releases will have cleaner
- ways to control this.)
-\item This documentation was substantially revised.
-\item Finally, since the edition numbers had grown unwieldy,
- the version is now simply identified by the year: \TL{} 2003.
-\end{itemize*}
-
-
-\subsubsection{2004}
-
-2004 saw many changes:
-
-\begin{itemize}
-
-\item If you have locally-installed fonts which use their own
-\filename{.map} or (much less likely) \filename{.enc} support files, you
-may need to move those support files.
-
-\filename{.map} files are now searched for in subdirectories of
-\dirname{fonts/map} only (in each \filename{texmf} tree), along the
-\envname{TEXFONTMAPS} path. Similarly, \filename{.enc} files are now
-searched for in subdirectories of \dirname{fonts/enc} only, along the
-\envname{ENCFONTS} path. \cmdname{updmap} will attempt to warn about
-problematic files.
-
-For methods of handling this and other information, please see
-\url{http://tug.org/texlive/mapenc.html}.
-
-\item The \TK\ has been expanded with the addition of a \MIKTEX-based
-installable \CD, for those who prefer that implementation to Web2C.
-See section~\ref{sec:struct-tl} (\p.\pageref{sec:struct-tl}).
-
-\item Within \TL, the single large \dirname{texmf} tree of previous
-releases has been replaced by three: \dirname{texmf},
-\dirname{texmf-dist}, and \dirname{texmf-doc}. See
-section~\ref{sec:tld} (\p.\pageref{sec:tld}), and the \filename{README}
-files for each.
-
-\item All \TeX-related input files are now collected in
-the \dirname{tex} subdirectory of \dirname{texmf*} trees, rather than
-having separate sibling directories \dirname{tex}, \dirname{etex},
-\dirname{pdftex}, \dirname{pdfetex}, etc. See
-\CDref{texmf-doc/doc/english/tds/tds.html\#Extensions}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Extensions}}.
-
-\item Helper scripts (not meant to be invoked by users) are now located
-in a new \dirname{scripts} directory of \dirname{texmf*} trees, and
-searched for via \verb|kpsewhich -format=texmfscripts|. So if you have
-programs which call such scripts, they'll need to be adjusted. See
-\CDref{texmf-doc/doc/english/tds/tds.html\#Scripts}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Scripts}}.
-
-\item Almost all formats leave most characters printable as
-themselves via the ``translation file'' \filename{cp227.tcx}, instead of
-translating them with the \verb|^^| notation. Specifically, characters
-at positions 32--256, plus tab, vertical tab, and form feed are
-considered printable and not translated. The exceptions are plain \TeX\
-(only 32--126 printable), \ConTeXt\ (0--255 printable), and the
-\OMEGA-related formats. This default behavior is almost the same as in
-\TL\,2003, but it's implemented more cleanly, with more possibilities
-for customization. See \CDref{texmf/doc/web2c/web2c.html\#TCX-files}
-{\texttt{texmf/doc/web2c/web2c.html\#TCX-files}}.
-(By the way, with Unicode input, \TeX\ may output partial character
-sequences when showing error contexts, since it is byte-oriented.)
-
-\item \textsf{pdfetex} is now the default engine for all formats
-except (plain) \textsf{tex} itself. (Of course it generates \acro{DVI}
-when run as \textsf{latex}, etc.) This means, among other things, that
-the microtypographic features of \textsf{pdftex} are available in
-\LaTeX, \ConTeXt, etc., as well as the \eTeX\ features
-(\OnCD{texmf-dist/doc/etex/base/}).
-
-It also means it's \emph{more important than ever} to use the
-\pkgname{ifpdf} package (works with both plain and \LaTeX) or equivalent
-code, because simply testing whether \cs{pdfoutput} or some other
-primitive is defined is not a reliable way to determine if \acro{PDF}
-output is being generated. We made this backward compatible as best we
-could this year, but next year, \cs{pdfoutput} may be defined even when
-\acro{DVI} is being written.
-
-\item pdf\TeX\ (\url{http://pdftex.org}) has many new features:
-
- \begin{itemize*}
-
- \item \cs{pdfmapfile} and \cs{pdfmapline} provide font map support
- from within a document.
-
- \item Microtypographic font expansion can be used more easily.\\
- \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}
-
- \item All parameters previously set through the special configuration
- file \filename{pdftex.cfg} must now be set through primitives,
- typically in \filename{pdftexconfig.tex}; \filename{pdftex.cfg} is no
- longer supported. Any extant \filename{.fmt} files must be redumped
- when \filename{pdftexconfig.tex} is changed.
-
- \item See the pdf\TeX\ manual for more: \OnCD{texmf/doc/pdftex/manual}.
-
- \end{itemize*}
-
-\item The \cs{input} primitive in \cmdname{tex} (and \cmdname{mf} and
-\cmdname{mpost}) now accepts double quotes containing spaces and other
-special characters. Typical examples:
-\begin{verbatim}
-\input "filename with spaces" % plain
-\input{"filename with spaces"} % latex
-\end{verbatim}
-See the Web2C manual for more: \OnCD{texmf/doc/web2c}.
-
-\item enc\TeX\ support is now included within Web2C and consequently all
-\TeX\ programs, via the \optname{-enc} option\Dash \emph{only when
-formats are built}. enc\TeX\ supports general re-encoding of input and
-output, enabling full support of Unicode (in \acro{UTF}-8). See
-\OnCD{texmf-dist/doc/generic/enctex/} and
-\url{http://www.olsak.net/enctex.html}.
-
-\item Aleph, a new engine combining \eTeX\ and \OMEGA, is available.
-A little information is available in \OnCD{texmf-dist/doc/aleph/base}
-and \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}. The
-\LaTeX-based format for Aleph is named \textsf{lamed}.
-
-\item The latest \LaTeX\ release has a new version of the
-\acro{LPPL}\Dash now officially a Debian-approved license. Assorted
-other updates, see the \filename{ltnews} files in
-\OnCD{texmf-dist/doc/latex/base}.
-
-\item \cmdname{dvipng}, a new program for converting \acro{DVI} to
-\acro{PNG} image files, is included. See \OnCD{texmf/doc/man/man1/dvipng.1}.
-
-\item We reduced the \pkgname{cbgreek} package to a ``medium'' sized set
-of fonts, with the assent and advice of the author (Claudio Beccari).
-The excised fonts are the invisible, outline, and transparency ones,
-which are relatively rarely used, and we needed the space. The full set
-is of course available from \acro{CTAN}
-(\url{http://www.ctan.org/tex-archive/fonts/greek/cb}).
-
-\item \cmdname{oxdvi} has been removed; just use \cmdname{xdvi}.
-
-\item The \cmdname{ini} and \cmdname{vir} commands (links) for
-\cmdname{tex}, \cmdname{mf}, and \cmdname{mpost} are no longer created,
-such as \cmdname{initex}. The \cmdname{ini} functionality has been
-available through the command-line option \optname{-ini} for years now.
-
-\item \textsf{i386-openbsd} platform support was removed. Since the
-\pkgname{tetex} package in the \acro{BSD} Ports system is available, and
-\acro{GNU/}Linux and Free\acro{BSD} binaries were available, it seemed
-volunteer time could be better spent elsewhere.
-
-\item On \textsf{sparc-solaris} (at least), you may have to set the
-\envname{LD\_LIBRARY\_PATH} environment variable to run the
-\pkgname{t1utils} programs. This is because they are compiled with C++,
-and there is no standard location for the runtime libraries. (This is
-not new in 2004, but wasn't previously documented.) Similarly, on
-\textsf{mips-irix}, the \acro{MIPS}pro 7.4 runtimes are required.
-
-\end{itemize}
-
-\subsubsection{2005}
-
-2005 saw the usual huge number of updates to packages and programs.
-The infrastructure stayed relatively stable from 2004, but inevitably
-there were some changes there as well:
-
-\begin{itemize}
-
-\item New scripts \cmdname{texconfig-sys}, \cmdname{updmap-sys}, and
- \cmdname{fmtutil-sys} were introduced, which modify the
- 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
- files (user or system, respectively) are found. Thus, you may
- need to move personal versions of \filename{fmtutil.cnf} and
- \filename{updmap.cfg} to these places; another option is to
- redefine \envname{TEXMFCONFIG} or \envname{TEXMFSYSCONFIG} in
- \filename{texmf.cnf}. In any case the real location of these files
- and the values of \envname{TEXMFCONFIG} and \envname{TEXMFSYSCONFIG}
- must agree.
- 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
- 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
- can use the package \pkgname{ifpdf.sty} (which works under both
- plain \TeX\ and \LaTeX) to do this, or steal its logic.
-
-\item Last year, we changed most formats to output (8-bit) characters as
- themselves (see previous section). The new TCX file
- \filename{empty.tcx} now provides an easier way to get the
- original \verb|^^| notation if you so desire, as in:
-\begin{verbatim}
-latex --translate-file=empty.tcx yourfile.tex
-\end{verbatim}
-
-\item The new program \cmdname{dvipdfmx} is included for translation of
- DVI to PDF; this is an actively maintained update of
- \cmdname{dvipdfm} (which is also still available for now, though
- no longer recommended).
-
-\item The new programs \cmdname{pdfopen} and \cmdname{pdfclose} are included
- to allow reloading of pdf files in the Adobe Acrobat Reader without
- restarting the program. (Other pdf readers, notably \cmdname{xpdf},
- \cmdname{gv}, and \cmdname{gsview}, have never suffered from this
- problem.)
-
-\item For consistency, the variables \envname{HOMETEXMF} and
- \envname{VARTEXMF} have been renamed to \envname{TEXMFHOME} and
- \envname{TEXMFSYSVAR}, respectively. There is also
- \envname{TEXMFVAR}, which is by default user-specific. See the
- first point above.
-
-\end{itemize}
-
-
-\subsection{Present}
-\label{tlcurrent}
-
-In 2006--2007, 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})
-
-The \TeX\ \filename{.fmt} (high-speed format) and the similar files for
-MetaPost and \MF\ are now stored in subdirectories of \dirname{texmf/web2c},
-instead of in the directory itself (although the directory is still
-searched, for the sake of existing \filename{.fmt}'s). The
-subdirectories are named for the `engine' in use, such as \filename{tex}
-or \filename{pdftex} or \filename{xetex}. This change should be
-invisible in normal use.
-
-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.
-
-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.
-
-Finally, in May 2006 Thomas Esser announced that he would no longer be
-updating te\TeX{} (\url{http://tug.org/tetex}). As a result, there was
-been a surge of interest in \TL{}, especially among \acro{GNU}/Linux
-distributors. (There is a new \texttt{tetex} installation scheme in
-\TL{}, which provides an approximate equivalent.) We hope this will
-eventually translate to improvements in the \TeX\ environment for
-everyone.
-
-
-\subsection{Future}
-
-\emph{\TL{} is not perfect!} (And never will be.) We intend to
-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
-a great deal remains to be done. If you can help, don't hesitate to put
-your name forward!
-
-Please send corrections, suggestions, and offers of help to:\hfill\null
-\begin{quote}
-\email{tex-live@tug.org} \\
-\url{http://tug.org/texlive}
-\end{quote}
-
-\medskip
-\noindent \textsl{Happy \TeX ing!}
-
-\end{document}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/live-2008.tex b/Master/texmf-doc/source/texlive/texlive-en/archive/live-2008.tex
deleted file mode 100644
index a172d5f409e..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/live-2008.tex
+++ /dev/null
@@ -1,2951 +0,0 @@
-% $Id: live.tex 9531 2008-07-13 21:12:58Z siepo $
-% TeX Live documentation. Originally written by Sebastian Rahtz and
-% Michel Goossens, now maintained by Karl Berry and others.
-% Public domain.
-%
-\documentclass{article}
-\let\tldocenglish=1 % for live4ht.cfg
-\usepackage{tex-live}
-\usepackage[latin1]{inputenc} % translators: use your preferred encodings.
-\usepackage[T1]{fontenc}
-
-\begin{document}
-
-\title{%
- {\huge \textit{The \TeX\ Live Guide}\\\smallskip}%
- {\LARGE \textsf{\TL{} 2008}}%
-}
-
-\author{Karl Berry, editor \\[3mm]
- \url{http://tug.org/texlive/}
- }
-
-\date{August 2008}
-
-\maketitle
-
-\begin{multicols}{2}
-\tableofcontents
-%\listoftables
-\end{multicols}
-
-\section{Introduction}
-\label{sec:intro}
-
-\subsection{\TeX\ Live and the \TeX\ Collection}
-
-This document describes the main features of the \TL{} software
-distribution\Dash \TeX{} and related programs for \GNU/Linux
-and other Unix flavors, \MacOSX, and Windows systems.
-
-You may have acquired \TL{} by downloading, or on the \TK{} \DVD,
-which \TeX{} usergroups distribute among their members. Section
-\ref{sec:tl-coll-dists} briefly describes the contents of this \DVD.
-Both \TL{} and the \TK{} are cooperative efforts by the \TeX{} user
-groups. This document mainly describes \TL{} itself.
-
-\TL{} includes executables for \TeX{}, \LaTeXe{}, \ConTeXt,
-\MF, \MP, \BibTeX{} and many other programs; an extensive collection
-of macros, fonts and documentation; and support for typesetting in
-many different scripts from around the world.
-
-\TL{} packages are regularly updated from
-\acro{CTAN}: \url{http://www.ctan.org}.
-
-For a brief summary of the major changes in this edition of \TL{},
-see the end of the document, section~\ref{sec:history}
-(\p.\pageref{sec:history}).
-
-\subsection{Operating system support}
-\label{sec:os-support}
-
-\TL{} contains binaries for many Unix-based architectures,
-including \MacOSX. The included sources should enable installation
-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
-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 installation of \protect\TL{}}
-\label{sec:basic}
-
-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
-your system supports that).
-
-\noindent This is described in the
-installation sections following, but here is a quick start:
-
-\begin{itemize*}
-
-\item The installation script is named \filename{install-tl}. It can
- operate in both a \GUI{} mode (default for Windows) and
- a text mode (default for everything else). You can force one mode or
- the other with the options \code{-gui} and \code{-no-gui}, respectively.
-
-\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*}
-
-
-\subsection{Getting help}
-\label{sec:help}
-
-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:
-
-\begin{description}
-\item [Getting Started] If you are new to \TeX, the web page
-\url{http://tug.org/begin.html} gives a brief introduction to the system.
-
-\item [\TeX{} \acro{FAQ}] The \TeX{} \acro{FAQ} is a huge compendium
- of answers to all sorts of questions, from the most basic to the
- most arcane. It is included on \TL{} in
- \OnCD{texmf-doc/doc/english/FAQ-en/html/index.html}, and is available
- on the Internet through \url{http://www.tex.ac.uk/faq}. Please
- check here first.
-
-\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
-\url{http://www.ctan.org/help/Catalogue/}.
-
-\item [\TeX{} Web Resources] The web page
-\url{http://tug.org/interest.html} has many \TeX{}-related links, in
-particular for numerous books, manuals, and articles on all aspects of
-the system.
-
-\item [support archives] The two principal support forums are the
-Usenet newsgroup \url{news:comp.text.tex} and the mailing list
-\email{texhax@tug.org}. Their archives have years of past
-questions and answers for your searching pleasure, via
-\url{http://groups.google.com/group/comp.text.tex/topics} and
-\url{http://tug.org/mail-archives/texhax}, respectively. And a general web
-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, 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{}, 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}
-
-The other side of the coin is helping others who have questions. Both
-\dirname{comp.text.tex} and \code{texhax} are open to anyone, so feel
-free to join, start reading, and help out where you can.
-
-
-% don't use \TL so the \uppercase in the headline works. Also so
-% tex4ht ends up with the right TeX. Likewise the \protect's.
-\section{Overview of \protect\TeX\protect\ Live}
-\label{sec:overview-tl}
-
-This section describes the contents of \TL{} and the \TK{} of which it
-is a part.
-
-\subsection{The \protect\TeX\protect\ Collection: \TL, pro\TeX{}t, Mac\TeX}
-\label{sec:tl-coll-dists}
-
-The \TK{} \DVD{} comprises the following:
-
-\begin{description}
-
-\item [\TL] A complete \TeX{} system which can be run live or
- installed to disk.
-
-\item [Mac\TeX] for \MacOSX, this adds a native \MacOSX\ installer and other
-Mac applications to \TL{}. Its home page is
-\url{http://www.tug.org/mactex/}.
-
-\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. The \ProTeXt\ home page is
-\url{http://tug.org/protext}.
-
-\item [CTAN] A snapshot of the \CTAN{} repository.
-
-\item [\texttt{texmf-extra}] A directory with assorted additional packages.
-
-\end{description}
-
-\CTAN{}, \pkgname{protext}, and \dirname{texmf-extra} do not
-necessarily follow the same copying conditions as \TL{}, so be careful
-when redistributing or modifying.
-
-
-\subsection{Top level \TL{} directories}
-\label{sec:tld}
-
-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{texlive}, not at the top
-level of the disc.
-
-\begin{ttdescription}
-\item[bin] The \TeX{} system programs, arranged by platform.
-%
-\item[readme.html] Web pages with a quick introduction and useful links,
-in various languages.
-%
-\item[source] The source to all included programs, including the main \Webc{}
- \TeX{} and \MF{} distributions.
-%
-\item[support] Various auxiliary packages and programs. These are
- \emph{not} installed automatically. This includes
- assorted editors and \TeX\ shells.
-%
-\item[texmf] See \dirname{TEXMFMAIN} below.
-%
-\item[texmf-dist] See \dirname{TEXMFDIST} below.
-%
-\item[texmf-doc] Tree for self-contained pure documentation, arranged by
- language.
-%
-\item[tlpkg] Scripts, programs and data for managing the
- installation. It also contains private copies of
- Perl and Ghostscript for Windows, which are invisible outside \TL,
- and a new Windows PostScript viewer PSView.
-\end{ttdescription}
-
-In addition to the directories above, the installation scripts and
-\filename{README} files (in various languages) are at the top level of
-the distribution.
-
-The \dirname{texmf-doc} directory contains documentation which does
-not belong to any particular package or program. The documentation
-for the programs (manuals, man pages, Info files) is in
-\dirname{texmf/doc}. The documentation for \TeX\ packages and
-formats is in \dirname{texmf-dist/doc}. You can use the
-\cmdname{texdoc} or \cmdname{texdoctk} programs to find any
-documentation wherever it is located. The comprehensive links in
-the top-level file \OnCD{doc.html} may also be helpful.
-
-This \TL\ documentation itself is in \dirname{texmf-doc} and is
-available in several languages:
-
-\begin{itemize*}
-\item{Simplified Chinese:} \OnCD{texmf-doc/doc/chinese/texlive-zh-cn}
-\item{Czech/Slovak:} \OnCD{texmf-doc/doc/czechslovak/texlive-cz}
-\item{English:} \OnCD{texmf-doc/doc/english/texlive-en}
-\item{French:} \OnCD{texmf-doc/doc/french/texlive-fr}
-\item{German:} \OnCD{texmf-doc/doc/german/texlive-de}
-\item{Polish:} \OnCD{texmf-doc/doc/polish/texlive-pl}
-\item{Russian:} \OnCD{texmf-doc/doc/russian/texlive-ru}
-\end{itemize*}
-
-\subsection{Overview of the predefined texmf trees}
-\label{sec:texmftrees}
-
-This section lists all predefined variables specifying the texmf trees
-used by the system, and their intended purpose, and the default
-layout of a \TL{} system. The command \texttt{texconfig conf} shows
-you the values of these variables, so that you can easily find out
-how they map to directory names in your installation.
-
-\begin{ttdescription}
-\item [TEXMFMAIN] The tree which holds vital parts of the system
- such as helper scripts (e.g., \verb+web2c/mktexdir+) and other
- support files and their documentation. Does not include
- \TeX\ formats and packages.
-\item [TEXMFDIST] The tree which holds the main set of macro packages,
- fonts, etc., as originally distributed.
-\item [TEXMFLOCAL] The tree which administrators can use for system-wide
- installation of additional or updated macros, fonts, etc.
-\item [TEXMFHOME] The tree which users can use for their own individual
- installations of additional or updated macros, fonts, etc.
- The expansion of this variable dynamically adjusts for each user to
- their own individual directory.
-\item [TEXMFCONFIG] The tree used by the utilities
- \verb+texconfig+, \verb+updmap+, and \verb+fmtutil+ to store modified
- configuration data. Under \envname{TEXMFHOME} by default.
-\item [TEXMFSYSCONFIG] The tree used by the utilities
- \verb+texconfig-sys+, \verb+updmap-sys+, and \verb+fmtutil-sys+ to
- store modified configuration data.
-\item [TEXMFVAR] The tree used by \verb+texconfig+, \verb+updmap+ and
- \verb+fmtutil+ to store (cached) runtime data such as format files and
- generated map files. Under \envname{TEXMFHOME} by default.
-\item [TEXMFSYSVAR] The tree used by \verb+texconfig-sys+,
- \verb+updmap-sys+ and \verb+fmtutil-sys+, and also by \verb+tlmgr+, to
- store (cached) runtime data such as format files and generated map files.
-\end{ttdescription}
-
-\noindent
-The default layout is:
-\begin{description}
- \item[system-wide root] can span multiple \TL{} releases:
- \begin{ttdescription}
- \item[2007] A previous release.
- \begin{ttdescription}
- \item [...]
- \end{ttdescription}
- \item[2008] The current release.
- \begin{ttdescription}
- \item [bin] ~
- \begin{ttdescription}
- \item [i386-linux] \GNU/Linux binaries
- \item [...]
- \item [universal-darwin] \MacOSX binaries
- \item [win32] Windows binaries
- \end{ttdescription}
- \item [texmf] This is \envname{TEXMFMAIN}.
- \item [texmf-dist] \envname{TEXMFDIST}
- \item [texmf-doc] \envname{TEXMFDOC}
- \item [texmf-var] \envname{TEXMFSYSVAR}
- \item [texmf-config] \envname{TEXMFSYSCONFIG}
- \end{ttdescription}
- \item [texmf-local] \envname{TEXMFLOCAL}, intended to be
- retained from release to release.
- \end{ttdescription}
- \item[user's home] (\texttt{\$HOME} or
- \texttt{\%USERPROFILE\%})
- \begin{ttdescription}
- \item[.texlive2007] Privately generated and configuration data
- for a previous release.
- \item[.texlive2008] Privately generated and configuration data
- for the current release.
- \begin{ttdescription}
- \item [texmf-var] \envname{TEXMFVAR}
- \item [texmf-config] \envname{TEXMFCONFIG}
- \end{ttdescription}
- \item[texmf] \envname{TEXMFHOME} Personal macros.
- \textit{etc.}
- \end{ttdescription}
-\end{description}
-
-
-\subsection{Extensions to \protect\TeX}
-\label{sec:tex-extensions}
-
-\TeX{} itself is frozen, apart from rare bug fixes. It is still present
-in \TL\ as the program \prog{tex}, and will remain so in the
-foreseeable future. \TL{} contains several extended versions of \TeX:
-
-\begin{description}
-
-\item [\eTeX] adds a set of new primitives
-\label{text:etex} (related to macro expansion, character scanning,
-classes of marks, additional debugging features, and more) and the
-\TeXXeT{} extensions for bidirectional typesetting. In default mode,
-\eTeX{} is 100\% compatible with ordinary \TeX. See
-\OnCD{texmf-dist/doc/etex/base/etex_man.pdf}.
-
-\item [pdf\TeX] builds on the \eTeX\ extensions, adding support for
-writing \acro{PDF} output as well as \dvi{}. This is the program
-invoked for most formats, e.g., \prog{etex}, \prog{latex},
-\prog{pdflatex}. See \url{http://www.pdftex.org/}.
-\OnCD{texmf-dist/doc/pdftex/manual/pdftex-a.pdf} for the manual, and
-\OnCD{texmf-dist/doc/pdftex/manual/samplepdf/samplepdf.tex} for example usage
-of some of its features.
-
-\item [Lua\TeX] is the designated successor of pdf\TeX, with which it
-is intended to be backward-compatible. It should also supersede Aleph,
-see below. The incorporated Lua interpreter (see
-\url{http://www.lua.org/}) enables elegant solutions for many thorny
-\TeX{} problems. When called as \filename{texlua}, it functions as a
-standalone Lua interpreter, and is already used as such within \TL. See
-\url{http://www.luatex.org/} and
-\OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}.
-
-\item [\XeTeX] adds support for Unicode input and OpenType- and system
-fonts, implemented using standard 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
-also supports so-called `\OMEGA{} Translation Processes' (\acro{OTP}s),
-for performing complex transformations on arbitrary input. See
-\OnCD{texmf-dist/doc/omega/base/doc-1.8.tex} (not completely up-to-date).
-
-\item [Aleph] combines the \OMEGA\ and \eTeX\ extensions.
-See \OnCD{texmf-dist/doc/aleph/base} for some minimal documentation.
-
-\end{description}
-
-
-\subsection{Other notable programs in \protect\TL}
-
-Here are a few other commonly-used programs included in \TL{}:
-
-\begin{cmddescription}
-
-\item [bibtex] bibliography support.
-
-\item [makeindex] index support.
-
-\item [dvips] convert \dvi{} to \PS{}.
-
-\item [xdvi] \dvi{} previewer for the X Window System.
-
-\item [dvilj] \dvi{} drive for the HP LaserJet family.
-
-\item [dv2dt, dt2dv] convert \dvi{} to/from plain text.
-
-\item [dviconcat, dviselect] cut and paste pages
-from \dvi{} files.
-
-\item [dvipdfmx] convert \dvi{} to \acro{PDF}, an alternative approach
-to pdf\TeX\ (mentioned above). See the \pkgname{ps4pdf} and
-\pkgname{pdftricks} packages for still more alternatives.
-
-\item [psselect, psnup, \ldots] \PS{}
-utilities.
-
-\item [lacheck] \LaTeX{} syntax checker.
-
-\item [texexec, texmfstart] Con\TeX{}t and \acro{PDF} processor.
-
-\item [tex4ht] \TeX{} to \acro{HTML} (and \acro{XML} and more) converter.
-
-\end{cmddescription}
-
-
-\subsection{Fonts in \protect\TL}
-\label{sec:tl-fonts}
-
-\TL{} comes with many high-quality scalable fonts. See
-\url{http://tug.org/fonts} and
-\OnCD{texmf-doc/doc/english/free-math-font-survey}.
-
-
-
-\section{Installation}
-\label{sec:install}
-
-\subsection{Starting the installer}
-\label{sec:inst-start}
-
-To start with, get the \TK{} \DVD{} or download the \TL{} net installer,
-and locate the installer script: \filename{install-tl} for Unix,
-\filename{install-tl.bat} for Windows.
-
-\begin{description}
-\item [Net installer:] Download from \CTAN, under
-\dirname{systems/texlive/tlnet}; the url
-\url{http://mirror.ctan.org/systems/texlive/tlnet} will automatically
-redirect to a nearby, up-to-date, mirror. You can retrieve either
-\filename{install-tl.zip} which can be used under Unix and Windows and
-\filename{install-unx.tar.gz} which is considerably smaller, for Unix
-only. After unpacking, \filename{install-tl} and
-\filename{install-tl.bat} will be in the \dirname{install-tl}
-subdirectory.
-
-\item [\TeX{} Collection \DVD:] go to its \dirname{texlive}
-subdirectory. Under Windows, the installer should start automatically
-when you insert the \DVD. You can get the \DVD\ by becoming a member of
-a \TeX\ user group (highly recommended,
-\url{http://tug.org/usergroups.html}), or purchasing it separately
-(\url{http://tug.org/store}), or burning your own from the \ISO\
-image (\url{http://tug.org/texlive/acquire.html}).
-
-\end{description}
-The following sections explain in more detail.
-
-\subsubsection{Unix}
-
-\begin{figure}[tb]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
-
- Detected platform: Intel x86 with GNU/Linux
-
- <B> binary systems: 1 out of 16
-
- <S> Installation scheme (scheme-full)
-
- Customizing installation scheme:
- <C> standard collections
- <L> language collections
- 83 collections out of 84, disk space required: 1666 MB
-
- <D> directories:
- TEXDIR (the main TeX directory):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
- [X] install macro/font doc tree
- [X] install macro/font source tree
- [ ] create symlinks in standard directories
-
- <V> Install for running from DVD
-
-Other actions:
- <I> start installation to HD
- <H> help
- <Q> quit
-
-Enter command:
-\end{boxedverbatim}
-\caption{Main text installer screen (\GNU/Linux)}\label{fig:text-main}
-\end{figure}
-
-\begin{figure}[tb]
-\tlpng{install-w32-main}{\linewidth}
-\caption{Main \GUI{} installer screen (Windows)}\label{fig:gui-main}
-\end{figure}
-
-\noindent
-Below, \texttt{>} denotes the shell prompt; user input is
-\Ucom{\texttt{bold}}.
-Starting in a terminal window on a Unix-compatible system, the simplest
-way:
-\begin{alltt}
-> \Ucom{cd /path/to/installer}
-> \Ucom{perl install-tl}
-\end{alltt}
-(Or you can invoke \Ucom{perl /path/to/installer/install-tl}, or
-\Ucom{./install-tl} if it stayed executable, etc.; we won't repeat all
-these variations.)
-
-To install in \GUI\ mode (you'll need the \dirname{Perl/TK} module), use:
-\begin{alltt}
-> \Ucom{perl install-tl -gui}
-\end{alltt}
-
-For a complete listing of the various options:
-\begin{alltt}
-> \Ucom{perl install-tl -help}
-\end{alltt}
-
-\textbf{Warning about Unix permissions:} Your \code{umask} at the time
-of installation will be respected by the \TL{} installer. Therefore, if
-you want your installation to be usable by users other than you, make
-sure your setting is sufficiently permissive, for instance, \code{umask
-002}. For more information about \code{umask}, consult your system
-documentation.
-
-
-\subsubsection{Mac\,OS\,X}
-
-As mentioned in section~\ref{sec:tl-coll-dists}, a separate distribution
-is prepared for \MacOSX, named Mac\TeX\ (\url{http://tug.org/mactex}).
-We recommend using the native Mac\TeX\ installer instead of the \TL\
-installer on \MacOSX, because the native installer can make a few
-Mac-specific adjustments, in particular to allow easily switching
-between the various \TeX\ distributions for \MacOSX\ (Mac\TeX, gw\TeX,
-Fink, MacPorts, \ldots).
-
-Mac\TeX\ is firmly based on \TL, and the main \TeX\ trees are precisely
-the same. It does add a few extra folders with Mac-specific
-documentation and applications.
-
-
-\subsubsection{Windows}
-
-If you are using the net installer, or the \DVD\ installer failed to
-start automatically, double-click \filename{install-tl.bat}.
-
-You can also start the installer from the command-prompt. Below,
-\texttt{>} denotes the prompt; user input is \Ucom{\texttt{bold}}. If
-you are in the installer directory, run just:
-\begin{alltt}
-> \Ucom{install-tl}
-\end{alltt}
-
-Or you can invoke it with an absolute location, such as:
-\begin{alltt}
-> \Ucom{D:\bs{}texlive\bs{}install-tl}
-\end{alltt}
-for the \TK\ \DVD, supposing that \dirname{D:} is the optical drive.
-
-To install in text mode, use:
-\begin{alltt}
-> \Ucom{install-tl -no-gui}
-\end{alltt}
-
-For a complete listing of the various options:
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-
-\subsubsection{The text installer}
-
-Figure~\ref{fig:text-main} displays the main text mode screen under
-Unix.
-
-This is only a command-line installer; there is no cursor support at
-all. For instance, you cannot tab around checkboxes or input fields.
-You just type something (case-sensitive) at the prompt and press the
-Enter key, and then the entire terminal screen will be rewritten, with
-adjusted content.
-
-The text installer interface is this primitive for a reason: it
-is designed to run on as many platforms as possible, even with a
-very barebones Perl (for Windows, a Perl subset is included).
-
-\subsubsection{The graphical installer}
-
-Figure~\ref{fig:gui-main} displays the graphical installer under
-Windows. Most differences in available options are due to this
-screenshot being from Windows, and the previous text screen being
-from \GNU/Linux.
-
-\subsection{Running the installer}
-\label{sec:runinstall}
-
-The installer is intended to be mostly self-explanatory. Still, a few
-quick notes about the various options and submenus:
-
-\subsubsection{Binary systems menu (Unix only)}
-\label{sec:binary}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Available sets of binaries:
-===============================================================================
-
- a [ ] alpha-linux DEC Alpha with GNU/Linux
- b [ ] amd64-freebsd x86_64 with FreeBSD
- c [ ] hppa-hpux HP-UX
- d [ ] i386-freebsd Intel x86 with FreeBSD
- e [X] i386-linux Intel x86 with GNU/Linux
- f [ ] i386-openbsd Intel x86 with OpenBSD
- g [ ] i386-solaris Intel x86 with Sun Solaris
- h [ ] mips-irix SGI IRIX
- i [ ] powerpc-aix PowerPC with AIX
- j [ ] powerpc-linux PowerPC with GNU/Linux
- k [ ] sparc-linux Sparc with GNU/Linux
- l [ ] sparc-solaris Sparc with Solaris
- m [ ] universal-darwin universal binaries for MacOSX/Darwin
- o [ ] win32 Windows
- p [ ] x86_64-linux x86_64 with GNU/Linux
-\end{boxedverbatim}
-\caption{Binaries menu}\label{fig:bin-text}
-\end{figure}
-
-Figure~\ref{fig:bin-text} displays the text mode binaries menu. By
-default, only the binaries for your current platform will be installed.
-From this menu, you can select installation of binaries for other
-architectures as well. This can be useful if you are sharing a \TeX\
-tree across a network of heterogenous machines, or for a dual-boot
-system.
-
-\subsubsection{Selecting what is going to be installed}
-\label{sec:components}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Select a scheme:
-===============================================================================
-
- a [ ] TeX Live basic scheme
- b [ ] TeX Live scheme for ConTeXt
- c [X] TeX Live full scheme
- d [ ] GUST TeX Live scheme
- e [ ] GUTenberg TeX Live scheme
- f [ ] TeX Live medium scheme
- g [ ] TeX Live minimal scheme
- h [ ] TeX Live for Omega users
- i [ ] teTeX scheme
- j [ ] XML typesetting scheme
-\end{boxedverbatim}
-\caption{Scheme menu}\label{fig:scheme-text}
-\end{figure}
-
-Figure~\ref{fig:scheme-text} displays the \TL\ scheme menu; from here,
-you choose a ``scheme'', which is an overall set of package collections.
-The default \optname{full} scheme installs everything available, but you
-can also choose the \optname{basic} scheme for a small system,
-\optname{minimal} for testing purposes, and \optname{medium} or
-\optname{teTeX} to get something in between. There are also various
-specialized and country-specific schemes.
-
-\begin{figure}[tbh]
-\tlpng{stdcoll}{.7\linewidth}
-\caption{Collections menu (Linux)}\label{fig:collections-gui}
-\end{figure}
-
-You can refine your scheme selection with the `standard collections' and
-`language collections' menus (figure~\ref{fig:collections-gui}, shown in
-\GUI\ mode for a change).
-
-Collections are one level more detailed than schemes\Dash in essence, a
-scheme consists of several collections, a collection consists of one or
-more packages, and a package (the lowest level grouping in \TL) contains
-the actual \TeX\ macro files, font files, and so on.
-
-If you want more control than the collection menus provide, you can use
-the \prog{tlmgr} program after installation (see
-section~\ref{sec:tlmgr}); using that, you can control the installation
-at the package level.
-
-\subsubsection{Directories}
-\label{sec:directories}
-
-The default layout is described in section~\ref{sec:texmftrees},
-\p.\pageref{sec:texmftrees}. The default location of
-\dirname{TEXDIR} is different between Windows
-(|%PROGRAMFILES%\texlive\2008|) and Unix
-(\dirname{/usr/local/texlive/2008}).
-
-The main reason to change this default is if you lack write permission
-for the default location. You don't have to be root or adminstrator to
-install \TL, but you do need write access to the target directory.
-
-A logical alternate choice is a directory under your home directory,
-especially if you will be the sole user. Use
-`|~|' to indicate this, as in `|~/texlive/2008|'.
-
-We recommend including the year in the name, to enable keeping different
-releases of \TL{} side by side. (You may wish to make a
-version-independent name such as \dirname{/usr/local/texlive-cur} via a
-symbolic link, which you can then update after testing the new release.)
-
-Changing \dirname{TEXDIR} in the installer will also change
-\dirname{TEXMFLOCAL}, \dirname{TEXMFSYSVAR} and
-\dirname{TEXMFSYSCONFIG}.
-
-\dirname{TEXMFHOME} is the recommended location for personal
-macro files or packages. The default value is |~/texmf|. In
-contrast to \dirname{TEXDIR}, here a |~| is preserved in the
-newly-written configuration files, since it usefully refers to the home
-directory of each individual running \TeX. It expands to
-\dirname{$HOME} on Unix and \verb|%USERPROFILE%| on Windows.
-
-\subsubsection{Options}
-\label{sec:options}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-<P> use letter size instead of A4 by default: [ ]
-<F> create all format files: [X]
-<D> install font/macro doc tree: [X]
-<S> install font/macro source tree: [X]
-<L> create symlinks in standard directories: [ ]
- binaries to:
- manpages to:
- info to:
-\end{boxedverbatim}
-\caption{Options menu (Unix)}\label{fig:options-text}
-\end{figure}
-
-Figure~\ref{fig:options-text} displays the text mode options menu.
-Three of the options here need mentioning:
-
-\begin{description}
-\item[use letter size instead of A4 by default:] The usual default paper
- size selection. Of course, individual documents can specify a specific
- paper size, if desired.
-
-\item[create all format files:] Although unnecessary format files
- take time to generate and disk space to store, it is still recommended
- to leave this option checked: if you don't, then format files will be
- generated in people's private \dirname{TEXMFVAR} tree as they are
- needed. In that location, they will not be updated automatically if
- (say) binaries or hyphenation patterns are updated in the
- installation, and thus could end up with incompatible format files.
-
-\item[create symlinks in standard directories] (Unix only):
- This option bypasses the need to change environment
- variables. Without this option, \TL{} directories have to be added
- to \envname{PATH}, \envname{MANPATH} and \envname{INFOPATH}. You will
- need write permissions to the target directories. It is not
- advisable to overwrite a \TeX\ system that came with your system
- with this option. It is intended primarily for creating the links
- in standard directories that are known to users, such as
- \dirname{/usr/local/bin}, which don't already contain any
- \TeX\ files.
-\end{description}
-
-Now when all these settings are to your liking, you can type `I' to
-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)}
-\label{sec:fromdvd}
-
-Type `|V|' to select this option. This changes the main menu into something
-like figure~\ref{fig:main-fromdvd}.
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
- <D> directories:
- TEXDIRW (Writable root):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
-
- <V> set up for installing to hard disk
-
-Other actions:
- <I> start installation for running from DVD
- <H> help
- <Q> quit
-\end{boxedverbatim}
-\caption{The main menu with \optname{from DVD}
- set}\label{fig:main-fromdvd}
-\end{figure}
-
-Note the changes: all options about what to install have
-disappeared, and the directories section now talks about
-\dirname{TEXDIRW} or writable root. The symlinks option has also
-disappeared.
-
-The installer will still create various directories and
-configuration files, but won't copy \dirname{texmf},
-\dirname{texmf-dist} or \dirname{texmf-doc} to hard disk.
-
-Post-install configuration for Unix will be slightly more complicated,
-because now the directory layout deviates from the default; see
-section~\ref{sec:postinstall}.
-
-Due to time constraints, this option didn't make it into the \GUI{}
-installer, but it is available both for Unix and for
-Windows. Windows users have to start the installer from a command
-prompt, see section~\ref{sec:cmdline}.
-
-Section \ref{sec:portable-unix} describes a more strictly portable
-way to run \TL, which doesn't make or require changes in the
-system's configuration, but doesn't allow any configuration either.
-
-\subsection{Command-line install options}
-\label{sec:cmdline}
-
-Type
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-for a listing of command-line options. Either |-| or |--| can be used
-to introduce option names. These are the more
-interesting ones:
-
-\begin{ttdescription}
-\item[-gui] If possible, use the \GUI{} installer. This requires the
- Perl/Tk module (\url{http://tug.org/texlive/distro.html#perltk});
- if Perl/Tk is not available, installation continues in text mode.
-\item[-no-gui] Force using the text mode installer, even under
- Windows; you'll need this if you want a `from \DVD' installation,
- since that is not available in \GUI{} mode.
-\item[-lang {\sl LL}] Specify the installer interface
- language as its standard two-letter code \textsl{LL}. Currently
- supported languages: English (\texttt{en}, default), German
- (\texttt{de}), French (\texttt{fr}), Dutch (\texttt{nl}), Polish
- (\texttt{pl}), Slovenian (\texttt{sl}) and Vietnamese
- (\texttt{vi}). The installer tries to determine the right language
- itself but if it fails, or if the right language is not available,
- then it uses English as a fallback.
-\item[-profile {\sl profile}] The installer always writes a file
- \filename{texlive.profile} to the \dirname{2008/tlpkg}- or
- \dirname{tlpkg} subdirectory of your installation. This option tells
- the installer to re-use such a profile file. Here's an excerpt:
- \begin{fverbatim}
-# texlive.profile written on Wed Jul 9 16:13:44 2008 UTC
-# It will NOT be updated and reflects only the
-# installation profile at installation time.
-selected_scheme scheme-basic
-TEXDIR /usr/local/texlive/2008
-TEXDIRW /usr/local/texlive/2008
-...
-TEXMFSYSVAR /usr/local/texlive/2008/texmf-var
-collection-basic 1
-...
-option_symlinks 0
- \end{fverbatim}
- Thus, using this option you can install in batch mode on
- subsequent systems, reproducing the choices you made for the
- original installation.
-\item [-location {\sl url/path}] Specify a non-default source for
- packages; see below.
-\end{ttdescription}
-
-\subsubsection{The \optname{location} parameter}
-\label{sec:location}
-
-The location value can be a url starting with \texttt{ftp:},
-\texttt{http:}, or \texttt{file:/} url, or a plain path. If the given
-argument is on a local drive (either a path or a \texttt{file:/} url),
-the installation type (compressed or live) is automatically determined:
-if an \dirname{archive} subdirectory with \filename{.tar.lzma} files is
-found then it will be used, even if uncompressed files are available as
-well.
-
-When giving an \texttt{http:} or \texttt{ftp:} location, trailing
-`\texttt{/}' characters and/or a trailing `\texttt{/tlpkg}' component
-are ignored. For example, you could choose a particular \CTAN\ mirror
-with something like:
-\url{http://ctan.example.org/tex-archive/texlive/tlnet/2008},
-substituting of course a proper hostname and its particular top-level
-\CTAN\ path (the list of \CTAN\ mirrors is maintained at
-\url{http://ctan.org/mirrors}) for |ctan.example.org/tex-archive|. The
-default is to pick a mirror automatically, using
-\url{http://mirror.ctan.org}; in any case, the chosen host is used for
-the entire download.
-
-
-\subsection{Post-install actions}
-\label{sec:postinstall}
-
-Some post-install may be required.
-
-\subsubsection{Windows}
-
-But on Windows, the installer takes care of everything.
-
-\subsubsection{If symlinks were created}
-
-If you elected to create symlinks in standard directories (mentioned in
-section~\ref{sec:options}), then there is no need to edit environment
-variables.
-
-\subsubsection{Environment variables for Unix}
-\label{sec:env}
-
-The directory of the binaries for your platform must be added to
-the search path. Each supported platform has its own subdirectory
-under \dirname{TEXDIR/bin}. See figure~\ref{fig:bin-text} for the
-list of subdirectories and corresponding platforms.
-
-You can also add the documentation man and Info directories to their
-respective search paths, if you want the system tools to find them.
-
-For Bourne-compatible shells such as \prog{bash}, and using Intel x86
-GNU/Linux and a default directory setup as an example, the file to edit
-might be \filename{$HOME/.profile} (or another file sourced by
-\filename{.profile}, and the lines to add would look like this:
-
-\begin{sverbatim}
-PATH=/usr/local/texlive/2008/bin/i386-linux:$PATH; export PATH
-MANPATH=/usr/local/texlive/2008/texmf/doc/man:$MANPATH; export MANPATH
-INFOPATH=/usr/local/texlive/2008/texmf/doc/info:$INFOPATH; export INFOPATH
-\end{sverbatim}
-
-For csh or tcsh, the file to edit is typically \filename{$HOME/.cshrc}, and
-the lines to add might look like:
-
-\begin{sverbatim}
-setenv PATH /usr/local/texlive/2008/bin/i386-linux:$PATH
-setenv MANPATH /usr/local/texlive/2008/texmf/doc/man:$MANPATH
-setenv INFOPATH /usr/local/texlive/2008/texmf/doc/info:$INFOPATH
-\end{sverbatim}
-
-Of course, you may well already have settings somewhere in your ``dot''
-files, and so then the \TL\ directories should simply be merged in as
-appropriate.
-
-\subsubsection{Environment variables: global configuration}
-\label{sec:envglobal}
-
-If you want to make these changes globally, or for a user newly added to
-the system, then you are on your own; there is just too much variation
-between systems in how and where these things are configured.
-
-Our two hints are: 1)~you may want to check for a file
-\filename{/etc/manpath.config} and, if present, add lines such as
-
-\begin{sverbatim}
-MANPATH_MAP /usr/local/texlive/2008/bin/i386-linux \
- /usr/local/texlive/2008/texmf/doc/man
-\end{sverbatim}
-
-And 2)~check for a file \filename{/etc/environment} which may define the
-search path and other default environment variables.
-
-
-\subsubsection{When running from DVD}
-
-Normally, a \TL{} program consults a file \filename{texmf.cnf} for the
-location of the various trees. It looks for this file in a series of
-locations relative to its own location. However, this scheme breaks down
-when a program is run from \DVD{}: the \DVD{} is read-only. Some of the
-paths to be recorded in \filename{texmf.cnf} are only known at
-installation time, so this file cannot be on the \DVD{} and must be
-placed somewhere else. This makes it necessary to define an environment
-\envname{TEXMFCNF} variable which tells \TL{} programs in what directory
-to find this \filename{texmf.cnf}. It is also still necessary to modify
-the \envname{PATH} environment variable, as described before.
-
-At the end of the installation, the installer should have printed a
-message giving the value to which \envname{TEXMFCNF} should be set. In
-case you missed it: this value is \dirname{$TEXMFSYSVAR/web2c}. For the
-default, \dirname{/usr/local/texlive/2008/texmf-var/web2c}, you need the
-lines
-\begin{sverbatim}
-TEXMFCNF=/usr/local/texlive/2008/texmf-var/web2c; export TEXMFCNF
-\end{sverbatim}
-or, for [t]csh:
-\begin{sverbatim}
-setenv TEXMFCNF /usr/local/texlive/2008/texmf-var/web2c
-\end{sverbatim}
-
-
-\subsubsection{\ConTeXt{} Mark IV}
-
-The `old' \ConTeXt{} should run out of the box. The new `Mark IV'
-\ConTeXt{} will require manual setup; see
-\url{http://wiki.contextgarden.net/Running_Mark_IV}.
-
-
-\subsubsection{Integrating local and personal macros}
-\label{sec:local-personal-macros}
-
-This is already mentioned implicitly in section~\ref{sec:texmftrees}:
-\dirname{TEXMFLOCAL} (by default,
-\dirname{/usr/local/texlive/texmf-local} or
-\verb|C:\Program Files\texlive\texmf-local|)
-
-is intended for system-wide local fonts and macros; and
-\dirname{TEXMFHOME} (by default, \dirname{$HOME/texmf} or
-\verb|%USERPROFILE%\texmf|), is for personal fonts and macros. These
-directories are intended to stick around from release to release, and
-have their content seen automatically by a new \TL{} release.
-Therefore, it is best to refrain from changing the definition of
-\dirname{TEXMFLOCAL} to be too far away from the main \TL{} directory,
-or you will need to manually change future releases.
-
-For both trees, files should be placed in their proper subdirectories;
-see \url{http://tug.org/tds} or consult
-\filename{texmf/web2c/texmf.cnf}. For instance, a \LaTeX{} class file or
-package should be placed in \dirname{TEXMFLOCAL/tex/latex} or
-\dirname{TEXMFHOME/tex/latex}, or a subdirectory thereof.
-
-\dirname{TEXMFLOCAL} requires an up-to-date filename database, or files
-will not be found. You can update it with the command
-\cmdname{mktexlsr} or use the `Reinit file database' button on the
-configuration tab of \prog{tlmgr} in \GUI\ mode.
-
-\subsubsection{Integrating third-party fonts}
-
-This is unfortunately a very complicated and messy topic. Forget
-about it unless you really know your way around blindfolded in a
-\TeX{} installation. Don't forget to check first what you get for
-free: see section~\ref{sec:tl-fonts}.
-
-A possible alternative is to use \XeTeX (see
-section~\ref{sec:tex-extensions}), which lets you use operating system
-fonts without any installation in \TeX.
-
-
-\subsection{Testing the installation}
-\label{sec:test-install}
-
-After installing \TL{} as best you can, you naturally want to test
-it out, so you can start creating beautiful documents and\slash or fonts.
-
-This section gives some basic procedures for testing that the new system
-is functional. We give Unix commands here; under \MacOSX{} and Windows,
-you're more likely to run the tests through a graphical interface, but
-the principles are the same.
-
-\begin{enumerate}
-
-\item Make sure that you can run the \cmdname{tex} program in the first
-place:
-
-\begin{alltt}
-> \Ucom{tex -{}-version}
-TeX 3.1415926 (Web2C 7.5.7)
-kpathsea version 3.5.7
-...
-\end{alltt}
-If this comes back with `command not found' instead of version and
-copyright information, or with an older version, most likely you don't
-have the correct \dirname{bin} subdirectory in your \envname{PATH}. See
-the environment-setting information on \p.\pageref{sec:env}.
-
-\item Process a basic \LaTeX{} file:
-\begin{alltt}
-> \Ucom{latex sample2e.tex}
-This is pdfeTeXk, Version 3.1415926...
-...
-Output written on sample2e.dvi (3 pages, 7484 bytes).
-Transcript written on sample2e.log.
-\end{alltt}
-If this fails to find \filename{sample2e.tex} or other files, most
-likely you have interference from old environment variables or
-configuration files; we recommend unsetting all \TeX-related environment
-variables for a start. (For a deep analysis, you can ask \TeX{} to
-report on exactly what it is searching for, and finding; see ``Debugging
-actions'' on page~\pageref{sec:debugging}.)
-
-\item Preview the result online:
-\begin{alltt}
-> \Ucom{xdvi sample2e.dvi}
-\end{alltt}
-(Under Windows, the analogous command is \cmdname{dviout}.) You should
-see a new window with a nice document explaining some of the basics of
-\LaTeX{}. (Well worth reading, by the way if you're new to the system.)
-You do have to be running under X for \cmdname{xdvi} to work; if you're
-not, or your \envname{DISPLAY} environment variable is set incorrectly,
-you'll get an error \samp{Can't open display}.
-
-\item Create a \PS{} file for printing or display:
-\begin{alltt}
-> \Ucom{dvips sample2e.dvi -o sample2e.ps}
-\end{alltt}
-
-\item Create a \acro{PDF} file instead of \dvi{}; this processes the
-\filename{.tex} file and writes \acro{PDF} directly:
-\begin{alltt}
-> \Ucom{pdflatex sample2e.tex}
-\end{alltt}
-
-\item Preview the \acro{PDF} file:
-\begin{alltt}
-> \Ucom{gv sample2e.pdf}
-\textrm{or:}
-> \Ucom{xpdf sample2e.pdf}
-\end{alltt}
-Unfortunately neither \cmdname{gv} nor \cmdname{xpdf} are currently
-included in \TL{}, so you must install them separately. See
-\url{http://www.gnu.org/software/gv} and
-\url{http://www.foolabs.com/xpdf}, respectively. (There are plenty of
-other \acro{PDF} viewers, too.)
-
-\item Standard test files you may find useful in addition to
-\filename{sample2e.tex}:
-
-\begin{ttdescription}
-\item [small2e.tex] A simpler document than \filename{sample2e}, to
-reduce the input size if you're having troubles.
-\item [testpage.tex] Test if your printer introduces any offsets.
-\item [nfssfont.tex] For printing font tables and tests.
-\item [testfont.tex] Also for font tables, but using plain \TeX{}.
-\item [story.tex] The most canonical (plain) \TeX{} test file of all.
-You must type \samp{\bs bye} to the \code{*} prompt after \samp{tex
-story.tex}.
-\end{ttdescription}
-
-\end{enumerate}
-
-If you are new to \TeX{}, or otherwise need help with actually writing
-\TeX{} or \LaTeX{} documents, please visit
-\url{http://tug.org/begin.html} for some introductory resources.
-
-
-\section{Network installations}
-\label{sec:netinstall}
-
-\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
-\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.
-
-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.
-
-You can read more about \TL{} configuration and path searching in
-section~\ref{sec:kpathsea}.
-
-\section{Maximally portable \protect\TL{} on DVD and USB}
-\label{sec:portable-unix}
-
-The `running from \DVD{}' option described in
-section~\ref{sec:fromdvd} is fine for your own system, but if you
-are a guest on somebody else's system then you would probably like
-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
-secondary shell\slash command prompt with environment settings suitable
-for directly accessing the \TL{} on the \DVD.
-
-When it runs for the first time, some files will be generated in a
-directory \dirname{~/.tlportable2008}, which will take a little time.
-On subsequent runs, though, it will start almost instantaneously.
-
-The rest of the system will be unaware of \TL. If you want your editor
-to be aware of this \TL, then you can start it from a second, parallel,
-such \filename{tl-portable} session.
-
-You can also use \filename{tl-portable} to run \TL{} on a
-\acro{USB} stick. In this case, copy all the top-level files and
-the contents of the \dirname{bin}, \dirname{texmf},
-\dirname{texmf-dist}, and \dirname{tlpkg} directories (at least) to
-the stick. This may take quite a while! If you are copying to a
-\acro{FAT}32-formatted \acro{USB} stick, make sure to dereference
-symbolic links (\code{cp -L}). A \dirname{texmf-local} directory on
-the stick will also be found and used.
-
-Then run \filename{tl-portable} from the root of the stick, as above.
-In this case, the script will notice that the stick is writable and use
-it for generated files. You could burn the resulting contents of the
-stick back to \DVD{} if that is more convenient to (for example) give to
-others.
-
-
-\section{\cmdname{tlmgr}: Managing your installation}
-\label{sec:tlmgr}
-
-\begin{figure}[tb]
-\tlpng{tlmgr-gui}{\linewidth}
-\caption{\prog{tlmgr} in \GUI\ mode. The list of
- packages/collections/schemes only shows up after clicking the
- `Load' button.}\label{fig:tlmgr-gui}
-\end{figure}
-
-\begin{figure}[tb]
-\tlpng{tlmgr-config}{\linewidth}
-\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:
-
-\begin{itemize*}
-\item listing schemes, collections and packages;
-\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 changing installation options such as paper size and source
- location (see section~\ref{sec:location}).
-\end{itemize*}
-\textit{Warning:} \prog{tlmgr} has not been designed for or tested
-with installations which run from \DVD.
-
-\subsection{\cmdname{tlmgr} GUI mode}
-\prog{tlmgr} can be started in \GUI{} mode with
-\begin{alltt}
-> \Ucom{tlmgr -gui}
-\end{alltt}
-or in Windows via the Start menu: \texttt{Start}, \texttt{Programs},
-\texttt{TeX Live 2008}, \texttt{TeX Live Manager}. After clicking `Load'
-it displays a list of available and installed packages\Dash the latter
-prepended with `(i)'. This assumes of course that the installation
-source is valid and reachable.
-
-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:
-
-\begin{alltt}
-> \Ucom{tlmgr -location http://172.16.18.1/tldev install collection-xetex xkeyval}
-\end{alltt}
-It generates the following output:
-\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/2008/texmf/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-config/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-dist/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-doc/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/../texmf-local/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-var/ls-R...
-mktexlsr: Done.
-regenerating fmtutil.cnf
-running fmtutil-sys --missing
-...
-Transcript written on xelatex.log.
-fmtutil: /usr/local/texlive/2008/texmf-var/web2c/xetex/xelatex.fmt installed.
-\end{fverbatim}
-As you 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.)
-
-This example installs a new language. This also triggers format
-regeneration:
-\begin{alltt}
-> \Ucom{tlmgr install collection-langdutch}
-\end{alltt}
-To describe a package:
-\begin{alltt}
-> \Ucom{tlmgr show collection-wintools}
-\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
-\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}
-\end{alltt}
-
-
-\section{Notes on Windows}
-\label{sec:windows}
-
-\TL\ has a single installer which runs on both Windows and Unix. This
-was only possible by dropping support for older Windows versions, so
-\TL\ can now be installed only on Windows 2000 and later.
-
-
-\subsection{Windows-specific features}
-\label{sec:winfeatures}
-
-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.
-\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
- this.
-\end{description}
-
-\subsection{Additional included software}
-
-\begin{figure}[tb]
-\tlpng{psview}{.6\linewidth}
-\caption{PS\_View: very high magnifications available!}\label{fig:psview}
-\end{figure}
-
-To be complete, a \TL installation needs support packages that are not
-commonly found on a Windows machine. \TL{} provides the missing
-pieces:
-\begin{description}
-\item[Perl and Ghostscript.] Because of the importance of Perl and
- 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
- shouldn't interfere with any system installations of Perl or
- Ghostscript.
-\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
- \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}
-
-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.
-
-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.
-
-\subsection{Links for additional downloadable software}
-
-Urls for some other tools you may consider installing:
-\begin{description}
-\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/}
-\item[Perl] \url{http://www.perl.org/} with
- supplementary packages from \acro{CPAN}, \url{http://www.cpan.org/}
-\item[ImageMagick] \url{http://www.imagemagick.com}, for graphics
- processing and conversion
-\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:
- \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}.
- \end{itemize*}
-\end{description}
-
-
-\subsection{User Profile is Home}
-\label{sec:winhome}
-
-The Windows counterpart of a Unix home directory is the
-\verb|%USERPROFILE%| directory. Under Windows 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
-appropriately on both Windows and Unix.
-
-
-\subsection{The Windows registry}
-\label{sec:registry}
-
-Windows stores nearly all configuration data in its registry. The
-registry contains a set of hierarchically organized keys, with several
-root keys. The most important ones for installation programs are
-\path{HKEY_CURRENT_USER} and \path{HKEY_LOCAL_MACHINE}, \path{HKCU} and
-\path{HKLM} in short. The \path{HKCU} part of the registry is in the
-user's home directory (see section~\ref{sec:winhome}). \path{HKLM} is
-normally in a subdirectory of the Windows directory.
-
-In some cases, system information could be obtained from environment
-variables but for other information, for example the location of
-shortcuts, it is necessary to consult the registry. Setting environment
-variables permanently also requires registry access.
-
-
-\subsection{Windows permissions}
-\label{sec:winpermissions}
-
-In later versions of Windows, a distinction is made between regular
-users and administrators, where only the latter have free access to the
-entire operating system. In practice, though, you could better describe
-these classes of users as unprivileged users and normal users: being an
-administrator is the rule, not the exception. Nevertheless, we have made
-an effort to make \TL{} installable without administrative privileges.
-
-If the user is an administrator, shortcuts are created for all users,
-and the system environment is modified. Otherwise, shortcuts and menu
-entries are created for the current user, and the user environment is
-modified. Use the \optname{non-admin} option to \prog{install-tl} if
-you prefer per-user settings even as an administrator.
-
-Regardless of administrator status, the default root of \TL{} proposed
-by the installer is always under \verb|%PROGRAMFILES%|. The installer
-always tests whether the root is writable for the current user.
-
-A problem may arise if the user is not an administrator and \TeX{}
-already exists in the search path. Since the effective path consists of
-the system path followed by the user path, the new \TL{} will never get
-precedence. As a workaround, in this case the installer creates
-shortcuts to the command-prompt in which the new \TL{} binary directory
-is prepended to the local searchpath. The new \TL{} will be usable when
-run in a command-line session started from such a shortcut.
-
-
-\section{A user's guide to Web2C}
-
-\Webc{} is an integrated collection of \TeX-related programs: \TeX{}
-itself, \MF{}, \MP, \BibTeX{}, etc. It is the heart of \TL{}. The home
-page for \Webc{}, with the current manual and more, is
-\url{http://tug.org/web2c}.
-
-A bit of history: The original implementation was by Tomas Rokicki who,
-in 1987, developed a first \TeX{}-to-C system based on change files
-under Unix, which were primarily the original work of Howard Trickey and
-Pavel Curtis. Tim Morgan became the maintainer of the system, and
-during this period the name changed to Web-to-C\@. In 1990, Karl Berry
-took over the work, assisted by dozens of additional contributors, and
-in 1997 he handed the baton to Olaf Weber, who returned it to Karl in
-2006.
-
-The \Webc{} system runs on Unix, 32-bit Windows systems, \MacOSX{}, and
-other operating systems. It uses Knuth's original sources for \TeX{} and
-other basic programs written in the \web{} literate programming system
-and translates them into C source code. The core \TeX{} programs
-handled in this way are:
-
-\begin{cmddescription}
-\item[bibtex] Maintaining bibliographies.
-\item[dmp] \cmdname{troff} to MPX (\MP{} pictures).
-\item[dvicopy] Expands virtual font references in \dvi{} files.
-\item[dvitomp] \dvi{} to MPX (MetaPost pictures).
-\item[dvitype] \dvi{} to human-readable text.
-\item[gftodvi] Generic font proofsheets.
-\item[gftopk] Generic to packed fonts.
-\item[gftype] GF to human-readable text.
-\item[makempx] \MP{} label typesetting.
-\item[mf] Creating typeface families.
-\item[mft] Prettyprinting \MF{} source.
-\item[mpost] Creating technical diagrams.
-\item[mpto] MetaPost label extraction.
-\item[newer] Compare modification times.
-\item[patgen] Creating hyphenation patterns.
-\item[pktogf] Packed to generic fonts.
-\item[pktype] PK to human-readable text.
-\item[pltotf] Plain text property list to TFM.
-\item[pooltype] Display \web{} pool files.
-\item[tangle] \web{} to Pascal.
-\item[tex] Typesetting.
-\item[tftopl] TFM to plain text property list.
-\item[vftovp] Virtual font to virtual property list.
-\item[vptovf] Virtual property list to virtual font.
-\item[weave] \web{} to \TeX.
-\end{cmddescription}
-
-\noindent The precise functions and syntax of these programs are
-described in the documentation of the individual packages and of \Webc{}
-itself. However, knowing a few principles governing the whole family of
-programs will help you take advantage of your \Webc{} installation.
-
-All programs honor these standard \GNU options:
-\begin{ttdescription}
-\item[-{}-help] print basic usage summary.
-\item[-{}-verbose] print detailed progress report.
-\item[-{}-version] print version information, then exit.
-\end{ttdescription}
-
-For locating files the \Webc{} programs use the path searching library
-\KPS{} (\url{http://tug.org/kpathsea}). This library uses a combination
-of environment variables and a configuration files to optimize searching
-the (huge) collection of \TeX{} files. \Webc{} can look at many
-directory trees simultaneously, which is useful in maintaining \TeX's
-standard distribution and local and personal extensions in distinct
-trees. To speed up file searches, the root of each tree has a file
-\file{ls-R}, containing an entry showing the name and relative pathname
-for all files under that root.
-
-
-\subsection{Kpathsea path searching}
-\label{sec:kpathsea}
-
-Let us first describe the generic path searching mechanism of the \KPS{}
-library.
-
-We call a \emph{search path} a colon- or semicolon\hyph sepa\-rated list
-of \emph{path elements}, which are basically directory names. A
-search path can come from (a combination of) many sources. To look up
-a file \samp{my-file} along a path \samp{.:/dir}, \KPS{} checks each
-element of the path in turn: first \file{./my-file}, then
-\file{/dir/my-file}, returning the first match (or possibly all
-matches).
-
-In order to adapt optimally to all operating systems' conventions, on
-non-Unix systems \KPS{} can use filename separators different from
-colon (\samp{:}) and slash (\samp{/}).
-
-To check a particular path element \var{p}, \KPS{} first checks if a
-prebuilt database (see ``Filename data\-base'' on
-page~\pageref{sec:filename-database}) applies to \var{p}, i.e., if the
-database is in a directory that is a prefix of \var{p}. If so, the path
-specification is matched against the contents of the database.
-
-If the database does not exist, or does not apply to this path
-element, or contains no matches, the filesystem is searched (if this
-was not forbidden by a specification starting with \samp{!!}\ and if
-the file being searched for must exist). \KPS{} constructs the list
-of directories that correspond to this path element, and then checks
-in each for the file being sought.
-
-The ``file must exist'' condition comes into play with \samp{.vf} files and
-input files read by \TeX's \cs{openin} command. Such files may not
-exist (e.g., \file{cmr10.vf}), and so it would be wrong to search the
-disk for them. Therefore, if you fail to update \file{ls-R} when you
-install a new \samp{.vf} file, it will never be found.
-Each path element is checked in turn: first the database, then the
-disk. If a match is found, the search stops and the result is
-returned.
-
-Although the simplest and most common path element is a directory
-name, \KPS{} supports additional features in search paths: layered
-default values, environment variable names, config file values, users'
-home directories, and recursive subdirectory searching. Thus, we say
-that \KPS{} \emph{expands} a path element, meaning it transforms all
-the specifications into basic directory name or names. This is
-described in the following sections in the same order as it takes
-place.
-
-Note that if the filename being searched for is absolute or explicitly
-relative, i.e., starts with \samp{/} or \samp{./} or \samp{../},
-\KPS{} simply checks if that file exists.
-
-\ifSingleColumn
-\else
-\begin{figure*}
-\verbatiminput{examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{An illustrative configuration file sample}
- \label{fig:config-sample}
-\end{figure*}
-\fi
-
-\subsubsection{Path sources}
-\label{sec:path-sources}
-
-A search path can come from many sources. In the order in which
-\KPS{} uses them:
-
-\begin{enumerate}
-\item
- A user-set environment variable, for instance, \envname{TEXINPUTS}\@.
- Environment variables with a period and a program name appended
- override; e.g., if \samp{latex} is the name of the program being run,
- then \envname{TEXINPUTS.latex} will override \envname{TEXINPUTS}.
-\item
- A program-specific configuration file, for exam\-ple, a line
- \samp{S /a:/b} in \cmdname{dvips}'s \file{config.ps}.
-\item A \KPS{} configuration file \file{texmf.cnf}, containing a line like
- \samp{TEXINPUTS=/c:/d} (see below).
-\item The compile-time default.
-\end{enumerate}
-\noindent You can see each of these values for a given search path by
-using the debugging options (see ``Debugging actions'' on
-page~\pageref{sec:debugging}).
-
-\subsubsection{Config files}
-
-\begingroup\tolerance=3500
-\KPS{} reads \emph{runtime configuration files} named \file{texmf.cnf}
-for search path and other definitions. The search path used to look
-for these files is named \envname{TEXMFCNF} (by default such a file lives
-in the \file{texmf/web2c} subdirectory). \emph{All}
-\file{texmf.cnf} files in the search path will be read and definitions
-in earlier files override those in later files. Thus, with a search
-path of \verb|.:$TEXMF|, values from \file{./texmf.cnf} override those
-from \verb|$TEXMF/texmf.cnf|.
-\endgroup
-
-\begin{itemize}
-\item
- Comments start with \code{\%} and continue to the end of the line.
-\item
- Blank lines are ignored.
-\item
- A \bs{} at the end of a line acts as a continuation character,
- i.e., the next line is appended. Whitespace at the beginning of
- continuation lines is not ignored.
-\item
- Each remaining line has the form:
-\begin{alltt}
- \var{variable}[.\var{progname}] [=] \var{value}
-\end{alltt}%
- where the \samp{=} and surrounding whitespace are optional.
-\item
- The \ttvar{variable} name may contain any character other
- than whitespace, \samp{=}, or \samp{.}, but sticking to
- \samp{A-Za-z\_} is safest.
-\item
- If \samp{.\var{progname}} is present, the definition only
- applies if the program that is running is named
- \texttt{\var{progname}} or \texttt{\var{progname}.exe}. This allows
- different flavors of \TeX{} to have different search paths, for
- example.
-\item \var{value} may contain any characters except
- \code{\%} and \samp{@}. The
- \code{\$\var{var}.\var{prog}} feature is not available on the
- right-hand side; instead, you must use an additional variable. A
- \samp{;}\ in \var{value} is translated to \samp{:}\ if
- running under Unix; this is useful to be able to have a single
- \file{texmf.cnf} for Unix, \acro{MS-DOS} and Windows systems.
-\item
- All definitions are read before anything is expanded, so
- variables can be referenced before they are defined.
-\end{itemize}
-A configuration file fragment illustrating most of these points is
-\ifSingleColumn
-shown below:
-
-\verbatiminput{examples/ex5.tex}
-\else
-shown in Figure~\ref{fig:config-sample}.
-\fi
-
-\subsubsection{Path expansion}
-\label{sec:path-expansion}
-
-
-\KPS{} recognizes certain special characters and constructions in
-search paths, similar to those available in Unix shells. As a
-general example, the complex path,
-\verb+~$USER/{foo,bar}//baz+, expands to all subdirectories under
-directories \file{foo} and \file{bar} in \texttt{\$USER}'s home
-directory that contain a directory or file \file{baz}. These
-expansions are explained in the sections below.
-%$
-\subsubsection{Default expansion}
-\label{sec:default-expansion}
-
-\tolerance=2500
-If the highest-priority search path (see ``Path sources'' on
-page~\pageref{sec:path-sources}) contains an \emph{extra colon} (i.e.,
-leading, trailing, or doubled), \KPS{} inserts at that point the
-next-highest-prio\-rity search path that is defined. If that inserted
-path has an extra colon, the same happens with the next highest. For
-example, given an environment variable setting
-
-\tolerance=1500
-
-\begin{alltt}
-> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
-and a \code{TEXINPUTS} value from \file{texmf.cnf} of
-
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
-then the final value used for searching will be:
-
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-
-Since it would be useless to insert the default value in more than one
-place, \KPS{} changes only one extra \samp{:}\ and leaves any others in
-place. It checks first for a leading \samp{:}, then a trailing
-\samp{:}, then a doubled \samp{:}.
-
-\subsubsection{Brace expansion}
-
-A useful feature is brace expansion, which means that, for instance,
-\verb+v{a,b}w+ expands to \verb+vaw:vbw+. Nesting is allowed.
-This is used to implement multiple \TeX{} hierarchies, by
-assigning a brace list to \code{\$TEXMF}.
-For example, in \file{texmf.cnf}, the following definition
-(appproximately; there are actually even more trees) is made:
-\begin{verbatim}
- TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN}
-\end{verbatim}
-Using this you can then write something like
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-%$
-which means that, after looking in the current directory, the
-\code{\$TEXMFHOME/tex}, \code{\$TEXMFLOCAL/tex}, \code{\$TEXMFVAR/tex}
-and \code{\$TEXMFMAIN/tex} trees \emph{only}) will be searched (the
-last two use using \file{ls-R} data base files). It is a convenient
-way for running two parallel \TeX{} structures, one ``frozen'' (on a
-\CD, for instance) and the other being continuously updated with new
-versions as they become available. By using the \code{\$TEXMF}
-variable in all definitions, one is sure to always search the
-up-to-date tree first.
-
-\subsubsection{Subdirectory expansion}
-\label{sec:subdirectory-expansion}
-
-Two or more consecutive slashes in a path element following a directory
-\var{d} is replaced by all subdirectories of \var{d}: first those
-subdirectories directly under \var{d}, then the subsubdirectories under
-those, and so on. At each level, the order in which the directories are
-searched is \emph{unspecified}.
-
-If you specify any filename components after the \samp{//}, only
-subdirectories with matching components are included. For example,
-\samp{/a//b} expands into directories \file{/a/1/b}, \file{/a/2/b},
-\file{/a/1/1/b}, and so on, but not \file{/a/b/c} or \file{/a/1}.
-
-Multiple \samp{//} constructs in a path are possible, but
-\samp{//} at the beginning of a path is ignored.
-
-\subsubsection{List of special characters and their meaning: a summary}
-
-The following list summarizes the special characters in \KPS{}
-configuration files.
-
-% need a wider space for the item labels here.
-\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
-\begin{ttdescription}
-\item[\CODE{:}] Separator in path specification; at the beginning or
- the end of a path it substitutes the default path expansion.\par
-\item[\CODE{;}] Separator on non-Unix systems (acts like \code{:}).
-\item[\CODE{\$}] Variable expansion.
-\item[\CODE{\string~}] Represents the user's home directory.
-\item[\CODE{\char`\{...\char`\}}] Brace expansion.
-\item[\CODE{//}] Subdirectory expansion (can occur anywhere in
- a path, except at its beginning).
-\item[\CODE{\%}] Start of comment.
-\item[\CODE{\bs}] Continuation character (allows multi-line entries).
-\item[\CODE{!!}] Search \emph{only} database to locate file, \emph{do
- not} search the disk.
-\end{ttdescription}
-
-
-\subsection{Filename databases}
-\label{sec:filename-database}
-
-\KPS{} goes to some lengths to minimize disk accesses for searches.
-Nevertheless, at installations with enough directories, searching each
-possible directory for a given file can take an excessively long time
-(this is especially true if many hundreds of font directories have to
-be traversed.) Therefore, \KPS{} can use an externally-built plain text
-``database'' file named \file{ls-R} that maps files to directories,
-thus avoiding the need to exhaustively search the disk.
-
-A second database file \file{aliases} allows you to give additional
-names to the files listed in \file{ls-R}. This can be helpful to
-confirm to \acro{DOS} 8.3 filename conventions in source files.
-
-\subsubsection{The filename database}
-\label{sec:ls-R}
-
-As explained above, the name of the main filename database must be
-\file{ls-R}. You can put one at the root of each \TeX{} hierarchy in
-your installation that you wish to be searched (\code{\$TEXMF} by
-default); most sites have only one hierarchy. \KPS{} looks for
-\file{ls-R} files along the \code{TEXMFDBS} path.
-
-The recommended way to create and maintain \samp{ls-R} is to run the
-\code{mktexlsr} script included with the distribution. It is invoked
-by the various \samp{mktex}\dots\ scripts. In principle, this script
-just runs the command
-\begin{alltt}
-cd \var{/your/texmf/root} && \path|\|ls -1LAR ./ >ls-R
-\end{alltt}
-presuming your system's \code{ls} produces the right output format
-(\GNU \code{ls} is all right). To ensure that the database is
-always up-to-date, it is easiest to rebuild it regularly via
-\code{cron}, so that it is automatically updated when the installed
-files change, such as after installing or updating a \LaTeX{} package.
-
-If a file is not found in the database, by default \KPS{} goes ahead
-and searches the disk. If a particular path element begins with
-\samp{!!}, however, \emph{only} the database will be searched for that
-element, never the disk.
-
-
-\subsubsection{kpsewhich: Standalone path searching}
-\label{sec:invoking-kpsewhich}
-
-The \texttt{kpsewhich} program exercises path searching independent of any
-particular application. This can be useful as a sort of \code{find}
-program to locate files in \TeX{} hierarchies (this is used heavily in
-the distributed \samp{mktex}\dots\ scripts).
-
-\begin{alltt}
-> \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}}
-\end{alltt}
-The options specified in \ttvar{option} start with either \samp{-}
-or \samp{-{}-}, and any unambiguous abbreviation is accepted.
-
-\KPS{} looks up each non-option argument on the command line as a
-filename, and returns the first file found. There is no option to
-return all the files with a particular name (you can run the Unix
-\samp{find} utility for that).
-
-The most common options are described next.
-
-\begin{ttdescription}
-\item[\texttt{-{}-dpi=\var{num}}]\mbox{}
- Set the resolution to \ttvar{num}; this only affects \samp{gf}
- and \samp{pk} lookups. \samp{-D} is a synonym, for compatibility
- with \cmdname{dvips}. Default is 600.
-
-\item[\texttt{-{}-format=\var{name}}]\mbox{}\\
- Set the format for lookup to \ttvar{name}. By default, the
- format is guessed from the filename. For formats which do not have
- an associated unambiguous suffix, such as \MP{} support files and
- \cmdname{dvips} configuration files, you have to specify the name as
- known to \KPS{}, such as \texttt{tex} or \texttt{enc files}. Run
- \texttt{kpsewhich -{}-help} for a list.
-
-\item[\texttt{-{}-mode=\var{string}}]\mbox{}\\
- Set the mode name to \ttvar{string}; this only affects \samp{gf}
- and \samp{pk} lookups. No default: any mode will be found.
-\item[\texttt{-{}-must-exist}]\mbox{}\\
- Do everything possible to find the files, notably including
- searching the disk. By default, only the \file{ls-R} database is
- checked, in the interest of efficiency.
-\item[\texttt{-{}-path=\var{string}}]\mbox{}\\
- Search along the path \ttvar{string} (colon-separated as usual),
- instead of guessing the search path from the filename. \samp{//} and
- all the usual expansions are supported. The options \samp{-{}-path}
- and \samp{-{}-format} are mutually exclusive.
-\item[\texttt{-{}-progname=\var{name}}]\mbox{}\\
- Set the program name to \texttt{\var{name}}.
- This can affect the search paths via the \texttt{.\var{progname}}
- feature.
- The default is \cmdname{kpsewhich}.
-\item[\texttt{-{}-show-path=\var{name}}]\mbox{}\\
- shows the path used for file lookups of file type \texttt{\var{name}}.
- Either a filename extension (\code{.pk}, \code{.vf}, etc.) or a
- name can be used, just as with \samp{-{}-format} option.
-\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\
- sets the debugging options to \texttt{\var{num}}.
-\end{ttdescription}
-
-
-\subsubsection{Examples of use}
-\label{sec:examples-of-use}
-
-Let us now have a look at \KPS{} in action. Here's a straightforward search:
-
-\begin{alltt}
-> \Ucom{kpsewhich article.cls}
- /usr/local/texmf-dist/tex/latex/base/article.cls
-\end{alltt}
-We are looking for the file \file{article.cls}. Since the \samp{.cls}
-suffix is unambiguous we do not need to specify that we want to look for a
-file of type \optname{tex} (\TeX{} source file directories). We find it in
-the subdirectory \file{tex/latex/base} below the \samp{texmf-dist} \TL\
-directory. Similarly, all of the following are found without problems
-thanks to their unambiguous suffix.
-\begin{alltt}
-> \Ucom{kpsewhich array.sty}
- /usr/local/texmf-dist/tex/latex/tools/array.sty
-> \Ucom{kpsewhich latin1.def}
- /usr/local/texmf-dist/tex/latex/base/latin1.def
-> \Ucom{kpsewhich size10.clo}
- /usr/local/texmf-dist/tex/latex/base/size10.clo
-> \Ucom{kpsewhich small2e.tex}
- /usr/local/texmf-dist/tex/latex/base/small2e.tex
-> \Ucom{kpsewhich tugboat.bib}
- /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-By the way, that last is a \BibTeX{} bibliography database for \textsl{TUGBoat} articles.
-
-\begin{alltt}
-> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
-Font bitmap glyph files of type \file{.pk} are used by display
-programs like \cmdname{dvips} and \cmdname{xdvi}. Nothing is returned in
-this case since there are no pre-generated Computer Modern \samp{.pk}
-files in \TL{}\Dash the Type~1 variants are used by default.
-\begin{alltt}
-> \Ucom{kpsewhich wsuipa10.pk}
-\ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
-\else /usr/local/texmf-var/fonts/pk/ljfour/public/
-... wsuipa/wsuipa10.600pk
-\fi\end{alltt}
-For these fonts (a phonetic alphabet from the University of Washington)
-we had to generate \samp{.pk} files, and since the default \MF{} mode on
-our installation is \texttt{ljfour} with a base resolution of 600\dpi{}
-(dots per inch), this instantiation is returned.
-\begin{alltt}
-> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
-\end{alltt}
-In this case, when specifying that we are interested in a resolution
-of 300\dpi{} (\texttt{-dpi=300}) we see that no such font is available on
-the system. A program like \cmdname{dvips} or \cmdname{xdvi} would
-go off and actually build the required \texttt{.pk} files
-using the script \cmdname{mktexpk}.
-
-Next we turn our attention to \cmdname{dvips}'s header and configuration
-files. We first look at one of the commonly used files, the general
-prologue \file{tex.pro} for \TeX{} support, before turning our attention
-to the generic configuration file (\file{config.ps}) and the \PS{} font
-map \file{psfonts.map}\Dash as of 2004, map and encoding files have
-their own search paths and new location in \dirname{texmf} trees. As
-the \samp{.ps} suffix is ambiguous we have to specify explicitly which
-type we are considering (\optname{dvips config}) for the file
-\texttt{config.ps}.
-\begin{alltt}
-> \Ucom{kpsewhich tex.pro}
- /usr/local/texmf/dvips/base/tex.pro
-> \Ucom{kpsewhich --format="dvips config" config.ps}
- /usr/local/texmf/dvips/config/config.ps
-> \Ucom{kpsewhich psfonts.map}
- /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map
-\end{alltt}
-
-We now take a closer look at the \acro{URW} Times \PS{} support
-files. The prefix for these in the standard font naming scheme is
-\samp{utm}. The first file we look at is the configuration file,
-which contains the name of the map file:
-\begin{alltt}
-> \Ucom{kpsewhich --format="dvips config" config.utm}
- /usr/local/texmf-dist/dvips/psnfss/config.utm
-\end{alltt}
-The contents of that file is
-\begin{alltt}
- p +utm.map
-\end{alltt}
-which points to the file \file{utm.map}, which we want to
-locate next.
-\begin{alltt}
-> \Ucom{kpsewhich utm.map}
- /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
-\end{alltt}
-This map file defines the file names of the Type~1 \PS{} fonts in
-the URW collection. Its contents look like (we only show part of the
-lines):
-\begin{alltt}
-utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
-utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
-utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
-Let us, for instance, take the Times Roman instance
-\file{utmr8a.pfb} and find its position in the \file{texmf} directory
-tree with a search for Type~1 font files:
-\begin{alltt}
-> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
-\else /usr/local/texmf-dist/fonts/type1/
-... urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
-It should be evident from these examples how you can easily locate the
-whereabouts of a given file. This is especially important if you suspect
-that the wrong version of a file is picked up somehow, since
-\cmdname{kpsewhich} will show you the first file encountered.
-
-\subsubsection{Debugging actions}
-\label{sec:debugging}
-
-Sometimes it is necessary to investigate how a program resolves file
-references. To make this practical, \KPS{} offers various levels of
-debugging output:
-
-\begin{ttdescription}
-\item[\texttt{\ 1}] \texttt{stat} calls (disk lookups). When running
- with an up-to-date \file{ls-R} database this should almost give no
- output.
-\item[\texttt{\ 2}] References to hash tables (such as \file{ls-R}
- databases, map files, configuration files).
-\item[\texttt{\ 4}] File open and close operations.
-\item[\texttt{\ 8}] General path information for file types
- searched by \KPS. This is useful to find out where a particular
- path for the file was defined.
-\item[\texttt{16}] Directory list for each path element (only relevant
- for searches on disk).
-\item[\texttt{32}] File searches.
-\item[\texttt{64}] Variable values.
-\end{ttdescription}
-A value of \texttt{-1} will set all the above options; in practice,
-this is usually the most convenient.
-
-Similarly, with the \cmdname{dvips} program, by setting a combination of
-debug switches, one can follow in detail where files are being picked up
-from. Alternatively, when a file is not found, the debug trace shows in
-which directories the program looks for the given file, so that one can
-get an indication what the problem~is.
-
-Generally speaking, as most programs call the \KPS{} library
-internally, one can select a debug option by using the
-\envname{KPATHSEA\_DEBUG} environment variable, and setting it to (a
-combination of) values as described in the above list.
-
-(Note for Windows users: it is not easy to redirect
-all messages to a file in this system. For diagnostic purposes
-you can temporarily \texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log}).
-
-Let us consider, as an example, a small \LaTeX{} source file,
-\file{hello-world.tex}, which contains the following input.
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
-This little file only uses the font \file{cmr10}, so let us look at
-how \cmdname{dvips} prepares the \PS{} file (we want to use the Type~1
-version of the Computer Modern fonts, hence the option \texttt{-Pcms}).
-\begin{alltt}
-> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
-In this case we have combined \cmdname{dvips}'s debug class 4 (font
-paths) with \KPS's path element expansion (see \cmdname{dvips} Reference
-Manual, \OnCD{texmf/doc/dvips/dvips.pdf}).
-The output (slightly rearranged) appears in
-Figure~\ref{fig:dvipsdbga}.
-\begin{figure*}[tp]
-\centering
-\input{examples/ex6a.tex}
-\caption{Finding configuration files}\label{fig:dvipsdbga}
-
-\bigskip
-
-\input{examples/ex6b.tex}
-\caption{Finding the prolog file}\label{fig:dvipsdbgb}
-
-\bigskip
-
-\input{examples/ex6c.tex}
-\caption{Finding the font file}\label{fig:dvipsdbgc}
-\end{figure*}
-
-\cmdname{dvips} starts by locating its working files. First,
-\file{texmf.cnf} is found, which gives the definitions of the search
-paths for the other files, then the file database \file{ls-R} (to
-optimize file searching) and the file \file{aliases}, which makes it
-possible to declare several names (e.g., a short \acro{DOS}-like 8.3 and
-a more natural longer version) for the same file. Then \cmdname{dvips}
-goes on to find the generic configuration file \file{config.ps}
-before looking for the customization file \file{.dvipsrc} (which, in
-this case is \emph{not found}). Finally, \cmdname{dvips} locates the
-config file for the Computer Modern \PS{} fonts \file{config.cms}
-(this was initiated with the \texttt{-Pcms} option on the \cmdname{dvips}
-command). This file contains the list of the map files which
-define the relation between the \TeX{}, \PS{} and file system
-names of the fonts.
-\begin{alltt}
-> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
- p +ams.map
- p +cms.map
- p +cmbkm.map
- p +amsbkm.map
-\end{alltt}
-\cmdname{dvips} thus goes on to find all these files, plus the generic
-map file \file{psfonts.map}, which is always loaded (it contains
-declarations for commonly used \PS{} fonts; see the last part of
-Section \ref{sec:examples-of-use} for more details about \PS{} map
-file handling).
-
-At this point \cmdname{dvips} identifies itself to the user:
-\begin{alltt}
-This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com)
-\end{alltt}
-\ifSingleColumn
-Then it goes on to look for the prolog file \file{texc.pro}:
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
-Then it goes on to look for the prolog file \file{texc.pro} (see
-Figure~\ref{fig:dvipsdbgb}).
-\fi
-
-After having found the file in question, \cmdname{dvips} outputs
-the date and time, and informs us that it will generate the
-file \file{hello-world.ps}, then that it needs the font file
-\file{cmr10}, and that the latter is declared as ``resident'' (no
-bitmaps needed):
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
-Now the search is on for the file \file{cmr10.tfm}, which is found,
-then a few more prolog files (not shown) are referenced, and finally
-the Type~1 instance \file{cmr10.pfb} of the font is located and
-included in the output file (see last line).
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-\subsection{Runtime options}
-
-Another useful feature of \Webc{} is its possibility to control a number
-of memory parameters (in particular, array sizes) via the runtime file
-\file{texmf.cnf} read by \KPS{}. The memory settings can be found in
-Part 3 of that file in the \TL{} distribution. The more important
-are:
-
-\begin{ttdescription}
-\item[\texttt{main\_memory}]
- Total words of memory available, for
- \TeX{}, \MF{} and \MP. You must make a new format file for each
- different setting. For instance, you could generate a ``huge''
- version of \TeX{}, and call the format file \texttt{hugetex.fmt}.
- Using the standard way of specifying the program name used by \KPS{},
- the particular value of the \texttt{main\_memory} variable will then
- be read from \file{texmf.cnf}.
-\item[\texttt{extra\_mem\_bot}]
- Extra space for ``large'' \TeX{} data structures:
- boxes, glue, breakpoints, etc. Especially useful if you use
- \PiCTeX{}.
-\item[\texttt{font\_mem\_size}]
- Number of words for font information available for \TeX. This
- is more or less the total size of all \acro{TFM} files read.
-\item[\texttt{hash\_extra}]
- Additional space for the hash table of control sequence names.
- Only $\approx$10,000 control sequences can be stored in the main
- hash table; if you have a large book with numerous cross-references,
- this might not be enough. The default value of
- \texttt{hash\_extra} is \texttt{50000}.
-\end{ttdescription}
-
-\noindent Of course, this facility is no substitute for truly dynamic
-arrays and memory allocation, but since these are extremely difficult to
-implement in the present \TeX{} source, these runtime parameters provide
-a practical compromise allowing some flexibility.
-
-
-\begin{comment}
-\section{Building on a new Unix platform}
-
-If you have a platform for which executables are not included, you will
-need to compile \TeX{} and friends. This is not as hard as it
-sounds. What you need is all in the directory \texttt{source} in the
-distribution.
-
-\subsection{Prerequisites}
-
-You will need at least 100 megabytes of disk space to compile all of
-\TeX{} and its support programs. You'll also need an \acro{ANSI} C
-compiler, a \cmdname{make} utility, a lexical scanner, and a parser
-generator. We recommend the \GNU version of these programs
-(\cmdname{gcc}, \GNU \cmdname{make}, \cmdname{m4}, \cmdname{flex},
-\cmdname{bison}). You may be able to work with other C compilers and
-\cmdname{make} programs, but you will need a good understanding of
-building Unix programs to sort out problems.
-
-Also, the command \texttt{uname} must return a sensible value.
-
-
-\subsection{Configuration}
-
-To begin, perform a normal installation of \TL{} to your disk (see
-section~\ref{sec:install-disk} on
-\p.\pageref{sec:install-disk}). You may wish to skip installing
-all of the prebuilt binaries.
-
-Then, unpack the source from the compressed \texttt{tar} file in the
-directory \dirname{source} to your disk and change directory to where
-you placed it.
-
-Next, run \cmdname{configure} with a command line like this:
-\begin{alltt}
-> \Ucom{sh configure -prefix=/usr/local/TeX}
-\end{alltt}
-
-The \optname{-prefix} directory is the one where you installed the
-support tree; the directory layout will be as follows (where \$TEXDIR
-stands for the directory you chose):
-
-\noindent
-\begin{tabular}{>{\ttfamily}ll@{}}
- \dirname{$TEXDIR/share/texmf} & main tree with fonts,\\
- & \qquad macros, etc\\
- \dirname{$TEXDIR/man} & Unix manual pages\\
- \dirname{$TEXDIR/info} & \GNU style Info manuals\\
- \dirname{$TEXDIR/bin/$PLATFORM} & binaries\\
-\end{tabular}
-%$
-
-If you want to leave out the \dirname{$PLATFORM} directory level,
-i.e., put the binaries directly into \dirname{$TEXDIR/bin}, specify
-the \verb|--disable-multiplatform| option to \cmdname{configure}.
-
-Have a look at the output of \verb|./configure --help| for more
-options you can use. For example, you can skip building of \OMEGA{} and
-\eTeX{}.
-
-
-\subsection{Running \cmdname{make}}
-
-Make sure the shell variable or option \texttt{noclobber} is not set.
-Then, run the main \cmdname{make} like this:
-\begin{alltt}
-> \Ucom{make world}
-\end{alltt}
-and relax\ldots
-
-Alternatively, you want to log all the output, as in:
-\begin{alltt}
-> \Ucom{sh -c "make world >world.log 2>\&1" \&}
-\end{alltt}
-
-Before you believe that everything went ok, please check the log file
-for errors: \GNU \cmdname{make} always uses the string \samp{***}
-whenever a command fails. Also, check if all the programs were built:
-
-\begin{alltt}
-> \Ucom{cd \var{TEXDIR}/bin/\var{archname}}
-> \Ucom{ls | wc}
-\end{alltt}
-The result should be over 200 (you can check the exact number with the
-\dirname{bin} directory contents in the distribution).
-
-If you need special privileges for \texttt{make install}, you can
-separate the \samp{make world} into two different runs, like this:
-\begin{alltt}
-> \Ucom{make all}
-> \Ucom{su}
-> \Ucom{make install strip}
-\end{alltt}
-
-After you've installed your new binaries, you should follow the normal
-post-installation procedures, given in section~\ref{sec:postinstall}
-(\p.\pageref{sec:postinstall}).
-
-Also, if you'd like to make your binaries available to others, please
-contact us. We'll be happy to put them on the \TL\ web pages.
-\end{comment}
-
-\ifx\HCode\undefined\else\HCode{<a id="ack"></a>}
-\section{Acknowledgements}
-
-\TL{} is a joint effort by virtually all of the \TeX{} user groups.
-This edition of \TL{} was overseen by Karl Berry. The other principal
-contributors, past and present, are listed below.
-
-\begin{itemize*}
-
-\item The English, German, Dutch, and Polish \TeX{} user groups
-(\acro{TUG}, \acro{DANTE} e.V., \acro{NTG}, and \acro{GUST},
-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,
-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
-autotools usage throughout \TL.
-
-\item Thomas Esser, without whose marvelous \teTeX{} package \TL{}
-would have never existed.
-
-\item Michel Goossens, who co-authored the original documentation.
-
-\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.
-
-\item \Thanh, Martin Schr\"oder, and the pdf\TeX\ team
-(\url{http://pdftex.org}) for continuing enhancements of \TeX's
-abilities.
-
-\item Hans Hagen, for much testing and making his \ConTeXt\ format
-(\url{http://pragma-ade.com}) work within \TL's framework.
-
-\item Hartmut Henkel, for significant development contributions to
-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.
-
-\item Pawe{\l} Jackowski, for the Windows installer \cmdname{tlpm},
-and Tomasz {\L}uczak, for \cmdname{tlpmgui}, used in past releases.
-
-\item Akira Kakuto, for providing the Windows
-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 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
-so.
-
-\item Reinhard Kotucha, for major contributions to the \TL{} 2008
-infrastructure and installer, as well as Windows research efforts, the
-\texttt{getnonfreefonts} script, and more.
-
-\item Siep Kroonenberg, also for major contributions to the \TL{} 2008
-infrastructure and installer, especially on Windows, and for the bulk of
-work updating this manual describing the new features.
-
-\item Petr Ol\v{s}ak, who coordinated and checked all the Czech and Slovak
-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.
-
-\item Fabrice Popineau, for the original Windows support in \TL{} and
-work on the French documentation.
-
-\item Norbert Preining, the principal architect of the \TL{} 2008
-infrastructure and installer, and also for coordinating the Debian
-version of \TL{} (together with Frank K\"uster), making many suggestions
-along the way.
-
-\item Sebastian Rahtz, for originally creating \TL{} and maintaining it
-for many years.
-
-\item Vladimir Volovich, for substantial help with porting and other
-maintenance issues, and especially for making it feasible to include
-\cmdname{xindy}.
-
-\item Staszek Wawrykiewicz, the principal tester for all of \TL{},
-and coordinator of the many major Polish contributions: fonts, Windows
-installation, and more.
-
-\item Olaf Weber, for his patient maintenance of \Webc.
-
-\item Gerben Wierda, for creating and maintaining the \MacOSX\ support,
-and much integration and testing.
-
-\item Graham Williams, on whose work the \TeX\ Catalogue of packages depends.
-
-\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}),
-Akira Kakuto (\pkgname{win32}),
-Dick Koch (\pkgname{universal-darwin}),
-Manfred Lotz (\pkgname{i386-freebsd}),
-Norbert Preining (\pkgname{alpha-linux}),
-Arthur Reutenauer (\pkgname{sparc-linux}),
-Thomas Schmitz (\pkgname{powerpc-linux}),
-Apostolos Syropoulos (\pkgname{i386-solaris}),
-Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-solaris}),
-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),
-Klaus H\"oppner (German),
-Petr Sojka \& Jan Busa (Czech\slash Slovak),
-Boris Veytsman (Russian),
-Staszek Wawrykiewicz (Polish). The \TL{} documentation web page
-is \url{http://tug.org/texlive/doc.html}.
-
-Of course the most important acknowledgement must go to Donald Knuth,
-first for inventing \TeX, and then for giving it to the world.
-
-
-
-\section{Release history}
-\label{sec:history}
-
-\subsection{Past}
-
-Discussion began in late 1993 when the Dutch \TeX{} Users Group was
-starting work on its 4All\TeX{} \CD{} for \acro{MS-DOS} users, and it
-was hoped at that time to issue a single, rational, \CD{} for all
-systems. This was too ambitious a target for the time, but it did spawn
-not only the very successful 4All\TeX{} \CD{}, but also the \acro{TUG}
-Technical Council working group on a \emph{\TeX{} Directory Structure}
-(\url{http://tug.org/tds}), which specified how to create consistent and
-manageable collections of \TeX{} support files. A complete draft of the
-\TDS{} was published in the December 1995 issue of \textsl{TUGboat}, and
-it was clear from an early stage that one desirable product would be a
-model structure on \CD{}. The distribution you now have is a very direct
-result of the working group's deliberations. It was also clear that the
-success of the 4All\TeX{} \CD{} showed that Unix users would benefit
-from a similarly easy system, and this is the other main strand of
-\TL.
-
-We first undertook to make a new Unix-based \TDS{} \CD{} in the autumn
-of 1995, and quickly identified Thomas Esser's \teTeX{} as the ideal
-setup, as it already had multi-platform support and was built with
-portability across file systems in mind. Thomas agreed to help, and work
-began seriously at the start of 1996. The first edition was released in
-May 1996. At the start of 1997, Karl Berry completed a major new release
-of Web2c, which included nearly all the features which Thomas Esser had
-added in \teTeX, and we decided to base the 2nd edition of the \CD{} on
-the standard \Webc, with the addition of \teTeX's \texttt{texconfig}
-script. The 3rd edition of the \CD{} was based on a major revision of
-\Webc, 7.2, by Olaf Weber; at the same time, a new revision of \teTeX
-was being made, and \TL{} included almost all of its features. The
-4th edition followed the same pattern, using a new version of \teTeX,
-and a new release of \Webc{} (7.3). The system now included a complete
-Windows setup.
-
-For the 5th edition (March 2000) many parts of the \CD{} were revised
-and checked, updating hundreds of packages. Package details were stored
-in XML files. But the major change for \TeX\ Live 5 was that all
-non-free software was removed. Everything in \TL{} is now intended
-to be compatible with the Debian Free Software Guidelines
-(\url{http://www.debian.org/intro/free}); we have done our best to check
-the license conditions of all packages, but we would very much
-appreciate hearing of any mistakes.
-
-The 6th edition (July 2001) had much more material updated. The major
-change was a new install concept: the user could select a more exact set
-of needed collections. Language-related collections were completely
-reorganized, so selecting any of them installs not only macros, fonts,
-etc., but also prepares an appropriate \texttt{language.dat}.
-
-The 7th edition of 2002 had the notable addition of \MacOSX{} support,
-and the usual myriad of updates to all sorts of packages and
-programs. An important goal was integration of the source back with
-\teTeX, to correct the drift apart in versions~5 and~6.
-
-\subsubsection{2003}
-
-In 2003, with the continuing flood of updates and additions, we found
-that \TL{} had grown so large it could no longer be contained on a
-single \CD, so we split it into three different distributions (see
-section~\ref{sec:tl-coll-dists}, \p.\pageref{sec:tl-coll-dists}). In
-addition:
-
-\begin{itemize*}
-\item At the request of the \LaTeX{} team, we changed the standard
- \cmdname{latex} and \cmdname{pdflatex} commands to now use \eTeX{} (see
- \p.\pageref{text:etex}).
-\item The new Latin Modern fonts were included (and are recommended).
-\item Support for Alpha \acro{OSF} was removed
- (\acro{HPUX} support was removed previously), since no one had (or
- volunteered) hardware available on which to compile new binaries.
-\item Windows setup was substantially changed; for the first time
- an integrated environment based on XEmacs was introduced.
-\item Important supplementary programs for Windows
- (Perl, Ghost\-script, Image\-Magick, Ispell) are now installed
- in the \TL{} installation directory.
-\item Font map files used by \cmdname{dvips}, \cmdname{dvipdfm}
- and \cmdname{pdftex} are now generated by the new program
- \cmdname{updmap} and installed into \dirname{texmf/fonts/map}.
-\item \TeX{}, \MF{}, and \MP{} now, by default, output most input
- characters (32 and above) as themselves in output (e.g.,
- \verb|\write|) files,
- log files, and the terminal, i.e., \emph{not} translated using the
- \verb|^^| notation. In \TL{}~7, this translation was
- dependent on the system locale settings; now, locale settings do
- not influence the \TeX{} programs' behavior. If for some reason
- you need the \verb|^^| output, rename the file
- \verb|texmf/web2c/cp8bit.tcx|. (Future releases will have cleaner
- ways to control this.)
-\item This documentation was substantially revised.
-\item Finally, since the edition numbers had grown unwieldy,
- the version is now simply identified by the year: \TL{} 2003.
-\end{itemize*}
-
-
-\subsubsection{2004}
-
-2004 saw many changes:
-
-\begin{itemize}
-
-\item If you have locally-installed fonts which use their own
-\filename{.map} or (much less likely) \filename{.enc} support files, you
-may need to move those support files.
-
-\filename{.map} files are now searched for in subdirectories of
-\dirname{fonts/map} only (in each \filename{texmf} tree), along the
-\envname{TEXFONTMAPS} path. Similarly, \filename{.enc} files are now
-searched for in subdirectories of \dirname{fonts/enc} only, along the
-\envname{ENCFONTS} path. \cmdname{updmap} will attempt to warn about
-problematic files.
-
-For methods of handling this and other information, please see
-\url{http://tug.org/texlive/mapenc.html}.
-
-\item The \TK\ has been expanded with the addition of a \MIKTEX-based
-installable \CD, for those who prefer that implementation to Web2C.
-See section~\ref{sec:overview-tl} (\p.\pageref{sec:overview-tl}).
-
-\item Within \TL, the single large \dirname{texmf} tree of previous
-releases has been replaced by three: \dirname{texmf},
-\dirname{texmf-dist}, and \dirname{texmf-doc}. See
-section~\ref{sec:tld} (\p.\pageref{sec:tld}), and the \filename{README}
-files for each.
-
-\item All \TeX-related input files are now collected in
-the \dirname{tex} subdirectory of \dirname{texmf*} trees, rather than
-having separate sibling directories \dirname{tex}, \dirname{etex},
-\dirname{pdftex}, \dirname{pdfetex}, etc. See
-\CDref{texmf-doc/doc/english/tds/tds.html\#Extensions}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Extensions}}.
-
-\item Helper scripts (not meant to be invoked by users) are now located
-in a new \dirname{scripts} directory of \dirname{texmf*} trees, and
-searched for via \verb|kpsewhich -format=texmfscripts|. So if you have
-programs which call such scripts, they'll need to be adjusted. See
-\CDref{texmf-doc/doc/english/tds/tds.html\#Scripts}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Scripts}}.
-
-\item Almost all formats leave most characters printable as
-themselves via the ``translation file'' \filename{cp227.tcx}, instead of
-translating them with the \verb|^^| notation. Specifically, characters
-at positions 32--256, plus tab, vertical tab, and form feed are
-considered printable and not translated. The exceptions are plain \TeX\
-(only 32--126 printable), \ConTeXt\ (0--255 printable), and the
-\OMEGA-related formats. This default behavior is almost the same as in
-\TL\,2003, but it's implemented more cleanly, with more possibilities
-for customization. See \CDref{texmf/doc/web2c/web2c.html\#TCX-files}
-{\texttt{texmf/doc/web2c/web2c.html\#TCX-files}}.
-(By the way, with Unicode input, \TeX\ may output partial character
-sequences when showing error contexts, since it is byte-oriented.)
-
-\item \textsf{pdfetex} is now the default engine for all formats
-except (plain) \textsf{tex} itself. (Of course it generates \acro{DVI}
-when run as \textsf{latex}, etc.) This means, among other things, that
-the microtypographic features of \textsf{pdftex} are available in
-\LaTeX, \ConTeXt, etc., as well as the \eTeX\ features
-(\OnCD{texmf-dist/doc/etex/base/}).
-
-It also means it's \emph{more important than ever} to use the
-\pkgname{ifpdf} package (works with both plain and \LaTeX) or equivalent
-code, because simply testing whether \cs{pdfoutput} or some other
-primitive is defined is not a reliable way to determine if \acro{PDF}
-output is being generated. We made this backward compatible as best we
-could this year, but next year, \cs{pdfoutput} may be defined even when
-\acro{DVI} is being written.
-
-\item pdf\TeX\ (\url{http://pdftex.org}) has many new features:
-
- \begin{itemize*}
-
- \item \cs{pdfmapfile} and \cs{pdfmapline} provide font map support
- from within a document.
-
- \item Microtypographic font expansion can be used more easily.\\
- \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}
-
- \item All parameters previously set through the special configuration
- file \filename{pdftex.cfg} must now be set through primitives,
- typically in \filename{pdftexconfig.tex}; \filename{pdftex.cfg} is no
- longer supported. Any extant \filename{.fmt} files must be redumped
- when \filename{pdftexconfig.tex} is changed.
-
- \item See the pdf\TeX\ manual for more: \OnCD{texmf-dist/doc/pdftex/manual/pdftex-a.pdf}.
-
- \end{itemize*}
-
-\item The \cs{input} primitive in \cmdname{tex} (and \cmdname{mf} and
-\cmdname{mpost}) now accepts double quotes containing spaces and other
-special characters. Typical examples:
-\begin{verbatim}
-\input "filename with spaces" % plain
-\input{"filename with spaces"} % latex
-\end{verbatim}
-See the Web2C manual for more: \OnCD{texmf/doc/web2c}.
-
-\item enc\TeX\ support is now included within Web2C and consequently all
-\TeX\ programs, via the \optname{-enc} option\Dash \emph{only when
-formats are built}. enc\TeX\ supports general re-encoding of input and
-output, enabling full support of Unicode (in \acro{UTF}-8). See
-\OnCD{texmf-dist/doc/generic/enctex/} and
-\url{http://www.olsak.net/enctex.html}.
-
-\item Aleph, a new engine combining \eTeX\ and \OMEGA, is available.
-A little information is available in \OnCD{texmf-dist/doc/aleph/base}
-and \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}. The
-\LaTeX-based format for Aleph is named \textsf{lamed}.
-
-\item The latest \LaTeX\ release has a new version of the
-\acro{LPPL}\Dash now officially a Debian-approved license. Assorted
-other updates, see the \filename{ltnews} files in
-\OnCD{texmf-dist/doc/latex/base}.
-
-\item \cmdname{dvipng}, a new program for converting \acro{DVI} to
-\acro{PNG} image files, is included. See \OnCD{texmf/doc/man/man1/dvipng.1}.
-
-\item We reduced the \pkgname{cbgreek} package to a ``medium'' sized set
-of fonts, with the assent and advice of the author (Claudio Beccari).
-The excised fonts are the invisible, outline, and transparency ones,
-which are relatively rarely used, and we needed the space. The full set
-is of course available from \acro{CTAN}
-(\url{http://www.ctan.org/tex-archive/fonts/greek/cb}).
-
-\item \cmdname{oxdvi} has been removed; just use \cmdname{xdvi}.
-
-\item The \cmdname{ini} and \cmdname{vir} commands (links) for
-\cmdname{tex}, \cmdname{mf}, and \cmdname{mpost} are no longer created,
-such as \cmdname{initex}. The \cmdname{ini} functionality has been
-available through the command-line option \optname{-ini} for years now.
-
-\item \textsf{i386-openbsd} platform support was removed. Since the
-\pkgname{tetex} package in the \acro{BSD} Ports system is available, and
-\acro{GNU/}Linux and Free\acro{BSD} binaries were available, it seemed
-volunteer time could be better spent elsewhere.
-
-\item On \textsf{sparc-solaris} (at least), you may have to set the
-\envname{LD\_LIBRARY\_PATH} environment variable to run the
-\pkgname{t1utils} programs. This is because they are compiled with C++,
-and there is no standard location for the runtime libraries. (This is
-not new in 2004, but wasn't previously documented.) Similarly, on
-\textsf{mips-irix}, the \acro{MIPS}pro 7.4 runtimes are required.
-
-\end{itemize}
-
-\subsubsection{2005}
-
-2005 saw the usual huge number of updates to packages and programs.
-The infrastructure stayed relatively stable from 2004, but inevitably
-there were some changes there as well:
-
-\begin{itemize}
-
-\item New scripts \cmdname{texconfig-sys}, \cmdname{updmap-sys}, and
- \cmdname{fmtutil-sys} were introduced, which modify the
- configuration in the system trees. The \cmdname{texconfig},
- \cmdname{updmap}, and \cmdname{fmtutil} scripts now modify
- user-specific files, under \dirname{$HOME/.texlive2005}.
-
-\item Corresponding new variables \envname{TEXMFCONFIG} and
- \envname{TEXMFSYSCONFIG} to specify the trees where configuration
- files (user or system, respectively) are found. Thus, you may
- need to move personal versions of \filename{fmtutil.cnf} and
- \filename{updmap.cfg} to these places; another option is to
- redefine \envname{TEXMFCONFIG} or \envname{TEXMFSYSCONFIG} in
- \filename{texmf.cnf}. In any case the real location of these files
- and the values of \envname{TEXMFCONFIG} and \envname{TEXMFSYSCONFIG}
- must agree.
- 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
- 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
- can use the package \pkgname{ifpdf.sty} (which works under both
- plain \TeX\ and \LaTeX) to do this, or steal its logic.
-
-\item Last year, we changed most formats to output (8-bit) characters as
- themselves (see previous section). The new TCX file
- \filename{empty.tcx} now provides an easier way to get the
- original \verb|^^| notation if you so desire, as in:
-\begin{verbatim}
-latex --translate-file=empty.tcx yourfile.tex
-\end{verbatim}
-
-\item The new program \cmdname{dvipdfmx} is included for translation of
- DVI to PDF; this is an actively maintained update of
- \cmdname{dvipdfm} (which is also still available for now, though
- no longer recommended).
-
-\item The new programs \cmdname{pdfopen} and \cmdname{pdfclose} are included
- to allow reloading of pdf files in the Adobe Acrobat Reader without
- restarting the program. (Other pdf readers, notably \cmdname{xpdf},
- \cmdname{gv}, and \cmdname{gsview}, have never suffered from this
- problem.)
-
-\item For consistency, the variables \envname{HOMETEXMF} and
- \envname{VARTEXMF} have been renamed to \envname{TEXMFHOME} and
- \envname{TEXMFSYSVAR}, respectively. There is also
- \envname{TEXMFVAR}, which is by default user-specific. See the
- first point above.
-
-\end{itemize}
-
-
-\subsubsection{2006--2007}
-
-In 2006--2007, the major new addition to \TL{} was the \XeTeX{} 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}).
-
-The \TeX\ \filename{.fmt} (high-speed format) and the similar files for
-MetaPost and \MF\ are now stored in subdirectories of \dirname{texmf/web2c},
-instead of in the directory itself (although the directory is still
-searched, for the sake of existing \filename{.fmt}'s). The
-subdirectories are named for the `engine' in use, such as \filename{tex}
-or \filename{pdftex} or \filename{xetex}. This change should be
-invisible in normal use.
-
-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).
-
-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.
-
-Finally, in May 2006 Thomas Esser announced that he would no longer be
-updating te\TeX{} (\url{http://tug.org/tetex}). As a result, there was
-been a surge of interest in \TL{}, especially among \GNU/Linux
-distributors. (There is a new \texttt{tetex} installation scheme in
-\TL{}, which provides an approximate equivalent.) We hope this will
-eventually translate to improvements in the \TeX\ environment for
-everyone.
-
-\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}.
-
-\ifx\HCode\undefined\else\HCode{<a id="news"></a>}
-\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}.
-
-Among other things, this finally makes possible upgrading a \TL{}
-installation over the Internet after the initial installation, a feature
-MiK\TeX\ has provided for many years. We expect to regularly update new
-packages as they are released to \CTAN.
-
-The major new engine Lua\TeX\ (\url{http://luatex.org}) is included;
-besides a new level of flexibility in typesetting, this provides an
-excellent scripting language for use both inside and outside of \TeX\
-documents.
-
-Support among Windows and the Unix-based platforms is now much more
-uniform. In particular, most Perl and Lua scripts are now available on
-Windows, using the Perl internally distributed with \TL.
-
-The new \cmdname{tlmgr} script (section~\ref{sec:tlmgr}) is the
-general interface for managing \TL{} after the initial installation.
-It handles package updates and consequent regeneration of formats, map
-files, and language files, optionally including local additions.
-
-With the advent of \cmdname{tlmgr}, the \cmdname{texconfig} actions to
-edit the format and hyphenation configuration files are now disabled.
-
-The \cmdname{xindy} indexing program
-(\url{http://xindy.sourceforge.net/}) is now included on most platforms.
-
-The \cmdname{kpsewhich} tool can now report all matches for a given file
-(option \optname{--all}) and limit matches to a given subdirectory
-(option \optname{--subdir}).
-
-The \cmdname{dvipdfmx} program now includes functionality to extract
-bounding box information, via the command name \cmdname{extractbb}; this
-was one of the last features provided by \cmdname{dvipdfm} not in
-\cmdname{dvipdfmx}.
-
-The font aliases \filename{Times-Roman}, \filename{Helvetica}, and so on
-have been removed. Different packages expected them to behave
-differently (in particular, to have different encodings), and there was
-no good way to resolve this.
-
-The \pkgname{platex} format has been removed, to resolve a name conflict
-with a completely different Japanese \pkgname{platex}; the
-\pkgname{polski} package is now the main Polish support.
-
-Internally, the \web\ string pool files are now compiled into the
-binaries, to ease upgrades.
-
-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}.
-
-
-\subsection{Future}
-
-\emph{\TL{} is not perfect!} (And never will be.) We intend to
-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 better-checked tree of macros and fonts. This work is
-all done by hard-pressed volunteers in their limited spare time, and a
-great deal remains to be done. Please see
-\url{http://tug.org/texlive/contribute.html}.
-
-Please send corrections, suggestions, and offers of help to:
-\begin{quote}
-\email{tex-live@tug.org} \\
-\url{http://tug.org/texlive}
-\end{quote}
-
-\medskip
-\noindent \textsl{Happy \TeX ing!}
-
-\end{document}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/live-tl7.tex b/Master/texmf-doc/source/texlive/texlive-en/archive/live-tl7.tex
deleted file mode 100644
index 1e8ee77312b..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/live-tl7.tex
+++ /dev/null
@@ -1,3554 +0,0 @@
-%
-% change history (started May 13th 2002)
-% 2002/05/13: added tex-langafrican to list of collections
-% 2002/05/14: corrected example files, other small errors noted by Volker
-% 2002/05/18: win32 updates, by Fabrice
-% 2002/05/25: remove mention of sizes, and bsr-interpolated; add Gutenberg
-\documentclass{article}
-\advance\textwidth by 1in
-\advance\oddsidemargin by -1in
-\advance\evensidemargin by -1in
-\newsavebox{\warnbox}
-\def\Q#1{\par\vskip6pt\leftline{#1}\par}
-\setcounter{tocdepth}{2}
-\pretolerance=1000
-\tolerance=1500
-\hbadness=3000
-\vbadness=3000
-\hyphenpenalty=400
-\renewcommand{\topfraction}{0.85}
-\renewcommand{\floatpagefraction}{0.86}
-\renewcommand{\textfraction}{0.1}
-\setcounter{topnumber}{5}
-\setcounter{totalnumber}{5}
-\def\eTeX{$\varepsilon$-\TeX}
-\def\Dash{---}
-\def\hyph{-}
-\def\OMEGA{$\Omega$}
-\def\bs{{\protect\normalfont\ttfamily\char'134}}
-\DeclareRobustCommand{\cs}[1]{{\normalfont\ttfamily\char`\\#1}}
-\def\La{La}
-\let\textsl\textit
-\let\sl\it
-\let\slfamily\itfamily
-\def\ttdefault{cmtt}
-\usepackage{tex-live}
-\begin{document}
-%\makeatletter\@ifundefined{HRestore}{}{\HRestore\noalign}\makeatother
-\author{Sebastian Rahtz\\
-\texttt{sebastian.rahtz@oucs.ox.ac.uk}
-%Michel Goossens\\
-%\texttt{m.goossens@cern.ch}
-}
-\title{The \protect\TeX\ Live Guide, 7th edition}
-\date{May 2002}
-\maketitle
-\begin{multicols}{2}
-\tableofcontents
-\listoftables
-\end{multicols}
-\section{Introduction}\label{sec:intro}
-This documentation describes the
- main features of the \TeXLive{} 7 \CD{}\Dash a \TeX{}/\LaTeX{}
- distribution for Unix, Linux, MacOSX, and Windows32 systems that includes
- \TeX{}, \LaTeXe{}, \MF, \MP, \cmdname{Makeindex}, and \BibTeX{}; and
- a wide-ranging set of macros, fonts and documentation conforming to
- the \emph{\TeX{} Directory Standard} (\TDS{})\Dash which can be used
- with nearly every \TeX{} setup.
-
- This \TeX{} package uses the \Webc{} version 7.3.7
- implementation of the programs, which tries to make \TeX{}ing as
- easy as possible, and takes full advantage of the efficient and
- highly customizable \KPS{} library from Karl Berry and Olaf Weber.
- It can be run either directly from the \CD{} or installed on a hard
- disk.
-
-Most of the runnable systems on the \CD{} include a large set of
-drivers and support programs for \TeX, including \cmdname{dvips}
-(PostScript driver), \cmdname{dvipdfm} (dvi to PDF),
-\cmdname{xdvi} (X Windows previewer),
-\cmdname{dvilj} (HP LaserJet driver), \cmdname{lacheck} (\LaTeX{}
-syntax checker), \cmdname{tex4ht} (\TeX{} to HTML converter),
-\cmdname{dviconcat} and \cmdname{dviselect}, \cmdname{dv2dt} and
- \cmdname{dt2dv} (\texttt{dvi} to ASCII and vice versa), and Angus
- Duggan's PostScript utilities.
-
-\subsection{Extensions to \TeX}
-
-The \TeXLive{} runnable systems contain three extended versions of
-standard \TeX:
-\begin{enumerate}
-\item \eTeX, which adds a small but powerful set of new primitives,
- and the \TeXXeT{} extensions for left to right typesetting; in
- default mode, \eTeX{} is 100\% compatible with ordinary \TeX. See
- \OnCD{texmf/doc/etex/base/etex_man.pdf} on the \CD{} for details.
-\item pdf\TeX, which can optionally write Acrobat PDF format instead
- of \dvi{}. You will find the user manual in
- \OnCD{texmf/doc/pdftex/pdftex-l.pdf}. The
- file \OnCD{texmf/doc/pdftex/samplepdf/samplepdf.tex} shows how it is
- used. The \LaTeX{} \pkgname{hyperref} package has an option
- `\optname{pdftex}', which turns on all the program features.
-\item \OMEGA{} (Omega), which works internally with 16-bit characters,
- using Unicode; this allows it to directly work with almost all the
- world's scripts simultaneously. It also supports dynamically loaded
- `\OMEGA{} Translation Processes' (\acro{OTP}s), which allow the user
- to define complex transformations to be performed on arbitrary
- streams of input. See \OnCD{texmf/doc/omega/base/doc-1.8.tex} for some
- (not necessarily up to date) documentation.
-\end{enumerate}
-\eTeX{} (version 2.1) is stable, although subsequent releases will add
-new functionality. pdf\TeX{} (version 1.00b) is also stable,
-but is still being improved.
-\OMEGA{} (version 1.23) is under development; the version
-on this \CD{} is that current as of May 2002.
-
-
-\section[Structure and contents of the CD-ROM]{Structure
- and contents of the \protect\CD{}}
-The important \CD{} top-level directories are listed below.
-\begin{description}
-\item[bin] The \TeX{} family programs, arranged in separate platform
- directories.
-\item[Books] Examples related to some books about \TeX.
-\item[FAQ] Frequently Asked Questions, in English, French, and German.
-\item[MacOSX] Support programs for MacOSX users
-\item[info] Documentation in \acro{GNU} `info' format for the \TeX{}
- system.
-\item[man] Documentation in the form of Unix man pages for the \TeX{}
- system.
-\item[setupw32] directory contains material for installation and use
- under Windows (see section \ref{sec:wintex} on p.~\pageref{sec:wintex}).
-\item[source] The source of all programs, including the main \Webc{}
- \TeX{} and \MF{} distributions. These are stored in a bzip2-compressed
- tar archive.
-\item[support] Various bits of \TeX-related software which are
- \emph{not} installed by default, support programs, and a complete
- distribution of \cmdname{Ghostscript} version 7.05.
- You can find here some other programs (editors, \TeX\ shells), which
- are usually absent from Windows installations, dedicated for beginners.
- They can be installed with the \texttt{TeXSetup.exe} Windows installation
- program.
-\item[texmf] The main support tree of macros, fonts and documentation;
-\item[usergrps] Material about \TeX\ User Groups.
-\end{description}
-
-There are also two installation scripts for Unix systems,
-\texttt{install-cd.sh} and \texttt{install-pkg.sh}; we discuss
-them on in section \ref{sec:install} on p.~\pageref{sec:install}.
-
-\subsection[Packages and collections]{Packages and collections}
-\label{packages}
-The \TeXLive{} \texttt{texmf} tree consists of various `collections',
-each of which refers to a set of `packages', of which there are over 700
-on the \CD{}. Normal installation allows the
-user to copy all of a collection to a local hard disk from the \CD{}, but
-it is also possible to install just one package of a collection.
-
-The collections add functionality to a \TeX\ system. One of them, named
-`tex-basic', is necessary for almost all \TeX\ tasks,
-and two others, called `tex-latex' and `tex-pdftex' are highly
-recommended for most users. All others are optional.
-The collections (defined by XML files in \texttt{texmf/tpm/collections})
-and their short descriptions are listed below.
-
-\begin{description}
- \item[tex-basic]
- These files are regarded as basic for any \TeX\ system, covering
-plain \TeX\ macros, Computer Modern fonts, and configuration for common
-drivers.
- \item[tex-bibtexextra]
- Additional, extensive libraries of BibTeX styles and bibliographies.
- \item[tex-chemistry]
- Essential chemistry
- \item[tex-context]
- Hans Hagen's powerful macro package, ConText
- \item[tex-documentation]
- Assorted useful documentation and guides
- \item[tex-etex]
- Support files for an extended \TeX\
- \item[tex-extrabin]
- Various useful, but non-essential, support programs. Includes
- programs and macros for texinfo system; programs for dvi file
- manipulation, etc.
- \item[tex-fontbin]
- Programs for conversion between font formats, testing fonts
- (virtual fonts stuff, .gf and .pk manipulation,
- mft, fontinst, etc.)
- \item[tex-fontsextra]
- All sorts of extra fonts
- \item[tex-formatsextra]
- A collection of \TeX\ `formats', ie large-scale
-macro packages designed to be dumped into .fmt file
- \item[tex-games]
- Setups for typesetting various board games, including chess
- \item[tex-genericextra]
- This is a mixed bag of macro packages and fonts which do not seem
-to belong elsewhere
- \item[tex-htmlxml]
- Packages to convert \LaTeX\ to XML/HTML, and typeset XML/SGML
- \item[tex-langafrican]
- Support for some African scripts
- \item[tex-langarmenian]
- Essential armenian
- \item[tex-langcjk]
-Essential CJK (Chinese, Japanese, Korean) macros and fonts
- \item[tex-langcroatian]
- Essential croatian
- \item[tex-langcyrillic]
- Fonts and macro packages to typeset Cyrillic texts.
- \item[tex-langczechslovak]
- Pick this if you want Czech/Slovak fonts and other packages
- \item[tex-langdanish]
- Essential Danish
- \item[tex-langdutch]
- Essential Dutch
- \item[tex-langfinnish]
- Essential Finnish
- \item[tex-langfrench]
- Essential French
- \item[tex-langgerman]
- Essential German
- \item[tex-langgreek]
- Essential Greek
- \item[tex-langhungarian]
- Essential Hungarian
- \item[tex-langindic]
- Essential Indic
- \item[tex-langitalian]
- Essential Italian
- \item[tex-langlatin]
- Essential Latin
- \item[tex-langmanju]
- Essential Manju
- \item[tex-langmongolian]
- Essential mongolian
- \item[tex-langnorwegian]
- Essential Norwegian
- \item[tex-langother]
- Other languages
- \item[tex-langpolish]
- Pick this if you want Polish fonts and other packages
- \item[tex-langportuguese]
- Essential Portuguese
- \item[tex-langspanish]
- Essential Spanish
- \item[tex-langswedish]
- Essential Swedish
- \item[tex-langtibetan]
- Fonts and support for typesetting Tibetan
- \item[tex-langukenglish]
- Essential UK English
- \item[tex-langvietnamese]
- Essential Vietnamese
- \item[tex-latex]
- These packages are either mandated by the core \LaTeX\ team,
-or very commonly recommended
- \item[tex-latexextra]
- A large collection of add-on packages for \LaTeX\
- \item[tex-mathextra]
- Extra math
- \item[tex-metapost]
- MetaPost (and MetaFont) drawing packages
- \item[tex-music]
- Music typesetting packages
- \item[tex-omega]
- Omega, a 16-bit extended \TeX\ by John Plaice and Yannis Haralambous
- \item[tex-pdftex]
- Support files for Han The Thanh's variant of \TeX\ which can
-generate PDF output
- \item[tex-pictures]
- Essential graphics
- \item[tex-plainextra]
- Plain \TeX\ extra macros
- \item[tex-psfonts]
- Essential psfonts
- \item[tex-psutils]
- Utilities to manipulate PostScript files
- \item[tex-publishers]
- Essential publishers
- \item[tex-t1utils]
- Utilities to manipulate Type1 fonts
- \item[tex-texbooks]
- Examples and other material from various books about TeX/LaTeX.
- \item[tex-theses]
- Macro packages from various Universities for their thesis styles
- \item[tex-ttfutils]
- Utilities to manipulate TrueType fonts
- \item[win32-support]
- You can choose individual tools from this collection.
- There are many \TeX\ oriented editors, graphics files
- toolsets, etc.
-\end{description}
-
-The directory \texttt{texmf/tpm/packages} contains lists
-of all files in each package (used by the installation programs).
-
-\section{Installation and use under Unix}
-\label{sec:install}
-You can use the \TeXLive{} \CD{} in three ways:
-\begin{enumerate}
-\item You can mount the \CD{} on your file system, run
-the \texttt{install-cd.sh} script, and select the option \verb|<R>|
- (`do not install files, set up to run off CD-ROM'),
- and run everything off the \CD; this takes very
- little disk space, and gives you immediate access to everything on
- the \CD; although the performance will not be optimal, it is
- perfectly acceptable on, for instance, PCs running Linux. You could
- also copy the entire CD contents to your hard disk and work in this way.
-\item You can install all or part of the system to your local hard
- disk; this is the best method for many people, if they have enough
- disk space to spare (a minimum of about 100 megabytes, or 300
- megabytes for a recommended good-sized system).
-\item You can install selected packages to work either with your
- existing \TeX{} system or a \TeXLive{} system you installed earlier.
-\end{enumerate}
-Each of these methods is described in more detail in the following
-sections.
-
-\ifSingleColumn
-\begin{figure*}
- \begin{center}
- \leavevmode
-\fi
-\begin{warningbox}
-\textbf{Warning: } This \CD{} is in ISO 9660 (High Sierra) format,
-with Rock Ridge and Joliet extensions. In order to take full advantage
-of the \CD{} on a Unix system, your system needs to be able to use
-the Rock Ridge extensions. Please consult the documentation for your
-\cmdname{mount} command to see if it is possible. If you have several
-different machines on a local network, see if you can mount the
-\CD{} on one which \emph{does} support Rock Ridge, and use this with
-the others.
-
-\leavevmode\quad
-Linux, FreeBSD, Sun, SGI and DEC Alpha systems should be able to use
-the \CD{} with no problems. We would appreciate receiving detailed advice
-from other system users who also succeed, for future versions of this
-documentation.
-
-\leavevmode\quad
-The discussion below about installation assumes you have been able to mount
-the \CD{} with full Rock Ridge compatibility.
-\end{warningbox}
-\ifSingleColumn
- \end{center}
-\end{figure*}
-\fi
-
-%\begin{addbymb}
-\subsection[Pre-installation procedure for MacOSX users]
-{Pre-installation procedure for MacOSX users}
-If you do not run MacOSX, you should skip this section.
-
-The \texttt{install-cd.sh} script is a \emph{sh} script (begins with
-``\verb=#!/bin/sh=''), but
-on MacOSX \cmdname{sh} is unable to run it because
-\cmdname{sh} is
-emulated. However, \cmdname{bash} will run it. Unfortunately (again)
-\cmdname{bash} is not
-installed by default on MacOSX\footnote{there are some suggestions this will
-change in the future and even
-that \cmdname{bash} will be used to emulate \cmdname{sh},
-in which case it might be true
-that in future versions of MacOSX, the script will just work.}.
-\begin{enumerate}
-\item\label{test-bash} (optional) See if \path|bash| is already installed.
-Launch \path|Terminal|
-(\path|/Applications/utilities/Terminal|) and type in a window
-\begin{alltt}
->> \Ucom{rehash; which bash}
-\end{alltt}
-the answer will be:
-\begin{itemize}
-\item the bash location (e.g. \path|/bin/bash| or \path|/usr/local/bin/bash|) if installed;
-\item \texttt{bash: command not found} if not installed.
-\end{itemize}
-
-If bash is already installed, skip to \ref{std-install}
-
-\item bash installation:
-\begin{description}
-\item[Mac friendly procedure]
-Look in the \path|MacOSX| directory of the \CD{}
-for an image disk named \path|bash.dmg|. mount that
-file by double-clicking it. The disk image (volume) will be mounted.
-Then start the \path|i-Installer| application on that volume. You will be asked
-to authenticate, if you have never seen that before, you might not have
-enough privileges to install. Just enter your own user name and
-password. Hit install. \path|bash| will be installed on your system.
-\item[Terminal procedure]
-\begin{enumerate}
-\item Log in as an admin user, at least a user with Admin privileges or
-sudo user or as the System Administrator.
-\item Open the \path|MacOSX| directory on the \CD{} and copy
-\path|bash.tar.gz|
-to your home directory (\texttt{\~{}/})
-\item Then launch \path|Terminal| and type or copy/paste the
-line below in a Terminal window):
-\begin{alltt}
->> \Ucom{(cd /usr/local/; sudo tar xvzf ~/bash.tar.gz)}
-\end{alltt}
-type a carriage-return: you will be asked for your password, and
-\path|bash| will be
-installed.
-\item Quit \path|Terminal|.
-\end{enumerate}
-\end{description}
-\item Now after using either install method, goto \ref{test-bash}:
-you must obtain \path|/usr/local/bin/bash|\ldots{} (if not, try to log out and in).
-\item\label{std-install} The installation procedure is the
-same on MacOSX than on other UNIX platforms (as MacOSX is UNIX,
-that's quite normal!). Nevertheless, you should read what follows:
-\begin{itemize}
- \item Note that in all commands of the following sections,
-\cmdname{sh} must be replaced by \texttt{sudo bash}:
-\begin{alltt}
->> \Ucom{sh install-cd.sh}
-\end{alltt}
-becomes
-\begin{alltt}
->> \Ucom{sudo bash install-cd.sh}
-\end{alltt}
-etc.
-\item On MacOSX, cd are auto-mounted: you \emph{don't} need to use
-\texttt{mount}. The \CD{} will be mounted in the \path|/Volumes/|
-directory: in order to make it the current directory, you just have to
-type in \path|Terminal|:
-\begin{alltt}
->> \Ucom{cd /Volumes/TeXLive-7...}
-\end{alltt}
-(complete this line with the real name of the \CD{}: using
-``auto completion'' by pressing the \texttt{<tab>}
-key will do it).
-\end{itemize}
-\end{enumerate}
-%\end{addbymb}
-
-\subsection[Running \protect\TeXLive{} from the CD-ROM]{Running \protect\TeXLive{} from the \protect\CD}
-The organisation of \Webc{} means that you can run programs simply by
-adding the appropriate directory under \path|bin| on the \CD{} to
-your \texttt{PATH}, and the support files will all be found with no further
-ado. The following shows the list of available systems and the
-corresponding directories. \textbf{Only x86 Linux, Mac OSX, and
- Windows are available on the default CD. You need to ask
-for the Unix CD if you need the other systems.}
-
-\begin{flushleft}
-\begin{tabular}{@{}l>{\ttfamily}ll}
-Compaq Alpha Linux & alpha-linux & CD2\\
-Compaq Alphaev5 OSF 4.0d & alphaev5-osf4.0d & CD2\\
-HP9000 HPUX 10.20 & hppa2.0-hpux10.20 & CD2\\
-IBM RS 6000 AIX 4.2.* & rs6000-aix4.2.1.0 & CD2\\
-Intel x86 Solaris 2.8 & i386-solaris2.8 & CD2\\
-Intel x86 with GNU/Linux & i386-linux & CD1\\
-Mac OSX & powerpc-darwin5.3 & CD1\\
-Sun Sparc Solaris 2.7 & sparc-solaris2.7 & CD2\\
-Windows 9X/ME/NT/2K/XP & win32 & CD1\\
-\end{tabular}
-\end{flushleft}
-
-You may worry that when you subsequently make fonts or change
-configuration, things will go wrong because you cannot change files on
-the \CD{}. However, you can maintain a parallel, writeable, \TeX{}
-tree on your hard disk; this is searched before the main tree on the
-\CD{}. The default location is \path|texmf-var| on the CD
-(which does not exist!), so you \emph{must} override this by setting
-the \texttt{VARTEXMF} environment variable.
-
-
-Thus \emph{sh} or \emph{bash} users on an Intel PC
-running Linux can mount the \TeXLive{} \CD{} on
-\file{/mnt/cdrom} by issuing the command:
-
-\begin{alltt}
->> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom}
-\end{alltt}
-Then they should change the current directory to \path|/mnt/cdrom|, run
-\begin{alltt}
->> \Ucom{sh install-cd.sh}
-\end{alltt}
-and select the option \verb|<R>| (\emph{do not install files, set up to run
-off CD-ROM}). After that, they should include the directory containing
-the binaries for the given architecture into the search path
-by updating the \texttt{PATH} variable.
-\begin{verbatim}
-PATH=/mnt/cdrom/bin/i386-linux:$PATH
-export PATH
-VARTEXMF=/usr/TeX/texmf-var
-export VARTEXMF
-\end{verbatim}
-%\begin{addbymb}
-\begin{description}
- \item[MacOSX users] On MacOSX, the default shell is \texttt{tcsh}:
-\begin{verbatim}
-setenv PATH /Volumes/<cd-name>/bin/powerpc-darwin5.3:${PATH}
-setenv VARTEXMF /usr/TeX/texmf-var
-\end{verbatim}
-\end{description}
-%\end{addbymb}
-For convenience, these statements can also be entered into the
-\texttt{.profile} script.
-%\begin{addbymb}
-(for \texttt{tcsh} on MacOSX,
-\verb=~/Library/init/tcsh/rc.mine=).
-%\end{addbymb}
-
-If in doubt, ask your local system support guru to help you work out
-how to mount your \CD{} or which directory to use for your system.
-
-Appropriate support files will be installed on your hard disk the
-first time you need them. You can edit and change local configuration
-files which are stored to the directory designated
-by \texttt{\$VARTEXMF}. Any format file that is needed
-will be generated and stored here.
-
-%------------------------------------------------
-\subsection{Installing \protect\TeXLive{} to a hard disk}
-All of the necessary steps to install all or part of the distribution
-on your hard disk are achieved by mounting the \CD{}, changing to the
-top-level directory, and typing:
-\begin{alltt}
->> \Ucom{sh install-cd.sh}
-\end{alltt}
-(On some Unix systems, you may need to use \cmdname{sh5} or
-\cmdname{bash}.) This script works by accessing lists of collections
-and packages from the \CD{}, and trying to guess what sort of computer
-system you are on. It should start by displaying the following:
-\verbatiminput{../examples/ex1.tex}
-It will then show the main control screen
-(Figure~\ref{ins1}), which lets you change five
-things:
-\begin{enumerate}
-\item the type of system you are on, or want to install for;
-\item the \emph{installation scheme} you want to use (eg full,
- recommended, basic etc)
-\item the collections you want to change from
-the installation scheme (they are organised into two sets:
-\emph{standard collections} and \emph{language collections});
-\item the location on your hard disk to put the files;
-\item some runtime behaviour features.
-\end{enumerate}
-
-\begin{figure*}
-\begin{center}
-\ifnum\Status=2
-\boxedverbatiminput{../examples/ex2.tex}
-\else
-\begin{minipage}{0.8\textwidth}
-\boxedverbatiminput{../examples/ex2.tex}
-\end{minipage}
-\fi
-\caption{Main control screen}\label{ins1}
-\end{center}
-\end{figure*}
-
-You choose options by typing a letter or number and pressing `return'.
-In the example, a Linux GNU/Linux system has been detected, the
-default set of collections will be installed, and
-the default installation directory is \path|/usr/TeX|; note
-that the disk space required for the current installation
-configuration is also displayed. If you make a suggested setup, you
-need about 60 megabytes of disk free; however, the basic setup will
-only take about 30 megabytes, and you can enhance it with selected
-packages as you need them.
-
-%\begin{addbymb}
-\begin{description}
- \item[MacOSX users] Most frontends (\emph{TeXShop},
- \emph{ITeXMac}\ldots) use the \teTeX{} default location
- which is \path|/usr/local/teTeX|, so, Mac users could find interest
- in installing \TeXLive{} in \path|/usr/local/teTeX|
-rather than in \path|/usr/TeX|.
-\end{description}
-%\end{addbymb}
-
-Under the directory you choose for installation, the installation
-script will put the binaries in a subdirectory of \path|bin|, and the
-support tree in \path|texmf|. An additional tree \path|texmf-var|
-will contain copies of configuration files (except the main
-\path|texmf.cnf|), which are to be modified by \path|texconfig| program.
-This tree will also store generated format files for \TeX, \MF, etc.
-
-\begin{figure*}
-\begin{center}
-\ifnum\Status=2
-\boxedverbatiminput{../examples/ex3.tex}
-\else
-\begin{minipage}{.80\linewidth}
-\footnotesize
-\boxedverbatiminput{../examples/ex3.tex}
-\end{minipage}
-\fi
-\caption{Selecting standard collections}\label{ins2}
-\end{center}
-\end{figure*}
-
-\begin{figure*}
-\begin{center}
-\ifnum\Status=2
-\boxedverbatiminput{../examples/ex4.tex}
-\else
-\begin{minipage}{.80\linewidth}
-\footnotesize
-\boxedverbatiminput{../examples/ex4.tex}
-\end{minipage}
-\fi
-\caption{Selecting language collections}\label{ins3}
-\end{center}
-\end{figure*}
-
-When you choose |<C>| for \emph{standard collections}, you will see
-the display of available collections (Figure \ref{ins2}). Each
-collection --- TeX macro files, Metafont font families, and so on ---
-consists of several packages. You can toggle their inclusion on or
-off by pressing the key. Note that the selection letter keys are case
-sensitive.
-
-When you choose |<L>| for \emph{language collections}, you will see
-the display of available language support collections (Figure
-\ref{ins3}). Each collection consists of several packages, which
-provide features like hyphenation files and fonts.
-
-The |<O>| for \emph{options} item lets you decide whether to make new fonts
-be created in another location (if you want the main package mounted
-read-only for most users), and whether to make symbolic links for the
-binaries, \cmdname{man} and \acro{GNU} \cmdname{info} pages in the `standard'
-locations; you'll need `root' permissions for tasks to do this, of course.
-
-When you are finished, return to the main screen, and ask the
-installation to start. It will take each of the collections and
-systems that you requested, consult the list of files on the \CD{},
-and build a master list of files to transfer. These will then be
-copied to your hard disk. If you installed a system,
-an initialization sequence is now run
-(creating format files, etc.). When this has finished, all you need do
-is add the correct subdirectory of \texttt{bin} in the \TeX{}
-installation to your path, and start using \TeX. If you want, you can
-move the binaries up one level, e.g.\ from
-\path|/usr/local/bin/alpha-osf3.2|
-to \path|/usr/local/bin|; if you do this, however, you must
-edit \path|texmf/web2c/texmf.cnf| (see Appendix~\ref{app:texmf.cnf})
-and change the line near the start which reads
-\begin{verbatim}
- TEXMFMAIN = $SELFAUTOPARENT
-\end{verbatim}
-to
-\begin{verbatim}
- TEXMFMAIN = $SELFAUTODIR
-\end{verbatim}
-
-If you move the whole installation to another directory tree entirely, you
-need to edit \envname{TEXMFMAIN} to specify the support tree explicitly, and
-set \envname{TEXMFCNF} in your environment to \path|$TEXMFMAIN/texmf/web2c|.
-
-%------------------------------------------------
-
-\subsection{Installing individual packages from \protect\TeXLive{} to a hard
- disk} You may want to use the \TeXLive{} \CD{} to either update an
-existing setup, or add features to an earlier installation from the
-\CD{}. The main installation program is intended for the first time
-only, and subsequently you should use the \texttt{install-pkg.sh}
-script on the \CD{}. Run this by mounting the \CD{}, changing to
-the mounted directory, and typing
-
-\begin{alltt}
->> \Ucom{sh install-pkg.sh \emph{options}}
-\end{alltt}
-
-
-The script supports nine options; the first four let you set the
-individual package you want to install, the whole collection (i.e.,
-\texttt{tex-mathextra}), the name of the mounted \CD{} directory, and
-the name of the directory containing the list files (normally these
-latter two will be set automatically):
-
-\begin{tabular}{ll}
-\texttt{-{}-package=}\emph{name} & \\
-\texttt{-{}-collection=}\emph{name} & \\
-\texttt{-{}-cddir=}\emph{name} & \\
-\texttt{-{}-listdir=}\emph{name} & \\
-\end{tabular}
-
-What actually happens is controlled by four more switches; the first
-two allow you to exclude documentation or source files from the
-installation, the third stops the default action of running
-\texttt{mktexlsr} on completion to rebuild the file database, and
-the last does nothing but list the files that would be installed:
-
-\begin{tabular}{ll}
-\texttt{-{}-nodoc} & \\
-\texttt{-{}-nosrc} & \\
-\texttt{-{}-nohash} & \\
-\texttt{-{}-listonly} & \\
-\end{tabular}
-
-Finally, you can specify that, instead of installing the files, the script
-should make a \cmdname{tar} archive in a specified location:
-
-\begin{tabular}{ll}
-\texttt{-{}-archive=}\emph{name} & \\
-\end{tabular}
-
-Thus, if we simply wanted to see the files that make up the package
-\pkgname{fancyhdr} before we installed it, our command and output would be
-as follows:
-
-\begin{alltt}
-\ifSingleColumn>> \Ucom{sh install-pkg.sh --package=fancyhdr --listonly}
-\else>> \Ucom{sh install-pkg.sh -{}-package=fancyhdr \bs}
->> \Ucom{-{}-listonly}
-\fi{}
-texmf/doc/latex/fancyhdr/fancyhdr.dvi
-texmf/doc/latex/fancyhdr/fancyhdr.tex
-texmf/lists/fancyhdr
-texmf/source/latex/fancyhdr/README
-texmf/source/latex/fancyhdr/fancyheadings.new
-texmf/tex/latex/fancyhdr/extramarks.sty
-texmf/tex/latex/fancyhdr/fancyhdr.sty
-texmf/tex/latex/fancyhdr/fixmarks.sty
-\end{alltt}
-Other examples of usage are:
-\begin{itemize}
-\item Install the \LaTeX{} package \texttt{natbib}:
-\begin{alltt}
->> \Ucom{sh install-pkg.sh --package=natbib}
-\end{alltt}
-\item Install the \LaTeX{} package \texttt{alg} with no source files and no
-documentation:
-\begin{alltt}
-\ifSingleColumn>> \Ucom{sh install-pkg.sh --package=alg --nosrc --nodoc}
-\else>> \Ucom{sh install-pkg.sh -{}-package=alg \bs}
->> \Ucom{-{}-nosrc -{}-nodoc}
-\fi\end{alltt}
-\item Install all the packages available in the collection containing additional
-Plain \TeX\ macros:
-\begin{alltt}
->> \Ucom{sh install-pkg.sh --collection=tex-plainextra}
-\end{alltt}
-\item Place all files which are needed for PSTricks
-in a \cmdname{tar} file in \path|/tmp|:
-\begin{alltt}
-\ifSingleColumn>> \Ucom{sh install-pkg.sh --package=pstricks --archive=/tmp/pstricks.tar}
-\else
->> \Ucom{sh install-pkg.sh -{}-package=pstricks \bs}
->> \Ucom{-{}-archive=/tmp/pstricks.tar}
-\fi\end{alltt}
-\end{itemize}
-
-\subsection{The texconfig program}
-\label{ssec:tex}
-
-After the installation program has copied all files to their final
-locations, you can use a program called \cmdname{texconfig} that
-allows you to configure the system to fit your local needs. This can
-be called at any other time to change your setup, with a full-screen
-(which requires the \cmdname{dialog} program, included as part of the
-binary packages) or command-line interface.
-It should be used for all maintenance, such as changes of installed
-printers, or rebuilding the file database. Both modes have help text
-to guide you through the facilities.
-
-\section{Installation and use under Windows}
-\label{sec:wintex}
-This section only applies to systems running Windows 9x, \acro{ME},
-\acro{NT}, \acro{2K} or \acro{XP}.
-
-It is also necessary to have your Windows set up so that it uses the
-Microsoft Joliet extensions for reading \CD s; simply look at the
-\CD{} in Explorer and see whether it shows long, mixed-case, file
-names. If it does not, you cannot use the ready-to-run system on the
-\CD.
-
-This Win32 \TeX{} systems includes a \texttt{dvi} previewer,
-\textsf{Windvi}, which is similar in usage to the established Unix
-\textsf{xdvi}. The documentation can be found in
-\OnCD{texmf/doc/html/windvi/windvi.html}.
-
-\subsection[The TeXLive.exe program]{The \texttt{TeXLive.exe} program}
-
-\begin{figure*}
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.7\textwidth]{../pictures/Welcome-to-TeXLive}
- \else
- \ifnum \Status=2
-\includegraphics[bb=20 20 575 432]{../pictures/Welcome-to-TeXLive.gif}
- \else
- \includegraphics[width=.7\textwidth]{../pictures/Welcome-to-TeXLive}
- \fi
- \fi
- \end{center}
- \caption{``Welcome to \TeXLive'' window}\label{graph:welcome}
-\end{figure*}
-
-If your computer is configured to let the \CD{} autostart, then a
-dialog box with a menu bar will popup on the screen, and you will have several choices
-from there:
-\begin{itemize}
-\item Install \TeX{} on your hard disk,
-\item Install TeX-oriented editors on your hard disk,
-\item Install support packages on your hard disk (Ghostscript, NetPBM,
- \ldots)
-\item Do some maintenance on you \TeX{} system,
-\item Remove the \TeX{} system,
-\item Use \TeX{} off the \CD{},
-\item Cleanup the temporary files created on your hard disk when using
- \TeX{} off the \CD{},
-\item Update some of the DLLs on your system,
-\item Browse some documentation: \TeXLive{} documentation, TUG web
- pages, \fpTeX web pages,
-\item Run the \cmdname{TeXdocTK} application to find specific documentation.
-\end{itemize}
-
-If your \CD{} does not autostart, you can explicitly run the program
-by double clicking on \path|bin/win32/TeXLive.exe| on the \CD{} from
-the explorer window.
-
-\subsection[Running \protect\TeXLive{} from the CD-ROM]{Running from
-the \protect\CD{}}
-You can run all the \TeX{} programs directly off the \CD, and have
-access to all the macros and fonts immediately, at the price of a
-slower performance than if you install on the hard disk.
-To work effectively, one needs to modify
-environment variables and to create some small auxiliary directories on a
-hard disk. These directories will contain necessary configuration files
-allowing the user to modify programs settings and to generate a necessary
-format file. Moreover, automatically generated font files will be stored
-there too.
-
-Should you want to run \TeX{} this way, you will have to follow these
-steps:
-\begin{enumerate}
-\item from the menu, chose \verb|Explore CD-Rom|, then
- \verb|Select a text editor|, a dialog box will open to select some \path|.exe|
- program.
-
- This program needs to be a \TeX{} oriented editor. It must be able
- to run the \TeX{} compiler, previewer and any other needed tool. If
- you don't have one already installed on your system, you can install
- one from the \CD{}, details section~{\ref{sec:texlive-install}}.
-
- \emph{There is no way we can guess if the program you will
- select is actually a text editor, so be careful}.
- Here is a list of frequently used \TeX{} editors:
-\begin{center}
- \begin{tabular}[ht]{ll}
- GNU Emacs & \path|c:\Program Files\NTEmacs\bin\runemacs.exe| \\
- XEmacs & \path|c:\Program Files\XEmacs\XEmacs-21.2\i586-pc-win32\xemacs.exe| \\
- WinShell & \path|c:\Program Files\WinShell\WinShell.exe| \\
- WinEdt & \path|c:\Program Files\WinEdt Team\WinEdt\WinEdt.exe|\\
- TeXnicCenter & \path|c:\Program Files\TeXnicCenter\TEXCNTR.exe|
- \end{tabular}
-\end{center}
- The program
- selected will be memorized as the editor to use for future runs.
-
-\item from the menu, chose \verb|Explore CD-Rom|, then
- \verb|Run TeX off CD-Rom|. The environment will be modified, a small
- temporary directory created and some configuration files copied
- there. Then, the selected editor selected will be launched, and you
- will be able to type in some text, let \TeX{} typeset it and the
- view it or print it.
-
- If Ghostscript is not detected on your machine, you will be warned
- that rendering your DVI files might fail. You can install it from
- the \path|Install|, \path|Support| menu item. See
- section~\ref{sec:texlive-install} for details.
-
-\item you can select a different text editor any time you want.
-
-\item if you chose \verb|Cleanup CD-Rom setup|, everything \TeX{}
- needed will be removed, comprised the selection of your text
- editor, but not the extra packages you may have downloaded and
- installed. If you installed \cmdname{WinShell} or \cmdname{NTEmacs},
-they won't be removed.
-\end{enumerate}
-
-The editor is run inside a modified environment. A temporary TDS
-compliant texmf tree is build in the temporary area of your computer.
-It is needed to store files that may be build on the fly like pk font
-files or format files. Configuration files are copied from the \CD{}
-to this texmf tree, so that you can edit them if needed. The \path|ls-R|
-database is computed for this texmf tree.
-Then the \texttt{PATH} and \texttt{TEXMFCNF} environment
-variables are set locally, and the editor is run in
-this local environment. From within your editor\footnote{Actually, you can
- state any other program than a text editor, and select your command
- processor for example. You will then get a console with the right
- settings to use \TeX{} from the \CD{}.}, you have access to a full
-\TeXLive{} environment, all files referenced on the \CD{}.
-
-
-\smallskip {\small\noindent \textbf{[For advanced users:]} You can
- also use the small batch file \path|mkloctex.bat| to be called in a
- directory \path|setupw32| of the \CD. From the Start menu select
- `Run', then browse CD drive and select \path|mkloctex.bat|. Before
- starting it, you should add two parameters separated by a space: the
- letter of your CD drive and the letter of the hard disk where you
- want to install the \TeX\ directory. The whole line should read,
- e.g., \verb+d:\setupw32\mkloctex.bat d c+. When installation is
- complete, please read carefully the information on screen. If you
- are running Windows 9x/ME, then you will have to restart Windows. }
-
-\subsection{Installing editors or support packages}
-\label{sec:texlive-install}
-
-You can already use the \path|TeXSetup.exe| program to install a
-single, not \TeX{} dependent package. This might be either an editor
-like \cmdname{WinShell} or \cmdname{NTEmacs},
-or also a support package like \cmdname{NetPBM}
-(graphics formats conversion) or \cmdname{Ghostscript}.
-
-Some of the packages are not free, or not with the same meaning as for
-the rest of the \CD{}. These packages have been made available through
-the Internet. You need to enable an Internet connection in order to
-install them. Chosing the \path|Enable Internet access| subitem will
-search your system for an active Internet connection, or start one if
-possible. \emph{If your computer is not connected to the Internet,
- then the timeout might be long, 30s or more}. So try to enable it
-only if you know you have a connection.
-
-Only a few packages are available from the \CD{}, but the most
-important of them: \cmdname{NTEmacs} and \cmdname{WinShell} for the
-editors, \cmdname{Ghostscript} and \cmdname{NetPBM} for the other
-support packages. \cmdname{NetPBM} is needed for running \TeX{}4ht.
-
-The downloadable packages are sometimes huge: \cmdname{Perl} is 10Mb,
-\cmdname{XEmacs} is 50Mb, so be warned that it can take a lot of time
-to install such things. \path|TeXSetup.exe| does not yet provide an
-estimation of the time needed to complete the download.
-
-When installing these packages, \path|TeXSetup| is working in
-unattended mode. However, the programs that have their own installer
-like WinEdt or Ghostscript for example will require human interaction.
-
-Those packages who have no specific installer will be unpacked and configured
-for your system. You will be required to select some directory where
-they will be installed. The directory to select should be the root
-directory of the whole installation. Assuming you want to install
-NTEmacs and NetPBM, the archive files already contain the
-\path|NTEmacs\| and \path|NetPBM\| part, so the directory you have to
-select is something like \path|c:\Local| or \path|c:\Program Files|.
-
-\subsection{Installing to your hard disk}
-
-Installation is started by letting the CD autostart, and
-selecting the item \verb|Install| from the menu, then the subitem
-\verb|TeXLive|. This will invoke the \path|TeXSetup.exe|. You can also find
-it in the \path|bin/win32| directory and run it. \path|TeXSetup.exe|
-is a Windows wizard and it will display several pages while running.
-
-\begin{description}
-\item[Welcome Page]
- You can choose a \emph{quick} installation from
- there, in this case, the installation will run without any human
- assistance from beginning to end, with all the default settings
- (Figure~\ref{graph:setup-src},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). However, if you chose to install any support program that has its
- own installer like WinEdt or Ghostscript, your intervention might be required.
- If you have enough privileges (administrator or power user rights)
- under a Windows version where it is applicable, then you can decide
- to install the \TeXLive{} for all users or for yourself only by
- checking the appropriate box.
-
- \begin{figure*}[!htb]
- The \cmdname{TeXSetup} Wizard\hfill
- Source directories for the \TeXLive{} files
-
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.48\textwidth]{../pictures/setup-wizard.jpg}\hfill%
- \includegraphics[width=.48\textwidth]{../pictures/source-for-texlive.jpg}
- \else
- \ifnum \Status=2
-\includegraphics[bb=0 0 506 403]{../pictures/setup-wizard.gif}
-\includegraphics[bb=0 0 506 403]{../pictures/source-for-texlive.gif}
- \else
- \includegraphics[width=.48\textwidth]{../pictures/setup-wizard}%
- \hfill%
- \includegraphics[width=.48\textwidth]{../pictures/source-for-texlive}
- \fi
- \fi
- \caption{The \TeXLive{} setup wizard}\label{graph:setup-src}
- \end{center}
-\end{figure*}
-\item[Source Page]
- This page is a bit complex. It will allow you to select two source
- directories for your \TeXLive{} system
- (Figure~\ref{graph:setup-src},
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ). You will need a \emph{local
- source directory} and possibly a \emph{remote source directory}.
-
- Why do we need both these directories? The very files of the
- \TeXLive{} system are on the \CD{}, but some other packages useful
- under a Win32 system are not, either because of space lacking or
- because their license was not compatible with the \TeXLive{}'s one.
- You need to enable Internet downloading if you want to install these
- support packages.
-
- However, don't panic: the default parameters of the setup will allow
- you to install a full system using the \CD{} only. Simply, you won't
- have \file{WinEdt} for example, but you will be able to install it
- later.
-
- So you can take your files from:
- \begin{itemize}
- \item the \CD{} or any similar flat tree of files, available through
- some standard directory (this means the \CD{} can be mounted on
- some remote machine and be made available through network
- sharing),
- \item a set of \file{.zip} files (this is the case when you are
- installing the
- \fpTeX{} distribution),
- \item the Internet, in this case, the program takes care of
- downloading the \file{.zip} files it needs for you.
- \end{itemize}
- This option is available only if you enable Internet file
- downloading in the right part of the page. You also need to
- configure this Internet access by selecting to connect either using
- Internet Explorer~5 \file{wininet.dll}, or using a direct connection (\texttt{ftp},
- \texttt{http}).
-% or using a proxy server.
-% Last, you can be assisted in defining the \emph{local source
-% directory} and \emph{remote source directory} which will be used
-% to copy the files onto your hard disk. The \texttt{browse} buttons
-% allow to select a directory for the former, and an url among a list
-% of mirrors for the latter.
-\item[Root Page]
- On this page, you will tell where you want the files to be
- installed (Figure~\ref{graph:root-schm},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). Only the root directory really matters, the other ones
- are set according to the root one. You may want to make
- \path|$TEXMFEXTRA| point to some TDS compliant directory with other
- \TeX{} files or assign a different value to
- \path|$HOMETEXMF|, which is set by default to whatever Windows think
- is your `HOME' location.
-\begin{figure*}[!htb]
- Root and directories\hfill%
- Scheme selection
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.46\textwidth]{../pictures/root-of-installation.jpg}\hfill%
- \includegraphics[width=.46\textwidth]{../pictures/scheme-selection.jpg}
- \else
- \ifnum \Status=2
-\includegraphics[bb=0 0 506 403]{../pictures/root-of-installation.gif}
-\includegraphics[bb=0 0 506 403]{../pictures/scheme-selection.gif}
- \else
- \includegraphics[width=.46\textwidth]{../pictures/root-of-installation}%
- \hfill%
- \includegraphics[width=.46\textwidth]{../pictures/scheme-selection}
- \fi
- \fi
- \caption{\TeXLive-Setup: Root and directories / Schemes}\label{graph:root-schm}
- \end{center}
-\end{figure*}
-\item[Get TPM Page]
- This page does not require any manual intervention. The \file{.tpm}
- files which describe collections and packages are retrieved
- (possibly from the Internet), unzipped if needed and parsed.
-\item[Schemes Page]
- On this page, you will select the global scheme of your
- installation (Figure~\ref{graph:root-schm},
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ). A scheme is a large set of files targeted at some kind
- of usage. There are 3 generic schemes for basic, recommended and
- full installation. The other ones are devoted to LUGs (what GUST or
- GUTenberg propose for their members) or applications (XML and
- \TeX{}).
- When a scheme is selected, it is still possible to refine the
- selection by checking the appropriate box. If doing so, you will be
- presented the packages page to change your selection, else you will
- jump to the review page.
-\item[Packages Page]
- Collections and packages are presented in a tree form
- (Figure~\ref{graph:win32-support},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). The links
- in the tree are dependency links. Collections \emph{depend on}
- packages and maybe other collections, and it is the same for each
- package. You can select any package or collection individually, but
- your request will be granted only if the object is not requested by
- another one which is selected. For example, you can't deselect
- \texttt{tex-basic} without deselecting all the collections that
- request it.
-
- The \texttt{win32-support} collection displayed on the picture is Win32 specific. It
- holds a number of bonus packages (Figure~\ref{graph:win32-support},
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ) which can be installed
- automatically and individually: Ghostscript, the PostScript
- interpreter, \TeX{} oriented editors, tools like Perl,
- \LaTeX{}2HTML, etc. \emph{None of these packages are selected by
- default}. Some of them have an Internet Explorer icon on their
- right, this means that they are not on the \CD{} and they will be
- available only if you previously enabled Internet
- downloading. \emph{This collection cannot be selected entirely at
- once: you need to select the packages individually}. This is to
- avoid unwanted downloads of huge files.
-
- On this page, you also have the information about disk space
- needed, for each object, and for the set of those who are selected,
- and also the disk space available on the partition selected for the
- installation. Last, you can choose to install or not the
- documentation files and source files associated with each package.
-\item[Review Page]
- You will find there a summary of your choices
- (Figure~\ref{graph:review},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). It is still time to
- go back to change them.
-\begin{figure*}[!htb]
- Packages Page\hfill%
- Win32 Support
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.48\textwidth]{../pictures/package-selection}\hfill%
- \includegraphics[width=.48\textwidth]{../pictures/win32-support}
- \else
- \ifnum \Status=2
-\includegraphics[bb=0 0 506 403]{../pictures/package-selection.gif}\hfill%
-\includegraphics[bb=0 0 506 403]{../pictures/win32-support.gif}
- \else
- \includegraphics[width=.48\textwidth]{../pictures/package-selection}%
- \hfill%
- \includegraphics[width=.48\textwidth]{../pictures/win32-support}
- \fi
- \fi
- \end{center}
- \caption{Packages Page / Win32 goodies}
- \label{graph:win32-support}
-\end{figure*}
-\item[Files Copy Page]
- The selected files are copied on your hard disk (Figure~\ref{graph:file-copy},
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ). All the files not
- yet available on your local disk are first downloaded from the
- remote source directory on the Internet. Then every package is
- unpacked (if \path|.zip| files), or copied from the \CD{}.
-\item[Configuration Page] Several packages need some configuration
- step to make them usable (Figure~\ref{graph:configuration},
- \ifnum \Status = 1
- on the left%
- \else\ifnum \Status=2
- at the top%
- \else
- on the left%
- \fi\fi
- ). Also the \TeXLive{} system needs some post-processing step
- (format files generation, ls-R databases generation, environment
- variables, etc.). All these operations are done there, some of them
- can be lengthy.
-\begin{figure*}[!htb]
- \textbf{Review Page}\hfill%
- \textbf{File Copy Page}
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.48\textwidth]{../pictures/review-settings}\hfill%
- \includegraphics[width=.48\textwidth]{../pictures/file-copy}
- \else
- \ifnum \Status=2
- \includegraphics[bb=0 0 506 403]{../pictures/review-settings.gif}\hfill%
- \includegraphics[bb=0 0 506 403]{../pictures/file-copy.gif}
- \else
- \includegraphics[width=.48\textwidth]{../pictures/review-settings}\hfill%
- \includegraphics[width=.48\textwidth]{../pictures/file-copy}%
- \fi
- \fi
- \end{center}
- \caption{Review Page / File Copy Page}
- \label{graph:review}\label{graph:file-copy}
-\end{figure*}
-\item[Final Page] The installation being over, you may want to display
- the Windows specific documentation (HTML format) and / or the log
- file of the setup process (Figure~\ref{graph:final}
- \ifnum \Status = 1
- on the right%
- \else\ifnum \Status=2
- at the bottom%
- \else
- on the right%
- \fi\fi
- ). If it is needed (Win9x/WinME), you will
- be asked to reboot your computer.
-\end{description}
-
-\begin{figure*}[!htb]
- \textbf{Configuration Page}\hfill%
- \textbf{Final Page}
- \begin{center}
- \ifnum \Status=1
- \includegraphics[width=.48\textwidth]{../pictures/configuration}\hfill%
- \includegraphics[width=.48\textwidth]{../pictures/congratulations}
- \else
- \ifnum \Status=2
- \includegraphics[bb=0 0 506 403]{../pictures/configuration.gif}\hfill%
- \includegraphics[bb=0 0 506 403]{../pictures/congratulations.gif}
- \else
- \includegraphics[width=.48\textwidth]{../pictures/configuration}\hfill%
- \includegraphics[width=.48\textwidth]{../pictures/congratulations}%
- \fi
- \fi
- \end{center}
- \caption{Configuration Page / Final page}
-\label{graph:configuration}\label{graph:final}
-\end{figure*}
-
-Please be aware that the choice of cluster size on DOS disk
-partitions can radically affect the size of your \TeX\
-installation. The support tree has hundreds of small files, and it is
-not unusual for a complete installation to take up to 4 times the
-amount of space used on the \CD.
-
-
-\section[Maintenance and other aspects of the \protect\TeXLive{}
-installation under Windows]{Maintenance and other aspects of the \protect\TeXLive{}
-installation under Windows}
-
-\subsection{What's different under Win32 from the standard \Webc ?}
-The Win32 version of \Webc{} has some specific features that need to
-be noticed.
-
-\begin{description}
-\item[\KPS{}] the hash-tables that \KPS{} builds are quite large for
- the \TeXLive{}. In order to cut down the starting time of any
- \KPS{}-enabled program, these hash-tables have been put in shared
- memory. This way, when you chain the execution of several such
- programs, like \path|tex| calling \path|mpost| calling \path|tex|,
- the overhead when starting each of the programs but the first will
- be reduced. This change is hidden to the user, except if you set the
- debug flag of kpathsea to the \path|-1| value: you will then trace
- access to the shared memory, which is not what you want (it is
- accessed very often!). What is useful in a log trace of the shared
- memory access is still to be defined, so the situation might evolve
- in the future.
-\item[\cmdname{kpsecheck}] this command provides some option that did
- not fit well into \cmdname{kpsewhich}. It will allow you to list all
- the files that occur multiple times across your texmf trees. This
- could be handy, but most of the time you will also get unwanted
- output (like dozens of \path|README| files)\footnote{It is noticeable
- that all these files result in clashes inside the \KPS{}-hashing
- mechanism, fortunately, \KPS{} never look for these files.}. For
- this reason, you can combine the \path|-multiple-occurences| with 2
- other options for including or excluding any filename that match
- some pattern (you can request for several patterns).
-
- The \cmdname{kpsecheck} command will also report the status of
- shared memory: in use or not used. That might be useful to know
- because if the status reported is ``in use'', that means one or
- several processes are working, and the effect of any
- \cmdname{mktexlsr} command will be delayed until the next time where
- no \KPS{} linked process will be running.
-
- Last, this same command will report about the location it thinks
- Ghostscript can be found. Under Win32, for many programs, it is
- easier to use the Ghostscript dll, and find it by using the
- Ghostscript registry key than to change the \path|PATH|, which has a
- limited length anyway.
-\item[\Webc{}] the engines have a few more options than the ones from regular
- \Webc{}, and one option with a different behaviour:
- \begin{itemize}
- \item the \path|-fmt| option behaves differently. Previously and
- with the regular \Webc{} distribution, this option has 2 different
- meanings when you are in ``ini'' or ``vir'' mode. Under Win32, it
- has the same meaning: preload the format file specified with the
- argument. The meaning of building a format of such name in ``ini''
- mode is obtained by the new \path|-job-name| option.
- \item \path|-job-name| option: allows to set the name of the file
- resulting from the compilation process. In normal mode, it will
- change the base name of all files produced (\path|.dvi|,
- \path|.aux|, etc.), while in ``ini'' mode, it will set the name of
- the format file written.
- \item \path|-halt-on-error| stop the compilation at the first error.
- \item \path|-job-time| set the job time to the same timestamp as the
- file given in argument.
- \item \path|-output-directory| allow to write all the output files in the
- specified directory.
- \item \path|-time-statistics| print statistics about the job run
- time. It is to be noted that Win9x not being a true multitasking
- operating system, it has no reliable timer for short periods, so
- the value printed is an approximation. Under NT/2K/XP, the result
- is quite accurate with user time and system time values allocated
- for this run. For Unix
- users: the \path|time| command is not usually available to Windows
- users.
- \end{itemize}
-\end{description}
-
-\subsection{Adding packages to your installation}
-
-You will find an option in the \texttt{TeXLive} menu (or go to
-\texttt{Start -> Programs -> TeXLive -> Add TeX package} menu) to run again
-\file{TeXSetup.exe}, but in maintenance mode this time. The steps you
-will go through are almost identical to the ones the first time you
-run it.
-
-The only different step is about the packages selection page. In
-maintenance mode, the list of installed packages is compared to the
-list of packages available from your source directories. Packages that
-are not installed will be displayed in green, out of date packages
-will be displayed in red and up to date, installed packages are
-displayed in black.
-
-This way, you can choose to add or upgrade components, either from
-your \CD{} or from the
-Internet, where you are likely to find some more recent version of
-your packages.
-
-It is up to you to select which ones of the packages you want to
-install. The rest of the process is similar to the first installation.
-
-If you want to add files that are not provided by the \TeXLive{} (or
-\fpTeX{}) distribution, it is recommended to put them in the
-\path|$TEXMFLOCAL| directory. This way, you will be safe against
-upgrades of the \TeXLive{} software.
-
-The directory pointed to by \path|$TEXMFLOCAL| is initially empty. If
-you want to add there the support file for Maple (symbolic computation
-program) for example, you will have to put the style files in:\\
-\path|c:\Program Files\TeXLive\texmf-local\tex\latex\maple\|\\
-and the documentation files in:\\
-\path|c:\Program Files\TeXLive\texmf-local\doc\latex\maple\|
-
-Next, \textbf{do not forget to rebuild the ls-R databases files},
-either by using the right menu (Start -> Programs -> TeXLive
- -> Maintenance), either by manually running the \file{mktexlsr}
- command.
-
-\subsection[Removing \protect\TeXLive{} from your hard disk]{Removing
- \protect\TeXLive{} from your hard disk}
-
-The uninstall procedure is available either from the
-\file{TeXLive.exe} program, from the \path|TeXLive| menu or from the
-control panel (Start menu -> Control Panel, Add/Remove Programs
-option). This procedure will cleanup your hard disk of most of the
-\TeXLive{} files. However, \TeX{} is a system that is creating files
-and there is no mechanism to keep track of all of them. Moreover,
-Win32 support packages have their own uninstall procedure, which you
-will have to run separately (provided you want to get rid of them). Last,
-the files you may have stored in \path|$TEXMFLOCAL| won't be
-removed. So, even if the vast majority of files are automatically
-removed by the uninstall procedure, you will have to do some manual
-cleanup to actually remove all of them.
-
-\subsection{Running \texttt{TeXSetup.exe} from the command line}
-
-The \path|TeXSetup.exe| program has a number of other interesting
-options. You can get the list by running:
-\begin{verbatim}
-c:\>TeXSetup --help
-\end{verbatim}
-
-Here is the description:
-\begin{description}
-\item[\path|--automatic-reboot|] reboot without waiting user
- confirmation once installation is over;
-\item[\path|--dry-run|] do nothing, just log everything that will be
- done without this option;
-\item[\path|--quick|] use the recommended installation and default
- directories, ask nothing up to rebooting;
-\item[\path|--net-method (=ie5/direct)|] enable to download components with
- restricted licenses from the Internet (either using direct
- connection of Internet Explorer 5 DLLs): you need to have an available
- network connection and some of the packages are huge;
-\item[\path|--remote-source-directory <url>|] this is the base url for the remote packages;
-\item[\path|--local-source-directory <dir>|] by default, \path|TeXSetup.exe|
- will guess the root directory of the set of files you want it to act on, if you ever
- upgrade \path|TeXSetup.exe|, you won't be able to copy the new version
- onto your \CD{}, so you will need to use this option to specify the
- root of the \CD{};
-\item[\path|--installation-directory <dir>|] this is the root of your
- installation, all files will be copied under this location. The
- default value is \verb+c:\Program Files\TeXLive+;
-\item[\path|--texmfmain-directory <dir>|]
-\item[\path|--texmflocal-directory <dir>|]
-\item[\path|--texmfextra-directory <dir>|]
-\item[\path|--texmfhome-directory <dir>|]
-\item[\path|--vartexmf-directory <dir>|]
-\item[\path|--vartexfonts-directory <dir>|] these are the directories
- used to configure the location of your files. They map directly to
- the \path|texmf.cnf| variables.
-\item[\path|--with-source-files(=yes/no)|] copy the source files
- for \TeX{} packages, default value is no;
-\item[\path|--with-documentation-files(=yes/no)|] copy documentation files for \TeX{}
- packages. Default value is yes. Beware: this is only documentation about specific
- packages, general documentation will be installed anyway;
-\item[\path|--program-folder <folder>|] the name of the folder under
- which you will find the menus;
-\item[\path|--add-package <pkg>|] this is used to add or update a specific
- package after a first regular installation;
-\item[\path|--scheme <pkg>|] install the named scheme instead of the
- default \path|texlive-recommended| scheme;
-\item[\path|--maintenance|] mostly the same as \path|--add-package|
- without specifying a package to add;
-\item[\path|--uninstall|] this option will remove anything \TeX{} related coming from
- the \CD{}, which means there can be files left if you added style
- files or format files, and also that supplementary tools will not be
- removed\footnote{This option is still a bit crude as of \today};
-\item[\path|--help|] this option opens up a box with the list of options.
-\end{description}
-
-\subsection{Network installation}
-
-\KPS{} knows about UNC names, so you can use them to get your TEXMF
-tree from the network. But there is better than this.
-All the support files and configuration files, everything except the files in the
-\path|bin/win32| are shareable with a \teTeX{} or Unix \TeXLive{} installation. That means
-you can use Samba either to mount from an NT server to a Unix
-workstation or the converse. Several strategies are possible:
-\begin{itemize}
-\item Put everything on the server. Just add each set of files for the os and
-architecture you want to use in the \path|bin| directory. That means
-for example \path|bin/win32| and \path|bin/i386-linux|. Next configure
-your main variables. You can use UNC names to
-point to the right directories under Win32.
-\item Install a local copy for the binaries and format files. In this
- case, assign \path|$TEXMFMAIN| to the main \path|texmf| tree that
- will be accessed remotely. Set \path|$VARTEXMF| to be a local
- directory which will hold local configuration files and on-the-fly
- generated files.
-\end{itemize}
-
-\subsection{Personal Configurations}
-
-\subsubsection{\cmdname{WinShell}}
-\label{sec:winshell}
-
-Start this program from the Start menu or from the Desktop shortcut.
-Go to \textbf{Options} \verb+->+ \textbf{Program Calls}.
-
-\begin{itemize}\itemsep 0pt
-\item In the DVIWin tab, if the filename is \textbf{yap}, replace it
-with \textbf{windvi.exe}.
-\item In Ghostview tab, make sure it gives the correct path for
-gsview32.exe:\\
-\hspace*{1em} \verb+C:\ghostgum\gsview\gsview32.exe+ (for 3.6, the
-current version)\\
-or \\
-\hspace*{1em} \verb+C:\gstools\gsview\gsview32.exe+ (for the older
-version)
-
-\end{itemize}
-
-Click \textbf{OK}.
-
-Note that the install process sets all files with the \texttt{.tex}
-extension to open with \cmdname{WinShell}. Unless you plan to use another editor
-(such as WinEdt or Emacs), this is appropriate.
-
-Unfortunately, \cmdname{WinShell} does not have a spell-checking feature.
-However, if you have installed the \path|tex-extrabin| collection,
-your installation includes \textbf{Ispell} (a spell checking program
-found on most Unix systems). The executable is in your PATH so
-\verb+ispell.exe+ will be found if you invoke it from a DOS window.
-If you installed documentation, look
-at\\
-\verb+C:\Program Files\TeXLive\texmf\doc\html\manpages\ispell.html+\\
-for information on Ispell. (Otherwise, you can find
-\verb+ispell.html+ on the CD.) If you rely on spell checking, you may
-want to add an Ispell icon to \cmdname{WinShell}. See
-subsection~\ref{winshell:ispell} of this document for how to do that.
-
-For an excellent commercial (but inexpensive) spelling checker,
-see \url{http://www.microspell.com}.
-
-%Appendix B also contains other information about using \cmdname{WinShell}, such as:
-%
-%\begin{itemize}
-%\item How to apply a bug fix you probably need
-%\item How to print directly from \cmdname{WinShell}
-%\item How to use the Project feature for multiple-file documents
-%\end{itemize}
-
-\cmdname{WinShell} also has on-line help, which you can access via the
-$\textbf{\underbar{?}}$ on the menu bar.
-
-Other information about using \cmdname{WinShell} can be found in
-section \ref{winshell:more} on p.~\pageref{winshell:more}.
-
-\subsubsection{Dvips}
-
-The configuration file for dvips can be found in\\
-\verb+C:\Program Files\TeXLive\texmf-var\dvips\config\config.ps+\\
-You may open it with any editor (\cmdname{WinShell} will do fine) and change
-some parameters:
-
-\begin{description}
-\item [fonts] you can change the default printer \MF{} mode or printer
- resolution in case dvips needs to generate PK fonts. By default it
- is configured to use type1 versions of the CM fonts, so it should
- not call \cmdname{mktexpk} too often;
-\item[printer] you can tell dvips where you want to print by
- default. If the `o' option is not followed by a printer name, then a
- \file{.ps} PostScript file is written. You can give dvips a printer
- name such as:
-\begin{verbatim}
-o lpt1:
-% o | lpr -S server -P myprinter
-% o \\server\myprinter
-\end{verbatim}
-\item[paper] Next, you might want
- to change the paper size from European (A4) to US letter
- by making the US letter the first paper size mentioned in the file.
- Scroll to the group of lines beginning with ``@''. Move
- the appropriate lines so that this section begins with the lines:\\
-\hspace*{1em} @ letterSize 8.5in 11in\\
-\hspace*{1em} @ letter 8.5in 11in\\
-\hspace*{1em} @+ \%\%BeginPaperSize: Letter\\
-\hspace*{1em} @+ letter\\
-\hspace*{1em} @+ \%\%EndPaperSize
-\end{description}
-
-\textbf{Note:} The current \TeXLive{} distribution has implemented (for
-the first time!) the procedure of making always up-to-date fontmaps files
-for Dvips and Pdftex. This is done by \cmdname{updmap} program
-during installation, as well as during any font package addition.
-If you add new packages by hand, edit the file \verb+updmap.cfg+
-in \path|$VARTEXMF/web2c|.
-
-\subsubsection{Pdftex}
-If you want to use the program pdf{}latex to convert directly to
-pdf format, and you are using US letter file, edit the file\\
-\verb+C:\Program Files\TeXLive\texmf-var\pdftex\config\pdftex.cfg+\\
-and change ``page\_width'' and ``page\_height'' to specify letter-size paper.
-These entries should read:\\
-\hspace*{1em} page\_width 8.5 true in\\
-\hspace*{1em} page\_height 11 true in\\[6pt]
-Save the file and exit the editor.
-
-\subsubsection{GSView}
-Starting from versions compatible with Ghostscript 6.50, GSView is not
-free anymore, but shareware. So it is not on the \CD{} anymore.
-
-You may want to change the papersize to US letter size. If so,
-open GSView from the Start menu. \\
-From the \textbf{Media} menu, select \textbf{Letter}.
-
-Also, there are menu settings that are supposed to give you the
-most readable screen image:\\[4pt]
- From \textbf{Media} \verb+->+ \textbf{Display Settings},
-set \textbf{Text Alpha}
-and \textbf{Graphics Alpha} both to 4 bits.
-
-Note that the installation process has set all .ps and .eps files
-to automatically open with GSView.
-
-For printing instructions, see section~\ref{printing} below.
-
-\subsubsection{WinDvi}
-\label{sub:windvi}
-
-The \file{TeXSetup.exe} program takes care of associating the files
-with the \file{.dvi} extension with \file{Windvi}.
-
-Open it from the Start menu (Programs \verb+->+ TeXLive \verb+->+ DVI Viewer).
-You can set it for US letter paper by going to \textbf{View} \verb+->+ \textbf{Options}
-and next to \textbf{Papertype},
-selecting US (8.5\verb+"+ x 11\verb+"+).
-Click \textbf{OK}.
-Exit Windvi.
-You can change other parameters from there, like the ability to
-execute commands included in path|\special{}|.
-Also, the first time you
-view any .dvi file, you may find the magnification too large. Zoom out
-until you get an appropriate size.
-
-%There are two important parameters related to printing that can't yet
-%be set from the dialog boxes, namely the resolution and the \MF{} mode
-%for the printer. You can set them once for all by specifying them on
-%the command line:
-%\begin{verbatim}
-%c:\>windvi -p 360 -mfmode canonbjc foo.dvi
-%\end{verbatim}
-%When you will exit Windvi, these parameters will be stored in the
-%configuration file. The available modes are found in this file:\\
-%\path|c:\Program Files\TeXLive\texmf\metafont\misc\modes.mf|
-
-All the configuration for Windvi is stored in the
-\path|$HOME/windvi.cnf| file. You can find it by running this command
-at the prompt:
-\begin{verbatim}
-c:\>kpsewhich --expand-var $HOME/windvi.cnf
-\end{verbatim}
-
-Should you have problems with Windvi, please remove the configuration
-file and test your problem against a vanilla configuration.
-
-\subsection{Testing}
-
-You can test \cmdname{WinShell} by opening the file \verb+sample2e.tex+, found in
-\path|C:\Local\TeX\texmf\tex\latex\base|. The \LaTeX\ source should appear
-on the screen. Process it by clicking on the \LaTeX\ icon on the toolbar,
-then view it by clicking on the Preview (Windvi) icon.
-
-At first, when you preview files with Windvi, 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.
-Return to \cmdname{WinShell} and try dvips, then GSView.
-
-\textbf{Hint for the future:} If a \LaTeX\ run stops because \LaTeX\
-cannot find a file, you can press \textbf{Ctrl-z} to quit.
-
-\subsection{Printing}\label{printing}
-
-It is possible to print from Windvi. In this case, printing will
-be done using the Windows unified printer driver. By definition, it
-is compatible with all printers. However, there is some drawback: it
-can generate some huge spool files, and some (older) versions of Windows just
-don't like them. The advantage is that you can use features like
-embedding BMP or WMF images. You also need to make sure that the
-printer parameters are correctly set (subsection~\ref{sub:windvi}),
-else you will get scaled printing (printing at 600dpi on a 300dpi
-printer will give you only one quadrant of your page).
-
-
-Printing is faster and more reliable if you run dvips to make a
-.ps file and then print from GSView. To print from GSView, first select
-\textbf{Print...} from the \textbf{File} menu. A Print window will appear.
-
-If you will be using a PostScript printer, \textit{be sure to select
-\textbf{PostScript Printer}}. In the newer version this is done in
-the ``Print Method'' box at the bottom left of the Print window. You
-can then select any of the printers that you have previously installed
-on your PC. If you fail to check the box for PostScript Printer,
-printing will not work.
-
-If you will be using your own non-PostScript printer, select
-\textbf{Ghostscript device} in the ``Print Method'' box, then click on
-the button to the right labelled \textbf{djet500} and select your
-printer type from the list that pops up. (In the older version of
-GSView, make sure PostScript Printer is \textit{not} selected, then
-select your printer type from the ``Device'' list.)
-
-If you use \cmdname{WinShell} and a PostScript printer, probably the most
-convenient way to print is to add an icon to the \cmdname{WinShell} toolbar that
-invokes dvips in a way that sends the output directly to a default
-printer. For detailed instructions on how to do this, see
-\ref{winshell:print} on p.~\pageref{winshell:print}
-(\textit{More About \cmdname{WinShell}}).
-
-\subsection{More About \cmdname{WinShell}}\label{winshell:more}
-\subsubsection{Installing Bug Fixes}
-
-\cmdname{WinShell}'s author (\href{mailto:idb@winshell.de}{Ingo de Boer},
-thanks to him) sometimes releases beta versions of the next \cmdname{WinShell}
-version which are also bug fixes. You can grab them from
-\url{http://www.winshell.de}. Usually they are \file{.zip} files that
-only require to be unpacked in \cmdname{WinShell} directory (\path|c:\Program
-Files\WinShell| by default), either using WinZip or a similar tool, or
-by using \file{unzip} on the command line. If you got some
-\file{winshellbugfix.zip} file and that you saved it in the \cmdname{WinShell}
-directory, then you need to run:
-\begin{verbatim}
-c:\>cd c:\"Program Files"\WinShell
-c:\>c:\local\bin\unzip winshellbugfix.zip
-\end{verbatim}
-Say `yes' if you are asked if some files should be overwritten. The
-\path|unzip.exe| programme can be found in the
-\path|support/gnu-utils| package. If you
-do not have it on your machine, you can use any archiver tool like
-WinZip to achieve the same effect.
-
-\subsubsection{Using the Project Feature}
-If your document is split into several files
-(for example a thesis), look into \cmdname{WinShell}'s ``Project'' feature. From the
-\textbf{Project} menu, you give the project a name (e.g., Thesis),
-supply the name of the main (or root) file, and then ``add'' other
-files. These filenames display on the left of the screen where you can
-double click the names to view and switch between them. Clicking
-the \textbf{\LaTeX} icon always processes the main file.
-
-Note the icons on the toolbar for toggling the project space (on the left)
-and the log space (at the bottom). If you are not using the Project
-feature, you may want to toggle off the space on the left, using the full
-screen width to display your file.
-
-\subsubsection{Printing from \cmdname{WinShell} to a PostScript Printer}
-\label{winshell:print}
-
-The Dvips icon on the \cmdname{WinShell} toolbar puts the PostScript output in a file,
-which you can then view with GSView and print from there if you choose.
-However, it's convenient to add a \cmdname{WinShell} ``program call'' to dvips which
-sends the output directly to a designated PostScript printer. The steps
-below show how to do this for the printer \textbf{vclw}; you should
-substitute the name of your most frequently-used printer for \textbf{vclw}.
-\begin{enumerate}
-\item Make the program aware of the printer:
-\begin{itemize}
-
-\item Open \cmdname{WinShell}, go to \textbf{Options} \verb+->+
-\textbf{Program Calls} \verb+->+ \textbf{User defined}.
-
-\item Click on \textbf{Tool 1} in the list on the right and fill in the
-fields to the left as follows:\vspace{-6pt}
-\begin{quote}
-Name: \verb+Print+\\
-exe file: \verb+dvips+\\
-cmd-line: \verb+ -D600 %m -o vclw+\\
-Uncheck the box for ``DVIPS first''
-\end{quote}%\vspace{-12pt}
-\item Click \textbf{OK}
-\end{itemize}
-\item Add Print to the toolbar:
-\begin{itemize}
-\item Go to \textbf{Options} \verb+->+ \textbf{View} \verb+->+ \textbf{Customize}.
-\item In the Category box, select \textbf{User-Programs}.
-\item Select \textbf{Print} and drag it to the toolbar, placing it just to
- the right of the GSView icon.
-\item You then have a choice of ``Image only'', ``Text only'', or ``Image and
-Text''. The easiest is to select ``Text only'' and click \textbf{OK}.
-You should then see \textbf{Print} on the toolbar. (If you prefer, you can
-select ``Image only'', then ``Edit'', and edit the displayed picture to your
-satisfaction.)
-\end{itemize}
-\end{enumerate}
-Now, to print a \LaTeX\ document, just click on the \textbf{Print} icon to
-send to your selected printer. To use a different printer, you will need to
-click on the \textbf{Dvips} icon to print to a file. Then click on the
-GSView icon and use GSView to send to any printer you have installed on
-your PC.
-
-\subsubsection{Adding Ispell to \cmdname{WinShell}}
-\label{winshell:ispell}
-\begin{enumerate}
-\item Add Ispell to User Tools:
-\begin{itemize}
-\item Open \cmdname{WinShell}, go to \textbf{Options} \verb+->+
-\textbf{Program Calls} \verb+->+ \textbf{User defined}.
-\item In the list on the right, click on \textbf{Tool 1} (or \textbf{Tool
- 2} if you have already used \textbf{Tool 1}) and fill in the
-fields to the left as follows:\vspace{-6pt}
-\begin{quote}
-Name: \verb+Ispell+\\
-exe file: \verb+ispell+\\
-cmd-line: \verb+ -t -d american %c.tex+\\
-Uncheck the boxes for ``LaTeX first'' and ``DVIPS first''
-\end{quote}%\vspace{-12pt}
-\item Click \textbf{OK}
-\end{itemize}
-
-\item Add Ispell to the toolbar: %\vspace{-14pt}
-\begin{itemize}\itemsep 0pt
-\item Go to \textbf{Options} \verb+->+ \textbf{View} \verb+->+ \textbf{Customize}.
-\item In the Category box, select \textbf{User-Programs}.
-\item Select \textbf{Ispell} and drag it to the toolbar, placing it just to
- the right of the GSView icon (or the last icon you added).
-\item You then have a choice of ``Image only'', ``Text only'', or ``Image and
-Text''. The easiest is to select ``Text only'' and click \textbf{OK}.
-You should then see \textbf{Ispell} on the toolbar. (If you prefer, you can
-select ``Image only'', then ``Edit'', and edit the displayed picture to your
-satisfaction.)
-\end{itemize}
-\end{enumerate}
-Now, when you have a \LaTeX\ document open, you can click on
-\textbf{Ispell} to perform spell checking. Ispell will open another window
-and display the first misspelled word on the left with the filename on the
-right. Below that you will see the context in which the misspelling appears;
-often several suggestions for replacements are also displayed. To replace
-the word, enter the number corresponding to the desired replacement. Other
-possible responses are listed below; for example, you can press the space
-bar to ignore the misspelled word. For more information on Ispell, read the
-manual page: \verb+C:\Program Files\TeXLive\texmf\doc\html\manpages\ispell.html+.
-
-Note that when you replace a word, you will not see the correction in your
-\cmdname{WinShell} window until you close the file (click the X in the upper right
-corner) and then open it again (use the File menu).
-
-\subsection{Tips and tricks about the Win32 platform}
-
-\subsubsection{Different flavors of Win32}
-
-What we call Win32 is not an operating system by itself. It is a set
-of functions -- and a large one\footnote{Around 12000 functions in the
- header files of the Microsoft SDK} -- that you can use to write
-programs for different operating systems of the Windows family.
-
-Windows comes in different flavors:
-\begin{itemize}
-\item Win95, Win98 and WinME, which \emph{are not true multitasking,
- multithreading} environments. They are the latest -- and hopefully
- last -- metamorphosis of DOS. This can be more or less proven by the
- fact that when booting, the PC will load the \path|command.com|
- interpreter, and if you stop the boot process at this point, you can
- ask for the current (DOS) version and it will answer something like
- 'MS-DOS 7.0' (at least for the old versions of Win9x);
-\item Windows NT, which is a new operating system written from scratch,
- capable of
- true multitasking behaviour, and loaded with high level features;
-\item Windows 2K, written on an NT basis, with all the bells and
- whistles of Win98.
-\item Windows XP, which comes with Personal and Pro flavors. This is
- the last step in merging both lines of products (Win9x based and NT
- based). XP is written on an NT basis.
-\end{itemize}
-
-Win9x are able to run 32~bits programs and 16~bits programs
-concurrently. But the operating system by itself is not entirely
-written in 32~bits mode, and does not support memory protection: 16bits
-applications can overwrite parts of the operating system memory! Some
-parts of the system like the GDI (Graphical Device Interface) manage
-limited resources like bitmaps, fonts, pens and so on for the set of
-all programs that run concurrently. All the bitmaps headers available
-at the same time can't amount for more than 64kb. This explains the
-performance tool and the fact that you can put your system on his
-knees by making intensive use of graphic objects for example.
-
-NT, 2K and XP do not suffer from these limitations, and neither from
-other Win9x limitations. They are true multitasking environments, with
-protected memory. They are much more responsive than Win9x because
-of better memory management, better file system and so on.
-
-\subsubsection{Command line prompt}
-
-You will wonder: ``why would I need to use a command line prompt when
-I have Windows?''.
-
-Good question. The problem is of very general nature. Not all
-operations can be done easily using only a GUI. Command line gives you
-programming power -- assuming a clever command interpreter.
-
-But the problem here is more fundamental: \TeX{} is \emph{a batch}
-tool. Not an interactive one. \TeX{} needs to compute the best
-layout for each page, resolve cross-references and so on. This can be
-done only by a global processing of the document. It is not (yet) a
-task that can be done interactively.
-
-This means that you should use \TeX{} from a command line. In fact the
-situation is not so bad. There is an advantage to write command line
-tools for complex processing: they are better debugged, because not
-tied to GUI problems, and GUI tools can be designed to interface the
-command line tools. This is the case for \TeX{} where you will
-interact with it most of the time through a GUI text editor -- see
-section~\ref{sec:winshell} for example.
-
-However, you may need to use the command line prompt in a number of
-situations, by example in case of problems and you want to debug your
-setup -- see
- section~\ref{sec:troubleshooting}.
-
- \begin{description}
- \item[Win9x] You will open a command line prompt by looking either
- for the MS-DOS icon in the ``Start->Programs'' menu, either by
- choosing ``Start->Run'' menu and typing in \path|command.com|
- \item[NT, 2K, XP] You will open a command line prompt by looking
- for the ``Command Prompt'' in the ``Start->Accessories''
- menu\footnote{These locations may change across different OS
- versions.}. You can also choose the ``Start->Run'' menu and type
- in \path|cmd.exe|, which is the name of the brand new command
- interpreter for NT\footnote{Which explains why it is untrue to
- call this a \emph{DOS} box under NT!}.
-\end{description}
-
-\subsubsection{Path separators}
-
-The Win32 API understands both \path|/| and \path|\| characters as
-PATH separators. But the command interpreters do not! So whenever a
-path name is used programmatically, you can use both separators, and
-even mix them up in the same path name. But on the command line, you
-must type \path|\| as path separator. The reason is compatibility:
-the command processor used the \path|/| to introduce arguments to
-commands.
-
-All this to say: do not be surprised to read path names written using
-the Unix convention; \fpTeX{} is a port of \Webc, and aims to be compatible
-across platforms. For this reason, all the configuration files that
-need to specify path names use the Unix convention.
-
-\subsubsection{File systems}
-\label{sec:clusters}
-
-The worse feature of Win9x with regard to \TeX{} is probably the
-so-called FAT file system. \TeX{} uses many many small files, with
-size around 1kb -- 3kb. The FAT file system is old, and predates by
-far the multi-gigabytes hard disks we have today. It means it can't
-manage efficiently the 30000 \TeX{} files found on the \CD{}. The FAT
-file system will allocate a minimum of 32kb for \emph{any} file on a
-huge partition. It means that \TeX{} will use much more disk space
-than it actually needs.
-
-The other, more modern, file systems available -- namely FAT32 and
-NTFS -- do not have this drawback. They manage clusters of 4kb
-only\footnote{You can lower the limit to 512 bytes on NTFS}.
-
-\subsubsection{How to add some directory to your PATH}
-
-There are pairs of variables and values which behave much like global
-variables inside your programs. The set of those variables is called the
-environment. Each program is initialized with a copy of the
-environment when it is run. It can request and change the
-value of any variable. The changes happen in the copy of the
-environment, and is not at all propagated to the other running
-programs.
-
-Your PATH is a special environment variable used to search for
-programs you want to run.
-There is a different procedure to change it for Win9x, WinME and NT/2K/XP:
-
-\begin{description}
-\item[Windows 95/98] Edit your \path|autoexec.bat|. In this file should be a line
- starting with \texttt{PATH=} and followed by a list of directories separated
- 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:\"Program Files"\TeXLive\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
- environment variable. From this program, select the `Environment'
- tab, and then add or modify the variable you want. You will be asked to reboot the
- machine upon any change.
-\item[Windows NT/2K/XP]
- Click left on \texttt{Start --> Settings --> Control Panel}. Now the window
- with the control panel icons opens. Double click on System. The
- System Properties window opens. Click on the tab
- \textsf{Environment} or look for a button named `Environment
- Variables' among the dialog boxes. Now
- you can change the environment variables for your user account. Note:
- There are also displayed the environment settings for the system.
- Normally, you can't change the system variables unless you have
- administrator rights on your machine. If you want to change the \texttt{PATH}
- for all users, you will have to contact your system administrator or
- be the system administrator yourself--in the later case you should
- know what you are doing.
-
- If there is already a \texttt{PATH} setting for your user account,
- left click on \texttt{PATH}. In the field \textsf{Variable} appears
- \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:\Program Files\TeXLive\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
- the \textsf{Apply} button before clicking \textsf{Ok}, otherwise the
- changes to \texttt{PATH} won't apply to your system. Be careful when
- changing the environment settings.
-\end{description}
-
-The best way to be sure that a variable has been properly set is to
-open a console and type:
-\begin{verbatim}
-set VARIABLE
-\end{verbatim}
-which should return the corresponding value.
-
-\subsubsection{\TeX{} engines}
-
-If you have a look at the \Webc{} documentation, you will read that all
-the various \TeX{} derived programs use the same base engine. For
-example, \path|tex.exe| and \path|latex.exe| are exact copies of the
-same program, but each one will use a different format file, based on
-its calling name.
-
-Under Unix, this feature is implemented through \emph{symbolic
- links}. It saves up a bit of disk space, because some engines are
-used with many different format files.
-
-The Win32 API does not know about file links. So to save up almost
-the same amount of memory, all the \TeX{} base engines have been put
-in DLLs (\emph{Dynamic Linked Library}). This means that you will have
-the following layout:
-\begin{alltt}
-13/05/2002 17:06 3 584 latex.exe
-13/05/2002 17:06 266 240 tex.dll
-13/05/2002 17:06 3 584 tex.exe
-\end{alltt}
-and the \path|latex.exe| file is nothing but a rough copy of
-\path|tex.exe| using the same core \path|tex.dll|.
-The same trick has been used for the \path|mktex*.exe| family of programs which are
-linked to the \path|mktex.dll| library.
-
-In fact, a generic tool called \path|lnexe.exe| is provided to build the
-equivalent of Unix hard links for executable files only under Win32.
-
-\subsection{In case of problems}
-\label{sec:troubleshooting}
-
-\subsubsection{What to do if \texttt{latex} does not
- find your files?}
-
-\begin{itemize}
-\item \cmdname{kpsewhich} is the tool of choice to debug any
-problem. Unfortunately, kpsewhich outputs debug information to
-stderr, and the Windows console does not know how to redirect stderr
-to a file\footnote{Well, NT and Win2k consoles know how to do
- that. But the trick will work for any console.}.
-For diagnostic purposes you can temporarily set an
-environment variable (in DOS box):
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=err.log
-\end{verbatim}
-You can also set the debug level:
-\begin{verbatim}
-SET KPATHSEA_DEBUG=-1
-\end{verbatim}
-
-If you want to redirect stderr to stdout, which is not possible under
-either W9x or NT/2K/XP, then just do:
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=con:
-\end{verbatim}
-This way you can capture both stdout and stderr in the same file.
-
-\item Assuming the installation has been done in \path|c:/Program Files/TeXLive|, check
- the following values: \\
- {\small
- \begin{tabular}{ll}
- \path|kpsewhich -expand-path $SELFAUTOPARENT| & \path|c:/Program Files/TeXLive| \\
- \path|kpsewhich -expand-path $TEXMF| & \path|c:/Program Files/TeXLive/texmf| \\
- \path|kpsewhich -expand-path $TEXMFCNF| &
- \path|.;c:/Program Files/TeXLive/texmf/web2c;| \\
- & \path|c:/Program Files/TeXLive/bin/win32;| \\
- & \path|c:/Program Files/TeXLive/bin;| \\
- & \path|c:/Program Files/TeXLive| \\
- \path|kpsewhich -expand-var $TEXINPUTS| & \path|.;c:/Program Files/TeXLive/texmf/tex//|
- \end{tabular}
-}
-\item If you have other \TeX{}-related values already set in your
- environment, please, remove them. They are overriding the ones in
- texmf.cnf.
-\item Check the values from:\\
-{\small
- \begin{tabular}{ll}
- \texttt{kpsewhich cmr10.tfm} & \path|c:/Program Files/TeXLive/texmf/fonts/tfm/public/cm/cmr10.tfm|\\
- \texttt{kpsewhich latex.fmt}& \path|c:/Program Files/TeXLive/texmf/web2c/latex.fmt|
- \end{tabular}
-}
-\item At this point, if everything is correct, \path|tex.exe| and
- co. should work. If it is not the case, you will need to play with
- the \path|-debug=n| option from \path|kpsewhich|, and check back all
- the values. Try to identify and report the problem.
-\end{itemize}
-
-\subsubsection{What to do if your setup still does not work as expected?}
-
-There are several questions to ask about:
-\begin{enumerate}
-\item Is \file{tex.exe} on my \path|PATH|?
-\item Is the \path|TEXMFCNF| variable correctly set to
- \path|c:/Program Files/TeXLive/texmf-var/web2c| (default value)?
-\item Are there any errors in the log file generated by the
- \file{TeXSetup.exe} program? Errors are flagged with the sequence
- \path|Error|.
-% \item If everything seems correct up there, then you need to read the
-% documentation in \path|texmf/doc/fptex/fptex.pdf| or
-% \path|texmf/doc/html/fptex/fptex.html| for a more detailed procedure
-% (available on your hard disk or on the \CD{}).
-\item One can also go to \url{http://www.tug.org/tex-live.html} and
- check for any bug fix.
-\item The Windows distribution on the \CD{} is no more no less than
- the \fpTeX{} distribution, so you can also go to the Web pages at
- \url{http://www.fptex.org}, or consider subscribing to the \fpTeX{}
- mailing-list by consulting
- \url{http://www.tug.org/mailman/listinfo/fptex} .
-\end{enumerate}
-
-
-The \TeXLive{} software is complex and made of more than 250 programs
-and around 40000 files from various sources. It is quite difficult to
-predict all possible causes for problems. Nevertheless, we will do our
-best to help you in every case.
-
-
-\subsection{Compiling the source files}
-
-You have the whole set of source files, comprised for
-Windows in the \path|source/source.tar.bz2| archive available on the
-\CD{}. To be able to compile the whole distribution for Windows, you
-will need:
-\begin{itemize}
-\item Windows 2K/XP
-\item Microsoft Visual Studio .Net
-\item a set of Unix tools (\texttt{sed},
- \texttt{grep}, \texttt{gawk}, etc.) and also Perl, Flex and Bison,
-\item to adjust the paths in the
- \path|win32/make/common.mak| file according to your installation
-\item adjust the paths in the Perl script file
- \path|win32/perl/build.pl|,
-\item run the compilation from the \path|win32/| directory using this
- command:
-\begin{verbatim}
-c:\texlive\source\win32>perl ./perl/build.pl --install --log=install.log
-\end{verbatim}
-\end{itemize}
-
-There is a lot of work to do to make this process easier and cleaner.
-
-\subsection{Where to get more information?}
-
-The Win32 \TeX{} distribution on the \CD{} is also known as
-\fpTeX. Only the packaging differs, but \fpTeX{} is no more no less
-than the current \TeXLive\ release for Windows.
-
-The \fpTeX home on the Web is at:\\
-\url{http://www.fptex.org/}
-
-The current \fpTeX release is available from any
-\href{http://www.ctan.org}{CTAN} %(see also the section
-%\ref{sec:ctan})
-site in the directory~:\\
-\noindent\url{ftp://ctan.tug.org/tex-archive/systems/win32/fptex/}.
-
-The main ftp site for \fpTeX\ is \url{ftp://ftp.dante.de/pub/fptex/} from
-where beta versions of \fpTeX\ and additionnal tools are available.
-This main site is (partially) mirrored daily by the CTAN backbones in their
-\path|systems/win32/fptex| directory.
-
-% You can reach me at my email address:
-% \url{mailto:Fabrice.Popineau@supelec.fr}.
-
-The \TeX{} Users Group is kindly hosting a mailing-list dedicated to
-\fpTeX. This is a very low volume one. It is used for announcements,
-bugs reports or as well to discuss about improvements or various users
-problems. To subscribe, read the page at
-\url{http://www.tug.org/mailman/listinfo/fptex}. The mailing list
-address is \EmailURL{fptex@tug.org}.
-
-\section{Building on a new Unix platform}
-If you have a platform for which we have not provided binary sources,
-you will need to compile \TeX{} and friends from scratch. This is not
-as hard as it sounds. What you need is all in the directory
-\texttt{source} on the \CD{}.
-
-You should first install the support tree from the \TeXLive{} \CD{} (do
-a basic install, with no system binaries chosen).
-
-\subsection{Prerequisites}
-You will need about 100 megabytes of disk space to compile all of
-\TeX{} and its support programs. You'll also need an \acro{ANSI} C
-compiler, a \cmdname{make} utility, a lexical scanner, and a parser
-generator. The \acro{GNU} utilities (\cmdname{gcc}, \acro{GNU}
-\cmdname{make}, \cmdname{m4}, \cmdname{flex}, \cmdname{bison}) are the
-most widely tested on different platforms. \cmdname{gcc}-2.7.*
-\cmdname{flex}-2.4.7 and \acro{GNU}\,\cmdname{make}-3.72.1 or newer
-should work well. You may be able to work with other C compilers and
-\cmdname{make} programs, but you will need a good understanding of
-building Unix programs to sort out problems. The command
-\texttt{uname} must return a sensible value.
-
-
-
-\subsection{Configuration}
-First, unpack the source from the compressed
-\texttt{tar} file in the directory \dirname{source} to your disk and change
-directory to where you placed it. Decide where the `root' of the
-installation will be, e.g.\ \path|/usr/local| or
-\path|/usr/local/TeX|. Obviously you should use the same location
-that you specified when you installed the support tree.
-
-Now, start the build process by running \textsf{configure} with
-a command-line like
-\begin{alltt}
->> \Ucom{./configure -prefix=/usr/local/TeX}
-\end{alltt}
-
-The `prefix' directory is the one where you installed the support
-tree; the directory layout that will be used is as follows (where
-\$TEXDIR stands for the directory you chose):
-
-\noindent
-\begin{tabular}{>{\ttfamily}ll@{}}
- \dirname{$TEXDIR/man} & Unix manual pages\\
- \dirname{$TEXDIR/share/texmf} & main tree with fonts,\\
- & \qquad macros, etc\\
- \dirname{$TEXDIR/info} & \acro{GNU} style info manuals\\
- \dirname{$TEXDIR/bin/$PLATFORM} & binaries\\
-\end{tabular}
-%$
-
-You can omit the use of `\dirname{share/}' part for the
-\dirname{texmf} directory if you want, as
-\dirname{$TEXDIR/share/texmf} and \dirname{$TEXDIR/texmf} are
-auto-detected by configure. If you choose something different, you
-have to specify that directory with the \verb|--datadir| option of
-\textsf{configure}.
-
-
-If you want to leave out the \dirname{$PLATFORM} directory level
-(i.e.\ put the binaries directly into \dirname{$TEXDIR/bin}), specify
-the \verb|--disable-multiplatform| option for \textsf{configure}.
-
-
-Have a look at the output of \texttt{./configure --help} for more
-options you can use (such as omitting optional packages such as \OMEGA\
-or \eTeX).
-
-\subsection{Running \textsf{make}}
-Make sure the shell variable \texttt{noclobber} is not set, and
-then type
-\begin{alltt}
->> \Ucom{make world}
-\end{alltt}
-and relax\ldots.
-
-It could also be useful to log all the output, e.g.\ by
-typing
-\begin{alltt}
->> \Ucom{sh -c "make world >world.log 2>\&1" \&}
-\end{alltt}
-Before you think that everything is ok, please check the log file for
-errors (\acro{GNU} \cmdname{make} always uses the string
-``\texttt{Error:}'' whenever a command returns an error code) and
-check if all binaries are built:
-\begin{alltt}
->> \Ucom{cd /usr/local/TeX/bin/i686-pc-linux-gnu}
->> \Ucom{ls | wc}
-\end{alltt}
-The result should be 209.
-
-If you need special privileges for \texttt{make install}, you can
-run two \cmdname{make} jobs in separate runs:
-\begin{alltt}
->> \Ucom{make all}
->> \Ucom{su}
->> \Ucom{make install strip}
-\end{alltt}
-
-\subsection{Final configuration steps}
-Set up your \envname{PATH} to include the directory containing the
-just-installed binaries (e.g.\
-\dirname{/usr/local/TeX/bin/mips-sgi-irix6.5}); similarly,
-\envname{MANPATH} and \envname{INFOPATH} to include the relevant newly
-installed subdirectories, i.e.\ \dirname{$TEXDIR/man} and
-\dirname{$TEXDIR/info}.
-
-The program \textsf{texconfig} allows you to set the defaults for
-hyphenation, paper size, print command, \MF{} mode, etc. You can
-run this command interactively and see what options it offers, or type
-\begin{alltt}
->> \Ucom{texconfig help}
-\end{alltt}
-
-For example, if you are not using A4 format paper, you can make
-`lettersize' the default using:
-\begin{alltt}
->> \Ucom{texconfig dvips paper letter}
->> \Ucom{texconfig xdvi paper us}
-\end{alltt}
-
-\section{A user's guide to the \protect\Webc{} system}
-
-%--------------------------------------------------------
-
-\Webc{} contains a set of \TeX-related programs, i.e., \TeX{} itself,
-\MF{}, \MP, \BibTeX{}, etc. The original implementation was by Tomas
-Rokicki who, in 1987, developed a first \TeX{}-to-C system adapting
-change files under Unix, which were primarily the work of Howard
-Trickey and Pavel Curtis. Tim Morgan became the maintainer of the
-system, and during this period the name changed to Web-to-C\@. In
-1990, Karl Berry took over the work, assisted by dozens of additional
-contributors, and in 1997 he handed the baton to Olaf Weber. The
-latest result is \Webc{} Version 7.3, which was released in March
-1999. Our version has some updates for the forthcoming new release,
-and identifies itself as 7.3.7
-
-The \Webc{} 7.3 system runs on Unix, Windows 3.1, 9x/ME/\acro{NT}/\acro{2K}/\acro{XP},
-\acro{DOS}, and other operating systems. It uses Knuth's
-original sources for \TeX{} and other basic programs written in \web{}
-and translates them into C source code. Moreover, the system offers a
-large set of macros and functions developed to augment the original
-\TeX{} software. The core \TeX{} family components are:
-
-\begin{description}
-\renewcommand{\makelabel}[1]{\descriptionlabel{\mdseries\cmdname{#1}}}
-\item[bibtex] Maintaining bibliographies.
-\item[dmp] \cmdname{troff} to MPX (\MP{} pictures).
-\item[dvicopy] Produces modified copy of \dvi{} file.
-\item[dvitomp] \dvi{} to MPX (MetaPost pictures).
-\item[dvitype] \dvi{} to human-readable text.
-\item[gftodvi] Generic font proofsheets.
-\item[gftopk] Generic to packed fonts.
-\item[gftype] GF to human-readable text.
-\item[makempx] \MP{} label typesetting.
-\item[mf] Creating typeface families.
-\item[mft] Prettyprinting \MF{} source.
-\item[mpost] Creating technical diagrams.
-\item[mpto] MetaPost label extraction.
-\item[newer] Compare modification times.
-\item[patgen] Creating hyphenation patterns.
-\item[pktogf] Packed to generic fonts.
-\item[pktype] PK to human-readable text.
-\item[pltotf] Property list to TFM.
-\item[pooltype] Display \web{} pool files.
-\item[tangle] \web{} to Pascal.
-\item[tex] Typesetting.
-\item[tftopl] TFM to property list.
-\item[vftovp] Virtual font to virtual property list
-\item[vptovf] Virtual property list to virtual font.
-\item[weave] \web{} to \TeX.
-\end{description}
-\noindent The precise functions and syntax of these programs are described in
-the documentation of the individual packages or of \Webc{} itself.
-However, knowing a few principles governing the whole family of
-programs will help you to benefit optimally from your \Webc{}
-installation.
-
-All programs honor the standard \acro{GNU} options:
-\begin{description}
-\item[\texttt{-{}-help\ \ \ }] print basic usage summary.
-\item[\texttt{-{}-verbose}] print detailed progress report.
-\item[\texttt{-{}-version}] print version information, then exit.
-\end{description}
-
-For locating files the \Webc{} programs use the path searching library
-\KPS{}. This library uses a combination of environment variables and a
-few configuration files to optimize searching the \TeX{} directory
-tree. \Webc{} can handle more than one directory tree
-simultaneously, which is useful if one wants to maintain \TeX's
-standard distribution and local extensions in two distinct trees. To
-speed up file searches the root of each tree has a file \file{ls-R},
-containing an entry showing the name and relative pathname for all
-files ``hanging'' under that root.
-
-\subsection{\protect\KPS\ path searching}
-
-Let us first describe the generic path searching mechanism of the \KPS{}
-library.
-
-We call a \emph{search path} a colon- or semicolon\hyph sepa\-rated list
-of \emph{path elements}, which are basically directory names. A
-search path can come from (a combination of) many sources. To look up
-a file \samp{my-file} along a path \samp{.:/dir}, \KPS{} checks each
-element of the path in turn: first \file{./my-file}, then
-\file{/dir/my-file}, returning the first match (or possibly all
-matches).
-
-In order to adapt optimally to all operating systems' conventions, on
-non-Unix systems \KPS{} can use filename separators different from
-``colon'' (\samp{:}) and ``slash'' (\samp{/}).
-
-To check a particular path element \var{p}, \KPS{} first checks if a
-prebuilt database (see ``Filename data\-base'' on
-page~\pageref{Filename-database}) applies to \var{p}, i.e., if the database
-is in a directory that is a prefix of \var{p}. If so, the path
-specification is matched against the contents of the database.
-
-If the database does not exist, or does not apply to this path
-element, or contains no matches, the filesystem is searched (if this
-was not forbidden by a specification starting with \samp{!!}\ and if
-the file being searched for must exist). \KPS{} constructs the list
-of directories that correspond to this path element, and then checks
-in each for the file being sought.
-
-The ``file must exist'' condition comes into play with \samp{.vf} files and
-input files read by \TeX's \cs{openin} command. Such files may not
-exist (e.g., \file{cmr10.vf}), and so it would be wrong to search the
-disk for them. Therefore, if you fail to update \file{ls-R} when you
-install a new \samp{.vf} file, it will never be found.
-Each path element is checked in turn: first the database, then the
-disk. If a match is found, the search stops and the result is
-returned.
-
-Although the simplest and most common path element is a directory
-name, \KPS{} supports additional features in search paths: layered
-default values, environment variable names, config file values, users'
-home directories, and recursive subdirectory searching. Thus, we say
-that \KPS{} \emph{expands} a path element, meaning it transforms all
-the specifications into basic directory name or names. This is
-described in the following sections in the same order as it takes
-place.
-
-Note that if the filename being searched for is absolute or explicitly
-relative, i.e., starts with \samp{/} or \samp{./} or \samp{../},
-\KPS{} simply checks if that file exists.
-
-\ifSingleColumn
-\else
-\begin{figure*}
-\verbatiminput{../examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{An illustrative configuration file sample}
- \label{fig:config-sample}
-\end{figure*}
-\fi
-
-\subsubsection{Path sources}
-\label{Path-sources}
-
-A search path can come from many sources. In the order in which
-\KPS{} uses them:
-
-\begin{enumerate}
-\item
- A user-set environment variable, for instance, \envname{TEXINPUTS}\@.
- Environment variables with a period and a program name appended
- override; e.g., if \samp{latex} is the name of the program being run,
- then \envname{TEXINPUTS.latex} will override \envname{TEXINPUTS}.
-\item
- A program-specific configuration file, for exam\-ple, a line
- ``\texttt{S /a:/b}'' in \cmdname{dvips}'s \file{config.ps}.
-\item A \KPS{} configuration file \file{texmf.cnf}, containing a line like
- \samp{TEXINPUTS=/c:/d} (see below).
-\item The compile-time default.
-\end{enumerate}
-\noindent You can see each of these values for a given
-search path by using the debugging options (see ``Debugging actions''
-on page~\pageref{Debugging}).
-
-\subsubsection{Config files}
-
-\tolerance=3500
-\KPS{} reads \emph{runtime configuration files} named \file{texmf.cnf}
-for search path and other definitions. The search path used to look
-for these files is named \envname{TEXMFCNF} (by default such a file lives
-in the \file{texmf/web2c} subdirectory). \emph{All}
-\file{texmf.cnf} files in the search path will be read and definitions
-in earlier files override those in later files. Thus, with a search
-path of \verb|.:$TEXMF|, values from \file{./texmf.cnf} override those
-from \verb|$TEXMF/texmf.cnf|.
-
-\tolerance=1500
-
-While reading the description of the format of the file
-\file{texmf.cnf} below, please also refer to
-appendix~\ref{app:texmf.cnf}, starting on
-page~\pageref{app:texmf.cnf}, which lists the \file{texmf.cnf} file on
-the \CD.
-
-\begin{itemize}
-\item
- Comments start with ``\texttt{\%}'' and continue to the end of the line.
-\item
- Blank lines are ignored.
-\item
- A \bs{} at the end of a line acts as a continuation character,
- i.e., the next line is appended. Whitespace at the beginning of
- continuation lines is not ignored.
-\item
- Each remaining line has the form:
-\begin{alltt}
- \emph{variable}[.\emph{progname}] [=] \emph{value}
-\end{alltt}%
- where the \samp{=} and surrounding whitespace are optional.
-\item
- The ``\texttt{\var{variable}}'' name may contain any character other
- than whitespace, \samp{=}, or \samp{.}, but sticking to
- \samp{A-Za-z\_} is safest.
-\item
- If ``\texttt{.\var{progname}}'' is present, the definition only
- applies if the program that is running is named
- \texttt{\var{progname}} or \texttt{\var{progname}.exe}. This allows
- different flavors of \TeX{} to have different search paths, for
- example.
-\item ``\texttt{\var{value}}'' may contain any characters except
- ``\texttt{\%}'' and \samp{@}. The
- ``\texttt{\$\var{var}.\var{prog}}'' feature is not available on the
- right-hand side; instead, you must use an additional variable. A
- \samp{;}\ in ``\texttt{\var{value}}'' is translated to \samp{:}\ if
- running under Unix; this is useful to be able to have a single
- \file{texmf.cnf} for Unix, MSDOS and Windows systems.
-\item
- All definitions are read before anything is expanded, so
- variables can be referenced before they are defined.
-\end{itemize}
-A configuration file fragment illustrating most of these points is
-\ifSingleColumn
-shown below:
-
-\verbatiminput{../examples/ex5.tex}
-\else
-shown in Figure~\ref{fig:config-sample}.
-\fi
-
-\subsubsection{Path expansion}
-\label{Path-expansion}
-
-
-\KPS{} recognizes certain special characters and constructions in
-search paths, similar to those available in Unix shells. As a
-general example, the complex path,
-\verb+~$USER/{foo,bar}//baz+, expands to all subdirectories under
-directories \file{foo} and \file{bar} in \texttt{\$USER}'s home
-directory that contain a directory or file \file{baz}. These
-expansions are explained in the sections below.
-%$
-\subsubsection{Default expansion}
-\label{Default-expansion}
-
-\tolerance=2500
-If the highest-priority search path (see ``Path sources'' on
-page~\pageref{Path-sources}) contains an \emph{extra colon} (i.e.,
-leading, trailing, or doubled), \KPS{} inserts at that point the
-next-highest-prio\-rity search path that is defined. If that inserted
-path has an extra colon, the same happens with the next highest. For
-example, given an environment variable setting
-
-\tolerance=1500
-
-\begin{alltt}
->> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
-and a \code{TEXINPUTS} value from \file{texmf.cnf} of
-
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
-then the final value used for searching will be:
-
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-
-Since it would be useless to insert the default value in more than one
-place, \KPS{} changes only one extra \samp{:}\ and leaves any others in
-place: it checks first for a leading \samp{:}, then a trailing
-\samp{:}, then a doubled \samp{:}.
-
-\subsubsection{Brace expansion}
-
-A useful feature is brace expansion, which means that, for instance,
-\verb+v{a,b}w+ expands to \verb+vaw:vbw+. Nesting is allowed.
-This can be used to implement multiple \TeX{} hierarchies, by
-assigning a brace list to \code{\$TEXMF}.
-For example, in \file{texmf.cnf}, you find
-the following definition:
-\begin{verbatim}
- TEXMF = {$HOMETEXMF,$TEXMFLOCAL,!!$VARTEXMF,!!$TEXMFMAIN}
-\end{verbatim}
-Using this you can then write something like
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-%$
-which means that, after looking in the current directory, the
-\code{\$HOMETEXMF/tex}, \code{\$TEXMFLOCAL/tex}, \code{\$VARTEXMF/tex}
-and \code{\$TEXMFMAIN/tex} trees \emph{only}) will be searched (the
-last two use using \file{ls-R} data base files). It is a convenient
-way for running two parallel \TeX{} structures, one ``frozen'' (on a
-\CD, for instance) and the other being continuously updated with new
-versions as they become available. By using the \code{\$TEXMF}
-variable in all definitions, one is sure to always search the
-up-to-date tree first.
-
-\subsubsection{Subdirectory expansion}
-\label{Subdirectory-expansion}
-
-Two or more consecutive slashes in a path element following a directory
-\var{d} is replaced by all subdirectories of \var{d}: first those
-subdirectories directly under \var{d}, then the subsubdirectories under
-those, and so on. At each level, the order in which the directories are
-searched is \emph{unspecified}.
-
-If you specify any filename components after the \samp{//}, only
-subdirectories with matching components are included. For example,
-\samp{/a//b} expands into directories \file{/a/1/b}, \file{/a/2/b},
-\file{/a/1/1/b}, and so on, but not \file{/a/b/c} or \file{/a/1}.
-
-Multiple \samp{//} constructs in a path are possible, but
-\samp{//} at the beginning of a path is ignored.
-
-\subsubsection{List of special characters and their meaning: a summary}
-
-The following list summarises the meaning of special characters
-in \KPS{} configuration files.
-
-\newcommand{\CODE}[1]{\makebox[2.2em][l]{\code{#1}}}
-\begin{description}
-\item[\CODE{:}] Separator in path specification; at the beginning or
- the end of a path it substitutes the default path expansion.
-\item[\CODE{;}] Separator on non-Unix systems (acts like \code{:}).
-\item[\CODE{\$}] Variable expansion.
-\item[\CODE{\string~}] Represents the user's home directory.
-\item[\CODE{\char`\{\dots\char`\}}] Brace expansion, e.g.,
- \verb+a{1,2}b+ will become \verb+a1b:a2b+.
-\item[\CODE{//}] Subdirectory expansion (can occur anywhere in
- a path, except at its beginning).
-\item[\CODE{\%}] Start of comment.
-\item[\CODE{\bs}] Continuation character (allows multi-line entries).
-\item[\CODE{!!}] Search \emph{only} database to locate file, \emph{do
- not} search the disk.
-\end{description}
-
-
-\subsection{Filename databases}
-\label{Filename-database}
-
-
-\KPS{} goes to some lengths to minimize disk accesses for searches.
-Nevertheless, at installations with enough directories, searching each
-possible directory for a given file can take an excessively long time
-(this is especially true if many hundreds of font directories have to
-be traversed.) Therefore, \KPS{} can use an externally-built
-``database'' file named \file{ls-R} that maps files to directories,
-thus avoiding the need to exhaustively search the disk.
-
-A second database file \file{aliases} allows you to give additional
-names to the files listed in \file{ls-R}. This can be helpful to
-adapt to DOS-like ``8.3'' filename conventions in source files.
-
-\subsubsection{The filename database}
-\label{ls-R}
-
-As explained above, the name of the main filename database must be
-\file{ls-R}. You can put one at the root of each \TeX{} hierarchy in
-your installation that you wish to be searched (\code{\$TEXMF} by
-default); most sites have only one hierarchy. \KPS{} looks for
-\file{ls-R} files along the \code{TEXMFDBS} path.
-
-The recommended way to create and maintain \samp{ls-R} is to run the
-\code{mktexlsr} script included with the distribution. It is invoked
-by the various \samp{mktex}\dots\ scripts. In principle, this script
-just runs the command
-\begin{alltt}
-cd \var{/your/texmf/root} && ls -LAR ./ >ls-R
-\end{alltt}
-presuming your system's \code{ls} produces the right output format
-(\acro{GNU}'s \code{ls} is all right). To ensure that the database is always
-up to date, it is easiest to rebuild it regularly via \code{cron}, so
-that for changes in the installed files\Dash perhaps after installing or
-updating a \LaTeX{} package\Dash the file \file{ls-R} is automatically
-updated.
-
-If a file is not found in the database, by default \KPS{} goes ahead
-and searches the disk. If a particular path element begins with
-\samp{!!}, however, \emph{only} the database will be searched for that
-element, never the disk.
-
-
-\subsubsection{kpsewhich: Standalone path searching}
-\label{Invoking-kpsewhich}
-
-The \texttt{kpsewhich} program exercises path searching independent of any
-particular application. This can be useful as a sort of \code{find}
-program to locate files in \TeX{} hierarchies (this is used heavily in
-the distributed \samp{mktex}\dots\ scripts).
-
-\begin{alltt}
->> \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}}
-\end{alltt}
-The options specified in ``\texttt{\var{option}}'' can start with either \samp{-}
-or \samp{-{}-}, and any unambiguous abbreviation is accepted.
-
-\KPS{} looks up each non-option argument on the command line as a
-filename, and returns the first file found. There is no option to
-return all the files with a particular name (you can run the Unix
-\samp{find} utility for that).
-
-The more important options are described next.
-
-\begin{description}
-\item[\texttt{-{}-dpi=\var{num}}]\mbox{}
- Set the resolution to ``\texttt{\var{num}}''; this only affects \samp{gf}
- and \samp{pk} lookups. \samp{-D} is a synonym, for compatibility
- with \cmdname{dvips}. Default is 600.
-\item[\texttt{-{}-format=\var{name}}]\mbox{}\\
- Set the format for lookup to ``\texttt{\var{name}}''. By default, the
- format is guessed from the filename. For formats which do not have
- an associated unambiguous suffix, such as \MP{} support files and
- \cmdname{dvips} configuration files, you have to specify the name as
- found in the first column of Table~\ref{TABKpathsea}, which lists
- currently recognized names, a description,
- associated environment variables%,
- \footnote{You can find definitions for these environment variables
- in the file \file{texmf.cnf} (page~\pageref{app:texmf.cnf})}, and
- possible file extensions.
-\end{description}
-
-
-\def\KpathKey#1#2#3#4#5{% name, number, description, variables,
- % suffixes
-\SetRowColor#1 & #3 & #4 & #5\\}
-\def\HEAD#1{\multicolumn{1}{l}{\emph{#1}}}
-%
-\begin{small}
-% a footnoterule immediately under a bottom-of-page rule looks dead
-% silly, so we suppress it
-\renewcommand\footnoterule{\relax}
-%
-\begin{longtable}{@{}%
- >{\ttfamily}P{.16\textwidth}% Col.1
- P{.3\textwidth}% Col 2
- >{\ttfamily\footnotesize}P{.29\textwidth}% Col 3
- >{\ttfamily}P{.14\textwidth}% Col 4
-@{}}
-\caption{Kpathsea file types}\label{TABKpathsea}\\
-\emph{Name} & \HEAD{Description} & \HEAD{Variables}
-& \HEAD{Suffixes}\\
-\hline
-\endfirsthead
-\multicolumn{3}{l}{Kpathsea file types \emph{continued}}\\
-\emph{Name} & \HEAD{Description} & \HEAD{Variables}
-& \HEAD{Suffixes}\\
-\hline
-\noalign{\vspace{2pt}}
-\endhead
-\mbox{}\\
-\hline
-\endfoot
-\KpathKey
- {afm}
- {4}
- {Adobe font metrics}
- {AFMFONTS}
- {.afm}
-\KpathKey
- {base}
- {5}
- {Metafont memory dump}
- {MFBASES, TEXMFINI}
- {.base}
-\KpathKey
- {bib}
- {6}
- {\BibTeX{} bibliography source}
- {BIBINPUTS, TEXBIB}
- {.bib}
-\KpathKey
- {}
- {2}
- {bitmap fonts}
- {GLYPHFONTS, TEXFONTS}
- {}
-\KpathKey
- {bst}
- {7}
- {\BibTeX{} style files}
- {BSTINPUTS}
- {.bst}
-\KpathKey
- {cnf}
- {8}
- {Runtime configuration files}
- {TEXMFCNF}
- {.cnf}
-\KpathKey
- {dvips config}
- {34}
- {\textsf{dvips} configuration files, e.g., \file{config.ps}
- and \file{psfonts.map}}
- {TEXCONFIG}
- {.map}
-\KpathKey
- {fmt}
- {10}
- {\TeX{} memory dump}
- {TEXFORMATS, TEXMFINI}
- {.fmt, .efmt, .efm}
-\KpathKey
- {gf}
- {0}
- {generic font bitmap}
- {GFFONTS}
- {.gf}
-\KpathKey
- {graphic/figure}
- {25}
- {Encapsulated PostScript figures}
- {TEXPICTS, TEXINPUTS}
- {.eps, .epsi}
-\KpathKey
- {ist}
- {35}
- {\textsf{makeindex} style files}
- {TEXINDEXSTYLE, INDEXSTYLE}
- {.ist}
-\KpathKey
- {ls-R}
- {9}
- {Filename databases}
- {TEXMFDBS}
- {}
-\KpathKey
- {map}
- {11}
- {Fontmaps}
- {TEXFONTMAPS}
- {.map}
-\KpathKey
- {mem}
- {12}
- {MetaPost memory dump}
- {MPMEMS, TEXMFINI}
- {.mem}
-\KpathKey
- {mf}
- {13}
- {Metafont source}
- {MFINPUTS}
- {.mf}
-\KpathKey
- {mfpool}
- {14}
- {Metafont program strings}
- {MFPOOL, TEXMFINI}
- {.pool}
-\KpathKey
- {mft}
- {15}
- {MFT style file}
- {MFTINPUTS}
- {.mft}
-\KpathKey
- {}
- {41}
- {miscellaneous fonts}
- {MISCFONTS}
- {}
-\KpathKey
- {mp}
- {16}
- {MetaPost source}
- {MPINPUTS}
- {.mp}
-\KpathKey
- {mppool}
- {17}
- {MetaPost program strings}
- {MPPOOL, TEXMFINI}
- {.pool}
-\KpathKey
- {MetaPost support}
- {18}
- {MetaPost support files, used by DMP}
- {MPSUPPORT}
- {}
-\KpathKey
- {ocp}
- {19}
- {\OMEGA{} compiled process files}
- {OCPINPUTS}
- {.ocp}
-\KpathKey
- {ofm}
- {20}
- {\OMEGA{} font metrics}
- {OFMFONTS, TEXFONTS}
- {.ofm, .tfm}
-\KpathKey
- {opl}
- {21}
- {\OMEGA{} property lists}
- {OPLFONTS, TEXFONTS}
- {.opl}
-\KpathKey
- {otp}
- {22}
- {\OMEGA{} translation process files}
- {OTPINPUTS}
- {.otp}
-\KpathKey
- {ovf}
- {23}
- {\OMEGA{} virtual fonts}
- {OVFFONTS, TEXFONTS}
- {.ovf}
-\KpathKey
- {ovp}
- {24}
- {\OMEGA{} virtual property lists}
- {OVPFONTS, TEXFONTS}
- {.ovp}
-\KpathKey
- {pk}
- {1}
- {packed bitmap fonts}
- {\emph{program}FONTS \textrm{(\texttt{\emph{program}} being
- \textsmaller{\cmdname{XDVI}},
- etc.)}, PKFONTS, TEXPKS, GLYPHFONTS, TEXFONTS}
- {.pk}
-\KpathKey
- {PostScript header}
- {30}
- {downloadable PostScript}
- {TEXPSHEADERS, PSHEADERS}
- {.pro, .enc}
-\KpathKey
- {tex}
- {26}
- {\TeX{} source}
- {TEXINPUTS}
- {.tex, .cls, .sty, .clo, .def}
-\KpathKey
- {TeX system documentation}
- {27}
- {Documentation files for the \TeX{} system}
- {TEXDOCS}
- {}
-\KpathKey
- {TeX system sources}
- {29}
- {Source files for the \TeX{} system}
- {TEXSOURCES}
- {}
-\KpathKey
- {texpool}
- {28}
- {\TeX{} program strings}
- {TEXPOOL, TEXMFINI}
- {.pool}
-\KpathKey
- {tfm}
- {3}
- {\TeX{} font metrics}
- {TFMFONTS, TEXFONTS}
- {.tfm}
-\KpathKey
- {Troff fonts}
- {31}
- {Troff fonts, used by DMP}
- {TRFONTS}
- {}
-\KpathKey
- {truetype fonts}
- {36}
- {TrueType outline fonts}
- {TTFONTS}
- {.ttf, .ttc}
-\KpathKey
- {type1 fonts}
- {32}
- {Type 1 PostScript outline fonts}
- {T1FONTS, T1INPUTS, TEXPSHEADERS, DVIPSHEADERS}
- {.pfa, .pfb}
-\KpathKey
- {type42 fonts}
- {37}
- {Type 42 PostScript outline fonts}
- {T42FONTS}
- {}
-\KpathKey
- {vf}
- {33}
- {virtual fonts}
- {VFFONTS, TEXFONTS}
- {.vf}
-\KpathKey
- {web2c files}
- {38}
- {\Webc{} support files}
- {WEB2C}
- {}
-\KpathKey
- {other text files}
- {39}
- {text files used by `\textsf{foo}'}
- {FOOINPUTS}
- {}
-\KpathKey
- {other binary files}
- {40}
- {binary files used by `\textsf{foo}'}
- {FOOINPUTS}
- {}
-\end{longtable}
-\end{small}
-
-
-\begin{multicols}{2}
-
-\begin{description}
-\item[] The last two entries in Table~\ref{TABKpathsea} are special
- cases, where the paths and environment variables depend on the name
- of the program: the variable name is constructed by converting the
- program name to upper case, and then appending \texttt{INPUTS}.
-
- The environment variables are set by default in the configuration
- file \file{texmf.cnf}. It is only when you want to override one or
- more of the values specified in that file that you might want to set
- them explicitly in your execution environment.
-
- Note that the \samp{-{}-format} and \samp{-{}-path} options are mutually
- exclusive.
-\item[\texttt{-{}-mode=\var{string}}]\mbox{}\\
- Set the mode name to ``\texttt{\var{string}}''; this only affects \samp{gf}
- and \samp{pk} lookups. No default: any mode will be found.
-\item[\texttt{-{}-must-exist}]\mbox{}\\
- Do everything possible to find the files, notably including
- searching the disk. By default, only the \file{ls-R} database is
- checked, in the interest of efficiency.
-\item[\texttt{-{}-path=\var{string}}]\mbox{}\\
- Search along the path ``\texttt{\var{string}}'' (colon-%
- separated as usual),
- instead of guessing the search path from the filename. \samp{//}
- and all the usual expansions are supported.
- The options \samp{-{}-path} and \samp{-{}-format} are mutually
- exclusive.
-\item[\texttt{-{}-progname=\var{name}}]\mbox{}\\
- Set the program name to ``\texttt{\var{name}}''.
- This can affect the search paths via the ``\texttt{.\var{prognam}}''
- feature in configuration files.
- The default is \samp{kpsewhich}.
-\item[\texttt{-{}-show-path=\var{name}}]\mbox{}\\
- shows the path used for file lookups of file type ``\texttt{\var{name}}''.
- Either a filename extension (\samp{.pk}, \samp{.vf}, etc.) or a
- name can be used, just as with \samp{-{}-format} option.
-\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\
- sets the debugging options to ``\texttt{\var{num}}''.
-\end{description}
-
-
-\subsubsection{Examples of use}
-\label{SExamplesofuse}
-
-Let us now have a look at \KPS{} in action.
-
-\begin{alltt}
->> \Ucom{kpsewhich article.cls}
-/usr/local/texmf/tex/latex/base/article.cls
-\end{alltt}
-We are looking for the file \file{article.cls}. Since the \samp{.cls}
-suffix is unambiguous we do not need to specify that we want to look for a
-file of type ``tex'' (\TeX{} source file directories). We find it in
-the subdirectory \file{tex/latex/base} below the \samp{TEXMF} root
-directory. Similarly, all of the following are found without problems
-thanks to their unambiguous suffix.
-\begin{alltt}
->> \Ucom{kpsewhich array.sty}
- /usr/local/texmf/tex/latex/tools/array.sty
->> \Ucom{kpsewhich latin1.def}
- /usr/local/texmf/tex/latex/base/latin1.def
->> \Ucom{kpsewhich size10.clo}
- /usr/local/texmf/tex/latex/base/size10.clo
->> \Ucom{kpsewhich small2e.tex}
- /usr/local/texmf/tex/latex/base/small2e.tex
->> \Ucom{kpsewhich tugboat.bib}
- /usr/local/texmf/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-The latter is a \BibTeX{} bibliography database for \textsl{TUGBoat} articles.
-
-\begin{alltt}
->> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
-Font bitmap glyph files of type \file{.pk} are used by display
-programs like \cmdname{dvips} and \cmdname{xdvi}. Nothing is returned in
-this case since there are no pre-generated Computer Modern \samp{.pk}
-files on our system (since we use the Type1 versions on the \CD{}).
-\begin{alltt}
->> \Ucom{kpsewhich ecrm1000.pk}
-\ifSingleColumn /usr/local/texmf/fonts/pk/ljfour/jknappen/ec/ecrm1000.600pk
-\else
-/usr/local/texmf/fonts/pk/ljfour/jknappen/
-... ec/ecrm1000.600pk
-\fi\end{alltt}
-For the extended Computer Modern files we had to generate \samp{.pk}
-files, and since the default \MF{} mode on our installation is
-\texttt{ljfour} with a base resolution of 600 dpi (dots per inch),
-this instantiation is returned.
-\begin{alltt}
->> \Ucom{kpsewhich -dpi=300 ecrm1000.pk}
-\end{alltt}
-In this case, when specifying that we are interested in a resolution
-of 300dpi (\texttt{-dpi=300}) we see that no such font is available on
-the system. In fact, a program like \cmdname{dvips} or \cmdname{xdvi} would
-go off and actually build the \texttt{.pk} files at the required
-resolution using the script \cmdname{mktexpk}.
-
-Next we turn our attention to \cmdname{dvips}'s header and configuration
-files. We first look at one of the commonly used files, the general
-prolog \file{tex.pro} for \TeX{} support, before turning our attention
-to the generic configuration file (\file{config.ps}) and the
-PostScript font map \file{psfonts.map}. As the \samp{.ps} suffix is
-ambiguous we have to specify explicitly which type we are considering
-(``\texttt{dvips config}'') for the file \texttt{config.ps}.
-\begin{alltt}
->> \Ucom{kpsewhich tex.pro}
- /usr/local/texmf/dvips/base/tex.pro
->> \Ucom{kpsewhich --format="dvips config" config.ps}
- /usr/local/texmf/config/config.ps
->> \Ucom{kpsewhich psfonts.map}
- /usr/local/texmf/dvips/base/psfonts.map
-\end{alltt}
-
-We now take a closer look at the URW Times PostScript support files.
-The name for these in Berry's font naming scheme is ``\texttt{utm}''.
-The first file we look at is the configuration file, which contains
-the name of the map file:
-\begin{alltt}
->> \Ucom{kpsewhich --format="dvips config" config.utm}
-/usr/local/texmf/dvips/psnfss/config.utm
-\end{alltt}
-The contents of that file is
-\begin{alltt}
- p +utm.map
-\end{alltt}
-which points to the file \file{utm.map}, which we want to
-locate next.
-\begin{alltt}
->> \Ucom{kpsewhich --format="dvips config" utm.map}
- /usr/local/texmf/dvips/psnfss/utm.map
-\end{alltt}
-This map file defines the file names of the Type1 PostScript fonts in
-the URW collection. Its contents look like (we only show part of the
-lines):
-\begin{alltt}
- utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
- utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
- utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
- utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
- utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
- utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
-Let us, for instance, take the Times Regular instance
-\file{utmr8a.pfb} and find its position in the \file{texmf} directory
-tree by using a search for Type1 font files:
-\begin{alltt}
->> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf/fonts/type1/urw/utm/utmr8a.pfb
-\else /usr/local/texmf/fonts/type1/
-... urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
-It should be evident from these few examples how you can easily locate
-the whereabouts of a given file. This is especially important if you
-suspect that the wrong version of a file is picked up somehow, since
-\cmdname{kpsewhich} will show you the first file encountered.
-
-\subsubsection{Debugging actions}
-\label{Debugging}
-
-Sometimes it is necessary to investigate how a program resolves
-file references. To make this feasible in a convenient way \KPS{}
-offers various debug levels:
-\begin{itemize}
-\item[\texttt{\ 1}] \texttt{stat} calls (file tests). When running
- with an up-to-date \file{ls-R} database this should almost give no
- output.
-\item[\texttt{\ 2}] References to hash tables (like \file{ls-R}
- database, map files, configuration files).
-\item[\texttt{\ 4}] File open and close operations.
-\item[\texttt{\ 8}] General path information for file types
- searched by \KPS. This is useful to find out where a particular
- path for the file was defined.
-\item[\texttt{16}] Directory list for each path element (only relevant
- for searches on disk).
-\item[\texttt{32}] File searches.
-\end{itemize}
-A value of \texttt{-1} will set all the above options; in practice you
-will probably always use these levels if you need any debugging.
-
-Similarly, with the \cmdname{dvips} program, by setting a
-combination of debug switches, one can follow in detail where files are being picked
-up from. Alternatively, when a file is not found, the debug trace
-shows in which directories the program looks for the given file, so
-that one can get an indication what the problem~is.
-
-Generally speaking, as most programs call the \KPS{} library
-internally, one can select a debug option by using the
-\envname{KPATHSEA\_DEBUG} environment variable, and setting it to (a
-combination of) values as described in the above list.
-
-(Note for Windows users: it is not easy to redirect
-all messages to a file in this system. For diagnostic purposes
-you can temporarily \texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log}).
-
-Let us consider, as an example, a small \LaTeX{} source file,
-\file{hello-world.tex}, which contains the following input.
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
-This little file only uses the font \file{cmr10}, so let us look
-how \cmdname{dvips} prepares the PostScript file (we want to use the Type1
-version of the Computer Modern fonts, hence the option \texttt{-Pcms}).
-\begin{alltt}
->> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
-In this case we have combined \cmdname{dvips}'s debug class 4 (font
-paths) with \KPS's path element expansion (see \cmdname{dvips} Reference
-Manual, \OnCD{texmf/doc/html/dvips/dvips_toc.html}).
-%\ifSingleColumn
-%We get something
-%like the following (we have rearranged the output for easier display):
-%\begin{alltt}\small
-%\input{../examples/ex6.tex}
-%\end{alltt}
-%\else
-The output (slightly rearranged) appears in
-Figure~\ref{fig:dvipsdbga}.
-\begin{figure*}[tp]
-\centering
-\input{../examples/ex6a.tex}
-\caption{Finding configuration files}\label{fig:dvipsdbga}
-
-\bigskip
-
-\input{../examples/ex6b.tex}
-\caption{Finding the prolog file}\label{fig:dvipsdbgb}
-
-\bigskip
-
-\input{../examples/ex6c.tex}
-\caption{Finding the font file}\label{fig:dvipsdbgc}
-\end{figure*}
-\cmdname{dvips} starts by locating its working files. First,
-\file{texmf.cnf} is found, which gives the definitions of the search
-paths for the other files, then the file database \file{ls-R} (to
-optimize file searching) and the file \file{aliases}, which makes it
-possible to declare several names (e.g., a short \acro{DOS}-like ``8.3'' and
-a more natural longer version) for the same file. Then \cmdname{dvips}
-goes on to find the generic configuration file \file{config.ps}
-before looking for the customization file \file{.dvipsrc} (which, in
-this case is \emph{not found}). Finally, \cmdname{dvips} locates the
-config file for the Computer Modern PostScript fonts \file{config.cms}
-(this was initiated with the \texttt{-Pcms} option on the \cmdname{dvips}
-command). This file contains the list of the ``map'' files which
-define the relation between the \TeX{}, PostScript and file system
-names of the fonts.
-\begin{alltt}
->> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
- p +ams.map
- p +cms.map
- p +cmbkm.map
- p +amsbkm.map
-\end{alltt}
-\cmdname{dvips} thus goes on to find all these files, plus the generic
-map file \file{psfonts.map}, which is always loaded (it contains
-declarations for commonly used PostScript fonts; see the last part of
-Section \ref{SExamplesofuse} for more details about PostScript map
-file handling).
-
-At this point \cmdname{dvips} identifies itself to the user\ldots
-\begin{alltt}\ifSingleColumn
-This is dvips 5.78 Copyright 1998 Radical Eye Software (www.radicaleye.com)
-\else\small{}This is dvips 5.78 Copyright 1998 Radical Eye...
-\fi\end{alltt}% decided to accept slight overrun in tub case
-\ifSingleColumn
-\ldots and then goes on to look for the prolog file \file{texc.pro},
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
-then goes on to look for the prolog file \file{texc.pro} (see
-Figure~\ref{fig:dvipsdbgb}).
-
-\fi
-After having found the file in question, \cmdname{dvips} outputs
-date and time, and informs us that it will generate the
-file \file{hello-world.ps}, then that it needs the font file
-\file{cmr10}, and that the latter is declared as ``resident'':
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
-Now the search is on for the file \file{cmr10.tfm}, which is found,
-then a few more prolog files (not shown) are referenced, and finally
-the Type1 instance \file{cmr10.pfb} of the font is located and
-included in the output file (see last line).
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-\subsection{Runtime options}
-
-Another of the nice features of \Webc{} is its possibility to
-control a number of memory parameters (in particular, array sizes) via
-the runtime file \file{texmf.cnf} read by \KPS{}. The listing of
-\file{texmf.cnf} is shown in Appendix~\ref{app:texmf.cnf}, starting on
-page~\pageref{app:texmf.cnf}; the settings of all parameters can be
-found in Part 3 of that file. The more important control variables are:
-\begin{description}
-\item[\texttt{main\_memory}]
- Total words of memory available, for
- \TeX{}, \MF{} and \MP. You must make a new format file for each
- different setting. For instance, you could generate a ``huge''
- version of \TeX{}, and call the format file \texttt{hugetex.fmt}.
- Using the standard way of specifying the program name used by \KPS{},
- the particular value of the \texttt{main\_memory} variable will then
- be read from \file{texmf.cnf} (compare the generic value
- and the ``huge'' one instantiated by \texttt{hugetex},
- etc.).
-\item[\texttt{extra\_mem\_bot}]
- Extra space for ``large'' \TeX{} data structures:
- boxes, glue, breakpoints, etc. Especially useful if you use
- \PiCTeX{}.
-\item[\texttt{font\_mem\_size}]
- Number of words for font information available for \TeX. This
- is more or less the total size of all TFM files read.
-\item[\texttt{hash\_extra}]
- Additional space for the hash table of control sequence names.
- Approximately 10,000 control sequences can be stored in the main
- hash table; if you have a large book with numerous cross-references,
- this might not be enough. You can see that both the
- \cmdname{hugetex} and \cmdname{pdflatex} program invocations ask for
- an extra 15,000 control sequences (the default value of
- \texttt{hash\_extra} is zero).
-\end{description}
-Of course, this facility is no substitute for truly dynamic arrays and
-memory allocation, but since this is extremely difficult to implement
-in present \TeX, these runtime parameters provide a practical compromise
-allowing some flexibility.
-
-%--------------------------------------------------------
-
-
-\section{Acknowledgements}\label{sec:acknowl}
-This edition of TeXLive is edited by Sebastian Rahtz, with the
-major contributors being Fabrice Popineau, who has worked away
-unceasingly at the Win32 part of the package (especially the setup!)
-and contributed in many different ways with ideas, advice and code;
-and Staszek Wawrykiewicz, who provided great checking feedback, and
-co-ordinated the Polish contributions. Kaja Christiansen performed a
-vital role in endless recompilations on assorted Unix platforms, and
-Robin Laakso coordinated production for TUG. Vladimir Volovich
-did great work on cleaning the source and making other improvements,
-while Gerben Wierda did all the work for MacOSX.
-
-We are very grateful for past and present help from
-\begin{itemize}
-\item The German-speaking \TeX{} Users (DANTE e.V.), who provided a machine
- on which the master of the CD-ROM is developed and maintained; and Rainer
-Sch\"opf and Reinhard Zierke who look after it;
-\item The Perforce company, for providing a free copy of their
-excellent change management system, which we have used to
- manage the CD-ROM
-contents;
-\item Karl Berry, who provided the original \Webc{} distribution, and
- has continued to give invaluable advice, encouragement, and help;
-\item Mimi Burbank, who arranged access
- at the Florida State University School of Computational Science
- and Information Technology
- to a slew of different
- computers to compile \TeX{} on, and acted as an essential guinea-pig
- whenever asked;
-\item Kaja Christiansen, who provided essential feedback, compilation, and
- documentation preparation;
-\item Thomas Esser, without whose marvellous \teTeX{} package this
- \CD{} would certainly not exist, and whose continual help makes it a
- better product;
-\item Michel Goossens, who co-authored the documentation;
-\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;
-\item Art Ogawa and Pat Monohon, who coordinated releases for TUG;
-\item Petr Olsak, who coordinated and checked all the Czech/Slovak
- material very carefully;
-\item Olaf Weber, for his patient assembly and maintenance of Web2c;
-\item Graham Williams, on whose work the catalogue of packages depends.
-\end{itemize}
-
-Gerhard Wilhelms, Volker Schaa, Fabrice Popineau, Janka
-Chleb\'\i{}kov\'a, Staszek Wawrykiewicz, Erik Frambach, and Ulrik
-Vieth kindly translated documentation at various times into their
-respective languages, checked other documentation, and provided very
-welcome feedback.
-
-
-\section{History}
-
-This \CD{} distribution is a joint effort by many \TeX{} Users
-Groups, including those from Germany, the Netherlands, the UK, France,
-the Czech Republic/Slovakia, India, Poland and Russia, as well as
-the international TUG.
-Discussion began in late 1993 when the Dutch \TeX{} Users Group was
-starting work on its 4All\TeX{} \CD{} for \acro{MS-DOS} users, and it was
-hoped at that time to issue a single, rational, \CD{} for all
-systems. This was far too ambitious a target, but it did spawn not
-only the very successful 4All\TeX{} \CD{}, but also the \acro{TUG}
-Technical Council working group on a \emph{\TeX{} Directory
- Structure}, which specified how to create consistent and manageable
-collections of \TeX{} support files. The final draft of the \TDS{} was
-published in the December 1995 issue of \textsl{TUGboat}, and it was clear from
-an early stage that one desirable product would be a model structure
-on \CD{}. The \CD{} you now have is a very direct result of the
-working group's deliberations. It was also clear that the success of
-the 4All\TeX{} \CD{} showed that Unix users would benefit from a
-similarly easy system, and this is the other main strand of \TeXLive.
-
-We undertook to make a new Unix-based \TDS{} \CD{} in the autumn of
-1995, and quickly identified Thomas Esser's \teTeX{} as the ideal
-setup, as it already had multi-platform support and was built with
-portability across file systems in mind. Thomas agreed to help, and
-work began seriously at the start of 1996. The first edition was
-released in May 1996. At the start of 1997, Karl Berry completed a
-major new release of his \Webc{} package, which included nearly all
-the features which Thomas Esser had added in \teTeX, and we decided to
-base the 2nd edition of the \CD{} on the standard \Webc, with the
-addition of \teTeX's \texttt{texconfig} script. The 3rd edition of the
-\CD{} was based on a major revision of \Webc, 7.2, by Olaf Weber; at the
-same time, a new revision of \teTeX was being made,
-and \TeXLive{} shares almost all of its features. The 4th edition
-followed the same pattern, using a new version of te\TeX, and a new
-release of \Webc{} (7.3). The system now included a complete Windows setup.
-
-For the 5th edition (March 2000) many parts of the \CD{} were revised
-and checked, updating hundreds of packages. Package details were
-stored in XML files. But the major change for \TeX\ Live 5 was that
-all non-free software was removed. Everything on this \CD{} should be
-compatible with the Debian Free Software Guidelines
-(\url{http://www.debian.org/intro/free}); we have done our best to
-check the license conditions of all packages, but we would very much
-appreciate hearing of any mistakes.
-
-The 6th edition (July 2001) had a lot material updated. The major
-change was a new install concept: the user could select a more exact set
-of needed collections. Language-related collections were completely
-reorganized, so selecting any of them installs not only macros, fonts,
-etc., but also prepares an appropriate \texttt{language.dat}.
-
-The 7th edition of 2002 had as a major addition a setup
-for MacOSX, and the usual myriad of updates to all sorts
-of packages and programs. An important goal was integration
-of the source back with teTeX, to correct the drift apart
-in versions 5 and 6.
-
-\section{Future versions}
-
-\emph{This \CD{} is not a perfect product!} We plan to re-issue it
-once a year, 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 a
-great deal remains to be done. If you can help, don't hesitate to put
-your name forward!
-
-Corrections, suggestions and additions for future revisions
-should be sent to:\hfill\null
-\begin{quote}
-Sebastian Rahtz\\
-{}7 Stratfield Road\\
-Oxford OX2 7BG\\
-United Kingdom\\
-\EmailURL{rahtz@tug.org}
-\end{quote}
-
-
-Updates, notes, and suggestions will be made available on \CTAN{}
-in \path|info/texlive|. A \acro{WWW} page for
-information and ordering details is at
-\url{http://www.tug.org/tex-live.html}.
-
-\end{multicols}
-
-\Section{The texmf.cnf file}
-\label{app:texmf.cnf}
-\begin{small}
-\listinginput{1}{../examples/texmf.cnf}
-\end{small}
-
-\end{document}
-
-
-
-Notes on Nicolle Zellner's problems:
-------------------------------------
-- autoexec.bat gave error, ``too many parameters''.
-fix: in setvars.bat file, put "" around %PATH% to take care of spaces.
-
-- ``out of environment space'' when rebooting meant that autoexec.bat was
-not executing properly-- path and texmfhome variable were not being set.
-fix: put in config.sys file the line: shell=c:\command.com /e:1024 /p
-(and reboot probably)
-
-[Note: alternative advice written by Pat:
- The environment space is an area of memory in which the OS stores
- variables such as path. To increase the memory size do the following:
-
- Open a MS-DOS window. Click on the Properties icon (looks like a hand
- holding a sheet of paper). Click on the Memory tab in the Properties
- window. Change the value under Initial Environment: to 4096. Apply the
- properties. Click OK on the warning about needing to restart your computer.
- The new environment memory will be in effect after the reboot.]
-
-- windvi did not retain settings.
-fix: in setvars.bat file, add command: set Home=c:\Home and also create
-the directory c:\Home.
-copy windvi.cnf to c:\Home\
-reboot
-
--ispell doesn't work (can't write to c:\tmp, can't create dictionary)
-In addition to the the c:\Home addition above, create the folder:
-d:\tmp\ (d: is where the files are that she is using.)
-Now ispell should work from the command line.
-Still can't get it to work from within \cmdname{WinShell}. (change cmd line to %c.tex,
-it was reading the project main file)
-
-
-
-Notes on installing WinEdt:
----------------------------
-If you choose to install WinEdt, you will be asked for a folder name: any
-folder name will do, as this is for temporary storage. An acceptable
-choice is \verb+C:\Winedt+. Click \textbf{unzip}, then \textbf{OK},
-and finally \textbf{Close}.
----
-
-later, to complete WinEdt installation:
-
-Run "winedt5.exe" and complete the setup procedure.
-
-Get from ftp://ftp.dante.de/pub/fptex/supplementary/
-30/08/2000 20:17 70 844 winedt5-cnf.zip
-10/09/2000 10:43 839 086 winedt5-patch4.zip
-
-then unpack (use unzip or winzip with subdir creation enabled, NOT pkunzkip)
- "winedt5-patch4.zip" inside the "c:\program files\winedt" directory
-then at last unpack "winedt5-cnf.zip".
-
-When this is done, go inside the 'Options->Configurations' menu,
-choose the "fpTeX Direct" option.
-
-If windvi previewer doesn't work, go to options->menu setup-> accessories
-and change the Menu Setup so the call for DVI Preview is analogous to
-the call for Dvips-- i.e., don't use "DVIVIEW" in the command line,
-but rather fptex-bin and dviwin.exe.
-
-
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/live4ht.cfg-2004 b/Master/texmf-doc/source/texlive/texlive-en/archive/live4ht.cfg-2004
deleted file mode 100644
index 8700827d62a..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/live4ht.cfg-2004
+++ /dev/null
@@ -1,36 +0,0 @@
-% $Id$
-% tex4ht configuration file for the TeX Live documentation.
-%
-% The 2 means to separate output files for only the top sectioning levels.
-% xhtml specifies the main output format.
-% info for extra debugging info in the log files.
-% Without the \begin{document}, LaTeX complains that it is missing.
-%
-\Preamble{2,xhtml,info} \begin{document} \EndPreamble
-
-% simplify output for HTML. We leave TeX and LaTeX alone, since tex4ht
-% actually does the lowered E (and raised A) in CSS.
-\def\OMEGA{Omega}
-\def\LaTeXe{LaTeX2e}
-\def\eTeX{e-\TeX}
-\def\acro#1{#1}
-\def\MF{Metafont}
-\def\BibTeX{BibTeX}
-\def\warningbox{}
-\def\endwarningbox{}
-
-\newif\ifhackliterals
-\ifx\tldocenglish\undefined \else \hackliteralstrue \fi
-\ifx\tldocrussian\undefined \else \hackliteralstrue \fi
-\ifx\tldocgerman\undefined \else \hackliteralstrue \fi
-%
-\ifhackliterals
- % these definitions cause "missing } inserted" at \end{tabularx} in
- % French and Czech. don't know why.
- %
- % don't make these into links, as happens with \path. We only have a couple
- % special characters that actually occur.
- \def\dirname{\texttt\bgroup\catcode`\$=12 \catcode`\_=12 \finishliteral}
- \def\finishliteral#1{#1\egroup}
- \let\filename=\dirname
-\fi
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/mod.pl b/Master/texmf-doc/source/texlive/texlive-en/archive/mod.pl
deleted file mode 100644
index 4f8df5df762..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/mod.pl
+++ /dev/null
@@ -1,976 +0,0 @@
-
-$M{"a0poster"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"a4"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"a4wide"}="18 May 1996 11:33:54 Graham.Williams\@cmis.csiro.au";
-$M{"a5"}="19 Apr 1998 15:19:21 Graham.Williams\@cmis.csiro.au";
-$M{"a5comb"}="19 Apr 1998 15:19:21 Graham.Williams\@cmis.csiro.au";
-$M{"aaai"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"abc2mtex"}="27 Nov 1996 13:50:01 Graham.Williams\@cmis.csiro.au";
-$M{"abstbook"}="5 Mar 1997 16:28:20 Graham.Williams\@cmis.csiro.au";
-$M{"abstyles"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"accents"}="25 Feb 1999 09:06:12 Graham.Williams\@cmis.csiro.au";
-$M{"accfonts"}="30 Jan 1999 06:16:19 Graham.Williams\@cmis.csiro.au";
-$M{"achemso"}="8 Jul 1998 08:11:28 Graham.Williams\@cmis.csiro.au";
-$M{"acronym"}="17 Nov 1997 09:21:35 Graham.Williams\@cmis.csiro.au";
-$M{"acroread"}="20 May 1997 18:04:58 Graham.Williams\@cmis.csiro.au";
-$M{"acrotex"}="2 Dec 1998 09:52:54 Graham.Williams\@cmis.csiro.au";
-$M{"adfathesis"}="23 Feb 1999 16:11:03 Graham.Williams\@cmis.csiro.au";
-$M{"adobe"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"adobeother"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"adobestd"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"adrlist"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"advdate"}="5 Mar 1997 11:25:37 Graham.Williams\@cmis.csiro.au";
-$M{"ae"}="5 Dec 1998 08:56:53 Graham.Williams\@cmis.csiro.au";
-$M{"afterpage"}="13 Aug 1998 05:36:56 Graham.Williams\@cmis.csiro.au";
-$M{"afthesis"}="15 Dec 1996 19:08:54 Graham.Williams\@cmis.csiro.au";
-$M{"aguplus"}="16 Sep 1998 06:02:47 Graham.Williams\@cmis.csiro.au";
-$M{"aiaa"}="24 Feb 1999 09:15:44 Graham.Williams\@cmis.csiro.au";
-$M{"akletter"}="1 Jun 1998 12:04:46 Graham.Williams\@cmis.csiro.au";
-$M{"alatex"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"alg"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"algorithms"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"alltt"}="28 May 1996 16:23:49 Graham.Williams\@cmis.csiro.au";
-$M{"alphanum"}="10 Mar 1998 06:11:22 Graham.Williams\@cmis.csiro.au";
-$M{"altfont"}="1 Jul 1996 21:06:06 Graham.Williams\@cmis.csiro.au";
-$M{"altfont"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"amiweb2c"}="25 Mar 1998 09:12:31 Graham.Williams\@cmis.csiro.au";
-$M{"amsbsy"}="18 Jun 1997 19:16:14 Graham.Williams\@cmis.csiro.au";
-$M{"amscd"}="1 Nov 1996 08:34:08 Graham.Williams\@cmis.csiro.au";
-$M{"amsfonts"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"amsfonts"}="9 Nov 1996 15:43:40 Graham.Williams\@cmis.csiro.au";
-$M{"amslatex"}="9 Nov 1996 15:40:28 Graham.Williams\@cmis.csiro.au";
-$M{"amslatex"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"amsltx11"}="9 Nov 1996 15:46:01 Graham.Williams\@cmis.csiro.au";
-$M{"amsmath"}="9 Nov 1996 16:15:32 Graham.Williams\@cmis.csiro.au";
-$M{"amsppt"}="24 Sep 1996 08:42:35 Graham.Williams\@cmis.csiro.au";
-$M{"amsppt1"}="25 Sep 1996 09:41:18 Graham.Williams\@cmis.csiro.au";
-$M{"amssym"}="25 Sep 1996 09:44:00 Graham.Williams\@cmis.csiro.au";
-$M{"amssymb"}="11 Nov 1996 20:19:40 Graham.Williams\@cmis.csiro.au";
-$M{"amstex"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"amstex"}="9 Nov 1996 15:47:35 Graham.Williams\@cmis.csiro.au";
-$M{"amstext"}="11 Nov 1996 20:24:24 Graham.Williams\@cmis.csiro.au";
-$M{"answers"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"answers"}="29 May 1996 13:08:24 Graham.Williams\@cmis.csiro.au";
-$M{"anttvf"}="5 Feb 1998 09:27:21 Graham.Williams\@cmis.csiro.au";
-$M{"anttvf"}="08 Feb 1998 staw\@gust.org.pl";
-$M{"antyktor"}="18 Jun 1998 10:23:35 Graham.Williams\@cmis.csiro.au";
-$M{"apa"}="12 Nov 1998 11:38:01 Graham.Williams\@cmis.csiro.au";
-$M{"apacite"}="12 Jul 1996 10:10:07 Graham.Williams\@cmis.csiro.au";
-$M{"apasoft"}="15 Sep 1998 06:39:47 Graham.Williams\@cmis.csiro.au";
-$M{"apl"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"appendix"}="11 Dec 1998 05:36:39 Graham.Williams\@cmis.csiro.au";
-$M{"ar"}="24 Apr 1998 16:02:22 Graham.Williams\@cmis.csiro.au";
-$M{"arabtex"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"arabtex"}="13 May 1997 16:45:22 Graham.Williams\@cmis.csiro.au";
-$M{"armenian"}="3 Jul 1997 08:23:26 Graham.Williams\@cmis.csiro.au";
-$M{"arosgn"}="21 Oct 1996 10:32:18 Graham.Williams\@cmis.csiro.au";
-$M{"arrow"}="7 Nov 1996 19:31:04 Graham.Williams\@cmis.csiro.au";
-$M{"asaetr"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"ascii"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"astro"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"at"}="12 Nov 1996 09:27:11 Graham.Williams\@cmis.csiro.au";
-$M{"auctex"}="19 Oct 1998 06:10:29 Graham.Williams\@cmis.csiro.au";
-$M{"aurora"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"authorindex"}="16 Feb 1998 17:29:41 Graham.Williams\@cmis.csiro.au";
-$M{"autotab"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"babel"}="12 Jan 1997 11:26:33 Graham.Williams\@cmis.csiro.au";
-$M{"backgammon"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"bakoma-fonts"}="13 Dec 1996 08:26:36 Graham.Williams\@cmis.csiro.au";
-$M{"bakoma"}="22 Jan 1999 07:17:26 Graham.Williams\@cmis.csiro.au";
-$M{"barcode2"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"barcodes"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"barcodes"}="7 Jun 1996 13:43:47 Graham.Williams\@cmis.csiro.au";
-$M{"barr"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"bayer"}="10 Feb 1998 09:30:02 Graham.Williams\@cmis.csiro.au";
-$M{"bbding"}="13 May 1996 06:15:45 Graham.Williams\@cmis.csiro.au";
-$M{"bbding"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"bbm"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"beebe"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"belleek"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"beton"}="28 May 1996 16:24:30 Graham.Williams\@cmis.csiro.au";
-$M{"bez123"}="21 Oct 1998 09:36:53 Graham.Williams\@cmis.csiro.au";
-$M{"bezos"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"bibarts"}="19 Apr 1998 15:55:19 Graham.Williams\@cmis.csiro.au";
-$M{"bibindex"}="12 Jan 1997 14:53:39 Graham.Williams\@cmis.csiro.au";
-$M{"biblio"}="4 Oct 1996 08:44:47 Graham.Williams\@cmis.csiro.au";
-$M{"biblios"}="16 Aug 1996 14:40:47 Graham.Williams\@cmis.csiro.au";
-$M{"biblist"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"biblook"}="12 Jan 1997 14:53:39 Graham.Williams\@cmis.csiro.au";
-$M{"bibsort"}="12 Nov 1996 10:28:11 Graham.Williams\@cmis.csiro.au";
-$M{"bibtex8bit"}="19 Aug 1996 22:05:26 Graham.Williams\@cmis.csiro.au";
-$M{"bibtool"}="24 Feb 1998 13:38:41 Graham.Williams\@cmis.csiro.au";
-$M{"bibunits"}="29 May 1997 12:15:06 Graham.Williams\@cmis.csiro.au";
-$M{"bibweb"}="28 Nov 1997 09:12:23 Graham.Williams\@cmis.csiro.au";
-$M{"bidstobibtex"}="21 Oct 1996 13:54:10 Graham.Williams\@cmis.csiro.au";
-$M{"bitstrea"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"blackboard"}="9 Jul 1998 05:37:01 Graham.Williams\@cmis.csiro.au";
-$M{"blue"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"bluesky"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"bm"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"booktabs"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"borceux"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"bosisio"}="1 May 1998 16:53:18 Graham.Williams\@cmis.csiro.au";
-$M{"boxedminipage"}="19 Apr 1998 15:20:55 Graham.Williams\@cmis.csiro.au";
-$M{"breqn"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"bridge"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"brief"}="30 May 1996 11:22:14 Graham.Williams\@cmis.csiro.au";
-$M{"brushscr"}="24 Jun 1998 12:56:02 Graham.Williams\@cmis.csiro.au";
-$M{"btparse"}="20 Feb 1998 14:21:13 Graham.Williams\@cmis.csiro.au";
-$M{"c-pascal"}="3 Mar 1998 15:29:06 Graham.Williams\@cmis.csiro.au";
-$M{"c2cweb"}="29 Nov 1996 15:27:19 Graham.Williams\@cmis.csiro.au";
-$M{"calc"}="12 Aug 1998 06:27:04 Graham.Williams\@cmis.csiro.au";
-$M{"calendar"}="18 Mar 1997 13:07:53 Graham.Williams\@cmis.csiro.au";
-$M{"calendar"}="4 Feb 1998 13:36:58 Graham.Williams\@cmis.csiro.au";
-$M{"calligra"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"calrsfs"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"calrsfs"}="12 Jun 1996 09:16:09 Graham.Williams\@cmis.csiro.au";
-$M{"camel"}="5 Mar 1997 16:31:57 Graham.Williams\@cmis.csiro.au";
-$M{"cancel"}="26 May 1997 12:53:21 Graham.Williams\@cmis.csiro.au";
-$M{"capt-of"}="15 Dec 1996 19:04:36 Graham.Williams\@cmis.csiro.au";
-$M{"caption"}="12 Nov 1996 20:23:42 Graham.Williams\@cmis.csiro.au";
-$M{"carlisle"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"cases"}="15 Dec 1996 19:14:30 Graham.Williams\@cmis.csiro.au";
-$M{"casyl"}="24 Feb 1999 09:19:05 Graham.Williams\@cmis.csiro.au";
-$M{"catalogue"}="22 May 1996 16:49:04 Graham.Williams\@cmis.csiro.au";
-$M{"catdoc"}="5 Nov 1998 11:47:57 Graham.Williams\@cmis.csiro.au";
-$M{"cbgreek"}="24 Oct 1998 07:42:16 Graham.Williams\@cmis.csiro.au";
-$M{"cc-pl"}="09 Jun 1998 staw\@gust.org.pl";
-$M{"ccaption"}="27 Jan 1999 09:40:41 Graham.Williams\@cmis.csiro.au";
-$M{"ccfonts"}="23 Jun 1998 15:52:05 Graham.Williams\@cmis.csiro.au";
-$M{"cchess"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"cd-cover"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"cdcover"}="10 Feb 1998 09:31:30 Graham.Williams\@cmis.csiro.au";
-$M{"cdlabeler"}="2 Jan 1999 21:57:44 Graham.Williams\@cmis.csiro.au";
-$M{"cellular"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"cep"}="27 Jan 1998 16:53:11 Graham.Williams\@cmis.csiro.au";
-$M{"cep"}="08 Feb 1998 staw\@gust.org.pl";
-$M{"changebar"}="7 Oct 1997 09:02:24 Graham.Williams\@cmis.csiro.au";
-$M{"chapterbib"}="15 Dec 1996 19:13:07 Graham.Williams\@cmis.csiro.au";
-$M{"chemcono"}="21 Oct 1996 14:28:23 Graham.Williams\@cmis.csiro.au";
-$M{"chemcono"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"chemsym"}="8 Jul 1998 08:11:58 Graham.Williams\@cmis.csiro.au";
-$M{"cheq"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"cherokee"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"chess"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"china2e"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"china2e"}="26 Feb 1998 08:51:49 Graham.Williams\@cmis.csiro.au";
-$M{"chktex"}="21 Oct 1996 13:51:58 Graham.Williams\@cmis.csiro.au";
-$M{"circ"}="18 Mar 1998 09:29:16 Graham.Williams\@cmis.csiro.au";
-$M{"circle"}="13 Oct 1998 09:09:47 Graham.Williams\@cmis.csiro.au";
-$M{"circuit-macro"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"circuit-macros"}="6 Sep 1998 05:00:37 Graham.Williams\@cmis.csiro.au";
-$M{"cirth"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"cite"}="15 Dec 1996 19:10:42 Graham.Williams\@cmis.csiro.au";
-$M{"cjk-fonts"}="8 Jan 1999 08:02:11 Graham.Williams\@cmis.csiro.au";
-$M{"cjk"}="8 Jan 1999 08:01:13 Graham.Williams\@cmis.csiro.au";
-$M{"cm"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"cmactex"}="9 Aug 1998 06:47:00 Graham.Williams\@cmis.csiro.au";
-$M{"cmbright"}="28 Dec 1998 09:33:43 Graham.Williams\@cmis.csiro.au";
-$M{"cmcyr"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"cmcyralt"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"cmdtrack"}="22 Feb 1999 16:17:02 Graham.Williams\@cmis.csiro.au";
-$M{"cmextra"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"cmpica"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"cmps"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"cmsd"}="19 Feb 1998 09:45:20 Graham.Williams\@cmis.csiro.au";
-$M{"cmtt"}="1 Jun 1996 15:43:59 Graham.Williams\@cmis.csiro.au";
-$M{"cmyk-hax"}="12 May 1997 10:23:51 Graham.Williams\@cmis.csiro.au";
-$M{"cmyk-hax"}="08 Feb 1998 staw\@gust.org.pl";
-$M{"code128"}="7 Jun 1996 13:42:22 Graham.Williams\@cmis.csiro.au";
-$M{"codepage"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"color"}="24 Sep 1996 08:56:07 Graham.Williams\@cmis.csiro.au";
-$M{"colorsep"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"colortbl"}="24 Jun 1998 13:01:21 Graham.Williams\@cmis.csiro.au";
-$M{"comma"}="11 Feb 1998 07:46:23 Graham.Williams\@cmis.csiro.au";
-$M{"comment"}="8 Sep 1998 06:29:57 Graham.Williams\@cmis.csiro.au";
-$M{"compsci"}="21 Oct 1996 14:11:57 Graham.Williams\@cmis.csiro.au";
-$M{"concmath"}="25 Dec 1996 UV";
-$M{"concprog"}="22 Oct 1996 09:37:54 Graham.Williams\@cmis.csiro.au";
-$M{"concrete-wrap"}="27 Nov 1996 13:57:24 Graham.Williams\@cmis.csiro.au";
-$M{"concrete"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"consdiag"}="21 Jan 1999 19:26:28 Graham.Williams\@cmis.csiro.au";
-$M{"context"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"corelpak"}="21 Jan 1999 14:00:25 Graham.Williams\@cmis.csiro.au";
-$M{"count1to"}="24 Oct 1998 09:04:16 Graham.Williams\@cmis.csiro.au";
-$M{"covington"}="22 Apr 1997 14:32:07 Graham.Williams\@cmis.csiro.au";
-$M{"croatian"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"crop"}="8 Dec 1998 09:21:42 Graham.Williams\@cmis.csiro.au";
-$M{"crossword"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"crosswrd"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"csfonts"}="3 May 1997 s.rahtz\@elsevier.co.uk";
-$M{"cslatex"}="3 May 1997 s.rahtz\@elsevier.co.uk";
-$M{"csplain"}="3 May 1997 s.rahtz\@elsevier.co.uk";
-$M{"cspsfonts"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"cstug"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"csx"}="12 Jul 1998 05:30:19 Graham.Williams\@cmis.csiro.au";
-$M{"cursor"}="20 Jan 1999 14:56:10 Graham.Williams\@cmis.csiro.au";
-$M{"custom-bib"}="18 Aug 1998 18:00:42 Graham.Williams\@cmis.csiro.au";
-$M{"cwebbin"}="16 Oct 1998 06:27:49 Graham.Williams\@cmis.csiro.au";
-$M{"cwebx"}="17 Feb 1999 16:44:14 Graham.Williams\@cmis.csiro.au";
-$M{"cwpuzzle"}="28 Nov 1996 10:09:18 Graham.Williams\@cmis.csiro.au";
-$M{"cyrtug"}="8 Oct 1998 11:51:48 Graham.Williams\@cmis.csiro.au";
-$M{"dancers"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"dante-src"}="11 Feb 1998 07:50:55 Graham.Williams\@cmis.csiro.au";
-$M{"dates"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"dblfont"}="1 May 1998 16:53:44 Graham.Williams\@cmis.csiro.au";
-$M{"dbprocess"}="2 Jan 1999 21:55:59 Graham.Williams\@cmis.csiro.au";
-$M{"dc"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"dc"}="2 Jun 1996 11:09:21 Graham.Williams\@cmis.csiro.au";
-$M{"dco"}="16 Aug 1996 14:14:54 Graham.Williams\@cmis.csiro.au";
-$M{"dcounter"}="28 Dec 1998 09:21:00 Graham.Williams\@cmis.csiro.au";
-$M{"default"}="18 Jul 1998 06:43:35 Graham.Williams\@cmis.csiro.au";
-$M{"deleq"}="8 Jul 1998 08:12:25 Graham.Williams\@cmis.csiro.au";
-$M{"devanagari"}="7 Dec 1998 05:46:30 Graham.Williams\@cmis.csiro.au";
-$M{"dialogl"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"dinbrief"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"dinbrief"}="4 Nov 1996 09:56:05 Graham.Williams\@cmis.csiro.au";
-$M{"directory"}="10 Mar 1998 05:30:54 Graham.Williams\@cmis.csiro.au";
-$M{"dn2"}="13 Mar 1998 09:10:15 Graham.Williams\@cmis.csiro.au";
-$M{"doc"}="19 Aug 1996 22:19:13 Graham.Williams\@cmis.csiro.au";
-$M{"dotseqn"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"doublestroke"}="21 Oct 1996 13:56:41 Graham.Williams\@cmis.csiro.au";
-$M{"draftcopy"}="21 May 1996 12:52:54 Graham.Williams\@cmis.csiro.au";
-$M{"dratex"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"dropcaps"}="19 Jun 1996 13:38:04 Graham.Williams\@cmis.csiro.au";
-$M{"dropping"}="9 Jul 1998 06:27:48 Graham.Williams\@cmis.csiro.au";
-$M{"duerer"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"dvgtk"}="29 Apr 1997 14:45:04 Graham.Williams\@cmis.csiro.au";
-$M{"dvi2tty"}="7 Jun 1996 20:12:43 Graham.Williams\@cmis.csiro.au";
-$M{"dviconcat"}="1 Nov 1996 08:10:15 Graham.Williams\@cmis.csiro.au";
-$M{"dvicopy"}="= {1 Nov 1996 08:30:05 Graham.Williams\@cmis.csiro.au";
-$M{"dviljk"}="6 Apr 1998 06:10:01 Graham.Williams\@cmis.csiro.au";
-$M{"dvipaste"}="23 Feb 1998 15:46:09 Graham.Williams\@cmis.csiro.au";
-$M{"dvipdfm"}="2 Dec 1998 05:56:54 Graham.Williams\@cmis.csiro.au";
-$M{"dvips-os2"}="21 Jan 1999 13:57:52 Graham.Williams\@cmis.csiro.au";
-$M{"dvips-shell"}="5 Mar 1998 22:29:41 Graham.Williams\@cmis.csiro.au";
-$M{"dvips"}="13 May 1997 09:51:53 Graham.Williams\@cmis.csiro.au";
-$M{"dvipsdoc"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"dvipsk"}="6 Apr 1998 05:56:12 Graham.Williams\@cmis.csiro.au";
-$M{"ean"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"ean"}="7 Jun 1996 13:44:26 Graham.Williams\@cmis.csiro.au";
-$M{"easy"}="18 Aug 1998 18:24:49 Graham.Williams\@cmis.csiro.au";
-$M{"easybib"}="7 Mar 1997 16:54:36 Graham.Williams\@cmis.csiro.au";
-$M{"easybmat"}="18 Aug 1998 18:27:38 Graham.Williams\@cmis.csiro.au";
-$M{"easyeqn"}="18 Nov 1997 15:21:55 Graham.Williams\@cmis.csiro.au";
-$M{"easymat"}="18 Aug 1998 18:28:31 Graham.Williams\@cmis.csiro.au";
-$M{"easytable"}="18 Aug 1998 18:28:50 Graham.Williams\@cmis.csiro.au";
-$M{"easyvector"}="18 Nov 1997 15:22:16 Graham.Williams\@cmis.csiro.au";
-$M{"ec-plain"}="21 Apr 1998 08:38:32 Graham.Williams\@cmis.csiro.au";
-$M{"ec"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"ecc"}="11 Dec 1998 08:59:53 Graham.Williams\@cmis.csiro.au";
-$M{"ecltree"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"eco"}="22 Jul 1998 09:13:53 Graham.Williams\@cmis.csiro.au";
-$M{"ecpk"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"edmac"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"eepic"}="28 Dec 1998 09:32:41 Graham.Williams\@cmis.csiro.au";
-$M{"egplot"}="9 Jul 1998 06:27:09 Graham.Williams\@cmis.csiro.au";
-$M{"eiad"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"eijkhout"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"elsevier"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"elvish"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"emp"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"emp"}="26 Feb 1998 08:53:14 Graham.Williams\@cmis.csiro.au";
-$M{"emtex-os2"}="31 Jul 1998 10:16:40 Graham.Williams\@cmis.csiro.au";
-$M{"emtex"}="31 Jul 1998 10:16:40 Graham.Williams\@cmis.csiro.au";
-$M{"emtexgi"}="12 Jan 1997 11:32:36 Graham.Williams\@cmis.csiro.au";
-$M{"emtextds"}="30 Sep 1998 07:58:58 Graham.Williams\@cmis.csiro.au";
-$M{"emulateapj"}="27 Nov 1997 17:06:10 Graham.Williams\@cmis.csiro.au";
-$M{"encodings"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"endfloat"}="21 Jun 1996 14:52:55 Graham.Williams\@cmis.csiro.au";
-$M{"endnotes"}="3 Sep 1996 09:20:05 Graham.Williams\@cmis.csiro.au";
-$M{"endnotes"}="4 Feb 1998 13:33:16 Graham.Williams\@cmis.csiro.au";
-$M{"engwar"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"enumerate"}="22 Jul 1998 05:47:30 Graham.Williams\@cmis.csiro.au";
-$M{"envbig"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"envlab"}="17 Jul 1997 14:37:23 Graham.Williams\@cmis.csiro.au";
-$M{"epic"}="24 Jul 1998 06:18:39 Graham.Williams\@cmis.csiro.au";
-$M{"epigraph"}="1 Dec 1998 12:42:01 Graham.Williams\@cmis.csiro.au";
-$M{"eplain"}="19 Aug 1996 22:10:25 Graham.Williams\@cmis.csiro.au";
-$M{"epmtfe"}="23 Feb 1999 15:01:08 Graham.Williams\@cmis.csiro.au";
-$M{"epsfx"}="09 Jun 1998 staw\@gust.org.pl";
-$M{"epslatex"}="9 Feb 1998 09:22:51 Graham.Williams\@cmis.csiro.au";
-$M{"eqname"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"esieecv"}="26 Feb 1998 08:54:52 Graham.Williams\@cmis.csiro.au";
-$M{"esieecv"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"esindex"}="10 Nov 1998 10:40:44 Graham.Williams\@cmis.csiro.au";
-$M{"eso-pic"}="22 Jul 1998 06:17:37 Graham.Williams\@cmis.csiro.au";
-$M{"et"}="24 Feb 1998 13:45:45 Graham.Williams\@cmis.csiro.au";
-$M{"etexbase"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"ethiop"}="13 Dec 1998 15:02:18 Graham.Williams\@cmis.csiro.au";
-$M{"euler"}="5 Jun 1996 10:03:48 Graham.Williams\@cmis.csiro.au";
-$M{"euro"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"eurofont"}="31 Jan 1999 07:41:02 Graham.Williams\@cmis.csiro.au";
-$M{"europs"}="21 Jan 1999 13:04:27 Graham.Williams\@cmis.csiro.au";
-$M{"eurosans"}="27 Jan 1999 08:25:26 Graham.Williams\@cmis.csiro.au";
-$M{"eurosym"}="6 Jan 1999 07:26:11 Graham.Williams\@cmis.csiro.au";
-$M{"everysel"}="10 Aug 1998 09:05:43 Graham.Williams\@cmis.csiro.au";
-$M{"everyshi"}="10 Aug 1998 09:20:24 Graham.Williams\@cmis.csiro.au";
-$M{"exam"}="16 Dec 1998 08:31:47 Graham.Williams\@cmis.csiro.au";
-$M{"examdesign"}="20 Jan 1998 22:03:03 Graham.Williams\@cmis.csiro.au";
-$M{"exams"}="29 May 1996 13:09:04 Graham.Williams\@cmis.csiro.au";
-$M{"excalibur"}="8 Nov 1998 07:01:25 Graham.Williams\@cmis.csiro.au";
-$M{"expdlist"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"expl3"}="1 Jun 1998 12:09:40 Graham.Williams\@cmis.csiro.au";
-$M{"export"}="12 Jan 1997 11:45:06 Graham.Williams\@cmis.csiro.au";
-$M{"export"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"exscale"}="12 Jun 1996 06:53:11 Graham.Williams\@cmis.csiro.au";
-$M{"extdash"}="28 Dec 1998 09:21:00 Graham.Williams\@cmis.csiro.au";
-$M{"fancybox"}="2 Mar 1998 09:20:57 Graham.Williams\@cmis.csiro.au";
-$M{"fancyhdr"}="9 Sep 1998 06:51:16 Graham.Williams\@cmis.csiro.au";
-$M{"fancyref"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"fancyvrb"}="1 Apr 1998 06:01:31 Graham.Williams\@cmis.csiro.au";
-$M{"faq"}="1 Jul 1998 10:31:39 Graham.Williams\@cmis.csiro.au";
-$M{"fax"}="13 Dec 1996 09:32:37 Graham.Williams\@cmis.csiro.au";
-$M{"fc"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"fc"}="5 Mar 1998 22:19:31 Graham.Williams\@cmis.csiro.au";
-$M{"fepslatex"}="6 Nov 1998 05:54:05 Graham.Williams\@cmis.csiro.au";
-$M{"feynmf"}="30 May 1996 06:34:12 Graham.Williams\@cmis.csiro.au";
-$M{"fihyph"}=" from fihyph.tex to make the Finnish accented";
-$M{"fihyph"}="6 Nov 1998 06:34:36 Graham.Williams\@cmis.csiro.au";
-$M{"finbib"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"finplain"}="29 Jun 1998 10:04:25 Graham.Williams\@cmis.csiro.au";
-$M{"fix2col"}="19 Aug 1998 16:52:30 Graham.Williams\@cmis.csiro.au";
-$M{"fixfloat"}="23 May 1997 09:28:11 Graham.Williams\@cmis.csiro.au";
-$M{"flabels"}="21 Jul 1997 09:34:31 Graham.Williams\@cmis.csiro.au";
-$M{"flatex"}="24 Sep 1996 08:59:43 Graham.Williams\@cmis.csiro.au";
-$M{"flatten"}="18 Jun 1996 09:36:48 Graham.Williams\@cmis.csiro.au";
-$M{"float"}="25 May 1996 07:26:32 Graham.Williams\@cmis.csiro.au";
-$M{"floatflt"}="8 Jul 1998 08:16:33 Graham.Williams\@cmis.csiro.au";
-$M{"fltpage"}="19 Nov 1998 05:29:33 Graham.Williams\@cmis.csiro.au";
-$M{"fncychap"}=" Each can be using a set of simple commands.";
-$M{"fncychap"}="13 Dec 1996 08:41:01 Graham.Williams\@cmis.csiro.au";
-$M{"fnpara"}="10 Sep 1996 09:23:00 Graham.Williams\@cmis.csiro.au";
-$M{"foilhtml"}="19 Feb 1998 09:39:43 Graham.Williams\@cmis.csiro.au";
-$M{"foiltex"}="15 Aug 1998 07:01:05 Graham.Williams\@cmis.csiro.au";
-$M{"fontinst"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"fontmisc"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"fontname"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"fonts"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"footbib"}="19 Jun 1997 11:31:23 Graham.Williams\@cmis.csiro.au";
-$M{"footmisc"}="22 Jun 1998 16:47:47 Graham.Williams\@cmis.csiro.au";
-$M{"footnpag"}="10 Sep 1996 09:26:38 Graham.Williams\@cmis.csiro.au";
-$M{"formats"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"formlett"}="27 May 1997 09:39:35 Graham.Williams\@cmis.csiro.au";
-$M{"formula"}="18 Jun 1998 10:24:39 Graham.Williams\@cmis.csiro.au";
-$M{"fourtex"}="21 Nov 1998 05:32:50 Graham.Williams\@cmis.csiro.au";
-$M{"fp"}="4 Nov 1996 09:45:28 Graham.Williams\@cmis.csiro.au";
-$M{"freefonts"}="10 Sep 1998 18:50:47 Graham.Williams\@cmis.csiro.au";
-$M{"freetype"}="2 Jan 1999 22:37:14 Graham.Williams\@cmis.csiro.au";
-$M{"french"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"fribrief"}="20 Jan 1998 21:50:51 Graham.Williams\@cmis.csiro.au";
-$M{"ftetx"}="24 Feb 1998 13:52:42 Graham.Williams\@cmis.csiro.au";
-$M{"ftn"}="10 Sep 1996 09:43:47 Graham.Williams\@cmis.csiro.au";
-$M{"ftnright"}="19 Aug 1996 22:20:55 Graham.Williams\@cmis.csiro.au";
-$M{"fullblck"}="18 Nov 1998 09:21:36 Graham.Williams\@cmis.csiro.au";
-$M{"fullpict"}="18 Feb 1999 10:39:07 Graham.Williams\@cmis.csiro.au";
-$M{"fundus"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"funnelweb"}="25 Jun 1996 12:38:19 Graham.Williams\@cmis.csiro.au";
-$M{"futhark"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"g-brief"}="20 Feb 1998 14:17:49 Graham.Williams\@cmis.csiro.au";
-$M{"gb4e"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"genealogy"}="31 May 1996 14:10:08 Graham.Williams\@cmis.csiro.au";
-$M{"genmisc"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"gentl-gr"}="29 Jan 1999 09:40:36 Graham.Williams\@cmis.csiro.au";
-$M{"geometry"}="8 Apr 1998 14:26:57 Graham.Williams\@cmis.csiro.au";
-$M{"geomsty"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"geomsty"}="26 Feb 1998 08:58:15 Graham.Williams\@cmis.csiro.au";
-$M{"german"}="15 Jul 1998 07:33:39 Graham.Williams\@cmis.csiro.au";
-$M{"germbib"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"germdoc"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"getrefs"}="12 Nov 1998 20:22:10 Graham.Williams\@cmis.csiro.au";
-$M{"ghostscript"}="20 May 1997 14:12:34 Graham.Williams\@cmis.csiro.au";
-$M{"ghostview-mac"}="27 Mar 1998 05:51:48 Graham.Williams\@cmis.csiro.au";
-$M{"ghyphen"}="8 Jul 1998 08:55:23 Graham.Williams\@cmis.csiro.au";
-$M{"gleitobjekte"}="17 Feb 1998 09:09:23 Graham.Williams\@cmis.csiro.au";
-$M{"gloss"}="19 Apr 1998 15:58:24 Graham.Williams\@cmis.csiro.au";
-$M{"glosstex"}="25 Feb 1998 09:12:56 Graham.Williams\@cmis.csiro.au";
-$M{"gn-logic"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"gnhyph"}="16 Sep 1998 09:18:43 Graham.Williams\@cmis.csiro.au";
-$M{"gnuplot-ps"}="30 May 1996 11:22:14 Graham.Williams\@cmis.csiro.au";
-$M{"go"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"gothic"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"graphfig"}="1 May 1998 16:54:18 Graham.Williams\@cmis.csiro.au";
-$M{"graphics"}="1 Nov 1996 08:16:13 Graham.Williams\@cmis.csiro.au";
-$M{"graphicx"}="12 Jun 1996 06:47:22 Graham.Williams\@cmis.csiro.au";
-$M{"gray"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"grfguide"}="11 Jun 1997 16:17:05 Graham.Williams\@cmis.csiro.au";
-$M{"grfpaste"}="23 Feb 1998 15:39:11 Graham.Williams\@cmis.csiro.au";
-$M{"grnumalt"}="23 Feb 1998 15:49:56 Graham.Williams\@cmis.csiro.au";
-$M{"gsftopk"}="12 Nov 1996 09:08:05 Graham.Williams\@cmis.csiro.au";
-$M{"gustlib"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"gustlib"}="March 1998, s.rahtz\@elsevier.co.uk";
-$M{"hands"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"hanging"}="11 Dec 1998 05:38:02 Graham.Williams\@cmis.csiro.au";
-$M{"harpoon"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"harvmac"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"hellas"}="10 Mar 1998 06:00:34 Graham.Williams\@cmis.csiro.au";
-$M{"here"}="25 May 1996 07:24:51 Graham.Williams\@cmis.csiro.au";
-$M{"hh"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"hilowres"}="21 Jan 1999 19:31:07 Graham.Williams\@cmis.csiro.au";
-$M{"histogr"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"hlatex"}="28 May 1997 16:04:14 Graham.Williams\@cmis.csiro.au";
-$M{"hoekwater"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"html"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"html2latex"}="30 Sep 1998 07:55:02 Graham.Williams\@cmis.csiro.au";
-$M{"huhyph"}="5 Nov 1998 05:50:17 Graham.Williams\@cmis.csiro.au";
-$M{"hvdashln"}="13 May 1997 09:36:00 Graham.Williams\@cmis.csiro.au";
-$M{"hyper"}="30 Aug 1997 12:04:32 Graham.Williams\@cmis.csiro.au";
-$M{"hyperlatex"}="27 Dec 1998 20:25:24 Graham.Williams\@cmis.csiro.au";
-$M{"hyperref"}="17 Feb 1999 16:41:40 Graham.Williams\@cmis.csiro.au";
-$M{"hyphenat"}="22 Feb 1999 16:42:36 Graham.Williams\@cmis.csiro.au";
-$M{"hypht1"}="3 May 1997 20:57:53 Graham.Williams\@cmis.csiro.au";
-$M{"ibm"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"idealfonts"}="20 Feb 1998 14:34:54 Graham.Williams\@cmis.csiro.au";
-$M{"ifacmtg"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"imac"}="24 Sep 1998 05:27:35 Graham.Williams\@cmis.csiro.au";
-$M{"indxcite"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"indxcite"}="24 Jun 1996 15:17:51 Graham.Williams\@cmis.csiro.au";
-$M{"info"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"inhyph"}="7 Oct 1997 08:54:26 Graham.Williams\@cmis.csiro.au";
-$M{"inputenc"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"insbox"}="25 Feb 1998 09:20:32 Graham.Williams\@cmis.csiro.au";
-$M{"ipa"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"isostds"}="21 Oct 1998 09:38:15 Graham.Williams\@cmis.csiro.au";
-$M{"ithyph"}="4 Aug 1998 05:39:19 Graham.Williams\@cmis.csiro.au";
-$M{"izhitsa"}="30 Jan 1999 06:34:27 Graham.Williams\@cmis.csiro.au";
-$M{"jadetex"}="3 May 1997 s.rahtz\@elsevier.co.uk";
-$M{"javatex"}="8 Oct 1998 12:03:35 Graham.Williams\@cmis.csiro.au";
-$M{"jknappen"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"jknappen"}="10 Mar 1998 09:10:20 Graham.Williams\@cmis.csiro.au";
-$M{"jsmisc"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"jspell"}="= {5 Nov 1998 15:43:30 Graham.Williams\@cmis.csiro.au";
-$M{"jura"}="11 Jul 1998 17:22:01 Graham.Williams\@cmis.csiro.au";
-$M{"kalendar"}="27 Mar 1998 05:44:58 Graham.Williams\@cmis.csiro.au";
-$M{"kalender"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"karnaugh"}="24 Sep 1998 05:26:10 Graham.Williams\@cmis.csiro.au";
-$M{"kdgreek"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"kix"}="19 Sep 1998 08:58:56 Graham.Williams\@cmis.csiro.au";
-$M{"kluwer"}="31 May 1997 20:08:21 Graham.Williams\@cmis.csiro.au";
-$M{"knst"}="21 Oct 1996 13:44:44 Graham.Williams\@cmis.csiro.au";
-$M{"knuth"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"koi8"}="21 Oct 1996 13:48:21 Graham.Williams\@cmis.csiro.au";
-$M{"koma-script"}="30 Nov 1998 09:41:00 Graham.Williams\@cmis.csiro.au";
-$M{"kpathsea"}="3 Feb 1999 10:29:24 Graham.Williams\@cmis.csiro.au";
-$M{"kuvio"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"lamstex"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"lated"}="11 Feb 1998 07:41:10 Graham.Williams\@cmis.csiro.au";
-$M{"latex"}="2 Jul 1998 12:56:15 Graham.Williams\@cmis.csiro.au";
-$M{"latex209"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"latex209"}="4 Jul 1996 10:07:05 Graham.Williams\@cmis.csiro.au";
-$M{"latex2e"}="4 Jul 1996 09:53:38 Graham.Williams\@cmis.csiro.au";
-$M{"latex2html"}="8 Jul 1996 23:00:59 Graham.Williams\@cmis.csiro.au";
-$M{"latex2man"}="9 Sep 1998 05:33:13 Graham.Williams\@cmis.csiro.au";
-$M{"latex2rtf"}="17 Nov 1998 08:56:23 Graham.Williams\@cmis.csiro.au";
-$M{"latexcad"}="20 Mar 1998 09:32:43 Graham.Williams\@cmis.csiro.au";
-$M{"latexfonts"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"latexmk"}="12 Jan 1997 11:30:28 Graham.Williams\@cmis.csiro.au";
-$M{"latexn"}="27 Nov 1997 17:04:03 Graham.Williams\@cmis.csiro.au";
-$M{"latin2jk"}="7 Oct 1997 08:56:04 Graham.Williams\@cmis.csiro.au";
-$M{"layout"}="13 Aug 1998 05:42:38 Graham.Williams\@cmis.csiro.au";
-$M{"layouts"}="31 Jan 1999 06:43:57 Graham.Williams\@cmis.csiro.au";
-$M{"leaflet"}="30 Sep 1998 08:20:21 Graham.Williams\@cmis.csiro.au";
-$M{"leftidx"}="4 Feb 1998 13:16:00 Graham.Williams\@cmis.csiro.au";
-$M{"letter"}="6 Nov 1998 13:26:58 Graham.Williams\@cmis.csiro.au";
-$M{"lettrine"}="25 Mar 1998 09:11:24 Graham.Williams\@cmis.csiro.au";
-$M{"levy"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"lexikon"}="1 Apr 1998 06:05:45 Graham.Williams\@cmis.csiro.au";
-$M{"lgreek"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"lgrind-win32"}="24 Mar 1998 11:41:55 Graham.Williams\@cmis.csiro.au";
-$M{"lgrind"}="5 Aug 1998 06:33:28 Graham.Williams\@cmis.csiro.au";
-$M{"lh"}="2 Oct 1998 07:20:00 Graham.Williams\@cmis.csiro.au";
-$M{"lhcyr"}="21 Jan 1999 19:44:44 Graham.Williams\@cmis.csiro.au";
-$M{"lilypond"}="21 Oct 1998 09:41:28 Graham.Williams\@cmis.csiro.au";
-$M{"lineno"}="20 Jan 1999 14:57:13 Graham.Williams\@cmis.csiro.au";
-$M{"linguex"}="1 Jun 1998 11:57:34 Graham.Williams\@cmis.csiro.au";
-$M{"lintex"}="16 Jun 1998 10:19:01 Graham.Williams\@cmis.csiro.au";
-$M{"lips"}="21 Oct 1996 10:30:25 Graham.Williams\@cmis.csiro.au";
-$M{"listings"}="11 Nov 1998 05:44:14 Graham.Williams\@cmis.csiro.au";
-$M{"lkort"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"llncs"}="4 Oct 1996 08:48:06 Graham.Williams\@cmis.csiro.au";
-$M{"localloc"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"logic"}="3 May 1997 s.rahtz\@elsevier.co.uk";
-$M{"logo-ps"}="25 Jul 1998 06:24:28 Graham.Williams\@cmis.csiro.au";
-$M{"lollipop"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"longtable"}="21 Jun 1996 08:12:11 Graham.Williams\@cmis.csiro.au";
-$M{"lscape"}="7 Nov 1996 19:36:31 Graham.Williams\@cmis.csiro.au";
-$M{"lshort-english"}="21 Jan 1999 19:27:28 Graham.Williams\@cmis.csiro.au";
-$M{"lshort-finnish"}="21 Jan 1999 19:12:55 Graham.Williams\@cmis.csiro.au";
-$M{"lshort-french"}="5 Feb 1998 09:10:02 Graham.Williams\@cmis.csiro.au";
-$M{"lshort-german"}="30 Jan 1999 07:28:37 Graham.Williams\@cmis.csiro.au";
-$M{"lshort-mongolian"}="30 Jan 1999 07:28:04 Graham.Williams\@cmis.csiro.au";
-$M{"lshort-polish"}="25 Feb 1999 14:09:31 Graham.Williams\@cmis.csiro.au";
-$M{"lshort-russian"}="13 Oct 1998 09:11:31 Graham.Williams\@cmis.csiro.au";
-$M{"lshort-spanish"}="21 Jan 1999 19:12:55 Graham.Williams\@cmis.csiro.au";
-$M{"ltoh"}="8 Apr 1998 09:41:19 Graham.Williams\@cmis.csiro.au";
-$M{"ltx2rtf"}="28 Dec 1998 09:11:53 Graham.Williams\@cmis.csiro.au";
-$M{"ltx2x"}="26 Jan 1997 10:24:09 Graham.Williams\@cmis.csiro.au";
-$M{"ltxbase"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"ltxinput"}="26 Nov 1996 16:30:38 Graham.Williams\@cmis.csiro.au";
-$M{"ltxmisc"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"ltxsrc"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"lucida"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"lucold"}="4 Feb 1998 13:23:16 Graham.Williams\@cmis.csiro.au";
-$M{"lw35nfsx"}="28 Jul 1998 05:36:21 Graham.Williams\@cmis.csiro.au";
-$M{"ly1"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"m-pictex"}="24 Feb 1998 13:55:54 Graham.Williams\@cmis.csiro.au";
-$M{"macbibtex"}="7 Nov 1996 13:35:35 Graham.Williams\@cmis.csiro.au";
-$M{"magaz"}="17 Feb 1999 17:33:54 Graham.Williams\@cmis.csiro.au";
-$M{"mailing"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"makeindex"}="23 May 1997 13:18:35 Graham.Williams\@cmis.csiro.au";
-$M{"malayalam"}="23 Jun 1998 15:49:27 Graham.Williams\@cmis.csiro.au";
-$M{"malvern"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"manyfoot"}="28 Dec 1998 09:24:33 Graham.Williams\@cmis.csiro.au";
-$M{"mapcodes"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"maple"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"margbib"}="24 Feb 1998 13:20:27 Graham.Williams\@cmis.csiro.au";
-$M{"marvosym-mac"}="5 Nov 1998 15:47:46 Graham.Williams\@cmis.csiro.au";
-$M{"marvosym"}="21 Jul 1998 05:27:14 Graham.Williams\@cmis.csiro.auy";
-$M{"mathcmd"}="abstract Provides a slightly version of the commands for";
-$M{"mathcmd"}="1 May 1998 16:54:49 Graham.Williams\@cmis.csiro.au";
-$M{"mathcomp"}="10 Sep 1998 18:44:41 Graham.Williams\@cmis.csiro.au";
-$M{"mathematica"}="20 Jan 1998 22:00:24 Graham.Williams\@cmis.csiro.au";
-$M{"mathenv"}="1 May 1998 16:55:25 Graham.Williams\@cmis.csiro.au";
-$M{"mathinst"}="10 Sep 1998 18:54:03 Graham.Williams\@cmis.csiro.au";
-$M{"mathkit"}="4 Feb 1998 13:20:21 Graham.Williams\@cmis.csiro.au";
-$M{"mathpple"}="21 Jan 1999 19:34:23 Graham.Williams\@cmis.csiro.au";
-$M{"mathrsfs"}="27 Mar 1998 05:58:42 Graham.Williams\@cmis.csiro.au";
-$M{"mathtime"}="29 May 1996 10:39:52 Graham.Williams\@cmis.csiro.au";
-$M{"mcite"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"mdwtools"}="16 Jun 1998 10:36:35 Graham.Williams\@cmis.csiro.au";
-$M{"meta-mode"}="1 May 1997 10:10:22 Graham.Williams\@cmis.csiro.au";
-$M{"metapost"}="25 Jun 1996 10:58:40 Graham.Williams\@cmis.csiro.au";
-$M{"method"}="21 Jan 1999 07:58:21 Graham.Williams\@cmis.csiro.au";
-$M{"mex"}="08 Feb 1998 staw\@gust.org.pl";
-$M{"mf-ps"}="4 Feb 1998 13:18:00 Graham.Williams\@cmis.csiro.au";
-$M{"mf-ps"}="08 Feb 1998 staw\@gust.org.pl";
-$M{"mf2pt3"}="2 Jan 1999 21:45:21 Graham.Williams\@cmis.csiro.au";
-$M{"mf2tex"}="3 May 1997 21:09:52 Graham.Williams\@cmis.csiro.au";
-$M{"mff"}="24 Oct 1996 10:27:31 Graham.Williams\@cmis.csiro.au";
-$M{"mff"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"mflogo"}="25 Dec 1996 UV";
-$M{"mfnfss"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"mfpic"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"mftoeps"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"mhs"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"midnight"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"mif2xfig"}="20 Nov 1996 11:23:52 Graham.Williams\@cmis.csiro.au";
-$M{"miktex-axp"}="25 Sep 1997 14:01:19 Graham.Williams\@cmis.csiro.au";
-$M{"miktex"}="23 Feb 1999 16:12:25 Graham.Williams\@cmis.csiro.au";
-$M{"miniltx"}="20 May 1996 10:13:07 Graham.Williams\@cmis.csiro.au";
-$M{"minitoc"}="12 Jan 1997 11:20:36 Graham.Williams\@cmis.csiro.au";
-$M{"mirr"}="12 May 1997 10:27:47 Graham.Williams\@cmis.csiro.au";
-$M{"mirr"}="08 Feb 1998 staw\@gust.org.pl";
-$M{"miscpk"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"mitpress"}="19 Sep 1998 10:11:07 Graham.Williams\@cmis.csiro.au";
-$M{"mkpic"}="2 Jan 1999 21:52:06 Graham.Williams\@cmis.csiro.au";
-$M{"mla"}="28 Apr 1997 09:48:03 Graham.Williams\@cmis.csiro.au";
-$M{"mlbib"}="5 Nov 1996 09:15:29 Graham.Williams\@cmis.csiro.au";
-$M{"mltex"}="28 Dec 1998 09:15:09 Graham.Williams\@cmis.csiro.au";
-$M{"mmtools"}="23 Jul 1997 09:16:45 Graham.Williams\@cmis.csiro.au";
-$M{"mnras"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"modes"}="11 Aug 1998 05:29:08 Graham.Williams\@cmis.csiro.au";
-$M{"monotype"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"monster"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"montex"}="29 Jan 1999 09:53:15 Graham.Williams\@cmis.csiro.au";
-$M{"morehelp"}="19 Feb 1998 09:36:53 Graham.Williams\@cmis.csiro.au";
-$M{"moresize"}="17 Jul 1997 14:08:56 Graham.Williams\@cmis.csiro.au";
-$M{"moreverb"}="29 May 1996 11:58:07 Graham.Williams\@cmis.csiro.au";
-$M{"moreverb"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"morse"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"morse"}="26 Feb 1998 09:08:33 Graham.Williams\@cmis.csiro.au";
-$M{"mpattern"}="30 Sep 1998 11:00:52 Graham.Williams\@cmis.csiro.au";
-$M{"mpfnmark"}="13 Dec 1996 08:30:22 Graham.Williams\@cmis.csiro.au";
-$M{"mpfnmark"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"ms"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"mslapa"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"mslapa"}="12 Jul 1996 10:06:59 Graham.Williams\@cmis.csiro.au";
-$M{"mt11p"}="14 Feb 1997 09:21:04 Graham.Williams\@cmis.csiro.au";
-$M{"mtbe"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"multenum"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"multicol"}="21 Dec 1998 13:35:30 Graham.Williams\@cmis.csiro.au";
-$M{"multido"}="19 Mar 1998 10:41:51 Graham.Williams\@cmis.csiro.au";
-$M{"multirow"}="25 Nov 1998 06:06:17 Graham.Williams\@cmis.csiro.au";
-$M{"multitoc"}="8 Sep 1998 05:46:30 Graham.Williams\@cmis.csiro.au";
-$M{"musictex"}="27 Nov 1996 13:59:30 Graham.Williams\@cmis.csiro.au";
-$M{"musixtex"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"mxedruli"}="25 Jul 1998 06:28:00 Graham.Williams\@cmis.csiro.au";
-$M{"mylatex"}="1 May 1998 17:00:39 Graham.Williams\@cmis.csiro.au";
-$M{"myletter"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"nassflow"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"natbib"}="17 Jul 1998 16:12:29 Graham.Williams\@cmis.csiro.au";
-$M{"nb4latex"}="21 Nov 1996 16:56:44 Graham.Williams\@cmis.csiro.au";
-$M{"nccfoots"}="28 Dec 1998 09:25:59 Graham.Williams\@cmis.csiro.au";
-$M{"ncctools"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"netpbm-win"}="10 Sep 1998 18:37:04 Graham.Williams\@cmis.csiro.au";
-$M{"newsletr"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"newthm"}="abstract A version of the theorem-style which provides";
-$M{"newthm"}="14 Feb 1997 09:30:36 Graham.Williams\@cmis.csiro.au";
-$M{"newthm"}="13 May 1997 10:24:58 Robin Fairbairns ";
-$M{"niceframe"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"nomencl"}="27 May 1997 09:24:37 Graham.Williams\@cmis.csiro.au";
-$M{"norbib"}="2 Jul 1998 12:55:09 Graham.Williams\@cmis.csiro.au";
-$M{"nrc"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"ntemacs"}="19 Oct 1998 06:03:28 Graham.Williams\@cmis.csiro.au";
-$M{"ntgclass"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"ntheorem"}="11 Dec 1998 05:44:07 Graham.Williams\@cmis.csiro.au";
-$M{"numline"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"numline"}="28 May 1996 16:02:33 Graham.Williams\@cmis.csiro.au";
-$M{"objectz"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"oca"}="3 May 1997 s.rahtz\@elsevier.co.uk";
-$M{"ocr-a"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"ocr-a"}="18 May 1996 14:10:28 Graham.Williams\@cmis.csiro.au";
-$M{"ocr-b"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"ocr-b"}="18 May 1996 14:10:28 Graham.Williams\@cmis.csiro.au";
-$M{"ogham"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"ogonek"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"oldstyle"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"omega"}="11 Feb 1998 08:05:12 Graham.Williams\@cmis.csiro.au";
-$M{"omegabase"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"omegafonts"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"onepagem"}="18 Jul 1997 14:23:48 Graham.Williams\@cmis.csiro.au";
-$M{"oryia"}="1 Jul 1998 10:29:59 Graham.Williams\@cmis.csiro.au";
-$M{"os2tex"}="3 Jan 1999 10:42:23 Graham.Williams\@cmis.csiro.au";
-$M{"osmanian"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"ot2cyr"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"overcite"}="15 Dec 1996 19:11:52 Graham.Williams\@cmis.csiro.au";
-$M{"overpic"}="27 Nov 1997 17:00:55 Graham.Williams\@cmis.csiro.au";
-$M{"overword"}="13 Dec 1996 08:37:08 Graham.Williams\@cmis.csiro.au";
-$M{"overword"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"oxford"}="11 Jan 1998 20:39:42 Graham.Williams\@cmis.csiro.au";
-$M{"oztex-german"}="25 Mar 1998 09:10:39 Graham.Williams\@cmis.csiro.au";
-$M{"oztex"}="27 Dec 1998 20:16:46 Graham.Williams\@cmis.csiro.au";
-$M{"pageno"}="23 Sep 1998 09:40:33 Graham.Williams\@cmis.csiro.au";
-$M{"pandey"}="30 Sep 1998 07:56:09 Graham.Williams\@cmis.csiro.au";
-$M{"pandora"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"paper"}="20 May 1996 06:33:20 Graham.Williams\@cmis.csiro.au";
-$M{"paradissa"}="14 Jun 1996 16:18:31 Graham.Williams\@cmis.csiro.au";
-$M{"paralist"}="21 Jan 1999 19:49:45 Graham.Williams\@cmis.csiro.au";
-$M{"patch"}="3 May 1997 s.rahtz\@elsevier.co.uk";
-$M{"path"}="25 Jun 1996 09:13:30 Graham.Williams\@cmis.csiro.au";
-$M{"pawpict"}="10 Feb 1998 09:32:45 Graham.Williams\@cmis.csiro.au";
-$M{"pb-diagram"}="30 Nov 1998 13:48:18 Graham.Williams\@cmis.csiro.au";
-$M{"pcfonts"}="21 Oct 1996 13:32:14 Graham.Williams\@cmis.csiro.au";
-$M{"pdcmac"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"pdftex-djgpp"}="23 Feb 1998 15:51:42 Graham.Williams\@cmis.csiro.au";
-$M{"pdftex"}="13 Aug 1998 05:51:13 Graham.Williams\@cmis.csiro.au";
-$M{"permute"}="28 Dec 1998 09:09:59 Graham.Williams\@cmis.csiro.au";
-$M{"pf2afm"}="18 Jun 1998 10:13:25 Graham.Williams\@cmis.csiro.au";
-$M{"phonetic"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"phppcf"}="14 Jun 1996 12:35:55 Graham.Williams\@cmis.csiro.au";
-$M{"physe"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"phyzzx"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"pictex"}="24 Feb 1998 13:53:44 Graham.Williams\@cmis.csiro.au";
-$M{"piff"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"piq"}="ctan fonts/okuda//";
-$M{"piq"}="17 Nov 1996 11:28:28 Graham.Williams\@cmis.csiro.au";
-$M{"pkfind"}=" utility to understand those specials, and to act";
-$M{"pkfind"}="3 Mar 1998 15:39:16 Graham.Williams\@cmis.csiro.au";
-$M{"pl-mf"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"pl-mf"}="08 Feb 1998 staw\@gust.org.pl";
-$M{"pl-qx"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"pl"}="25 Feb 1998, s.rahtz\@elsevier.co.uk";
-$M{"plainmisc"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"plaintex"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"plari"}="6 Nov 1998 06:24:51 Graham.Williams\@cmis.csiro.au";
-$M{"platex"}="18 Jun 1998 10:22:09 Graham.Williams\@cmis.csiro.au";
-$M{"plcalendar"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"plfonts"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"plgraph"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"plpsfont"}="08 Feb 1998 staw\@gust.org.pl";
-$M{"pmcstex"}="27 Nov 1997 17:12:37 Graham.Williams\@cmis.csiro.au";
-$M{"pmgraph"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"poligraf"}="17 Nov 1996 11:34:19 Graham.Williams\@cmis.csiro.au";
-$M{"poligraf"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"poligraf"}="08 Feb 1998 staw\@gust.org.pl";
-$M{"polish"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"polyglot"}="12 Sep 1997 10:32:34 Graham.Williams\@cmis.csiro.au";
-$M{"ppchtex"}="15 Jan 1997 09:54:55 Graham.Williams\@cmis.csiro.au";
-$M{"prelim2e"}="10 Aug 1998 09:16:01 Graham.Williams\@cmis.csiro.au";
-$M{"prettyref"}="29 Jul 1998 05:41:53 Graham.Williams\@cmis.csiro.au";
-$M{"progkeys"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"program"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"proofs"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"prv"}="11 Dec 1998 05:33:29 Graham.Williams\@cmis.csiro.au";
-$M{"ps_conv"}="17 Nov 1996 11:34:19 Graham.Williams\@cmis.csiro.au";
-$M{"ps_view"}="25 Jun 1998 staw\@gust.org.pl";
-$M{"psfig"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"psfixbb"}="23 Jun 1998 15:54:54 Graham.Williams\@cmis.csiro.au";
-$M{"psfont"}="1 Jul 1996 21:00:54 Graham.Williams\@cmis.csiro.au";
-$M{"psfonts"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"psfrag"}="24 Jun 1998 12:56:59 Graham.Williams\@cmis.csiro.au";
-$M{"psizzl"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"pslatex"}="2 Aug 1996 12:28:03 Graham.Williams\@cmis.csiro.au";
-$M{"pslatex"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"psmerge"}="1 Nov 1996 08:12:01 Graham.Williams\@cmis.csiro.au";
-$M{"psnfss"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"psnfss"}="24 Apr 1997 16:16:14 Graham.Williams\@cmis.csiro.au";
-$M{"psnfssx"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"pspicture"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"pstotext"}="31 Oct 1996 13:39:09 Graham.Williams\@cmis.csiro.au";
-$M{"pstricks"}="30 May 1996 11:20:11 Graham.Williams\@cmis.csiro.au";
-$M{"punk"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"qfig"}="24 Jul 1998 06:25:39 Graham.Williams\@cmis.csiro.au";
-$M{"qfonts"}="18 Jun 1998 10:17:31 Graham.Williams\@cmis.csiro.au";
-$M{"qobitree"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"qsymbols"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"quotchap"}="24 Feb 1998 13:20:08 Graham.Williams\@cmis.csiro.au";
-$M{"quotes"}="1 May 1998 16:55:48 Graham.Williams\@cmis.csiro.au";
-$M{"r-und-s"}="3 Jul 1997 08:10:21 Graham.Williams\@cmis.csiro.au";
-$M{"ragged2e"}="10 Aug 1998 09:09:43 Graham.Williams\@cmis.csiro.au";
-$M{"rail"}="1 Oct 1998 07:36:00 Graham.Williams\@cmis.csiro.au";
-$M{"rangecite"}="28 May 1996 16:31:55 Graham.Williams\@cmis.csiro.au";
-$M{"rawfonts"}="6 Jun 1997 11:32:53 Graham.Williams\@cmis.csiro.au";
-$M{"rawprint"}="21 Oct 1996 13:50:40 Graham.Williams\@cmis.csiro.au";
-$M{"rcsinfo"}="25 Feb 1999 11:36:47 Graham.Williams\@cmis.csiro.au";
-$M{"realcalc"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"recipe"}="26 Nov 1996 16:28:13 Graham.Williams\@cmis.csiro.au";
-$M{"refcheck"}="12 May 1997 10:18:04 Graham.Williams\@cmis.csiro.au";
-$M{"refman"}="1 Jun 1998 12:05:47 Graham.Williams\@cmis.csiro.au";
-$M{"relenc"}="23 Feb 1999 16:14:26 Graham.Williams\@cmis.csiro.au";
-$M{"remreset"}="7 Oct 1997 08:58:13 Graham.Williams\@cmis.csiro.au";
-$M{"repeat"}="5 Jan 1999 08:27:22 Graham.Williams\@cmis.csiro.au";
-$M{"revnum"}="3 Mar 1998 15:31:13 Graham.Williams\@cmis.csiro.au";
-$M{"revtex"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"revtex"}="31 Oct 1996 13:44:58 Graham.Williams\@cmis.csiro.au";
-$M{"rlepsf"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"rmpage"}="5 Feb 1998 14:07:37 Graham.Williams\@cmis.csiro.au";
-$M{"romaniantex"}="15 Nov 1996 14:57:19 Graham.Williams\@cmis.csiro.au";
-$M{"romanneg"}="19 Apr 1998 15:22:21 Graham.Williams\@cmis.csiro.au";
-$M{"rotating"}="12 Jun 1996 06:45:47 Graham.Williams\@cmis.csiro.au";
-$M{"rplain"}="23 Sep 1998 09:45:08 Graham.Williams\@cmis.csiro.au";
-$M{"rsfs-ps"}="25 Apr 1998 06:14:30 Graham.Williams\@cmis.csiro.au";
-$M{"rsfs"}="12 Jun 1996 06:57:19 Graham.Williams\@cmis.csiro.au";
-$M{"ruhyphen"}="8 Oct 1998 11:53:41 Graham.Williams\@cmis.csiro.au";
-$M{"ruler"}="22 May 1996 16:04:57 Graham.Williams\@cmis.csiro.au";
-$M{"s2latex"}="7 Jun 1996 20:13:54 Graham.Williams\@cmis.csiro.au";
-$M{"saferef"}="4 Feb 1997 09:57:44 Graham.Williams\@cmis.csiro.au";
-$M{"sanskrit"}="19 Mar 1997 12:03:33 Graham.Williams\@cmis.csiro.au";
-$M{"sauter"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"sauterfonts"}="12 Nov 1998 20:16:14 Graham.Williams\@cmis.csiro.au";
-$M{"scale"}="6 Nov 1998 06:19:58 Graham.Williams\@cmis.csiro.au";
-$M{"scalefnt"}="7 Oct 1997 08:58:13 Graham.Williams\@cmis.csiro.au";
-$M{"schedule"}="18 Feb 1998 10:30:16 Graham.Williams\@cmis.csiro.au";
-$M{"script"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"section"}="1 May 1998 17:01:43 Graham.Williams\@cmis.csiro.au";
-$M{"sectsty"}="13 Dec 1998 05:29:30 Graham.Williams\@cmis.csiro.au";
-$M{"semantic"}="13 May 1996 06:13:26 Graham.Williams\@cmis.csiro.au";
-$M{"seminar"}="28 May 1996 16:32:44 Graham.Williams\@cmis.csiro.au";
-$M{"setspace"}="27 Nov 1998 09:26:04 Graham.Williams\@cmis.csiro.au";
-$M{"sfg"}="8 Jul 1998 09:15:14 Graham.Williams\@cmis.csiro.au";
-$M{"sfheaders"}="17 Feb 1998 09:11:27 Graham.Williams\@cmis.csiro.au";
-$M{"shadbox"}="5 Aug 1996 12:14:57 Graham.Williams\@cmis.csiro.au";
-$M{"shadbox"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"shadethm"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"shading"}="24 Sep 1996 08:55:09 Graham.Williams\@cmis.csiro.au";
-$M{"shadow"}="21 Oct 1996 10:39:52 Graham.Williams\@cmis.csiro.au";
-$M{"shalom"}="30 May 1996 11:22:14 Graham.Williams\@cmis.csiro.au";
-$M{"shapepar"}="3 Jul 1996 15:23:38 Graham.Williams\@cmis.csiro.au";
-$M{"shhyphl"}="7 Jan 1999 07:27:53 Graham.Williams\@cmis.csiro.au";
-$M{"shortlst"}="29 Nov 1998 18:20:51 Graham.Williams\@cmis.csiro.au";
-$M{"shorttoc"}="22 Jul 1998 06:07:50 Graham.Williams\@cmis.csiro.au";
-$M{"showdim"}="30 Jul 1998 05:30:48 Graham.Williams\@cmis.csiro.au";
-$M{"showlabels"}="23 Feb 1999 13:56:22 Graham.Williams\@cmis.csiro.au";
-$M{"siam"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"sidecap"}="6 Nov 1998 06:07:25 Graham.Williams\@cmis.csiro.au";
-$M{"siggraph"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"simpsons"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"sinhala"}="31 Oct 1996 09:54:37 Graham.Williams\@cmis.csiro.au";
-$M{"sirlin"}="16 Aug 1996 14:13:00 Graham.Williams\@cmis.csiro.au";
-$M{"siunits"}="23 Jan 1999 05:00:33 Graham.Williams\@cmis.csiro.au";
-$M{"slashbox"}="20 Feb 1998 14:26:38 Graham.Williams\@cmis.csiro.au";
-$M{"slashed"}="11 Feb 1998 07:48:41 Graham.Williams\@cmis.csiro.au";
-$M{"slidenotes"}="16 Dec 1998 08:33:45 Graham.Williams\@cmis.csiro.au";
-$M{"slides"}="17 Jun 1997 20:12:00 Graham.Williams\@cmis.csiro.au";
-$M{"smallcap"}="28 May 1996 15:57:18 Graham.Williams\@cmis.csiro.au";
-$M{"smallcap"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"smartmn"}="5 Nov 1996 09:14:21 Graham.Williams\@cmis.csiro.au";
-$M{"sobolev"}="1 May 1998 16:56:12 Graham.Williams\@cmis.csiro.au";
-$M{"somedefs"}="12 Aug 1998 06:35:40 Graham.Williams\@cmis.csiro.au";
-$M{"songbook"}="30 Jun 1998 10:54:02 Graham.Williams\@cmis.csiro.au";
-$M{"sorhyph"}="12 May 1997 10:30:15 Graham.Williams\@cmis.csiro.au";
-$M{"soul"}="21 Jan 1999 19:15:44 Graham.Williams\@cmis.csiro.au";
-$M{"spanish"}="21 May 1996 13:04:45 Graham.Williams\@cmis.csiro.au";
-$M{"spanishb"}="5 Oct 1998 11:43:25 Graham.Williams\@cmis.csiro.au";
-$M{"sphack"}="28 May 1998 16:16:55 Graham.Williams\@cmis.csiro.au";
-$M{"sprite"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"ssqquote"}="25 Dec 1996 UV";
-$M{"startex"}="21 Oct 1996 14:23:19 Graham.Williams\@cmis.csiro.au";
-$M{"startex"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"stdclsdv"}="21 Jan 1999 12:51:23 Graham.Williams\@cmis.csiro.au";
-$M{"stmaryrd-ps"}="25 Jul 1998 06:01:40 Graham.Williams\@cmis.csiro.au";
-$M{"stmaryrd"}="25 Apr 1998 06:19:27 Graham.Williams\@cmis.csiro.au";
-$M{"subeqn"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"supertabular"}="7 Oct 1997 09:01:35 Graham.Williams\@cmis.csiro.au";
-$M{"swift"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"syngen"}="19 Nov 1996 08:42:42 Graham.Williams\@cmis.csiro.au";
-$M{"synttree"}="12 Aug 1998 06:13:18 Graham.Williams\@cmis.csiro.au";
-$M{"t2"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"tabbing"}="10 Feb 1998 12:54:11 Graham.Williams\@cmis.csiro.au";
-$M{"tabls"}="15 Dec 1996 19:17:27 Graham.Williams\@cmis.csiro.au";
-$M{"tap"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"tap"}="08 Feb 1998 staw\@gust.org.pl";
-$M{"taylor"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"tbe"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"tcvn"}="21 Jan 1999 19:18:03 Graham.Williams\@cmis.csiro.au";
-$M{"tcx"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"tds"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"techexplorer"}="19 Aug 1998 07:13:20 Graham.Williams\@cmis.csiro.au";
-$M{"tengwar"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"tensind"}="18 Jun 1998 10:06:41 Graham.Williams\@cmis.csiro.au";
-$M{"tensor"}="7 Jun 1996 08:52:37 Graham.Williams\@cmis.csiro.au";
-$M{"termcal"}="14 Jan 1997 10:10:12 Graham.Williams\@cmis.csiro.au";
-$M{"tetex"}="11 Jun 1997 19:22:32 Graham.Williams\@cmis.csiro.au";
-$M{"tex-math"}="8 Jul 1996 14:14:25 Graham.Williams\@cmis.csiro.au";
-$M{"tex-ps"}="09 Jun 1998 staw\@gust.org.pl";
-$M{"tex2bib"}="27 Jan 1998 16:50:26 Graham.Williams\@cmis.csiro.au";
-$M{"tex2html"}="29 Jan 1998 09:10:30 Graham.Williams\@cmis.csiro.au";
-$M{"tex2ltx"}="28 Oct 1998 11:56:39 Graham.Williams\@cmis.csiro.au";
-$M{"tex2rtf"}="25 Jun 1996 08:56:43 Graham.Williams\@cmis.csiro.au";
-$M{"tex4ht"}="23 Oct 1998 05:35:34 Graham.Williams\@cmis.csiro.au";
-$M{"tex98"}="12 Aug 1998 06:09:09 Graham.Williams\@cmis.csiro.au";
-$M{"texdraw"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"texed"}="11 Nov 1998 05:47:04 Graham.Williams\@cmis.csiro.au";
-$M{"texi2html"}="3 Feb 1999 10:27:21 Graham.Williams\@cmis.csiro.au";
-$M{"texi2www"}="2 Jul 1996 10:33:31 Graham.Williams\@cmis.csiro.au";
-$M{"texinfo"}="3 Feb 1999 10:28:52 Graham.Williams\@cmis.csiro.au";
-$M{"texip"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"texlist"}="31 Jan 1999 07:36:23 Graham.Williams\@cmis.csiro.au";
-$M{"texperf"}="16 Aug 1996 14:08:55 Graham.Williams\@cmis.csiro.au";
-$M{"texshell32"}="28 Mar 1998 07:07:28 Graham.Williams\@cmis.csiro.au";
-$M{"texsis"}="27 Jan 1998 16:44:10 Graham.Williams\@cmis.csiro.au";
-$M{"texsk"}="7 Mar 1997 16:53:45 Graham.Williams\@cmis.csiro.au";
-$M{"text1"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"textcase"}="11 Feb 1998 07:49:12 Graham.Williams\@cmis.csiro.au";
-$M{"textfit"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"textmerg"}="31 May 1996 08:43:05 Graham.Williams\@cmis.csiro.au";
-$M{"textoolspro"}=" LaTeX- code, so you can write sections in a";
-$M{"textoolspro"}="21 Jan 1999 13:03:19 Graham.Williams\@cmis.csiro.au";
-$M{"textpos"}="23 Feb 1999 13:54:56 Graham.Williams\@cmis.csiro.au";
-$M{"tfmpk"}="16 Dec 1998 08:30:00 Graham.Williams\@cmis.csiro.au";
-$M{"thesis"}="20 May 1996 10:22:19 Graham.Williams\@cmis.csiro.au";
-$M{"threed"}="13 Apr 1998 06:37:38 Graham.Williams\@cmis.csiro.au";
-$M{"threeparttable"}="15 Dec 1996 19:16:24 Graham.Williams\@cmis.csiro.au";
-$M{"thumb"}="10 Feb 1998 09:34:21 Graham.Williams\@cmis.csiro.au";
-$M{"thumbpdf"}="17 Feb 1999 16:50:56 Graham.Williams\@cmis.csiro.au";
-$M{"tiff"}="11 Nov 1998 05:43:39 Graham.Williams\@cmis.csiro.au";
-$M{"tiff2ps"}="06 May 1998 staw\@gust.org.pl";
-$M{"time"}="7 Jun 1996 09:04:45 Graham.Williams\@cmis.csiro.au";
-$M{"times"}="28 May 1997 16:25:37 Graham.Williams\@cmis.csiro.au";
-$M{"timesht"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"timing"}="3 May 1997 s.rahtz\@elsevier.co.uk";
-$M{"tipa"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"titlefoot"}="18 Mar 1998 09:30:36 Graham.Williams\@cmis.csiro.au";
-$M{"titleref"}="15 Dec 1996 19:19:50 Graham.Williams\@cmis.csiro.au";
-$M{"titlesec"}="23 Feb 1999 14:58:36 Graham.Williams\@cmis.csiro.au";
-$M{"titletoc"}="23 Feb 1999 14:58:46 Graham.Williams\@cmis.csiro.au";
-$M{"tkbibtex"}="10 Aug 1998 06:27:23 Graham.Williams\@cmis.csiro.au";
-$M{"tmview"}="29 Jun 1998 10:00:32 Graham.Williams\@cmis.csiro.au";
-$M{"tocbibind"}="21 Jan 1999 12:54:08 Graham.Williams\@cmis.csiro.au";
-$M{"tocloft"}="21 Jan 1999 12:57:14 Graham.Williams\@cmis.csiro.au";
-$M{"tocvsec2"}="21 Jan 1999 12:52:58 Graham.Williams\@cmis.csiro.au";
-$M{"toil"}="27 Jan 1998 16:54:47 Graham.Williams\@cmis.csiro.au";
-$M{"toil"}="08 Feb 1998 staw\@gust.org.pl";
-$M{"tools"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"topcapt"}="15 Dec 1996 19:04:36 Graham.Williams\@cmis.csiro.au";
-$M{"tracking"}="5 Aug 1996 12:11:48 Graham.Williams\@cmis.csiro.au";
-$M{"tracking"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"trans"}="17 Nov 1996 11:34:19 Graham.Williams\@cmis.csiro.au";
-$M{"trans"}="08 Feb 1998 staw\@gust.org.pl";
-$M{"transfig"}="8 Jul 1998 09:08:50 Graham.Williams\@cmis.csiro.au";
-$M{"treesvr"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"truncate"}="15 Dec 1996 19:23:52 Graham.Williams\@cmis.csiro.au";
-$M{"tsconfig"}="27 Nov 1996 13:48:24 Graham.Williams\@cmis.csiro.au";
-$M{"ttf2mf"}="25 Nov 1998 05:37:46 Graham.Williams\@cmis.csiro.au";
-$M{"ttf2pk"}="2 Jan 1999 22:03:00 Graham.Williams\@cmis.csiro.au";
-$M{"ttf2tfm"}="2 Jan 1999 22:05:48 Graham.Williams\@cmis.csiro.au";
-$M{"ttftogf"}="19 Sep 1998 08:12:18 Graham.Williams\@cmis.csiro.au";
-$M{"tth-rpm"}="13 Feb 1999 08:51:59 Graham.Williams\@cmis.csiro.au";
-$M{"tth-win"}="10 Sep 1998 18:39:22 Graham.Williams\@cmis.csiro.au";
-$M{"tth"}="27 Mar 1998 12:45:38 Graham.Williams\@cmis.csiro.au";
-$M{"ttt"}="19 Mar 1997 08:34:45 Graham.Williams\@cmis.csiro.au";
-$M{"tubtoc"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"tugboat-toc"}="28 Dec 1998 09:28:11 Graham.Williams\@cmis.csiro.au";
-$M{"tugboat"}="3 May 1997 s.rahtz\@elsevier.co.uk";
-$M{"tugboat"}="3 Jul 1997 08:01:03 Graham.Williams\@cmis.csiro.au";
-$M{"twg-list"}="25 Feb 1998 09:33:34 Graham.Williams\@cmis.csiro.au";
-$M{"twoup"}="19 Mar 1998 10:39:40 Graham.Williams\@cmis.csiro.au";
-$M{"type1"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"type1"}="February 1998, s.rahtz\@elsevier.co.uk";
-$M{"type1cm"}="7 Mar 1997 16:50:06 Graham.Williams\@cmis.csiro.au";
-$M{"type1cm"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"typearea"}="12 Jun 1996 13:18:22 Graham.Williams\@cmis.csiro.au";
-$M{"typehtml"}="27 Nov 1997 17:08:38 Graham.Williams\@cmis.csiro.au";
-$M{"typespec"}="2 Jul 1998 13:03:32 Graham.Williams\@cmis.csiro.au";
-$M{"uaclasses"}="19 Mar 1997 12:05:52 Graham.Williams\@cmis.csiro.au";
-$M{"uaclasses"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"ucthesis"}="abstract A version of the standard \LaTeX{} report style";
-$M{"ukhyph"}="21 Oct 1996 10:37:20 Graham.Williams\@cmis.csiro.au";
-$M{"ulem"}="28 May 1996 16:34:03 Graham.Williams\@cmis.csiro.au";
-$M{"ulsy"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"umlaute"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"umrand"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"underlin"}="13 May 1997 10:24:58 Robin Fairbairns rf\@cl.cam.ac.uk";
-$M{"underscore"}="17 Jul 1998 07:34:04 Graham.Williams\@cmis.csiro.au";
-$M{"uniqleaf"}="2 Aug 1996 12:44:23 Graham.Williams\@cmis.csiro.au";
-$M{"units"}="6 Aug 1998 06:17:29 Graham.Williams\@cmis.csiro.au";
-$M{"universa"}="6 Sep 1998 05:46:31 Graham.Williams\@cmis.csiro.au";
-$M{"url"}="3 Jul 1996 15:23:38 Graham.Williams\@cmis.csiro.au";
-$M{"urw"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"urwstd"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"urwvf"}="5 Feb 1998 09:33:04 Graham.Williams\@cmis.csiro.au";
-$M{"ut-backref"}="10 Nov 1998 10:38:10 Graham.Williams\@cmis.csiro.au";
-$M{"ut-thesis"}="23 Feb 1999 15:02:00 Graham.Williams\@cmis.csiro.au";
-$M{"utorontothesis"}="20 Feb 1998 14:27:24 Graham.Williams\@cmis.csiro.au";
-$M{"utthesis"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"uwthesis"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"vdm"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"vector"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"verbatim"}="29 May 1996 11:58:52 Graham.Williams\@cmis.csiro.au";
-$M{"vertex"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"vfcomb"}="24 Oct 1996 10:25:22 Graham.Williams\@cmis.csiro.au";
-$M{"vfinst"}="10 Sep 1998 18:41:42 Graham.Williams\@cmis.csiro.au";
-$M{"viiptart"}="8 Jul 1998 09:20:53 Graham.Williams\@cmis.csiro.au";
-$M{"vmargin"}="12 Jun 1996 13:14:31 Graham.Williams\@cmis.csiro.au";
-$M{"vncmr"}="19 Jul 1996 08:45:39 Graham.Williams\@cmis.csiro.au";
-$M{"vrb"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"vrsion"}="8 Jul 1998 08:17:05 Graham.Williams\@cmis.csiro.au";
-$M{"vruler"}="24 Oct 1996 11:15:39 Graham.Williams\@cmis.csiro.au";
-$M{"warpcol"}="13 Sep 1998 06:27:36 Graham.Williams\@cmis.csiro.au";
-$M{"wasy-ps"}="25 Jul 1998 06:05:00 Graham.Williams\@cmis.csiro.au";
-$M{"wasy"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"wasy2-ps"}="5 Aug 1998 06:26:09 Graham.Williams\@cmis.csiro.au";
-$M{"wasy2"}="25 Jul 1998 06:18:23 Graham.Williams\@cmis.csiro.au";
-$M{"wasysym"}="5 Jan 1999 07:44:43 Graham.Williams\@cmis.csiro.au";
-$M{"web2c-win32"}="3 Apr 1998 06:38:58 Graham.Williams\@cmis.csiro.au";
-$M{"web2c"}="20 Mar 1998 09:27:08 Graham.Williams\@cmis.csiro.au";
-$M{"williams"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"win95-guide"}="12 Apr 1998 20:46:26 Graham.Williams\@cmis.csiro.au";
-$M{"windvi"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"winedt"}="2 Jul 1998 13:00:44 Graham.Williams\@cmis.csiro.au";
-$M{"winemtex"}="3 Aug 1998 18:15:29 Graham.Williams\@cmis.csiro.au";
-$M{"winshell"}="21 Nov 1998 05:34:40 Graham.Williams\@cmis.csiro.au";
-$M{"wmf2eps"}="12 Nov 1998 20:15:28 Graham.Williams\@cmis.csiro.au";
-$M{"wnri"}="30 Jun 1998 10:56:34 Graham.Williams\@cmis.csiro.au";
-$M{"wntamil"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"word2x"}="29 Apr 1997 14:47:38 Graham.Williams\@cmis.csiro.au";
-$M{"wp-conv"}="1 Aug 1998 05:39:06 Graham.Williams\@cmis.csiro.au";
-$M{"wp2latex"}="23 Sep 1998 05:24:28 Graham.Williams\@cmis.csiro.au";
-$M{"wsuipa"}="13 Aug 1998 05:27:18 Graham.Williams\@cmis.csiro.au";
-$M{"wtex95"}="24 Feb 1998 14:01:24 Graham.Williams\@cmis.csiro.au";
-$M{"xdvi"}="28 Jun 1996 10:08:55 Graham.Williams\@cmis.csiro.au";
-$M{"xdvik"}="6 Apr 1998 05:53:45 Graham.Williams\@cmis.csiro.au";
-$M{"xfig"}="8 Jul 1998 09:08:50 Graham.Williams\@cmis.csiro.au";
-$M{"xtab"}="21 Oct 1998 09:32:30 Graham.Williams\@cmis.csiro.au";
-$M{"xtcapts"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"xtem"}="27 Nov 1997 17:13:37 Graham.Williams\@cmis.csiro.au";
-$M{"xymtex"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"xypic"}="21 Nov 1998 05:35:39 Graham.Williams\@cmis.csiro.au";
-$M{"yannisgr"}="25 Feb 1998 s.rahtz\@elsevier.co.uk";
-$M{"yfonts"}="27 Jan 1999 08:26:02 Graham.Williams\@cmis.csiro.au";
-$M{"yhmath"}="16 May 1996 s.rahtz\@elsevier.co.uk";
-$M{"yi4latex"}="22 Feb 1999 s.rahtz\@elsevier.co.uk";
-$M{"youngtab"}="29 Jun 1998 10:06:42 Graham.Williams\@cmis.csiro.au";
-$M{"yplan99"}="11 Dec 1998 05:45:33 Graham.Williams\@cmis.csiro.au";
-$M{"ytex"}="12 Apr 1997 s.rahtz\@elsevier.co.uk";
-$M{"zefonts"}="30 Sep 1998 07:50:57 Graham.Williams\@cmis.csiro.au";
-1;
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/nocites.tex b/Master/texmf-doc/source/texlive/texlive-en/archive/nocites.tex
deleted file mode 100644
index 759b379f30e..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/nocites.tex
+++ /dev/null
@@ -1,557 +0,0 @@
-\nocite{a0poster}
-\nocite{aaai}
-\nocite{abstyles}
-\nocite{accfonts}
-\nocite{achemso}
-\nocite{acronym}
-\nocite{adfathesis}
-\nocite{adobeother}
-\nocite{adobestd}
-\nocite{adrlist}
-\nocite{ae}
-\nocite{aguplus}
-\nocite{aiaa}
-\nocite{akletter}
-\nocite{alatex}
-\nocite{algorithms}
-\nocite{alg}
-\nocite{alphaev5-osf4.0d}
-\nocite{altfont}
-\nocite{amsfonts}
-\nocite{amslatex}
-\nocite{amstex}
-\nocite{answers}
-\nocite{antyktor}
-\nocite{apa}
-\nocite{apl}
-\nocite{appendix}
-\nocite{arabtex}
-\nocite{arydshln}
-\nocite{ar}
-\nocite{asaetr}
-\nocite{ascii}
-\nocite{astro}
-\nocite{aurora}
-\nocite{authorindex}
-\nocite{autotab}
-\nocite{babel}
-\nocite{backgammon}
-\nocite{bakoma}
-\nocite{barcode2}
-\nocite{barcodes}
-\nocite{barr}
-\nocite{bbding}
-\nocite{bbm}
-\nocite{bbold}
-\nocite{bbtbase}
-\nocite{bbtdoc}
-\nocite{beebe}
-\nocite{belleek}
-\nocite{beton}
-\nocite{bez123}
-\nocite{bezos}
-\nocite{bibarts}
-\nocite{biblist}
-\nocite{bluesky}
-\nocite{blue}
-\nocite{booktabs}
-\nocite{borceux}
-\nocite{bosisio}
-\nocite{bridge}
-\nocite{brushscr}
-\nocite{c-pascal}
-\nocite{calendar}
-\nocite{calligra}
-\nocite{calrsfs}
-\nocite{camel}
-\nocite{caption}
-\nocite{carlisle}
-\nocite{casyl}
-\nocite{catalog}
-\nocite{cbgreek}
-\nocite{cc-pl}
-\nocite{ccaption}
-\nocite{ccfonts}
-\nocite{cchess}
-\nocite{cdcover}
-\nocite{cellular}
-\nocite{changebar}
-\nocite{chemcono}
-\nocite{chemsym}
-\nocite{cheq}
-\nocite{cherokee}
-\nocite{chess}
-\nocite{china2e}
-\nocite{circ}
-\nocite{cirth}
-\nocite{cite}
-\nocite{cjk}
-\nocite{cmbright}
-\nocite{cmcyralt}
-\nocite{cmcyr}
-\nocite{cmdtrack}
-\nocite{cmextra}
-\nocite{cmpica}
-\nocite{cmpk}
-\nocite{cmsd}
-\nocite{cm}
-\nocite{codepage}
-\nocite{colorsep}
-\nocite{colortab}
-\nocite{comment}
-\nocite{concmath}
-\nocite{concrete}
-\nocite{context}
-\nocite{covington}
-\nocite{croatian}
-\nocite{crop}
-\nocite{crossword}
-\nocite{crosswrd}
-\nocite{csfonts}
-\nocite{cslatex}
-\nocite{csplain}
-\nocite{cspsfonts}
-\nocite{cstug}
-\nocite{cursor}
-\nocite{curves}
-\nocite{custom-bib}
-\nocite{cyrillic}
-\nocite{dancers}
-\nocite{deleq}
-\nocite{devanagari}
-\nocite{dialogl}
-\nocite{dinbrief}
-\nocite{directory}
-\nocite{dotseqn}
-\nocite{draftcopy}
-\nocite{dratex}
-\nocite{dropping}
-\nocite{dstroke}
-\nocite{dtk}
-\nocite{duerer}
-\nocite{dvipdfm}
-\nocite{dvipsbase}
-\nocite{dvipsdoc}
-\nocite{ean}
-\nocite{easy}
-\nocite{ecc}
-\nocite{ecltree}
-\nocite{eco}
-\nocite{ecpk}
-\nocite{ec}
-\nocite{edmac}
-\nocite{eepic}
-\nocite{egplot}
-\nocite{eiad}
-\nocite{eijkhout}
-\nocite{elsevier}
-\nocite{elvish}
-\nocite{emp}
-\nocite{emulateapj}
-\nocite{encodings}
-\nocite{endfloat}
-\nocite{engwar}
-\nocite{envbig}
-\nocite{envlab}
-\nocite{epigraph}
-\nocite{eplain}
-\nocite{eqname}
-\nocite{eqnarray}
-\nocite{esieecv}
-\nocite{etexbase}
-\nocite{etruscan}
-\nocite{euler}
-\nocite{euro2}
-\nocite{eurofont}
-\nocite{europs}
-\nocite{eurosans}
-\nocite{eurosym}
-\nocite{euro}
-\nocite{euxm}
-\nocite{examdesign}
-\nocite{exam}
-\nocite{expdlist}
-\nocite{expl3}
-\nocite{export}
-\nocite{fancybox}
-\nocite{fancyhdr}
-\nocite{fancyref}
-\nocite{fancyvrb}
-\nocite{fax}
-\nocite{fc}
-\nocite{feynmf}
-\nocite{finbib}
-\nocite{floatfig}
-\nocite{floatflt}
-\nocite{float}
-\nocite{fltpage}
-\nocite{fncychap}
-\nocite{foilhtml}
-\nocite{foiltex}
-\nocite{fontinst}
-\nocite{fontname}
-\nocite{footbib}
-\nocite{footmisc}
-\nocite{footnpag}
-\nocite{formats}
-\nocite{formula}
-\nocite{fp}
-\nocite{frankenstein}
-\nocite{french}
-\nocite{fribrief}
-\nocite{fullblck}
-\nocite{fullpict}
-\nocite{fundus}
-\nocite{futhark}
-\nocite{g-brief}
-\nocite{gb4e}
-\nocite{genealogy}
-\nocite{general}
-\nocite{genmisc}
-\nocite{geometry}
-\nocite{geomsty}
-\nocite{german}
-\nocite{germbib}
-\nocite{germdoc}
-\nocite{gloss}
-\nocite{gn-logic}
-\nocite{gothic}
-\nocite{go}
-\nocite{graphics}
-\nocite{greek6cbc}
-\nocite{grnumalt}
-\nocite{grtimes}
-\nocite{guides}
-\nocite{gustlib}
-\nocite{hands}
-\nocite{hanging}
-\nocite{harpoon}
-\nocite{harvard}
-\nocite{harvmac}
-\nocite{hh}
-\nocite{hilowres}
-\nocite{histogr}
-\nocite{hoekwater}
-\nocite{hppa1.1-hpux10.10}
-\nocite{html}
-\nocite{hvmaths}
-\nocite{hyperref}
-\nocite{hyper}
-\nocite{hyphenat}
-\nocite{hyphen}
-\nocite{i386-linux-libc5}
-\nocite{i386-linux}
-\nocite{ibm}
-\nocite{ieeepes}
-\nocite{ifacmtg}
-\nocite{imac}
-\nocite{indxcite}
-\nocite{info}
-\nocite{ini}
-\nocite{insbox}
-\nocite{ipa}
-\nocite{isostds}
-\nocite{jadetex}
-\nocite{jhep}
-\nocite{jknappen}
-\nocite{jsmisc}
-\nocite{jura}
-\nocite{kalender}
-\nocite{karnaugh}
-\nocite{kdgreek}
-\nocite{kluwer}
-\nocite{knuth}
-\nocite{koma-script}
-\nocite{kuvio}
-\nocite{labels}
-\nocite{lamstex}
-\nocite{lastpage}
-\nocite{latexfonts}
-\nocite{layouts}
-\nocite{leaflet}
-\nocite{leftidx}
-\nocite{lettrine}
-\nocite{levy}
-\nocite{lgc}
-\nocite{lgreek}
-\nocite{lhcyr}
-\nocite{lh}
-\nocite{lineno}
-\nocite{linguex}
-\nocite{listings}
-\nocite{lkort}
-\nocite{localloc}
-\nocite{logic}
-\nocite{lollipop}
-\nocite{ltablex}
-\nocite{ltx2rtf}
-\nocite{ltxbase}
-\nocite{ltxdoc}
-\nocite{ltxmisc}
-\nocite{lucida}
-\nocite{ly1}
-\nocite{mailing}
-\nocite{makeindex}
-\nocite{malayalam}
-\nocite{malvern}
-\nocite{mapcodes}
-\nocite{maple}
-\nocite{margbib}
-\nocite{marvosym}
-\nocite{mathcomp}
-\nocite{mathematica}
-\nocite{mathpple}
-\nocite{mcite}
-\nocite{mdwtools}
-\nocite{metasupp}
-\nocite{method}
-\nocite{mex}
-\nocite{mff}
-\nocite{mflogo}
-\nocite{mfmisc}
-\nocite{mfnfss}
-\nocite{mfpic}
-\nocite{mftoeps}
-\nocite{mft}
-\nocite{mhs}
-\nocite{midnight}
-\nocite{minitoc}
-\nocite{mips-irix6.2}
-\nocite{misc209}
-\nocite{mltex}
-\nocite{mnras}
-\nocite{monotype}
-\nocite{montex}
-\nocite{morehelp}
-\nocite{moresize}
-\nocite{moreverb}
-\nocite{morse}
-\nocite{mpattern}
-\nocite{mpbase}
-\nocite{mpfnmark}
-\nocite{mslapa}
-\nocite{ms}
-\nocite{mtbe}
-\nocite{multenum}
-\nocite{multirow}
-\nocite{multi}
-\nocite{musictex}
-\nocite{musixtex}
-\nocite{nassflow}
-\nocite{natbib}
-\nocite{ncctools}
-\nocite{newalg}
-\nocite{newlfm}
-\nocite{newsletr}
-\nocite{newthm}
-\nocite{niceframe}
-\nocite{nomencl}
-\nocite{nrc}
-\nocite{ntgclass}
-\nocite{ntg}
-\nocite{ntheorem}
-\nocite{numline}
-\nocite{objectz}
-\nocite{oca}
-\nocite{ocr-a}
-\nocite{ogham}
-\nocite{ogonek}
-\nocite{oldstyle}
-\nocite{omegabase}
-\nocite{omegafonts}
-\nocite{osmanian}
-\nocite{ot2cyr}
-\nocite{overpic}
-\nocite{pacioli}
-\nocite{pageno}
-\nocite{pandora}
-\nocite{paper}
-\nocite{paralist}
-\nocite{parallel}
-\nocite{patch}
-\nocite{pawpict}
-\nocite{pb-diagram}
-\nocite{pdcmac}
-\nocite{pdfscreen}
-\nocite{pdftex}
-\nocite{permute}
-\nocite{phoenician}
-\nocite{phonetic}
-\nocite{physe}
-\nocite{phyzzx}
-\nocite{picinpar}
-\nocite{picins}
-\nocite{pictex}
-\nocite{piff}
-\nocite{pl-qx}
-\nocite{plainmisc}
-\nocite{plaintex}
-\nocite{plari}
-\nocite{platex}
-\nocite{play}
-\nocite{plcalendar}
-\nocite{plfonts}
-\nocite{plgraph}
-\nocite{plpatch}
-\nocite{pl}
-\nocite{pmgraph}
-\nocite{poligraf}
-\nocite{polish}
-\nocite{polyglot}
-\nocite{prettyref}
-\nocite{progkeys}
-\nocite{program}
-\nocite{proofs}
-\nocite{protex}
-\nocite{psafm}
-\nocite{psfig}
-\nocite{psfrag}
-\nocite{psizzl}
-\nocite{pslatex}
-\nocite{psnfssx}
-\nocite{psnfss}
-\nocite{pspicture}
-\nocite{pstricks}
-\nocite{punk}
-\nocite{qfonts}
-\nocite{qobitree}
-\nocite{qsymbols}
-\nocite{quotchap}
-\nocite{r-und-s}
-\nocite{rcsinfo}
-\nocite{rcs}
-\nocite{realcalc}
-\nocite{refcheck}
-\nocite{refman}
-\nocite{relenc}
-\nocite{revtex}
-\nocite{rlepsf}
-\nocite{rmpage}
-\nocite{rotating}
-\nocite{rotfloat}
-\nocite{rplain}
-\nocite{rs6000-aix4.1.4.0}
-\nocite{rsfs}
-\nocite{ruhyphen}
-\nocite{runic}
-\nocite{sanskrit}
-\nocite{sauterfonts}
-\nocite{scale}
-\nocite{schedule}
-\nocite{script}
-\nocite{sectsty}
-\nocite{semantic}
-\nocite{seminar}
-\nocite{setspace}
-\nocite{shadbox}
-\nocite{shadethm}
-\nocite{shortlst}
-\nocite{shorttoc}
-\nocite{showdim}
-\nocite{showlabels}
-\nocite{siam}
-\nocite{sidecap}
-\nocite{siggraph}
-\nocite{simpsons}
-\nocite{siunits}
-\nocite{slashbox}
-\nocite{slidenotes}
-\nocite{smallcap}
-\nocite{songbook}
-\nocite{soul}
-\nocite{sparc-solaris2.5.1}
-\nocite{sprite}
-\nocite{ssqquote}
-\nocite{startex}
-\nocite{stdclsdv}
-\nocite{stmaryrd}
-\nocite{subeqnarray}
-\nocite{subeqn}
-\nocite{subfigure}
-\nocite{supertabular}
-\nocite{synttree}
-\nocite{t2}
-\nocite{tabbing}
-\nocite{tap}
-\nocite{taylor}
-\nocite{tbe}
-\nocite{tcx}
-\nocite{tds}
-\nocite{tengwar}
-\nocite{tetex}
-\nocite{tex-ps}
-\nocite{tex4ht}
-\nocite{texdraw}
-\nocite{texinfo}
-\nocite{texip}
-\nocite{texlive}
-\nocite{texsis}
-\nocite{text1}
-\nocite{textfit}
-\nocite{textmerg}
-\nocite{textpos}
-\nocite{thesis}
-\nocite{threed}
-\nocite{thumbpdf}
-\nocite{thumb}
-\nocite{timesht}
-\nocite{timing}
-\nocite{tipa}
-\nocite{titlefoot}
-\nocite{titlesec}
-\nocite{tmmaths}
-\nocite{tocbibind}
-\nocite{tocloft}
-\nocite{tocvsec2}
-\nocite{tools}
-\nocite{tracking}
-\nocite{treesvr}
-\nocite{treetex}
-\nocite{ttf2pk}
-\nocite{tugboat}
-\nocite{tug}
-\nocite{type1cm}
-\nocite{type1}
-\nocite{typespec}
-\nocite{uaclasses}
-\nocite{ucthesis}
-\nocite{ulsy}
-\nocite{umlaute}
-\nocite{umrand}
-\nocite{underlin}
-\nocite{units}
-\nocite{universa}
-\nocite{uni}
-\nocite{unsupported}
-\nocite{urwstd}
-\nocite{useful}
-\nocite{ut-thesis}
-\nocite{utthesis}
-\nocite{uwthesis}
-\nocite{vdm}
-\nocite{vector}
-\nocite{vertex}
-\nocite{vita}
-\nocite{vrb}
-\nocite{vrsion}
-\nocite{warpcol}
-\nocite{wasysym}
-\nocite{wasy}
-\nocite{williams}
-\nocite{win32}
-\nocite{windvi}
-\nocite{wnri}
-\nocite{wntamil}
-\nocite{wsuipa}
-\nocite{xtab}
-\nocite{xtcapts}
-\nocite{xymtex}
-\nocite{xypic}
-\nocite{yannisgr}
-\nocite{yfonts}
-\nocite{yhmath}
-\nocite{yi4latex}
-\nocite{youngtab}
-\nocite{ytex}
-\nocite{zed-csp}
-\nocite{zefonts}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/picture.tex b/Master/texmf-doc/source/texlive/texlive-en/archive/picture.tex
deleted file mode 100644
index 098cfe18f10..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/picture.tex
+++ /dev/null
@@ -1,46 +0,0 @@
-\documentclass{artikel3}
-\pagestyle{empty}
-\usepackage{pstcol,pst-text,lucidbrb}
-\font\manual=manfnt %logo10 doesn't have what we need
-\hyphenchar\manual=-1
-\def\MF{{\manual META}\-{\manual FONT}}
-\begin{document}
-\sffamily
-\psset{unit=1mm}
-\def\Size#1#2{\fontsize{#1}{#2}\selectfont}
-\begin{pspicture}(-58,-58)(58,58)
-\pscircle[linewidth=.3pt,linecolor=lightgray]{58}
-%\pscircle{23}
-\psset{linestyle=none}
-% top of circle
-\pstextpath[c]{\psarcn(0,0){48}{180}{0}}
-{\Size{1.2cm}{1cm}\bfseries \TeX\ Live 4}
-\rput(0,34){\begin{minipage}{8cm}\centering \textbf{March 1999}\\[3mm]
-\Size{9}{10.5}Ready-to-run \TeX\ system for Linux, Unix (DEC,\\ HP, IBM,
-SGI, Sun), and Win32 systems, \\
-based on Web2c 7.3\\
-\end{minipage}}
-% bottom of circle
-\rput(30,10){\begin{minipage}{2.7cm}\raggedleft\footnotesize
-ISO 9660 with Joliet \\and Rock Ridge \\
-extensions\end{minipage}}
-\rput(0,-30){\begin{minipage}{7cm}\centering
-Macros, fonts, documentation to the\\
-\emph{{\TeX} Directory Structure} standard.\\[2mm]
-Editor: Sebastian Rahtz
-\end{minipage}}
-\pstextpath[c]{\psarc(0,0){45}{180}{0}}
-{
-{\Size{14}{14}\ttfamily http://www.tug.org/texlive/} }
-\pstextpath[c]{\psarc(0,0){53}{180}{0}}
-{\Size{13.2}{14}\bfseries
-CSTUG $\bullet$
-Dante e.V. $\bullet$
-GUST $\bullet$
-GUTenberg $\bullet$
-NTG $\bullet$
-TUG $\bullet$
-TUG India $\bullet$
-UK TUG}
-\end{pspicture}
-\end{document}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/split.pl b/Master/texmf-doc/source/texlive/texlive-en/archive/split.pl
deleted file mode 100644
index bca00584335..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/split.pl
+++ /dev/null
@@ -1,16 +0,0 @@
-#@TeXIndex{a0poster,
-open TMP, ">/dev/null";
-while (<>) {
- chop;
- if (/\@TeXIndex/) {
- print TMP "\n";
- close TMP;
- $keep=$_;
- s/\@TeXIndex{(.*),.*/$1/;
- print "[$_]\n";
- open TMP, ">$_.bib";
- print TMP "$keep\n";
- }
- else { print TMP "$_\n" ; }
-
-}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/status.pl b/Master/texmf-doc/source/texlive/texlive-en/archive/status.pl
deleted file mode 100644
index 28c3d0d6d4c..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/status.pl
+++ /dev/null
@@ -1,31 +0,0 @@
-#package: pIq
-#license: pd
-#(but erasing the headers is not allowed)
-#Note that I made the most recent change, but
-#Mark Shoulson (shoulson@ctr.columbia.edu)
-#wrote the initial version. He should be named
-#in the catalogue, too.
-
-#csuov@csv.warwick.ac.uk
-#Subject: cmtt
-#To: krab@iesd.auc.dk
-#Subject: ftn
-#To: inas@MIB.HARZ.DE
-#Subject: newthm
-#To: reckdahl@leland.stanford.edu
-#Subject: epslatex
-#To: miktex-bug@ronin.in-berlin.de
-#Subject: miktex
-#To: de8827@blackjack.usma.edu
-#Subject: lated
-#To: jdyoung@AFIT.AF.MIL
-#Subject: afthesis
-#xlwy01@uxp1.hrz.uni-dortmund.de (c2cweb)
-
-$L{"newlfm"}="free-latex";
-$L{"pacioli"}="gpl";
-$L{"etruscan"}="gpl";
-$L{"phoenician"}="gpl";
-$L{"greek6bc"}="gpl";
-$L{"runic"}="gpl";
-1;
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.bib b/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.bib
deleted file mode 100644
index 17c75e197b7..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.bib
+++ /dev/null
@@ -1,235 +0,0 @@
-@TeXIndex{mips-irix6.2,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {System binaries for SGI running Irix 6.2},
- status = {free},
- texlive = {systems1}
-}
-
-@TeXIndex{alpha-osf3.2,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {System binaries for Alpha running OSF 3.2.},
- status = {free},
- texlive = {systems1}
-}
-
-@TeXIndex{alphaev5-osf4.0d,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {System binaries for Alphaev5 running OSF 4.0d.},
- status = {free},
- texlive = {systems1}
-}
-
-@TeXIndex{alphaev5-osf4.0b,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {System binaries for Alphaev5 running OSF 4.0b.},
- status = {free},
- texlive = {systems1}
-}
-
-@TeXIndex{bbtbase,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Basic \BibTeX{} support files.},
- status = {free},
- texlive = {bibtex1}
-}
-
-@TeXIndex{bbtdoc,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Basic \BibTeX{} documentation.},
- status = {free},
- texlive = {bibtex2}
-}
-
-@TeXIndex{catalog,
- modified = {February 1999, s.rahtz@elsevier.co.uk},
- abstract = {Graham Williams' Catalogue of \TeX{} packages.},
- status = {free},
- texlive = {doc2}
-}
-
-@TeXIndex{cmpk,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Computer Modern fonts in PK format.},
- status = {free},
- texlive = {fonts3}
-}
-
-@TeXIndex{dtk,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Macros for the DANTE publication.},
- status = {free},
- texlive = {latex3}
-}
-
-@TeXIndex{dvipsbase,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Basic support files for dvips.},
- status = {free},
- texlive = {dvips1}
-}
-
-@TeXIndex{general,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Useful general documentation.},
- status = {free},
- texlive = {doc1}
-}
-
-@TeXIndex{guides,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Guides to using \LaTeX, in English, German, French,
- Greek and Polish.},
- status = {free},
- texlive = {doc2}
-}
-
-@TeXIndex{hppa1.1-hpux10.10,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {System binaries for HP running hpux10.10.},
- status = {free},
- texlive = {systems1}
-}
-
-@TeXIndex{hyphen,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Collection of hyphenation patterns.},
- email = {s.rahtz@elsevier.co.uk},
- author = {LaTeX3 Project},
- status = {free},
- texlive = {lang1}
-}
-
-@TeXIndex{i386-linux,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {System binaries for Intel machines running Linux.},
- status = {free},
- texlive = {systems1}
-}
-
-@TeXIndex{i386-linux-libc5,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {System binaries for Intel machines
- running Linux, with libc5},
- status = {free},
- texlive = {systems1}
-}
-
-@TeXIndex{ini,
- modified = {February 1999, s.rahtz@elsevier.co.uk},
- abstract = {Startup files for building formats.},
- status = {free},
- texlive = {texlive1}
-}
-
-@TeXIndex{lgc,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Examples from the \emph{\LaTeX{} Graphics Companion}.},
- status = {free},
- texlive = {doc3}
-}
-
-@TeXIndex{metasupp,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {MetaPost support files.},
- status = {free},
- texlive = {texlive1}
-}
-
-@TeXIndex{mfmisc,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Small support files for \MF.},
- status = {free},
- texlive = {fonts1}
-}
-
-@TeXIndex{mft,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Support files for MFT.},
- status = {free},
- texlive = {texlive1}
-}
-
-@TeXIndex{misc209,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Miscellaneous small macro files for \LaTeX 2.09.},
- status = {free},
- texlive = {latex2}
-}
-
-@TeXIndex{mpbase,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Basic MetaPost support files.},
- status = {free},
- texlive = {metapost1}
-}
-
-@TeXIndex{multi,
- modified = {February 1999, s.rahtz@elsevier.co.uk},
- abstract = {dvips header for making n-up pages.},
- status = {free},
- texlive = {dvips3}
-}
-
-@TeXIndex{psafm,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {AFM files for PostScript fonts.},
- status = {free},
- texlive = {fonts3}
-}
-
-@TeXIndex{pspk,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {PK files for common PostScript fonts.},
- status = {free},
- texlive = {fonts3}
-}
-
-@TeXIndex{rs6000-aix4.1,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {System binaries for RS6000 running AIX 4.1.},
- status = {free},
- texlive = {systems1}
-}
-
-@TeXIndex{rs6000-aix4.1.4.0,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {System binaries for RS6000 running AIX 4.1.4.0},
- status = {free},
- texlive = {systems1}
-}
-
-@TeXIndex{sparc-solaris2.5.1,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {System binaries for Sun Sparc running Solaris 2.5.1.},
- status = {free},
- texlive = {systems1}
-}
-
-@TeXIndex{texlive,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Basic material for \TeXLive{}.},
- status = {free},
- texlive = {texlive1}
-}
-
-@TeXIndex{tug,
- modified = {February 1999, s.rahtz@elsevier.co.uk},
- abstract = {\TeX\ Users Group information.},
- status = {free},
- texlive = {doc3}
-}
-
-@TeXIndex{useful,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {Useful documentation; various \LaTeX{} guides, FAQ,
- fontname docs, etc.},
- status = {free},
- texlive = {doc2}
-}
-
-@TeXIndex{win32,
- modified = {February 1999 s.rahtz@elsevier.co.uk},
- abstract = {System binaries for Windows 32.},
- status = {free},
- texlive = {systems1}
-}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.bst b/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.bst
deleted file mode 100644
index a4954030c95..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.bst
+++ /dev/null
@@ -1,60 +0,0 @@
-ENTRY
- {
- name
- status
- abstract
- texlive
- author
- ctan
- keywords
- version
- also
- modified
- }
- {} % no integer entry variables
- { label extra.label sort.label } % label entry variables
-
-
-STRINGS { s t a.name }
-
-
-FUNCTION {not}
-{ { #0 }
- { #1 }
- if$
-}
-
-FUNCTION {and}
-{ 'skip$
- { pop$ #0 }
- if$
-}
-
-FUNCTION {or}
-{ { pop$ #1 }
- 'skip$
- if$
-}
-
-INTEGERS { nameptr namesleft numnames }
-
-
-FUNCTION {TexIndex} {
- texlive empty$
- { }
- { "\bibitem{" cite$ * "}" * write$
- cite$ "&" * write$
- status "&" * write$
- texlive "&" * write$
- newline$
- abstract write$
- newline$
- }
- if$
- }
-
-
-READ
-
-ITERATE {call.type$}
-
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2003 b/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2003
deleted file mode 100644
index 3b75b7b5bfd..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2003
+++ /dev/null
@@ -1,378 +0,0 @@
-\NeedsTeXFormat{LaTeX2e}[1995/12/01]
-\ProvidesPackage{tex-live}[2003/09/01 v1.0 TeX Live documentation style]
-%
-\RequirePackage{alltt}
-\RequirePackage{array}
-\RequirePackage{colortbl}
-\RequirePackage{graphicx}
-\RequirePackage{here}
-\RequirePackage{longtable}
-\RequirePackage{pslatex}
-\RequirePackage{shortvrb}
-\RequirePackage[normalem]{ulem}
-\RequirePackage[obeyspaces]{url}
-\RequirePackage{xspace}
-\usepackage[T1]{fontenc}
-\usepackage[latin1]{inputenc}
-%\usepackage[textcomp]{lmodern}
-%
-\RequirePackage{europs}
-\let\euro\EUR
-%
-\RequirePackage{mflogo}
-\def\MP{MetaPost}
-\let\mf\MF
-%
-% 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}\@}
-%
-\RequirePackage{fancyvrb}
-\DefineVerbatimEnvironment{verbatim}{Verbatim}{fontsize=\normalsize}
-\DefineVerbatimEnvironment{fverbatim}{Verbatim}{fontsize=\footnotesize}
-\DefineVerbatimEnvironment{sverbatim}{Verbatim}{fontsize=\small}
-\DefineVerbatimEnvironment{boxedverbatim}
- {Verbatim}{fontsize=\scriptsize,frame=single}
-\DefineVerbatimEnvironment{Verbatim}{Verbatim}{fontsize=\normalsize}
-\def\verbatiminput#1{\VerbatimInput[fontsize=\scriptsize]{#1}}
-\def\boxedverbatiminput#1{\VerbatimInput[frame=single,fontsize=\scriptsize]{#1}}
-\def\listinginput#1#2{\VerbatimInput[fontsize=\scriptsize,firstnumber=#1,numbers=left]{#2}}
-\MakeShortVerb\|
-%
-%
-% Done with packages.
-%
-% Page layout.
-\advance\textwidth by 1.1in
-\advance\oddsidemargin by -.55in
-\advance\evensidemargin by -.55in
-%
-\advance\textheight by 1in
-\advance\topmargin by -.5in
-\advance\footskip by -.5in
-\pagestyle{headings}
-%
-% LaTeX parameters.
-\renewcommand{\topfraction}{0.85}
-\renewcommand{\floatpagefraction}{0.86}
-\renewcommand{\textfraction}{0.1}
-\renewcommand{\belowcaptionskip}{4pt}
-\setcounter{tocdepth}{2}
-\setcounter{topnumber}{5}
-\setcounter{totalnumber}{5}
-%
-% linebreaking, etc.
-\pretolerance=1000
-\tolerance=1500
-\hbadness=3000
-\vbadness=3000
-\hyphenpenalty=400
-\emergencystretch=.1\hsize
-\relpenalty=500
-%
-% fonts
-\let\sl\it
-\let\slfamily\itfamily
-\let\textsl\textit
-%\def\ttdefault{cmtt}
-\def\ttdefault{lmtt}
-%
-% various sorts of names
-\newcommand*{\pkgname}[1]{\textsf{#1}}% package name
-\newcommand*{\optname}[1]{\texttt{#1}}% (package,class) option name
-\newcommand*{\cmdname}[1]{\textsf{#1}}% command name
-\newcommand*{\colname}[1]{\emph{#1}}% collection name
-\newcommand*{\dirname}[1]{\path{#1}}% directory name
-\newcommand*{\filename}[1]{\path{#1}}% file name
-\newcommand*{\envname}[1]{\texttt{#1}}% environment variable name
-\newcommand{\code}[1]{\texttt{#1}}
-\newcommand{\file}[1]{\texttt{#1}}
-\newcommand{\prog}[1]{\texttt{#1}}
-\newcommand{\samp}[1]{`\texttt{#1}'}
-\newcommand{\var}[1]{\emph{#1}}
-\newcommand{\ttvar}[1]{\texttt{\var{#1}}}
-%
-% underlined command input.
-\def\Ucom#1{%
- \uline{\rule[-.2\baselineskip]{0pt}{.9\baselineskip}\ttfamily #1}}
-\def\OnCD#1{\href{../../../../#1}{\path{#1}}}
-%
-% GUI menu/button/tab sequence:
-\def\guiseq#1{\textsf{#1}}
-\def\arw{\unskip$\rightarrow$\ignorespaces}
-%
-% Special names.
-\def\dpi{$\,$dpi\xspace}
-\def\bs{{\protect\normalfont\ttfamily\char'134}}
-\DeclareRobustCommand{\cs}[1]{{\normalfont\ttfamily\char`\\#1}}
-\def\Q#1{\par\vskip6pt\leftline{#1}\par}
-\def\hyph{-}
-%
-% many abbreviations.
-\newcommand{\CS}{$\mathcal{C}\kern-.1667em\lower.5ex%
- \hbox{$\mathcal{S}$}\kern-.075em $}
-\def\AFMtoTFM{\cmdname{AFM2TFM}\null}
-\def\bv{\emph{Baskerville}}
-\let\BV=\bv
-\def\Dash{\unskip\nobreak\thinspace---\thinspace\ignorespaces}
-\def\dvicopy{\cmdname{dvicopy}}
-\def\dvidvi{\cmdname{dvidvi}}
-\def\dvips{\cmdname{dvips}}
-\def\eTeX{$\varepsilon$-\TeX}
-\def\fpTeX{\textrm{fp}\TeX\xspace}
-\def\GFtoDVI{\cmdname{GFtoDVI}\null}
-\def\GFtoPK{\cmdname{GFtoPK}\null}
-\def\GFtype{\cmdname{GFtype}}
-\def\KPS{Kpathsea}
-\def\La{La}
-\def\OMEGA{$\Omega$}
-\def\OzMF{OzMF}
-\def\OzMP{OzMP}
-\def\OzTeX{O\kern-.03em z\kern-.15em\TeX}
-\def\PKtype{\cmdname{PKtype}}
-\def\PLtoTF{\cmdname{PLtoTF}\null}
-\def\teTeX{\textrm{te}\TeX\xspace}
-\def\TeXLive{\TeX{} Live\xspace}
-\def\TFtoPL{\cmdname{TFtoPL}\null}
-\def\TK{\textsf{\TeX-Collection}}
-\def\TypeI{Type~1}
-\def\VFtoVP{\cmdname{VFtoVP}\null}
-\def\VPtoVF{\cmdname{VPtoVF}\null}
-\def\XEmTeX{\textrm{XEm}\TeX\xspace}
-\def\XEmacs{\textrm{XEmacs}\xspace}
-\def\Webc{Web2C}
-\providecommand*{\CD}{\acro{CD}\xspace}
-\providecommand*{\CTAN}{\acro{CTAN}\xspace}
-\providecommand*{\DVD}{\acro{DVD}\xspace}
-\providecommand*{\HTML}{\acro{HTML}\xspace}
-\providecommand*{\MacOSX}{Mac\,\acro{OS\,X}\xspace}
-\providecommand*{\PS}{Post\-Script\xspace}
-\providecommand*{\TDS}{\acro{TDS}\xspace}
-\providecommand*{\dvi}{\acro{DVI}\xspace}
-\providecommand*{\web}{\texttt{web}\xspace}
-%
-% description-like environment that uses tt instead of bf, and doesn't
-% go to the left margin. Without the \hfil, get an underfull box.
-% Don't why \descriptionlabel doesn't.
-\newenvironment{ttdescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt % these lists tend to have short descriptions
- \let\makelabel=\ttdescriptionlabel}}%
- {\end{list}}
-\newcommand*\ttdescriptionlabel[1]{\hspace\labelsep
- \normalfont\ttfamily #1\hfil}
-%
-% Likewise, for commands using sans serif.
-\newenvironment{cmddescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt
- \let\makelabel=\cmddescriptionlabel}}%
- {\end{list}}
-\newcommand*\cmddescriptionlabel[1]{\hspace\labelsep
- \normalfont\sffamily #1\hfil}
-%
-\newsavebox{\wbox}
-\newenvironment{warningbox}
- {\begin{lrbox}{\wbox}
- \begin{minipage}{.95\textwidth}}
- {\end{minipage}\end{lrbox}\fbox{\usebox{\wbox}}}
-%
-% lrbox is used as a representation marking. I changed it to
-% lrBox in tne source file, to get closer to logical marking
-\newsavebox{\mylrbox}
-\newenvironment{lrBox}
- {\begin{lrbox}{\mylrbox}}
- {\end{lrbox}}
-%
-%
-% output setup
-%
-\newif\ifSingleColumn
-\providecommand{\Status}{0}
-%\typeout{Status is \Status}
-%
-% By default, we won't be creating hyperlinks.
-\def\href#1#2{#2}
-\def\hypertarget#1#2{}
-\def\email#1{\href{mailto:#1}{\path{#1}}} % \path comes from url
-%
-%
-\ifcase\Status
- % \Status = 0
- \typeout{TeX Live documentation for printing}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 1
- \typeout{TeX Live documentation in PDF format}
- \RequirePackage[colorlinks,bookmarksopen,
- pdfstartview={FitBH -320000},hyperindex]{hyperref}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 2
- \typeout{TeX Live documentation in HTML format}
- \RequirePackage[latex4ht]{tex4ht}
- \or
- % \Status = 3
- \typeout{TeX Live documentation as a Baskerville issue}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \RequirePackage{bvoutln}% outline of baskerville
- \RequirePackage{multicol}
- \SingleColumnfalse
- \or
- % \Status = 4
- \typeout{TeX Live documentation as a TUB article}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \SingleColumnfalse
- \newenvironment{multicols}[1]{}{}
-\fi
-%
-\ifnum \Status=4
-\else
- \RequirePackage{texnames}
- \providecommand\TeXXeT{\TeX-{}-%
- \kern-.1emX\kern-.125em\lower.5ex\hbox{E}\kern-.1667emT\@}
-\fi
-%
-% hacking at sections etc., to pay attention to baskerville status
-\newcommand{\@condend@multicols}{%
- \ifSingleColumn
- \else
- \def\@tempa{multicols}%
- \ifx\@tempa\@currenvir
- \end{multicols}%
- \fi
- \fi
-}
-\let\Section\section
-\renewcommand{\section}{%
- \@ifstar
- {\Section*}%
- {%
- \@condend@multicols
- \@dblarg\@full@section
- }%
-}
-\def\@full@section[#1]#2{%
- \Section[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-\let\SubSection\subsection
-\renewcommand{\subsection}{%
- \@ifstar{\SubSection*}%
- {%
- \@condend@multicols
- \@dblarg\@full@subsection
- }
-}
-\def\@full@subsection[#1]#2{%
- \SubSection[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-
-% calm things down a bit if we're in a multiple-column version
-\ifSingleColumn
-\else
- \def\@listI{\leftmargin\leftmargini
- \parsep \z@
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \itemsep \z@ \@plus .1\p@
- }
- \let\@listi\@listI
- \@listi
- \def\@listii{\leftmargin\leftmarginii
- \labelwidth\leftmarginii\advance\labelwidth-\labelsep
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \itemsep \z@ \@plus .1\p@
- }
- \def\@listiii{\leftmargin\leftmarginiii
- \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
- \topsep 1\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \partopsep \z@
- \itemsep \topsep
- }
- \def\@listiv{\leftmargin\leftmarginiv
- \labelwidth\leftmarginiv\advance\labelwidth-\labelsep
- }
- \def\@listv{\leftmargin\leftmarginv
- \labelwidth\leftmarginv\advance\labelwidth-\labelsep
- }
- \def\@listvi{\leftmargin\leftmarginvi
- \labelwidth\leftmarginvi\advance\labelwidth-\labelsep
- }
-\fi
-%
-% array package stuff
-\def\arraybackslash{\let\\=\@arraycr}
-\newcolumntype{P}[1]{>{\raggedright\arraybackslash}p{#1}}
-%
-% shaded rows (using facilities of colortbl)
-%
-\definecolor{pale}{gray}{.9}
-\newcount\colrow
-\gdef\RowColor{pale}
-\def\SetRowColor{%
- \rowcolor{\RowColor}%
- \global\advance\colrow by1\relax
- \ifodd\colrow
- \gdef\RowColor{pale}%
- \else
- \gdef\RowColor{white}%
- \fi
-}
-% redefine to hack up a reference even though we don't need it...
-\renewcommand\@bibitem[1]{\if@filesw \immediate\write\@auxout
- {\string\bibcite{#1}{?}}\fi\ignorespaces}
-%
-% \unknownTeXlive is a dummy texlive entry for the biblio
-\newcommand\unknownTeXlive[2][\relax]{\textbf{\textsc{unknown}}%
- \global\@all@unknown\expandafter{\the\@all@unknown{#2}}%
-}
-\newtoks\@all@unknown
-\global\@all@unknown{}
-\AtEndDocument{\@message@unknowns}
-\def\@message@unknowns{\edef\@tempa{\the\@all@unknown}%
- \ifx\@tempa\@empty
- \else
- \def\@tempa{*** TeX live package location of }%
- \expandafter\@output@unknowns\the\@all@unknown\@empty
- \fi
-}
-\def\@output@unknowns#1{\edef\@tempb{#1}%
- \ifx\@tempb\@empty
- \typeout{ unknown}%
- \else
- \message{\@tempa#1,}%
- \def\@tempa{}%
- \expandafter\@output@unknowns
- \fi
-}
-%
-% a hack for the bibliography
-\bibliographystyle{tex-live}
-\newif\iffirstbibentry
-\global\firstbibentrytrue
-\let\@@bibitem\bibitem
-\renewcommand\bibitem{\iffirstbibentry
- \global\firstbibentryfalse
- \else
- \\\SetRowColor
- \fi
- \@@bibitem
-}
-
-
-% for \Dings
-\RequirePackage{pifont}
-% available for inter-article dinglines
-\def\Dings{\nopagebreak{\footnotesize\dingline{167}}}
-
-\endinput
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2004 b/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2004
deleted file mode 100644
index 54ff32dbe53..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2004
+++ /dev/null
@@ -1,422 +0,0 @@
-% $Id$
-% TeX Live documentation style. Written by many people over many years.
-% Public domain.
-%
-\NeedsTeXFormat{LaTeX2e}[1995/12/01]
-\ProvidesPackage{tex-live}[2004/11/07 v1.0 TeX Live documentation style]
-%
-\RequirePackage{alltt}
-\RequirePackage{array}
-\RequirePackage{colortbl}
-\RequirePackage{comment}
-\RequirePackage{graphicx}
-\RequirePackage{here}
-\RequirePackage{longtable}
-\RequirePackage{shortvrb}
-\RequirePackage[normalem]{ulem}
-\RequirePackage[obeyspaces]{url}
-\RequirePackage{xspace}
-%
-\RequirePackage{lmodern}
-\usepackage{textcomp}% including \textbullet
-\usepackage[T1]{fontenc}
-\usepackage[latin1]{inputenc}
-%
-% 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}\@}
-%
-\RequirePackage{fancyvrb}
-\DefineVerbatimEnvironment{verbatim}{Verbatim}{fontsize=\normalsize}
-\DefineVerbatimEnvironment{fverbatim}{Verbatim}{fontsize=\footnotesize}
-\DefineVerbatimEnvironment{sverbatim}{Verbatim}{fontsize=\small}
-\DefineVerbatimEnvironment{boxedverbatim}
- {Verbatim}{fontsize=\scriptsize,frame=single}
-\DefineVerbatimEnvironment{Verbatim}{Verbatim}{fontsize=\normalsize}
-\def\verbatiminput#1{\VerbatimInput[fontsize=\scriptsize]{#1}}
-\def\boxedverbatiminput#1{\VerbatimInput[frame=single,fontsize=\scriptsize]{#1}}
-\def\listinginput#1#2{\VerbatimInput[fontsize=\scriptsize,firstnumber=#1,numbers=left]{#2}}
-\MakeShortVerb\|
-%
-%
-% Done with packages.
-%
-% Page layout.
-\advance\textwidth by 1.1in
-\advance\oddsidemargin by -.55in
-\advance\evensidemargin by -.55in
-%
-\advance\textheight by 1in
-\advance\topmargin by -.5in
-\advance\footskip by -.5in
-\pagestyle{headings}
-%
-% LaTeX parameters.
-\renewcommand{\topfraction}{0.85}
-\renewcommand{\floatpagefraction}{0.86}
-\renewcommand{\textfraction}{0.1}
-\renewcommand{\belowcaptionskip}{4pt}
-\setcounter{tocdepth}{2}
-\setcounter{topnumber}{5}
-\setcounter{totalnumber}{5}
-%
-% linebreaking, etc.
-\hbadness=4000
-\vbadness=4000
-\emergencystretch=.1\hsize
-\relpenalty=500
-%
-\def\slash{/\penalty\z@\hskip\z@skip }
-%
-% various sorts of names
-\newcommand*{\pkgname}[1]{\textsf{#1}}% package name
-\newcommand*{\optname}[1]{\texttt{#1}}% (package,class) option name
-\newcommand*{\cmdname}[1]{\textsf{#1}}% command name
-\newcommand*{\colname}[1]{\emph{#1}}% collection name
-\newcommand*{\dirname}[1]{\path{#1}}% directory name
-\newcommand*{\filename}[1]{\path{#1}}% file name
-\newcommand*{\envname}[1]{\texttt{#1}}% environment variable name
-\newcommand{\code}[1]{\texttt{#1}}
-\newcommand{\file}[1]{\texttt{#1}}
-\newcommand{\prog}[1]{\texttt{#1}}
-\newcommand{\samp}[1]{`\texttt{#1}'}
-\newcommand{\var}[1]{{\sl #1}}% not \textsl, for roman not typewriter slanted.
-\newcommand{\ttvar}[1]{\texttt{\var{#1}}}
-%
-% underlined command input.
-\def\Ucom#1{%
- \uline{\rule[-.2\baselineskip]{0pt}{.9\baselineskip}\ttfamily #1}}
-%
-% \CDref is for url's with a #, where we need to write the target url and
-% displayed url separately in the input, due to catcode madness.
-% (We could simplify/remove this next time, I think.)
-\def\CDref#1#2{\texttt{#1}}
-%
-% \OnCD is currently for any other reference to a file or directory in
-% the distribution. PDF readers only open .pdf files, though, so we
-% should change this to only use \href for those. Or more likely use
-% different macros in the source.
-\def\OnCD#1{\href{../../../../#1}{\path{#1}}}
-%
-% \href incorrectly appends .pdf to anything without an extension; these
-% definitions using \hyper@linkurl do not, but they fail for .pdf
-% references -- which are the only ones that work anyway. So this is
-% useless, in practice.
-%\def\CDref#1#2{\hyper@linkurl{#2}{../../../../#1}}
-%\def\OnCD#1{\hyper@linkurl{\path{#1}}{../../../../#1}}
-
-% GUI menu/button/tab sequence:
-\def\guiseq#1{\textsf{#1}}
-\def\arw{\unskip$\rightarrow$\ignorespaces}
-%
-% Special names.
-\def\dpi{$\,$dpi\xspace}
-\def\bs{{\protect\normalfont\ttfamily\char'134}}
-\DeclareRobustCommand{\cs}[1]{{\normalfont\ttfamily\char`\\#1}}
-\def\Q#1{\par\vskip6pt\leftline{#1}\par}
-\def\hyph{-}
-%
-% many abbreviations.
-\newcommand{\CS}{$\mathcal{C}\kern-.1667em\lower.5ex%
- \hbox{$\mathcal{S}$}\kern-.075em $}
-\def\AFMtoTFM{\cmdname{AFM2TFM}\null}
-\def\bv{\emph{Baskerville}}
-\let\BV=\bv
-\def\Dash{\unskip\nobreak\thinspace---\thinspace\ignorespaces}
-\def\dvicopy{\cmdname{dvicopy}}
-\def\dvidvi{\cmdname{dvidvi}}
-\def\dvips{\cmdname{dvips}}
-\def\eTeX{$\varepsilon$-\TeX}
-\def\fpTeX{\textrm{fp}\TeX\xspace}
-\def\GFtoDVI{\cmdname{GFtoDVI}\null}
-\def\GFtoPK{\cmdname{GFtoPK}\null}
-\def\GFtype{\cmdname{GFtype}}
-\def\KPS{Kpathsea}
-\def\La{La}
-\def\OMEGA{$\Omega$}
-\def\OzMF{OzMF}
-\def\OzMP{OzMP}
-\def\OzTeX{O\kern-.03em z\kern-.15em\TeX}
-\def\p.{p.\,}
-\def\PKtype{\cmdname{PKtype}}
-\def\PLtoTF{\cmdname{PLtoTF}\null}
-\def\ProTeXt{Pro\TeX t}
-\def\teTeX{\textrm{te}\TeX\xspace}
-\def\TeXLive{\TeX{} Live\xspace}
-\def\TFtoPL{\cmdname{TFtoPL}\null}
-\def\TK{\textsf{\TeX-Collection}}
-\let\TL=\TeXLive
-\def\TypeI{Type~1}
-\def\VFtoVP{\cmdname{VFtoVP}\null}
-\def\VPtoVF{\cmdname{VPtoVF}\null}
-\def\Thanh{H\`an~Th\^e\llap{\raise 0.5ex\hbox{\'{}}}~Th\`anh}
-\def\XEmTeX{\textrm{XEm}\TeX\xspace}
-\def\XEmacs{\textrm{XEmacs}\xspace}
-\def\Webc{Web2C}
-\providecommand*{\CD}{\acro{CD}\xspace}
-\providecommand*{\CTAN}{\acro{CTAN}\xspace}
-\providecommand*{\DVD}{\acro{DVD}\xspace}
-\providecommand*{\HTML}{\acro{HTML}\xspace}
-\providecommand*{\MacOSX}{Mac\,\acro{OS\,X}\xspace}
-\providecommand*{\PS}{Post\-Script\xspace}
-\providecommand*{\TDS}{\acro{TDS}\xspace}
-\providecommand*{\dvi}{\acro{DVI}\xspace}
-\providecommand*{\web}{\texttt{web}\xspace}
-
-% Include an image.
-% #1 - name of image (pictures/#1.jpg, always .jpg please)
-% #2 - bb for html
-% #3 - width for TeX
-%
-\def\tlimage#1#2#3{%
- \ifnum \Status=2 % html, want relative path in output
- \includegraphics[#2]{../../general/texlive-common/pictures/#1.jpg}
- \else % not html, handled by TEXINPUTS in Makefile
- \includegraphics[width=#3]{pictures/#1.jpg}
- \fi
- \\[5mm]
-}
-%
-% description-like environment that uses tt instead of bf, and doesn't
-% go to the left margin. Without the \hfil, get an underfull box.
-% Don't know why \descriptionlabel doesn't.
-%
-\newenvironment{ttdescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt % these lists tend to have short descriptions
- \parindent=0pt
- \let\makelabel=\ttdescriptionlabel}}%
- {\end{list}}
-\newcommand*\ttdescriptionlabel[1]{\hspace\labelsep
- \normalfont\ttfamily #1\hfil}
-%
-% Likewise, for commands using sans serif.
-\newenvironment{cmddescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt
- \let\makelabel=\cmddescriptionlabel}}%
- {\end{list}}
-\newcommand*\cmddescriptionlabel[1]{\hspace\labelsep
- \normalfont\sffamily #1\hfil}
-
-% General squeezed itemize.
-\newenvironment{itemize*}%
- {\begin{itemize}%
- \setlength{\itemsep}{0pt}%
- \setlength{\parskip}{0pt}}%
- {\end{itemize}}
-
-\newsavebox{\wbox}
-\newenvironment{warningbox}
- {\begin{lrbox}{\wbox}
- \begin{minipage}{.95\textwidth}}
- {\end{minipage}\end{lrbox}\fbox{\usebox{\wbox}}}
-%
-% lrbox is used as a representation marking. I changed it to
-% lrBox in tne source file, to get closer to logical marking
-\newsavebox{\mylrbox}
-\newenvironment{lrBox}
- {\begin{lrbox}{\mylrbox}}
- {\end{lrbox}}
-
-
-% emacs-page output setup
-%
-\newif\ifSingleColumn
-\providecommand{\Status}{0}
-%\typeout{Status is \Status}
-%
-% By default, we won't be creating hyperlinks.
-\def\href#1#2{#2}
-\def\hypertarget#1#2{}
-\def\email#1{\href{mailto:#1}{\path{#1}}} % \path comes from url
-%
-\definecolor{hypercolor}{rgb}{0.5,0.0,0.5} % purplish external links.
-%
-%
-\ifcase\Status
- % \Status = 0
- \typeout{TeX Live documentation in DVI format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 1
- \typeout{TeX Live documentation in PDF format}
- \RequirePackage[breaklinks,
- colorlinks,linkcolor=hypercolor,citecolor=hypercolor,
- pagecolor=hypercolor,urlcolor=hypercolor,
- filecolor=hypercolor,
- bookmarksopen,pdfstartview={FitBH -320000},hyperindex]
- {hyperref}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 2
- \typeout{TeX Live documentation in HTML format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- % read our config file, live4ht.cfg; q.v., for more definitions.
- % hyperref load must come after the tex4ht load.
- \RequirePackage[live4ht]{tex4ht}
- \RequirePackage[tex4ht]{hyperref} \hyperlinkfileprefix{}
- % definitions need simplifying for TeX4ht to make relative paths work.
- \def\CDref#1#2{\href{../../../../#1}{#2}}
- \def\OnCD#1{\href{../../../../#1}{#1}}
- \or
- % \Status = 3
- \typeout{TeX Live documentation as a Baskerville issue}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \RequirePackage{bvoutln}% outline of baskerville
- \SingleColumnfalse
- \RequirePackage{multicol}
- \or
- % \Status = 4
- \typeout{TeX Live documentation as a TUB article}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \SingleColumnfalse
- \newenvironment{multicols}[1]{}{}
-\fi
-%
-\ifnum \Status=4
-\else
- \RequirePackage{texnames}
- \providecommand\TeXXeT{\TeX-{}-%
- \kern-.1emX\kern-.125em\lower.5ex\hbox{E}\kern-.1667emT\@}
- \def\MP{MetaPost}
- \let\mf\MF
- \newcommand\ConTeXt{C\kern-.0333emon\-\kern-.0667em\TeX\kern-.0333emt}
- \newcommand\MIKTEX{MiK\kern-.025em \TeX}% per www.miktex.org
- % from pictex.tex:
- \ifx\PiC\undefined \def\PiC{P\kern-.12em\lower.5ex\hbox{I}\kern-.075emC} \fi
- \ifx\PiCTeX\undefined \def\PiCTeX{\PiC\kern-.11em\TeX} \fi
-\fi
-%
-% hacking at sections etc., to pay attention to baskerville status
-\newcommand{\@condend@multicols}{%
- \ifSingleColumn
- \else
- \def\@tempa{multicols}%
- \ifx\@tempa\@currenvir
- \end{multicols}%
- \fi
- \fi
-}
-\let\Section\section
-\renewcommand{\section}{%
- \@ifstar
- {\Section*}%
- {%
- \@condend@multicols
- \@dblarg\@full@section
- }%
-}
-\def\@full@section[#1]#2{%
- \Section[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-\let\SubSection\subsection
-\renewcommand{\subsection}{%
- \@ifstar{\SubSection*}%
- {%
- \@condend@multicols
- \@dblarg\@full@subsection
- }
-}
-\def\@full@subsection[#1]#2{%
- \SubSection[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-
-% calm things down a bit if we're in a multiple-column version
-\ifSingleColumn
-\else
- \def\@listI{\leftmargin\leftmargini
- \parsep \z@
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \itemsep \z@ \@plus .1\p@
- }
- \let\@listi\@listI
- \@listi
- \def\@listii{\leftmargin\leftmarginii
- \labelwidth\leftmarginii\advance\labelwidth-\labelsep
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \itemsep \z@ \@plus .1\p@
- }
- \def\@listiii{\leftmargin\leftmarginiii
- \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
- \topsep 1\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \partopsep \z@
- \itemsep \topsep
- }
- \def\@listiv{\leftmargin\leftmarginiv
- \labelwidth\leftmarginiv\advance\labelwidth-\labelsep
- }
- \def\@listv{\leftmargin\leftmarginv
- \labelwidth\leftmarginv\advance\labelwidth-\labelsep
- }
- \def\@listvi{\leftmargin\leftmarginvi
- \labelwidth\leftmarginvi\advance\labelwidth-\labelsep
- }
-\fi
-%
-% array package stuff
-\def\arraybackslash{\let\\=\@arraycr}
-\newcolumntype{P}[1]{>{\raggedright\arraybackslash}p{#1}}
-%
-% shaded rows (using facilities of colortbl)
-%
-\definecolor{pale}{gray}{.9}
-\newcount\colrow
-\gdef\RowColor{pale}
-\def\SetRowColor{%
- \rowcolor{\RowColor}%
- \global\advance\colrow by1\relax
- \ifodd\colrow
- \gdef\RowColor{pale}%
- \else
- \gdef\RowColor{white}%
- \fi
-}
-% redefine to hack up a reference even though we don't need it...
-\renewcommand\@bibitem[1]{\if@filesw \immediate\write\@auxout
- {\string\bibcite{#1}{?}}\fi\ignorespaces}
-%
-% \unknownTeXlive is a dummy texlive entry for the biblio
-\newcommand\unknownTeXlive[2][\relax]{\textbf{\textsc{unknown}}%
- \global\@all@unknown\expandafter{\the\@all@unknown{#2}}%
-}
-\newtoks\@all@unknown
-\global\@all@unknown{}
-\AtEndDocument{\@message@unknowns}
-\def\@message@unknowns{\edef\@tempa{\the\@all@unknown}%
- \ifx\@tempa\@empty
- \else
- \def\@tempa{*** TeX live package location of }%
- \expandafter\@output@unknowns\the\@all@unknown\@empty
- \fi
-}
-\def\@output@unknowns#1{\edef\@tempb{#1}%
- \ifx\@tempb\@empty
- \typeout{ unknown}%
- \else
- \message{\@tempa#1,}%
- \def\@tempa{}%
- \expandafter\@output@unknowns
- \fi
-}
-
-
-% Silence font warnings about no bold typewriter in LM.
-\def\@font@warning#1{}%
-
-% Silence hyperref warnings about \kern.
-\def\HyPsd@Warning#1{}%
-
-\endinput
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2005 b/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2005
deleted file mode 100644
index 487c8b8d7a2..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2005
+++ /dev/null
@@ -1,429 +0,0 @@
-% $Id: tex-live.sty 1513 2006-02-13 00:22:35Z karl $
-% TeX Live documentation style. Written by many people over many years.
-% Public domain.
-%
-\NeedsTeXFormat{LaTeX2e}[1995/12/01]
-\ProvidesPackage{tex-live}[2005/09/24 v1.5 TeX Live documentation style]
-%
-\RequirePackage{alltt}
-\RequirePackage{array}
-\RequirePackage{colortbl}
-\RequirePackage{comment}
-\RequirePackage{float}
-\RequirePackage{graphicx}
-\RequirePackage{longtable}
-\RequirePackage{shortvrb}
-\RequirePackage[normalem]{ulem}
-\RequirePackage[obeyspaces]{url}
-\RequirePackage{xspace}
-%
-\RequirePackage{lmodern}
-\usepackage{textcomp}% including \textbullet
-\usepackage[T1]{fontenc}
-\usepackage[latin1]{inputenc}
-%
-% 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}\@}
-%
-\RequirePackage{fancyvrb}
-\DefineVerbatimEnvironment{verbatim}{Verbatim}{fontsize=\normalsize}
-\DefineVerbatimEnvironment{fverbatim}{Verbatim}{fontsize=\footnotesize}
-\DefineVerbatimEnvironment{sverbatim}{Verbatim}{fontsize=\small}
-\DefineVerbatimEnvironment{boxedverbatim}
- {Verbatim}{fontsize=\scriptsize,frame=single}
-\DefineVerbatimEnvironment{Verbatim}{Verbatim}{fontsize=\normalsize}
-\def\verbatiminput#1{\VerbatimInput[fontsize=\scriptsize]{#1}}
-\def\boxedverbatiminput#1{\VerbatimInput[frame=single,fontsize=\scriptsize]{#1}}
-\def\listinginput#1#2{\VerbatimInput[fontsize=\scriptsize,firstnumber=#1,numbers=left]{#2}}
-\MakeShortVerb\|
-%
-%
-% Done with packages.
-%
-% Page layout.
-\advance\textwidth by 1.1in
-\advance\oddsidemargin by -.55in
-\advance\evensidemargin by -.55in
-%
-\advance\textheight by 1in
-\advance\topmargin by -.5in
-\advance\footskip by -.5in
-\pagestyle{headings}
-%
-% LaTeX parameters.
-\renewcommand{\topfraction}{0.85}
-\renewcommand{\floatpagefraction}{0.86}
-\renewcommand{\textfraction}{0.1}
-\renewcommand{\belowcaptionskip}{4pt}
-\setcounter{tocdepth}{2}
-\setcounter{topnumber}{5}
-\setcounter{totalnumber}{5}
-%
-% linebreaking, etc.
-\hbadness=4000
-\vbadness=4000
-\emergencystretch=.1\hsize
-\relpenalty=500
-%
-\def\slash{/\penalty\z@\hskip\z@skip }
-%
-% various sorts of names
-\newcommand*{\pkgname}[1]{\textsf{#1}}% package name
-\newcommand*{\optname}[1]{\texttt{#1}}% (package,class) option name
-\newcommand*{\cmdname}[1]{\textsf{#1}}% command name
-\newcommand*{\colname}[1]{\emph{#1}}% collection name
-\newcommand*{\dirname}[1]{\path{#1}}% directory name
-\newcommand*{\filename}[1]{\path{#1}}% file name
-\newcommand*{\envname}[1]{\texttt{#1}}% environment variable name
-\newcommand{\code}[1]{\texttt{#1}}
-\newcommand{\file}[1]{\texttt{#1}}
-\newcommand{\prog}[1]{\texttt{#1}}
-\newcommand{\samp}[1]{`\texttt{#1}'}
-\newcommand{\var}[1]{{\sl #1}}% not \textsl, for roman not typewriter slanted.
-\newcommand{\ttvar}[1]{\texttt{\var{#1}}}
-%
-% underlined command input.
-\def\Ucom#1{%
- \uline{\rule[-.2\baselineskip]{0pt}{.9\baselineskip}\ttfamily #1}}
-%
-% \CDref is for url's with a #, where we need to write the target url and
-% displayed url separately in the input, due to catcode madness.
-% (We could simplify/remove this next time, I think.)
-\def\CDref#1#2{\texttt{#1}}
-%
-% \OnCD is currently for any other reference to a file or directory in
-% the distribution. PDF readers only open .pdf files, though, so we
-% should change this to only use \href for those. Or more likely use
-% different macros in the source.
-\def\OnCD#1{\href{../../../../#1}{\path{#1}}}
-%
-% \href incorrectly appends .pdf to anything without an extension; these
-% definitions using \hyper@linkurl do not, but they fail for .pdf
-% references -- which are the only ones that work anyway. So this is
-% useless, in practice.
-%\def\CDref#1#2{\hyper@linkurl{#2}{../../../../#1}}
-%\def\OnCD#1{\hyper@linkurl{\path{#1}}{../../../../#1}}
-
-% GUI menu/button/tab sequence:
-\def\guiseq#1{\textsf{#1}}
-\def\arw{\unskip$\rightarrow$\ignorespaces}
-%
-% Special names.
-\def\dpi{$\,$dpi\xspace}
-\def\bs{{\protect\normalfont\ttfamily\char'134}}
-\DeclareRobustCommand{\cs}[1]{{\normalfont\ttfamily\char`\\#1}}
-\def\Q#1{\par\vskip6pt\leftline{#1}\par}
-\def\hyph{-}
-%
-% many abbreviations.
-\newcommand{\CS}{$\mathcal{C}\kern-.1667em\lower.5ex%
- \hbox{$\mathcal{S}$}\kern-.075em $}
-\def\AFMtoTFM{\cmdname{AFM2TFM}\null}
-\def\bv{\emph{Baskerville}}
-\let\BV=\bv
-\def\Dash{\unskip\nobreak\thinspace---\thinspace\ignorespaces}
-\def\dvicopy{\cmdname{dvicopy}}
-\def\dvidvi{\cmdname{dvidvi}}
-\def\dvips{\cmdname{dvips}}
-\def\eTeX{$\varepsilon$-\TeX}
-\def\fpTeX{\textrm{fp}\TeX\xspace}
-\def\GFtoDVI{\cmdname{GFtoDVI}\null}
-\def\GFtoPK{\cmdname{GFtoPK}\null}
-\def\GFtype{\cmdname{GFtype}}
-\def\KPS{Kpathsea}
-\def\La{La}
-\def\OMEGA{$\Omega$}
-\def\OzMF{OzMF}
-\def\OzMP{OzMP}
-\def\OzTeX{O\kern-.03em z\kern-.15em\TeX}
-\def\p.{p.\,}
-\def\PKtype{\cmdname{PKtype}}
-\def\PLtoTF{\cmdname{PLtoTF}\null}
-\def\ProTeXt{Pro\TeX t}
-\def\teTeX{\textrm{te}\TeX\xspace}
-\def\TeXLive{\TeX{} Live\xspace}
-\def\TFtoPL{\cmdname{TFtoPL}\null}
-\def\TK{\textsf{\TeX\ Collection}}
-\let\TL=\TeXLive
-\def\TypeI{Type~1}
-\def\VFtoVP{\cmdname{VFtoVP}\null}
-\def\VPtoVF{\cmdname{VPtoVF}\null}
-\def\Thanh{H\`an~Th\^e\llap{\raise 0.5ex\hbox{\'{}}}~Th\`anh}
-\def\XEmTeX{\textrm{XEm}\TeX\xspace}
-\def\XEmacs{\textrm{XEmacs}\xspace}
-\def\Webc{Web2C}
-\providecommand*{\CD}{\acro{CD}\xspace}
-\providecommand*{\CTAN}{\acro{CTAN}\xspace}
-\providecommand*{\DVD}{\acro{DVD}\xspace}
-\providecommand*{\HTML}{\acro{HTML}\xspace}
-\providecommand*{\MacOSX}{Mac\,\acro{OS\,X}\xspace}
-\providecommand*{\PS}{Post\-Script\xspace}
-\providecommand*{\TDS}{\acro{TDS}\xspace}
-\providecommand*{\dvi}{\acro{DVI}\xspace}
-\providecommand*{\web}{\texttt{web}\xspace}
-
-% Include an image.
-% #1 - name of image (pictures/#1.jpg, always .jpg please)
-% #2 - bb for html
-% #3 - width for TeX
-%
-\def\tlimage#1#2#3{%
- \ifnum \Status=2 % html, want relative path in output
- \includegraphics[#2]{../../general/texlive-common/pictures/#1.jpg}
- \else % not html, handled by TEXINPUTS in Makefile
- \includegraphics[width=#3]{pictures/#1.jpg}
- \fi
- \\[5mm]
-}
-%
-% description-like environment that uses tt instead of bf, and doesn't
-% go to the left margin. Without the \hfil, get an underfull box.
-% Don't know why \descriptionlabel doesn't.
-%
-\newenvironment{ttdescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt % these lists tend to have short descriptions
- \parindent=0pt
- \let\makelabel=\ttdescriptionlabel}}%
- {\end{list}}
-\newcommand*\ttdescriptionlabel[1]{\hspace\labelsep
- \normalfont\ttfamily #1\hfil}
-%
-% Likewise, for commands using sans serif.
-\newenvironment{cmddescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt
- \let\makelabel=\cmddescriptionlabel}}%
- {\end{list}}
-\newcommand*\cmddescriptionlabel[1]{\hspace\labelsep
- \normalfont\sffamily #1\hfil}
-
-% General squeezed itemize.
-\newenvironment{itemize*}%
- {\begin{itemize}%
- \setlength{\itemsep}{0pt}%
- \setlength{\parskip}{0pt}}%
- {\end{itemize}}
-
-\newsavebox{\wbox}
-\newenvironment{warningbox}
- {\begin{lrbox}{\wbox}
- \begin{minipage}{.95\textwidth}}
- {\end{minipage}\end{lrbox}\fbox{\usebox{\wbox}}}
-%
-% lrbox is used as a representation marking. I changed it to
-% lrBox in tne source file, to get closer to logical marking
-\newsavebox{\mylrbox}
-\newenvironment{lrBox}
- {\begin{lrbox}{\mylrbox}}
- {\end{lrbox}}
-
-
-% emacs-page output setup
-%
-\ifx \HCode\UnDef
- \providecommand{\Status}{0}% running TeX
-\else
- \providecommand{\Status}{2}% running TeX4ht
-\fi
-%\typeout{Status is \Status}
-%
-\newif\ifSingleColumn
-%
-% By default, we won't be creating hyperlinks.
-\def\href#1#2{#2}
-\def\hypertarget#1#2{}
-\def\email#1{\href{mailto:#1}{\path{#1}}} % \path comes from url
-%
-\definecolor{hypercolor}{rgb}{0.5,0.0,0.5} % purplish external links.
-%
-%
-\ifcase\Status
- % \Status = 0
- \typeout{TeX Live documentation in DVI format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 1
- \typeout{TeX Live documentation in PDF format}
- \RequirePackage[breaklinks,
- colorlinks,linkcolor=hypercolor,citecolor=hypercolor,
- pagecolor=hypercolor,urlcolor=hypercolor,
- filecolor=hypercolor,
- bookmarksopen,
- %pdfstartview={FitBH -320000}, % fails with acrobat7
- hyperindex]
- {hyperref}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 2
- \typeout{TeX Live documentation in HTML format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- % read our config file, live4ht.cfg; q.v., for more definitions.
- % hyperref load must come after the tex4ht load.
- \RequirePackage[live4ht]{tex4ht}
- \RequirePackage[tex4ht]{hyperref} \hyperlinkfileprefix{}
- % definitions need simplifying for TeX4ht to make relative paths work.
- \def\CDref#1#2{\href{../../../../#1}{#2}}
- \def\OnCD#1{\href{../../../../#1}{#1}}
- \or
- % \Status = 3
- \typeout{TeX Live documentation as a Baskerville issue}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \RequirePackage{bvoutln}% outline of baskerville
- \SingleColumnfalse
- \RequirePackage{multicol}
- \or
- % \Status = 4
- \typeout{TeX Live documentation as a TUB article}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \SingleColumnfalse
- \newenvironment{multicols}[1]{}{}
-\fi
-%
-\ifnum \Status=4
-\else
- \RequirePackage{texnames}
- \providecommand\TeXXeT{\TeX-{}-%
- \kern-.1emX\kern-.125em\lower.5ex\hbox{E}\kern-.1667emT\@}
- \def\MP{MetaPost}
- \let\mf\MF
- \newcommand\ConTeXt{C\kern-.0333emon\-\kern-.0667em\TeX\kern-.0333emt}
- \newcommand\MIKTEX{MiK\kern-.025em \TeX}% per www.miktex.org
- % from pictex.tex:
- \ifx\PiC\undefined \def\PiC{P\kern-.12em\lower.5ex\hbox{I}\kern-.075emC} \fi
- \ifx\PiCTeX\undefined \def\PiCTeX{\PiC\kern-.11em\TeX} \fi
-\fi
-%
-% hacking at sections etc., to pay attention to baskerville status
-\newcommand{\@condend@multicols}{%
- \ifSingleColumn
- \else
- \def\@tempa{multicols}%
- \ifx\@tempa\@currenvir
- \end{multicols}%
- \fi
- \fi
-}
-\let\Section\section
-\renewcommand{\section}{%
- \@ifstar
- {\Section*}%
- {%
- \@condend@multicols
- \@dblarg\@full@section
- }%
-}
-\def\@full@section[#1]#2{%
- \Section[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-\let\SubSection\subsection
-\renewcommand{\subsection}{%
- \@ifstar{\SubSection*}%
- {%
- \@condend@multicols
- \@dblarg\@full@subsection
- }
-}
-\def\@full@subsection[#1]#2{%
- \SubSection[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-
-% calm things down a bit if we're in a multiple-column version
-\ifSingleColumn
-\else
- \def\@listI{\leftmargin\leftmargini
- \parsep \z@
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \itemsep \z@ \@plus .1\p@
- }
- \let\@listi\@listI
- \@listi
- \def\@listii{\leftmargin\leftmarginii
- \labelwidth\leftmarginii\advance\labelwidth-\labelsep
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \itemsep \z@ \@plus .1\p@
- }
- \def\@listiii{\leftmargin\leftmarginiii
- \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
- \topsep 1\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \partopsep \z@
- \itemsep \topsep
- }
- \def\@listiv{\leftmargin\leftmarginiv
- \labelwidth\leftmarginiv\advance\labelwidth-\labelsep
- }
- \def\@listv{\leftmargin\leftmarginv
- \labelwidth\leftmarginv\advance\labelwidth-\labelsep
- }
- \def\@listvi{\leftmargin\leftmarginvi
- \labelwidth\leftmarginvi\advance\labelwidth-\labelsep
- }
-\fi
-%
-% array package stuff
-\def\arraybackslash{\let\\=\@arraycr}
-\newcolumntype{P}[1]{>{\raggedright\arraybackslash}p{#1}}
-%
-% shaded rows (using facilities of colortbl)
-%
-\definecolor{pale}{gray}{.9}
-\newcount\colrow
-\gdef\RowColor{pale}
-\def\SetRowColor{%
- \rowcolor{\RowColor}%
- \global\advance\colrow by1\relax
- \ifodd\colrow
- \gdef\RowColor{pale}%
- \else
- \gdef\RowColor{white}%
- \fi
-}
-% redefine to hack up a reference even though we don't need it...
-\renewcommand\@bibitem[1]{\if@filesw \immediate\write\@auxout
- {\string\bibcite{#1}{?}}\fi\ignorespaces}
-%
-% \unknownTeXlive is a dummy texlive entry for the biblio
-\newcommand\unknownTeXlive[2][\relax]{\textbf{\textsc{unknown}}%
- \global\@all@unknown\expandafter{\the\@all@unknown{#2}}%
-}
-\newtoks\@all@unknown
-\global\@all@unknown{}
-\AtEndDocument{\@message@unknowns}
-\def\@message@unknowns{\edef\@tempa{\the\@all@unknown}%
- \ifx\@tempa\@empty
- \else
- \def\@tempa{*** TeX live package location of }%
- \expandafter\@output@unknowns\the\@all@unknown\@empty
- \fi
-}
-\def\@output@unknowns#1{\edef\@tempb{#1}%
- \ifx\@tempb\@empty
- \typeout{ unknown}%
- \else
- \message{\@tempa#1,}%
- \def\@tempa{}%
- \expandafter\@output@unknowns
- \fi
-}
-
-
-% Silence font warnings about no bold typewriter in LM.
-\def\@font@warning#1{}%
-
-% Silence hyperref warnings about \kern.
-\def\HyPsd@Warning#1{}%
-
-\endinput
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2007 b/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2007
deleted file mode 100644
index 487c8b8d7a2..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2007
+++ /dev/null
@@ -1,429 +0,0 @@
-% $Id: tex-live.sty 1513 2006-02-13 00:22:35Z karl $
-% TeX Live documentation style. Written by many people over many years.
-% Public domain.
-%
-\NeedsTeXFormat{LaTeX2e}[1995/12/01]
-\ProvidesPackage{tex-live}[2005/09/24 v1.5 TeX Live documentation style]
-%
-\RequirePackage{alltt}
-\RequirePackage{array}
-\RequirePackage{colortbl}
-\RequirePackage{comment}
-\RequirePackage{float}
-\RequirePackage{graphicx}
-\RequirePackage{longtable}
-\RequirePackage{shortvrb}
-\RequirePackage[normalem]{ulem}
-\RequirePackage[obeyspaces]{url}
-\RequirePackage{xspace}
-%
-\RequirePackage{lmodern}
-\usepackage{textcomp}% including \textbullet
-\usepackage[T1]{fontenc}
-\usepackage[latin1]{inputenc}
-%
-% 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}\@}
-%
-\RequirePackage{fancyvrb}
-\DefineVerbatimEnvironment{verbatim}{Verbatim}{fontsize=\normalsize}
-\DefineVerbatimEnvironment{fverbatim}{Verbatim}{fontsize=\footnotesize}
-\DefineVerbatimEnvironment{sverbatim}{Verbatim}{fontsize=\small}
-\DefineVerbatimEnvironment{boxedverbatim}
- {Verbatim}{fontsize=\scriptsize,frame=single}
-\DefineVerbatimEnvironment{Verbatim}{Verbatim}{fontsize=\normalsize}
-\def\verbatiminput#1{\VerbatimInput[fontsize=\scriptsize]{#1}}
-\def\boxedverbatiminput#1{\VerbatimInput[frame=single,fontsize=\scriptsize]{#1}}
-\def\listinginput#1#2{\VerbatimInput[fontsize=\scriptsize,firstnumber=#1,numbers=left]{#2}}
-\MakeShortVerb\|
-%
-%
-% Done with packages.
-%
-% Page layout.
-\advance\textwidth by 1.1in
-\advance\oddsidemargin by -.55in
-\advance\evensidemargin by -.55in
-%
-\advance\textheight by 1in
-\advance\topmargin by -.5in
-\advance\footskip by -.5in
-\pagestyle{headings}
-%
-% LaTeX parameters.
-\renewcommand{\topfraction}{0.85}
-\renewcommand{\floatpagefraction}{0.86}
-\renewcommand{\textfraction}{0.1}
-\renewcommand{\belowcaptionskip}{4pt}
-\setcounter{tocdepth}{2}
-\setcounter{topnumber}{5}
-\setcounter{totalnumber}{5}
-%
-% linebreaking, etc.
-\hbadness=4000
-\vbadness=4000
-\emergencystretch=.1\hsize
-\relpenalty=500
-%
-\def\slash{/\penalty\z@\hskip\z@skip }
-%
-% various sorts of names
-\newcommand*{\pkgname}[1]{\textsf{#1}}% package name
-\newcommand*{\optname}[1]{\texttt{#1}}% (package,class) option name
-\newcommand*{\cmdname}[1]{\textsf{#1}}% command name
-\newcommand*{\colname}[1]{\emph{#1}}% collection name
-\newcommand*{\dirname}[1]{\path{#1}}% directory name
-\newcommand*{\filename}[1]{\path{#1}}% file name
-\newcommand*{\envname}[1]{\texttt{#1}}% environment variable name
-\newcommand{\code}[1]{\texttt{#1}}
-\newcommand{\file}[1]{\texttt{#1}}
-\newcommand{\prog}[1]{\texttt{#1}}
-\newcommand{\samp}[1]{`\texttt{#1}'}
-\newcommand{\var}[1]{{\sl #1}}% not \textsl, for roman not typewriter slanted.
-\newcommand{\ttvar}[1]{\texttt{\var{#1}}}
-%
-% underlined command input.
-\def\Ucom#1{%
- \uline{\rule[-.2\baselineskip]{0pt}{.9\baselineskip}\ttfamily #1}}
-%
-% \CDref is for url's with a #, where we need to write the target url and
-% displayed url separately in the input, due to catcode madness.
-% (We could simplify/remove this next time, I think.)
-\def\CDref#1#2{\texttt{#1}}
-%
-% \OnCD is currently for any other reference to a file or directory in
-% the distribution. PDF readers only open .pdf files, though, so we
-% should change this to only use \href for those. Or more likely use
-% different macros in the source.
-\def\OnCD#1{\href{../../../../#1}{\path{#1}}}
-%
-% \href incorrectly appends .pdf to anything without an extension; these
-% definitions using \hyper@linkurl do not, but they fail for .pdf
-% references -- which are the only ones that work anyway. So this is
-% useless, in practice.
-%\def\CDref#1#2{\hyper@linkurl{#2}{../../../../#1}}
-%\def\OnCD#1{\hyper@linkurl{\path{#1}}{../../../../#1}}
-
-% GUI menu/button/tab sequence:
-\def\guiseq#1{\textsf{#1}}
-\def\arw{\unskip$\rightarrow$\ignorespaces}
-%
-% Special names.
-\def\dpi{$\,$dpi\xspace}
-\def\bs{{\protect\normalfont\ttfamily\char'134}}
-\DeclareRobustCommand{\cs}[1]{{\normalfont\ttfamily\char`\\#1}}
-\def\Q#1{\par\vskip6pt\leftline{#1}\par}
-\def\hyph{-}
-%
-% many abbreviations.
-\newcommand{\CS}{$\mathcal{C}\kern-.1667em\lower.5ex%
- \hbox{$\mathcal{S}$}\kern-.075em $}
-\def\AFMtoTFM{\cmdname{AFM2TFM}\null}
-\def\bv{\emph{Baskerville}}
-\let\BV=\bv
-\def\Dash{\unskip\nobreak\thinspace---\thinspace\ignorespaces}
-\def\dvicopy{\cmdname{dvicopy}}
-\def\dvidvi{\cmdname{dvidvi}}
-\def\dvips{\cmdname{dvips}}
-\def\eTeX{$\varepsilon$-\TeX}
-\def\fpTeX{\textrm{fp}\TeX\xspace}
-\def\GFtoDVI{\cmdname{GFtoDVI}\null}
-\def\GFtoPK{\cmdname{GFtoPK}\null}
-\def\GFtype{\cmdname{GFtype}}
-\def\KPS{Kpathsea}
-\def\La{La}
-\def\OMEGA{$\Omega$}
-\def\OzMF{OzMF}
-\def\OzMP{OzMP}
-\def\OzTeX{O\kern-.03em z\kern-.15em\TeX}
-\def\p.{p.\,}
-\def\PKtype{\cmdname{PKtype}}
-\def\PLtoTF{\cmdname{PLtoTF}\null}
-\def\ProTeXt{Pro\TeX t}
-\def\teTeX{\textrm{te}\TeX\xspace}
-\def\TeXLive{\TeX{} Live\xspace}
-\def\TFtoPL{\cmdname{TFtoPL}\null}
-\def\TK{\textsf{\TeX\ Collection}}
-\let\TL=\TeXLive
-\def\TypeI{Type~1}
-\def\VFtoVP{\cmdname{VFtoVP}\null}
-\def\VPtoVF{\cmdname{VPtoVF}\null}
-\def\Thanh{H\`an~Th\^e\llap{\raise 0.5ex\hbox{\'{}}}~Th\`anh}
-\def\XEmTeX{\textrm{XEm}\TeX\xspace}
-\def\XEmacs{\textrm{XEmacs}\xspace}
-\def\Webc{Web2C}
-\providecommand*{\CD}{\acro{CD}\xspace}
-\providecommand*{\CTAN}{\acro{CTAN}\xspace}
-\providecommand*{\DVD}{\acro{DVD}\xspace}
-\providecommand*{\HTML}{\acro{HTML}\xspace}
-\providecommand*{\MacOSX}{Mac\,\acro{OS\,X}\xspace}
-\providecommand*{\PS}{Post\-Script\xspace}
-\providecommand*{\TDS}{\acro{TDS}\xspace}
-\providecommand*{\dvi}{\acro{DVI}\xspace}
-\providecommand*{\web}{\texttt{web}\xspace}
-
-% Include an image.
-% #1 - name of image (pictures/#1.jpg, always .jpg please)
-% #2 - bb for html
-% #3 - width for TeX
-%
-\def\tlimage#1#2#3{%
- \ifnum \Status=2 % html, want relative path in output
- \includegraphics[#2]{../../general/texlive-common/pictures/#1.jpg}
- \else % not html, handled by TEXINPUTS in Makefile
- \includegraphics[width=#3]{pictures/#1.jpg}
- \fi
- \\[5mm]
-}
-%
-% description-like environment that uses tt instead of bf, and doesn't
-% go to the left margin. Without the \hfil, get an underfull box.
-% Don't know why \descriptionlabel doesn't.
-%
-\newenvironment{ttdescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt % these lists tend to have short descriptions
- \parindent=0pt
- \let\makelabel=\ttdescriptionlabel}}%
- {\end{list}}
-\newcommand*\ttdescriptionlabel[1]{\hspace\labelsep
- \normalfont\ttfamily #1\hfil}
-%
-% Likewise, for commands using sans serif.
-\newenvironment{cmddescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt
- \let\makelabel=\cmddescriptionlabel}}%
- {\end{list}}
-\newcommand*\cmddescriptionlabel[1]{\hspace\labelsep
- \normalfont\sffamily #1\hfil}
-
-% General squeezed itemize.
-\newenvironment{itemize*}%
- {\begin{itemize}%
- \setlength{\itemsep}{0pt}%
- \setlength{\parskip}{0pt}}%
- {\end{itemize}}
-
-\newsavebox{\wbox}
-\newenvironment{warningbox}
- {\begin{lrbox}{\wbox}
- \begin{minipage}{.95\textwidth}}
- {\end{minipage}\end{lrbox}\fbox{\usebox{\wbox}}}
-%
-% lrbox is used as a representation marking. I changed it to
-% lrBox in tne source file, to get closer to logical marking
-\newsavebox{\mylrbox}
-\newenvironment{lrBox}
- {\begin{lrbox}{\mylrbox}}
- {\end{lrbox}}
-
-
-% emacs-page output setup
-%
-\ifx \HCode\UnDef
- \providecommand{\Status}{0}% running TeX
-\else
- \providecommand{\Status}{2}% running TeX4ht
-\fi
-%\typeout{Status is \Status}
-%
-\newif\ifSingleColumn
-%
-% By default, we won't be creating hyperlinks.
-\def\href#1#2{#2}
-\def\hypertarget#1#2{}
-\def\email#1{\href{mailto:#1}{\path{#1}}} % \path comes from url
-%
-\definecolor{hypercolor}{rgb}{0.5,0.0,0.5} % purplish external links.
-%
-%
-\ifcase\Status
- % \Status = 0
- \typeout{TeX Live documentation in DVI format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 1
- \typeout{TeX Live documentation in PDF format}
- \RequirePackage[breaklinks,
- colorlinks,linkcolor=hypercolor,citecolor=hypercolor,
- pagecolor=hypercolor,urlcolor=hypercolor,
- filecolor=hypercolor,
- bookmarksopen,
- %pdfstartview={FitBH -320000}, % fails with acrobat7
- hyperindex]
- {hyperref}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 2
- \typeout{TeX Live documentation in HTML format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- % read our config file, live4ht.cfg; q.v., for more definitions.
- % hyperref load must come after the tex4ht load.
- \RequirePackage[live4ht]{tex4ht}
- \RequirePackage[tex4ht]{hyperref} \hyperlinkfileprefix{}
- % definitions need simplifying for TeX4ht to make relative paths work.
- \def\CDref#1#2{\href{../../../../#1}{#2}}
- \def\OnCD#1{\href{../../../../#1}{#1}}
- \or
- % \Status = 3
- \typeout{TeX Live documentation as a Baskerville issue}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \RequirePackage{bvoutln}% outline of baskerville
- \SingleColumnfalse
- \RequirePackage{multicol}
- \or
- % \Status = 4
- \typeout{TeX Live documentation as a TUB article}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \SingleColumnfalse
- \newenvironment{multicols}[1]{}{}
-\fi
-%
-\ifnum \Status=4
-\else
- \RequirePackage{texnames}
- \providecommand\TeXXeT{\TeX-{}-%
- \kern-.1emX\kern-.125em\lower.5ex\hbox{E}\kern-.1667emT\@}
- \def\MP{MetaPost}
- \let\mf\MF
- \newcommand\ConTeXt{C\kern-.0333emon\-\kern-.0667em\TeX\kern-.0333emt}
- \newcommand\MIKTEX{MiK\kern-.025em \TeX}% per www.miktex.org
- % from pictex.tex:
- \ifx\PiC\undefined \def\PiC{P\kern-.12em\lower.5ex\hbox{I}\kern-.075emC} \fi
- \ifx\PiCTeX\undefined \def\PiCTeX{\PiC\kern-.11em\TeX} \fi
-\fi
-%
-% hacking at sections etc., to pay attention to baskerville status
-\newcommand{\@condend@multicols}{%
- \ifSingleColumn
- \else
- \def\@tempa{multicols}%
- \ifx\@tempa\@currenvir
- \end{multicols}%
- \fi
- \fi
-}
-\let\Section\section
-\renewcommand{\section}{%
- \@ifstar
- {\Section*}%
- {%
- \@condend@multicols
- \@dblarg\@full@section
- }%
-}
-\def\@full@section[#1]#2{%
- \Section[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-\let\SubSection\subsection
-\renewcommand{\subsection}{%
- \@ifstar{\SubSection*}%
- {%
- \@condend@multicols
- \@dblarg\@full@subsection
- }
-}
-\def\@full@subsection[#1]#2{%
- \SubSection[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-
-% calm things down a bit if we're in a multiple-column version
-\ifSingleColumn
-\else
- \def\@listI{\leftmargin\leftmargini
- \parsep \z@
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \itemsep \z@ \@plus .1\p@
- }
- \let\@listi\@listI
- \@listi
- \def\@listii{\leftmargin\leftmarginii
- \labelwidth\leftmarginii\advance\labelwidth-\labelsep
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \itemsep \z@ \@plus .1\p@
- }
- \def\@listiii{\leftmargin\leftmarginiii
- \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
- \topsep 1\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \partopsep \z@
- \itemsep \topsep
- }
- \def\@listiv{\leftmargin\leftmarginiv
- \labelwidth\leftmarginiv\advance\labelwidth-\labelsep
- }
- \def\@listv{\leftmargin\leftmarginv
- \labelwidth\leftmarginv\advance\labelwidth-\labelsep
- }
- \def\@listvi{\leftmargin\leftmarginvi
- \labelwidth\leftmarginvi\advance\labelwidth-\labelsep
- }
-\fi
-%
-% array package stuff
-\def\arraybackslash{\let\\=\@arraycr}
-\newcolumntype{P}[1]{>{\raggedright\arraybackslash}p{#1}}
-%
-% shaded rows (using facilities of colortbl)
-%
-\definecolor{pale}{gray}{.9}
-\newcount\colrow
-\gdef\RowColor{pale}
-\def\SetRowColor{%
- \rowcolor{\RowColor}%
- \global\advance\colrow by1\relax
- \ifodd\colrow
- \gdef\RowColor{pale}%
- \else
- \gdef\RowColor{white}%
- \fi
-}
-% redefine to hack up a reference even though we don't need it...
-\renewcommand\@bibitem[1]{\if@filesw \immediate\write\@auxout
- {\string\bibcite{#1}{?}}\fi\ignorespaces}
-%
-% \unknownTeXlive is a dummy texlive entry for the biblio
-\newcommand\unknownTeXlive[2][\relax]{\textbf{\textsc{unknown}}%
- \global\@all@unknown\expandafter{\the\@all@unknown{#2}}%
-}
-\newtoks\@all@unknown
-\global\@all@unknown{}
-\AtEndDocument{\@message@unknowns}
-\def\@message@unknowns{\edef\@tempa{\the\@all@unknown}%
- \ifx\@tempa\@empty
- \else
- \def\@tempa{*** TeX live package location of }%
- \expandafter\@output@unknowns\the\@all@unknown\@empty
- \fi
-}
-\def\@output@unknowns#1{\edef\@tempb{#1}%
- \ifx\@tempb\@empty
- \typeout{ unknown}%
- \else
- \message{\@tempa#1,}%
- \def\@tempa{}%
- \expandafter\@output@unknowns
- \fi
-}
-
-
-% Silence font warnings about no bold typewriter in LM.
-\def\@font@warning#1{}%
-
-% Silence hyperref warnings about \kern.
-\def\HyPsd@Warning#1{}%
-
-\endinput
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2008 b/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2008
deleted file mode 100644
index 6bb5d7fb57b..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/tex-live.sty-2008
+++ /dev/null
@@ -1,444 +0,0 @@
-% $Id: tex-live.sty 10332 2008-08-14 01:04:30Z karl $
-% TeX Live documentation style. Written by many people over many years.
-% Public domain.
-%
-\NeedsTeXFormat{LaTeX2e}[1995/12/01]
-\ProvidesPackage{tex-live}[2008/08/08 v1.6 TeX Live documentation style]
-%
-\RequirePackage{alltt}
-\RequirePackage{array}
-\RequirePackage{colortbl}
-\RequirePackage{comment}
-\RequirePackage{float}
-\RequirePackage{graphicx}
-\RequirePackage{longtable}
-\RequirePackage{shortvrb}
-\RequirePackage[normalem]{ulem}
-\RequirePackage[obeyspaces]{url}
-\RequirePackage{xspace}
-%
-\RequirePackage{lmodern}
-\usepackage{textcomp}% including \textbullet
-\def\p.{p.\,}
-
-% for a proper \acro command.
-\RequirePackage{relsize}
-%\DeclareRobustCommand{\acro}[1]{\textscale{.9}{#1}\@}
-\def\acro#1{\textscale{.9}{#1}\@}
-%
-\RequirePackage{fancyvrb}
-\DefineVerbatimEnvironment{verbatim}{Verbatim}{fontsize=\normalsize}
-\DefineVerbatimEnvironment{fverbatim}{Verbatim}{fontsize=\footnotesize}
-\DefineVerbatimEnvironment{sverbatim}{Verbatim}{fontsize=\small}
-\DefineVerbatimEnvironment{boxedverbatim}
- {Verbatim}{fontsize=\scriptsize,frame=single}
-\DefineVerbatimEnvironment{Verbatim}{Verbatim}{fontsize=\normalsize}
-\def\verbatiminput#1{\VerbatimInput[fontsize=\scriptsize]{#1}}
-\def\boxedverbatiminput#1{\VerbatimInput[frame=single,fontsize=\scriptsize]{#1}}
-\def\listinginput#1#2{\VerbatimInput[fontsize=\scriptsize,firstnumber=#1,numbers=left]{#2}}
-\MakeShortVerb\|
-%
-%
-% Done with packages.
-%
-% Page layout.
-\advance\textwidth by 1.1in
-\advance\oddsidemargin by -.55in
-\advance\evensidemargin by -.55in
-%
-\advance\textheight by 1in
-\advance\topmargin by -.5in
-\advance\footskip by -.5in
-\pagestyle{headings}
-%
-% LaTeX parameters.
-\renewcommand{\topfraction}{0.85}
-\renewcommand{\floatpagefraction}{0.86}
-\renewcommand{\textfraction}{0.1}
-\renewcommand{\abovecaptionskip}{4pt}
-\renewcommand{\belowcaptionskip}{4pt}
-\setcounter{tocdepth}{3}
-\setcounter{secnumdepth}{3}
-\setcounter{topnumber}{5}
-\setcounter{totalnumber}{5}
-%
-% linebreaking, etc.
-\hbadness=4000
-\vbadness=4000
-\emergencystretch=.1\hsize
-\relpenalty=500
-%
-\def\slash{/\penalty\z@\hskip\z@skip }
-%
-% various sorts of names
-\newcommand*{\pkgname}[1]{\textsf{#1}}% package name
-\newcommand*{\optname}[1]{\texttt{#1}}% (package,class) option name
-\newcommand*{\cmdname}[1]{\textsf{#1}}% command name
-\newcommand*{\colname}[1]{\emph{#1}}% collection name
-\newcommand*{\dirname}[1]{\path{#1}}% directory name
-\newcommand*{\filename}[1]{\path{#1}}% file name
-\newcommand*{\envname}[1]{\texttt{#1}}% environment variable name
-\newcommand{\code}[1]{\texttt{#1}}
-\newcommand{\file}[1]{\texttt{#1}}
-\newcommand{\prog}[1]{\textsf{#1}}% same as \cmdname
-\newcommand{\samp}[1]{`\texttt{#1}'}
-\newcommand{\var}[1]{{\sl #1}}% not \textsl, for roman not typewriter slanted.
-\newcommand{\ttvar}[1]{\texttt{\var{#1}}}
-%
-% underlined command input.
-%\def\Ucom#1{%
-% \uline{\rule[-.2\baselineskip]{0pt}{.9\baselineskip}\ttfamily #1}}
-% bold command input
-\def\Ucom#1{{\bfseries\ttfamily #1}}
-%
-% \CDref is for url's with a #, where we need to write the target url and
-% displayed url separately in the input, due to catcode madness.
-% (We could simplify/remove this next time, I think.)
-\def\CDref#1#2{\texttt{#1}}
-%
-% \OnCD is currently for any other reference to a file or directory in
-% the distribution. PDF readers only open .pdf files, though, so we
-% should change this to only use \href for those. Or more likely use
-% different macros in the source.
-\def\OnCD#1{\href{../../../../#1}{\path{#1}}}
-%
-% \href incorrectly appends .pdf to anything without an extension; these
-% definitions using \hyper@linkurl do not, but they fail for .pdf
-% references -- which are the only ones that work anyway. So this is
-% useless, in practice.
-%\def\CDref#1#2{\hyper@linkurl{#2}{../../../../#1}}
-%\def\OnCD#1{\hyper@linkurl{\path{#1}}{../../../../#1}}
-
-% GUI menu/button/tab sequence:
-\def\guiseq#1{\textsf{#1}}
-\def\arw{\unskip$\rightarrow$\ignorespaces}
-%
-% Special names.
-\def\dpi{$\,$dpi\xspace}
-\def\bs{{\protect\normalfont\ttfamily\char'134}}
-\DeclareRobustCommand{\cs}[1]{{\normalfont\ttfamily\char`\\#1}}
-\def\Q#1{\par\vskip6pt\leftline{#1}\par}
-\def\hyph{-}
-%
-% many abbreviations.
-\newcommand{\CS}{$\mathcal{C}\kern-.1667em\lower.5ex%
- \hbox{$\mathcal{S}$}\kern-.075em $}
-\def\AFMtoTFM{\cmdname{AFM2TFM}\null}
-\def\bv{\emph{Baskerville}}
-\let\BV=\bv
-\def\Dash{\unskip\nobreak\thinspace---\thinspace\ignorespaces}
-\def\dvicopy{\cmdname{dvicopy}}
-\def\dvidvi{\cmdname{dvidvi}}
-\def\dvips{\cmdname{dvips}}
-\def\eTeX{$\varepsilon$-\TeX}
-\def\fpTeX{\textrm{fp}\TeX\xspace}
-\def\GFtoDVI{\cmdname{GFtoDVI}\null}
-\def\GFtoPK{\cmdname{GFtoPK}\null}
-\def\GFtype{\cmdname{GFtype}}
-\def\GUI{\acro{GUI}\xspace}
-\def\KPS{Kpathsea}
-\def\La{La}
-\def\OMEGA{$\Omega$}
-\def\OzMF{OzMF}
-\def\OzMP{OzMP}
-\def\OzTeX{O\kern-.03em z\kern-.15em\TeX}
-\def\PKtype{\cmdname{PKtype}}
-\def\PLtoTF{\cmdname{PLtoTF}\null}
-\def\ProTeXt{Pro\TeX t}
-\def\teTeX{\textrm{te}\TeX\xspace}
-\def\TeXLive{\TeX{} Live\xspace}
-\def\TFtoPL{\cmdname{TFtoPL}\null}
-\def\TK{\TeX\ Collection}
-\let\TL=\TeXLive
-\def\TypeI{Type~1}
-\def\VFtoVP{\cmdname{VFtoVP}\null}
-\def\VPtoVF{\cmdname{VPtoVF}\null}
-\def\Thanh{H\`an~Th\ifx % get Unicode char in tex4ht's HTML output
- \HCode\UnDef\^e\llap{\raise 0.5ex\hbox{\'{}}}\else
- \HCode{\string&\#x1EBF;}\fi~Th\`anh}
-\def\XEmTeX{\textrm{XEm}\TeX\xspace}
-\def\XEmacs{\textrm{XEmacs}\xspace}
-\def\XeTeX{Xe\TeX\xspace}
-\def\Webc{Web2C}
-\providecommand*{\CD}{\acro{CD}\xspace}
-\providecommand*{\CTAN}{\acro{CTAN}\xspace}
-\providecommand*{\DVD}{\acro{DVD}\xspace}
-\providecommand*{\GNU}{\acro{GNU}\xspace}
-\providecommand*{\HTML}{\acro{HTML}\xspace}
-\providecommand*{\ISO}{\acro{ISO}\xspace}
-\providecommand*{\MacOSX}{Mac\,\acro{OS\,X}\xspace}
-\providecommand*{\PS}{Post\-Script\xspace}
-\providecommand*{\TDS}{\acro{TDS}\xspace}
-\providecommand*{\dvi}{\acro{DVI}\xspace}
-\providecommand*{\web}{\texttt{WEB}\xspace}
-
-% Include an image.
-% #1 - name of image (pictures/#1.jpg, always .jpg please)
-% #2 - bb for html
-% #3 - width for TeX
-%
-\def\tlimage#1#2#3{%
- \ifnum \Status=2 % html, want relative path in output
- \includegraphics[#2]{../../general/texlive-common/pictures/#1.jpg}
- \else % not html, handled by TEXINPUTS in Makefile
- \includegraphics[width=#3]{pictures/#1.jpg}
- \fi
- \\[5mm]
-}
-
-\def\tlpng#1#2{%
- \ifnum \Status=2 % html, want relative path in output
- \includegraphics[bb=0 0 1 1]{#1.png}%
- \else % not html, handled by TEXINPUTS in Makefile
- \includegraphics[width=#2]{#1.png}%
- \fi
-}
-%
-% description-like environment that uses tt instead of bf, and doesn't
-% go to the left margin. Without the \hfil, get an underfull box.
-% Don't know why \descriptionlabel doesn't.
-%
-\newenvironment{ttdescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt % these lists tend to have short descriptions
- \parindent=0pt
- \let\makelabel=\ttdescriptionlabel}}%
- {\end{list}}
-\newcommand*\ttdescriptionlabel[1]{\hspace\labelsep
- \normalfont\ttfamily #1\hfil}
-%
-% Likewise, for commands using sans serif.
-\newenvironment{cmddescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt
- \let\makelabel=\cmddescriptionlabel}}%
- {\end{list}}
-\newcommand*\cmddescriptionlabel[1]{\hspace\labelsep
- \normalfont\sffamily #1\hfil}
-
-% General squeezed itemize.
-\newenvironment{itemize*}%
- {\begin{itemize}%
- \setlength{\itemsep}{0pt}%
- \setlength{\parskip}{0pt}}%
- {\end{itemize}}
-
-\newsavebox{\wbox}
-\newenvironment{warningbox}
- {\begin{lrbox}{\wbox}
- \begin{minipage}{.95\textwidth}}
- {\end{minipage}\end{lrbox}\fbox{\usebox{\wbox}}}
-%
-% lrbox is used as a representation marking. I changed it to
-% lrBox in tne source file, to get closer to logical marking
-\newsavebox{\mylrbox}
-\newenvironment{lrBox}
- {\begin{lrbox}{\mylrbox}}
- {\end{lrbox}}
-
-
-% emacs-page output setup
-%
-\ifx \HCode\UnDef
- \providecommand{\Status}{0}% running TeX
-\else
- \providecommand{\Status}{2}% running TeX4ht
-\fi
-%\typeout{Status is \Status}
-%
-\newif\ifSingleColumn
-%
-% By default, we won't be creating hyperlinks.
-\def\href#1#2{#2}
-\def\hypertarget#1#2{}
-\def\email#1{\href{mailto:#1}{\path{#1}}} % \path comes from url
-%
-\definecolor{hypercolor}{rgb}{0.5,0.0,0.5} % purplish external links.
-%
-%
-\ifcase\Status
- % \Status = 0
- \typeout{TeX Live documentation in DVI format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 1
- \typeout{TeX Live documentation in PDF format}
- \RequirePackage[breaklinks,
- colorlinks,linkcolor=hypercolor,citecolor=hypercolor,
- urlcolor=hypercolor,filecolor=hypercolor,
- bookmarksopen,
- %pdfstartview={FitBH -320000}, % fails with acrobat7
- hyperindex]
- {hyperref}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 2
- \typeout{TeX Live documentation in HTML format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- % read our config file, live4ht.cfg; q.v., for more definitions.
- % hyperref load must come after the tex4ht load.
- \RequirePackage[live4ht]{tex4ht}
- \RequirePackage[tex4ht]{hyperref} \hyperlinkfileprefix{}
- % definitions need simplifying for TeX4ht to make relative paths work.
- \def\CDref#1#2{\href{../../../../#1}{#2}}
- \def\OnCD#1{\href{../../../../#1}{#1}}
- \or
- % \Status = 3
- \typeout{TeX Live documentation as a Baskerville issue}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \RequirePackage{bvoutln}% outline of baskerville
- \SingleColumnfalse
- \RequirePackage{multicol}
- \or
- % \Status = 4
- \typeout{TeX Live documentation as a TUB article}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \SingleColumnfalse
- \newenvironment{multicols}[1]{}{}
-\fi
-%
-\ifnum \Status=4
-\else
- \RequirePackage{texnames}
- \providecommand\TeXXeT{\TeX-{}-%
- \kern-.1emX\kern-.125em\lower.5ex\hbox{E}\kern-.1667emT\@}
- \def\MP{MetaPost}
- \let\mf\MF
- \newcommand\ConTeXt{C\kern-.0333emon\-\kern-.0667em\TeX\kern-.0333emt}
- \newcommand\MIKTEX{MiK\kern-.025em \TeX}% per www.miktex.org
- % from pictex.tex:
- \ifx\PiC\undefined \def\PiC{P\kern-.12em\lower.5ex\hbox{I}\kern-.075emC} \fi
- \ifx\PiCTeX\undefined \def\PiCTeX{\PiC\kern-.11em\TeX} \fi
-\fi
-%
-% hacking at sections etc., to pay attention to baskerville status
-\newcommand{\@condend@multicols}{%
- \ifSingleColumn
- \else
- \def\@tempa{multicols}%
- \ifx\@tempa\@currenvir
- \end{multicols}%
- \fi
- \fi
-}
-\let\Section\section
-\renewcommand{\section}{%
- \@ifstar
- {\Section*}%
- {%
- \@condend@multicols
- \@dblarg\@full@section
- }%
-}
-\def\@full@section[#1]#2{%
- \Section[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-\let\SubSection\subsection
-\renewcommand{\subsection}{%
- \@ifstar{\SubSection*}%
- {%
- \@condend@multicols
- \@dblarg\@full@subsection
- }
-}
-\def\@full@subsection[#1]#2{%
- \SubSection[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-
-% calm things down a bit if we're in a multiple-column version
-\ifSingleColumn
-\else
- \def\@listI{\leftmargin\leftmargini
- \parsep \z@
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \itemsep \z@ \@plus .1\p@
- }
- \let\@listi\@listI
- \@listi
- \def\@listii{\leftmargin\leftmarginii
- \labelwidth\leftmarginii\advance\labelwidth-\labelsep
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \itemsep \z@ \@plus .1\p@
- }
- \def\@listiii{\leftmargin\leftmarginiii
- \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
- \topsep 1\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \partopsep \z@
- \itemsep \topsep
- }
- \def\@listiv{\leftmargin\leftmarginiv
- \labelwidth\leftmarginiv\advance\labelwidth-\labelsep
- }
- \def\@listv{\leftmargin\leftmarginv
- \labelwidth\leftmarginv\advance\labelwidth-\labelsep
- }
- \def\@listvi{\leftmargin\leftmarginvi
- \labelwidth\leftmarginvi\advance\labelwidth-\labelsep
- }
-\fi
-%
-% array package stuff
-\def\arraybackslash{\let\\=\@arraycr}
-\newcolumntype{P}[1]{>{\raggedright\arraybackslash}p{#1}}
-%
-% shaded rows (using facilities of colortbl)
-%
-\definecolor{pale}{gray}{.9}
-\newcount\colrow
-\gdef\RowColor{pale}
-\def\SetRowColor{%
- \rowcolor{\RowColor}%
- \global\advance\colrow by1\relax
- \ifodd\colrow
- \gdef\RowColor{pale}%
- \else
- \gdef\RowColor{white}%
- \fi
-}
-% redefine to hack up a reference even though we don't need it...
-\renewcommand\@bibitem[1]{\if@filesw \immediate\write\@auxout
- {\string\bibcite{#1}{?}}\fi\ignorespaces}
-%
-% \unknownTeXlive is a dummy texlive entry for the biblio
-\newcommand\unknownTeXlive[2][\relax]{\textbf{\textsc{unknown}}%
- \global\@all@unknown\expandafter{\the\@all@unknown{#2}}%
-}
-\newtoks\@all@unknown
-\global\@all@unknown{}
-\AtEndDocument{\@message@unknowns}
-\def\@message@unknowns{\edef\@tempa{\the\@all@unknown}%
- \ifx\@tempa\@empty
- \else
- \def\@tempa{*** TeX live package location of }%
- \expandafter\@output@unknowns\the\@all@unknown\@empty
- \fi
-}
-\def\@output@unknowns#1{\edef\@tempb{#1}%
- \ifx\@tempb\@empty
- \typeout{ unknown}%
- \else
- \message{\@tempa#1,}%
- \def\@tempa{}%
- \expandafter\@output@unknowns
- \fi
-}
-
-
-% Silence font warnings about no bold typewriter in LM.
-\def\@font@warning#1{}%
-
-% Silence hyperref warnings about \kern.
-\def\HyPsd@Warning#1{}%
-
-\endinput
diff --git a/Master/texmf-doc/source/texlive/texlive-en/archive/texlive.pl b/Master/texmf-doc/source/texlive/texlive-en/archive/texlive.pl
deleted file mode 100644
index 33a19a801d6..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/archive/texlive.pl
+++ /dev/null
@@ -1,574 +0,0 @@
-$texlive{"a0poster"}="latex3";
-$texlive{"aaai"}="latex3";
-$texlive{"abstyles"}="bibtex3";
-$texlive{"accfonts"}="fonts3";
-$texlive{"achemso"}="latex3";
-$texlive{"acronym"}="latex3";
-$texlive{"adfathesis"}="latex3";
-$texlive{"adobeother"}="fonts3";
-$texlive{"adobestd"}="fonts1";
-$texlive{"adrlist"}="latex3";
-$texlive{"ae"}="fonts2";
-$texlive{"aguplus"}="latex3";
-$texlive{"aiaa"}="latex3";
-$texlive{"akletter"}="latex3";
-$texlive{"alatex"}="formats3";
-$texlive{"alg"}="latex3";
-$texlive{"algorithms"}="latex3";
-$texlive{"alphaev5-osf4.0d"}="systems1";
-$texlive{"alphaev5-osf4.0d"}="systems2";
-$texlive{"alphaev5-osf4.0d"}="systems3";
-$texlive{"altfont"}="latex3";
-$texlive{"amsfonts"}="fonts2";
-$texlive{"amslatex"}="latex2";
-$texlive{"amstex"}="plain2";
-$texlive{"answers"}="latex3";
-$texlive{"antyktor"}="fonts3";
-$texlive{"apa"}="latex3";
-$texlive{"apl"}="fonts3";
-$texlive{"appendix"}="latex3";
-$texlive{"ar"}="fonts3";
-$texlive{"arabtex"}="lang3";
-$texlive{"arydshln"}="latex3";
-$texlive{"asaetr"}="latex3";
-$texlive{"ascii"}="fonts3";
-$texlive{"astro"}="fonts3";
-$texlive{"aurora"}="dvips3";
-$texlive{"authorindex"}="latex3";
-$texlive{"autotab"}="latex3";
-$texlive{"babel"}="generic2";
-$texlive{"backgammon"}="fonts3";
-$texlive{"bakoma"}="fonts2";
-$texlive{"barcode2"}="fonts3";
-$texlive{"barcodes"}="fonts3";
-$texlive{"barr"}="graphics3";
-$texlive{"bbding"}="fonts3";
-$texlive{"bbm"}="fonts3";
-$texlive{"bbold"}="fonts3";
-$texlive{"bbtbase"}="bibtex1";
-$texlive{"bbtdoc"}="bibtex2";
-$texlive{"beebe"}="bibtex2";
-$texlive{"belleek"}="fonts2";
-$texlive{"beton"}="latex3";
-$texlive{"bez123"}="latex3";
-$texlive{"bezos"}="latex3";
-$texlive{"bibarts"}="bibtex3";
-$texlive{"biblist"}="latex3";
-$texlive{"blue"}="formats3";
-$texlive{"bluesky"}="fonts1";
-$texlive{"booktabs"}="latex2";
-$texlive{"borceux"}="graphics3";
-$texlive{"bosisio"}="latex3";
-$texlive{"bridge"}="latex3";
-$texlive{"brushscr"}="fonts3";
-$texlive{"c-pascal"}="generic3";
-$texlive{"calendar"}="latex3";
-$texlive{"calligra"}="fonts3";
-$texlive{"calrsfs"}="latex3";
-$texlive{"camel"}="latex3";
-$texlive{"caption"}="latex2";
-$texlive{"carlisle"}="latex2";
-$texlive{"casyl"}="lang3";
-$texlive{"catalog"}="doc2";
-$texlive{"cbgreek"}="fonts3";
-$texlive{"cc-pl"}="fonts2";
-$texlive{"ccaption"}="latex3";
-$texlive{"ccfonts"}="latex3";
-$texlive{"cchess"}="fonts3";
-$texlive{"cdcover"}="latex3";
-$texlive{"cellular"}="plain3";
-$texlive{"changebar"}="latex2";
-$texlive{"chemcono"}="latex3";
-$texlive{"chemsym"}="latex3";
-$texlive{"cheq"}="fonts3";
-$texlive{"cherokee"}="fonts3";
-$texlive{"chess"}="fonts3";
-$texlive{"china2e"}="latex3";
-$texlive{"circ"}="graphics3";
-$texlive{"cirth"}="fonts3";
-$texlive{"cite"}="latex2";
-$texlive{"cjk"}="lang3";
-$texlive{"cm"}="fonts1";
-$texlive{"cmbright"}="fonts2";
-$texlive{"cmcyr"}="fonts3";
-$texlive{"cmcyralt"}="latex3";
-$texlive{"cmdtrack"}="latex2";
-$texlive{"cmextra"}="fonts2";
-$texlive{"cmpica"}="fonts3";
-$texlive{"cmpk"}="fonts3";
-$texlive{"cmsd"}="latex3";
-$texlive{"codepage"}="latex3";
-$texlive{"colorsep"}="dvips3";
-$texlive{"colortab"}="plain3";
-$texlive{"comment"}="latex3";
-$texlive{"concmath"}="fonts3";
-$texlive{"concrete"}="fonts3";
-$texlive{"context"}="formats2";
-$texlive{"covington"}="latex3";
-$texlive{"croatian"}="lang3";
-$texlive{"crop"}="latex3";
-$texlive{"crossword"}="latex3";
-$texlive{"crosswrd"}="latex3";
-$texlive{"csfonts"}="fonts2";
-$texlive{"cslatex"}="lang2";
-$texlive{"csplain"}="lang2";
-$texlive{"cspsfonts"}="fonts2";
-$texlive{"cstug"}="doc3";
-$texlive{"cursor"}="latex3";
-$texlive{"curves"}="graphics3";
-$texlive{"custom-bib"}="bibtex2";
-$texlive{"cyrillic"}="lang2";
-$texlive{"dancers"}="fonts3";
-$texlive{"deleq"}="latex3";
-$texlive{"devanagari"}="lang3";
-$texlive{"dialogl"}="latex3";
-$texlive{"dinbrief"}="latex3";
-$texlive{"directory"}="bibtex3";
-$texlive{"dotseqn"}="latex3";
-$texlive{"draftcopy"}="latex3";
-$texlive{"dratex"}="graphics3";
-$texlive{"dropping"}="latex3";
-$texlive{"dstroke"}="fonts3";
-$texlive{"dtk"}="latex3";
-$texlive{"duerer"}="fonts3";
-$texlive{"dvipdfm"}="doc2";
-$texlive{"dvipsbase"}="dvips1";
-$texlive{"dvipsdoc"}="dvips2";
-$texlive{"ean"}="generic3";
-$texlive{"easy"}="latex3";
-$texlive{"ec"}="fonts2";
-$texlive{"ecc"}="fonts3";
-$texlive{"ecltree"}="latex2";
-$texlive{"eco"}="fonts3";
-$texlive{"ecpk"}="fonts3";
-$texlive{"edmac"}="plain3";
-$texlive{"eepic"}="graphics2";
-$texlive{"egplot"}="latex3";
-$texlive{"eiad"}="fonts3";
-$texlive{"eijkhout"}="generic3";
-$texlive{"elsevier"}="latex3";
-$texlive{"elvish"}="fonts3";
-$texlive{"emp"}="latex3";
-$texlive{"emulateapj"}="latex3";
-$texlive{"encodings"}="omega2";
-$texlive{"endfloat"}="latex3";
-$texlive{"engwar"}="fonts3";
-$texlive{"envbig"}="latex3";
-$texlive{"envlab"}="latex3";
-$texlive{"epigraph"}="latex3";
-$texlive{"eplain"}="formats2";
-$texlive{"eqname"}="latex3";
-$texlive{"eqnarray"}="latex3";
-$texlive{"esieecv"}="latex3";
-$texlive{"etexbase"}="etex2";
-$texlive{"etruscan"}="fonts3";
-$texlive{"euler"}="latex3";
-$texlive{"euro"}="fonts2";
-$texlive{"euro2"}="latex3";
-$texlive{"eurofont"}="fonts2";
-$texlive{"europs"}="fonts2";
-$texlive{"eurosans"}="latex3";
-$texlive{"eurosym"}="fonts2";
-$texlive{"euxm"}="fonts3";
-$texlive{"exam"}="latex3";
-$texlive{"examdesign"}="latex3";
-$texlive{"expdlist"}="latex3";
-$texlive{"expl3"}="latex3";
-$texlive{"export"}="latex3";
-$texlive{"fancybox"}="latex2";
-$texlive{"fancyhdr"}="latex2";
-$texlive{"fancyref"}="latex2";
-$texlive{"fancyvrb"}="latex2";
-$texlive{"fax"}="latex3";
-$texlive{"fc"}="fonts3";
-$texlive{"feynmf"}="graphics3";
-$texlive{"finbib"}="bibtex3";
-$texlive{"float"}="latex2";
-$texlive{"floatfig"}="latex3";
-$texlive{"floatflt"}="latex3";
-$texlive{"fltpage"}="latex3";
-$texlive{"fncychap"}="latex3";
-$texlive{"foilhtml"}="latex3";
-$texlive{"foiltex"}="latex3";
-$texlive{"fontinst"}="generic2";
-$texlive{"fontname"}="doc2";
-$texlive{"footbib"}="latex3";
-$texlive{"footmisc"}="latex2";
-$texlive{"footnpag"}="latex3";
-$texlive{"formats"}="texlive2";
-$texlive{"formula"}="latex3";
-$texlive{"fp"}="latex3";
-$texlive{"frankenstein"}="latex3";
-$texlive{"french"}="lang2";
-$texlive{"fribrief"}="latex3";
-$texlive{"fullblck"}="latex3";
-$texlive{"fullpict"}="latex3";
-$texlive{"fundus"}="latex3";
-$texlive{"futhark"}="fonts3";
-$texlive{"g-brief"}="latex3";
-$texlive{"gb4e"}="latex3";
-$texlive{"genealogy"}="fonts3";
-$texlive{"general"}="doc1";
-$texlive{"genmisc"}="generic3";
-$texlive{"geometry"}="latex3";
-$texlive{"geomsty"}="latex3";
-$texlive{"german"}="lang2";
-$texlive{"germbib"}="bibtex2";
-$texlive{"germdoc"}="doc2";
-$texlive{"gloss"}="latex3";
-$texlive{"gn-logic"}="latex3";
-$texlive{"go"}="fonts3";
-$texlive{"gothic"}="fonts3";
-$texlive{"graphics"}="latex1";
-$texlive{"greek6cbc"}="fonts3";
-$texlive{"grnumalt"}="latex3";
-$texlive{"grtimes"}="lang3";
-$texlive{"guides"}="doc2";
-$texlive{"gustlib"}="plain2";
-$texlive{"hands"}="fonts3";
-$texlive{"hanging"}="latex3";
-$texlive{"harpoon"}="latex3";
-$texlive{"harvard"}="bibtex2";
-$texlive{"harvmac"}="plain3";
-$texlive{"hh"}="latex3";
-$texlive{"hilowres"}="latex3";
-$texlive{"histogr"}="latex3";
-$texlive{"hoekwater"}="fonts2";
-$texlive{"hppa1.1-hpux10.10"}="systems1";
-$texlive{"hppa1.1-hpux10.10"}="systems2";
-$texlive{"hppa1.1-hpux10.10"}="systems3";
-$texlive{"html"}="doc2";
-$texlive{"hvmaths"}="fonts3";
-$texlive{"hyper"}="latex3";
-$texlive{"hyperref"}="latex2";
-$texlive{"hyphen"}="lang1";
-$texlive{"hyphenat"}="latex3";
-$texlive{"i386-linux"}="systems1";
-$texlive{"i386-linux"}="systems2";
-$texlive{"i386-linux"}="systems3";
-$texlive{"i386-linux-libc5"}="systems1";
-$texlive{"i386-linux-libc5"}="systems2";
-$texlive{"i386-linux-libc5"}="systems3";
-$texlive{"ibm"}="fonts3";
-$texlive{"ieeepes"}="latex3";
-$texlive{"ifacmtg"}="latex3";
-$texlive{"imac"}="latex3";
-$texlive{"indxcite"}="latex3";
-$texlive{"info"}="doc2";
-$texlive{"ini"}="texlive1";
-$texlive{"insbox"}="generic3";
-$texlive{"ipa"}="latex3";
-$texlive{"isostds"}="latex3";
-$texlive{"jadetex"}="formats2";
-$texlive{"jhep"}="latex3";
-$texlive{"jknappen"}="latex2";
-$texlive{"jsmisc"}="plain3";
-$texlive{"jura"}="latex3";
-$texlive{"kalender"}="latex3";
-$texlive{"karnaugh"}="latex3";
-$texlive{"kdgreek"}="fonts3";
-$texlive{"kluwer"}="latex3";
-$texlive{"knuth"}="doc3";
-$texlive{"koma-script"}="latex3";
-$texlive{"kuvio"}="graphics3";
-$texlive{"labels"}="latex3";
-$texlive{"lamstex"}="formats3";
-$texlive{"lastpage"}="latex3";
-$texlive{"latexfonts"}="latex1";
-$texlive{"layouts"}="latex3";
-$texlive{"leaflet"}="latex3";
-$texlive{"leftidx"}="latex3";
-$texlive{"lettrine"}="latex3";
-$texlive{"levy"}="latex3";
-$texlive{"lgc"}="doc3";
-$texlive{"lgreek"}="latex3";
-$texlive{"lh"}="fonts2";
-$texlive{"lhcyr"}="latex3";
-$texlive{"lineno"}="latex3";
-$texlive{"linguex"}="latex3";
-$texlive{"listings"}="latex3";
-$texlive{"lkort"}="doc3";
-$texlive{"localloc"}="latex3";
-$texlive{"logic"}="fonts3";
-$texlive{"lollipop"}="formats3";
-$texlive{"ltablex"}="latex3";
-$texlive{"ltx2rtf"}="texlive2";
-$texlive{"ltxbase"}="latex1";
-$texlive{"ltxdoc"}="doc2";
-$texlive{"ltxdoc"}="latex1";
-$texlive{"ltxmisc"}="latex2";
-$texlive{"lucida"}="fonts2";
-$texlive{"ly1"}="latex3";
-$texlive{"mailing"}="latex3";
-$texlive{"makeindex"}="doc1";
-$texlive{"malayalam"}="lang3";
-$texlive{"malvern"}="fonts3";
-$texlive{"mapcodes"}="latex3";
-$texlive{"maple"}="latex3";
-$texlive{"margbib"}="latex3";
-$texlive{"marvosym"}="fonts3";
-$texlive{"mathcomp"}="latex2";
-$texlive{"mathematica"}="fonts3";
-$texlive{"mathpple"}="fonts3";
-$texlive{"mcite"}="latex3";
-$texlive{"mdwtools"}="latex3";
-$texlive{"metasupp"}="texlive1";
-$texlive{"method"}="latex3";
-$texlive{"mex"}="lang2";
-$texlive{"mff"}="latex3";
-$texlive{"mflogo"}="latex2";
-$texlive{"mfmisc"}="fonts1";
-$texlive{"mfnfss"}="latex2";
-$texlive{"mfpic"}="graphics3";
-$texlive{"mft"}="texlive1";
-$texlive{"mftoeps"}="fonts3";
-$texlive{"mhs"}="latex3";
-$texlive{"midnight"}="generic3";
-$texlive{"minitoc"}="latex3";
-$texlive{"mips-irix6.2"}="systems1";
-$texlive{"mips-irix6.2"}="systems2";
-$texlive{"mips-irix6.2"}="systems3";
-$texlive{"misc209"}="latex2";
-$texlive{"mltex"}="latex2";
-$texlive{"mnras"}="plain3";
-$texlive{"monotype"}="fonts3";
-$texlive{"montex"}="lang3";
-$texlive{"morehelp"}="latex3";
-$texlive{"moresize"}="latex3";
-$texlive{"moreverb"}="latex3";
-$texlive{"morse"}="fonts3";
-$texlive{"mpattern"}="metapost2";
-$texlive{"mpbase"}="metapost1";
-$texlive{"mpfnmark"}="latex3";
-$texlive{"ms"}="latex3";
-$texlive{"mslapa"}="latex3";
-$texlive{"mtbe"}="plain3";
-$texlive{"multenum"}="latex3";
-$texlive{"multi"}="dvips3";
-$texlive{"multirow"}="latex3";
-$texlive{"musictex"}="generic3";
-$texlive{"musixtex"}="generic3";
-$texlive{"nassflow"}="latex3";
-$texlive{"natbib"}="bibtex2";
-$texlive{"ncctools"}="latex2";
-$texlive{"newalg"}="latex3";
-$texlive{"newlfm"}="latex3";
-$texlive{"newsletr"}="plain3";
-$texlive{"newthm"}="latex3";
-$texlive{"niceframe"}="latex3";
-$texlive{"nomencl"}="latex3";
-$texlive{"nrc"}="latex3";
-$texlive{"ntg"}="doc3";
-$texlive{"ntgclass"}="latex2";
-$texlive{"ntheorem"}="latex3";
-$texlive{"numline"}="latex3";
-$texlive{"objectz"}="latex3";
-$texlive{"oca"}="fonts3";
-$texlive{"ocr-a"}="fonts3";
-$texlive{"ogham"}="fonts3";
-$texlive{"ogonek"}="latex3";
-$texlive{"oldstyle"}="latex3";
-$texlive{"omegabase"}="omega2";
-$texlive{"omegafonts"}="omega2";
-$texlive{"osmanian"}="fonts3";
-$texlive{"ot2cyr"}="fonts2";
-$texlive{"overpic"}="latex3";
-$texlive{"pacioli"}="fonts3";
-$texlive{"pageno"}="latex3";
-$texlive{"pandora"}="fonts3";
-$texlive{"paper"}="latex3";
-$texlive{"paralist"}="latex3";
-$texlive{"parallel"}="latex3";
-$texlive{"patch"}="latex2";
-$texlive{"pawpict"}="latex3";
-$texlive{"pb-diagram"}="latex3";
-$texlive{"pdcmac"}="plain3";
-$texlive{"pdfscreen"}="latex3";
-$texlive{"pdftex"}="pdftex2";
-$texlive{"permute"}="latex3";
-$texlive{"phoenician"}="fonts3";
-$texlive{"phonetic"}="fonts3";
-$texlive{"physe"}="formats3";
-$texlive{"phyzzx"}="formats3";
-$texlive{"picinpar"}="latex3";
-$texlive{"picins"}="latex3";
-$texlive{"pictex"}="graphics2";
-$texlive{"piff"}="latex3";
-$texlive{"pl"}="latex3";
-$texlive{"pl-qx"}="fonts2";
-$texlive{"plainmisc"}="plain1";
-$texlive{"plaintex"}="plain1";
-$texlive{"plari"}="latex3";
-$texlive{"platex"}="lang2";
-$texlive{"play"}="latex3";
-$texlive{"plcalendar"}="plain3";
-$texlive{"plfonts"}="fonts2";
-$texlive{"plgraph"}="generic3";
-$texlive{"plpatch"}="plain3";
-$texlive{"pmgraph"}="latex3";
-$texlive{"poligraf"}="generic3";
-$texlive{"polish"}="doc3";
-$texlive{"polyglot"}="latex3";
-$texlive{"prettyref"}="latex3";
-$texlive{"progkeys"}="latex3";
-$texlive{"program"}="latex3";
-$texlive{"proofs"}="latex3";
-$texlive{"protex"}="generic3";
-$texlive{"psafm"}="fonts3";
-$texlive{"psfig"}="generic3";
-$texlive{"psfrag"}="graphics2";
-$texlive{"psizzl"}="formats3";
-$texlive{"pslatex"}="latex2";
-$texlive{"psnfss"}="latex1";
-$texlive{"psnfssx"}="latex2";
-$texlive{"pspicture"}="latex2";
-$texlive{"pstricks"}="graphics2";
-$texlive{"punk"}="fonts3";
-$texlive{"qfonts"}="fonts2";
-$texlive{"qobitree"}="graphics3";
-$texlive{"qsymbols"}="latex3";
-$texlive{"quotchap"}="latex3";
-$texlive{"r-und-s"}="latex3";
-$texlive{"rcs"}="latex3";
-$texlive{"rcsinfo"}="latex3";
-$texlive{"realcalc"}="generic3";
-$texlive{"refcheck"}="latex3";
-$texlive{"refman"}="latex3";
-$texlive{"relenc"}="latex3";
-$texlive{"revtex"}="latex2";
-$texlive{"rlepsf"}="generic3";
-$texlive{"rmpage"}="latex3";
-$texlive{"rotating"}="latex2";
-$texlive{"rotfloat"}="latex3";
-$texlive{"rplain"}="latex3";
-$texlive{"rs6000-aix4.1.4.0"}="systems1";
-$texlive{"rs6000-aix4.1.4.0"}="systems2";
-$texlive{"rs6000-aix4.1.4.0"}="systems3";
-$texlive{"rsfs"}="fonts2";
-$texlive{"ruhyphen"}="lang1";
-$texlive{"runic"}="fonts3";
-$texlive{"sanskrit"}="fonts3";
-$texlive{"sauterfonts"}="latex3";
-$texlive{"scale"}="latex3";
-$texlive{"schedule"}="latex3";
-$texlive{"script"}="latex3";
-$texlive{"sectsty"}="latex3";
-$texlive{"semantic"}="latex3";
-$texlive{"seminar"}="latex2";
-$texlive{"setspace"}="latex3";
-$texlive{"shadbox"}="latex3";
-$texlive{"shadethm"}="latex3";
-$texlive{"shortlst"}="latex3";
-$texlive{"shorttoc"}="latex3";
-$texlive{"showdim"}="latex3";
-$texlive{"showlabels"}="latex3";
-$texlive{"siam"}="generic3";
-$texlive{"sidecap"}="latex3";
-$texlive{"siggraph"}="latex3";
-$texlive{"simpsons"}="fonts3";
-$texlive{"siunits"}="latex3";
-$texlive{"slashbox"}="latex3";
-$texlive{"slidenotes"}="latex3";
-$texlive{"smallcap"}="latex3";
-$texlive{"songbook"}="latex3";
-$texlive{"soul"}="latex3";
-$texlive{"sparc-solaris2.5.1"}="systems1";
-$texlive{"sparc-solaris2.5.1"}="systems2";
-$texlive{"sparc-solaris2.5.1"}="systems3";
-$texlive{"sprite"}="graphics3";
-$texlive{"ssqquote"}="latex3";
-$texlive{"startex"}="formats3";
-$texlive{"stdclsdv"}="latex3";
-$texlive{"stmaryrd"}="fonts2";
-$texlive{"subeqn"}="latex3";
-$texlive{"subeqnarray"}="latex3";
-$texlive{"subfigure"}="latex3";
-$texlive{"supertabular"}="latex3";
-$texlive{"synttree"}="latex3";
-$texlive{"t2"}="lang3";
-$texlive{"tabbing"}="latex3";
-$texlive{"tap"}="generic2";
-$texlive{"taylor"}="graphics3";
-$texlive{"tbe"}="plain3";
-$texlive{"tcx"}="texlive1";
-$texlive{"tds"}="doc1";
-$texlive{"tengwar"}="fonts3";
-$texlive{"tetex"}="doc1";
-$texlive{"tex-ps"}="generic2";
-$texlive{"tex4ht"}="latex2";
-$texlive{"texdraw"}="graphics3";
-$texlive{"texinfo"}="plain2";
-$texlive{"texip"}="formats3";
-$texlive{"texlive"}="texlive1";
-$texlive{"texsis"}="formats3";
-$texlive{"text1"}="formats3";
-$texlive{"textfit"}="latex3";
-$texlive{"textmerg"}="latex3";
-$texlive{"textpos"}="latex3";
-$texlive{"thesis"}="latex3";
-$texlive{"threed"}="metapost2";
-$texlive{"thumb"}="latex3";
-$texlive{"thumbpdf"}="latex3";
-$texlive{"timesht"}="latex3";
-$texlive{"timing"}="latex3";
-$texlive{"tipa"}="fonts2";
-$texlive{"titlefoot"}="latex3";
-$texlive{"titlesec"}="latex3";
-$texlive{"tmmaths"}="fonts3";
-$texlive{"tocbibind"}="latex3";
-$texlive{"tocloft"}="latex3";
-$texlive{"tocvsec2"}="latex3";
-$texlive{"tools"}="latex1";
-$texlive{"tracking"}="latex3";
-$texlive{"treesvr"}="latex3";
-$texlive{"treetex"}="plain3";
-$texlive{"ttf2pk"}="texlive2";
-$texlive{"tug"}="doc3";
-$texlive{"tugboat"}="generic2";
-$texlive{"type1"}="fonts2";
-$texlive{"type1cm"}="latex3";
-$texlive{"typespec"}="plain3";
-$texlive{"uaclasses"}="latex3";
-$texlive{"ucthesis"}="latex3";
-$texlive{"ulsy"}="latex3";
-$texlive{"umlaute"}="latex3";
-$texlive{"umrand"}="fonts3";
-$texlive{"underlin"}="latex3";
-$texlive{"uni"}="fonts3";
-$texlive{"units"}="latex3";
-$texlive{"universa"}="fonts3";
-$texlive{"unsupported"}="fonts3";
-$texlive{"urwstd"}="fonts2";
-$texlive{"useful"}="doc2";
-$texlive{"ut-thesis"}="latex3";
-$texlive{"utthesis"}="latex3";
-$texlive{"uwthesis"}="latex3";
-$texlive{"vdm"}="latex3";
-$texlive{"vector"}="latex3";
-$texlive{"vertex"}="plain3";
-$texlive{"vita"}="latex3";
-$texlive{"vrb"}="latex3";
-$texlive{"vrsion"}="latex3";
-$texlive{"warpcol"}="latex3";
-$texlive{"wasy"}="fonts2";
-$texlive{"wasysym"}="latex2";
-$texlive{"williams"}="latex3";
-$texlive{"win32"}="systems1";
-$texlive{"win32"}="systems2";
-$texlive{"win32"}="systems3";
-$texlive{"windvi"}="doc1";
-$texlive{"wnri"}="fonts3";
-$texlive{"wntamil"}="lang3";
-$texlive{"wsuipa"}="fonts2";
-$texlive{"xtab"}="latex3";
-$texlive{"xtcapts"}="latex3";
-$texlive{"xymtex"}="latex3";
-$texlive{"xypic"}="graphics2";
-$texlive{"yannisgr"}="fonts3";
-$texlive{"yfonts"}="latex3";
-$texlive{"yhmath"}="latex3";
-$texlive{"yi4latex"}="lang3";
-$texlive{"youngtab"}="latex3";
-$texlive{"ytex"}="formats3";
-$texlive{"zed-csp"}="latex3";
-$texlive{"zefonts"}="fonts2";
diff --git a/Master/texmf-doc/source/texlive/texlive-en/live4ht.cfg b/Master/texmf-doc/source/texlive/texlive-en/live4ht.cfg
deleted file mode 100644
index 3435925813d..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/live4ht.cfg
+++ /dev/null
@@ -1,51 +0,0 @@
-% tex4ht configuration file for the TeX Live documentation.
-% Accumulated over many years. Public domain.
-%
-% html specifies the main output format.
-% info for extra debugging info in the log files.
-
-% have html in one piece (including footnotes).
-\Preamble{charset=iso-8859-1,html,info,fn-in}
-
-% add extra stylesheet
-\Configure{@HEAD}{\HCode{%
-<link rel="stylesheet" type="text/css" href="\jobname.css" />\Hnewline
-<link rel="stylesheet" type="text/css" href="tex-live.css" />\Hnewline
-}}
-% use png graphics as-is
-\Configure{graphics*}
- {png}
- {\Needs{""}%
- \Picture[pict]{\csname Gin@base\endcsname.png}%
- }
-% or LaTeX complains it is missing.
-\begin{document}
-
-\EndPreamble
-
-% simplify output for HTML. We leave TeX and LaTeX alone, since tex4ht
-% actually does the lowered E (and raised A) in CSS.
-\def\OMEGA{Omega}
-\def\LaTeXe{LaTeX2e}
-\def\eTeX{e-\TeX}
-\def\acro#1{#1}
-\def\MF{Metafont}
-\def\BibTeX{BibTeX}
-\def\warningbox{}
-\def\endwarningbox{}
-
-\newif\ifhackliterals
-\ifx\tldocenglish\undefined \else \hackliteralstrue \fi
-\ifx\tldocrussian\undefined \else \hackliteralstrue \fi
-\ifx\tldocgerman\undefined \else \hackliteralstrue \fi
-%
-\ifhackliterals
- % these definitions cause "missing } inserted" at \end{tabularx} in
- % French and Czech. don't know why.
- %
- % don't make these into links, as happens with \path. We only have a couple
- % special characters that actually occur.
- \def\dirname{\texttt\bgroup\catcode`\$=12 \catcode`\_=12 \finishliteral}
- \def\finishliteral#1{#1\egroup}
- \let\filename=\dirname
-\fi
diff --git a/Master/texmf-doc/source/texlive/texlive-en/tex-live.css b/Master/texmf-doc/source/texlive/texlive-en/tex-live.css
deleted file mode 100644
index 5062bc0d229..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/tex-live.css
+++ /dev/null
@@ -1,44 +0,0 @@
-/* $Id$
- Simple CSS for TeX Live that adds margins and a little color.
- original by Bzyl Wlodzimierz, edited by Karl Berry, 2005.
- Public domain. */
-
-html {
- // top left bottom right
- margin: 15pt 15pt 15pt 15pt;
- background: rgb(255,255,224);
-}
-
-body {
- margin: 0 5pt 0 5pt;
- padding: 0;
- //matw: background: rgb(224,255,224);
- // (It looks better to me to have a consistent background --karl)
-// fonts in browser are low resolution;
-// therefore generated serif are poor quality,
-// so they disturb reading (that is my opinion)
- font-family: sans-serif;
- font-style: normal;
-}
-
-/* (It looks better to me to not vary colors at every level --karl) */
-
-h3.sectionHead {
- padding: 12pt 10pt 12pt 20pt;
- //matw: background: rgb(192,224,255);
- background: rgb(224,224,255);
- color: rgb(0,0,32);
-}
-
-h4.subsectionHead {
- padding: 7pt 10pt 7pt 40pt;
- background: rgb(224,224,255);
- color: rgb(0,0,32);
-}
-
-h5.subsubsectionHead {
- padding: 3pt 10pt 3pt 40pt;
- //matw: background: rgb(224,255,255);
- background: rgb(224,224,255);
- color: rgb(0,0,32);
-}
diff --git a/Master/texmf-doc/source/texlive/texlive-en/tex-live.sty b/Master/texmf-doc/source/texlive/texlive-en/tex-live.sty
deleted file mode 100644
index 09956bd2a3e..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/tex-live.sty
+++ /dev/null
@@ -1,446 +0,0 @@
-% $Id$
-% TeX Live documentation style. Written by many people over many years.
-% Public domain.
-%
-\NeedsTeXFormat{LaTeX2e}[1995/12/01]
-\ProvidesPackage{tex-live}[2008/08/08 v1.6 TeX Live documentation style]
-%
-\RequirePackage{alltt}
-\RequirePackage{array}
-\RequirePackage{colortbl}
-\RequirePackage{comment}
-\RequirePackage{float}
-\RequirePackage{graphicx}
-\RequirePackage{longtable}
-\RequirePackage{shortvrb}
-\RequirePackage[normalem]{ulem}
-\RequirePackage[obeyspaces]{url}
-\RequirePackage{xspace}
-%
-\RequirePackage{lmodern}
-\usepackage{textcomp}% including \textbullet
-\def\p.{p.\,}
-
-% for a proper \acro command.
-\RequirePackage{relsize}
-%\DeclareRobustCommand{\acro}[1]{\textscale{.9}{#1}\@}
-\def\acro#1{\textscale{.9}{#1}\@}
-%
-\RequirePackage{fancyvrb}
-\DefineVerbatimEnvironment{verbatim}{Verbatim}{fontsize=\normalsize}
-\DefineVerbatimEnvironment{fverbatim}{Verbatim}{fontsize=\footnotesize}
-\DefineVerbatimEnvironment{sverbatim}{Verbatim}{fontsize=\small}
-\DefineVerbatimEnvironment{boxedverbatim}
- {Verbatim}{fontsize=\scriptsize,frame=single}
-\DefineVerbatimEnvironment{Verbatim}{Verbatim}{fontsize=\normalsize}
-\def\verbatiminput#1{\VerbatimInput[fontsize=\scriptsize]{#1}}
-\def\boxedverbatiminput#1{\VerbatimInput[frame=single,fontsize=\scriptsize]{#1}}
-\def\listinginput#1#2{\VerbatimInput[fontsize=\scriptsize,firstnumber=#1,numbers=left]{#2}}
-\MakeShortVerb\|
-%
-%
-% Done with packages.
-%
-% Page layout.
-\advance\textwidth by 1.1in
-\advance\oddsidemargin by -.55in
-\advance\evensidemargin by -.55in
-%
-\advance\textheight by 1in
-\advance\topmargin by -.5in
-\advance\footskip by -.5in
-\pagestyle{headings}
-%
-% LaTeX parameters.
-\renewcommand{\topfraction}{0.85}
-\renewcommand{\floatpagefraction}{0.86}
-\renewcommand{\textfraction}{0.1}
-\renewcommand{\abovecaptionskip}{4pt}
-\renewcommand{\belowcaptionskip}{4pt}
-\setcounter{tocdepth}{3}
-\setcounter{secnumdepth}{3}
-\setcounter{topnumber}{5}
-\setcounter{totalnumber}{5}
-%
-% linebreaking, etc.
-\hbadness=4000
-\vbadness=4000
-\emergencystretch=.1\hsize
-\relpenalty=500
-%
-\def\slash{/\penalty\z@\hskip\z@skip }
-%
-% various sorts of names
-\newcommand*{\pkgname}[1]{\textsf{#1}}% package name
-\newcommand*{\optname}[1]{\texttt{#1}}% (package,class) option name
-\newcommand*{\cmdname}[1]{\textsf{#1}}% command name
-\newcommand*{\colname}[1]{\emph{#1}}% collection name
-\newcommand*{\dirname}[1]{\path{#1}}% directory name
-\newcommand*{\filename}[1]{\path{#1}}% file name
-\newcommand*{\envname}[1]{\texttt{#1}}% environment variable name
-\newcommand{\code}[1]{\texttt{#1}}
-\newcommand{\file}[1]{\texttt{#1}}
-\newcommand{\prog}[1]{\textsf{#1}}% same as \cmdname
-\newcommand{\samp}[1]{`\texttt{#1}'}
-\newcommand{\var}[1]{{\sl #1}}% not \textsl, for roman not typewriter slanted.
-\newcommand{\ttvar}[1]{\texttt{\var{#1}}}
-%
-% underlined command input.
-%\def\Ucom#1{%
-% \uline{\rule[-.2\baselineskip]{0pt}{.9\baselineskip}\ttfamily #1}}
-% bold command input
-\def\Ucom#1{{\bfseries\ttfamily #1}}
-%
-% \CDref is for url's with a #, where we need to write the target url and
-% displayed url separately in the input, due to catcode madness.
-% (We could simplify/remove this next time, I think.)
-\def\CDref#1#2{\texttt{#1}}
-%
-% \OnCD is currently for any other reference to a file or directory in
-% the distribution. PDF readers only open .pdf files, though, so we
-% should change this to only use \href for those. Or more likely use
-% different macros in the source.
-\def\OnCD#1{\href{../../../../#1}{\path{#1}}}
-%
-% \href incorrectly appends .pdf to anything without an extension; these
-% definitions using \hyper@linkurl do not, but they fail for .pdf
-% references -- which are the only ones that work anyway. So this is
-% useless, in practice.
-%\def\CDref#1#2{\hyper@linkurl{#2}{../../../../#1}}
-%\def\OnCD#1{\hyper@linkurl{\path{#1}}{../../../../#1}}
-
-% GUI menu/button/tab sequence:
-\def\guiseq#1{\textsf{#1}}
-\def\arw{\unskip$\rightarrow$\ignorespaces}
-%
-% Special names.
-\def\dpi{$\,$dpi\xspace}
-\def\bs{{\protect\normalfont\ttfamily\char'134}}
-\DeclareRobustCommand{\cs}[1]{{\normalfont\ttfamily\char`\\#1}}
-\def\Q#1{\par\vskip6pt\leftline{#1}\par}
-\def\hyph{-}
-%
-% many abbreviations.
-\newcommand{\CS}{$\mathcal{C}\kern-.1667em\lower.5ex%
- \hbox{$\mathcal{S}$}\kern-.075em $}
-\def\AFMtoTFM{\cmdname{AFM2TFM}\null}
-\def\bv{\emph{Baskerville}}
-\let\BV=\bv
-\def\Dash{\unskip\nobreak\thinspace---\thinspace\ignorespaces}
-\def\dvicopy{\cmdname{dvicopy}}
-\def\dvidvi{\cmdname{dvidvi}}
-\def\dvips{\cmdname{dvips}}
-\def\eTeX{$\varepsilon$-\TeX}
-\def\fpTeX{\textrm{fp}\TeX\xspace}
-\def\GFtoDVI{\cmdname{GFtoDVI}\null}
-\def\GFtoPK{\cmdname{GFtoPK}\null}
-\def\GFtype{\cmdname{GFtype}}
-\def\GUI{\acro{GUI}\xspace}
-\def\KPS{Kpathsea}
-\def\La{La}
-\def\OMEGA{$\Omega$}
-\def\OzMF{OzMF}
-\def\OzMP{OzMP}
-\def\OzTeX{O\kern-.03em z\kern-.15em\TeX}
-\def\PKtype{\cmdname{PKtype}}
-\def\PLtoTF{\cmdname{PLtoTF}\null}
-\def\ProTeXt{Pro\TeX t}
-\def\teTeX{\textrm{te}\TeX\xspace}
-\def\TeXLive{\TeX{} Live\xspace}
-\def\TFtoPL{\cmdname{TFtoPL}\null}
-\def\TK{\TeX\ Collection}
-\let\TL=\TeXLive
-\def\TypeI{Type~1}
-\def\VFtoVP{\cmdname{VFtoVP}\null}
-\def\VPtoVF{\cmdname{VPtoVF}\null}
-\def\Thanh{H\`an~Th\ifx % get Unicode char in tex4ht's HTML output
- \HCode\UnDef\^e\llap{\raise 0.5ex\hbox{\'{}}}\else
- \HCode{\string&\#x1EBF;}\fi~Th\`anh}
-\def\XEmTeX{\textrm{XEm}\TeX\xspace}
-\def\XEmacs{\textrm{XEmacs}\xspace}
-\def\XeTeX{Xe\TeX\xspace}
-\def\Webc{Web2C}
-\providecommand*{\CD}{\acro{CD}\xspace}
-\providecommand*{\CTAN}{\acro{CTAN}\xspace}
-\providecommand*{\DVD}{\acro{DVD}\xspace}
-\providecommand*{\GNU}{\acro{GNU}\xspace}
-\providecommand*{\HTML}{\acro{HTML}\xspace}
-\providecommand*{\ISO}{\acro{ISO}\xspace}
-\providecommand*{\MacOSX}{Mac\,\acro{OS\,X}\xspace}
-\providecommand*{\PS}{Post\-Script\xspace}
-\providecommand*{\TDS}{\acro{TDS}\xspace}
-\providecommand*{\dvi}{\acro{DVI}\xspace}
-\providecommand*{\web}{\texttt{WEB}\xspace}
-
-% Include an image.
-% #1 - name of image (pictures/#1.jpg, always .jpg please)
-% #2 - bb for html
-% #3 - width for TeX
-%
-\def\tlimage#1#2#3{%
- \ifnum \Status=2 % html, want relative path in output
- \includegraphics[#2]{../../general/texlive-common/pictures/#1.jpg}
- \else % not html, handled by TEXINPUTS in Makefile
- \includegraphics[width=#3]{pictures/#1.jpg}
- \fi
- \\[5mm]
-}
-
-\def\tlpng#1#2{%
- \ifnum \Status=2 % html, want relative path in output
- \includegraphics[bb=0 0 1 1]{#1.png}%
- \else % not html, handled by TEXINPUTS in Makefile
- \includegraphics[width=#2]{#1.png}%
- \fi
-}
-%
-% description-like environment that uses tt instead of bf, and doesn't
-% go to the left margin. Without the \hfil, get an underfull box.
-% Don't know why \descriptionlabel doesn't.
-%
-\newenvironment{ttdescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt % these lists tend to have short descriptions
- \parindent=0pt
- \let\makelabel=\ttdescriptionlabel}}%
- {\end{list}}
-\newcommand*\ttdescriptionlabel[1]{\hspace\labelsep
- \normalfont\ttfamily #1\hfil}
-%
-% Likewise, for commands using sans serif.
-\newenvironment{cmddescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt
- \let\makelabel=\cmddescriptionlabel}}%
- {\end{list}}
-\newcommand*\cmddescriptionlabel[1]{\hspace\labelsep
- \normalfont\sffamily #1\hfil}
-
-% General squeezed itemize.
-\newenvironment{itemize*}%
- {\begin{itemize}%
- \setlength{\itemsep}{0pt}%
- \setlength{\parskip}{0pt}}%
- {\end{itemize}}
-
-\newsavebox{\wbox}
-\newenvironment{warningbox}
- {\begin{lrbox}{\wbox}
- \begin{minipage}{.95\textwidth}}
- {\end{minipage}\end{lrbox}\fbox{\usebox{\wbox}}}
-%
-% lrbox is used as a representation marking. I changed it to
-% lrBox in tne source file, to get closer to logical marking
-\newsavebox{\mylrbox}
-\newenvironment{lrBox}
- {\begin{lrbox}{\mylrbox}}
- {\end{lrbox}}
-
-
-% emacs-page output setup
-%
-\ifx \HCode\UnDef
- \providecommand{\Status}{0}% running TeX
-\else
- \providecommand{\Status}{2}% running TeX4ht
-\fi
-%\typeout{Status is \Status}
-%
-\newif\ifSingleColumn
-%
-% By default, we won't be creating hyperlinks.
-\def\href#1#2{#2}
-\def\hypertarget#1#2{}
-\def\email#1{\href{mailto:#1}{\path{#1}}} % \path comes from url
-\def\htmlanchor#1{}
-%
-\definecolor{hypercolor}{rgb}{0.5,0.0,0.5} % purplish external links.
-%
-%
-\ifcase\Status
- % \Status = 0
- \typeout{TeX Live documentation in DVI format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 1
- \typeout{TeX Live documentation in PDF format}
- \RequirePackage[breaklinks,
- colorlinks,linkcolor=hypercolor,citecolor=hypercolor,
- urlcolor=hypercolor,filecolor=hypercolor,
- bookmarksopen,
- %pdfstartview={FitBH -320000}, % fails with acrobat7
- hyperindex]
- {hyperref}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 2
- \typeout{TeX Live documentation in HTML format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- % read our config file, live4ht.cfg; q.v., for more definitions.
- % hyperref load must come after the tex4ht load.
- \RequirePackage[live4ht]{tex4ht}
- \RequirePackage[tex4ht]{hyperref} \hyperlinkfileprefix{}
- % definitions need simplifying for TeX4ht to make relative paths work.
- \def\CDref#1#2{\href{../../../../#1}{#2}}
- \def\OnCD#1{\href{../../../../#1}{#1}}
- \def\htmlanchor#1{\HCode{<a id="#1"></a>}
- \or
- % \Status = 3
- \typeout{TeX Live documentation as a Baskerville issue}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \RequirePackage{bvoutln}% outline of baskerville
- \SingleColumnfalse
- \RequirePackage{multicol}
- \or
- % \Status = 4
- \typeout{TeX Live documentation as a TUB article}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \SingleColumnfalse
- \newenvironment{multicols}[1]{}{}
-\fi
-%
-\ifnum \Status=4
-\else
- \RequirePackage{texnames}
- \providecommand\TeXXeT{\TeX-{}-%
- \kern-.1emX\kern-.125em\lower.5ex\hbox{E}\kern-.1667emT\@}
- \def\MP{MetaPost}
- \let\mf\MF
- \newcommand\ConTeXt{C\kern-.0333emon\-\kern-.0667em\TeX\kern-.0333emt}
- \newcommand\MIKTEX{MiK\kern-.025em \TeX}% per www.miktex.org
- % from pictex.tex:
- \ifx\PiC\undefined \def\PiC{P\kern-.12em\lower.5ex\hbox{I}\kern-.075emC} \fi
- \ifx\PiCTeX\undefined \def\PiCTeX{\PiC\kern-.11em\TeX} \fi
-\fi
-%
-% hacking at sections etc., to pay attention to baskerville status
-\newcommand{\@condend@multicols}{%
- \ifSingleColumn
- \else
- \def\@tempa{multicols}%
- \ifx\@tempa\@currenvir
- \end{multicols}%
- \fi
- \fi
-}
-\let\Section\section
-\renewcommand{\section}{%
- \@ifstar
- {\Section*}%
- {%
- \@condend@multicols
- \@dblarg\@full@section
- }%
-}
-\def\@full@section[#1]#2{%
- \Section[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-\let\SubSection\subsection
-\renewcommand{\subsection}{%
- \@ifstar{\SubSection*}%
- {%
- \@condend@multicols
- \@dblarg\@full@subsection
- }
-}
-\def\@full@subsection[#1]#2{%
- \SubSection[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-
-% calm things down a bit if we're in a multiple-column version
-\ifSingleColumn
-\else
- \def\@listI{\leftmargin\leftmargini
- \parsep \z@
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \itemsep \z@ \@plus .1\p@
- }
- \let\@listi\@listI
- \@listi
- \def\@listii{\leftmargin\leftmarginii
- \labelwidth\leftmarginii\advance\labelwidth-\labelsep
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \itemsep \z@ \@plus .1\p@
- }
- \def\@listiii{\leftmargin\leftmarginiii
- \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
- \topsep 1\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \partopsep \z@
- \itemsep \topsep
- }
- \def\@listiv{\leftmargin\leftmarginiv
- \labelwidth\leftmarginiv\advance\labelwidth-\labelsep
- }
- \def\@listv{\leftmargin\leftmarginv
- \labelwidth\leftmarginv\advance\labelwidth-\labelsep
- }
- \def\@listvi{\leftmargin\leftmarginvi
- \labelwidth\leftmarginvi\advance\labelwidth-\labelsep
- }
-\fi
-%
-% array package stuff
-\def\arraybackslash{\let\\=\@arraycr}
-\newcolumntype{P}[1]{>{\raggedright\arraybackslash}p{#1}}
-%
-% shaded rows (using facilities of colortbl)
-%
-\definecolor{pale}{gray}{.9}
-\newcount\colrow
-\gdef\RowColor{pale}
-\def\SetRowColor{%
- \rowcolor{\RowColor}%
- \global\advance\colrow by1\relax
- \ifodd\colrow
- \gdef\RowColor{pale}%
- \else
- \gdef\RowColor{white}%
- \fi
-}
-% redefine to hack up a reference even though we don't need it...
-\renewcommand\@bibitem[1]{\if@filesw \immediate\write\@auxout
- {\string\bibcite{#1}{?}}\fi\ignorespaces}
-%
-% \unknownTeXlive is a dummy texlive entry for the biblio
-\newcommand\unknownTeXlive[2][\relax]{\textbf{\textsc{unknown}}%
- \global\@all@unknown\expandafter{\the\@all@unknown{#2}}%
-}
-\newtoks\@all@unknown
-\global\@all@unknown{}
-\AtEndDocument{\@message@unknowns}
-\def\@message@unknowns{\edef\@tempa{\the\@all@unknown}%
- \ifx\@tempa\@empty
- \else
- \def\@tempa{*** TeX live package location of }%
- \expandafter\@output@unknowns\the\@all@unknown\@empty
- \fi
-}
-\def\@output@unknowns#1{\edef\@tempb{#1}%
- \ifx\@tempb\@empty
- \typeout{ unknown}%
- \else
- \message{\@tempa#1,}%
- \def\@tempa{}%
- \expandafter\@output@unknowns
- \fi
-}
-
-
-% Silence font warnings about no bold typewriter in LM.
-\def\@font@warning#1{}%
-
-% Silence hyperref warnings about \kern.
-\def\HyPsd@Warning#1{}%
-
-\endinput
diff --git a/Master/texmf-doc/source/texlive/texlive-en/texlive-en.tex b/Master/texmf-doc/source/texlive/texlive-en/texlive-en.tex
deleted file mode 100644
index 24fbb5d1c1b..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-en/texlive-en.tex
+++ /dev/null
@@ -1,2954 +0,0 @@
-% $Id: live.tex 9531 2008-07-13 21:12:58Z siepo $
-% TeX Live documentation. Originally written by Sebastian Rahtz and
-% Michel Goossens, now maintained by Karl Berry and others.
-% Public domain.
-%
-\documentclass{article}
-\let\tldocenglish=1 % for live4ht.cfg
-\usepackage{tex-live}
-\usepackage[latin1]{inputenc} % translators: use your preferred encodings.
-\usepackage[T1]{fontenc}
-
-\begin{document}
-
-\title{%
- {\huge \textit{The \TeX\ Live Guide}\\\smallskip}%
- {\LARGE \textsf{\TL{} 2008}}%
-}
-
-\author{Karl Berry, editor \\[3mm]
- \url{http://tug.org/texlive/}
- }
-
-\date{September 2008}
-
-\maketitle
-
-\begin{multicols}{2}
-\tableofcontents
-%\listoftables
-\end{multicols}
-
-\section{Introduction}
-\label{sec:intro}
-
-\subsection{\TeX\ Live and the \TeX\ Collection}
-
-This document describes the main features of the \TL{} software
-distribution\Dash \TeX{} and related programs for \GNU/Linux
-and other Unix flavors, \MacOSX, and Windows systems.
-
-You may have acquired \TL{} by downloading, or on the \TK{} \DVD,
-which \TeX{} usergroups distribute among their members. Section
-\ref{sec:tl-coll-dists} briefly describes the contents of this \DVD.
-Both \TL{} and the \TK{} are cooperative efforts by the \TeX{} user
-groups. This document mainly describes \TL{} itself.
-
-\TL{} includes executables for \TeX{}, \LaTeXe{}, \ConTeXt,
-\MF, \MP, \BibTeX{} and many other programs; an extensive collection
-of macros, fonts and documentation; and support for typesetting in
-many different scripts from around the world.
-
-\TL{} packages are regularly updated from
-\acro{CTAN}: \url{http://www.ctan.org}.
-
-For a brief summary of the major changes in this edition of \TL{},
-see the end of the document, section~\ref{sec:history}
-(\p.\pageref{sec:history}).
-
-\subsection{Operating system support}
-\label{sec:os-support}
-
-\TL{} contains binaries for many Unix-based architectures,
-including \MacOSX. The included sources should enable installation
-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
-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 installation of \protect\TL{}}
-\label{sec:basic}
-
-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
-your system supports that).
-
-\noindent This is described in the
-installation sections following, but here is a quick start:
-
-\begin{itemize*}
-
-\item The installation script is named \filename{install-tl}. It can
- operate in both a \GUI{} mode (default for Windows) and
- a text mode (default for everything else). You can force one mode or
- the other with the options \code{-gui} and \code{-no-gui}, respectively.
-
-\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*}
-
-
-\subsection{Getting help}
-\label{sec:help}
-
-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:
-
-\begin{description}
-\item [Getting Started] If you are new to \TeX, the web page
-\url{http://tug.org/begin.html} gives a brief introduction to the system.
-
-\item [\TeX{} \acro{FAQ}] The \TeX{} \acro{FAQ} is a huge compendium
- of answers to all sorts of questions, from the most basic to the
- most arcane. It is included on \TL{} in
- \OnCD{texmf-doc/doc/english/FAQ-en/html/index.html}, and is available
- on the Internet through \url{http://www.tex.ac.uk/faq}. Please
- check here first.
-
-\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
-\url{http://www.ctan.org/help/Catalogue/}.
-
-\item [\TeX{} Web Resources] The web page
-\url{http://tug.org/interest.html} has many \TeX{}-related links, in
-particular for numerous books, manuals, and articles on all aspects of
-the system.
-
-\item [support archives] The two principal support forums are the
-Usenet newsgroup \url{news:comp.text.tex} and the mailing list
-\email{texhax@tug.org}. Their archives have years of past
-questions and answers for your searching pleasure, via
-\url{http://groups.google.com/group/comp.text.tex/topics} and
-\url{http://tug.org/mail-archives/texhax}, respectively. And a general web
-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, 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{}, 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}
-
-The other side of the coin is helping others who have questions. Both
-\dirname{comp.text.tex} and \code{texhax} are open to anyone, so feel
-free to join, start reading, and help out where you can.
-
-
-% don't use \TL so the \uppercase in the headline works. Also so
-% tex4ht ends up with the right TeX. Likewise the \protect's.
-\section{Overview of \protect\TeX\protect\ Live}
-\label{sec:overview-tl}
-
-This section describes the contents of \TL{} and the \TK{} of which it
-is a part.
-
-\subsection{The \protect\TeX\protect\ Collection: \TL, pro\TeX{}t, Mac\TeX}
-\label{sec:tl-coll-dists}
-
-The \TK{} \DVD{} comprises the following:
-
-\begin{description}
-
-\item [\TL] A complete \TeX{} system which can be run live or
- installed to disk.
-
-\item [Mac\TeX] for \MacOSX, this adds a native \MacOSX\ installer and other
-Mac applications to \TL{}. Its home page is
-\url{http://www.tug.org/mactex/}.
-
-\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. The \ProTeXt\ home page is
-\url{http://tug.org/protext}.
-
-\item [CTAN] A snapshot of the \CTAN{} repository.
-
-\item [\texttt{texmf-extra}] A directory with assorted additional packages.
-
-\end{description}
-
-\CTAN{}, \pkgname{protext}, and \dirname{texmf-extra} do not
-necessarily follow the same copying conditions as \TL{}, so be careful
-when redistributing or modifying.
-
-
-\subsection{Top level \TL{} directories}
-\label{sec:tld}
-
-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{texlive}, not at the top
-level of the disc.
-
-\begin{ttdescription}
-\item[bin] The \TeX{} system programs, arranged by platform.
-%
-\item[readme.html] Web pages with a quick introduction and useful links,
-in various languages.
-%
-\item[source] The source to all included programs, including the main \Webc{}
- \TeX{} and \MF{} distributions.
-%
-\item[support] Various auxiliary packages and programs. These are
- \emph{not} installed automatically. This includes
- assorted editors and \TeX\ shells.
-%
-\item[texmf] See \dirname{TEXMFMAIN} below.
-%
-\item[texmf-dist] See \dirname{TEXMFDIST} below.
-%
-\item[texmf-doc] Tree for self-contained pure documentation, arranged by
- language.
-%
-\item[tlpkg] Scripts, programs and data for managing the
- installation. It also contains private copies of
- Perl and Ghostscript for Windows, which are invisible outside \TL,
- and a new Windows PostScript viewer PSView.
-\end{ttdescription}
-
-In addition to the directories above, the installation scripts and
-\filename{README} files (in various languages) are at the top level of
-the distribution.
-
-The \dirname{texmf-doc} directory contains documentation which does
-not belong to any particular package or program. The documentation
-for the programs (manuals, man pages, Info files) is in
-\dirname{texmf/doc}. The documentation for \TeX\ packages and
-formats is in \dirname{texmf-dist/doc}. You can use the
-\cmdname{texdoc} or \cmdname{texdoctk} programs to find any
-documentation wherever it is located. The comprehensive links in
-the top-level file \OnCD{doc.html} may also be helpful.
-
-This \TL\ documentation itself is in \dirname{texmf-doc} and is
-available in several languages:
-
-\begin{itemize*}
-\item{Simplified Chinese:} \OnCD{texmf-doc/doc/chinese/texlive-zh-cn}
-\item{Czech/Slovak:} \OnCD{texmf-doc/doc/czechslovak/texlive-cz}
-\item{English:} \OnCD{texmf-doc/doc/english/texlive-en}
-\item{French:} \OnCD{texmf-doc/doc/french/texlive-fr}
-\item{German:} \OnCD{texmf-doc/doc/german/texlive-de}
-\item{Polish:} \OnCD{texmf-doc/doc/polish/texlive-pl}
-\item{Russian:} \OnCD{texmf-doc/doc/russian/texlive-ru}
-\end{itemize*}
-
-\subsection{Overview of the predefined texmf trees}
-\label{sec:texmftrees}
-
-This section lists all predefined variables specifying the texmf trees
-used by the system, and their intended purpose, and the default
-layout of a \TL{} system. The command \texttt{texconfig conf} shows
-you the values of these variables, so that you can easily find out
-how they map to directory names in your installation.
-
-\begin{ttdescription}
-\item [TEXMFMAIN] The tree which holds vital parts of the system
- such as helper scripts (e.g., \verb+web2c/mktexdir+) and other
- support files and their documentation. Does not include
- \TeX\ formats and packages.
-\item [TEXMFDIST] The tree which holds the main set of macro packages,
- fonts, etc., as originally distributed.
-\item [TEXMFLOCAL] The tree which administrators can use for system-wide
- installation of additional or updated macros, fonts, etc.
-\item [TEXMFHOME] The tree which users can use for their own individual
- installations of additional or updated macros, fonts, etc.
- The expansion of this variable dynamically adjusts for each user to
- their own individual directory.
-\item [TEXMFCONFIG] The tree used by the utilities
- \verb+texconfig+, \verb+updmap+, and \verb+fmtutil+ to store modified
- configuration data. Under \envname{TEXMFHOME} by default.
-\item [TEXMFSYSCONFIG] The tree used by the utilities
- \verb+texconfig-sys+, \verb+updmap-sys+, and \verb+fmtutil-sys+ to
- store modified configuration data.
-\item [TEXMFVAR] The tree used by \verb+texconfig+, \verb+updmap+ and
- \verb+fmtutil+ to store (cached) runtime data such as format files and
- generated map files. Under \envname{TEXMFHOME} by default.
-\item [TEXMFSYSVAR] The tree used by \verb+texconfig-sys+,
- \verb+updmap-sys+ and \verb+fmtutil-sys+, and also by \verb+tlmgr+, to
- store (cached) runtime data such as format files and generated map files.
-\end{ttdescription}
-
-\noindent
-The default layout is:
-\begin{description}
- \item[system-wide root] can span multiple \TL{} releases:
- \begin{ttdescription}
- \item[2007] A previous release.
- \begin{ttdescription}
- \item [...]
- \end{ttdescription}
- \item[2008] The current release.
- \begin{ttdescription}
- \item [bin] ~
- \begin{ttdescription}
- \item [i386-linux] \GNU/Linux binaries
- \item [...]
- \item [universal-darwin] \MacOSX binaries
- \item [win32] Windows binaries
- \end{ttdescription}
- \item [texmf] This is \envname{TEXMFMAIN}.
- \item [texmf-dist] \envname{TEXMFDIST}
- \item [texmf-doc] \envname{TEXMFDOC}
- \item [texmf-var] \envname{TEXMFSYSVAR}
- \item [texmf-config] \envname{TEXMFSYSCONFIG}
- \end{ttdescription}
- \item [texmf-local] \envname{TEXMFLOCAL}, intended to be
- retained from release to release.
- \end{ttdescription}
- \item[user's home] (\texttt{\$HOME} or
- \texttt{\%USERPROFILE\%})
- \begin{ttdescription}
- \item[.texlive2007] Privately generated and configuration data
- for a previous release.
- \item[.texlive2008] Privately generated and configuration data
- for the current release.
- \begin{ttdescription}
- \item [texmf-var] \envname{TEXMFVAR}
- \item [texmf-config] \envname{TEXMFCONFIG}
- \end{ttdescription}
- \item[texmf] \envname{TEXMFHOME} Personal macros.
- \textit{etc.}
- \end{ttdescription}
-\end{description}
-
-
-\subsection{Extensions to \protect\TeX}
-\label{sec:tex-extensions}
-
-\TeX{} itself is frozen, apart from rare bug fixes. It is still present
-in \TL\ as the program \prog{tex}, and will remain so in the
-foreseeable future. \TL{} contains several extended versions of \TeX:
-
-\begin{description}
-
-\item [\eTeX] adds a set of new primitives
-\label{text:etex} (related to macro expansion, character scanning,
-classes of marks, additional debugging features, and more) and the
-\TeXXeT{} extensions for bidirectional typesetting. In default mode,
-\eTeX{} is 100\% compatible with ordinary \TeX. See
-\OnCD{texmf-dist/doc/etex/base/etex_man.pdf}.
-
-\item [pdf\TeX] builds on the \eTeX\ extensions, adding support for
-writing \acro{PDF} output as well as \dvi{}. This is the program
-invoked for most formats, e.g., \prog{etex}, \prog{latex},
-\prog{pdflatex}. See \url{http://www.pdftex.org/}.
-\OnCD{texmf-dist/doc/pdftex/manual/pdftex-a.pdf} for the manual, and
-\OnCD{texmf-dist/doc/pdftex/manual/samplepdf/samplepdf.tex} for example usage
-of some of its features.
-
-\item [Lua\TeX] is the designated successor of pdf\TeX, with which it
-is intended to be backward-compatible. It should also supersede Aleph,
-see below. The incorporated Lua interpreter (see
-\url{http://www.lua.org/}) enables elegant solutions for many thorny
-\TeX{} problems. When called as \filename{texlua}, it functions as a
-standalone Lua interpreter, and is already used as such within \TL. See
-\url{http://www.luatex.org/} and
-\OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}.
-
-\item [\XeTeX] adds support for Unicode input and OpenType- and system
-fonts, implemented using standard 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
-also supports so-called `\OMEGA{} Translation Processes' (\acro{OTP}s),
-for performing complex transformations on arbitrary input. See
-\OnCD{texmf-dist/doc/omega/base/doc-1.8.tex} (not completely up-to-date).
-
-\item [Aleph] combines the \OMEGA\ and \eTeX\ extensions.
-See \OnCD{texmf-dist/doc/aleph/base} for some minimal documentation.
-
-\end{description}
-
-
-\subsection{Other notable programs in \protect\TL}
-
-Here are a few other commonly-used programs included in \TL{}:
-
-\begin{cmddescription}
-
-\item [bibtex] bibliography support.
-
-\item [makeindex] index support.
-
-\item [dvips] convert \dvi{} to \PS{}.
-
-\item [xdvi] \dvi{} previewer for the X Window System.
-
-\item [dvilj] \dvi{} drive for the HP LaserJet family.
-
-\item [dv2dt, dt2dv] convert \dvi{} to/from plain text.
-
-\item [dviconcat, dviselect] cut and paste pages
-from \dvi{} files.
-
-\item [dvipdfmx] convert \dvi{} to \acro{PDF}, an alternative approach
-to pdf\TeX\ (mentioned above). See the \pkgname{ps4pdf} and
-\pkgname{pdftricks} packages for still more alternatives.
-
-\item [psselect, psnup, \ldots] \PS{}
-utilities.
-
-\item [lacheck] \LaTeX{} syntax checker.
-
-\item [texexec, texmfstart] Con\TeX{}t and \acro{PDF} processor.
-
-\item [tex4ht] \TeX{} to \acro{HTML} (and \acro{XML} and more) converter.
-
-\end{cmddescription}
-
-
-\subsection{Fonts in \protect\TL}
-\label{sec:tl-fonts}
-
-\TL{} comes with many high-quality scalable fonts. See
-\url{http://tug.org/fonts} and
-\OnCD{texmf-doc/doc/english/free-math-font-survey}.
-
-
-
-\section{Installation}
-\label{sec:install}
-
-\subsection{Starting the installer}
-\label{sec:inst-start}
-
-To start with, get the \TK{} \DVD{} or download the \TL{} net installer,
-and locate the installer script: \filename{install-tl} for Unix,
-\filename{install-tl.bat} for Windows.
-
-\begin{description}
-\item [Net installer:] Download from \CTAN, under
-\dirname{systems/texlive/tlnet}; the url
-\url{http://mirror.ctan.org/systems/texlive/tlnet} will automatically
-redirect to a nearby, up-to-date, mirror. You can retrieve either
-\filename{install-tl.zip} which can be used under Unix and Windows and
-\filename{install-unx.tar.gz} which is considerably smaller, for Unix
-only. After unpacking, \filename{install-tl} and
-\filename{install-tl.bat} will be in the \dirname{install-tl}
-subdirectory.
-
-\item [\TeX{} Collection \DVD:] go to its \dirname{texlive}
-subdirectory. Under Windows, the installer should start automatically
-when you insert the \DVD. You can get the \DVD\ by becoming a member of
-a \TeX\ user group (highly recommended,
-\url{http://tug.org/usergroups.html}), or purchasing it separately
-(\url{http://tug.org/store}), or burning your own from the \ISO\
-image (\url{http://tug.org/texlive/acquire.html}).
-
-\end{description}
-The following sections explain in more detail.
-
-\subsubsection{Unix}
-
-\begin{figure}[tb]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
-
- Detected platform: Intel x86 with GNU/Linux
-
- <B> binary systems: 1 out of 16
-
- <S> Installation scheme (scheme-full)
-
- Customizing installation scheme:
- <C> standard collections
- <L> language collections
- 83 collections out of 84, disk space required: 1666 MB
-
- <D> directories:
- TEXDIR (the main TeX directory):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
- [X] install macro/font doc tree
- [X] install macro/font source tree
- [ ] create symlinks in standard directories
-
- <V> Install for running from DVD
-
-Other actions:
- <I> start installation to HD
- <H> help
- <Q> quit
-
-Enter command:
-\end{boxedverbatim}
-\caption{Main text installer screen (\GNU/Linux)}\label{fig:text-main}
-\end{figure}
-
-\begin{figure}[tb]
-\tlpng{install-w32-main}{\linewidth}
-\caption{Main \GUI{} installer screen (Windows)}\label{fig:gui-main}
-\end{figure}
-
-\noindent
-Below, \texttt{>} denotes the shell prompt; user input is
-\Ucom{\texttt{bold}}.
-Starting in a terminal window on a Unix-compatible system, the simplest
-way:
-\begin{alltt}
-> \Ucom{cd /path/to/installer}
-> \Ucom{perl install-tl}
-\end{alltt}
-(Or you can invoke \Ucom{perl /path/to/installer/install-tl}, or
-\Ucom{./install-tl} if it stayed executable, etc.; we won't repeat all
-these variations.)
-
-To install in \GUI\ mode (you'll need the \dirname{Perl/TK} module), use:
-\begin{alltt}
-> \Ucom{perl install-tl -gui}
-\end{alltt}
-
-For a complete listing of the various options:
-\begin{alltt}
-> \Ucom{perl install-tl -help}
-\end{alltt}
-
-\textbf{Warning about Unix permissions:} Your \code{umask} at the time
-of installation will be respected by the \TL{} installer. Therefore, if
-you want your installation to be usable by users other than you, make
-sure your setting is sufficiently permissive, for instance, \code{umask
-002}. For more information about \code{umask}, consult your system
-documentation.
-
-
-\subsubsection{Mac\,OS\,X}
-
-As mentioned in section~\ref{sec:tl-coll-dists}, a separate distribution
-is prepared for \MacOSX, named Mac\TeX\ (\url{http://tug.org/mactex}).
-We recommend using the native Mac\TeX\ installer instead of the \TL\
-installer on \MacOSX, because the native installer can make a few
-Mac-specific adjustments, in particular to allow easily switching
-between the various \TeX\ distributions for \MacOSX\ (Mac\TeX, gw\TeX,
-Fink, MacPorts, \ldots).
-
-Mac\TeX\ is firmly based on \TL, and the main \TeX\ trees are precisely
-the same. It does add a few extra folders with Mac-specific
-documentation and applications.
-
-
-\subsubsection{Windows}
-
-If you are using the net installer, or the \DVD\ installer failed to
-start automatically, double-click \filename{install-tl.bat}.
-
-You can also start the installer from the command-prompt. Below,
-\texttt{>} denotes the prompt; user input is \Ucom{\texttt{bold}}. If
-you are in the installer directory, run just:
-\begin{alltt}
-> \Ucom{install-tl}
-\end{alltt}
-
-Or you can invoke it with an absolute location, such as:
-\begin{alltt}
-> \Ucom{D:\bs{}texlive\bs{}install-tl}
-\end{alltt}
-for the \TK\ \DVD, supposing that \dirname{D:} is the optical drive.
-
-To install in text mode, use:
-\begin{alltt}
-> \Ucom{install-tl -no-gui}
-\end{alltt}
-
-For a complete listing of the various options:
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-
-\subsubsection{The text installer}
-
-Figure~\ref{fig:text-main} displays the main text mode screen under
-Unix.
-
-This is only a command-line installer; there is no cursor support at
-all. For instance, you cannot tab around checkboxes or input fields.
-You just type something (case-sensitive) at the prompt and press the
-Enter key, and then the entire terminal screen will be rewritten, with
-adjusted content.
-
-The text installer interface is this primitive for a reason: it
-is designed to run on as many platforms as possible, even with a
-very barebones Perl (for Windows, a Perl subset is included).
-
-\subsubsection{The graphical installer}
-
-Figure~\ref{fig:gui-main} displays the graphical installer under
-Windows. Most differences in available options are due to this
-screenshot being from Windows, and the previous text screen being
-from \GNU/Linux.
-
-\subsection{Running the installer}
-\label{sec:runinstall}
-
-The installer is intended to be mostly self-explanatory. Still, a few
-quick notes about the various options and submenus:
-
-\subsubsection{Binary systems menu (Unix only)}
-\label{sec:binary}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Available sets of binaries:
-===============================================================================
-
- a [ ] alpha-linux DEC Alpha with GNU/Linux
- b [ ] amd64-freebsd x86_64 with FreeBSD
- c [ ] hppa-hpux HP-UX
- d [ ] i386-freebsd Intel x86 with FreeBSD
- e [X] i386-linux Intel x86 with GNU/Linux
- f [ ] i386-openbsd Intel x86 with OpenBSD
- g [ ] i386-solaris Intel x86 with Sun Solaris
- h [ ] mips-irix SGI IRIX
- i [ ] powerpc-aix PowerPC with AIX
- j [ ] powerpc-linux PowerPC with GNU/Linux
- k [ ] sparc-linux Sparc with GNU/Linux
- l [ ] sparc-solaris Sparc with Solaris
- m [ ] universal-darwin universal binaries for MacOSX/Darwin
- o [ ] win32 Windows
- p [ ] x86_64-linux x86_64 with GNU/Linux
-\end{boxedverbatim}
-\caption{Binaries menu}\label{fig:bin-text}
-\end{figure}
-
-Figure~\ref{fig:bin-text} displays the text mode binaries menu. By
-default, only the binaries for your current platform will be installed.
-From this menu, you can select installation of binaries for other
-architectures as well. This can be useful if you are sharing a \TeX\
-tree across a network of heterogenous machines, or for a dual-boot
-system.
-
-\subsubsection{Selecting what is going to be installed}
-\label{sec:components}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Select a scheme:
-===============================================================================
-
- a [ ] TeX Live basic scheme
- b [ ] TeX Live scheme for ConTeXt
- c [X] TeX Live full scheme
- d [ ] GUST TeX Live scheme
- e [ ] GUTenberg TeX Live scheme
- f [ ] TeX Live medium scheme
- g [ ] TeX Live minimal scheme
- h [ ] TeX Live for Omega users
- i [ ] teTeX scheme
- j [ ] XML typesetting scheme
-\end{boxedverbatim}
-\caption{Scheme menu}\label{fig:scheme-text}
-\end{figure}
-
-Figure~\ref{fig:scheme-text} displays the \TL\ scheme menu; from here,
-you choose a ``scheme'', which is an overall set of package collections.
-The default \optname{full} scheme installs everything available, but you
-can also choose the \optname{basic} scheme for a small system,
-\optname{minimal} for testing purposes, and \optname{medium} or
-\optname{teTeX} to get something in between. There are also various
-specialized and country-specific schemes.
-
-\begin{figure}[tbh]
-\tlpng{stdcoll}{.7\linewidth}
-\caption{Collections menu (Linux)}\label{fig:collections-gui}
-\end{figure}
-
-You can refine your scheme selection with the `standard collections' and
-`language collections' menus (figure~\ref{fig:collections-gui}, shown in
-\GUI\ mode for a change).
-
-Collections are one level more detailed than schemes\Dash in essence, a
-scheme consists of several collections, a collection consists of one or
-more packages, and a package (the lowest level grouping in \TL) contains
-the actual \TeX\ macro files, font files, and so on.
-
-If you want more control than the collection menus provide, you can use
-the \prog{tlmgr} program after installation (see
-section~\ref{sec:tlmgr}); using that, you can control the installation
-at the package level.
-
-\subsubsection{Directories}
-\label{sec:directories}
-
-The default layout is described in section~\ref{sec:texmftrees},
-\p.\pageref{sec:texmftrees}. The default location of
-\dirname{TEXDIR} is different between Windows
-(|%PROGRAMFILES%\texlive\2008|) and Unix
-(\dirname{/usr/local/texlive/2008}).
-
-The main reason to change this default is if you lack write permission
-for the default location. You don't have to be root or adminstrator to
-install \TL, but you do need write access to the target directory.
-
-A logical alternate choice is a directory under your home directory,
-especially if you will be the sole user. Use
-`|~|' to indicate this, as in `|~/texlive/2008|'.
-
-We recommend including the year in the name, to enable keeping different
-releases of \TL{} side by side. (You may wish to make a
-version-independent name such as \dirname{/usr/local/texlive-cur} via a
-symbolic link, which you can then update after testing the new release.)
-
-Changing \dirname{TEXDIR} in the installer will also change
-\dirname{TEXMFLOCAL}, \dirname{TEXMFSYSVAR} and
-\dirname{TEXMFSYSCONFIG}.
-
-\dirname{TEXMFHOME} is the recommended location for personal
-macro files or packages. The default value is |~/texmf|. In
-contrast to \dirname{TEXDIR}, here a |~| is preserved in the
-newly-written configuration files, since it usefully refers to the home
-directory of each individual running \TeX. It expands to
-\dirname{$HOME} on Unix and \verb|%USERPROFILE%| on Windows.
-
-\subsubsection{Options}
-\label{sec:options}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-<P> use letter size instead of A4 by default: [ ]
-<F> create all format files: [X]
-<D> install font/macro doc tree: [X]
-<S> install font/macro source tree: [X]
-<L> create symlinks in standard directories: [ ]
- binaries to:
- manpages to:
- info to:
-\end{boxedverbatim}
-\caption{Options menu (Unix)}\label{fig:options-text}
-\end{figure}
-
-Figure~\ref{fig:options-text} displays the text mode options menu.
-Three of the options here need mentioning:
-
-\begin{description}
-\item[use letter size instead of A4 by default:] The usual default paper
- size selection. Of course, individual documents can specify a specific
- paper size, if desired.
-
-\item[create all format files:] Although unnecessary format files
- take time to generate and disk space to store, it is still recommended
- to leave this option checked: if you don't, then format files will be
- generated in people's private \dirname{TEXMFVAR} tree as they are
- needed. In that location, they will not be updated automatically if
- (say) binaries or hyphenation patterns are updated in the
- installation, and thus could end up with incompatible format files.
-
-\item[create symlinks in standard directories] (Unix only):
- This option bypasses the need to change environment
- variables. Without this option, \TL{} directories have to be added
- to \envname{PATH}, \envname{MANPATH} and \envname{INFOPATH}. You will
- need write permissions to the target directories. It is not
- advisable to overwrite a \TeX\ system that came with your system
- with this option. It is intended primarily for creating the links
- in standard directories that are known to users, such as
- \dirname{/usr/local/bin}, which don't already contain any
- \TeX\ files.
-\end{description}
-
-Now when all these settings are to your liking, you can type `I' to
-start the installation process. When it is done, skip to
-section~\ref{sec:postinstall} to read what else needs to be done, if
-anything.
-
-\htmlanchor{runfromdvd}
-\subsubsection{Set up for running from DVD{} (text mode only)}
-\label{sec:fromdvd}
-
-Type `|V|' to select this option. This changes the main menu into something
-like figure~\ref{fig:main-fromdvd}.
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
- <D> directories:
- TEXDIRW (Writable root):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
-
- <V> set up for installing to hard disk
-
-Other actions:
- <I> start installation for running from DVD
- <H> help
- <Q> quit
-\end{boxedverbatim}
-\caption{The main menu with \optname{from DVD}
- set}\label{fig:main-fromdvd}
-\end{figure}
-
-Note the changes: all options about what to install have
-disappeared, and the directories section now talks about
-\dirname{TEXDIRW} or writable root. The symlinks option has also
-disappeared.
-
-The installer will still create various directories and
-configuration files, but won't copy \dirname{texmf},
-\dirname{texmf-dist} or \dirname{texmf-doc} to hard disk.
-
-Post-install configuration for Unix will be slightly more complicated,
-because now the directory layout deviates from the default; see
-section~\ref{sec:postinstall}.
-
-Due to time constraints, this option didn't make it into the \GUI{}
-installer, but it is available both for Unix and for
-Windows. Windows users have to start the installer from a command
-prompt, see section~\ref{sec:cmdline}.
-
-Section \ref{sec:portable-unix} describes a more strictly portable
-way to run \TL, which doesn't make or require changes in the
-system's configuration, but doesn't allow any configuration either.
-
-\subsection{Command-line install options}
-\label{sec:cmdline}
-
-Type
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-for a listing of command-line options. Either |-| or |--| can be used
-to introduce option names. These are the more
-interesting ones:
-
-\begin{ttdescription}
-\item[-gui] If possible, use the \GUI{} installer. This requires the
- Perl/Tk module (\url{http://tug.org/texlive/distro.html#perltk});
- if Perl/Tk is not available, installation continues in text mode.
-\item[-no-gui] Force using the text mode installer, even under
- Windows; you'll need this if you want a `from \DVD' installation,
- since that is not available in \GUI{} mode.
-\item[-lang {\sl LL}] Specify the installer interface
- language as its standard two-letter code \textsl{LL}. Currently
- supported languages: English (\texttt{en}, default), German
- (\texttt{de}), French (\texttt{fr}), Dutch (\texttt{nl}), Polish
- (\texttt{pl}), Slovenian (\texttt{sl}) and Vietnamese
- (\texttt{vi}). The installer tries to determine the right language
- itself but if it fails, or if the right language is not available,
- then it uses English as a fallback.
-\item[-profile {\sl profile}] The installer always writes a file
- \filename{texlive.profile} to the \dirname{2008/tlpkg}- or
- \dirname{tlpkg} subdirectory of your installation. This option tells
- the installer to re-use such a profile file. Here's an excerpt:
- \begin{fverbatim}
-# texlive.profile written on Wed Jul 9 16:13:44 2008 UTC
-# It will NOT be updated and reflects only the
-# installation profile at installation time.
-selected_scheme scheme-basic
-TEXDIR /usr/local/texlive/2008
-TEXDIRW /usr/local/texlive/2008
-...
-TEXMFSYSVAR /usr/local/texlive/2008/texmf-var
-collection-basic 1
-...
-option_symlinks 0
- \end{fverbatim}
- Thus, using this option you can install in batch mode on
- subsequent systems, reproducing the choices you made for the
- original installation.
-\item [-location {\sl url/path}] Specify a non-default source for
- packages; see below.
-\end{ttdescription}
-
-\subsubsection{The \optname{location} parameter}
-\label{sec:location}
-
-The location value can be a url starting with \texttt{ftp:},
-\texttt{http:}, or \texttt{file:/} url, or a plain path. If the given
-argument is on a local drive (either a path or a \texttt{file:/} url),
-the installation type (compressed or live) is automatically determined:
-if an \dirname{archive} subdirectory with \filename{.tar.lzma} files is
-found then it will be used, even if uncompressed files are available as
-well.
-
-When giving an \texttt{http:} or \texttt{ftp:} location, trailing
-`\texttt{/}' characters and/or a trailing `\texttt{/tlpkg}' component
-are ignored. For example, you could choose a particular \CTAN\ mirror
-with something like:
-\url{http://ctan.example.org/tex-archive/texlive/tlnet/2008},
-substituting of course a proper hostname and its particular top-level
-\CTAN\ path (the list of \CTAN\ mirrors is maintained at
-\url{http://ctan.org/mirrors}) for |ctan.example.org/tex-archive|. The
-default is to pick a mirror automatically, using
-\url{http://mirror.ctan.org}; in any case, the chosen host is used for
-the entire download.
-
-
-\subsection{Post-install actions}
-\label{sec:postinstall}
-
-Some post-install may be required.
-
-\subsubsection{Windows}
-
-But on Windows, the installer takes care of everything.
-
-\subsubsection{If symlinks were created}
-
-If you elected to create symlinks in standard directories (mentioned in
-section~\ref{sec:options}), then there is no need to edit environment
-variables.
-
-\subsubsection{Environment variables for Unix}
-\label{sec:env}
-
-The directory of the binaries for your platform must be added to
-the search path. Each supported platform has its own subdirectory
-under \dirname{TEXDIR/bin}. See figure~\ref{fig:bin-text} for the
-list of subdirectories and corresponding platforms.
-
-You can also add the documentation man and Info directories to their
-respective search paths, if you want the system tools to find them.
-
-For Bourne-compatible shells such as \prog{bash}, and using Intel x86
-GNU/Linux and a default directory setup as an example, the file to edit
-might be \filename{$HOME/.profile} (or another file sourced by
-\filename{.profile}, and the lines to add would look like this:
-
-\begin{sverbatim}
-PATH=/usr/local/texlive/2008/bin/i386-linux:$PATH; export PATH
-MANPATH=/usr/local/texlive/2008/texmf/doc/man:$MANPATH; export MANPATH
-INFOPATH=/usr/local/texlive/2008/texmf/doc/info:$INFOPATH; export INFOPATH
-\end{sverbatim}
-
-For csh or tcsh, the file to edit is typically \filename{$HOME/.cshrc}, and
-the lines to add might look like:
-
-\begin{sverbatim}
-setenv PATH /usr/local/texlive/2008/bin/i386-linux:$PATH
-setenv MANPATH /usr/local/texlive/2008/texmf/doc/man:$MANPATH
-setenv INFOPATH /usr/local/texlive/2008/texmf/doc/info:$INFOPATH
-\end{sverbatim}
-
-Of course, you may well already have settings somewhere in your ``dot''
-files, and so then the \TL\ directories should simply be merged in as
-appropriate.
-
-\subsubsection{Environment variables: global configuration}
-\label{sec:envglobal}
-
-If you want to make these changes globally, or for a user newly added to
-the system, then you are on your own; there is just too much variation
-between systems in how and where these things are configured.
-
-Our two hints are: 1)~you may want to check for a file
-\filename{/etc/manpath.config} and, if present, add lines such as
-
-\begin{sverbatim}
-MANPATH_MAP /usr/local/texlive/2008/bin/i386-linux \
- /usr/local/texlive/2008/texmf/doc/man
-\end{sverbatim}
-
-And 2)~check for a file \filename{/etc/environment} which may define the
-search path and other default environment variables.
-
-
-\subsubsection{When running from DVD}
-
-Normally, a \TL{} program consults a file \filename{texmf.cnf} for the
-location of the various trees. It looks for this file in a series of
-locations relative to its own location. However, this scheme breaks down
-when a program is run from \DVD{}: the \DVD{} is read-only. Some of the
-paths to be recorded in \filename{texmf.cnf} are only known at
-installation time, so this file cannot be on the \DVD{} and must be
-placed somewhere else. This makes it necessary to define an environment
-\envname{TEXMFCNF} variable which tells \TL{} programs in what directory
-to find this \filename{texmf.cnf}. It is also still necessary to modify
-the \envname{PATH} environment variable, as described before.
-
-At the end of the installation, the installer should have printed a
-message giving the value to which \envname{TEXMFCNF} should be set. In
-case you missed it: this value is \dirname{$TEXMFSYSVAR/web2c}. For the
-default, \dirname{/usr/local/texlive/2008/texmf-var/web2c}, you need the
-lines
-\begin{sverbatim}
-TEXMFCNF=/usr/local/texlive/2008/texmf-var/web2c; export TEXMFCNF
-\end{sverbatim}
-or, for [t]csh:
-\begin{sverbatim}
-setenv TEXMFCNF /usr/local/texlive/2008/texmf-var/web2c
-\end{sverbatim}
-
-
-\subsubsection{\ConTeXt{} Mark IV}
-
-The `old' \ConTeXt{} should run out of the box. The new `Mark IV'
-\ConTeXt{} will require manual setup; see
-\url{http://wiki.contextgarden.net/Running_Mark_IV}.
-
-
-\subsubsection{Integrating local and personal macros}
-\label{sec:local-personal-macros}
-
-This is already mentioned implicitly in section~\ref{sec:texmftrees}:
-\dirname{TEXMFLOCAL} (by default,
-\dirname{/usr/local/texlive/texmf-local} or
-\verb|C:\Program Files\texlive\texmf-local|)
-
-is intended for system-wide local fonts and macros; and
-\dirname{TEXMFHOME} (by default, \dirname{$HOME/texmf} or
-\verb|%USERPROFILE%\texmf|), is for personal fonts and macros. These
-directories are intended to stick around from release to release, and
-have their content seen automatically by a new \TL{} release.
-Therefore, it is best to refrain from changing the definition of
-\dirname{TEXMFLOCAL} to be too far away from the main \TL{} directory,
-or you will need to manually change future releases.
-
-For both trees, files should be placed in their proper subdirectories;
-see \url{http://tug.org/tds} or consult
-\filename{texmf/web2c/texmf.cnf}. For instance, a \LaTeX{} class file or
-package should be placed in \dirname{TEXMFLOCAL/tex/latex} or
-\dirname{TEXMFHOME/tex/latex}, or a subdirectory thereof.
-
-\dirname{TEXMFLOCAL} requires an up-to-date filename database, or files
-will not be found. You can update it with the command
-\cmdname{mktexlsr} or use the `Reinit file database' button on the
-configuration tab of \prog{tlmgr} in \GUI\ mode.
-
-\subsubsection{Integrating third-party fonts}
-
-This is unfortunately a very complicated and messy topic. Forget
-about it unless you really know your way around blindfolded in a
-\TeX{} installation. Don't forget to check first what you get for
-free: see section~\ref{sec:tl-fonts}.
-
-A possible alternative is to use \XeTeX (see
-section~\ref{sec:tex-extensions}), which lets you use operating system
-fonts without any installation in \TeX.
-
-
-\subsection{Testing the installation}
-\label{sec:test-install}
-
-After installing \TL{} as best you can, you naturally want to test
-it out, so you can start creating beautiful documents and\slash or fonts.
-
-This section gives some basic procedures for testing that the new system
-is functional. We give Unix commands here; under \MacOSX{} and Windows,
-you're more likely to run the tests through a graphical interface, but
-the principles are the same.
-
-\begin{enumerate}
-
-\item Make sure that you can run the \cmdname{tex} program in the first
-place:
-
-\begin{alltt}
-> \Ucom{tex -{}-version}
-TeX 3.1415926 (Web2C 7.5.7)
-kpathsea version 3.5.7
-...
-\end{alltt}
-If this comes back with `command not found' instead of version and
-copyright information, or with an older version, most likely you don't
-have the correct \dirname{bin} subdirectory in your \envname{PATH}. See
-the environment-setting information on \p.\pageref{sec:env}.
-
-\item Process a basic \LaTeX{} file:
-\begin{alltt}
-> \Ucom{latex sample2e.tex}
-This is pdfeTeXk, Version 3.1415926...
-...
-Output written on sample2e.dvi (3 pages, 7484 bytes).
-Transcript written on sample2e.log.
-\end{alltt}
-If this fails to find \filename{sample2e.tex} or other files, most
-likely you have interference from old environment variables or
-configuration files; we recommend unsetting all \TeX-related environment
-variables for a start. (For a deep analysis, you can ask \TeX{} to
-report on exactly what it is searching for, and finding; see ``Debugging
-actions'' on page~\pageref{sec:debugging}.)
-
-\item Preview the result online:
-\begin{alltt}
-> \Ucom{xdvi sample2e.dvi}
-\end{alltt}
-(Under Windows, the analogous command is \cmdname{dviout}.) You should
-see a new window with a nice document explaining some of the basics of
-\LaTeX{}. (Well worth reading, by the way if you're new to the system.)
-You do have to be running under X for \cmdname{xdvi} to work; if you're
-not, or your \envname{DISPLAY} environment variable is set incorrectly,
-you'll get an error \samp{Can't open display}.
-
-\item Create a \PS{} file for printing or display:
-\begin{alltt}
-> \Ucom{dvips sample2e.dvi -o sample2e.ps}
-\end{alltt}
-
-\item Create a \acro{PDF} file instead of \dvi{}; this processes the
-\filename{.tex} file and writes \acro{PDF} directly:
-\begin{alltt}
-> \Ucom{pdflatex sample2e.tex}
-\end{alltt}
-
-\item Preview the \acro{PDF} file:
-\begin{alltt}
-> \Ucom{gv sample2e.pdf}
-\textrm{or:}
-> \Ucom{xpdf sample2e.pdf}
-\end{alltt}
-Unfortunately neither \cmdname{gv} nor \cmdname{xpdf} are currently
-included in \TL{}, so you must install them separately. See
-\url{http://www.gnu.org/software/gv} and
-\url{http://www.foolabs.com/xpdf}, respectively. (There are plenty of
-other \acro{PDF} viewers, too.)
-
-\item Standard test files you may find useful in addition to
-\filename{sample2e.tex}:
-
-\begin{ttdescription}
-\item [small2e.tex] A simpler document than \filename{sample2e}, to
-reduce the input size if you're having troubles.
-\item [testpage.tex] Test if your printer introduces any offsets.
-\item [nfssfont.tex] For printing font tables and tests.
-\item [testfont.tex] Also for font tables, but using plain \TeX{}.
-\item [story.tex] The most canonical (plain) \TeX{} test file of all.
-You must type \samp{\bs bye} to the \code{*} prompt after \samp{tex
-story.tex}.
-\end{ttdescription}
-
-\end{enumerate}
-
-If you are new to \TeX{}, or otherwise need help with actually writing
-\TeX{} or \LaTeX{} documents, please visit
-\url{http://tug.org/begin.html} for some introductory resources.
-
-
-\section{Network installations}
-\label{sec:netinstall}
-
-\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
-\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.
-
-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.
-
-You can read more about \TL{} configuration and path searching in
-section~\ref{sec:kpathsea}.
-
-\section{Maximally portable \protect\TL{} on DVD and USB}
-\label{sec:portable-unix}
-
-The `running from \DVD{}' option described in
-section~\ref{sec:fromdvd} is fine for your own system, but if you
-are a guest on somebody else's system then you would probably like
-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
-secondary shell\slash command prompt with environment settings suitable
-for directly accessing the \TL{} on the \DVD.
-
-When it runs for the first time, some files will be generated in a
-directory \dirname{~/.tlportable2008}, which will take a little time.
-On subsequent runs, though, it will start almost instantaneously.
-
-The rest of the system will be unaware of \TL. If you want your editor
-to be aware of this \TL, then you can start it from a second, parallel,
-such \filename{tl-portable} session.
-
-You can also use \filename{tl-portable} to run \TL{} on a
-\acro{USB} stick. In this case, copy all the top-level files and
-the contents of the \dirname{bin}, \dirname{texmf},
-\dirname{texmf-dist}, and \dirname{tlpkg} directories (at least) to
-the stick. This may take quite a while! If you are copying to a
-\acro{FAT}32-formatted \acro{USB} stick, make sure to dereference
-symbolic links (\code{cp -L}). A \dirname{texmf-local} directory on
-the stick will also be found and used.
-
-Then run \filename{tl-portable} from the root of the stick, as above.
-In this case, the script will notice that the stick is writable and use
-it for generated files. You could burn the resulting contents of the
-stick back to \DVD{} if that is more convenient to (for example) give to
-others.
-
-
-\section{\cmdname{tlmgr}: Managing your installation}
-\label{sec:tlmgr}
-
-\begin{figure}[tb]
-\tlpng{tlmgr-gui}{\linewidth}
-\caption{\prog{tlmgr} in \GUI\ mode. The list of
- packages/collections/schemes only shows up after clicking the
- `Load' button.}\label{fig:tlmgr-gui}
-\end{figure}
-
-\begin{figure}[tb]
-\tlpng{tlmgr-config}{\linewidth}
-\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:
-
-\begin{itemize*}
-\item listing schemes, collections and packages;
-\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 changing installation options such as paper size and source
- location (see section~\ref{sec:location}).
-\end{itemize*}
-\textit{Warning:} \prog{tlmgr} has not been designed for or tested
-with installations which run from \DVD.
-
-\subsection{\cmdname{tlmgr} GUI mode}
-\prog{tlmgr} can be started in \GUI{} mode with
-\begin{alltt}
-> \Ucom{tlmgr -gui}
-\end{alltt}
-or in Windows via the Start menu: \texttt{Start}, \texttt{Programs},
-\texttt{TeX Live 2008}, \texttt{TeX Live Manager}. After clicking `Load'
-it displays a list of available and installed packages\Dash the latter
-prepended with `(i)'. This assumes of course that the installation
-source is valid and reachable.
-
-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:
-
-\begin{alltt}
-> \Ucom{tlmgr -location http://172.16.18.1/tldev install collection-xetex xkeyval}
-\end{alltt}
-It generates the following output:
-\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/2008/texmf/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-config/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-dist/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-doc/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/../texmf-local/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-var/ls-R...
-mktexlsr: Done.
-regenerating fmtutil.cnf
-running fmtutil-sys --missing
-...
-Transcript written on xelatex.log.
-fmtutil: /usr/local/texlive/2008/texmf-var/web2c/xetex/xelatex.fmt installed.
-\end{fverbatim}
-As you 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.)
-
-This example installs a new language. This also triggers format
-regeneration:
-\begin{alltt}
-> \Ucom{tlmgr install collection-langdutch}
-\end{alltt}
-To describe a package:
-\begin{alltt}
-> \Ucom{tlmgr show collection-wintools}
-\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
-\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}
-\end{alltt}
-
-
-\section{Notes on Windows}
-\label{sec:windows}
-
-\TL\ has a single installer which runs on both Windows and Unix. This
-was only possible by dropping support for older Windows versions, so
-\TL\ can now be installed only on Windows 2000 and later.
-
-
-\subsection{Windows-specific features}
-\label{sec:winfeatures}
-
-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.
-\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
- this.
-\end{description}
-
-\subsection{Additional included software}
-
-\begin{figure}[tb]
-\tlpng{psview}{.6\linewidth}
-\caption{PS\_View: very high magnifications available!}\label{fig:psview}
-\end{figure}
-
-To be complete, a \TL installation needs support packages that are not
-commonly found on a Windows machine. \TL{} provides the missing
-pieces:
-\begin{description}
-\item[Perl and Ghostscript.] Because of the importance of Perl and
- 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
- shouldn't interfere with any system installations of Perl or
- Ghostscript.
-\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
- \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}
-
-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.
-
-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.
-
-\subsection{Links for additional downloadable software}
-
-Urls for some other tools you may consider installing:
-\begin{description}
-\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/}
-\item[Perl] \url{http://www.perl.org/} with
- supplementary packages from \acro{CPAN}, \url{http://www.cpan.org/}
-\item[ImageMagick] \url{http://www.imagemagick.com}, for graphics
- processing and conversion
-\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:
- \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}.
- \end{itemize*}
-\end{description}
-
-
-\subsection{User Profile is Home}
-\label{sec:winhome}
-
-The Windows counterpart of a Unix home directory is the
-\verb|%USERPROFILE%| directory. Under Windows 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
-appropriately on both Windows and Unix.
-
-
-\subsection{The Windows registry}
-\label{sec:registry}
-
-Windows stores nearly all configuration data in its registry. The
-registry contains a set of hierarchically organized keys, with several
-root keys. The most important ones for installation programs are
-\path{HKEY_CURRENT_USER} and \path{HKEY_LOCAL_MACHINE}, \path{HKCU} and
-\path{HKLM} in short. The \path{HKCU} part of the registry is in the
-user's home directory (see section~\ref{sec:winhome}). \path{HKLM} is
-normally in a subdirectory of the Windows directory.
-
-In some cases, system information could be obtained from environment
-variables but for other information, for example the location of
-shortcuts, it is necessary to consult the registry. Setting environment
-variables permanently also requires registry access.
-
-
-\subsection{Windows permissions}
-\label{sec:winpermissions}
-
-In later versions of Windows, a distinction is made between regular
-users and administrators, where only the latter have free access to the
-entire operating system. In practice, though, you could better describe
-these classes of users as unprivileged users and normal users: being an
-administrator is the rule, not the exception. Nevertheless, we have made
-an effort to make \TL{} installable without administrative privileges.
-
-If the user is an administrator, shortcuts are created for all users,
-and the system environment is modified. Otherwise, shortcuts and menu
-entries are created for the current user, and the user environment is
-modified. Use the \optname{non-admin} option to \prog{install-tl} if
-you prefer per-user settings even as an administrator.
-
-Regardless of administrator status, the default root of \TL{} proposed
-by the installer is always under \verb|%PROGRAMFILES%|. The installer
-always tests whether the root is writable for the current user.
-
-A problem may arise if the user is not an administrator and \TeX{}
-already exists in the search path. Since the effective path consists of
-the system path followed by the user path, the new \TL{} will never get
-precedence. As a workaround, in this case the installer creates
-shortcuts to the command-prompt in which the new \TL{} binary directory
-is prepended to the local searchpath. The new \TL{} will be usable when
-run in a command-line session started from such a shortcut.
-
-
-\section{A user's guide to Web2C}
-
-\Webc{} is an integrated collection of \TeX-related programs: \TeX{}
-itself, \MF{}, \MP, \BibTeX{}, etc. It is the heart of \TL{}. The home
-page for \Webc{}, with the current manual and more, is
-\url{http://tug.org/web2c}.
-
-A bit of history: The original implementation was by Tomas Rokicki who,
-in 1987, developed a first \TeX{}-to-C system based on change files
-under Unix, which were primarily the original work of Howard Trickey and
-Pavel Curtis. Tim Morgan became the maintainer of the system, and
-during this period the name changed to Web-to-C\@. In 1990, Karl Berry
-took over the work, assisted by dozens of additional contributors, and
-in 1997 he handed the baton to Olaf Weber, who returned it to Karl in
-2006.
-
-The \Webc{} system runs on Unix, 32-bit Windows systems, \MacOSX{}, and
-other operating systems. It uses Knuth's original sources for \TeX{} and
-other basic programs written in the \web{} literate programming system
-and translates them into C source code. The core \TeX{} programs
-handled in this way are:
-
-\begin{cmddescription}
-\item[bibtex] Maintaining bibliographies.
-\item[dmp] \cmdname{troff} to MPX (\MP{} pictures).
-\item[dvicopy] Expands virtual font references in \dvi{} files.
-\item[dvitomp] \dvi{} to MPX (MetaPost pictures).
-\item[dvitype] \dvi{} to human-readable text.
-\item[gftodvi] Generic font proofsheets.
-\item[gftopk] Generic to packed fonts.
-\item[gftype] GF to human-readable text.
-\item[makempx] \MP{} label typesetting.
-\item[mf] Creating typeface families.
-\item[mft] Prettyprinting \MF{} source.
-\item[mpost] Creating technical diagrams.
-\item[mpto] MetaPost label extraction.
-\item[newer] Compare modification times.
-\item[patgen] Creating hyphenation patterns.
-\item[pktogf] Packed to generic fonts.
-\item[pktype] PK to human-readable text.
-\item[pltotf] Plain text property list to TFM.
-\item[pooltype] Display \web{} pool files.
-\item[tangle] \web{} to Pascal.
-\item[tex] Typesetting.
-\item[tftopl] TFM to plain text property list.
-\item[vftovp] Virtual font to virtual property list.
-\item[vptovf] Virtual property list to virtual font.
-\item[weave] \web{} to \TeX.
-\end{cmddescription}
-
-\noindent The precise functions and syntax of these programs are
-described in the documentation of the individual packages and of \Webc{}
-itself. However, knowing a few principles governing the whole family of
-programs will help you take advantage of your \Webc{} installation.
-
-All programs honor these standard \GNU options:
-\begin{ttdescription}
-\item[-{}-help] print basic usage summary.
-\item[-{}-verbose] print detailed progress report.
-\item[-{}-version] print version information, then exit.
-\end{ttdescription}
-
-For locating files the \Webc{} programs use the path searching library
-\KPS{} (\url{http://tug.org/kpathsea}). This library uses a combination
-of environment variables and a configuration files to optimize searching
-the (huge) collection of \TeX{} files. \Webc{} can look at many
-directory trees simultaneously, which is useful in maintaining \TeX's
-standard distribution and local and personal extensions in distinct
-trees. To speed up file searches, the root of each tree has a file
-\file{ls-R}, containing an entry showing the name and relative pathname
-for all files under that root.
-
-
-\subsection{Kpathsea path searching}
-\label{sec:kpathsea}
-
-Let us first describe the generic path searching mechanism of the \KPS{}
-library.
-
-We call a \emph{search path} a colon- or semicolon\hyph sepa\-rated list
-of \emph{path elements}, which are basically directory names. A
-search path can come from (a combination of) many sources. To look up
-a file \samp{my-file} along a path \samp{.:/dir}, \KPS{} checks each
-element of the path in turn: first \file{./my-file}, then
-\file{/dir/my-file}, returning the first match (or possibly all
-matches).
-
-In order to adapt optimally to all operating systems' conventions, on
-non-Unix systems \KPS{} can use filename separators different from
-colon (\samp{:}) and slash (\samp{/}).
-
-To check a particular path element \var{p}, \KPS{} first checks if a
-prebuilt database (see ``Filename data\-base'' on
-page~\pageref{sec:filename-database}) applies to \var{p}, i.e., if the
-database is in a directory that is a prefix of \var{p}. If so, the path
-specification is matched against the contents of the database.
-
-If the database does not exist, or does not apply to this path
-element, or contains no matches, the filesystem is searched (if this
-was not forbidden by a specification starting with \samp{!!}\ and if
-the file being searched for must exist). \KPS{} constructs the list
-of directories that correspond to this path element, and then checks
-in each for the file being sought.
-
-The ``file must exist'' condition comes into play with \samp{.vf} files and
-input files read by \TeX's \cs{openin} command. Such files may not
-exist (e.g., \file{cmr10.vf}), and so it would be wrong to search the
-disk for them. Therefore, if you fail to update \file{ls-R} when you
-install a new \samp{.vf} file, it will never be found.
-Each path element is checked in turn: first the database, then the
-disk. If a match is found, the search stops and the result is
-returned.
-
-Although the simplest and most common path element is a directory
-name, \KPS{} supports additional features in search paths: layered
-default values, environment variable names, config file values, users'
-home directories, and recursive subdirectory searching. Thus, we say
-that \KPS{} \emph{expands} a path element, meaning it transforms all
-the specifications into basic directory name or names. This is
-described in the following sections in the same order as it takes
-place.
-
-Note that if the filename being searched for is absolute or explicitly
-relative, i.e., starts with \samp{/} or \samp{./} or \samp{../},
-\KPS{} simply checks if that file exists.
-
-\ifSingleColumn
-\else
-\begin{figure*}
-\verbatiminput{examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{An illustrative configuration file sample}
- \label{fig:config-sample}
-\end{figure*}
-\fi
-
-\subsubsection{Path sources}
-\label{sec:path-sources}
-
-A search path can come from many sources. In the order in which
-\KPS{} uses them:
-
-\begin{enumerate}
-\item
- A user-set environment variable, for instance, \envname{TEXINPUTS}\@.
- Environment variables with a period and a program name appended
- override; e.g., if \samp{latex} is the name of the program being run,
- then \envname{TEXINPUTS.latex} will override \envname{TEXINPUTS}.
-\item
- A program-specific configuration file, for exam\-ple, a line
- \samp{S /a:/b} in \cmdname{dvips}'s \file{config.ps}.
-\item A \KPS{} configuration file \file{texmf.cnf}, containing a line like
- \samp{TEXINPUTS=/c:/d} (see below).
-\item The compile-time default.
-\end{enumerate}
-\noindent You can see each of these values for a given search path by
-using the debugging options (see ``Debugging actions'' on
-page~\pageref{sec:debugging}).
-
-\subsubsection{Config files}
-
-\begingroup\tolerance=3500
-\KPS{} reads \emph{runtime configuration files} named \file{texmf.cnf}
-for search path and other definitions. The search path used to look
-for these files is named \envname{TEXMFCNF} (by default such a file lives
-in the \file{texmf/web2c} subdirectory). \emph{All}
-\file{texmf.cnf} files in the search path will be read and definitions
-in earlier files override those in later files. Thus, with a search
-path of \verb|.:$TEXMF|, values from \file{./texmf.cnf} override those
-from \verb|$TEXMF/texmf.cnf|.
-\endgroup
-
-\begin{itemize}
-\item
- Comments start with \code{\%} and continue to the end of the line.
-\item
- Blank lines are ignored.
-\item
- A \bs{} at the end of a line acts as a continuation character,
- i.e., the next line is appended. Whitespace at the beginning of
- continuation lines is not ignored.
-\item
- Each remaining line has the form:
-\begin{alltt}
- \var{variable}[.\var{progname}] [=] \var{value}
-\end{alltt}%
- where the \samp{=} and surrounding whitespace are optional.
-\item
- The \ttvar{variable} name may contain any character other
- than whitespace, \samp{=}, or \samp{.}, but sticking to
- \samp{A-Za-z\_} is safest.
-\item
- If \samp{.\var{progname}} is present, the definition only
- applies if the program that is running is named
- \texttt{\var{progname}} or \texttt{\var{progname}.exe}. This allows
- different flavors of \TeX{} to have different search paths, for
- example.
-\item \var{value} may contain any characters except
- \code{\%} and \samp{@}. The
- \code{\$\var{var}.\var{prog}} feature is not available on the
- right-hand side; instead, you must use an additional variable. A
- \samp{;}\ in \var{value} is translated to \samp{:}\ if
- running under Unix; this is useful to be able to have a single
- \file{texmf.cnf} for Unix, \acro{MS-DOS} and Windows systems.
-\item
- All definitions are read before anything is expanded, so
- variables can be referenced before they are defined.
-\end{itemize}
-A configuration file fragment illustrating most of these points is
-\ifSingleColumn
-shown below:
-
-\verbatiminput{examples/ex5.tex}
-\else
-shown in Figure~\ref{fig:config-sample}.
-\fi
-
-\subsubsection{Path expansion}
-\label{sec:path-expansion}
-
-
-\KPS{} recognizes certain special characters and constructions in
-search paths, similar to those available in Unix shells. As a
-general example, the complex path,
-\verb+~$USER/{foo,bar}//baz+, expands to all subdirectories under
-directories \file{foo} and \file{bar} in \texttt{\$USER}'s home
-directory that contain a directory or file \file{baz}. These
-expansions are explained in the sections below.
-%$
-\subsubsection{Default expansion}
-\label{sec:default-expansion}
-
-\tolerance=2500
-If the highest-priority search path (see ``Path sources'' on
-page~\pageref{sec:path-sources}) contains an \emph{extra colon} (i.e.,
-leading, trailing, or doubled), \KPS{} inserts at that point the
-next-highest-prio\-rity search path that is defined. If that inserted
-path has an extra colon, the same happens with the next highest. For
-example, given an environment variable setting
-
-\tolerance=1500
-
-\begin{alltt}
-> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
-and a \code{TEXINPUTS} value from \file{texmf.cnf} of
-
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
-then the final value used for searching will be:
-
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-
-Since it would be useless to insert the default value in more than one
-place, \KPS{} changes only one extra \samp{:}\ and leaves any others in
-place. It checks first for a leading \samp{:}, then a trailing
-\samp{:}, then a doubled \samp{:}.
-
-\subsubsection{Brace expansion}
-
-A useful feature is brace expansion, which means that, for instance,
-\verb+v{a,b}w+ expands to \verb+vaw:vbw+. Nesting is allowed.
-This is used to implement multiple \TeX{} hierarchies, by
-assigning a brace list to \code{\$TEXMF}.
-For example, in \file{texmf.cnf}, the following definition
-(appproximately; there are actually even more trees) is made:
-\begin{verbatim}
- TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN}
-\end{verbatim}
-Using this you can then write something like
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-%$
-which means that, after looking in the current directory, the
-\code{\$TEXMFHOME/tex}, \code{\$TEXMFLOCAL/tex}, \code{\$TEXMFVAR/tex}
-and \code{\$TEXMFMAIN/tex} trees \emph{only}) will be searched (the
-last two use using \file{ls-R} data base files). It is a convenient
-way for running two parallel \TeX{} structures, one ``frozen'' (on a
-\CD, for instance) and the other being continuously updated with new
-versions as they become available. By using the \code{\$TEXMF}
-variable in all definitions, one is sure to always search the
-up-to-date tree first.
-
-\subsubsection{Subdirectory expansion}
-\label{sec:subdirectory-expansion}
-
-Two or more consecutive slashes in a path element following a directory
-\var{d} is replaced by all subdirectories of \var{d}: first those
-subdirectories directly under \var{d}, then the subsubdirectories under
-those, and so on. At each level, the order in which the directories are
-searched is \emph{unspecified}.
-
-If you specify any filename components after the \samp{//}, only
-subdirectories with matching components are included. For example,
-\samp{/a//b} expands into directories \file{/a/1/b}, \file{/a/2/b},
-\file{/a/1/1/b}, and so on, but not \file{/a/b/c} or \file{/a/1}.
-
-Multiple \samp{//} constructs in a path are possible, but
-\samp{//} at the beginning of a path is ignored.
-
-\subsubsection{List of special characters and their meaning: a summary}
-
-The following list summarizes the special characters in \KPS{}
-configuration files.
-
-% need a wider space for the item labels here.
-\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
-\begin{ttdescription}
-\item[\CODE{:}] Separator in path specification; at the beginning or
- the end of a path it substitutes the default path expansion.\par
-\item[\CODE{;}] Separator on non-Unix systems (acts like \code{:}).
-\item[\CODE{\$}] Variable expansion.
-\item[\CODE{\string~}] Represents the user's home directory.
-\item[\CODE{\char`\{...\char`\}}] Brace expansion.
-\item[\CODE{//}] Subdirectory expansion (can occur anywhere in
- a path, except at its beginning).
-\item[\CODE{\%}] Start of comment.
-\item[\CODE{\bs}] Continuation character (allows multi-line entries).
-\item[\CODE{!!}] Search \emph{only} database to locate file, \emph{do
- not} search the disk.
-\end{ttdescription}
-
-
-\subsection{Filename databases}
-\label{sec:filename-database}
-
-\KPS{} goes to some lengths to minimize disk accesses for searches.
-Nevertheless, at installations with enough directories, searching each
-possible directory for a given file can take an excessively long time
-(this is especially true if many hundreds of font directories have to
-be traversed.) Therefore, \KPS{} can use an externally-built plain text
-``database'' file named \file{ls-R} that maps files to directories,
-thus avoiding the need to exhaustively search the disk.
-
-A second database file \file{aliases} allows you to give additional
-names to the files listed in \file{ls-R}. This can be helpful to
-confirm to \acro{DOS} 8.3 filename conventions in source files.
-
-\subsubsection{The filename database}
-\label{sec:ls-R}
-
-As explained above, the name of the main filename database must be
-\file{ls-R}. You can put one at the root of each \TeX{} hierarchy in
-your installation that you wish to be searched (\code{\$TEXMF} by
-default); most sites have only one hierarchy. \KPS{} looks for
-\file{ls-R} files along the \code{TEXMFDBS} path.
-
-The recommended way to create and maintain \samp{ls-R} is to run the
-\code{mktexlsr} script included with the distribution. It is invoked
-by the various \samp{mktex}\dots\ scripts. In principle, this script
-just runs the command
-\begin{alltt}
-cd \var{/your/texmf/root} && \path|\|ls -1LAR ./ >ls-R
-\end{alltt}
-presuming your system's \code{ls} produces the right output format
-(\GNU \code{ls} is all right). To ensure that the database is
-always up-to-date, it is easiest to rebuild it regularly via
-\code{cron}, so that it is automatically updated when the installed
-files change, such as after installing or updating a \LaTeX{} package.
-
-If a file is not found in the database, by default \KPS{} goes ahead
-and searches the disk. If a particular path element begins with
-\samp{!!}, however, \emph{only} the database will be searched for that
-element, never the disk.
-
-
-\subsubsection{kpsewhich: Standalone path searching}
-\label{sec:invoking-kpsewhich}
-
-The \texttt{kpsewhich} program exercises path searching independent of any
-particular application. This can be useful as a sort of \code{find}
-program to locate files in \TeX{} hierarchies (this is used heavily in
-the distributed \samp{mktex}\dots\ scripts).
-
-\begin{alltt}
-> \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}}
-\end{alltt}
-The options specified in \ttvar{option} start with either \samp{-}
-or \samp{-{}-}, and any unambiguous abbreviation is accepted.
-
-\KPS{} looks up each non-option argument on the command line as a
-filename, and returns the first file found. There is no option to
-return all the files with a particular name (you can run the Unix
-\samp{find} utility for that).
-
-The most common options are described next.
-
-\begin{ttdescription}
-\item[\texttt{-{}-dpi=\var{num}}]\mbox{}
- Set the resolution to \ttvar{num}; this only affects \samp{gf}
- and \samp{pk} lookups. \samp{-D} is a synonym, for compatibility
- with \cmdname{dvips}. Default is 600.
-
-\item[\texttt{-{}-format=\var{name}}]\mbox{}\\
- Set the format for lookup to \ttvar{name}. By default, the
- format is guessed from the filename. For formats which do not have
- an associated unambiguous suffix, such as \MP{} support files and
- \cmdname{dvips} configuration files, you have to specify the name as
- known to \KPS{}, such as \texttt{tex} or \texttt{enc files}. Run
- \texttt{kpsewhich -{}-help} for a list.
-
-\item[\texttt{-{}-mode=\var{string}}]\mbox{}\\
- Set the mode name to \ttvar{string}; this only affects \samp{gf}
- and \samp{pk} lookups. No default: any mode will be found.
-\item[\texttt{-{}-must-exist}]\mbox{}\\
- Do everything possible to find the files, notably including
- searching the disk. By default, only the \file{ls-R} database is
- checked, in the interest of efficiency.
-\item[\texttt{-{}-path=\var{string}}]\mbox{}\\
- Search along the path \ttvar{string} (colon-separated as usual),
- instead of guessing the search path from the filename. \samp{//} and
- all the usual expansions are supported. The options \samp{-{}-path}
- and \samp{-{}-format} are mutually exclusive.
-\item[\texttt{-{}-progname=\var{name}}]\mbox{}\\
- Set the program name to \texttt{\var{name}}.
- This can affect the search paths via the \texttt{.\var{progname}}
- feature.
- The default is \cmdname{kpsewhich}.
-\item[\texttt{-{}-show-path=\var{name}}]\mbox{}\\
- shows the path used for file lookups of file type \texttt{\var{name}}.
- Either a filename extension (\code{.pk}, \code{.vf}, etc.) or a
- name can be used, just as with \samp{-{}-format} option.
-\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\
- sets the debugging options to \texttt{\var{num}}.
-\end{ttdescription}
-
-
-\subsubsection{Examples of use}
-\label{sec:examples-of-use}
-
-Let us now have a look at \KPS{} in action. Here's a straightforward search:
-
-\begin{alltt}
-> \Ucom{kpsewhich article.cls}
- /usr/local/texmf-dist/tex/latex/base/article.cls
-\end{alltt}
-We are looking for the file \file{article.cls}. Since the \samp{.cls}
-suffix is unambiguous we do not need to specify that we want to look for a
-file of type \optname{tex} (\TeX{} source file directories). We find it in
-the subdirectory \file{tex/latex/base} below the \samp{texmf-dist} \TL\
-directory. Similarly, all of the following are found without problems
-thanks to their unambiguous suffix.
-\begin{alltt}
-> \Ucom{kpsewhich array.sty}
- /usr/local/texmf-dist/tex/latex/tools/array.sty
-> \Ucom{kpsewhich latin1.def}
- /usr/local/texmf-dist/tex/latex/base/latin1.def
-> \Ucom{kpsewhich size10.clo}
- /usr/local/texmf-dist/tex/latex/base/size10.clo
-> \Ucom{kpsewhich small2e.tex}
- /usr/local/texmf-dist/tex/latex/base/small2e.tex
-> \Ucom{kpsewhich tugboat.bib}
- /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-By the way, that last is a \BibTeX{} bibliography database for \textsl{TUGBoat} articles.
-
-\begin{alltt}
-> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
-Font bitmap glyph files of type \file{.pk} are used by display
-programs like \cmdname{dvips} and \cmdname{xdvi}. Nothing is returned in
-this case since there are no pre-generated Computer Modern \samp{.pk}
-files in \TL{}\Dash the Type~1 variants are used by default.
-\begin{alltt}
-> \Ucom{kpsewhich wsuipa10.pk}
-\ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
-\else /usr/local/texmf-var/fonts/pk/ljfour/public/
-... wsuipa/wsuipa10.600pk
-\fi\end{alltt}
-For these fonts (a phonetic alphabet from the University of Washington)
-we had to generate \samp{.pk} files, and since the default \MF{} mode on
-our installation is \texttt{ljfour} with a base resolution of 600\dpi{}
-(dots per inch), this instantiation is returned.
-\begin{alltt}
-> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
-\end{alltt}
-In this case, when specifying that we are interested in a resolution
-of 300\dpi{} (\texttt{-dpi=300}) we see that no such font is available on
-the system. A program like \cmdname{dvips} or \cmdname{xdvi} would
-go off and actually build the required \texttt{.pk} files
-using the script \cmdname{mktexpk}.
-
-Next we turn our attention to \cmdname{dvips}'s header and configuration
-files. We first look at one of the commonly used files, the general
-prologue \file{tex.pro} for \TeX{} support, before turning our attention
-to the generic configuration file (\file{config.ps}) and the \PS{} font
-map \file{psfonts.map}\Dash as of 2004, map and encoding files have
-their own search paths and new location in \dirname{texmf} trees. As
-the \samp{.ps} suffix is ambiguous we have to specify explicitly which
-type we are considering (\optname{dvips config}) for the file
-\texttt{config.ps}.
-\begin{alltt}
-> \Ucom{kpsewhich tex.pro}
- /usr/local/texmf/dvips/base/tex.pro
-> \Ucom{kpsewhich --format="dvips config" config.ps}
- /usr/local/texmf/dvips/config/config.ps
-> \Ucom{kpsewhich psfonts.map}
- /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map
-\end{alltt}
-
-We now take a closer look at the \acro{URW} Times \PS{} support
-files. The prefix for these in the standard font naming scheme is
-\samp{utm}. The first file we look at is the configuration file,
-which contains the name of the map file:
-\begin{alltt}
-> \Ucom{kpsewhich --format="dvips config" config.utm}
- /usr/local/texmf-dist/dvips/psnfss/config.utm
-\end{alltt}
-The contents of that file is
-\begin{alltt}
- p +utm.map
-\end{alltt}
-which points to the file \file{utm.map}, which we want to
-locate next.
-\begin{alltt}
-> \Ucom{kpsewhich utm.map}
- /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
-\end{alltt}
-This map file defines the file names of the Type~1 \PS{} fonts in
-the URW collection. Its contents look like (we only show part of the
-lines):
-\begin{alltt}
-utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
-utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
-utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
-Let us, for instance, take the Times Roman instance
-\file{utmr8a.pfb} and find its position in the \file{texmf} directory
-tree with a search for Type~1 font files:
-\begin{alltt}
-> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
-\else /usr/local/texmf-dist/fonts/type1/
-... urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
-It should be evident from these examples how you can easily locate the
-whereabouts of a given file. This is especially important if you suspect
-that the wrong version of a file is picked up somehow, since
-\cmdname{kpsewhich} will show you the first file encountered.
-
-\subsubsection{Debugging actions}
-\label{sec:debugging}
-
-Sometimes it is necessary to investigate how a program resolves file
-references. To make this practical, \KPS{} offers various levels of
-debugging output:
-
-\begin{ttdescription}
-\item[\texttt{\ 1}] \texttt{stat} calls (disk lookups). When running
- with an up-to-date \file{ls-R} database this should almost give no
- output.
-\item[\texttt{\ 2}] References to hash tables (such as \file{ls-R}
- databases, map files, configuration files).
-\item[\texttt{\ 4}] File open and close operations.
-\item[\texttt{\ 8}] General path information for file types
- searched by \KPS. This is useful to find out where a particular
- path for the file was defined.
-\item[\texttt{16}] Directory list for each path element (only relevant
- for searches on disk).
-\item[\texttt{32}] File searches.
-\item[\texttt{64}] Variable values.
-\end{ttdescription}
-A value of \texttt{-1} will set all the above options; in practice,
-this is usually the most convenient.
-
-Similarly, with the \cmdname{dvips} program, by setting a combination of
-debug switches, one can follow in detail where files are being picked up
-from. Alternatively, when a file is not found, the debug trace shows in
-which directories the program looks for the given file, so that one can
-get an indication what the problem~is.
-
-Generally speaking, as most programs call the \KPS{} library
-internally, one can select a debug option by using the
-\envname{KPATHSEA\_DEBUG} environment variable, and setting it to (a
-combination of) values as described in the above list.
-
-(Note for Windows users: it is not easy to redirect
-all messages to a file in this system. For diagnostic purposes
-you can temporarily \texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log}).
-
-Let us consider, as an example, a small \LaTeX{} source file,
-\file{hello-world.tex}, which contains the following input.
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
-This little file only uses the font \file{cmr10}, so let us look at
-how \cmdname{dvips} prepares the \PS{} file (we want to use the Type~1
-version of the Computer Modern fonts, hence the option \texttt{-Pcms}).
-\begin{alltt}
-> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
-In this case we have combined \cmdname{dvips}'s debug class 4 (font
-paths) with \KPS's path element expansion (see \cmdname{dvips} Reference
-Manual, \OnCD{texmf/doc/dvips/dvips.pdf}).
-The output (slightly rearranged) appears in
-Figure~\ref{fig:dvipsdbga}.
-\begin{figure*}[tp]
-\centering
-\input{examples/ex6a.tex}
-\caption{Finding configuration files}\label{fig:dvipsdbga}
-
-\bigskip
-
-\input{examples/ex6b.tex}
-\caption{Finding the prolog file}\label{fig:dvipsdbgb}
-
-\bigskip
-
-\input{examples/ex6c.tex}
-\caption{Finding the font file}\label{fig:dvipsdbgc}
-\end{figure*}
-
-\cmdname{dvips} starts by locating its working files. First,
-\file{texmf.cnf} is found, which gives the definitions of the search
-paths for the other files, then the file database \file{ls-R} (to
-optimize file searching) and the file \file{aliases}, which makes it
-possible to declare several names (e.g., a short \acro{DOS}-like 8.3 and
-a more natural longer version) for the same file. Then \cmdname{dvips}
-goes on to find the generic configuration file \file{config.ps}
-before looking for the customization file \file{.dvipsrc} (which, in
-this case is \emph{not found}). Finally, \cmdname{dvips} locates the
-config file for the Computer Modern \PS{} fonts \file{config.cms}
-(this was initiated with the \texttt{-Pcms} option on the \cmdname{dvips}
-command). This file contains the list of the map files which
-define the relation between the \TeX{}, \PS{} and file system
-names of the fonts.
-\begin{alltt}
-> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
- p +ams.map
- p +cms.map
- p +cmbkm.map
- p +amsbkm.map
-\end{alltt}
-\cmdname{dvips} thus goes on to find all these files, plus the generic
-map file \file{psfonts.map}, which is always loaded (it contains
-declarations for commonly used \PS{} fonts; see the last part of
-Section \ref{sec:examples-of-use} for more details about \PS{} map
-file handling).
-
-At this point \cmdname{dvips} identifies itself to the user:
-\begin{alltt}
-This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com)
-\end{alltt}
-\ifSingleColumn
-Then it goes on to look for the prolog file \file{texc.pro}:
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
-Then it goes on to look for the prolog file \file{texc.pro} (see
-Figure~\ref{fig:dvipsdbgb}).
-\fi
-
-After having found the file in question, \cmdname{dvips} outputs
-the date and time, and informs us that it will generate the
-file \file{hello-world.ps}, then that it needs the font file
-\file{cmr10}, and that the latter is declared as ``resident'' (no
-bitmaps needed):
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
-Now the search is on for the file \file{cmr10.tfm}, which is found,
-then a few more prolog files (not shown) are referenced, and finally
-the Type~1 instance \file{cmr10.pfb} of the font is located and
-included in the output file (see last line).
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-\subsection{Runtime options}
-
-Another useful feature of \Webc{} is its possibility to control a number
-of memory parameters (in particular, array sizes) via the runtime file
-\file{texmf.cnf} read by \KPS{}. The memory settings can be found in
-Part 3 of that file in the \TL{} distribution. The more important
-are:
-
-\begin{ttdescription}
-\item[\texttt{main\_memory}]
- Total words of memory available, for
- \TeX{}, \MF{} and \MP. You must make a new format file for each
- different setting. For instance, you could generate a ``huge''
- version of \TeX{}, and call the format file \texttt{hugetex.fmt}.
- Using the standard way of specifying the program name used by \KPS{},
- the particular value of the \texttt{main\_memory} variable will then
- be read from \file{texmf.cnf}.
-\item[\texttt{extra\_mem\_bot}]
- Extra space for ``large'' \TeX{} data structures:
- boxes, glue, breakpoints, etc. Especially useful if you use
- \PiCTeX{}.
-\item[\texttt{font\_mem\_size}]
- Number of words for font information available for \TeX. This
- is more or less the total size of all \acro{TFM} files read.
-\item[\texttt{hash\_extra}]
- Additional space for the hash table of control sequence names.
- Only $\approx$10,000 control sequences can be stored in the main
- hash table; if you have a large book with numerous cross-references,
- this might not be enough. The default value of
- \texttt{hash\_extra} is \texttt{50000}.
-\end{ttdescription}
-
-\noindent Of course, this facility is no substitute for truly dynamic
-arrays and memory allocation, but since these are extremely difficult to
-implement in the present \TeX{} source, these runtime parameters provide
-a practical compromise allowing some flexibility.
-
-
-\begin{comment}
-\section{Building on a new Unix platform}
-
-If you have a platform for which executables are not included, you will
-need to compile \TeX{} and friends. This is not as hard as it
-sounds. What you need is all in the directory \texttt{source} in the
-distribution.
-
-\subsection{Prerequisites}
-
-You will need at least 100 megabytes of disk space to compile all of
-\TeX{} and its support programs. You'll also need an \acro{ANSI} C
-compiler, a \cmdname{make} utility, a lexical scanner, and a parser
-generator. We recommend the \GNU version of these programs
-(\cmdname{gcc}, \GNU \cmdname{make}, \cmdname{m4}, \cmdname{flex},
-\cmdname{bison}). You may be able to work with other C compilers and
-\cmdname{make} programs, but you will need a good understanding of
-building Unix programs to sort out problems.
-
-Also, the command \texttt{uname} must return a sensible value.
-
-
-\subsection{Configuration}
-
-To begin, perform a normal installation of \TL{} to your disk (see
-section~\ref{sec:install-disk} on
-\p.\pageref{sec:install-disk}). You may wish to skip installing
-all of the prebuilt binaries.
-
-Then, unpack the source from the compressed \texttt{tar} file in the
-directory \dirname{source} to your disk and change directory to where
-you placed it.
-
-Next, run \cmdname{configure} with a command line like this:
-\begin{alltt}
-> \Ucom{sh configure -prefix=/usr/local/TeX}
-\end{alltt}
-
-The \optname{-prefix} directory is the one where you installed the
-support tree; the directory layout will be as follows (where \$TEXDIR
-stands for the directory you chose):
-
-\noindent
-\begin{tabular}{>{\ttfamily}ll@{}}
- \dirname{$TEXDIR/share/texmf} & main tree with fonts,\\
- & \qquad macros, etc\\
- \dirname{$TEXDIR/man} & Unix manual pages\\
- \dirname{$TEXDIR/info} & \GNU style Info manuals\\
- \dirname{$TEXDIR/bin/$PLATFORM} & binaries\\
-\end{tabular}
-%$
-
-If you want to leave out the \dirname{$PLATFORM} directory level,
-i.e., put the binaries directly into \dirname{$TEXDIR/bin}, specify
-the \verb|--disable-multiplatform| option to \cmdname{configure}.
-
-Have a look at the output of \verb|./configure --help| for more
-options you can use. For example, you can skip building of \OMEGA{} and
-\eTeX{}.
-
-
-\subsection{Running \cmdname{make}}
-
-Make sure the shell variable or option \texttt{noclobber} is not set.
-Then, run the main \cmdname{make} like this:
-\begin{alltt}
-> \Ucom{make world}
-\end{alltt}
-and relax\ldots
-
-Alternatively, you want to log all the output, as in:
-\begin{alltt}
-> \Ucom{sh -c "make world >world.log 2>\&1" \&}
-\end{alltt}
-
-Before you believe that everything went ok, please check the log file
-for errors: \GNU \cmdname{make} always uses the string \samp{***}
-whenever a command fails. Also, check if all the programs were built:
-
-\begin{alltt}
-> \Ucom{cd \var{TEXDIR}/bin/\var{archname}}
-> \Ucom{ls | wc}
-\end{alltt}
-The result should be over 200 (you can check the exact number with the
-\dirname{bin} directory contents in the distribution).
-
-If you need special privileges for \texttt{make install}, you can
-separate the \samp{make world} into two different runs, like this:
-\begin{alltt}
-> \Ucom{make all}
-> \Ucom{su}
-> \Ucom{make install strip}
-\end{alltt}
-
-After you've installed your new binaries, you should follow the normal
-post-installation procedures, given in section~\ref{sec:postinstall}
-(\p.\pageref{sec:postinstall}).
-
-Also, if you'd like to make your binaries available to others, please
-contact us. We'll be happy to put them on the \TL\ web pages.
-\end{comment}
-
-\htmlanchor{ack}
-\section{Acknowledgements}
-
-\TL{} is a joint effort by virtually all of the \TeX{} user groups.
-This edition of \TL{} was overseen by Karl Berry. The other principal
-contributors, past and present, are listed below.
-
-\begin{itemize*}
-
-\item The English, German, Dutch, and Polish \TeX{} user groups
-(\acro{TUG}, \acro{DANTE} e.V., \acro{NTG}, and \acro{GUST},
-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,
-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
-autotools usage throughout \TL.
-
-\item Thomas Esser, without whose marvelous \teTeX{} package \TL{}
-would have never existed.
-
-\item Michel Goossens, who co-authored the original documentation.
-
-\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.
-
-\item \Thanh, Martin Schr\"oder, and the pdf\TeX\ team
-(\url{http://pdftex.org}) for continuing enhancements of \TeX's
-abilities.
-
-\item Hans Hagen, for much testing and making his \ConTeXt\ format
-(\url{http://pragma-ade.com}) work within \TL's framework.
-
-\item Hartmut Henkel, for significant development contributions to
-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.
-
-\item Pawe{\l} Jackowski, for the Windows installer \cmdname{tlpm},
-and Tomasz {\L}uczak, for \cmdname{tlpmgui}, used in past releases.
-
-\item Akira Kakuto, for providing the Windows
-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 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
-so.
-
-\item Reinhard Kotucha, for major contributions to the \TL{} 2008
-infrastructure and installer, as well as Windows research efforts, the
-\texttt{getnonfreefonts} script, and more.
-
-\item Siep Kroonenberg, also for major contributions to the \TL{} 2008
-infrastructure and installer, especially on Windows, and for the bulk of
-work updating this manual describing the new features.
-
-\item Petr Ol\v{s}ak, who coordinated and checked all the Czech and Slovak
-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.
-
-\item Fabrice Popineau, for the original Windows support in \TL{} and
-work on the French documentation.
-
-\item Norbert Preining, the principal architect of the \TL{} 2008
-infrastructure and installer, and also for coordinating the Debian
-version of \TL{} (together with Frank K\"uster), making many suggestions
-along the way.
-
-\item Sebastian Rahtz, for originally creating \TL{} and maintaining it
-for many years.
-
-\item Phil Taylor, for setting up the BitTorrent downloads.
-
-\item Vladimir Volovich, for substantial help with porting and other
-maintenance issues, and especially for making it feasible to include
-\cmdname{xindy}.
-
-\item Staszek Wawrykiewicz, the principal tester for all of \TL{},
-and coordinator of the many major Polish contributions: fonts, Windows
-installation, and more.
-
-\item Olaf Weber, for his patient maintenance of \Webc.
-
-\item Gerben Wierda, for creating and maintaining the \MacOSX\ support,
-and much integration and testing.
-
-\item Graham Williams, on whose work the \TeX\ Catalogue of packages depends.
-
-\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}),
-Akira Kakuto (\pkgname{win32}),
-Dick Koch (\pkgname{universal-darwin}),
-Manfred Lotz (\pkgname{i386-freebsd}),
-Norbert Preining (\pkgname{alpha-linux}),
-Arthur Reutenauer (\pkgname{sparc-linux}),
-Thomas Schmitz (\pkgname{powerpc-linux}),
-Apostolos Syropoulos (\pkgname{i386-solaris}),
-Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-solaris}),
-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),
-Klaus H\"oppner (German),
-Petr Sojka \& Jan Busa (Czech\slash Slovak),
-Boris Veytsman (Russian),
-Staszek Wawrykiewicz (Polish). The \TL{} documentation web page
-is \url{http://tug.org/texlive/doc.html}.
-
-Of course the most important acknowledgement must go to Donald Knuth,
-first for inventing \TeX, and then for giving it to the world.
-
-
-
-\section{Release history}
-\label{sec:history}
-
-\subsection{Past}
-
-Discussion began in late 1993 when the Dutch \TeX{} Users Group was
-starting work on its 4All\TeX{} \CD{} for \acro{MS-DOS} users, and it
-was hoped at that time to issue a single, rational, \CD{} for all
-systems. This was too ambitious a target for the time, but it did spawn
-not only the very successful 4All\TeX{} \CD{}, but also the \acro{TUG}
-Technical Council working group on a \emph{\TeX{} Directory Structure}
-(\url{http://tug.org/tds}), which specified how to create consistent and
-manageable collections of \TeX{} support files. A complete draft of the
-\TDS{} was published in the December 1995 issue of \textsl{TUGboat}, and
-it was clear from an early stage that one desirable product would be a
-model structure on \CD{}. The distribution you now have is a very direct
-result of the working group's deliberations. It was also clear that the
-success of the 4All\TeX{} \CD{} showed that Unix users would benefit
-from a similarly easy system, and this is the other main strand of
-\TL.
-
-We first undertook to make a new Unix-based \TDS{} \CD{} in the autumn
-of 1995, and quickly identified Thomas Esser's \teTeX{} as the ideal
-setup, as it already had multi-platform support and was built with
-portability across file systems in mind. Thomas agreed to help, and work
-began seriously at the start of 1996. The first edition was released in
-May 1996. At the start of 1997, Karl Berry completed a major new release
-of Web2c, which included nearly all the features which Thomas Esser had
-added in \teTeX, and we decided to base the 2nd edition of the \CD{} on
-the standard \Webc, with the addition of \teTeX's \texttt{texconfig}
-script. The 3rd edition of the \CD{} was based on a major revision of
-\Webc, 7.2, by Olaf Weber; at the same time, a new revision of \teTeX
-was being made, and \TL{} included almost all of its features. The
-4th edition followed the same pattern, using a new version of \teTeX,
-and a new release of \Webc{} (7.3). The system now included a complete
-Windows setup.
-
-For the 5th edition (March 2000) many parts of the \CD{} were revised
-and checked, updating hundreds of packages. Package details were stored
-in XML files. But the major change for \TeX\ Live 5 was that all
-non-free software was removed. Everything in \TL{} is now intended
-to be compatible with the Debian Free Software Guidelines
-(\url{http://www.debian.org/intro/free}); we have done our best to check
-the license conditions of all packages, but we would very much
-appreciate hearing of any mistakes.
-
-The 6th edition (July 2001) had much more material updated. The major
-change was a new install concept: the user could select a more exact set
-of needed collections. Language-related collections were completely
-reorganized, so selecting any of them installs not only macros, fonts,
-etc., but also prepares an appropriate \texttt{language.dat}.
-
-The 7th edition of 2002 had the notable addition of \MacOSX{} support,
-and the usual myriad of updates to all sorts of packages and
-programs. An important goal was integration of the source back with
-\teTeX, to correct the drift apart in versions~5 and~6.
-
-\subsubsection{2003}
-
-In 2003, with the continuing flood of updates and additions, we found
-that \TL{} had grown so large it could no longer be contained on a
-single \CD, so we split it into three different distributions (see
-section~\ref{sec:tl-coll-dists}, \p.\pageref{sec:tl-coll-dists}). In
-addition:
-
-\begin{itemize*}
-\item At the request of the \LaTeX{} team, we changed the standard
- \cmdname{latex} and \cmdname{pdflatex} commands to now use \eTeX{} (see
- \p.\pageref{text:etex}).
-\item The new Latin Modern fonts were included (and are recommended).
-\item Support for Alpha \acro{OSF} was removed
- (\acro{HPUX} support was removed previously), since no one had (or
- volunteered) hardware available on which to compile new binaries.
-\item Windows setup was substantially changed; for the first time
- an integrated environment based on XEmacs was introduced.
-\item Important supplementary programs for Windows
- (Perl, Ghost\-script, Image\-Magick, Ispell) are now installed
- in the \TL{} installation directory.
-\item Font map files used by \cmdname{dvips}, \cmdname{dvipdfm}
- and \cmdname{pdftex} are now generated by the new program
- \cmdname{updmap} and installed into \dirname{texmf/fonts/map}.
-\item \TeX{}, \MF{}, and \MP{} now, by default, output most input
- characters (32 and above) as themselves in output (e.g.,
- \verb|\write|) files,
- log files, and the terminal, i.e., \emph{not} translated using the
- \verb|^^| notation. In \TL{}~7, this translation was
- dependent on the system locale settings; now, locale settings do
- not influence the \TeX{} programs' behavior. If for some reason
- you need the \verb|^^| output, rename the file
- \verb|texmf/web2c/cp8bit.tcx|. (Future releases will have cleaner
- ways to control this.)
-\item This documentation was substantially revised.
-\item Finally, since the edition numbers had grown unwieldy,
- the version is now simply identified by the year: \TL{} 2003.
-\end{itemize*}
-
-
-\subsubsection{2004}
-
-2004 saw many changes:
-
-\begin{itemize}
-
-\item If you have locally-installed fonts which use their own
-\filename{.map} or (much less likely) \filename{.enc} support files, you
-may need to move those support files.
-
-\filename{.map} files are now searched for in subdirectories of
-\dirname{fonts/map} only (in each \filename{texmf} tree), along the
-\envname{TEXFONTMAPS} path. Similarly, \filename{.enc} files are now
-searched for in subdirectories of \dirname{fonts/enc} only, along the
-\envname{ENCFONTS} path. \cmdname{updmap} will attempt to warn about
-problematic files.
-
-For methods of handling this and other information, please see
-\url{http://tug.org/texlive/mapenc.html}.
-
-\item The \TK\ has been expanded with the addition of a \MIKTEX-based
-installable \CD, for those who prefer that implementation to Web2C.
-See section~\ref{sec:overview-tl} (\p.\pageref{sec:overview-tl}).
-
-\item Within \TL, the single large \dirname{texmf} tree of previous
-releases has been replaced by three: \dirname{texmf},
-\dirname{texmf-dist}, and \dirname{texmf-doc}. See
-section~\ref{sec:tld} (\p.\pageref{sec:tld}), and the \filename{README}
-files for each.
-
-\item All \TeX-related input files are now collected in
-the \dirname{tex} subdirectory of \dirname{texmf*} trees, rather than
-having separate sibling directories \dirname{tex}, \dirname{etex},
-\dirname{pdftex}, \dirname{pdfetex}, etc. See
-\CDref{texmf-doc/doc/english/tds/tds.html\#Extensions}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Extensions}}.
-
-\item Helper scripts (not meant to be invoked by users) are now located
-in a new \dirname{scripts} directory of \dirname{texmf*} trees, and
-searched for via \verb|kpsewhich -format=texmfscripts|. So if you have
-programs which call such scripts, they'll need to be adjusted. See
-\CDref{texmf-doc/doc/english/tds/tds.html\#Scripts}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Scripts}}.
-
-\item Almost all formats leave most characters printable as
-themselves via the ``translation file'' \filename{cp227.tcx}, instead of
-translating them with the \verb|^^| notation. Specifically, characters
-at positions 32--256, plus tab, vertical tab, and form feed are
-considered printable and not translated. The exceptions are plain \TeX\
-(only 32--126 printable), \ConTeXt\ (0--255 printable), and the
-\OMEGA-related formats. This default behavior is almost the same as in
-\TL\,2003, but it's implemented more cleanly, with more possibilities
-for customization. See \CDref{texmf/doc/web2c/web2c.html\#TCX-files}
-{\texttt{texmf/doc/web2c/web2c.html\#TCX-files}}.
-(By the way, with Unicode input, \TeX\ may output partial character
-sequences when showing error contexts, since it is byte-oriented.)
-
-\item \textsf{pdfetex} is now the default engine for all formats
-except (plain) \textsf{tex} itself. (Of course it generates \acro{DVI}
-when run as \textsf{latex}, etc.) This means, among other things, that
-the microtypographic features of \textsf{pdftex} are available in
-\LaTeX, \ConTeXt, etc., as well as the \eTeX\ features
-(\OnCD{texmf-dist/doc/etex/base/}).
-
-It also means it's \emph{more important than ever} to use the
-\pkgname{ifpdf} package (works with both plain and \LaTeX) or equivalent
-code, because simply testing whether \cs{pdfoutput} or some other
-primitive is defined is not a reliable way to determine if \acro{PDF}
-output is being generated. We made this backward compatible as best we
-could this year, but next year, \cs{pdfoutput} may be defined even when
-\acro{DVI} is being written.
-
-\item pdf\TeX\ (\url{http://pdftex.org}) has many new features:
-
- \begin{itemize*}
-
- \item \cs{pdfmapfile} and \cs{pdfmapline} provide font map support
- from within a document.
-
- \item Microtypographic font expansion can be used more easily.\\
- \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}
-
- \item All parameters previously set through the special configuration
- file \filename{pdftex.cfg} must now be set through primitives,
- typically in \filename{pdftexconfig.tex}; \filename{pdftex.cfg} is no
- longer supported. Any extant \filename{.fmt} files must be redumped
- when \filename{pdftexconfig.tex} is changed.
-
- \item See the pdf\TeX\ manual for more: \OnCD{texmf-dist/doc/pdftex/manual/pdftex-a.pdf}.
-
- \end{itemize*}
-
-\item The \cs{input} primitive in \cmdname{tex} (and \cmdname{mf} and
-\cmdname{mpost}) now accepts double quotes containing spaces and other
-special characters. Typical examples:
-\begin{verbatim}
-\input "filename with spaces" % plain
-\input{"filename with spaces"} % latex
-\end{verbatim}
-See the Web2C manual for more: \OnCD{texmf/doc/web2c}.
-
-\item enc\TeX\ support is now included within Web2C and consequently all
-\TeX\ programs, via the \optname{-enc} option\Dash \emph{only when
-formats are built}. enc\TeX\ supports general re-encoding of input and
-output, enabling full support of Unicode (in \acro{UTF}-8). See
-\OnCD{texmf-dist/doc/generic/enctex/} and
-\url{http://www.olsak.net/enctex.html}.
-
-\item Aleph, a new engine combining \eTeX\ and \OMEGA, is available.
-A little information is available in \OnCD{texmf-dist/doc/aleph/base}
-and \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}. The
-\LaTeX-based format for Aleph is named \textsf{lamed}.
-
-\item The latest \LaTeX\ release has a new version of the
-\acro{LPPL}\Dash now officially a Debian-approved license. Assorted
-other updates, see the \filename{ltnews} files in
-\OnCD{texmf-dist/doc/latex/base}.
-
-\item \cmdname{dvipng}, a new program for converting \acro{DVI} to
-\acro{PNG} image files, is included. See \OnCD{texmf/doc/man/man1/dvipng.1}.
-
-\item We reduced the \pkgname{cbgreek} package to a ``medium'' sized set
-of fonts, with the assent and advice of the author (Claudio Beccari).
-The excised fonts are the invisible, outline, and transparency ones,
-which are relatively rarely used, and we needed the space. The full set
-is of course available from \acro{CTAN}
-(\url{http://www.ctan.org/tex-archive/fonts/greek/cb}).
-
-\item \cmdname{oxdvi} has been removed; just use \cmdname{xdvi}.
-
-\item The \cmdname{ini} and \cmdname{vir} commands (links) for
-\cmdname{tex}, \cmdname{mf}, and \cmdname{mpost} are no longer created,
-such as \cmdname{initex}. The \cmdname{ini} functionality has been
-available through the command-line option \optname{-ini} for years now.
-
-\item \textsf{i386-openbsd} platform support was removed. Since the
-\pkgname{tetex} package in the \acro{BSD} Ports system is available, and
-\acro{GNU/}Linux and Free\acro{BSD} binaries were available, it seemed
-volunteer time could be better spent elsewhere.
-
-\item On \textsf{sparc-solaris} (at least), you may have to set the
-\envname{LD\_LIBRARY\_PATH} environment variable to run the
-\pkgname{t1utils} programs. This is because they are compiled with C++,
-and there is no standard location for the runtime libraries. (This is
-not new in 2004, but wasn't previously documented.) Similarly, on
-\textsf{mips-irix}, the \acro{MIPS}pro 7.4 runtimes are required.
-
-\end{itemize}
-
-\subsubsection{2005}
-
-2005 saw the usual huge number of updates to packages and programs.
-The infrastructure stayed relatively stable from 2004, but inevitably
-there were some changes there as well:
-
-\begin{itemize}
-
-\item New scripts \cmdname{texconfig-sys}, \cmdname{updmap-sys}, and
- \cmdname{fmtutil-sys} were introduced, which modify the
- configuration in the system trees. The \cmdname{texconfig},
- \cmdname{updmap}, and \cmdname{fmtutil} scripts now modify
- user-specific files, under \dirname{$HOME/.texlive2005}.
-
-\item Corresponding new variables \envname{TEXMFCONFIG} and
- \envname{TEXMFSYSCONFIG} to specify the trees where configuration
- files (user or system, respectively) are found. Thus, you may
- need to move personal versions of \filename{fmtutil.cnf} and
- \filename{updmap.cfg} to these places; another option is to
- redefine \envname{TEXMFCONFIG} or \envname{TEXMFSYSCONFIG} in
- \filename{texmf.cnf}. In any case the real location of these files
- and the values of \envname{TEXMFCONFIG} and \envname{TEXMFSYSCONFIG}
- must agree.
- 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
- 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
- can use the package \pkgname{ifpdf.sty} (which works under both
- plain \TeX\ and \LaTeX) to do this, or steal its logic.
-
-\item Last year, we changed most formats to output (8-bit) characters as
- themselves (see previous section). The new TCX file
- \filename{empty.tcx} now provides an easier way to get the
- original \verb|^^| notation if you so desire, as in:
-\begin{verbatim}
-latex --translate-file=empty.tcx yourfile.tex
-\end{verbatim}
-
-\item The new program \cmdname{dvipdfmx} is included for translation of
- DVI to PDF; this is an actively maintained update of
- \cmdname{dvipdfm} (which is also still available for now, though
- no longer recommended).
-
-\item The new programs \cmdname{pdfopen} and \cmdname{pdfclose} are included
- to allow reloading of pdf files in the Adobe Acrobat Reader without
- restarting the program. (Other pdf readers, notably \cmdname{xpdf},
- \cmdname{gv}, and \cmdname{gsview}, have never suffered from this
- problem.)
-
-\item For consistency, the variables \envname{HOMETEXMF} and
- \envname{VARTEXMF} have been renamed to \envname{TEXMFHOME} and
- \envname{TEXMFSYSVAR}, respectively. There is also
- \envname{TEXMFVAR}, which is by default user-specific. See the
- first point above.
-
-\end{itemize}
-
-
-\subsubsection{2006--2007}
-
-In 2006--2007, the major new addition to \TL{} was the \XeTeX{} 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}).
-
-The \TeX\ \filename{.fmt} (high-speed format) and the similar files for
-MetaPost and \MF\ are now stored in subdirectories of \dirname{texmf/web2c},
-instead of in the directory itself (although the directory is still
-searched, for the sake of existing \filename{.fmt}'s). The
-subdirectories are named for the `engine' in use, such as \filename{tex}
-or \filename{pdftex} or \filename{xetex}. This change should be
-invisible in normal use.
-
-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).
-
-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.
-
-Finally, in May 2006 Thomas Esser announced that he would no longer be
-updating te\TeX{} (\url{http://tug.org/tetex}). As a result, there was
-been a surge of interest in \TL{}, especially among \GNU/Linux
-distributors. (There is a new \texttt{tetex} installation scheme in
-\TL{}, which provides an approximate equivalent.) We hope this will
-eventually translate to improvements in the \TeX\ environment for
-everyone.
-
-\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}.
-
-Among other things, this finally makes possible upgrading a \TL{}
-installation over the Internet after the initial installation, a feature
-MiK\TeX\ has provided for many years. We expect to regularly update new
-packages as they are released to \CTAN.
-
-The major new engine Lua\TeX\ (\url{http://luatex.org}) is included;
-besides a new level of flexibility in typesetting, this provides an
-excellent scripting language for use both inside and outside of \TeX\
-documents.
-
-Support among Windows and the Unix-based platforms is now much more
-uniform. In particular, most Perl and Lua scripts are now available on
-Windows, using the Perl internally distributed with \TL.
-
-The new \cmdname{tlmgr} script (section~\ref{sec:tlmgr}) is the
-general interface for managing \TL{} after the initial installation.
-It handles package updates and consequent regeneration of formats, map
-files, and language files, optionally including local additions.
-
-With the advent of \cmdname{tlmgr}, the \cmdname{texconfig} actions to
-edit the format and hyphenation configuration files are now disabled.
-
-The \cmdname{xindy} indexing program
-(\url{http://xindy.sourceforge.net/}) is now included on most platforms.
-
-The \cmdname{kpsewhich} tool can now report all matches for a given file
-(option \optname{--all}) and limit matches to a given subdirectory
-(option \optname{--subdir}).
-
-The \cmdname{dvipdfmx} program now includes functionality to extract
-bounding box information, via the command name \cmdname{extractbb}; this
-was one of the last features provided by \cmdname{dvipdfm} not in
-\cmdname{dvipdfmx}.
-
-The font aliases \filename{Times-Roman}, \filename{Helvetica}, and so on
-have been removed. Different packages expected them to behave
-differently (in particular, to have different encodings), and there was
-no good way to resolve this.
-
-The \pkgname{platex} format has been removed, to resolve a name conflict
-with a completely different Japanese \pkgname{platex}; the
-\pkgname{polski} package is now the main Polish support.
-
-Internally, the \web\ string pool files are now compiled into the
-binaries, to ease upgrades.
-
-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}.
-
-
-\subsection{Future}
-
-\emph{\TL{} is not perfect!} (And never will be.) We intend to
-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 better-checked tree of macros and fonts. This work is
-all done by hard-pressed volunteers in their limited spare time, and a
-great deal remains to be done. Please see
-\url{http://tug.org/texlive/contribute.html}.
-
-Please send corrections, suggestions, and offers of help to:
-\begin{quote}
-\email{tex-live@tug.org} \\
-\url{http://tug.org/texlive}
-\end{quote}
-
-\medskip
-\noindent \textsl{Happy \TeX ing!}
-
-\end{document}
diff --git a/Master/texmf-doc/source/texlive/texlive-fr/Makefile b/Master/texmf-doc/source/texlive/texlive-fr/Makefile
deleted file mode 100644
index 519abf8798a..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-fr/Makefile
+++ /dev/null
@@ -1,5 +0,0 @@
-include ../texlive-en/Makefile
-doc = texlive-fr
-lang = french
-
-
diff --git a/Master/texmf-doc/source/texlive/texlive-fr/live.tex b/Master/texmf-doc/source/texlive/texlive-fr/live.tex
deleted file mode 100644
index ccb25a86f0b..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-fr/live.tex
+++ /dev/null
@@ -1,3945 +0,0 @@
-%Format: pdf
-
-% $Id: //depot/Master/texmf-doc/source/english/texlive-en/live.tex#31 $
-% $Author: staw $ $Date: 2005/10/31 $
-%
-% Change history (started May 18th 2002)
-% 2007/01/18: synced with 2007 English version, by Daniel Flipo
-% 2005/11/01: synced with 2005 English version, by Daniel Flipo
-% 2005/05/05: re-added section on building binaries (Daniel Flipo)
-% 2004/10/28: synced with 2004 English version, by Daniel Flipo
-% 2003/08/28: synced with 2003 English version, by ric Picheral and Jacques Andr
-% 2002/05/25: proof-reading and corrections, by Daniel Flipo
-% 2002/05/18: synced with English version, by Fabrice
-%
-\documentclass{article}
-%\let\tldocenglish=1 % *NOT* for French
-
-\usepackage[latin1]{inputenc}
-
-\usepackage{caption}
-\DeclareCaptionLabelSeparator{endash}{\space\textendash\space}
-\captionsetup{labelsep=endash}
-
-\usepackage[frenchb]{babel}
-\usepackage{xspace}
-\addto\captionsfrench{\def\figurename{{\scshape Figure}}}
-\addto\captionsfrench{\def\tablename{{\scshape Table}}}
-\AddThinSpaceBeforeFootnotes
-\FrenchFootnotes
-\NoAutoSpaceBeforeFDP
-
-\newcommand{\THANH}{Hn Th\'{} Thanh}
-
-\usepackage{comment}
-
-\usepackage{ifpdf}
-% tex-live.sty suppose \hyper@linkurl dfini...
-\ifpdf
- \def\Status{1} % (df) Pour faire charger hyperref dans tex-live.sty
-\else
- \makeatletter
- \def\hyper@linkurl#1#2{#2} % undefined if hyperref.sty not loaded
- \makeatother
-\fi
-
-\usepackage{tex-live}
-%%%% Ajout J.A. garder
-\newcommand{\CDdemo}{\acro{CD} \pkgname{demo}\xspace}
-\newcommand{\CDinst}{\acro{CD} \pkgname{inst}\xspace}
-\newcommand{\DVDlive}{\acro{DVD} \pkgname{live}\xspace}
-\renewcommand{\samp}[1]{\og \texttt{#1}\fg{}}
-
-%%%% Ajout (df)
-% Alias
-\let\XemTeX\XEmTeX
-% (df) La commande \TeXLive n'est pas utilise en v.f.
-\renewcommand{\TL}{\TeX{} Live\xspace}% Robuste (pas besoin de \protect)...
-% tex-live.sty fait prcder les no de page d'une fine... si on veut
-% une inscable normale, dcommenter la ligne suivante :
-\def\p.{p.~}
-% Chez Karl, la commande \url{} ne protge pas les caractres actifs (:?),
-% d'o ceci (essai provisoire... erreurs avec le car. #) :
-%\let\urlORI\url
-%\renewcommand*{\url}[1]{\foreignlanguage{english}{\urlORI{#1}}}
-%\renewcommand*{\url}[1]{{\shorthandoff{:?!;}\urlORI{#1}}}
-% La commande \path de url.sty ajoute des espaces parasites, pas \url, d'o
-\let\path\url
-% mais ceci impose de remplacer \path|...| par \path{...}, et les \$ inclus
-% par des $.
-
-\setlength{\parindent}{0mm}
-\addtolength{\parskip}{.25\baselineskip}
-
-\begin{document}
-
-\title{{\huge Guide pratique de \TL{}} \\ \strut
- {\LARGE\textsf{\TK{} 2007}}
- }
-
-\author{Karl Berry \\[3mm]
- \url{http://tug.org/texlive/}\\[5mm]
- \textit{Version franaise}\\[3mm]
- Daniel Flipo (GUTenberg)
- }
-
-\date{Janvier 2007}
-
-\maketitle
-\thispagestyle{empty} % no need for page number
-
-\newpage
-\begin{multicols}{2}
-\tableofcontents
-\listoftables
-\end{multicols}
-
-\section{Introduction}
-\label{sec:intro}
-
-Ce document dcrit les principales caractristiques de la
-distribution \TL{}, une distribution de \TeX{} et \LaTeX{}
-pour Linux et autres Unix, \MacOSX{} et systmes Windows 32 bits
-(attention, cette distribution n'est pas vraiment utilisable avec
-les anciens systmes Mac ou \acro{MS-DOS}). Elle comprend les binaires
-pr-compils de \TeX{}, \LaTeXe{}, \MF, \MP, \BibTeX{} et de nombreux
-autres programmes ainsi qu'une bibliothque tendue de macros, de
-fontes et de documentations. Elle traite aussi la composition de textes
-qui utilisent plusieurs systmes d'critures diffrentes venant de toute
-la surface du globe.
-La distribution \TL{} est en fait un sous-ensemble de \TK{} (dcrit brivement
- la section ~\ref{sec:struct-tl}, \p.\pageref{sec:struct-tl})
-produit grce aux efforts combins des diffrents groupes d'utilisateurs
-de \TeX.
-
-L'dition 2007 a t fige en janvier 2007.
-Les futures mises jour des composants de la distribution 2007
-seront disponibles au fur et mesure de leur parution sur le site
-\acro{CTAN}, \url{http://www.ctan.org}.
-
-On trouvera la fin du document, section~\ref{sec:history}
-(\p.\pageref{sec:history}), un bref historique des principales modifications
-apportes au fil du temps la distribution \TL.
-
-Les utilisateurs des ditions prcdentes de \TL{} sont invits
- lire, \emph{avant toute mise jour}, la section~\ref{tlcurrent}
-\p.\pageref{tlcurrent} qui prsente les principaux changements intervenus
-cette anne.
-
-
-\subsection{Utilisation lmentaire de \TL{}}
-\label{sec:basic}
-
-Vous pouvez utiliser \TL{} de trois faons diffrentes :
-\begin{enumerate}
-\item Vous pouvez excuter \TL{} directement depuis le
- \DVDlive{} (toutes plates-formes).
- Cela prend trs peu d'espace disque et
- donne un accs immdiat tout le contenu de
- \TL. C'est une solution parfaitement acceptable mme si les
- performances obtenues sont moins bonnes que si \TL{} tait
- lanc depuis un disque local.
-\item Vous pouvez installer tout ou partie de \TL{} sur un disque
- local. C'est l'utilisation la plus frquente de \TL{}.
- Ceci peut se faire partir du \DVDlive{} ou de l'un des \CD de la
- distribution (voir section~\ref{sec:multiple-dist},
- \p.\pageref{sec:multiple-dist}).
- Il faut disposer d'un minimum de 120\,Mo, mais on recommande au moins
-%(df) un peu mensonger... schma GUT = 800 Mo chez moi !
- 400\,Mo pour un systme standard ou 800\,Mo pour un systme complet.
-\item Vous pouvez incorporer un jeu de composants particulier ou une
- collection dans un systme \TeX{} dj prsent, soit un
- systme \TL{} install prcdemment, soit un systme \TeX{} diffrent.
-\end{enumerate}
-
-Ces trois utilisations sont dcrites en dtail dans les sections
-concernant l'installation spcifique chaque systme.
-Quelques remarques gnrales :
-
-\begin{itemize}
-
-\item Le script d'installation globale pour Unix et pour \MacOSX{} s'appelle
-\texttt{install-tl.sh}.
-Les utilisateurs de Linux peuvent aussi essayer le nouvel installeur
-\texttt{setuptl/tlpmgui} dvelopp au dpart pour Windows et adapt Linux.
-Consulter la section \ref{sec:win-install} p.~\pageref{sec:win-install} pour
-plus d'informations.
-
-\item Pour installer une extension ou une collection, on utilise le script
- d'installation \texttt{install-pkg.sh}.
-Aprs une installation faite l'aide de \texttt{tlpmgui}, il est possible
-d'utiliser \texttt{tlpmgui} pour ajouter ou supprimer des extensions ou des
-collections.
-
-\item Le programme d'installation pour Windows s'appelle
- \cmdname{tlpmgui.exe}, il sert aussi ajouter ou supprimer des composants
- dans une installation existante (voir section~\ref{sec:win-install}).
-
-\end{itemize}
-
-\subsection{Obtenir de l'aide}
-\label{sec:help}
-
-La communaut \TeX{} est la fois active et conviviale ; pratiquement
-toute question srieuse finit par obtenir une rponse. Le support est
-pourtant informel, assur par des volontaires et des lecteurs
-occasionnels, aussi est-il particulirement important que vous fassiez
-votre propre travail de recherche avant de poser la question (si vous
-prfrez un support commercial, vous pouvez renoncer \TL{} et
-acheter un systme payant ; voir une liste
-\url{http://tug.org/interest.html#vendors}).
-
-Voici une liste de ressources, classes selon l'ordre dans lequel nous
-recommandons de les utiliser :
-
-\begin{description}
-\item [Getting Started] Pour ceux qui dbutent en \TeX, la page web
-\url{http://tug.org/begin.html} contient une courte description
-du systme.
-
-\item [\acro{FAQ} \TeX{}] La \acro{FAQ} \TeX{} est un vaste recueil
- de rponses toutes sortes de questions, de la plus lmentaire la
- plus complexe. Elle est enregistre sur le \DVDlive{} dans
- \OnCD{texmf-doc/doc/english/FAQ-en}
- et elle est disponible sur Internet
- l'adresse \url{http://www.tex.ac.uk/faq}.
- Merci de consulter cette FAQ avant toute question.
-
-\item [Catalogue \TeX{}] Si vous recherchez une extension, une fonte,
- un programme, ... particuliers, il faut examiner le catalogue
- \TeX{}. C'est une importante liste de tous les lments relatifs
- \TeX{}. Voir \OnCD{texmf-doc/doc/english/catalogue} sur le \DVDlive{},
- ou \url{http://www.ctan.org/tex-archive/help/Catalogue}.
-
-\item [Ressources \TeX{} sur le Web ] La page web
- \url{http://tug.org/interest.html} propose
- beaucoup de liens relatifs \TeX{}, en particulier concernant des
- livres, manuels et articles portant sur tous les aspects du systme.
-
-\item [Archives des forums d'aide] Les principaux forums ddis
- au support de \TeX{} sont les groupes de news Usenet
- \url{news:comp.text.tex} (en anglais) et \url{news:fr.comp.text.tex}
- (en franais) ainsi que les listes de diffusion
- \email{texhax@tug.org} (en anglais) et \email{gut@ens.fr} (en franais).
- Les archives correspondantes contiennent des
- milliers de questions et rponses dj traites et permettent
- une recherche fructueuse. Voir
- \url{http://groups.google.com/groups?group=comp.text.tex}
- et \url{http://tug.org/mail-archives/texhax}, respectivement. Une
- question pose sur un moteur de recherche, tel que
- \url{http://google.com}, peut aussi fournir des rponses pertinentes.
-
-\item [Poster une question] Si vous n'obtenez pas de rponse, vous
- pouvez poster la question \dirname{comp.text.tex} via Google ou
- votre lecteur de news, ou encore par messagerie
- \email{texhax@tug.org}. Mais avant de le faire, merci de lire
- l'introduction de la \acro{FAQ} donnant les conseils sur la faon de
- rdiger la question pour avoir des chances d'obtenir une rponse :
- \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}.
-
-\item [Support de \TL{}] Si vous voulez faire un rapport
- d'anomalie, mettre des suggestions ou des commentaires sur la
- distribution \TL{}, l'installation ou la documentation, utilisez
- la liste de diffusion \email{tex-live@tug.org}. Mais attention, si
- la question concerne l'utilisation d'un programme particulier inclus
- dans \TL{}, il vaut mieux que vous criviez directement la
- personne ou la liste de diffusion qui maintient le programme.
-
-\end{description}
-
-L'autre aspect du sujet concerne l'aide apporter aux personnes
-soumettant des questions. Les forums \dirname{comp.text.tex},
-\dirname{fr.comp.text.tex} ainsi que les listes de diffusion \code{texhax}
-et \code{gut}
-sont ouverts tous, aussi n'hsitez pas vous y joindre, commencer
-la lecture et fournir de l'aide l o cela vous est possible.
-Bienvenue dans le monde \TeX{} !
-
-% No \protect needed as \TL is defined in French with \newcommand (robust).
-\section{Structure de \TL}
-\label{sec:struct-tl}
-
-Nous dcrivons ici la structure et le contenu de \TL{} et
-de \TK{} qui est un sur-ensemble de \TL.
-
-\subsection {Distributions multiples : \protect\pkgname{live},
- \protect\pkgname{inst}, \protect\pkgname{protext}}
-\label{sec:multiple-dist}
-
-Des limitations d'espace lies au format des \acro{CD-ROM} nous ont contraint
- diviser \TK{} en plusieurs distributions :
-
-\begin{description}
-
-\item [live] Un systme excutable complet sur \acro{DVD} ; il est
- trop volumineux pour tenir sur \acro{CD-ROM}. Le \DVD{} contient
- aussi une image du systme \CTAN{}, totalement indpendant de
- \TL{}, la distribution Mac\TeX{} pour \MacOSX, la distribution \ProTeXt{}
- pour Windows, ainsi que d'autres extensions
- runies dans un rpertoire \texttt{texmf-extra}.
-
- Les droits d'utilisation des fichiers prsents dans \CTAN, \ProTeXt,
- Mac\TeX{} et \texttt{texmf-extra} diffrent de ceux de \TL{}, pensez lire
- les licences si vous envisagez de modifier ou de redistribuer certains de
- ces fichiers.
-
-\item [inst\textrm{(allable)}] Un systme complet sur \CD{} pour les Unix
- (dont Linux et \MacOSX{}) ; pour le faire
- tenir sur le \CD, il a fallu compresser tout ce que nous avons
- pu. Du coup, il n'est pas possible d'excuter directement \TeX\
- depuis le \CD\ d'installation, il vous faut l'installer sur disque
- (d'o le nom). L'installation est dcrite dans les sections
- concernes (\ref{sec:unix-install-disk} et \ref{sec:osx-unix-inst}
- pour \MacOSX).
-
-\item [protext] Une extension du systme \MIKTEX\ sur \CD{} pour
- Windows. Cette distribution est totalement indpendante du \TL{},
- elle ncessite un mode d'installation spcifique.
- Elle peut tre installe sur disque ou excute directement
- depuis le \CD. Le site de \ProTeXt\ se trouve ici :
- \url{http://tug.org/protext}.
-
- \pkgname{protext} est fourni la fois sur le \DVDlive{} et
- sur un \CD{} spcifique pour ceux qui n'ont pas de lecteur de \DVD.
-
-\end{description}
-
-\noindent On peut dterminer la nature de la distribution
-utilise en recherchant le fichier \texttt{00\var{type}.TL} dans le
-rpertoire racine du mdium utilis (\CD{} ou \DVD{}).
-Ce fichier contient aussi la date de dernire mise jour du \TL.
-
-%(df) Que fait GUT ?
-%Naturally, each user group chooses what to distribute, at its own
-%discretion.
-
-\subsection{Rpertoires situs la racine}
-\label{sec:tld}
-
-Les rpertoires les plus importants situs la racine
-% (df) bin et source ne sont pas sur \CDinst
-du \DVDlive{}
-sont numrs ci-dessous. Cette anne, la distribution \TL{}
-est dans un sous-rpertoire \dirname{texlive2007} et non la racine.
-%%% (df) confus : on parle du CD ou du DVD
-\smallskip
-\begingroup
- \renewcommand{\arraystretch}{1.3} % open up interrow spacing
-\begin{tabular}{>{\ttfamily}lp{.78\hsize}}
-% (df) bin pas prsent sur \CDinst : les .zip des binaires sont dans 'archive'
-bin & Programmes de la famille \TeX{}, rangs dans des
- sous-rpertoires selon les plates-formes. \\
-% pas sur \CDinst
-source & Le code source de tous les programmes, incluant la
- distribution \Webc{} de \TeX{} et \MF{}. Il s'agit d'une archive au
- format \texttt{tar}, compresse par bzip2.
- % Ajout (df)
- Faute de place, le rpertoire \texttt{source}
- n'est pas sur le \CDinst{} (seulement sur le \DVDlive{}).\\
-setuptl & Programmes d'installation pour Windows et Linux. \\
-support & Ensemble d'extensions et programmes auxiliaires. Ils ne
- sont \emph{pas} installs par dfaut.
-% Faux (df)
-% On y trouve \cmdname{Ghostscript}, \cmdname{netpbm} et un ensemble
-% d'diteurs orients \TeX{}.
-\\
-texmf & Rpertoire contenant les programmes et leur documentation.
- Ne contient ni les formats ni les extensions
- (appel \envname{TEXMFMAIN} dans la section suivante.) \\
-texmf-dist & Rpertoire principal o se trouvent les extensions,
- les fontes, etc., avec leur documentation
- (appel \envname{TEXMFDIST} dans la section suivante.) \\
-texmf-doc & Rpertoire contenant le reste de la documentation,
- le sous-rpertoire doc est organis par langue. \\
-texmf-var & Rpertoire contenant les fichiers gnrs automatiquement
- (appel \envname{TEXMFSYSVAR} dans la section suivante.) \\
-\end{tabular}
-\endgroup
-
-\smallskip
-
-Le rpertoire \dirname{texmf-doc} ne contient que de la documentation
-mais pas toute la documentation. Celle concernant les programmes (manuels,
-pages \textit{man} et fichiers de type \textit{info} est dans
-\dirname{texmf/doc} car les programmes correspondants sont dans
-\dirname{texmf}. De mme, la documentation des extensions et formats
-est dans \dirname{texmf-dist/doc}. Les commandes \cmdname{texdoc} ou
-\cmdname{texdoctk} trouveront pour vous les documentations o quelles soient
-sur le disque. % Bof... pas vrai chez moi (df) ?
-Le fichier \OnCD{doc.html} du \DVDlive{} contient une liste de liens bien
-utiles pour localiser les fichiers de documentation.
-
-On trouve galement, au mme niveau que les rpertoires mentionns ci-dessus,
-les scripts d'installation et les fichiers \filename{README} (dans
-diffrentes langues).
-
-\subsection{Description des arborescences texmf utilises}
-\label{sec:texmftrees}
-
-Nous donnons ici la liste complte des variables prdfinies qui contiennent
-les noms des diffrentes arborescences de type texmf et l'usage qui en est
-fait. La commande \cmdname{texconfig conf} retourne les valeurs de ces
-variables, ce qui permet de savoir o se trouvent ces diffrentes
-arborescences dans une installation donne.
-
-\begin{ttdescription}
-\item [TEXMFMAIN] contient les lments essentiels du systme, comme les
- scripts (\cmdname{web2c/mktexdir}, etc.), les fichiers \file{.pool},
- etc.
-\item [TEXMFDIST] contient les fichiers de macro (Plain, \LaTeX, \ConTeXt,
- etc.,), les fontes, etc., de la distribution \TL. Rien ne devrait tre
- ni ajout ni supprim dans cette arborescence.
-\item [TEXMFLOCAL] c'est l que l'administrateur de la machine
- place les classes et extensions locales, les fontes non disponibles
- dans \TL, etc.
-\item [TEXMFHOME] contient les fichiers personnels (extensions, classes,
- fontes) de l'utilisateur ; ce rpertoire est sous \verb+$HOME+ % $
- par dfaut. La variable \envname{TEXINPUTS} ne devrait plus tre utilise.
-\item [TEXMFCONFIG] c'est l que les scripts \cmdname{updmap} et
- \cmdname{fmtutil} recherchent leurs fichiers de configuration en priorit.
- \cmdname{texconfig} y place les versions modifies des fichiers de
- configuration. Sous \verb+$HOME+ par dfaut. %$
-\item [TEXMFSYSCONFIG] c'est l que les scripts \cmdname{updmap-sys} et
- \cmdname{fmtutil-sys} recherchent leurs fichiers de configuration en
- priorit. \cmdname{texconfig-sys} y place les versions modifies des
- fichiers de configuration.
-\item [TEXMFVAR] c'est l que les scripts \cmdname{texconfig},
- \cmdname{updmap} et \cmdname{fmtutil} rangent les formats et les fichiers
- \file{.map} qu'ils produisent. Sous \verb+$HOME+ par dfaut. %$
-\item [TEXMFSYSVAR] c'est l que les scripts \cmdname{texconfig-sys},
- \cmdname{updmap-sys} et \cmdname{fmtutil-sys} rangent les formats et les
- fichiers \file{.map} qu'ils produisent.
-\end{ttdescription}
-
-Les possibilits offertes par \cmdname{texconfig} sont dcrites la
- section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig}.
-
-
-\subsection{Les extensions de \TeX}
-\label{sec:tex-extensions}
-
-\TL{} contient plusieurs extensions de \TeX{}.
-
-\begin{description}
-
-\item [\eTeX{}] \label{text:etex} ajoute un jeu, petit mais puissant,
- de nouvelles
- primitives et les extensions \TeXXeT{} pour l'criture de droite
- gauche ; \eTeX{} est, en mode normal, 100\% compatible avec
- \TeX{} standard. Pour plus de dtails consulter le
- fichier \OnCD{texmf-dist/doc/etex/base/etex_man.pdf} du \DVDlive{}.
-
-\item [pdf\TeX{}] inclut les extensions \eTeX{} et produit, au choix,
- des fichiers au format Acrobat \acro{PDF} ou au format \dvi{}.
- Le manuel d'utilisation se trouve sur le \DVDlive{}
- dans \OnCD{texmf/doc/pdftex/manual/}. Le fichier
- \OnCD{texmf/doc/pdftex/pdftex/manual/samplepdf/samplepdf.tex}\relax{}
- donne un exemple d'utilisation. pdf\TeX{} est le moteur de base
- sur lequel sont construits tous les formats autres que plain\TeX.
-
-\item [Xe\TeX] ajoute la possibilit d'utiliser le codage Unicode en entre
- et les fontes OpenType en sortie, ceci grce des bibliothques
- externes : voir \url{http://scripts.sil.org/xetex}.
-
-\item [\OMEGA{} (Omega)] fonctionne en utilisant Unicode et des
- caractres 16 bits, ce qui lui permet de travailler directement et
- simultanment avec presque toutes les critures du monde entier.
- L'extension supporte aussi le chargement dynamique d'\acro{OTP}
- (\OMEGA{} \emph{Translation Processes}) qui permet l'utilisateur
- d'appliquer sur des flux d'entre quelconques des transformations
- complexes qu'il aura lui-mme dfinies. Voir la documentation
- (pas vraiment jour) dans \OnCD{texmf-dist/doc/omega/base/doc-1.8.tex}.
-
-\item [Aleph] combine les fonctionnalits de \OMEGA\ et de \eTeX.
- \OnCD{texmf-dist/doc/aleph/base} contient une documentation de base.
-
-\end{description}
-
-\subsection{Quelques autres programmes intressants
- dans \TL}
-
-Voici quelques autres programmes couramment utiliss et prsents dans
-\TL{} :
-
-\begin{cmddescription}
-
-\item [bibtex] Traitement de la bibliographie.
-
-\item [makeindex] Traitement des index.
-
-\item [dvips] Conversion \dvi{} vers \PS{}.
-
-\item [xdvi] Visualisation \dvi{} pour le systme X Window.
-
-\item [dvilj] Pilote \dvi{} pour les imprimantes HP LaserJet.
-
-\item [dv2dt, dt2dv] Conversion \dvi{} vers ou depuis du texte simple.
-
-\item [dviconcat, dviselect] Couper/Coller de pages partir de fichiers
- \dvi{}.
-
-\item [dvipdfmx] Conversion \dvi{} vers \acro{PDF}, une autre approche que
- celle de pdf\TeX\ (mentionn ci-dessus). Voir les extensions
- \pkgname{ps4pdf} et \pkgname{pdftricks} pour d'autres alternatives.
-
-\item [psselect, psnup, \ldots] Utilitaires \PS{}.
-
-\item [lacheck] Vrification de syntaxe \LaTeX{}.
-
-\item [texexec] Processeur Con\TeX{}t et \acro{PDF}.
-
-\item [tex4ht] Conversion \TeX{} vers \acro{HTML}.
-
-\end{cmddescription}
-
-
-\section{Utilisation sous Unix}
-\label{sec:unix-install}
-
-Comme on l'a vu en section~\ref{sec:basic} \p.\pageref{sec:basic},
-le \TL{} peut tre utilis de trois faons principales :
-
-\begin{enumerate}
-\item Excution directe depuis le \DVDlive.
-\item Installation sur le disque dur.
-\item Intgration d'un jeu de composants ou collections dans un systme
-\TeX{} dj install.
-\end{enumerate}
-
-\noindent
-Les procdures spcifiques Unix sont dcrites pour chacun de ces cas
-dans les sections qui suivent.
-
-\ifSingleColumn \begin{figure}[ht]\noindent \fi
-\begin{warningbox}
- \textbf{ATTENTION : } Les \CD{} et le \DVD{} sont au format ISO~9660
- (High Sierra), avec les extensions \og Rock Ridge\fg{} (et \og Joliet\fg{}
- pour Windows). Votre systme doit pouvoir reconnatre les
- extensions \og Rock Ridge\fg{} pour une utilisation optimale de
- \TL{}. Consultez votre documentation concernant la commande
- \cmdname{mount} pour voir si c'est le cas. Si votre rseau local est
- constitu de machines diffrentes, regardez
- si vous pouvez monter les \CD{} sur une machine qui supporte
- Rock Ridge et utiliser ce point de montage pour les autres machines.
-
-\leavevmode\quad
-L'utilisation des \CD{} sur les systmes modernes
-ne devrait pas poser de problmes. S'il y en avait, n'hsitez pas
-nous le faire savoir.
-La suite de ce document suppose que vous avez install et mont les
- \CD{} avec une compatibilit Rock Ridge parfaite.
-\end{warningbox}
-
-\ifSingleColumn\end{figure}\fi
-
-N.B. : les droits de \og root \fg{} sont souvent requis pour monter le \CD{}.
-D'autre part, selon le type d'Unix utilis, il vous faudra probablement
-connatre le mot de passe de \og root \fg{} ou tout au moins utiliser la
-commande \cmdname{sudo} pour effectuer l'installation (le droit
-d'criture sur le(s) rpertoire(s) d'installation est videmment
-indispensable). Cette remarque concerne particulirement les utilisateurs de
-\MacOSX{} qui nous recommandons de prendre d'abord connaissance de la
-section~\ref{sec:mac-install} avant toute installation.
-
-
-\subsection{Utiliser \TL{} partir du \DVDlive}
-
-La liste des architectures sur lesquelles fonctionne \TL{} est donne
-page~\pageref{tab:archlist} (table~\ref{tab:archlist}).
-
-\def\runlive{% text repeated in windows section
-On peut utiliser le systme \TeX{} directement depuis \DVDlive,
-sans l'installer sur le disque dur (d'o en fait le nom \TL).
-Il \emph{n'est pas possible} de faire tourner \TeX{} directement
-depuis le \CDinst{} (voir section~\ref{sec:multiple-dist},
-page~\pageref{sec:multiple-dist}).
-}% fin \runlive
-
-\def\startinst{% repeated in other subsections
-Pour dmarrer, il faut d'abord \og monter \fg{} le mdium avec les
-extensions Rock Ridge.
-La commande exacte varie d'un systme l'autre ; la commande suivante
-fonctionne sous Linux, mais les noms du priphrique (ici
-\filename{/dev/cdrom}) et du point de montage (ici \dirname{/mnt/cdrom})
-peuvent changer.
-\\ N.B. Tous nos exemples utilisent \texttt{>} pour les lignes de
-commandes \textit{(shell prompt)} ; les commandes de l'utilisateur sont
-\underline{soulignes}.
-\begin{alltt}
-> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom}
-\end{alltt}
-
-\noindent Se placer au point de montage du lecteur :
-\begin{alltt}
-> \Ucom{cd /mnt/cdrom}
-\end{alltt}
-}% fin startinst
-
-\def\installtlsh{% repeated in other subsections
-Lancer le script \filename{install-tl.sh} :
-\begin{alltt}
-> \Ucom{sh install-tl.sh}\\
-Welcome to TeX Live...
-\end{alltt}
-
-\noindent Aprs l'affichage de divers messages de bienvenue et une liste des
-options du menu principal, l'installation rclame l'entre d'une commande.
-Taper alors le caractre voulu suivi d'un retour-chariot. Ne pas taper les
-chevrons (ni \texttt{<} ni \texttt{>}) ; on peut utiliser des majuscules ou
-des minuscules ; ici, les exemples utilisent des minuscules.
-}% fin \installtlsh
-
-\runlive
-\startinst
-\installtlsh
-
-Pour excuter \pkgname{live}, la premire commande est \Ucom{d}
-suivie de la sous-commande \Ucom{1} pour choisir le rpertoire du disque
-local o seront placs les fichiers (tels que les fontes et les formats) que
-le systme \TeX{} gnre lui-mme ainsi que les fichiers de configuration si
-besoin est. On utilisera \dirname{/opt/texlive2007} dans cet exemple,
-mais un utilisateur non privilgi peut trs bien choisir un
-sous-rpertoire non-existant de son rpertoire personnel (il sera cr
-et ne contiendra donc que du matriel \TL{}).
-tant donn que les fichiers crs ne sont pas toujours compatibles d'une
-anne sur l'autre, il est recommand d'inclure l'anne dans le nom du
-rpertoire.
-Si la valeur par dfaut \dirname{/usr/local/texlive/2007} vous convient
-(c.--d. que \dirname{/usr/local/texlive/2007} n'est pas un rpertoire
-existant et que vous avez les droits pour crire sous \dirname{/usr/local}),
-vous pouvez sauter cette tape.
-\begin{alltt}
-Enter command: \Ucom{d}
-Current directories setup:
-<1> TEXDIR: /usr/local/texlive/2007
-...
-Enter command: \Ucom{1}
-New value for TEXDIR [/usr/local/texlive/2007]: \Ucom{/opt/texlive2007}
-...
-Enter command: \Ucom{r}
-\end{alltt}
-
-Retour au menu principal. La seconde (et dernire) commande est
-\Ucom{r}
-pour faire tourner \pkgname{live} partir du \DVD{} sans pour autant
-l'installer sur le disque dur :
-
-\begin{alltt}
-Enter command: \Ucom{r}
-Preparing destination directories...
-...
-Welcome to the TeX Live!
->
-\end{alltt}
-
-On se retrouve au niveau de la ligne de commande
-comme on vient de le voir.
-
-Il faut maintenant modifier les deux variables
-d'environnement \envname{PATH} et \envname{TEXMFSYSVAR} comme indiqu
- l'cran quelques lignes au dessus de \og Welcome to TeX Live!\fg.
-La syntaxe dpend du \textit{shell} utilis. Les syntaxes
-prcises sont affiches pour les \textit{shell} de type Bourne ou compatible
-(\cmdname{bash}, \cmdname{sh} \cmdname{ksh}, etc.) et pour les
-\textit{C~shells} (\cmdname{csh}, \cmdname{tcsh}).
-Rappelons qu'il suffit de taper la commande \verb+echo $SHELL+ %$
-pour connatre le nom du \textit{shell} utilis.
-Le plus simple est de recopier par copier-coller, soit les deux lignes
-commenant par \og\cmdname{setenv}\fg{} pour les \textit{C~shells},
-soit les trois lignes \og\envname{PATH=}\fg, \og\envname{TEXMFSYSVAR=}\fg,
-\og\envname{export ...}\fg{} pour les \textit{shell} de type Bourne
-(suivies d'un retour-chariot) dans le terminal de commandes.
-
-Ceci suffit pour pouvoir utiliser la distribution \TL{}
-pendant toute la session.
-Pour ne pas avoir redfinir \envname{PATH} et \envname{TEXMFSYSVAR}
- chaque nouvelle connexion, il suffit d'entrer les mmes commandes
- l'aide d'un diteur dans le fichier d'initialisation du \textit{shell}
-(\file{.bash\_profile}, \file{.profile} ou \file{.cshrc}
-selon le cas).
-L'initialisation se fera ensuite automatiquement au dbut de chaque nouvelle
-session.
-
-\def\textruntexconfig{%
- Une fois l'installation termine et les variables d'environnement
- initialises, la dernire tape consiste excuter \cmdname{texconfig} ou
- \cmdname{texconfig-sys} pour ventuellement modifier certains paramtres.
- Ceci est expliqu la section~\ref{sec:texconfig},
- \p.\pageref{sec:texconfig}.%
-}
-\textruntexconfig
-
-\def\textifindoubt{%
-Passez maintenant la section~\ref{sec:test-install} pour effectuer
-quelques tests de bon fonctionnement.
-
-En cas de doute, n'hsitez pas contacter un gourou systme pour
-vous aider rsoudre vos problmes, tels que la faon de monter le
- mdium \TL{}, le choix des rpertoires utiliser ou les modifications
- apporter dans vos fichiers d'initialisation.
-}%fin textifindoubt
-\textifindoubt
-
-\subsection{Installer \TL{} sur le disque}
-\label{sec:unix-install-disk}
-
-Il est possible, et mme habituel, d'installer le systme \TeX{}
-partir du \TL{} sur le disque (\og dur\fg{}).
-Ceci peut se faire en utilisant soit le \DVDlive, soit le \CDinst
-(voir section~\ref{sec:multiple-dist}, \p.\pageref{sec:multiple-dist}
-pour des explications sur les diffrentes distributions).
-
-\startinst
-\installtlsh
-
-La table~\ref{tab:main-menu-options} donne la liste des options du menu
-principal. On peut choisir les options dans n'importe quel ordre, mais
-\Ucom{i} doit tre la dernire choisie. Il est cependant raisonnable de
-procder dans l'ordre o elles apparaissent ici !
-
-% apparently here.sty [H] doesn't support table*.
-\begin{table}[H]
-\caption{Options d'installation du menu principal}
-\label{tab:main-menu-options}
-\begin{tabular}{>{\ttfamily}ll}
-p & plate-forme que vous utilisez\\
-b & choix des binaires installer (architectures multiples)\\
-s & \emph{schma d'installation} de base
- (complet, recommand, GUTenberg, etc.).\\
-c & modifier le choix des collections individuelles\\
-l & modifier le choix des langues installer\\
-d & rpertoire o faire l'installation\\
-o & autres options\\
-i & lancer l'installation\\
-\end{tabular}
-\end{table}
-
-Voici quelques prcisions sur chaque option.
-
-\begin{description}
-
-\item[\optname{p} -- Platform (current).] Plate-forme utilise.\\
-Le script d'installation dtecte automatiquement la plate-forme
-sur laquelle il tourne, il est en gnral inutile de modifier cette option,
-sauf en cas d'erreur.
-
-\item[\optname{b} -- Binary architectures.] Binaires pour d'autres
-architectures.\\
-Par dfaut, seuls les binaires pour votre plate-forme seront installs.
-l'aide de ce menu-ci, il est possible de choisir d'installer aussi les
-binaires pour d'autres plates-formes (ou de ne pas installer pour la
-plate-forme courante). C'est utile si on partage un arbre \TeX\
-au travers d'un rseau de machines htrognes.
-La table~\ref{tab:archlist} ci-dessous donne la liste des architectures
-pour lesquelles des binaires sont disponibles.
-
-\begin{table*}[!ht]
-%\captionsetup{margin=5mm,justification=centerfirst}
-\caption{Les binaires sont disponibles pour les architectures suivantes.}
-\label{tab:archlist}
-%(df) vrifier la liste finale
-\begin{tabular}{>{\hspace*{15mm}\ttfamily}lll}
-alpha-linux & HP Alpha GNU/Linux \\
-%alphaev5-osf4.0d & HP Alphaev5 OSF \\
-%hppa2.0-hpux10.20 & HP9000 HPUX 10.20 \\
-i386-darwin & Intel x86 \MacOSX \\
-i386-freebsd & Intel x86 FreeBSD \\
-i386-linux & Intel x86 GNU/Linux \\
-%i386-openbsd3.3 & Intel x86 OpenBSD \\
-%i386-solaris2.8 & Intel x86 Solaris \\
-mips-irix & SGI IRIX \\
-powerpc-aix & IBM RS/6000 AIX \\
-powerpc-darwin & PowerPC \MacOSX \\
-sparc-linux & Sun Sparc GNU/Linux \\
-sparc-solaris & Sun Sparc Solaris \\
-win32 & Windows (32-bit) \\
-x86\_64-linux & Intel x86 64-bit GNU/Linux \\
-% \\ \hline
-\end{tabular}
-\end{table*}
-
-\item[\optname{s} -- Base Installation scheme.]
-Schma d'installation de base.\\
-Ce menu permet de choisir un type d'installation plus ou moins complet.
-L'option par dfaut (\optname{full}) installe tout, c'est un bon choix si
-l'espace disque n'est pas limit. Les francophones prfreront peut-tre
-le schma \acro{GUT}enberg, mais on peut choisir un ensemble minimal
-(\optname{basic}) pour conomiser de la place sur le disque. On trouve
-aussi des ensembles spcifiques pour Omega ou pour les utilisateurs
-d'\acro{XML}.
-
-\item[\optname{c} -- Individual collections.] Collections individuelles.\\
-Ce menu permet d'ajouter ou de supprimer des collections
-parmi celles retenues par le schma choisi ci-dessus.
-Chaque collection\Dash fichiers de macros TeX, familles de fontes Metafont,
-etc.\Dash{} est forme de plusieurs composants.
-Attention, le programme diffrencie les lettres minuscules
-des lettres capitales pour les touches de slection.
-
-\item[\optname{l} -- Language collections.] Collections de langues.\\
-Ce menu fonctionne comme celui de \Ucom{c} pour modifier
-le choix des langues installer.
-Attention, le programme diffrencie les lettres minuscules
-des lettres capitales pour les touches de slection.
-
-Voici la liste des collections de langues du \TL{}
-(on garde ici les noms anglais des options qui sont ceux du systme !) :
-
-% xx really should generate list from texmf/tpm/collection/tex-lang*
-% a la install-tl.sh.
-\begin{tabbing}
-\hspace{.25\linewidth} \=
-\hspace{.20\linewidth} \=
-\hspace{.20\linewidth} \=
-\hspace{.35\linewidth} \kill
-African \textit{(qq scripts)} \>
-Arabic \>
-Armenian \>
-Chinese\,Japanese\,Korean \\
-Croatian \>
-Cyrillic \>
-Czech/Slovak \>
-Danish \\
-Dutch \>
-Finnish \>
-French \>
-German \\
-Greek \>
-Hebrew \>
-Hungarian \>
-Indic \\
-Italian \>
-Latin \>
-Manju \>
-Mongolian \\
-Norwegian \>
-Polish \>
-Portuguese \>
-Spanish \\
-Swedish \>
-Tibetan \>
-\acro{UK} English \>
-Vietnamese \\
-\end{tabbing}
-
-\noindent Les collections de langues comprennent normalement des fontes,
-macros, motifs de csure et autres fichiers. Par exemple,
-\pkgname{frenchle.sty} est install lorsqu'on slectionne la collection
-\optname{French}. Par ailleurs, l'installation d'une langue de la collection
-modifie le fichier de configuration \filename{language.dat} qui contrle
-quelles divisions (ou coupures de mots) sont charges.
-
-\item[\optname{d} -- Installation directories] Choix des
-rpertoires d'installation.\\ \label{text:instdir}
-Ceci concerne les trois rpertoires suivants :
-
-\begin{ttdescription}
-\item [TEXDIR]
-Rpertoire de plus haut niveau sous lequel tout le reste sera install,
-la valeur par dfaut est \dirname{/usr/local/texlive/2007}.
-Il est conseill de faire figurer l'anne dans le nom choisi, de faon
-pouvoir conserver sparment plusieurs versions de \TL.
-L'ajout d'un lien symbolique
-\dirname{/usr/local/texlive/current} qui pointe vers la version utiliser
-facilitera grandement le basculement d'une version
- l'autre et le retour l'ancienne version en cas de problme.
-
-Sous \MacOSX, les interfaces utilisateurs recherchent \TeX{}
-dans \dirname{/usr/local/teTeX} ; plutt que d'installer la distribution \TL{}
-dans ce rpertoire, on pourra faire l'installation par dfaut
-(dans \dirname{/usr/local/texlive/2007} donc) et ajouter deux liens
-symboliques : \dirname{current} qui pointe vers \dirname{2007} et
-\dirname{teTeX} qui pointe vers \dirname{current}. Pour cela il suffit de
-taper les deux commandes suivantes dans un terminal :
-\begin{alltt}
-> \Ucom{(cd /usr/local/texlive ; ln -s ./2007 ./current)}
-> \Ucom{(cd /usr/local ; ln -s ./texlive/current teTeX)}
-\end{alltt}
-
-\item [TEXMFLOCAL]
-C'est dans cette arborescence que doivent tre placs les fichiers
-non fournis par \TL{}.
-La valeur par dfaut est \dirname{/usr/local/texlive/texmf-local}.
-C'est l'endroit recommand pour y mettre les classes et les fichiers de style
-locaux, les fontes (par exemple commerciales) non disponibles
-sur \TL{} ainsi que les paramtres de configuration locaux.
-
-\item [TEXMFSYSVAR]
-C'est dans cette arborescence que les scripts \cmdname{texconfig-sys},
-\cmdname{fmtutil-sys}, \cmdname{updmap-sys} installent les fichiers qui
-sont spcifiques la version, notamment les fichiers de format.
-La valeur par dfaut est \dirname{TEXDIR/texmf-var}, il n'y a en
-gnral aucune raison de la changer.
-Les fichiers configuration modifiables par \cmdname{texconfig-sys} (voir
-section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig}), comme
-\filename{fmtutil.cnf} et \filename{updmap.cfg}, sont eux dans
-\envname{TEXMFSYSCONFIG}.
-\end{ttdescription}
-
-\item[\optname{o} -- Other Options.]
-Ce menu permet de choisir les options suivantes :
-
-\begin{ttdescription}
-\item [a] Pour spcifier un autre rpertoire pour les fontes gnres.
-La valeur par dfaut utilise l'arborescence \envname{TEXMFVAR}, comme on
-l'a dit plus haut.
-Si vous voulez que l'arborescence principale soit accessible en lecture
-uniquement, cette option permet de choisir une autre localisation
-(qui doit bien sr tre accessible en lecture-criture pour tous)
-pour ranger les fontes cres dynamiquement.
-
-\item [l] Pour crer des liens symboliques pour les binaires,
-la documentation \textit{(man pages)} ou les fichiers Info \acro{GNU}.
-Par exemple, on peut dsirer rendre la documentation de type \textit{man}
-accessible depuis \dirname{/usr/local/man} et les fichiers Info
-depuis \dirname{/usr/local/info} (il faut alors bien sr avoir les droits
-d'criture dans les rpertoires spcifis).
-
-En revanche, il est dconseill d'utiliser cette option pour les binaires.
-Rendre les binaires \TL{} accessibles depuis \dirname{/usr/local/bin}
-risque de masquer dfinitivement, y compris pour \textit{root}, les
-binaires \TeX\ fournis en standard sur la plate-forme.
-Sous Linux par exemple, \textit{root} doit utiliser par dfaut les binaires
-\teTeX{} fournis avec la distribution installe (Debian, Mandrake, RedHat,
-etc.) et non ceux fournis par \TL.
-
-\item [d] Pour ne pas installer l'arborescence de la documentation
-sur les fontes et les macros. Utile pour conomiser de l'espace
-disque ou bien si la documentation a t installe auparavant un
-autre emplacement.
-
-\item [s] Pour ne pas installer l'arborescence des fichiers source.
-Ceci peut tre utile si cette arborescence est commune
-diffrentes machines ou architectures, (partage par \acro{NFS} ou
-\cmdname{automount} par exemple).
-
-\end{ttdescription}
-
-\item[\optname{i} -- Perform Installation.] Installer.\\
-Quand les options de configuration sont satisfaisantes, on peut taper
-\Ucom{i} pour lancer effectivement l'installation.
-
-\end{description}
-
-Lorsque l'installation est termine, l'tape suivante consiste inclure dans
-la variable \envname{PATH} des usagers (autres que \textit{root}
-cf. ci-dessus) le sous-rpertoire de \dirname{TEXDIR/bin} spcifique
-l'architecture de faon que les programmes nouvellement installs puissent
-tre trouvs. Le tableau~\ref{tab:archlist} (page~\pageref{tab:archlist})
-donne la liste des noms des architectures ; on peut aussi lister le contenu de
-\dirname{TEXDIR/bin} pour dterminer le nom du sous-rpertoire de
-\dirname{TEXDIR/bin} inclure en tte de \envname{PATH}.
-
-\label{text:path}
-La syntaxe de cette commande et le fichier d'initialisation utiliser
-dpendent du systme utilis. Pour un \textit{shell} Bourne ou
-compatible (\cmdname{sh}, \cmdname{bash}, \cmdname{ksh}, etc.), il
-faut mettre dans le fichier \filename{$HOME/.profile}% %$
-\footnote{Pour les utilisateurs qui possdent un fichier
- \filename{$HOME/.bash_profile}, c'est dans ce dernier qu'il faut redfinir
- la variable \envname{PATH}, car pour eux, \filename{$HOME/.profile} est
- sans effet.}
-des futurs utilisateurs de \TL{} :
-\begin{alltt}
-PATH=/\Ucom{\emph{TEXDIR}}/bin/\Ucom{\emph{archname}}:$PATH; export PATH
-\end{alltt}
-
-\noindent
-et pour un \textit{C~shell} (\cmdname{csh}, \cmdname{tcsh}),
-mettre dans le fichier \filename{$HOME/.cshrc} :
-\begin{alltt}
-setenv PATH /\Ucom{\emph{TEXDIR}}/bin/\Ucom{\emph{archname}}:$PATH
-\end{alltt} %$
-
-Sous \MacOSX{} ceci se peut se faire de la manire suivante, qui vite d'avoir
- ouvrir un diteur sur un fichier cach :
-on redevient utilisateur de base, on se place dans son rpertoire personnel,
-en tapant dans le Terminal
-\begin{alltt}
-> \Ucom{exit ; cd}
-\end{alltt}
-On vrifie quel est le \textit{shell} utilis en tapant
-\begin{alltt}
-> \Ucom{echo $SHELL}
-\end{alltt} %$
-Si la rponse est \filename{bash} (ou \filename{sh}) le fichier modifier est
-\file{.profile}, si c'est \filename{tcsh} (ou \filename{csh})
-le fichier modifier est \file{.cshrc}.\\
-Cas de \filename{bash} : on tape dans le terminal\footnotemark{}
-\addtocounter{footnote}{-1}
-\begin{alltt}
-> \Ucom{touch .profile}
-> \Ucom{echo "export PATH=/usr/local/texlive/2007/bin/powerpc-darwin:$PATH" >> .profile}
-> \Ucom{source .profile}
-\end{alltt} %$
-Cas de \filename{tcsh} : on tape dans le terminal%
-\footnote{Cet exemple suppose qu'on a fait l'installation dans
-\dirname{/usr/local/texlive/2007} et que processeur est un Motorola, sinon il
-faut adapter \envname{PATH} en consquence (changer \dirname{powerpc-darwin}
-en \dirname{i386-darwin} pour les Mac base de processeur Intel).}
-\begin{alltt}
-> \Ucom{touch .cshrc}
-> \Ucom{echo "setenv PATH /usr/local/texlive/2007/bin/powerpc-darwin:$PATH" >> .cshrc}
-> \Ucom{source .cshrc}
-\end{alltt} %$
-La mise jour de la variable \envname{PATH} est termine.
-
-\medskip
-Voici un court exemple qui slectionne une installation complte avec
-les binaires du systme actuel seulement (on accepte tous les choix par
-dfaut). Les \acro{RETURN} sont omis ici.
-
-% Respecter les espaces pour aligner les # !!!
-\begin{alltt}
-> \Ucom{sh install-tl.sh}
-\Ucom{i} # lancer l'installation
-# Redevenir utilisateur de base (non root)
-> \Ucom{exit ; cd}
-# Nouveau PATH (sous Linux, SHELL=bash, compte avec fichier \file{.bash_profile}) :
-> \Ucom{echo "export PATH=/usr/local/texlive/2007/bin/i386-linux:$PATH" >> .bash_profile}
-> \Ucom{source .bash_profile} # faire prendre en compte le nouveau PATH
-\end{alltt} %$
-
-Si votre systme Unix connat la commande \cmdname{manpath} (essayez en tapant
-\code{man manpath} dans un terminal), vous pourrez accder la documentation
-de \TL{} grce la commande \cmdname{man} en ajoutant la ligne suivante
-(en adaptant les chemins ventuellement) dans
-le fichier \filename{/etc/manpath.config} (ceci ncessite les droits de
-\textit{root}) :
-\begin{alltt}
-MANPATH_MAP /usr/local/texlive/2007/bin/i386-linux /usr/local/texlive/2007/texmf/doc/man
-\end{alltt}
-
-
-\textruntexconfig
-
-\medskip %J.A.
-
-\textifindoubt
-
-
-\subsubsection{Installation non interactive }
-\label{sec:noninteractive-install}
-
-Lorsqu'on doit dupliquer la mme installation sur plusieurs machines, il
-peut tre fastidieux de devoir rpondre chaque fois la mme liste de
-questions. Une installation personnalise automatique est possible.
-
-Exemple : pour raliser une installation standard de \TL{} sous
-\dirname{/opt/texlive} plutt que sous \dirname{/usr/local/texlive},
-il suffit d'excuter les trois commandes suivantes :
-\begin{alltt}
-> \Ucom{TEXLIVE_INSTALL_PREFIX=/opt/texlive}
-> \Ucom{export TEXLIVE_INSTALL_PREFIX}
-> \Ucom{echo i | sh install-tl.sh}
-\end{alltt}
-
-L'argument \og\texttt{i}\fg{} pass au script d'installation sert lancer
-l'installation (en mode interactif, on taperait \texttt{i} au clavier).
-
-Cinq variables d'environnement permettent de choisir o aura lieu
-l'installation :
-\begin{ttdescription}
-\item [TEXLIVE\_INSTALL\_PREFIX]
- remplace \dirname{/usr/local/texlive}.
-\item [TEXLIVE\_INSTALL\_TEXDIR]
- remplace \dirname{/usr/local/texlive/2007}.
-\item [TEXLIVE\_INSTALL\_TEXMFLOCAL]
- remplace \dirname{/usr/local/texlive/texmf-local}.
-\item [TEXLIVE\_INSTALL\_TEXMFSYSVAR]
- remplace \dirname{/usr/local/texlive/2007/texmf-var}.
-\item [TEXLIVE\_INSTALL\_TEXMFHOME]
- remplace \dirname{$HOME/texmf}. %$
-\end{ttdescription}
-
-\enlargethispage*{\baselineskip}
-Pour raliser une installation personnalise, il est facile d'crire un petit
-script qui passe les arguments adquats la commande \cmdname{install-tl.sh} ;
-par exemple pour une installation selon le schma Gutenberg, avec comme langues
-supplmentaires l'espagnol et l'anglais britannique, placer sous
-\dirname{/opt/texlive}, on pourrait lancer (sous root, en supposant que
-le SHELL est \cmdname{sh} ou \cmdname{bash} le script suivant :
-\begin{verbatim}
-TEXLIVE_INSTALL_PREFIX=/opt/texlive
-export TEXLIVE_INSTALL_PREFIX
-sh install-tl.sh <<EOI
-s
-e
-l
-A
-D
-r
-i
-EOI
-\end{verbatim}
-les lettres figurant entre \verb+<<EOI+ et \verb+EOI+ tant exactement
-celles entres (dans le mme ordre) lors d'une installation interactive.
-
-Une autre solution (meilleure ?) consisterait utiliser un fichier
-\filename{configure} la mode \acro{GNU}\dots{} Les volontaires
-pour travailler dans cette direction sont les bienvenus !
-
-%
-\subsection{Ajouter des composants une installation}
-
-On peut ajouter des composants individuels ou des collections de la
-distribution actuelle une distribution autre que \TL{} ou
- une installation plus ancienne de \TL{}. Ceci peut se faire soit partir
-du \DVDlive{} soit partir du \CDinst{}.
-
-%\startinst
-Pour dmarrer, il faut d'abord \og monter \fg{} le mdium avec les
-extensions Rock Ridge.
-La commande exacte varie d'un systme l'autre ; la commande suivante
-fonctionne sous Linux, mais les noms du priphrique (ici
-\filename{/dev/cdrom}) et du point de montage (ici \dirname{/mnt/cdrom})
-peuvent changer.
-\\ N.B. Tous nos exemples utilisent \texttt{>} pour les lignes de
-commandes \textit{(shell prompt)} ; les commandes de l'utilisateur sont
-\underline{soulignes}.
-\begin{alltt}
-> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom}
-\end{alltt}
-
-\noindent Se placer au point de montage du lecteur :
-\begin{alltt}
-> \Ucom{cd /mnt/cdrom}
-\end{alltt}
-
-Lancer le script \filename{install-pkg.sh} (et non
-\filename{install-tl.sh} qui n'est destin qu' l'installation complte) :
-
-\begin{alltt}
-> \Ucom{sh install-pkg.sh \var{options}}
-\end{alltt}
-
-Le premier jeu d'options permet de choisir ce qui sera install :
-
-\begin{ttdescription}
-\item [-{}-package=\var{pkgname}] Le composant individuel installer.
-
-\item [-{}-collection=\var{colname}] La collection individuelle installer.
-
-\item [-{}-nodoc] Ne pas installer les fichiers de documentation pour
-cette opration.
-
-\item [-{}-nosrc] Ne pas installer les fichiers source pour cette opration.
-
-\item [-{}-cddir=\var{dir}] Rpertoire source d'o on lit ;
-par dfaut le rpertoire courant. Si on a suivi les instructions ci-dessus,
-il n'a pas besoin d'tre modifi.
-
-\item [-{}-listdir=\var{dir}]
-Ce qu'on appelle \og rpertoire des listes\fg{} dans \var{cddir}
-d'o on lira l'information sur le composant.
-Si on a suivi les instructions ci-dessus, il n'y a pas besoin de le modifier.
-
-\end{ttdescription}
-
-La suite des oprations est contrle par les options dcrites ci-dessous.
-Si aucune n'est spcifie, par dfaut on installe les fichiers spcifis.
-L'arborescence principale de destination est
-le rpertoire pre du rpertoire \dirname{bin} affich par la commande
-\cmdname{which tex}.
-On peut la modifier en changeant les variables d'environnement
-\envname{TEXMFMAIN} ou \envname{TEXMF}.
-
-\begin{ttdescription}
-
-\item [-{}-listonly] Liste les fichiers installer mais n'installe
- rien du tout !
-
-\item [-{}-archive=\var{tarfile}] Au lieu d'installer les fichiers
- dans le systme \TeX{}, cre une archive \cmdname{tar}.
-
-\end{ttdescription}
-
-Options additionnelles :
-
-\begin{ttdescription}
-
-\item [-{}-config] Aprs l'installation, excuter \code{texconfig init}.
-
-\item [-{}-nohash] Aprs installation, ne pas lancer \cmdname{mktexlsr}
-pour reconstruire la base de donnes des noms de fichiers.
-\item [-{}-verbose] Donner plus d'informations durant l'excution des scripts.
-\end{ttdescription}
-
-Voici quelques exemples d'utilisation :
-
-\begin{enumerate}
-
-\item Voir les fichiers du composant \pkgname{fancyhdr} sans l'installer :
-
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=fancyhdr --listonly}
-\else> \Ucom{sh install-pkg.sh --package=fancyhdr \bs}
-> \Ucom{--listonly}
-\fi{}
-texmf-dist/doc/latex/fancyhdr/README
-texmf-dist/doc/latex/fancyhdr/fancyhdr.pdf
-...
-\end{alltt}
-
-\item Installer le composant \LaTeX{} \pkgname{natbib}:
-\begin{alltt}
-> \Ucom{sh install-pkg.sh --package=natbib}
-\end{alltt}
-
-\item Installer le composant
- \LaTeX{} \pkgname{alg} sans les sources ni la documentation :
-
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=alg --nosrc --nodoc}
-\else> \Ucom{sh install-pkg.sh -{}-package=alg \bs}
-> \Ucom{-{}-nosrc -{}-nodoc}
-\fi\end{alltt}
-
-\item Installer tous les composants dans la collection de macros
- additionnelles de plain \TeX\ :
-\begin{alltt}
-> \Ucom{sh install-pkg.sh --collection=tex-plainextra}
-\end{alltt}
-
-\item
-Faire une archive \cmdname{tar} dans \path{/tmp} contenant tous les
-composants
-de \pkgname{pstricks} :
-\begin{alltt}
-\ifSingleColumn> \Ucom{sh install-pkg.sh --package=pstricks --archive=/tmp/pstricks.tar}
-\else
-> \Ucom{sh install-pkg.sh -{}-package=pstricks \bs}
-> \Ucom{-{}-archive=/tmp/pstricks.tar}
-\fi\end{alltt}
-
-\end{enumerate}
-
-\textifindoubt
-
-%
-\section{ faire aprs l'installation}
-\label{sec:postinstall}
-
-Une fois l'installation termine il faut, quel que soit le systme,
-configurer le systme pour certains besoins locaux et
-faire des tests de base.
-
-Cette phase de post-installation comprend ventuellement la prise en compte de
-composants, fontes ou de programmes qui n'taient pas inclus dans \TL{}.
-L'ide de base est de faire les ajouts dans l'arborescence
-\envname{TEXMFLOCAL} (si vous avez install depuis le disque)
-ou dans \envname{TEXMFSYSVAR} (si vous excutez depuis le disque) ;
-voir \og rpertoires d'installation\fg{} en page~\pageref{text:instdir}.
-
-Bien sr, les dtails varient d'un cas l'autre et nous n'essayerons
-donc pas de les traiter ici. Voici quelques pointeurs consulter :
-\begin{itemize}
-\item
-\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages}
-\item
-\url{http://www.ctan.org/installationadvice}
-\item
-\url{http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst}
-\item
-\url{http://www.ctan.org/tex-archive/info/Type1fonts} sur l'installation
-de fontes.
-\end{itemize}
-
-\subsection{Le programme \protect\cmdname{texconfig}}
-\label{sec:texconfig}
-
-Vous pouvez utiliser le programme \cmdname{texconfig} n'importe quand aprs
-votre installation pour reconfigurer votre systme
-de faon satisfaire les besoins locaux.
-Il peut tre ncessaire de l'excuter au moins une fois juste aprs
-l'installation si les valeurs par dfaut de certains paramtres ne vous
-conviennent pas.
-Ce programme est install avec les autres sous le rpertoire propre
-votre architecture \texttt{TEXDIR/bin/\var{archname}}, si vous n'avez pas
-modifi le \envname{PATH} de \textit{root}, il faudra le lancer
-(sous \textit{root}) avec son chemin complet.
-
-Si on le lance sans arguments, il entre en mode plein-cran et on peut
-alors voir et modifier interactivement les paramtres.
-
-On peut aussi le lancer avec diverses options. Voici les plus courantes
-(la distribution \TL{} est configure pour utiliser du papier~A4 par dfaut) :
-
-\begin{ttdescription}
-
-\item [texconfig paper letter]
-Mettre la taille par dfaut du papier \textit{letter} pour les pilotes
-\cmdname{pdftex}, \cmdname{dvips}, \cmdname{dvipdfm}, \cmdname{xdvi}, etc.
-
-\item [texconfig rehash] Mettre jour toutes les bases de donnes des
-fichiers du systme \TeX{} ( faire aprs tout ajout ou suppression de
-fichier).
-
-\item [texconfig faq] Afficher la \acro{FAQ} sur \teTeX{}.
-(voir aussi la \acro{FAQ} principale de \TeX{} dans
-\OnCD{texmf-doc/doc/english/FAQ-en} sur le \DVDlive{}).
-
-\item [texconfig help] Obtenir de l'aide sur la commande \cmdname{texconfig}.
-
-\end{ttdescription}
-
-Bien sr, \cmdname{texconfig} ne permet de changer que certaines des
-nombreuses options et paramtres de configuration d'un systme \TeX{}.
-Le fichier principal de configuration pour les programmes de la base
-\Webc{} s'appelle \filename{texmf.cnf}. ; on peut trouver son emplacement
-en excutant \samp{kpsewhich texmf.cnf}. Ce fichier contient de nombreux
-commentaires expliquant les options par dfaut et la signification des
-paramtres, sa lecture est recommande.
-
-Depuis 2005, la commande \cmdname{texconfig} \emph{ne modifie plus les
-fichiers de configuration de la machine}, mais ceux de l'utilisateur qui la
-lance ; ces fichiers sont dans le rpertoire \dirname{$HOME/.texlive2007} %$
-de l'utilisateur.
-
-De mme, les commandes \cmdname{updmap} et \cmdname{fmtutil}
-oprent maintenant au niveau de l'utilisateur dans le rpertoire
-\dirname{$HOME/.texlive2007} %$
-
-\textbf{Important : machines multi-utilisateurs}. Les administrateurs
-installant \TL{} sur une machine multi-utilisateurs devront dornavant
-utiliser les commandes \cmdname{texconfig-sys}, \cmdname{updmap-sys} et
-\cmdname{fmtutil-sys} pour respectivement modifier la configuration, mettre
-jour les fichiers \file{.map} et crer les formats \emph{au niveau de la
- machine}. Noter qu'aucun format n'est cr l'installation, ils sont
-fabriqus la demande ; depuis cette anne, le format cr par un utilisateur
-l'est uniquement pour lui (il est mis dans \dirname{$HOME/.texlive2007}). %$
-Afin d'viter la multiplication de fichiers de formats, il y a donc lieu crer
-au moins les formats les plus utiliss au niveau du systme la fin de
-l'installation par la commande \cmdname{fmtutil-sys}. Le plus simple est de
-les crer tous (c.--d. ceux qui figurent dans le fichier fmtutil.conf) par
-\begin{alltt}
-> \Ucom{fmtutil-sys --all}
-\end{alltt}
-De plus, ceux qui ont des fichiers de configuration spcifiques
-\filename{fmtutil.cnf} ou \filename{updmap.cfg} devront les placer
-dans l'arborescence pointe par la nouvelle variable
-\envname{TEXMFSYSCONFIG},
-faute de quoi ces fichiers ne seront pas trouvs par les scripts
-\cmdname{fmtutil-sys} et \cmdname{updmap-sys}.
-Si les fichiers \filename{fmtutil.cnf} et \filename{updmap.cfg} propres la
-machine sont, par exemple, dans \envname{\$TEXMFLOCAL},
-rien n'empche de dfinir \envname{TEXMFSYSCONFIG} comme
-\envname{\$TEXMFLOCAL},
-mais il faut le faire explicitement dans le fichier \filename{texmf.cnf}.
-
-Rappelons que la commande \cmdname{texconfig conf} retourne les valeurs des
-variables \envname{TEXMFSYSCONFIG}, \envname{TEXMFLOCAL}, etc., et que
-l'utilisation des diffrentes arborescences texmf a t dcrite la
-section~\ref{sec:texmftrees} \p.\pageref{sec:texmftrees}.
-
-
-\subsection{Tester l'installation}
-\label{sec:test-install}
-
-Une fois l'installation de \TL{} termine, il faut
-la tester avant de crer des documents ou des fontes.
-Les tests doivent tre faits par un utilisateur non privilgi
-(autre que \textit{root}).
-
-On donne ici quelques procdures de base pour vrifier que le nouveau
-systme est oprationnel. On les dcrit pour Unix ; pour \MacOSX{} ou
-Windows, il vaut mieux tester au travers d'une interface graphique,
-mais les principes sont les mmes.
-
-\begin{enumerate}
-
-\item
-S'assurer en premier lieu que le programme \cmdname{tex} fonctionne :
-
-\begin{alltt}
-> \Ucom{tex -{}-version}
-TeX 3.141592 (Web2C 7.5.5)
-kpathsea version 3.5.5
-...
-\end{alltt}
-
-Si on rcupre un \textit{command not found} au lieu d'informations
-comme le numro de version et le copyright, il est fort probable que
-vous n'avez pas le bon rpertoire \dirname{bin} dans votre
-\envname{PATH}.
-Voir les informations sur l'environnement page~\pageref{text:path}.
-
-\item Traiter un fichier \LaTeX{} simple :
-
-\begin{alltt}
-> \Ucom{latex sample2e.tex}
-This is pdfeTeXk, Version 3.141592...
-...
-Output written on sample2e.dvi (3 pages, 7496 bytes).
-Transcript written on sample2e.log.
-\end{alltt}
-Si a choue en cherchant \filename{sample2e.tex} ou d'autres fichiers,
-il y a peut-tre des interfrences entre vos anciennes variables
-d'environnement ou fichiers de configuration. Pour analyser en dtail
-votre problme, vous pouvez demander \TeX{} de dire exactement ce
-qu'il cherche et trouve ; voir \og Actions de dbogage \fg{}
-page~\pageref{Debugging}.
-
-\item Prvisualiser les rsultats en ligne :
-\begin{alltt}
-> \Ucom{xdvi sample2e.dvi}
-\end{alltt}
-Sous Windows, la commande quivalente est \cmdname{dviout}.
-Une nouvelle fentre doit s'ouvrir et montrer un document expliquant les
-bases de \LaTeX{} (document lire d'ailleurs si vous tes dbutant !).
-Vous devez tourner sous X pour que \cmdname{xdvi} fonctionne. Sinon, votre
-variable d'environnement \envname{DISPLAY} n'est pas correcte et vous
-aurez une erreur \samp{Can't open display}.
-
-\item Crer un fichier \PS{} pour l'imprimer ou l'afficher :
-
-\begin{alltt}
-> \Ucom{dvips sample2e.dvi -o sample2e.ps}
-\end{alltt}
-
-\item Crer un fichier \acro{PDF} au lieu de \dvi{} ;
-cet exemple traite le fichier \filename{sample2e.tex} et cre directement
-du \acro{PDF} :
-
-\begin{alltt}
-> \Ucom{pdflatex sample2e.tex}
-\end{alltt}
-
-\item Prvisualiser le fichier \acro{PDF} :
-
-\begin{alltt}
-> \Ucom{gv sample2e.pdf}
-\textrm{ou}
-> \Ucom{xpdf sample2e.pdf}
-\end{alltt}
-
-Hlas, ni \cmdname{gv} ni \cmdname{xpdf} ne sont actuellement inclus dans
-\TL{}, aussi devez-vous les installer sparment si ce n'est dj fait.
-Voir respectivement
-\url{http://www.gnu.org/software/gv} et
-\url{http://www.foolabs.com/xpdf}.
-
-\item Autres fichiers de tests utiles :
-
-\begin{ttdescription}
-
-\item [small2e.tex] Un document plus simple compiler que
-\filename{sample2e} si celui-ci pose des problmes.
-
-\item [testpage.tex] Teste que l'imprimante n'introduit pas de dcalages.
-
-\item [nfssfont.tex] Imprime des tables de fontes et des tests.
-\item [testfont.tex] Aussi pour les tables de fontes, mais en (plain) \TeX.
-\item [story.tex] Le fichier de test de (plain) \TeX{} le plus canonique
-de tous. Il faut taper \samp{\bs bye} la commande \code{*} aprs
-\samp{tex story.tex}.
-
-\end{ttdescription}
-Pour excuter ces tests procder comme on l'a fait pour
-\filename{sample2e.tex}.
-
-\end{enumerate}
-
-Si vous tes dbutant ou si vous avez besoin d'aide pour raliser des
-documents \TeX{} ou \LaTeX{}, n'hsitez pas consulter
-\url{http://tug.org/begin.html}.
-On vous recommande galement l'introduction \LaTeX{} de Tobias Oetiker
-dans sa version anglaise (la version franaise n'est plus jour)
-disponible aprs installation sous
-\url{texmf-doc/doc/english/lshort-english/lshort.pdf}.
-
-
-\section{Installation pour \MacOSX}
-\label{sec:mac-install}
-
-\TL{} traite \MacOSX, mais pas les versions antrieures des Macintosh.
-
-On peut installer \TeX{} sous \MacOSX{} de deux faons :
-
-\begin{enumerate}
-
-\item Utiliser la nouvelle distribution, appelle Mac\TeX{}, disponible
- depuis l'dition 2005 sur le \DVDlive ; elle se trouve dans le rpertoire
- \dirname{mactex/}, voir section~\ref{sec:mactex}. C'est la mthode
- \emph{vivement recommande}, car l'installation est trs simple.
-
-\item Utiliser les commandes \filename{install*} comme pour Unix (lire d'abord
- la section~\ref{sec:osx-unix-inst} ci-dessous pour les spcificits \MacOSX{}
-puis la section~\ref{sec:unix-install}). Cette mthode offre plus de choix
-quant ce qui sera install mais droute bien des utilisateurs de Macintosh
-(ceux qui rpugnent taper des commandes dans un Terminal).
-
-\end{enumerate}
-
-\noindent Par ailleurs, l'utilisation de \TeX{} sous \MacOSX{} se fait
-normalement par le biais d'une interface graphique (\emph{frontend}),
-comme expliqu ci-dessous la section~\ref{sec:interf-graph-macosx}.
-
-\subsection{Installation de Mac\TeX}
-\label{sec:mactex}
-
-La distribution Mac\TeX{} est une variante de \TL{} complte par de
-nombreuses applications et de la documentation spcifique.
-Elle dispose de son propre installeur intgr.
-
-Le site de rfrence pour Mac\TeX{} est \url{http://tug.org/mactex}.
-
-\subsection{\protect\cmdname{install*.sh} : installation depuis \TL{}}
-\label{sec:osx-unix-inst}
-
-Le systme \MacOSX{} est un Unix (presque) comme les autres, mais Apple
-cache soigneusement ce fait, ce qui ne facilite pas l'installation de
-logiciels comme \TL{}.
-
-Nous allons essayer de dcrire en dtail la procdure d'installation.
-La premire chose faire est d'ouvrir une fentre \og Terminal \fg{}.
-L'application \og Terminal\fg{} se trouve dans le rpertoire
-/Applications/Utilitaires, elle est accessible partir du menu
-principal en haut de l'cran.
-
-Ensuite, nous allons vrifier si l'interprteur de commandes
-(ou \textit{shell} en anglais) \cmdname{bash} est prsent ou non.
-Pour cela, taper dans la fentre \og Terminal \fg{} la commande suivante :
-\begin{alltt}
-> \Ucom{which bash}
-\end{alltt}
-Si le \textit{shell} \cmdname{bash} est prsent (cas des versions
-de 10.2 et suivantes de \MacOSX) la rponse sera un chemin, par exemple
-\filename{/bin/bash}.
-Si la rponse est \texttt{command not found}, vous avez une version
-antrieure 10.2, sur laquelle \cmdname{bash} n'est pas install par dfaut.
-Vous devrez alors rcuprer le \textit{shell} \cmdname{bash} sur internet
-(par exemple ici : \url{http://tug.org/texlive/bash.dmg})
-et l'installer\dots{} ou mieux, mettre jour votre version de \MacOSX.
-
-Supposons dsormais le \textit{shell} \cmdname{bash} prsent.
-Il faut maintenant \og passer \textit{root} \fg{}, c'est--dire
-se donner le pouvoir d'effectuer des oprations normalement interdites
-aux utilisateurs de base. Ceci se fait en tapant dans le \og Terminal\fg{}
-la commande :
-\begin{alltt}
-> \Ucom{sudo su -}
-\end{alltt}
-
-Mettre le \CDinst{} ou le \DVDlive{} dans le lecteur, son contenu
-devient automatiquement accessible sous le rpertoire \dirname{/Volumes}.
-On tape ensuite dans le \og Terminal\fg{} les commandes :
-\begin{alltt}
-> \Ucom{cd /Volumes/texlive2007}
-> \Ucom{sh install-tl.sh}
-\end{alltt}
-pour se placer la racine de l'image disque monte et y lancer le script
-d'installation. Il suffit ensuite de suivre la documentation
-d'installation de la section~\ref{sec:unix-install-disk}
-\p.\pageref{sec:unix-install-disk} o des notes spcifiques pour \MacOSX{}
-ont t incluses si ncessaire.
-
-\subsection{Interfaces graphiques pour \MacOSX{}}
-\label{sec:interf-graph-macosx}
-
-Normalement, l'utilisation de \TeX{} sur un Macintosh se fait travers
-une interface graphique, comprenant un \textit{shell} d'excution, un
-diteur, un prvisualiseur et d'autres outils (on chappe toutefois
-difficilement l'utilisation de \og Terminal \fg{} ds que l'on veut
-raliser des tches un tant soit peu volues\ldots).
-
-Voici les principales interfaces disponibles :
-
-\begin{cmddescription}
-\item [TeXShop] Inclus dans \TL{} sous
-\filename{./MacOSX/texshop.dmg}.\\
-Voir \url{http://www.uoregon.edu/~koch/texshop/texshop.html}.
-
-\item [ITeXMac] Inclus dans \TL{} sous \filename{./MacOSX/iTM-*.dmg}.\\
-Voir \url{http://itexmac.sourceforge.net}.
-
-\item [Mac-emacs] Une adaptation d'Emacs \MacOSX{}, avec
-\pkgname{AucTeX} inclus.\\
-Voir \url{http://www.cs.man.ac.uk/~franconi/mac-emacs}.
-
-\end{cmddescription}
-
-Si vous choisissez d'utiliser \cmdname{TeXShop} ou \cmdname{ITeXMac},
-il sera ncessaire de donner ces logiciels les informations concernant
-le PATH :
-
-\begin{cmddescription}
-
-\item [TeXshop] Lancer l'application et ouvrir le panneau prfrences (menu
- TeXShop). Slectionner l'onglet \og Moteur\fg{} et modifier la premire
- ligne en saisissant votre PATH, par exemple :
- \dirname{/usr/local/texlive/2007/bin/powerpc-darwin}.
-
-\item [ITeXMac] Lancer l'application et ouvrir le panneau prfrences (menu
- ITeXMac). Slectionner le bouton \og Assistant teTeX\fg{}, puis l'onglet
- \og TeX\fg{} et cliquer sur le bouton radio \og{} Autre\fg{}. Saisir alors
- votre PATH, par exemple :
- \dirname{/usr/local/texlive/2007/bin/powerpc-darwin}.
-
-\end{cmddescription}
-
-
-\section{Installation sous Windows}
-\label{sec:win-install}
-
-La distribution \TL{} inclut un
-installeur pour Windows qui s'appelle \cmdname{tlpmgui}.
-
-%%%%%%%%%%%%%%%%%%%% Ajout (df) %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\begin{quote}
-\textbf{Note du traducteur :} titre personnel, je ne recommande pas
-l'installation sous Windows partir de \cmdname{tlpmgui}, sauf aux
-utilisateurs qui connaissent bien \TL{} sous Unix et veulent avoir sous
-Windows une distribution aussi proche que possible de celle-ci.
-
-Une autre piste, non base sur la distribution \TL{}, me semble nettement plus
-adapte : il s'agit installer la distribution \ProTeXt{} partir du
-\DVDlive{} ou du \CD{} spcifique, elle est base sur \MIKTEX{} distribution
-trs apprcie sous Windows ;
-
-Si vous dcidez d'opter pour \ProTeXt{} la suite de toute cette
-section ainsi que la suivante (Maintenance sous Windows) ne vous
-concernent pas.
-\end{quote}
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\cmdname{tlpmgui} propose essentiellement les mmes options que le script
-\cmdname{install-tl.sh} sous Unix mais dans une interface graphique :
- slection des schmas, choix des collections, etc., se reporter
- la section~\ref{sec:unix-install-disk} \p.\pageref{sec:unix-install-disk}.
-Certaines manipulations telles que l'ajout ou la suppression
-de composants, la mise jour des bases de donnes
-et la constructions de formats sont galement possibles.
-De plus, \cmdname{tlpmgui} offre la possibilit d'utiliser \TL{} depuis
-le \DVDlive{} (sans l'installer sur le disque dur).
-
-Pour les connaisseurs, \cmdname{tlpmgui} repose sur le programme
-\cmdname{tlpm} accessible en ligne de commande Windows.
-
-Les binaires pour Windows sont emprunts la distribution \acro{W32TEX},
-fournie par Akira Kakuto.
-Certains outils de l'ancienne distribution \fpTeX{} de Fabrice Popineau ont
-t conservs, le nouveau visualiseur \cmdname{dviout} de Toshio Oshima
-a remplac celui de Fabrice (\cmdname{Windvi}).
-
-\TL{} peut tre install sur les systmes Windows~9x, \acro{ME},
-\acro{NT}, \acro{2K} or \acro{XP}. Il ne fonctionne pas avec les versions
-plus anciennes Windows (3.1x) et \acro{MS-DOS}.
-
-\textbf{Attention :} Les utilisateurs de Windows~9x
- doit vrifier qu'il disposent d'assez d'espace pour les variables
- d'environnement. Le programme \cmdname{tlpmgui.exe} cre un certain
- nombre de variables d'environnement, si l'espace manque ajouter
- \texttt{SHELL=<path>COMMAND.COM /E:4096 /P} dans le fichier
- \filename{config.sys}.
-
-\subsection{Installation sous Windows depuis le \CDinst}
-
-Le programme \cmdname{tlpmgui} devrait dmarrer automatiquement
-ds l'insertion du \CDinst{} dans le lecteur de \acro{CD}.
-Si ce n'est pas le cas, cliquer sur \guiseq{Start\arw Run} puis
-taper \path{<lecteur cdrom>:\string\setuptl\string\tplmgui.exe}
---- resp.
-\path{<lecteur cdrom>:\string\texlive\string\setuptl\string\tplmgui.exe}
-si vous installez partir du \DVDlive{} --- o \path{<lecteur cdrom>}
-dsigne la lettre correspondant au lecteur de \acro{CD} ; cliquer ensuite
-sur OK.
-
-La fentre intitule \guiseq{TeX Live installation and maintenance utility}
-devrait s'ouvrir. Elle propose les options suivantes :
-\guiseq{Main customization}, \guiseq{Install}, \guiseq{Select a scheme},
-\guiseq{Select systems}, \guiseq{Directories} et \guiseq{Options}.
-
-Dans la section \guiseq{Directories}, le nom du lecteur de \acro{CD/DVD}
-(par exemple \texttt{F:/}) devrait apparatre ct du bouton
-\acro{CD/DVD}. S'il n'est pas affich utiliser ce bouton pour
-slectionner le lecteur de \acro{CD/DVD} contenant \TL.
-
-Il est possible de choisir le rpertoire devant contenir la distribution \TL{}
-en cliquant sur le bouton \guiseq{TLroot}(la variable \path{TLroot} contiendra
-le nom de ce rpertoire).
-% Le contenu des variables d'environnement
-% \path{TEXMFTEMP} et \path{TEXMFCNF} est affich ct des boutons
-% \guiseq{TEXMFTEMP} et \guiseq{TEXMFCNF}, il sera mis jour automatiquement
-% pendant l'installation (il est possible de le modifier en cas de besoin
-% particulier).
-
-La section \guiseq{Select a scheme} permet, comme sous Unix, de choisir le
-schma de base souhait pour l'installation (complte, GUTenberg, etc.) :
-utiliser le bouton radio pour faire ce choix et le bouton \guiseq{Info}
-pour une description du schma slectionn.
-
-Il est possible de personnaliser le schma choisi en lui ajoutant ou en
-supprimant certaines de ses composantes (appeles \guiseq{collections}).
-Ceci se fait en utilisant les boutons \guiseq{Standard collections}
-et \guiseq{Language collections} (choix des langues utilisables)
-dans \guiseq{Main customization}.
-
-La collection \guiseq{Wintools} est slectionne par dfaut car elle contient
-beaucoup de petits utilitaires non fournis avec Windows, comme des
-convertisseurs tels que \cmdname{sam2p}, \cmdname{jpeg2ps}, \cmdname{tiff2png},
-des prgramme de compression tels que \cmdname{bzip2}, \cmdname{gzip},
-\cmdname{unzip} et \cmdname{wget} qui est requis par le nouvel utilitaire
-\cmdname{getnonfreefonts}.
-
-\textbf{Remarque :} Les collections \guiseq{Ghostscript}, \guiseq{Perl}
-sont slectionnes par dfaut. Elles \emph{doivent tre
-installes}\dots{} sauf si elles l'ont t par ailleurs.
-Les variables d'environnement \envname{PERL5LIB} et \verb|GS_LIB| doivent
-aussi tre initialises et le chemin complet des binaires \guiseq{Ghostscript}
-doit tre ajout la variable \verb|PATH|.
-
-Finalement, cliquer sur le bouton \guiseq{Install} dans la section
-\guiseq{Install} pour lancer le processus d'installation.
-
-Laisser le processus se poursuivre jusqu' l'affichage du message annonant
-que l'installation a russi (un certain nombre d'tapes sont ncessaires,
-comme la cration des formats, la mise jour des bases de donnes, etc. ce
-qui peut prendre un certain temps).
-
-Un raccourci pour \cmdname{tlpmgui} (et pour \cmdname{dviout} s'il est
-install), sera ajout dans le menu \guiseq{Start\arw Programs\arw
-TeXLive2007}.
-
-Si ncessaire (Windows~9x/WinME), il vous sera demand de
-redmarrer l'ordinateur.
-
-
-\subsection{Programmes auxiliaires pour Windows}
-\label{sec:win-xemtex}
-
-Pour tre complte, une installation \TL{} a besoin de programmes
-auxiliaires qu'on ne trouve pas frquemment sur une machine Windows.
-De nombreux scripts sont crits en Perl. Certains outils importants utilisent
-l'interprteur \PS{} Ghostscript pour afficher ou convertir les fichiers.
-Il faut aussi dans certains cas une bote outils graphique.
-Enfin, un diteur orient \TeX{} facilite la saisie de fichiers \TeX{}.
-
-Tous ces outils sont assez faciles trouver pour \TeX{}, mais pour essayer
-de vous rendre la vie plus facile, nous avons incorpor des outils de ce type
-dans \TL{} :
-\begin{itemize}
-\item GNU \cmdname{GhostScript} 8.54 ;
-\item un \cmdname{Perl} 5.8 minimum, suffisant pour excuter tous les scripts
-Perl du \TL{} ;
-\item quelques utilitaires comme bzip2, gzip, jpeg2ps et tiff2png.
-\end{itemize}
-
-Perl et Ghostscript sont installs par dfaut ; vous pouvez empcher
-leur installation en les dselectionant explicitement lors de
-l'installation si vous les avez dj.
-
-Si vous prfrez ne pas installer les outils inclus dans \TL{}, vous tes
-libre d'installer les outils ncessaires pour complter votre systme \TL{} ;
-voici une liste des adresses o les obtenir :
-\begin{description}
-\item[GhostScript] \url{http://www.cs.wisc.edu/~ghost/}
-\item[Perl] \url{http://www.activestate.com/} (mais il vous faudra peut-tre
- chercher des bibliothques supplmentaires sur CPAN,
- \url{http://www.cpan.org/})
-\item[ImageMagick] \url{http://www.imagemagick.com}
-\item[NetPBM] Vous pouvez aussi utiliser NetPBM la place de ImageMagick
- pour traiter ou convertir vos fichiers graphiques. La page d'accueil
- de NetPBM est
- \url{http://netpbm.sourceforge.net/}
-\item[diteurs orients \TeX] Il y a un large choix, et cela dpend des
- prfrences de l'utilisateur. En voici une slection :
- \begin{itemize}
- \item \cmdname{GNU Emacs} avec l'extension AucTeX existe nativement
- sous Windows, l'url de rfrence est
- \url{ftp://alpha.gnu.org/gnu/auctex} ;
- \item \cmdname{WinShell} se trouve sur \TL{} dans le rpertoire
- \path{support}, l'url de rfrence est \url{http://www.winshell.de} ;
- \item \cmdname{WinEdt} est un partagiciel disponible l'adresse
- \url{http://www.winedt.com} ;
- \item TeXnicCenter est libre et se trouve l'adresse
- \url{http://www.toolscenter.org/products/texniccenter/} et aussi dans
- la distribution \ProTeXt{} ;
- \item \cmdname{Vim} peut tre tlcharg sur le site
- \url{http://www.vim.org} ;
- \item \cmdname{LEd} se trouve l'adresse
- \url{http://www.ctan.org/support/LEd} ;
- \item \cmdname{SciTE} se trouve l'adresse
- \url{http://www.scintilla.org/SciTE.html}.
- \end{itemize}
-\end{description}
-
-Il est aussi possible d'installer d'autres outils qui ne sont pas
-libres\footnote{Pas libres en fait dans le sens de la libert de les
- modifier et les redistribuer, selon les
-\emph{Debian's guidelines}. Cela ne signifie pas qu'on ne peut pas les
-acqurir gratuitement.}
-comme \cmdname{GSView}, le programme compagnon de \cmdname{GhostScript}
-pour afficher plus facilement les fichiers PS/PDF.
-\cmdname{GSView} est disponible l'url
-\url{http://www.cs.wisc.edu/~ghost/gsview/}
-ou sur tout site \acro{CTAN}.
-
-\section{Maintenance sous Windows}
-
-Une fois la distribution \TL{} installe, vous pouvez vous servir du programme
-\cmdname{tlpmgui} pour modifier ou complter votre installation.
-
-\subsection{Ajouter ou supprimer des composants}
-
-Le raccourci \cmdname{tlpmgui} du menu
-\guiseq{Start\arw Programs\arw TeXLive2007} permet de lancer le programme
-et affiche la fentre \guiseq{TeX Live installation and maintenance utility}.
-Les sections utiliser sont \guiseq{Add Packages} (ajout de composants),
-\guiseq{Remove packages} (suppression de composants),
-\guiseq{Manage installation} (maintenace), \guiseq{Remove installation}
-(suppression totale de \TL).
-
-Cliquer sur \guiseq{Add packages} ou \guiseq{Remove packages}, puis
-
-\begin{itemize}
-\item Choisir le lecteur de \acro{CD} (ou le rpertoire \texttt{texlive}
- du lecteur de \acro{DVD}) grce au bouton \guiseq{CD/DVD}.
-
-\item Cliquer sur le bouton \guiseq{Search} dans la section \guiseq{Buttons}
-pour afficher la liste de composants installer ou supprimer
-dans \guiseq{Select packages to\dots}.
-
-Lors de l'ajout de composants, la liste des composants installs est compare
- la liste des composants disponibles sur le \acro{CD/DVD}.
-Seuls les composants non installs sont affichs, vous de choisir ceux que
-vous souhaitez ajouter.
-
-Inversement, lors de la suppression de composants, seuls les composants
-installs sont affichs.
-
-Noter que les collections sont en tte de liste.
-
-\item Slectionner un composant en cliquant sur son nom dans la liste.
-Un clic sur le bouton \guiseq{Info} donne une courte description du contenu.
-Il est possible de slectionner plusieurs composants la fois l'aide des
-touches \og Ctrl \fg{} et \og Shift \fg{} (majuscules).
-
-\item Cliquer sur \guiseq{Install} ou \guiseq{Remove} pour terminer
-l'opration.
-\end{itemize}
-
-\subsection{Configuration et maintenance}
-
-La section \guiseq{Manage the installation} permet d'effectuer les oprations
-courantes de configuration et de maintenance.
-
-Voici la liste des actions possibles :
-\begin{itemize}
- \item mettre jour la base \filename{ls-R},
- \item crer les formats,
- \item modifier le fichier \filename{language.dat},
- \item modifier le fichier \filename{fmtutil.cnf},
- \item modifier le fichier \filename{updmap.cfg}.
- \end{itemize}
-
-Il faut sortir de la fentre d'dition en cliquant sur le bouton \guiseq{Done}
-pour que les mises jour des formats, fichiers \file{.map}, base
-\filename{ls-R} soient effectues.
-
-Les autres possibilits de configuration sont dcrites la
-section~\ref{sec:persconf}, \p.\pageref{sec:persconf}.
-
-\subsection{Dsinstallation complte de \TL{}}
-
-L'option \guiseq{Remove the TeX Live installation} permet de supprimer toute
-la distribution \TL{}.
-
-Attention, ce que vous avez ventuellement install dans le rpertoire
-\path{texmf-local} ne sera pas supprim ; le rpertoire \path{setuptl}
-contenant \cmdname{tlpmgui} doit tre galement nettoy la main si
-ncessaire.
-
-\subsection{Ajouter des composants votre systme}
-
-Tout d'abord, quelles que soient les modifications faites,
-\emph{n'oubliez pas de reconstruire les fichiers ls-R de bases de
- donnes}, sinon les nouveaux fichiers ne seront jamais retrouvs.
-Pour cela, vous pouvez soit utiliser le programme \cmdname{tlpmgui}, option
-\guiseq{Manage the installation}, soit lancer manuellement la commande
-\file{mktexlsr}.
-
-Si vous choisissez d'ajouter des fichiers qui ne proviennent pas de la
-distribution \TL{} (ou fp\TeX{}), il est fortement
-recommand de les mettre dans le rpertoire \path{$TEXMFLOCAL}. %$
-De cette manire, vous serez certain qu'il n'y aura pas de problme
-lors d'une mise jour de \TL.
-
-L'arborescence pointe par \path{$TEXMFLOCAL} est initialement %$
-vide. Si vous souhaitez y ajouter par exemple les fichiers de style
-pour le logiciel de calcul formel Maple, vous devrez mettre ces
-fichiers dans le rpertoire
-\path{C:\string\TeXLive2007\string\texmf-local\string\tex\string\latex\string\maple}
-et les fichiers de documentation dans
-\path{C:\string\TeXLive2007\string\texmf-local\string\doc\string\latex\string\maple}
-
-
-\subsection{Excution de \texttt{tlmp.exe} en ligne de commande}
-
-Le programme \cmdname{tlpm.exe} utilis par \cmdname{tlpmgui}
-possde de nombreuses options utiles dont la liste est donne par
-\begin{verbatim}
-tlpm --help
-\end{verbatim}
-
-Consulter le fichier \filename{tlpm.readme} pour plus de renseignements et des
-exemples.
-
-\subsection{Installation en rseau}
-
-\KPS{} est compatible avec les noms UNC, ceux-ci peuvent donc tre utiliss
-pour rcuprer l'arborescence TEXMF depuis le rseau. Mais
-encore mieux, tous les fichiers, y compris ceux de
-configuration et except les binaires dans \path{bin/win32}, sont
-compatibles et partageables avec \teTeX{} ou le \TL{} Unix. Cela
-signifie que vous pouvez utiliser Samba, soit pour monter la
-distribution Unix sur un client Windows, ou un client Unix
-depuis un serveur NT. Plusieurs stratgies sont possibles :
-\begin{itemize}
-
-\item tout mettre sur le serveur. Il faut simplement tre certain de mettre dans \path{bin/} les binaires pour tous les couples systmes d'exploitation / architectures ncessaires. Par exemple, ajouter \path{bin/win32} et
- \path{bin/i386-linux}. Ensuite configurer les variables principales ; vous
- pouvez utiliser des noms UNC pour pointer sur les rpertoires appropris
- sous Win32.
-
-\item Installer une copie locale pour les binaires et les fichiers de
- format. Dans ce cas, assigner \path{$TEXMFMAIN} au rpertoire
- principal \path{texmf} qui sera pris sur le rseau. Faire pointer
- \path{$VARTEXMF} vers un rpertoire local qui contiendra les fichiers
- de configuration locaux et les fichiers gnrs au vol. %$
-
-\end{itemize}
-
-\subsection{Diffrences entre la version Windows et la version
- Unix de \TL}
-
-La version Windows de \Webc{} possde quelques spcificits qui mritent
-d'tre notes.
-
-\begin{description}
-\item [\cmdname{kpsecheck}] Cette commande fournit des fonctionnalits
- qui ne rentraient pas bien dans \cmdname{kpsewhich}. En particulier,
- elle permet de lister tous les fichiers qui apparaissent plusieurs
- fois travers les multiples arborescences \path{texmf/}. Ceci
- l'air pratique, sauf qu'en ralit, la sortie est pollue par des
- occurrences multiples de fichiers qui ne sont pas utiles \TeX{}
- proprement parler (commes des dizaines de fichiers
- \filename{README})\footnote{Tous ces fichiers
- sont susceptibles de produire des collisions lors de l'accs la
- table de hachage ; heureusement \TeX{} ne les utilise pas, ils ne
- sont donc pas pris en compte !}. Pour cette raison, vous pouvez combiner
- l'option \path{-multiple-occurences} avec deux autres options pour
- inclure ou exclure de la recherche tout fichier conforme un
- certain motif (plusieurs motifs d'inclusion ou d'exclusion peuvent
- tre spcifis).
-
- La commande \cmdname{kpsecheck} peut aussi indiquer le statut
- d'utilisation de la mmoire partage : en utilisation ou
- non-utilise. Cette information peut tre trs utile, car si le
- statut rapport est \og en utilisation\fg{}, cela signifie qu'un
- ou plusieurs processus tournent et utilisent le bloc de mmoire
- partage. Dans ce cas, une rinitialisation des tables de hachage
- base sur les fichiers \filename{ls-R}, comme la commande
- \cmdname{mktexlsr} l'effectue, sera automatiquement repousse
- jusqu' ce que tous les processus utilisant la version courante en
- mmoire partage soient termins. Il est prvu d'enlever cette
- limitation dans une version future, mais la version actuelle de
- \KPS{} ne permet pas de faire facilement cette rinitialisation.
-
- Enfin, la mme commande \cmdname{kpsecheck} peut indiquer l'endroit
- o \KPS{} pense pouvoir trouver la Dll de Ghostscript. En effet,
- sous Win32, il est souvent plus simple de travailler directement
- avec la Dll de Ghostscript, et de la trouver en utilisant la cl
- approprie dans la base de registre, que d'utiliser \path{gswin32c.exe} et
- de modifier le \path{PATH} qui a une longueur limite.
-
-\item [\Webc] Les moteurs \TeX{} ont une option supplmentaire
- par rapport la version standard :
- \path{-proctimes} affiche des statistiques propos du
- temps d'excution. Il est noter que Windows~9x n'tant pas un
- systme multi-tche premptif, il ne possde pas d'horloge
- interne suffisamment prcise pour mesurer ces temps d'excution
- et donc la valeur affiche n'est qu'une approximation. Sous
- NT/2K/XP, le rsultat est assez prcis et comprend le temps
- utilisateur et le temps systme allous la compilation. Pour
- les utilisateurs d'Unix : la commande \path{time} n'existe pas
- sous Windows.
-\end{description}
-
-\subsection{Personnalisation de l'installation}
-\label{sec:persconf}
-
-\subsubsection{Dvips}
-
-Le fichier de configuration de \texttt{dvips} se trouve par dfaut en
-\path{C:\string\TeXLive2007\string\texmf-var\string\dvips\string\config\string\config.ps}. Il peut tre ouvert avec n'importe quel diteur de texte
-% (comme \cmdname{WinShell})
-pour modifier certains paramtres :
-\begin{description}
-\item[fontes] vous pouvez changer la rsolution et le mode de
- l'imprimante laquelle sont destins vos fichiers dans le cas o
- \texttt{dvips} aurait besoin de gnrer des fontes bitmap. Par dfaut,
- les fontes Type1 CM interpoles sont utilises, et donc
- \path{mktexpk} ne devrait pas tre appel trop souvent.
-\item[imprimante] vous pouvez spcifier o se fera l'impression par
- dfaut. Si l'option `o' n'est pas suivie d'un nom d'imprimante, un
- fichier est cr avec l'extension \file{.ps}. Sinon, vous pouvez
- spcifier un nom d'imprimante tel que :
-\begin{verbatim}
-o lpt1:
-% o | lpr -S server -P myprinter
-% o \\server\myprinter
-\end{verbatim}
-\item[papier] vous pouvez changer le format de papier retenu par
- dfaut (A4), par exemple en format US letter, le premier format
- mentionn. Allez vers les lignes dbutant par \path{@}. Dplacez les
- lignes adquates, ainsi le fichier commencera par les lignes qui suivent.
-\begin{verbatim}
-@ letterSize 8.5in 11in
-
-@ letter 8.5in 11in
-@+ %%BeginPaperSize: Letter
-@+ letter
-@+ %%EndPaperSize
-\end{verbatim}
-\end{description}
-
-La distribution \TL{} actuelle intgre un programme \og \cmdname{updmap} \fg{}
-facilitant la mise jour des fichiers \file{psfonts.map} pour Dvips et
-\file{pdftex.map} pour PdfTeX.
-\cmdname{updmap} est lanc automatiquement durant l'installation.
-Si vous ajoutez de nouvelles fontes la main,
-ditez le fichier \verb+updmap.cfg+ dans \path{$TEXMFVAR/web2c}. %$
-et relancez \cmdname{updmap}.
-
-\subsubsection{PdfTeX}
-
-Si le programme \cmdname{pdflatex} est utilis pour crire directement en
-format
-\acro{PDF} et qu'on utilise du papier au format \acro{US} letter-size,
-diter le fichier
-\path{C:\string\TeXLive2007\string\texmf-var\string\tex\string\generic\string\config\string\pdftexconfig.tex}
-et modifier \samp{\bs page\_width} et \samp{\bs page\_height}.
-Ces entres doivent tre :
-\begin{alltt}
-\bs{}pdfpagewidth=8.5 true in
-\bs{}pdfpageheight=11 true in
-\end{alltt}
-
-Sauvegarder le fichier et sortir de l'diteur.
-
-\subsubsection{Xe\TeX}
-
-Xe\TeX{} pour Windows est li statiquement la bibliothque fontconfig 2.4.2.
-Le fichier de configuration pour les fontes s'appelle \verb+fonts.conf+.
-Ce fichier se trouve dans le rpertoire indiqu par la commande
-\texttt{kpsewhich --var-value=FONTCONFIG\_PATH}.
-
-\subsubsection{Gsview}
-
-\cmdname{GSView} est maintenant distribu sous licence Aladdin et n'est donc
-plus inclus dans \TL{}.
-
-Si vous voulez changer le format du papier, ouvrez \cmdname{GSView}
-partir du menu \guiseq{Dmarrer} et slectionnez \guiseq{Media\arw Letter}.
-Le sous menu Display Settings vous permet
-galement d'amliorer la nettet du rendu en positionnant les
-deux valeurs \textbf{Text Alpha} et \textbf{Graphics Alpha} 4 bits.
-
-Pour ce qui est de l'impression, consulter la
-sous-section~\ref{sub:printing}.
-
-Les fichiers \file{.ps} et \file{.eps} seront automatiquement ouverts
-par \cmdname{GSView}.
-
-\subsection{Tests}
-
-Pour des procdures gnriques de vrification, voir
-section~\ref{sec:test-install}, page~\pageref{sec:test-install}.
-Cette section dcrit les tests spcifiques Windows.
-
-Vous pouvez tester l'installation
-en ouvrant le fichier
-\verb+sample2e.tex+ dans votre diteur (\cmdname{XEmacs},
-\cmdname{WinShell}) qui se trouve dans
-\path{C:\string\TeXLive2007\string\texmf-dist\string\tex\string\latex\string\base}.
-Le source \LaTeX{} doit apparatre l'cran. Compilez-le en cliquant
-sur le menu (XEmacs) \guiseq{Command\arw LaTeX} ou sur l'icne \LaTeX{}
-(WinShell) dans la barre d'outils, ensuite affichez-le en
-cliquant sur le menu (XEmacs) \guiseq{Command\arw View DVI}
-ou sur l'icne Preview (dviout).
-
-La premire fois que vous afficherez un document avec \cmdname{dviout}, il va
-crer les fichiers de fontes bitmaps qui ne sont pas installes.
-Aprs avoir visualis quelques fichiers, vous aurez cr la plupart de ces
-fichiers et vous ne verrez plus souvent apparatre la fentre de cration de
-fontes.
-
-En cas de problmes, reportez-vous la
-sous-section~\ref{sec:troubleshooting}.
-
-\subsection{Impression}
-\label{sub:printing}
-
-Il est possible d'imprimer depuis \cmdname{dviout}. Dans ce cas, l'impression
-utilise le pilote unifi d'impression de Windows, il est donc par
-dfinition compatible avec toutes les imprimantes. Cependant, il y a
-un inconvnient : cette impression gnre des fichiers (spool) trs
-importants, quelques versions anciennes de Windows le supportent mal.
-L'avantage est que vous pouvez tirer
-parti de l'impression d'images BMP ou WMF par exemple. Il faut
-galement faire bien attention ce que les paramtres de l'imprimante
-soient correctement dfinis sous peine
-d'avoir un effet d'chelle
-(imprimer 600\,dpi sur une imprimante qui fait rellement 300\,dpi
-aboutit n'avoir qu'un seul quart de la page visible).
-
-L'impression est souvent plus rapide en utilisant \cmdname{dvips}, puis en
-imprimant le fichier \file{.ps} depuis \cmdname{GSView}. Pour imprimer
-depuis \cmdname{GSView}, slectionner \textbf{Print\dots{}} dans le menu
-\textbf{File}. Une fentre de dialogue pour l'impression apparat.
-
-Si vous utilisez une imprimante PostScript, \emph{soyez sr de
- slectionner \textbf{PostScript Printer}} en choisissant cette
-option dans \textbf{Print Method} en bas gauche de la bote de
-dialogue, faute de quoi l'impression chouera. Vous
-pouvez ensuite slectionner une imprimante quelconque parmi celles
-installes.
-
-Si vous utilisez une imprimante qui ne supporte pas PostScript,
-slectionnez \textbf{Ghostscript Device} dans \textbf{Print
- Method}. Ensuite cliquez sur le bouton \textbf{djet500} et
-slectionnez votre imprimante.
-
-\subsection{Trucs et astuces propos de la plate-forme Win32}
-
-\subsubsection{Diffrentes dclinaisons de Win32}
-
-Ce que recouvre la dnomination Win32 n'est pas un systme
-d'exploitation. C'est un ensemble de fonctions trs
-vaste (environ 12000 fonctions dans les fichiers d'en-tte du
- SDK Microsoft) que vous pouvez utiliser pour crire des programmes
-pour diffrentes versions des systmes d'exploitation de la famille
-Windows.
-
-Windows se dcline en plusieurs versions :
-\begin{itemize}
-\item Win95, Win98 et WinME, qui \emph{ne sont pas de vrais systmes
- d'exploitation multitches et multithreads}. Ils sont en fait les
- dernires incarnations de DOS. On peut s'en apercevoir, car en
- lanant le PC, l'interprteur de commandes \path{command.com} est
- charg et si vous arrtez le processus ce moment, vous pouvez
- demander la version courante (de DOS) et il vous est rpondu quelque
- chose du style "MS-DOS 7.0", au moins pour les versions anciennes de
- Windows~9x ;
-\item Windows \acro{NT} est un systme d'exploitation crit partir
- de zro, avec un
- vrai multitche premptif et des fonctionnalits de trs haut niveau ;
-\item Windows 2000 est crit sur une base \acro{NT}, il est dot de toutes les
- facilits offertes par Win98 ;
-\item Windows \acro{XP} existe en versions Personnelle et
- Professionnelle. C'est la dernire tape dans la fusion entre les
- deux lignes de produits (base sur Windows~9x et base sur NT). \acro{XP} est
- crit sur une base NT.
-\end{itemize}
-
-Windows~9x peut faire tourner des programmes 32~bits et des
-programmes 16~bits en mme temps. Mais le systme d'exploitation
-lui-mme n'est pas entirement crit en mode 32~bits et ne fournit pas
-une protection mmoire entre les applications : les applications
-16~bits peuvent craser des parties du systme d'exploitation en
-mmoire ! Des parties du systme telles que le \acro{GDI}
-(\emph{Graphical Device Interface}) ne se voient allouer que des
-ressources de taille trs
-limite pour grer les bitmaps, les pinceaux et les polices, et ces
-ressources sont alloues de manire globale pour tous les programmes
-qui tournent de manire concurrente. Par exemple, toutes les enttes de
-bitmaps utiliss par tous les programmes qui tournent simultanment ne
-doivent pas requrir plus de 64~ko de mmoire. Ceci explique le
-comportement du moniteur de performance et le fait que vous pouvez
-mettre votre systme genoux en utilisant de manire intensive les
-objets graphiques.
-
-NT, 2K et XP ne souffrent pas de ces limitations, ni d'aucune autre
-limitation de Windows~9x. Ce sont de vrais environnements multitches, avec
-une vraie mmoire protge. Ils rpondent de manire plus fluide que
-Windows~9x de par leur meilleure gestion de la mmoire, leur systme de
-gestion de fichiers plus performant, etc.
-
-\subsubsection{La ligne de commande}
-
-Vous allez demander : mais pourquoi diable devrais-je me
-proccuper d'une ligne de commande alors que j'ai Windows ?
-
-Bonne question. Le problme est de nature trs gnrale. Toutes les
-oprations ne peuvent pas tre accomplies trs facilement l'aide de
-la seule interface graphique. La ligne de commande vous donne la
-puissance de la programmation -- si vous avez un bon interprteur de
-commandes.
-
-Mais le problme est plus fondamental : \TeX{} est un outil qui
-fonctionne \emph{en batch}, de manire non interactive. \TeX{} a
-besoin de calculer la meilleure mise en page pour chaque page, de
-rsoudre les rfrences croises, etc. Ceci ne peut tre ralis
-que par un traitement global du document. Ce n'est pas encore une tche
-qui peut tre ralise interactivement.
-
-Ceci implique que vous devriez utiliser \TeX{} depuis la ligne de
-commande. En fait la situation n'est pas si catastrophique. Il y a un
-avantage crire des outils en ligne de commande pour des tches
-complexes : ils sont bien plus fiables, parce qu'ils n'hritent pas de
-la complexit inhrente aux interfaces graphiques.
-Il est ensuite possible de
-concevoir des outils graphiques qui servent d'interface aux outils en
-ligne de commande. C'est le cas de \TeX{} : vous interagirez avec lui
-la plupart du temps au travers d'un diteur de textes qui possde une
-interface graphique.
-
-Cependant, il se peut que vous ayez besoin d'utiliser la ligne de
-commande dans certaines situations. Par exemple en cas de
-problmes, parce que vous avez besoin de trouver une erreur dans votre
-installation -- voir la section~\ref{sec:troubleshooting}.
-
-\begin{description}
-\item[Windows~9x, WinME] Vous ouvrirez une ligne de commande soit en cherchant
- l'icne \acro{MS-DOS} dans le menu \og \guiseq{Dmarrer\arw Programmes}\fg{},
- soit en choisissant \og \guiseq{Dmarrer\arw Excuter}\fg{}, puis en tapant
- \path{command.com} .
-\item[NT, 2K, XP] Vous ouvrirez une ligne de commande en cherchant
- \og \guiseq{Invite de commandes}\fg{} dans le menu \og \guiseq{Dmarrer\arw
- Accessoires}\fg{} (ces emplacements peuvent changer d'une version de Windows
- l'autre). Vous pouvez aussi choisir le menu
- \og Dmarrer -> Excuter\fg{} et taper \path{cmd.exe}, qui est le nom
- du nouvel interprteur de commandes pour NT.
-\end{description}
-
-\subsubsection{Les sparateurs de chemins}
-
-L'API Win32 admet les deux caractres \verb+/+ et \verb+\+ comme
-sparateurs pour les noms de fichiers. Mais pas les interprteurs
-de commande ! Donc, chaque fois qu'un nom de fichier est utilis par
-un programme, vous pouvez utiliser l'un ou l'autre sparateur, mais
-sur la ligne de commande, vous devez utiliser \verb+\+ comme unique
-sparateur. Ce qui explique que vous pouvez taper :
-\begin{verbatim}
- C:\>set TEXMFCNF=C:/Program Files/TeXLive/texmf-var/web2c
-\end{verbatim}
-mais pas :
-\begin{verbatim}
-C:\>dir "C:/Program Files/TeXLive"
-\end{verbatim}
-Dans le premier cas, seuls des programmes utiliseront le chemin que
-vous avez fourni, dans le deuxime cas, c'est l'interprteur de commandes
-qui va vouloir s'en servir directement.
-
-Tout ceci pour dire, ne soyez pas surpris de voir des noms de
-fichiers crits avec des \path{/} en guise de sparateurs, la mode Unix ;
-Windows-\TL{} est un portage de \Webc, dont l'objectif est d'tre
-compatible avec toutes les plates-formes. Pour cette raison, les
-fichiers de configuration utilisent la convention Unix des sparateurs
-dans les noms de fichiers.
-
-\subsubsection{Les systmes de gestion de fichiers}
-
-Une des plus mauvaises caractristiques de Windows~9x vis--vis de \TeX{}
-est probablement ce qu'on appelle le systme de fichiers FAT.
-\TeX{} utilise une myriade de petits fichiers dont la taille varie
-entre 1~ko et 5~ko. Le systme FAT est ancien et date d'une poque bien
-antrieure l'apparition des disques de plusieurs Go qui sont monnaie
-courante aujourd'hui. Tout ceci pour dire qu'il n'est pas possible de
-grer efficacement les dizaines de fichiers de \TL{} sur un disque dur
-format en FAT. Les fichiers se voient allouer chacun 32~ko au
-minimum, donc l'installation de \TL{} utilise beaucoup plus de
-place que ncessaire.
-
-Le seul moyen d'viter ce problme consiste
-passer en FAT32 ou NTFS. Ces systmes sont plus rcents et n'ont pas
-l'inconvnient de FAT. La taille des clusters par dfaut y est de 4~ko,
-leur accs est plus performant. NTFS est protg, redondant et on peut
-mme ajuster la taille des clusters jusqu' un minimum de 512 octets
- la cration.
-
-\subsubsection{Comment ajouter un rpertoire votre PATH}
-
-Il existe dans votre systme des variables qui
-agissent un peu comme des variables globales tous vos programmes. On
-appelle cet ensemble de variables \emph{l'environnement}. Chaque
-programme hrite son dmarrage d'une copie de l'environnement. Il peut
-modifier les valeurs des variables, ajouter ou enlever des variables,
-mais les modifications ne sont effectives que pour sa propre copie et
-ne sont pas propages aux autres programmes, sauf ceux qu'il lance
-lui-mme.
-
-Votre variable PATH est une variable spciale de l'environnement
-utilise pour chercher les programmes lorsque vous en demandez
-l'excution. Il y a une procdure diffrente pour modifier cette
-variable selon que vous tes sous Windows~9x, \acro{ME} ou
-\acro{NT}/\acro{2K}/\acro{XP}.
-
-\begin{description}
-\item[Windows 95/98]
-ditez votre fichier \path{autoexec.bat}. Dans ce fichier, vous
-trouverez une ligne commenant par \path{PATH=} et suivie par une
-liste de rpertoires spars par des points-virgules. Ajoutez le rpertoire
-contenant les programmes excutables au bout de cette ligne. Cette
-ligne ressemble alors la suivante :
-\begin{verbatim}
-PATH=C:\windows;C:\windows\system;C:\TeXLive2007\bin\win32
-\end{verbatim}
-Les modifications ne prendront effet qu'aprs redmarrage de la machine.
-\item[Windows ME]
- Vous devez utiliser le programme
- \path{C:\string\windows\string\system\string\msconfig.exe} pour pouvoir
- modifier une des
- variables d'environnement. Dans ce programme, choisissez l'onglet
- Environnement, ensuite ajoutez ou modifiez la variable de votre
- choix. Il faut alors redmarrer la machine pour que les modifications
- prennent effet.
-\item[Windows NT/2K/XP]
- Ouvrez le \guiseq{Panneau~de~Contrle}, accessible depuis le menu
- \guiseq{Dmarrer\arw} \guiseq{Paramtres\arw Panneau~de~Contrle}.
- Ouvrez l'icne Systme, la fentre des \guiseq{Proprits systme}
- s'ouvre. Choisissez l'onglet \textsf{Environnement} ou cherchez un
- bouton \guiseq{Variables d'environnement}
-parmi les diffrentes botes de dialogue offertes.
-Vous pouvez maintenant modifier vos propres variables d'environnement.
-Il est noter que les variables d'environnement systme communes
-tous les utilisateurs sont galement affiches. Vous ne pouvez les
-modifier que si vous avez les droits d'administrateur. Si c'est le
-cas, vous pouvez modifier la variable \path{PATH} pour tous les
-utilisateurs du systme -- mais vous devez savoir prcisment ce que
-vous faites.
-
-S'il y a dj un \path{PATH} dfini pour votre compte utilisateur, cliquez
-dessus. Dans le champ \textsf{Variable} apparat \path{PATH} et dans le champ
-\textsf{Valeur}, la liste courante de rpertoires spars par des
-points-virgules. Ajoutez les rpertoires o se trouvent vos excutables (i.e.
-\path{C:\string\TeXLive2007\string\bin\string\win32}). Si la variable
-\path{PATH} n'est pas encore dfinie, il suffit de taper son nom dans le champ
-\textsf{Variable} et la valeur initiale que vous souhaitez lui donner dans le
-champ \textsf{Valeur}. Important : cliquez sur le bouton \textsf{Appliquer}
-avant de cliquer sur \textsf{Ok}, de cette faon, les modifications seront
-propages immdiatement la session courante. Soyez prudent quand vous
-modifiez les variables d'environnement.
-\end{description}
-
-Le meilleur moyen de savoir si une variable a t correctement dfinie
-consiste ouvrir une console et taper
-\begin{verbatim}
-set VARIABLE
-\end{verbatim}
-la valeur correspondante doit alors tre affiche..
-
-\subsubsection{Les moteurs \TeX{}}
-
-En lisant la documentation de \Webc{}, on voit
-que les diffrents programmes drivs de \TeX{}
-utilisent le mme moteur de base. Par exemple, \path{tex.exe} et
-\path{latex.exe} sont des copies exactes du mme programme, mais
-chacun utilise un fichier de format diffrent, en se basant sur le nom
-par lequel il a t invoqu.
-
-Sous Unix, ce mode de fonctionnement est ralis en faisant appel aux
-\emph{liens symboliques}. On peut ainsi conomiser un peu d'espace disque,
-car plusieurs moteurs de base sont utiliss avec diffrents fichiers
-de format.
-
-L'API Win32 ne connat pas les liens symboliques. Dans le but
-d'conomiser presqu'autant d'espace disque, tous les moteurs
-\TeX{} de base ont t mis dans des DLL (\emph{Dynamic Linked
- Library}). Ceci se traduit par l'aspect suivant pour les fichiers :
-\begin{alltt}
- 2006-11-23 07:06 2 560 latex.exe
- 2007-01-06 23:54 1 073 664 pdftex.dll
- 2006-01-28 08:05 2 560 pdftex.exe
-\end{alltt}
-\noindent et le fichier \path{latex.exe} n'est ni plus ni moins qu'une copie
-presqu'identique du fichier \path{pdfetex.exe}, utilisant le mme moteur
-\path{pdftex.dll}. La mme astuce a t utilise pour la famille de
-programmes \path{mktex*.exe} qui utilisent tous la bibliothque
-\path{mktex.dll}.
-
-Il existe mme un outil gnrique appel \path{irun.exe} qui permet
-de simuler les liens durs de Unix sous Win32, mais uniquement pour les
-fichiers \file{.exe}.
-
-\subsection{En cas de problme}
-\label{sec:troubleshooting}
-
-\subsubsection{Que faire si \texttt{latex} ne trouve pas vos fichiers ?}
-
-\begin{itemize}
-\item \cmdname{kpsewhich} est l'outil de choix pour trouver la source
- de n'importe quel problme. Malheureusement, \cmdname{kpsewhich}
- crit le rsultat de ses recherches sur le flux \path{stderr}, et
- les anciennes versions de la console de Windows ne savaient pas
- rediriger ce flux vers un fichier\footnote{En fait, les systmes
- Windows NT/2K/XP savent le faire, grce leur nouvel interprteur
- de commandes, mais l'astuce spcifique \KPS{}-Win32 fonctionne
- sur toutes les consoles.}. Pour des besoins de diagnostic, vous
- pouvez positionner temporairement une variable d'environnement en tapant
- dans une console :
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=err.log
-\end{verbatim}
-Vous pouvez galement dfinir un niveau de trace :
-\begin{verbatim}
-SET KPATHSEA_DEBUG=-1
-\end{verbatim}
-
-La trace de l'excution des commandes suivantes sera conserve dans le
-fichier \filename{err.log}. Si vous voulez rediriger le flux stderr sur le
-flux stdout, ce qui n'est normalement possible sous aucune version de Windows,
-il vous suffit de faire :
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=con:
-\end{verbatim}
-De cette manire, vous pourrez rediriger la fois stdout et stderr
-dans le mme fichier.
-
-\item En supposant que l'installation a t faite dans
- \texttt{C:/TeX}, vrifiez les valeurs suivantes :\\
- \begin{tabular}{ll}
- \texttt{kpsewhich -expand-path \$SELFAUTOPARENT} & \texttt{C:/TeX} \\
- \texttt{kpsewhich -expand-path \$TEXMF} & \texttt{C:/TeX/texmf....} \\
- \texttt{kpsewhich -expand-path \$TEXMFCNF} &
- \texttt{.;C:/TeX/texmf-var/web2c;} \\
- \texttt{kpsewhich -expand-var \$TEXINPUTS} & \texttt{.;C:/TeX/texmf/tex//}
- \end{tabular}
-
-\item Si des variables d'environnement lies TeX sont
- positionnes dans votre environnement, enlevez-les, car elles
- masquent les valeurs existant dans le fichier \filename{texmf.cnf}.
-
-\item Vrifiez les valeurs de :\\
- \begin{tabular}{ll}
- \texttt{kpsewhich cmr10.tfm} & \texttt{C:/TeX/texmf-dist/fonts/tfm/public/cm/cmr10.tfm}\\
- \texttt{kpsewhich latex.fmt}& \texttt{C:/TeX/texmf-var/web2c/latex.fmt}
- \end{tabular}
-
-\item ce point, si tout est correct, \TeX{} et tous les
- programmes associs doivent fonctionner. Si ce n'est pas le cas,
- vous devez poursuivre vos investigations avec l'option \path{-debug=n} de
- \path{kpsewhich} et contrler toutes les valeurs. Essayez
- d'identifier et de signaler le problme.
-\end{itemize}
-
-\subsubsection{Que faire si votre installation ne fonctionne toujours
- pas selon vos attentes ?}
-
-Il faut se poser plusieurs questions :
-\begin{enumerate}
-\item Est-ce que \path{tex.exe} est bien dans mon \path{PATH} ?
-
-\item Est-ce que la variable d'environnement \path{TEXMFCNF} est bien
- positionne \\
- \path{C:/TeXLive2007/texmf-var/web2c} (valeur par dfaut) ?
-
-\item Est-ce qu'il y a des erreurs dans le fichier de log \file{tlmpgui.log}
- gnr lors de l'installation par \filename{tlmpgui} ? Ce fichier est dans
- le rpertoire \file{TEMP}, les erreurs sont repres par la squence
- \samp{Error}.
-
-\item Y a-t-il des correctifs de bogues correspondant au problme
- \url{http://www.tug.org/tex-live.html} (improbable, mais il vaut
- mieux le vrifier).
-
-\end{enumerate}
-
-Le logiciel \TL{} est compos de centaines de
-programmes et de milliers de fichiers d'origines trs diverses. Il
-est pratiquement impossible de prdire toutes les causes possibles de
-problmes. Nanmoins, nous ferons notre possible pour vous aider dans
-tous les cas (voir section~\ref{sec:help}, \p.\pageref{sec:help}).
-
-% don't use \Webc so the \uppercase in the headline works.
-%\section{Guide d'utilisation du systme \protect\Webc{}}
-\section{Guide d'utilisation du systme Web2C}
-
-\Webc{}est une collection intgre de programmes relatifs \TeX,
-c.--d. \TeX{} lui-mme, \MF{}, \MP, \BibTeX{}, etc.
-C'est le c\oe ur de \TL{}.
-
-Un peu d'histoire : la premire implmentation a t ralise par Tomas
-Rokicki qui, en 1987, a dvelopp un premier systme \TeX{}-to-C en adaptant
-les \textit{change files} pour Unix (travail de Howard Trickey et Pavel Curtis
-principalement). Tim Morgan assura la maintenance du systme, dont le nom fut
-remplac durant cette priode par Web-to-C. En 1990, Karl Berry reprit le
-travail, assist par des dizaines de contributeurs, et en 1997 il passa le
-relais Olaf Weber.
-
-Le systme \Webc{} fonctionne sur Unix, les systmes Windows 32 bits,
-\MacOSX{} et de nombreux autres systmes d'exploitation. Il utilise les
-sources originales de D.E.~Knuth pour \TeX{} et les autres programmes de base
-crits en \web{} qui sont tous traduits en langage C. Les composants du noyau
-de \TeX{} sont :
-
-\begin{description}
-%\renewcommand{\makelabel}[1]{\descriptionlabel{\makebox[0.6in][l]{#1}}}
-\item[bibtex] Gre les bibliographies.
-\item[dmp] \cmdname{troff} vers MPX (dessins \MP{}).
-\item[dvicopy] Copie le fichier \dvi{} en supprimant les fontes
-virtuelles.
-\item[dvitomp] Convertit le fichier \dvi{} en MPX (dessins \MP{}).
-\item[dvitype] Convertit le fichier \dvi{} en un texte lisible.
-\item[gftodvi] Visualisation de fontes gnriques GF.
-\item[gftopk] Convertit les fontes gnriques GF en fontes bitmap PK.
-\item[gftype] Convertit le fichier GF en un texte lisible.
-\item[makempx] Typographie des tiquettes \MP{}.
-\item[mf] Cration de fontes.
-\item[mft] Mise en page de code source \MF{}.
-\item[mpost] Cration de diagrammes techniques.
-\item[mpto] Extraction d'tiquettes \MP{}.
-\item[newer] Comparaison de dates de modification (fichiers).
-\item[patgen] Cration de motifs de csure.
-\item[pktogf] Convertit les fontes bitmap PK en fontes gnriques GF.
-\item[pktype] Convertit les fontes PK en un texte lisible.
-\item[pltotf] Convertit les fichiers PL (lisibles) en TFM.
-\item[pooltype] Affiche les fichiers \web{} pool.
-\item[tangle] \web{} vers Pascal.
-\item[tex] Composition de textes.
-\item[tftopl] Convertit les fichiers TFM en PL (lisibles).
-\item[vftovp] Convertit les fontes virtuelles VF en VPL (lisibles).
-\item[vptovf] Convertit les fontes VPL en fontes virtuelles VF.
-\item[weave] \web{} vers \TeX.
-\end{description}
-
-La syntaxe et les fonctions prcises de ces programmes sont dcrites
-dans
-la documentation des composants individuels et dans le manuel \Webc{}
-lui-mme. Toutefois, connatre un certain nombre de principes
-rgissant
-l'ensemble de la famille de programmes peut aider exploiter de
-faon
-optimale votre installation \Webc{}.
-
- Presque tous ces programmes suivent les
-options standard de \acro{GNU} :
-\begin{description}
-%\renewcommand{\descriptionlabel}[1]{\makebox[1.4in][l]{#1}}
- \item[\texttt{-{}-help}] imprime le sommaire de l'utilisation,
- \item[\texttt{-{}-verbose}] imprime le rapport dtaill du processus,
- \item[\texttt{-{}-version}] imprime seulement le numro de version.
-\end{description}
-
-Pour localiser les fichiers, les programmes \Webc{} utilisent la
-bibliothque de recherche \KPS{}. Cette bibliothque utilise une
-combinaison de
-variables d'environnement et un certain nombre de fichiers de
-paramtres pour optimiser la recherche dans l'norme arborescence
-\TeX{}.
-\Webc{} peut excuter une recherche dans plusieurs arborescences
-simultanment, ce qui est utile si l'on souhaite maintenir la
-distribution standard de \TeX{} et les extensions locales dans deux
-arborescences distinctes. Afin d'acclrer la recherche de fichiers, la
-racine de chaque arborescence possde un fichier \file{ls-R} contenant
-une
-entre donnant le nom et le chemin de chaque fichier situ sous la
-racine.
-
-\subsection{Kpathsea et la recherche de fichiers}
-
-Dcrivons en premier lieu le mcanisme de recherche de la bibliothque
-\KPS{}.
-
-Nous appelons \emph{chemin de recherche} une liste, spare par
-\og deux-points\fg{} ou \og point-virgule\fg{}, d'lments, appels
-\emph{lments de chemin}, qui sont des noms de rpertoires.
-Un chemin de recherche peut provenir de plusieurs sources.
-Pour rechercher un fichier \samp{my-file} le long
-d'un chemin \samp{.:/dir}, \KPS{} vrifie chaque lment du
-chemin :
-d'abord \filename{./my-file}, puis \filename{/dir/my-file}, et renvoie la
-premire occurrence (voire toutes).
-
-Afin d'optimiser l'adaptation tous les systmes d'exploitation,
-\KPS{} peut utiliser dans les noms de fichiers des sparateurs
-diffrents
-de deux-points (\samp{:}) et barre oblique (\samp{/})
- pour les systmes non-Unix.
-
-Pour vrifier un lment de chemin particulier \var{p}, \KPS{}
-vrifie d'abord si une base de donnes existante (voir
-page~\pageref{Filename-database}) contient \var{p},
-c.--d. si la base de donnes se trouve dans un
-rpertoire qui est un prfixe de \var{p}. Si oui, la spcification
-du chemin est compare avec le contenu de la base de donnes.
-
-Si la base de donnes n'existe pas, si elle ne s'applique pas cet
-lment de chemin ou si elle ne contient aucune correspondance,
-la recherche est lance sur tout le systme de fichiers (si cela
-n'a
-pas t interdit
-par une commande commenant par \samp{!!}
- et si le fichier cherch est cens exister).
-\KPS{} construit la liste de rpertoires qui correspondent
- cet lment de chemin, puis cherche le fichier dans chaque
-lment
-de cette liste.
-
-La condition \og le fichier est cens exister\fg{} est lie aux
-fichiers~\samp{.vf} et aux fichiers d'entre lus par la commande \TeX\
-\cs{openin}.
-De tels fichiers peuvent ne pas exister (par exemple \file{cmr10.vf}),
-il
-est donc inutile de les rechercher sur le disque. De plus, si vous
-n'actualisez pas le fichier \file{ls-R} lors de l'installation d'un
-nouveau fichier
-\samp{.vf},
-il ne sera jamais trouv.
-Chaque lment de chemin est alors vrifi : d'abord dans
-la base de donnes puis sur le disque. Si une occurrence est
-trouve, la recherche s'arrte et le rsultat est obtenu.
-
-Bien que l'lment de chemin le plus simple et le plus frquent
-soit un
-nom de rpertoire, \KPS{} supporte d'autres types d'lments dans
-les
-chemins de recherche : des valeurs par dfaut diffrentes pour chaque
-programme, des noms de variables d'environnement, des valeurs de
-fichiers de
-configuration, les rpertoires de l'utilisateur et la recherche
-rcursive
-de sous-rpertoires. Nous disons alors que \KPS{} \emph{tend} un
-lment, c'est--dire que \KPS{} transforme toutes ces
-spcifications
-en noms de rpertoires de base. Cette opration est dcrite dans les sections
-suivantes.
-
-Notons que si le nom de fichier cherch est absolu ou explicitement
-relatif, c'est--dire commenant par \samp{/}, \samp{./} ou
-\samp{../}, \KPS{} ne vrifie que l'existence de ce fichier.
-\ifSingleColumn
-\else
-\begin{figure*}
-\verbatiminput{examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{Un exemple de fichier de configuration}
- \label{fig:config-sample}
-\end{figure*}
-\fi
-
-\subsubsection{Les diffrentes sources}
-\label{Path-sources}
-
-Un chemin de recherche peut provenir de plusieurs sources. Voici l'ordre
-dans lequel \KPS\ les utilise.
-
-\begin{enumerate}
-\item
- Une variable d'environnement dfinie par l'utilisateur, par exemple
- \envname{TEXINPUTS}. Les variables d'environnement avec une
- extension attache (nom de programme) sont d'abord prises en compte :
- par exemple, si \samp{latex} est le nom du programme excut,
- \envname{TEXINPUTS.latex} passera avant \envname{TEXINPUTS}.
-\item
- Un fichier de configuration de programme spcifique, par exemple une
-ligne
- \og \texttt{S /a:/b}\fg{} dans le fichier \file{config.ps} de \cmdname{dvips}.
-\item
- Un fichier de configuration \file{texmf.cnf} de \KPS{} contenant une
- ligne telle que \\ \samp{TEXINPUTS=/c:/d} (voir ci-dessous).
-\item La valeur par dfaut obtenue la compilation.
-\end{enumerate}
-\noindent On peut voir chacune de ces valeurs pour un chemin de
-recherche
-donn en utilisant l'option de dbogage (voir page~\pageref{Debugging}).
-
-\subsubsection{Fichiers de configuration}
-
-\begingroup\tolerance=3500
-\KPS{} lit dans les \emph{fichiers de configuration
- l'excution} appels \file{texmf.cnf} les chemins de recherche et
-d'autres dfinitions. Le chemin pour accder ces fichiers dans
-l'arborescence est stock dans la variable \envname{TEXMFCNF}
-(par dfaut ces
-fichiers se trouvent dans le sous-rpertoire \file{texmf/web2c}).
-\emph{Tous} les fichiers \file{texmf.cnf} se trouvant dans le chemin
-de recherche vont tre lus et les dfinitions provenant
-de fichiers prcdents craseront celles des fichiers suivants. Par
-exemple, avec un chemin tel que \verb|.:$TEXMF|, les dfinitions du
-fichier \filename{./texmf.cnf} crasent celles de
-\verb|$TEXMF/texmf.cnf|.
-\endgroup
-
-\begin{itemize}
-\item
- Les commentaires sont signals par un \texttt{\%} et
- se terminent la fin de la ligne.
-\item
- Les lignes vides sont ignores.
-\item
- Un \bs{} la fin d'une ligne joue le rle d'un lien entre deux
- lignes, c'est--dire que la ligne courante se poursuit la ligne
- suivante. Dans ce cas, les espaces prsents au dbut de la ligne
- suivante ne sont pas ignors.
-\item
- Toutes les autres lignes sont de la forme :
-\begin{alltt}
- \emph{variable}[.\emph{progname}] [=] \emph{value}
-\end{alltt}%
- o le \samp{=} et les espaces autour sont optionnels.
-\item
- Le nom de la \ttvar{variable} peut contenir n'importe
- quel caractre autre que les espaces, \samp{=}, ou \samp{.}, mais
- on recommande d'utiliser \samp{A-Za-z\_} pour viter les
- problmes.
-\item
- Si \samp{.\var{progname}} est prsent, sa dfinition
- s'applique seulement si le programme excut se nomme
- \texttt{\var{progname}} ou \texttt{\var{progname}.exe}. Ceci permet
- par exemple diffrentes variantes de \TeX{} d'avoir des chemins de
- recherche diffrents.
-\item
- \var{value} peut contenir n'importe quel caractre
- except \code{\%} et \samp{@}.
- L'option
- \code{\$\var{var}.\var{prog}}
- n'est pas disponible droite du signe \samp{=} ;
- la place, on doit utiliser une variable supplmentaire. Un
-\samp{;}\ dans \var{value}
-est compris comme un
- \samp{:}\ si on travaille sous Unix ; ceci est trs utile et
- permet d'avoir un seul \file{texmf.cnf} pour les systmes Unix,
- \acro{MS-DOS} et Windows.
-\item
- Toutes les dfinitions sont lues avant tout dsarchivage ou
- dcompactage, de telle faon que les variables peuvent tre
- rfrences avant d'tre dfinies.
-\end{itemize}
-Voici un fichier de configuration illustrant les points
-prcdents
-\ifSingleColumn
-
-%\verbatiminput{examples/ex5.tex} % trop petit (df)
-\begin{verbatim}
-TEXMF = {$TEXMFLOCAL,!!$TEXMFMAIN}
-TEXINPUTS.latex = .;$TEXMF/tex/{latex,generic;}//
-TEXINPUTS.fontinst = .;$TEXMF/tex//;$TEXMF/fonts/afm//
-% e-TeX related files
-TEXINPUTS.elatex = .;$TEXMF/{etex,tex}/{latex,generic;}//
-TEXINPUTS.etex = .;$TEXMF/{etex,tex}/{eplain,plain,generic;}//
-\end{verbatim}
-
-\else
-dans la figure~\ref{fig:config-sample}.
-\fi
-
-\subsubsection{Expansion d'un chemin de recherche}
-\label{Path-expansion}
-
-\KPS{} reconnat certains caractres et constructions spciales dans
-les chemins de recherche, semblables ceux disponibles dans les
-\textit{shells} Unix. Ainsi, le chemin complexe,
-\verb+~$USER/{foo,bar}//baz+ %$
-tend la recherche vers tous les sous-rpertoires situs sous les
-rpertoires \file{foo} et \file{bar} dans le rpertoire utilisateur
-\texttt{\$USER} contenant un rpertoire ou un fichier appel %$
-\file{baz}. Ces expansions sont explicites dans les sections
-suivantes.
-
-\subsubsection{Expansion par dfaut}
-\label{Default-expansion}
-
-\tolerance=2500
-Si le chemin de recherche le plus prioritaire (voir
-section~\ref{Path-sources}) contient un \samp{:}
-\emph{supplmentaire} (c.--d. en dbut ou fin de ligne ou
-double), \KPS{} insre cet endroit le chemin suivant dont la
-priorit dfinie est immdiatement infrieure. Si ce chemin insr
-possde un \samp{:} supplmentaire, le mme processus se
-rpte pour le chemin prioritaire suivant.
-Par exemple, tant donn une variable d'environnement dfinie ainsi
-
-\tolerance=1500
-
-\begin{alltt}
-> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
-la valeur de \code{TEXINPUTS} d'aprs le fichier \file{texmf.cnf} tant
-
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
-alors la valeur finale utilise pour la recherche sera
-
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-
-Comme il est inutile d'insrer la valeur par dfaut en plusieurs
-endroits, \KPS{} applique la substitution seulement un \samp{:}
-supplmentaire et laisse les autres inchangs : il cherche d'abord un
-\samp{:} en dbut de ligne, puis en fin de ligne et enfin un double
-\samp{:}.
-
-\subsubsection{Expansion spcifie par les accolades}
-
-Option utile, l'expansion par le biais des accolades
-signifie, par exemple, que \verb+v{a,b}w+ va permettre la recherche
-dans \verb+vaw:vbw+. Les dfinitions embotes sont autorises. Ceci
-peut tre utilis pour tablir des hirarchies \TeX{} multiples en
-attribuant une liste entre accolades \code{\$TEXMF}. Par exemple,
-dans \file{texmf.cnf}, on trouve une dfinition du type suivant
-(il y a en fait plus de rpertoires) :
-\begin{verbatim}
- TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFSYSVAR,!!$TEXMFMAIN}
-\end{verbatim}
-Avec ceci, on peut crire quelque chose comme
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-%$
-ce qui signifie que, aprs avoir cherch dans le rpertoire courant, les
-arborescences compltes \code{\$TEXMFHOME/tex} suivie de
-\code{\$TEXMFLOCAL/tex} (sur le disque) et ensuite les arborescences
-\code{!!\$TEXMFVAR/tex} et \code{!!\$TEXMFMAIN/tex}
-(dfinies dans le fichier de rfrence \file{ls-R} \emph{seulement}) seront
-inspectes. C'est un moyen pratique permettant d'utiliser en parallle deux
-distributions \TeX{}, une \og gele\fg{} (sur un \CD, par exemple) et une
-autre rgulirement mise jour avec de nouvelles versions quand elles
-deviennent disponibles. En utilisant la variable \code{\$TEXMF} dans toutes
-les dfinitions, on est toujours sr d'inspecter d'abord l'arborescence la
-plus rcente.
-
-\subsubsection{Expansion des sous-rpertoires}
-\label{Subdirectory-expansion}
-
-Deux barres \samp{//} ou plus conscutives dans une partie d'un chemin suivant
-un rpertoire \var{d} sont remplaces par tous les sous-rpertoires de
-\var{d} : d'abord les sous-rpertoires directement prsents dans
-\var{d}, ensuite les sous-rpertoires de ceux-ci, et ainsi de suite.
-chaque niveau, l'ordre dans lequel les rpertoires sont inspects est
-\emph{non-dtermin}.
-
-Dans le cas o l'on spcifie une partie de nom de fichier aprs le
-\samp{//}, seuls sont inclus les sous-rpertoires auxquels le nom
-correspond. Par exemple, \samp{/a//b} va correspondre aux rpertoires
-\file{/a/1/b}, \file{/a/2/b},
-\file{/a/1/1/b}, et ainsi de suite, mais pas \file{/a/b/c} ni
-\file{/a/1}.
-
-Des \samp{//} multiples et successifs dans un chemin sont possibles,
-mais \samp{//} au dbut d'un chemin est ignor.
-
-\subsubsection{Liste des caractres spciaux et de leur signification :
- rcapitulatif}
-
-La liste suivante rcapitule la signification des caractres spciaux
-dans les fichiers de configuration de \KPS{}.
-
-\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
-
-\begin{ttdescription}
-
-\item[\CODE{:}] Sparateur dans un chemin de recherche ; au dbut
- ou la fin d'un chemin, il remplace le chemin par dfaut.
-
-\item[\CODE{;}] Sparateur dans les systmes non-Unix
- (joue le rle de \code{:}).
-
-\item[\CODE{\$}] Substitue le contenu d'une variable.
-
-\item[\CODE{\string~}] Reprsente le rpertoire racine de
- l'utilisateur.
-
-\item[\CODE{\char`\{...\char`\}}] Expansion par les accolades,
- par exemple \verb+a{1,2}b+ devient \verb+a1b:a2b+.
-
-\item[\CODE{//}] La recherche concernera aussi les sous-rpertoires
- (peut tre insr n'importe o dans un chemin sauf au dbut).
-
-\item[\CODE{\%}] Dbut d'un commentaire.
-
-\item[\CODE{\bs}] Caractre de continuation de ligne (permet les
- entres sur plusieurs lignes).
-
-\item[\CODE{!!}] Cherche \emph{seulement} dans la base de
- donnes pour localiser le fichier et \emph{ne cherche pas} sur le disque.
-
-\end{ttdescription}
-
-\subsection{Les bases de donnes}
-\label{Filename-database}
-
-\KPS{} a une certaine profondeur d'investigation pour minimiser les
-accs disque durant les recherches. Nanmoins, dans le cas de
-distributions comprenant beaucoup de rpertoires, inspecter chaque
-rpertoire possible pour un fichier donn peut durer excessivement
-longtemps (ceci est typiquement le cas quand plusieurs centaines de
-rpertoires de polices de caractres doivent tre parcourus). En
-consquence, \KPS{} peut utiliser un fichier texte appel \file{ls-R} --- en
-fait une base de donnes
-construite au pralable --- qui fait correspondre
-les fichiers leur rpertoire, ce qui permet d'viter une recherche
-exhaustive sur le disque.
-
-Un deuxime fichier appel \file{aliases} (qui est galement une base de
-donnes) permet de donner
-des noms diffrents aux fichiers lists dans \mbox{\file{ls-R}}. Ceci peut
-aider adapter ses fichiers source aux conventions de \acro{DOS}~8.3 pour les
-noms de fichiers.
-
-\subsubsection{Le fichier base de donnes}
-\label{ls-R}
-
-Comme nous l'avons expliqu ci-dessus, le nom du principal fichier-base de
-donnes doit tre \mbox{\file{ls-R}}.
-Dans votre installation, vous pouvez en mettre un la racine de chaque
-arborescence \TeX{} que vous dsirez voir
-inspecter (\code{\$TEXMF} par dfaut) ; la plupart des sites ont
-une seule arborescence \TeX{}. \KPS{} cherche les fichiers \file{ls-R}
-dans le chemin spcifi dans la variable \code{TEXMFDBS}.
-
-La meilleure faon de crer et mettre jour le fichier \file{ls-R}
-est d'excuter le script \cmdname{mktexlsr} inclus dans la
-distribution. Il est appel par les divers scripts \cmdname{mktex}\dots\
-En principe, ce script excute uniquement la commande
-%cd \var{/your/texmf/root} && \path|\|ls -1LAR ./ >ls-R|
-% Remplac (df) car \path|...| plante cause de \let\path\url.
-\begin{alltt}
-cd \var{/your/texmf/root} && \boi{}ls -1LAR ./ >ls-R
-\end{alltt}
-en supposant que la commande \code{ls} de votre systme produise le bon
-format de sortie (le \code{ls} de \acro{GNU} convient
-parfaitement). Pour s'assurer que la base de donnes est toujours
-jour, le meilleur moyen est de la reconstruire en utilisant la table
-des \code{cron}, de telle faon que le fichier \file{ls-R} prenne
-automatiquement en compte les changements dans les fichiers
-installs, par exemple aprs une installation ou une
-mise jour d'un composant \LaTeX{}.
-
-Si un fichier n'est pas trouv dans la base de donnes, par dfaut
-\KPS{} dcide de le chercher sur le disque. Par contre, si un lment du
-chemin commence par \samp{!!}, \emph{seule} la base de donnes
-sera inspecte pour cet lment, jamais le disque.
-
-\subsubsection{kpsewhich : programme de recherche dans une arborescence}
-\label{Invoking-kpsewhich}
-
-Le programme \texttt{kpsewhich} effectue une recherche dans une
-arborescence indpendamment de toute application. On peut le
-considrer comme une sorte de \code{find} pour localiser des fichiers
-dans les arborescences \TeX{} (ceci est largement utilis dans les
-scripts \cmdname{mktex}\dots\ de la distribution).
-
-\begin{alltt}
-> \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}}
-\end{alltt}
-Les options spcifies dans \ttvar{option} peuvent
-commencer soit par \samp{-} soit par \samp{-{}-} ; n'importe quelle
-abrviation claire est accepte.
-
-\KPS{} considre tout argument non optionnel dans la ligne de commande
-comme un nom de fichier et renvoie la premire occurrence trouve. Il
-n'y a pas d'option pour renvoyer tous les fichiers ayant un nom
-particulier (vous pouvez utiliser le \cmdname{find} d'Unix pour cela).
-
-Les options les plus importantes sont dcrites ci-aprs.
-
-\begin{ttdescription}
-%\renewcommand{\makelabel}[1]{\descriptionlabel{\makebox[1.2in]{#1}}}
-\item[\texttt{-{}-dpi=\var{num}}]\mbox{} \\
- Dfinit la rsolution \ttvar{num} ; ceci affecte
- seulement la recherche des fichiers \samp{gf} et \samp{pk}. \samp{-D} est un
- synonyme pour assurer la compatibilit avec \cmdname{dvips}. Le dfaut
- est 600.
-\item[\texttt{-{}-format=\var{name}}]\mbox{}\\
- Dfinit le format pour la recherche \ttvar{name}.
- Par dfaut, le format est estim en fonction du nom de fichier.
- Pour les formats qui n'ont pas de suffixe clair associ, comme les
- fichiers de support \MP{} et les fichiers de configuration
- \cmdname{dvips}, vous devez spcifier le nom connu de \KPS, comme
- \texttt{tex} ou \texttt{enc files}. Excutez la commande
- \texttt{kpsewhich -{}-help} pour obtenir la liste prcise.
-
-\item[\texttt{-{}-mode=\var{string}}]\mbox{}\\
- Dfinit le nom du mode comme tant \ttvar{string} ;
-ceci affecte seulement la recherche des \samp{gf} et des \samp{pk}.
-Pas d'option par dfaut, n'importe quel mode sera trouv.
-\item[\texttt{-{}-must-exist}]\mbox{}\\
- Fait tout ce qui est possible pour trouver les fichiers, ce qui
-inclut une recherche sur le disque. Par dfaut, seule la base de
-donnes \file{ls-R} est inspecte, dans un souci d'efficacit.
-\item[\texttt{-{}-path=\var{string}}]\mbox{}\\
- Recherche dans le chemin \ttvar{string} (spar par
-deux-points comme d'habitude), au lieu de prendre le chemin partir
-du nom de fichier. \samp{//} et toutes les expansions habituelles sont
-supportes.
- Les options \samp{-{}-path} et \samp{-{}-format} s'excluent mutuellement.
-\item[\texttt{-{}-progname=\var{name}}]\mbox{}\\
- Dfinit le nom de programme comme tant \ttvar{name}.
- Ceci peut affecter les chemins de recherche via l'option
- \texttt{.\var{progname}} dans les fichiers de configuration.
- Le dfaut est \cmdname{kpsewhich}.
-\item[\texttt{-{}-show-path=\var{name}}]\mbox{}\\
- Montre le chemin utilis pour la recherche des fichiers de type
-\ttvar{name}.
- On peut utiliser soit une extension de fichier (\code{.pk}, \code{.vf},
- etc.), soit un nom de fichier, comme avec l'option \samp{-{}-format}.
-\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\
- Dfinit les options de dbogage comme tant
- \ttvar{num}.
-\end{ttdescription}
-
-\subsubsection{Exemples d'utilisation}
-\label{SExamplesofuse}
-
-Jetons un coup d'{\oe}il \KPS{} en action ; voici une recherche
-toute simple :
-
-\begin{alltt}
-> \Ucom{kpsewhich article.cls}
-/usr/local/texmf-dist/tex/latex/base/article.cls
-\end{alltt}
-Nous recherchons le fichier \file{article.cls}. Puisque le suffixe
-\file{.cls} est non-ambigu, nous n'avons pas besoin de spcifier que
-nous voulons rechercher un fichier de type \optname{tex} (rpertoires des
-fichiers sources de \TeX{}). Nous le trouvons dans le sous-rpertoire
-\filename{tex/latex/base} du rpertoire racine \samp{TEXMF}. De mme,
- le suffixe non-ambigu permet de trouver facilement les autres fichiers.
-\begin{alltt}
-> \Ucom{kpsewhich array.sty}
- /usr/local/texmf-dist/tex/latex/tools/array.sty
-> \Ucom{kpsewhich latin1.def}
- /usr/local/texmf-dist/tex/latex/base/latin1.def
-> \Ucom{kpsewhich size10.clo}
- /usr/local/texmf-dist/tex/latex/base/size10.clo
-> \Ucom{kpsewhich small2e.tex}
- /usr/local/texmf-dist/tex/latex/base/small2e.tex
-> \Ucom{kpsewhich tugboat.bib}
- /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-Le dernier exemple est une base de donnes bibliographiques pour \BibTeX{}
-servant aux articles de \textsl{TUGBoat}.
-
-\begin{alltt}
-> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
-Les fichiers de glyphes de fontes bitmaps, de type
-\file{.pk}, sont
-utiliss pour l'affichage par des programmes comme \cmdname{dvips} et
-\cmdname{xdvi}. Rien n'est renvoy dans ce cas puisque il n'y a pas
-de fichiers Computer Modern \file{.pk} pr-crs sur nos systmes
-(nous utilisons les versions type~1 du \TL{}).
-\begin{alltt}
-> \Ucom{kpsewhich wsuipa10.pk}
-\ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
-\else /usr/local/texmf-var/fonts/pk/ljfour/public/
-... wsuipa/wsuipa10.600pk
-\fi\end{alltt}
-Pour ces fontes (alphabet phontique de l'universit Washington),
-nous avons d crer les fichiers \file{.pk} et, puisque le mode \MF{} par
-dfaut sur notre installation est \texttt{ljfour} avec une rsolution de
-base de 600\dpi{} \textit{(dots per inch)}, cette instance est trouve.
-\begin{alltt}
-> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
-\end{alltt}
-Dans ce cas, lorsque l'on spcifie que nous recherchons une
-rsolution de 300\dpi{} (\texttt{-dpi=300}) nous voyons qu'aucune fonte
-pour cette rsolution n'est disponible dans le systme. En fait, un
-programme comme \cmdname{dvips} ou \cmdname{xdvi} ne s'en
-proccuperait pas et crerait les fichiers \file{.pk} la
-rsolution demande en utilisant le script \cmdname{mktexpk}.
-
-Intressons-nous prsent aux fichiers d'en-tte et de configuration
-pour \cmdname{dvips}.
-Regardons en premier le fichier \file{tex.pro} communment utilis
-pour le support de \TeX{} avant de regarder le fichier
-de configuration gnrique (\file{config.ps}) et la liste des fontes
-\PS{} \file{psfonts.map}. Depuis l'dition 2004, les fichiers
-\file{.map} et les fichiers de codage ont chang de place dans
-l'arborescence \dirname{texmf}. Comme le suffixe \file{.ps} est
-ambigu, nous devons spcifier quel type particulier du fichier
-\texttt{config.ps} nous considrons (\optname{dvips config}).
-\begin{alltt}
-> \Ucom{kpsewhich tex.pro}
- /usr/local/texmf/dvips/base/tex.pro
-> \Ucom{kpsewhich -{}-format="dvips config" config.ps}
- /usr/local/texmf-var/dvips/config/config.ps
-> \Ucom{kpsewhich psfonts.map}
- /usr/local/texmf-var/fonts/map/dvips/updmap/psfonts.map
-\end{alltt}
-
-Regardons plus en dtail les fichiers de support Times
-\PS{} d'\acro{URW}. Leur nom standard dans le schma de nommage des fontes
-est \samp{utm}. Le premier fichier que nous voyons est le
-fichier de configuration, qui contient le nom du fichier
-de la liste :
-\begin{alltt}
-> \Ucom{kpsewhich -{}-format="dvips config" config.utm}
- /usr/local/texmf-dist/dvips/psnfss/config.utm
-\end{alltt}
-Le contenu de ce fichier est
-\begin{alltt}
- p +utm.map
-\end{alltt}
-qui pointe vers le fichier \file{utm.map}, que nous cherchons
-localiser ensuite.
-\begin{alltt}
-> \Ucom{kpsewhich utm.map}
- /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
-\end{alltt}
-Ce fichier liste les noms des fichiers des
-fontes \PS{} de type~1 dans la collection URW. Son contenu
-ressemble (nous ne montrons qu'une partie des lignes) :
-\begin{alltt}
-utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
-utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
-utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
-Prenons par exemple le cas de Times Roman \file{utmr8a.pfb} et
-trouvons sa position dans l'arborescence \file{texmf} en utilisant une
-recherche applicable aux fichiers de fontes de type~1 :
-\begin{alltt}
-> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
-\else /usr/local/texmf-dist/fonts/type1/
-... urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
-Il devrait tre clair, d'aprs ces quelques exemples, qu'il est facile
-de trouver l'endroit o se cache un fichier donn. C'est
-particulirement important si vous suspectez que c'est, pour une
-raison quelconque, une mauvaise version du fichier qui est utilise,
-puisque \cmdname{kpsewhich} va vous montrer le premier fichier
-trouv.
-
-\subsubsection{Oprations de dbogage}
-\label{Debugging}
-
-Il est quelquefois ncessaire de savoir comment un programme rfrence
-les fichiers. Pour permettre cela, \KPS{} offre
-plusieurs niveaux de dbogage :
-\begin{ttdescription}
-\item[\texttt{\ 1}] Appels \texttt{stat} (test d'existence de fichier). Lors d'une
- excution utilisant une base de donnes \file{ls-R} jour, ce niveau
- ne devrait donner presque aucune information en sortie.
-\item[\texttt{\ 2}] Rfrences aux diffrentes tables (comme la base
- de donnes \file{ls-R}, les fichiers de correspondance de fontes, les fichiers de
- configuration).
-\item[\texttt{\ 4}] Oprations d'ouverture et de fermeture des
- fichiers.
-\item[\texttt{\ 8}] Information globale sur la localisation des types
- de fichiers recherchs par \KPS. Ceci est utile pour trouver o a t
- dfini le chemin particulier pour un fichier.
-\item[\texttt{16}] Liste des rpertoires pour chaque lment du
- chemin (utilis uniquement en cas de recherche sur le disque).
-\item[\texttt{32}] Recherche de fichiers.
-\end{ttdescription}
-Une valeur de \texttt{-1} activera toutes les options ci-dessus ; en
-pratique, c'est habituellement la valeur la plus adapte.
-
-De la mme faon, avec le programme \cmdname{dvips}, en utilisant une
-combinaison d'options de dbogage, on peut suivre en dtail la
-localisation des
-diffrents fichiers. De plus, lorsqu'un fichier n'est
-pas trouv, la trace du dbogage montre les diffrents rpertoires dans
-lesquels le programme va chercher tel ou tel fichier, donnant ainsi
-des indices sur le problme.
-
-Gnralement, comme la plupart des programmes appellent la
-bibliothque \KPS{} en interne, on peut slectionner une option de
-dbogage en utilisant la variable d'environnement
-\envname{KPATHSEA\_DEBUG}, et en la dfinissant gale la valeur (ou
- une combinaison de valeurs) dcrite(s) dans la liste ci-dessus.
-
-Note l'intention des utilisateurs de Windows : il n'est pas facile
-de rediriger les messages d'erreur vers un fichier sur ces
-systmes. des fins de diagnostic, vous pouvez temporairement
-affecter \texttt{KPATHSEA\_DEBUG\_OUTPUT=err.log} pour capturer le flux
-standard d'erreur dans le fichier \texttt{err.log}.
-
-Considrons comme exemple un petit fichier source \LaTeX{},
-\file{hello-world.tex}, dont le contenu est le suivant.
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
-Ce petit fichier utilise simplement la fonte \file{cmr10}, aussi
-allons voir comment \cmdname{dvips} prpare le fichier \PS{}
-(nous voulons utiliser la version type~1
-des fontes Computer Modern, d'o l'option \texttt{-Pcms}).
-\begin{alltt}
-> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
-Dans ce cas, nous avons combin le niveau 4 de dbogage de
-\cmdname{dvips} (chemins des fontes) avec l'option d'expansion des
-lments du chemin de \KPS\ (voir \cmdname{dvips} Reference Manual,
-\OnCD{texmf/doc/html/dvips/dvips_toc.html} sur le \DVDlive{}).
-La sortie (lgrement formate) apparat dans la
-figure~\ref{fig:dvipsdbga}.
-\begin{figure*}[tp]
-\centering
-\input{examples/ex6a.tex}
-\caption{Recherche des fichiers de configuration}\label{fig:dvipsdbga}
-
-\bigskip
-
-\input{examples/ex6b.tex}
-\caption{Recherche du fichier prolog}\label{fig:dvipsdbgb}
-
-\bigskip
-
-\input{examples/ex6c.tex}
-\caption{Recherche du fichier de fontes}\label{fig:dvipsdbgc}
-\end{figure*}
-
-\cmdname{dvips} commence par localiser ses fichiers de
-fonctionnement. D'abord, \file{texmf.cnf} est trouv, ce qui donne les
-dfinitions pour les chemins de recherche servant localiser les
-autres fichiers, ensuite le fichier base de donnes \file{ls-R} (pour
-optimiser la recherche des fichiers) et le fichier \file{aliases}, qui
-permet de dclarer plusieurs noms (\p.ex., un nom \acro{DOS} de type
-8.3 court et une version longue plus naturelle) pour le mme
-fichier. Ensuite \cmdname{dvips} continue en cherchant le fichier de
-configuration gnrique \file{config.ps} avant de rechercher le fichier
-de paramtrisation \file{.dvipsrc} (qui, dans notre cas, \emph{n'est
-pas trouv}). Enfin, \cmdname{dvips} localise le fichier de
-configuration pour les fontes \PS{} Computer Modern
-\file{config.cms} (ceci est lanc par l'option \mbox{\texttt{-Pcms}} de la
-commande \cmdname{dvips}). Ce fichier contient la liste des fichiers
- qui dfinissent la relation entre les noms des fontes
-selon \TeX{}, selon \PS{} et dans le systme de fichiers.
-\begin{alltt}
-> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
- p +ams.map
- p +cms.map
- p +cmbkm.map
- p +amsbkm.map
-\end{alltt}
-\cmdname{dvips} veut chercher tous ces fichiers, y compris le
-fichier gnrique d'association \file{psfonts.map}, qui est toujours
-charg (il contient des dclarations pour les fontes \PS{} les
-plus communment utilises ; voir la dernire partie de la Section
-\ref{SExamplesofuse} pour plus de dtails sur la gestion du fichier
-d'association \PS{}).
-
-Arriv l, \cmdname{dvips} s'identifie l'utilisateur :
- \begin{alltt}
- This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com)
- \end{alltt}
-
-\ifSingleColumn
-pour continuer ensuite en cherchant le fichier prologue \file{texc.pro},
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
-pour continuer ensuite en cherchant le fichier prologue \file{texc.pro}
-(voir la figure~\ref{fig:dvipsdbgb}).
-\fi
-
-Aprs avoir trouv ce fichier, \cmdname{dvips} affiche la date et
-l'heure, et nous informe qu'il va gnrer le fichier
-\file{hello-world.ps}, puis qu'il a besoin du fichier de fonte
-\file{cmr10}, et que ce dernier est dclar comme \og rsident\fg{}
-(pas besoin de bitmaps) :
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
-Maintenant la recherche concerne le fichier \file{cmr10.tfm}, qui est
-trouv, puis quelques fichiers de prologue de plus (non montrs) sont
-rfrencs ; finalement le fichier de la fonte type~1 \file{cmr10.pfb}
-est localis et inclus dans le fichier de sortie (voir la dernire ligne).
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-\subsection{Options l'excution}
-
-\Webc{} offre la possibilit de contrler l'excution bon nombre de
-paramtres concernant la mmoire (en particulier la taille des
-tableaux utiliss) partir du fichier
-\file{texmf.cnf} qui est lu par \KPS.
-Les paramtres en question se trouvent
-dans la troisime partie du fichier inclus dans la distribution \TL{}.
- Les variables les plus importantes sont :
-\begin{ttdescription}
-\item[\texttt{main\_memory}]
- Nombre total de mots mmoire disponibles pour
- \TeX{}, \MF{} et \MP. Vous devez gnrer un nouveau fichier de
- format pour chaque nouveau paramtrage. Par exemple, vous pouvez
- gnrer une version large de \TeX{} et appeler le fichier de format
- \texttt{hugetex.fmt}. En utilisant la mthode supporte par \KPS{}
- qui consiste suffixer la variable par le nom du programme, la valeur
- particulire de la variable \texttt{main\_memory} destine ce
- fichier de format sera lue dans le fichier \file{texmf.cnf}.
-\item[\texttt{extra\_mem\_bot}]
- Espace supplmentaire pour certaines structures de donnes de \TeX{} :
- botes, \textit{glue}, points d'arrt\dots{} Surtout utile si vous utilisez
- \PiCTeX{} par exemple.
-\item[\texttt{font\_mem\_size}]
- Nombre de mots mmoire disponibles pour dcrire les polices. C'est
- plus ou moins l'espace occup par les fichiers TFM lus.
-\item[\texttt{hash\_extra}]
- Espace supplmentaire pour la table de hachage des noms de squences
- de contrle. Environ 10~000 de ces noms peuvent tre stocks dans la
- table principale ; si vous avez un document trs volumineux avec
- beaucoup de rfrences croises, il se peut que ce ne soit pas
- suffisant. La valeur par dfaut \texttt{hash\_extra} est \texttt{50000}.
-\end{ttdescription}
-
-\noindent videmment, cette possibilit ne remplace pas une vritable
-allocation dynamique des tableaux et de la mmoire, mais puisque c'est
-complexe implmenter dans le prsent source \TeX{}, ces paramtres lus
- l'excution fournissent un compromis pratique qui procure une certaine
-souplesse.
-
-%\begin{comment} (supprim (df) 5/5/2006, mail K.B.
-
-\section{Installation sur un nouveau systme Unix}
-
-Si vous avez un systme Unix ne correspondant aucun des excutables
-fournis, il faut compiler vous-mme \TeX{} et tous ses programmes
-satellites partir des sources. Cela n'est pas aussi difficile qu'il
-y parat. Tout ce dont vous aurez besoin est contenu dans le
-rpertoire \texttt{source} qui se trouve sur le \DVDlive.
-
-\subsection{Prrequis}
-
-Il faut au moins 400\,Mo d'espace sur disque pour compiler la
-totalit de \TeX{} et des programmes associs.
-Vous aurez aussi besoin d'un
-compilateur C \acro{ANSI}, de l'utilitaire \cmdname{make},
-d'un gnrateur d'analyseur lexical et d'un gnrateur d'analyseur
-syntaxique. Nous recommandons les versions \acro{GNU} des programmes suivants
-(\cmdname{gcc}, \acro{GNU}\cmdname{make}, \cmdname{m4},
-\cmdname{flex}, \cmdname{bison}). Vous pouvez utiliser d'autres compilateurs C
-et d'autres programmes \cmdname{make} si vous matrisez
-correctement la programmation sous Unix pour rsoudre les
-problmes ventuels. La commande \texttt{uname} doit renvoyer une valeur
-raisonnable.
-
-\subsection{Configuration}
-
-Tout d'abord, effectuez l'installation normale de \TL{} sur le disque
-dur (voir section~\ref{sec:unix-install-disk},
-\p.\pageref{sec:unix-install-disk}). Vous pouvez sauter l'installation de
-tous les binaires prcompils.
-Dcompactez ensuite sur le disque le fichier
-\file{source.tar.bz2} (archive compresse) trouv dans
-le rpertoire \dirname{source} et placez-vous dans
-le rpertoire o vous avez transfr l'ensemble.
-\begin{alltt}
-> \Ucom{cd /tmp/tl-source}
-> \Ucom{bunzip2 source.tar.bz2}
-> \Ucom{tar xf source.tar}
-\end{alltt}
-
-Lancez maintenant \textsf{configure} de la faon suivante :
-\begin{alltt}
-> \Ucom{sh configure -prefix=/usr/local/texlive/2007}
-\end{alltt}
-
-Le rpertoire \optname{-prefix} est le rpertoire de base de
-l'arborescence \TL{}, il est dsign par \var{TEXDIR} dans la suite.
-\begin{comment}
-Les rpertoires utiliss sont les suivants :
-
-\noindent
-\begin{tabular}{>{\ttfamily}ll@{}}
- \dirname{$TEXDIR/texmf-dist} & rpertoire de base pour les fontes,
- macros, etc\\
- \dirname{$TEXDIR/man} & pages du manuel Unix\\
- \dirname{$TEXDIR/info} & manuels \acro{GNU} en format Info\\
- \dirname{$TEXDIR/bin/$archname} & excutables.\\
-\end{tabular}\\
-\end{comment}
-%$
-
-Si vous ne voulez pas crer de rpertoire \dirname{$archname} spcifique %$
-au systme choisi pour stocker les excutables (c.--d. les
-copier directement dans \dirname{$TEXDIR/bin}), %$
-il faut excuter \textsf{configure} avec l'option \\
-\verb|--disable-multiplatform|.
-
-Tapez \verb|./configure --help|, le programme affichera
-les options supplmentaires disponibles (telles que supprimer l'installation
-des extensions optionnelles comme \OMEGA\ ou \eTeX).
-
-\subsection{Excuter \textsf{make}}
-S'assurer que la variable ou l'option \texttt{noclobber} n'est pas dfinie.
- et lancer le \cmdname{make} la racine de l'arborescence de la faon
-suivante :
-\begin{alltt}
->> \Ucom{make world}
-\end{alltt}
-et aller prendre un caf\dots
-
-Il peut tre utile de garder une trace complte dans un fichier log en tapant :
-\begin{alltt}
->> \Ucom{sh -c "make world >world.log 2>\&1" \&}
-\end{alltt}
-Avant de conclure que tout va bien, vrifier que le fichier log ne contient
-pas de message d'erreur : le \cmdname{make} de \acro{GNU} renvoie toujours
-le message \samp{***} chaque erreur d'excution. Vrifier aussi que
-tous les excutables ont t crs.
-\begin{alltt}
->> \Ucom{cd \var{TEXDIR}/bin/\var{archname}}
->> \Ucom{ls | wc}
-\end{alltt}
-Le rsultat doit tre suprieur 200 (on peut tester le nombre exact
-dans le rpertoire \dirname{bin} de la distribution).
-
-Si vous avez besoin de droits spciaux pour excuter \texttt{make install},
-vous pouvez sparer \samp{make world} en deux processus diffrents :
-\begin{alltt}
->> \Ucom{make all}
->> \Ucom{su}
->> \Ucom{make install strip}
-\end{alltt}
-
-Aprs avoir install vos nouveaux binaires, il faut suivre les procdures
-normales de la post-installation, indiques dans la
-section~\ref{sec:postinstall}, \p.\pageref{sec:postinstall}.
-
-%\end{comment} supprim (df) 5/5/2006
-
-\section{Remerciements}
-
-\TL{} est le rsultat des efforts
-collectifs de pratiquement tous les groupes d'utilisateurs de \TeX.
-La prsente dition de \TL{} a t coordonne par
-Sebastian Rahtz et Karl Berry.
-Voici la liste des principaux contributeurs :
-
-\begin{itemize}
-
-\item Les associations d'utilisateurs anglais, allemands, nerlandais et
- polonais (\acro{TUG}, \acro{DANTE} e.V., \acro{NTG}, and \acro{GUST},
- respectivement) qui contribuent ensemble l'infrastructure technique et
- administrative. Soutenez votre association locale (\acro{GUTenberg} pour
- les francophones) !
-
-\item L'quipe du \acro{CTAN} qui distribue les images des distributions \TL{}
- et fournit les sites d'hbergement pour le stockage et la mise jour des
- extensions qui sont la base de \TL.
-
-\item Peter Breitenlohner et toute l'quipe \eTeX{} qui construisent
- les bases des successeurs de \TeX.
-
-\item Thomas Esser, car, sans lui, sa merveilleuse distribution \teTeX{} et
- son aide continuelle, \TL{} n'existerait probablement pas.
-
-\item Michel Goossens, en tant que co-auteur de la documentation initiale.
-
-\item Eitan Gurari, dont le programme \TeX4ht a t utilis pour crer la
- version \HTML{} de cette documentation et qui travailla inlassablement
- l'amliorer, avec des dlais trs brefs.
-
-\item Hans Hagen qui, outre sa participation active aux tests,
- a adapt le format \ConTeXt\ aux besoins de \TL{}.
-
-\item \Thanh, Martin Schr\"oder et toute l'quipe pdf\TeX\ qui continuent
- inlassablement tendre les performances de \TeX.
-
-\item Taco Hoekwater, pour ses efforts sans cesse renouvels l'amlioration
- de MetaPost et de \TeX\ lui-mme.
-
-\item Pawe{\l} Jackowski, pour l'installeur Windows \cmdname{tlpm},
-et Tomasz {\L}uczak, pour la version graphique \cmdname{tlpmgui}.
-
-\item Akira Kakuto, pour son aide prcieuse qui nous a permis
- d'intgrer dans \TL{} les binaires Windows de sa distribution \acro{W32TEX}
- (\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}).
-
-\item Jonathan Kew et son employeur \acro{SIL}, pour avoir produit
- Xe\TeX{} et pour avoir pris la peine de l'intgrer dans \TL{}.
-
-\item Reinhard Kotucha, pour son aide dans la lourde tche consistant
-mettre jour les innombrables extensions incluses dans \TL{} et pour ses
-contributions sous Windows en particulier le script \texttt{getnonfreefonts}.
-
-\item Petr Ol\v{s}ak, qui coordonna et vrifia minutieusement toute la
- partie tchque et slovaque.
-
-\item Toshio Oshima, pour le visualisateur \cmdname{dviout} pour Windows.
-
-\item Fabrice Popineau, pionnier du dveloppement de \TL{} sous Windows.
-
-\item Norbert Preining, pour son aide la mise jour de \TL, ses nombreuses
- suggestions d'amlioration et pour avoir coordonn (avec Frank K\"uster) la
- version Debian de \TL.
-
-\item Staszek Wawrykiewicz, principal testeur de \TL{} et
- coordinateur des contributions polonaises
- (fontes, installation Windows, etc.).
-
-\item Olaf Weber, pour son patient assemblage et la maintenance de \Webc{}
- sur laquelle tout repose.
-
-\item Gerben Wierda, qui a cr et maintient la partie \MacOSX{}
- et qui participe activement aux tests.
-
-\item Graham Williams, du travail duquel dpend le catalogue des
-composants.
-\end{itemize}
-
-Les binaires ont t compils par :
-Hartmut Henkel (\pkgname{x86\_64-linux}),
-Akira Kakuto et Fabrice Popineau (\pkgname{win32}),
-Manfred Lotz (\pkgname{i386-freebsd}),
-Norbert Preining (\pkgname{alpha-linux}),
-Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-linux}
- et \pkgname{sparc-solaris}),
-Karl Berry (\pkgname{i386-linux}),
-Olaf Weber (\pkgname{mips-irix}),
-Gerben Wierda (\pkgname{i386-darwin}, \pkgname{powerpc-darwin}).
-
-Documentation et mises jour des traductions :
-Karl Berry (anglais),
-G\"unter Partosch, Hartmut Henkel \& Klaus H\"oppner (allemand),
-Daniel Flipo (franais),
-Petr Sojka \& Janka Chleb\'\i kov\'a (tchque et slovaque),
-Boris Veytsman (russe),
-Staszek Wawrykiewicz (polonais).
-
-Bien sr, notre gratitude va en premier lieu Donald Knuth pour avoir
-invent \TeX{} et l'avoir offert au monde entier.
-
-\section{Historique des versions successives}
-\label{sec:history}
-
-\subsection{Les ditions prcdentes}
-
-La discussion commena la fin de 1993 quand le Groupe des Utilisateurs
-Nerlandais de \TeX{} commenait travailler son \CD{} 4All\TeX{} pour les
-utilisateurs de \acro{MS-DOS}, et on esprait ce moment sortir un \CD{}
-unique pour tous les systmes. C'tait un objectif beaucoup trop ambitieux,
-mais il permit la naissance du \CD{} 4All\TeX{}, projet couronn de succs,
-mais aussi d'un groupe de travail \og \acro{TUG} Technical Council\fg{} pour
-mettre en place TDS (\emph{\TeX{} Directory Structure} :
-\url{http://tug.org/tds}), qui spcifiait la gestion des fichiers \TeX{} sous
-une forme logique. La mouture finale de \TDS{} fut publie dans le numro de
-dcembre 1995 de \textsl{TUGboat}, et il tait clair depuis un certain temps
-qu'il fallait proposer un produit contenant une structure modle sur \CD{}.
-La distribution que vous possdez est le rsultat direct des dlibrations de
-ce groupe de travail. Il tait galement clair que le succs des \CD{}
-4All\TeX{} dmontrait que les utilisateurs d'Unix trouveraient leur bonheur
-avec une distribution aussi simple, et ceci a t l'autre objectif de
-\TL.
-
-Nous avons d'abord entrepris de crer un nouveau \CD{} \TDS{} Unix l'automne
-1995, et nous avons rapidement choisi \teTeX{} de Thomas Esser comme tant la
-configuration idale, car il supportait dj plusieurs plates-formes et avait
-t construit en gardant l'esprit la portabilit entre systmes. Thomas
-accepta de nous aider et commena travailler srieusement au dbut de 1996.
-La premire dition sortit en mai 1996. Au dbut de 1997, Karl Berry acheva
-une nouvelle distribution de \Webc{}, qui incluait presque toutes les
-caractristiques que Thomas Esser avait ajoutes dans \teTeX, et il fut dcid
-de baser la deuxime dition du \CD{} sur le standard \Webc, en y ajoutant le
-script \texttt{texconfig} de \teTeX. La troisime dition du \CD{} tait
-base sur une version majeure de \Webc, 7.2, par Olaf Weber ; en mme temps,
-une nouvelle version rvise de \teTeX{} tait acheve dont \TL{} partageait
-presque toutes les caractristiques. La quatrime dition a suivi le mme
-schma, en utilisant une nouvelle version de \teTeX{} et une nouvelle version
-de \Webc{} (7.3). Le systme incluait dornavant un programme complet
-d'installation pour Windows.
-
-Pour la cinquime dition (mars 2000), de nombreuses parties du \CD{}
-ont t vrifies et rvises, des centaines de composants
-mis jour.
-Le contenu dtaill des composants tait dcrit par des
-fichiers XML. Mais le changement majeur de cette cinquime dition a
-t la suppression de tout logiciel non libre de droits.
-Tout ce qui se trouve dans \TL{} devait tre compatible avec la licence
-Debian (\emph{Debian Free Software Guidelines} :
-\url{http://www.debian.org/intro/free}) ; nous avons
-fait de notre mieux pour vrifier les termes des licences de chaque
-composant, et nous souhaiterions que toute erreur nous soit signale.
-
-La sixime dition (juillet 2001) contient un grand nombre de mises jour.
-Le changement majeur de cette version rside dans la refonte du
-processus d'installation : l'utilisateur peut dsormais choisir
-les collections de manire plus prcise. Les collections concernant
-les langues ont t entirement rorganises, aussi le choix d'une
-langue installe non seulement les macros, les fontes, etc. mais
-prpare galement un fichier \file{language.dat} adquat.
-
-La septime dition (mai 2002) a comme ajout majeur une installation
-pour \MacOSX{} et l'habituelle myriade de mises jour de composants et
-de programmes. Un objectif important a t de fusionner
-nouveau les sources avec ceux de \teTeX{}, alors que les versions
-5 et 6 s'en taient loignes.
-
-\subsubsection{2003}
-
-En 2003, le flot de mises jour et d'additions a continu, mais nous
-avons constat que \TL{} tait devenu si volumineux qu'il ne
-pouvait plus tenir sur un seul \CD, aussi l'avons-nous divis en trois
-distributions distinctes (voir section~\ref{sec:multiple-dist},
-\p.\pageref{sec:multiple-dist}). Par ailleurs :
-\begin{itemize}
-\item la demande de l'quipe \LaTeX{}, nous avons modifi les
- commandes standard \cmdname{latex} et \cmdname{pdflatex} pour
- qu'elles utilisent \eTeX{} (voir \p.\pageref{text:etex}).
-\item Les nouvelles fontes Latin Modern sont disponibles (et
- recommandes).
-\item Le support pour Alpha \acro{OSF} a t supprim
- (celui pour \acro{HPUX} l'avait t auparavant), car personne
- disposant des machines ncessaires ne s'est
- propos pour compiler les nouveaux binaires.
-\item L'installation pour Windows a t largement modifie ; un environnement
- de travail intgr bas sur \cmdname{XEmacs} a t introduit.
-\item Des programmes supplmentaires importants pour Windows (Perl,
- Ghost\-script, Image\-Magick, Ispell) sont maintenant installs dans le
- rpertoire d'installation de \TL{}.
-\item Les fichiers \emph{font map} utiliss par \cmdname{dvips},
- \cmdname{dvipdfm} et \cmdname{pdftex} sont maintenant gnrs par le
- nouveau programme \cmdname{updmap} et installs dans
- \dirname{texmf/fonts/map}.
-\item Dornavant, \TeX{}, \MF{} et \MP{} crivent les caractres 8-bit
- prsents en entre sans modification, et non pas avec la notation
- \verb|^^|, que ce soit dans des fichiers (par la commande
- \verb|write|), dans les fichiers de trace (\verb|.log|) ou sur le
- terminal. Dans le \TL{}~7, l'criture de ces caractres
- 8-bit tait influence par les paramtres de localisation du
- systme; maintenant ces paramtres n'influent plus du tout sur le
- comportement des programmes \TeX{}. Si pour quelque raison que ce
- soit, vous avez besoin de la notation \verb|^^| en sortie,
- renommez le fichier \verb|texmf/web2c/cp8bit.tcx|. Les prochaines
- versions disposeront d'un moyen plus propre pour contrler cette
- sortie.
-\item La documentation de \TL{} a t largement rvise.
-\item Enfin, comme la numrotation squentielle des versions
- devenait peu maniable, il a t dcid d'identifier dsormais la version
- de \TL{} par l'anne : \TL{}~2003 au lieu de \TL{}~8.
-\end{itemize}
-
-
-\subsubsection{2004}
-
-2004 a apport beaucoup de changements (et quelques incompatibilits avec les
-versions prcdentes) :
-
-\begin{itemize}
-
-\item Si vous avez install des fontes supplmentaires qui ont leur propre
-fichier \file{.map} ou des fichiers \file{.enc} spcifiques, vous
-devrez vraisemblablement dplacer ces fichiers.
-
-Les fichiers \file{.map} sont dsormais recherchs uniquement dans les
-sous-rpertoires \dirname{fonts/map} (dans chaque arborescence
-\filename{texmf}), leur chemin de recherche est donn par la variable
-\envname{TEXFONTMAPS} de \filename{texmf.cnf}.
-De mme, les fichiers \file{.enc} sont dsormais recherchs uniquement
-dans les sous-rpertoires \dirname{fonts/enc}, leur chemin de recherche est
-donn par la variable \envname{ENCFONTS} de \filename{texmf.cnf}.
-Le script \cmdname{updmap} devrait mettre des messages d'avertissement
-pour les fichiers \file{.map} et \file{.enc} mal placs.
-
-Sur les diffrentes faons de traiter le problme, consulter
-\url{http://tug.org/texlive/mapenc.html}.
-
-\item La distribution pour Windows a chang cette anne :
-l'installation de la distribution \fpTeX{} (base sur \Webc{}) de Fabrice
-Popineau n'est provisoirement plus propose dans l'attente
-d'un nouvel installeur. la place, vous pouvez tester et installer
-la distribution \MIKTEX{} (indpendante de \Webc{}),
-voir section~\ref{sec:struct-tl}, \p.\pageref{sec:struct-tl}.
-Le \CDdemo{} diffus en 2003 a t supprim.
-
-\item L'ancien rpertoire \dirname{texmf} a t clat en trois parties :
-\dirname{texmf}, \dirname{texmf-dist} et \dirname{texmf-doc}. Voir
-section~\ref{sec:tld}, \p.\pageref{sec:tld}.
-% et les fichiers \filename{README} la racine de ces rpertoires.
-% (df) Y'en a pas !!!
-
-\item Tous les fichiers relatifs aux diffrents avatars de \TeX{} sont
-dsormais regroups dans le mme sous-rpertoire \dirname{tex} des
-arborescences \dirname{texmf*} (ils taient jusqu'ici placs dans des
-sous-rpertoires spcifiques \dirname{tex}, \dirname{etex},
-\dirname{pdftex}, \dirname{pdfetex}, etc.). Voir
-\CDref{texmf-doc/doc/english/tds/tds.html\#Extensions}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Extensions}}.
-
-\item Les scripts auxiliaires, normalement pas excuts directement
-par les utilisateurs, sont regroups dans un rpertoire \dirname{scripts}
-des arborescences \dirname{texmf*}. On les localise grce la
-commande \verb|kpsewhich -format=texmfscripts|. Au cas o vous en auriez,
-les programmes utilisant ces scripts ncessiteront une adaptation. Voir
-\OnCD{texmf-doc/doc/english/tds/tds.html\#Scripts}.
-
-\item La plupart des formats affichent en clair (dans les fichiers
-\file{.log} en particulier) les caractres imprimables au lieu
-de les transcrire en notation hexadcimale \verb|^^|. Ceci se fait
-grce au fichier \filename{cp227.tcx}, qui considre comme imprimables
-les caractres 32 256, ainsi que les tabulations et les changements
-de page (caractres 9 11). Les formats faisant exception sont
-plain \TeX\ (seuls les caractres 32 127 sont dclars imprimables),
-\ConTeXt{} (0 255 imprimables) et les formats bass sur \OMEGA.
-Il y a peu de diffrence avec le comportement de \TL\,2003
-mais la mise en {\oe}uvre est plus propre et plus facilement configurable.
-Voir \OnCD{texmf/doc/web2c/web2c.html\#TCX-files}.
-Noter que l'utilisation du codage Unicode en entre peut provoquer
-des affichages dfectueux en sortie (TeX code sur un seul octet).
-
-\item Tous les formats, sauf plain \TeX, font appel au moteur
-\textsf{pdfetex} (qui produit bien sr par dfaut des fichiers \acro{DVI}
-lorsque le format choisi est \LaTeX). Ceci permet aux formats
-\LaTeX, \ConTeXt, etc., d'avoir accs aux fonctionnalits
-micro-typographiques de pdf\TeX{} (alignement optique des marges par exemple)
-et aux fonctionnalits de \eTeX{} (\OnCD{texmf-dist/doc/etex/base/}).
-
-Ceci rend \emph{indispensable} le recours l'extension \pkgname{ifpdf}
-(qui fonctionne aussi bien avec plain que \LaTeX) pour dterminer si
-le format de sortie est \acro{DVI} ou \acro{PDF}. Tester si la commande
-\cs{pdfoutput} est dfinie ou non \emph{n'est pas} un moyen fiable
-de le faire.
-
-\item pdf\TeX\ (\url{http://pdftex.org}) offre de nouvelles fonctionnalits :
-
- \begin{itemize}
-
- \item Les commandes \cs{pdfmapfile} et \cs{pdfmapline} permettent
- de spcifier le choix des fichiers \file{.map} utiliser
- pour le document en cours.
-
- \item L'amlioration du gris typographique par variation (infime) de la
- largeur des caractres (\textit{font expansion}) est plus facile
- mettre en {\oe}uvre, voir
- \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}
-
- \item Le fichier \filename{pdftex.cfg} n'est plus utilis.
- Toutes les affectations de paramtres doivent dsormais tre
- faites dans le prambule en utilisant les primitives ad~hoc.
-
- \item Pour plus d'informations, consulter le manuel de pdf\TeX\ :
- \OnCD{texmf/doc/pdftex/manual}.
-
- \end{itemize}
-
-\item La primitive \cs{input} de \cmdname{tex}, \cmdname{mf} et
-\cmdname{mpost}, accepte dsormais les espaces et autres caractres
-spciaux dans les noms de fichiers condition d'utiliser des
-\textit{double quotes}, en voici deux exemples typiques :
-\begin{verbatim}
-\input "filename with spaces" % plain
-\input{"filename with spaces"} % latex
-\end{verbatim}
-Consulter le manuel \Webc{} pour plus d'informations : \OnCD{texmf/doc/web2c}.
-
-\item Les fonctionnalits de enc\TeX\ sont dsormais incluses dans \Webc{}.
-Ainsi, tous les formats \emph{construits avec l'option \optname{-enc}} y ont
-accs. enc\TeX\ permet le transcodage en entre et en sortie et
-l'utilisation transparente du codage Unicode \acro{UTF}-8. Voir
-\OnCD{texmf-dist/doc/generic/enctex/} et
-\url{http://www.olsak.net/enctex.html}.
-
-\item Un nouveau moteur combinant les fonctionnalits de \eTeX\
-et d'\OMEGA, appel Aleph, est disponible. \OnCD{texmf-dist/doc/aleph/base}
-et \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}
-fournissent une information succincte. Le format \LaTeX{} utilisant
-Aleph s'appelle \textsf{lamed}.
-
-\item La licence \acro{LPPL} de \LaTeX\ (version dcembre 2003) a chang,
-elle est dsormais compatible avec les prescriptions Debian.
-Les autres changements sont dcrits dans le fichier \filename{ltnews}, voir
-\OnCD{texmf-dist/doc/latex/base}.
-
-\item Un nouveau programme, \cmdname{dvipng}, qui convertit les fichiers
-\acro{DVI} en images \acro{PNG} a t ajout. Voir
-\OnCD{texmf/doc/man/man1/dvipng.1}.
-
-\item Nous avons d rduire le nombre de fontes incluses dans l'extension
-\pkgname{cbgreek}, ceci a t fait avec l'accord et l'aide de l'auteur
-(Claudio Beccari). Les fontes exclues (invisibles, transparentes, contours)
-sont rarement utilises et la place nous manquait. La collection complte
-des fontes \pkgname{cbgreek} est disponible sur \acro{CTAN}
-(\url{http://www.ctan.org/tex-archive/fonts/greek/cb}).
-
-\item La commande \cmdname{oxdvi} a t supprime, il suffit utiliser
-\cmdname{xdvi} la place.
-
-\item Les commandes \cmdname{initex}, \cmdname{virtex} et leurs
-homologues pour \cmdname{mf} et \cmdname{mpost} ont disparu.
-Vous pouvez les recrer si ncessaire mais elles sont avantageusement
-remplaces, depuis des annes maintenant, par l'option \optname{-ini}
-(\cmdname{tex} \optname{-ini} pour \cmdname{initex} et \cmdname{virtex}).
-
-\item Les binaires pour l'architecture \textsf{i386-openbsd} ont t
- supprims par manque de volontaires pour les compiler.
-
-Sur \textsf{sparc-solaris} (au moins) il sera probablement
-ncessaire de positionner la variable d'environnement
-\envname{LD\_LIBRARY\_PATH} pour utiliser les programmes de la famille
-\pkgname{t1utils}. Ceci vient du fait qu'ils sont compils en C++,
-et que l'emplacement des bibliothques dynamiques est variable.
-Ce n'est pas une nouveaut 2004 mais ce point n'tait pas document
-prcdemment. De mme, sur \textsf{mips-irix}, les bibliothques dynamiques
-\acro{MIPS}pro 7.4 sont ncessaires.
-
-\end{itemize}
-
-\subsubsection{2005}
-
-2005 a apport son lot habituel d'innombrables mises jour d'extensions
-et de programmes. L'infrastructure est reste relativement stable par rapport
- 2004, quelques changements invitables prs :
-
-\begin{itemize}
-
-\item Trois nouveaux scripts \cmdname{texconfig-sys}, \cmdname{updmap-sys} et
- \cmdname{fmtutil-sys} ont t introduits ; ils agissent sur la
- configuration gnrale de la machine, comme le faisaient les
- scripts \cmdname{texconfig}, \cmdname{updmap} et \cmdname{fmtutil}
- jusqu' l'an dernier. Les nouveaux scripts \cmdname{texconfig},
- \cmdname{updmap} et \cmdname{fmtutil} modifient maintenant
- la configuration \emph{personnelle} de l'utilisateur qui les lance ;
- le rsultat est plac dans le rpertoire personnel de l'utilisateur
- (sous \dirname{$HOME/.texlive2005}), voir %$
- section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig}.
-
-\item De nouvelles variables, \envname{TEXMFCONFIG} (resp.
- \envname{TEXMFSYSCONFIG}) ont t introduites ; elles dfinissent
- les rpertoires o doivent se trouver les fichiers de configuration de
- l'utilisateur (resp. de la machine), comme \filename{fmtutil.cnf} et
- \filename{updmap.cfg}. Les utilisateurs de fichiers de configuration
- locaux \filename{fmtutil.cnf} ou \filename{updmap.cfg} devront
- probablement les dplacer ; une autre possibilit est de modifier la
- dfinition des variables \envname{TEXMFCONFIG} ou
- \envname{TEXMFSYSCONFIG} dans \filename{texmf.cnf}. L'important est
- de s'assurer de la cohrence entre les dfinitions de ces variables
- dans \filename{texmf.cnf} et l'emplacement rel de ces fichiers.
- Voir section~\ref{sec:texmftrees}, \p.\pageref{sec:texmftrees} pour
- la description des diffrentes arborescences texmf utilises.
-
-\item L'an dernier nous avions rendu \og \texttt{undefined} \fg certaines
- primitives propres \cmdname{pdftex} (comme \verb|\pdfoutput|)
- dans les formats crs partir de \cmdname{pdfetex} (\cmdname{latex}
- \cmdname{amstex}, \cmdname{context} par exemple)).
- C'tait titre transitoire, aussi cette anne, ces primitives sont de
- nouveau dfinies dans tous les formats base \cmdname{pdf(e)tex},
- \emph{mme lorsqu'ils sont utiliss pour produire des fichiers
- \file{.dvi}}. Ceci implique qu'il vous faudra modifier vos
- documents qui utilisent le test \verb|\ifx\pdfoutput\undefined|
- pour dterminer si la sortie est en DVI ou en PDF. Le mieux est
- d'utiliser l'extension \pkgname{ifpdf.sty} et son test
- \verb|\ifpdf| qui fonctionne mme en plain \TeX.
-
-\item L'an dernier nous avions fait en sorte que la plupart des formats
- impriment dans les sorties \file{.log} des caractres 8-bit
- lisibles la place des notations hexadcimales \verb|^^|
- (voir section prcdente).
- Le nouveau fichier TCX \filename{empty.tcx} permet
- de revenir facilement la notation traditionnelle \verb|^^|, il suffit
- de coder :
-\begin{verbatim}
-latex --translate-file=empty.tcx fichier.tex
-\end{verbatim}
-
-\item Le nouveau programme \cmdname{dvipdfmx} est disponible pour convertir
- des fichier DVI en PDF ; ce programme remplace \cmdname{dvipdfm},
- toujours disponible mais dont l'usage est maintenant dconseill.
-
-\item Les variables \envname{HOMETEXMF} et \envname{VARTEXMF} ont t renommes
- en \envname{TEXMFHOME} et \envname{TEXMFSYSVAR} respectivement pour
- raisons de cohrence avec les autres noms de variables. Il y a aussi
- \envname{TEXMFVAR} qui dsigne maintenant un rpertoire personnel
- de l'utilisateur (cf. le premier point de la prsente liste).
-
-\end{itemize}
-
-\subsection{L'dition 2006--2007}
-\label{tlcurrent}
-
-En 2006--2007, la nouveaut majeure a t l'arrive dans \TL{} de Xe\TeX{}
-disponible sous forme de deux programmes \texttt{xetex} et \texttt{xelatex},
-voir \url{http://scripts.sil.org/xetex}.
-
-MetaPost a subi une mise jour importante et d'autres amliorations
-sont prvues, voir \url{http://tug.org/metapost/articles}. Il en va de mme
-pour pdf\TeX{}, voir \url{http://tug.org/applications/pdftex}.
-
-Le format \filename{tex.fmt} et les formats pour MetaPost and \MF\ ne
-se trouvent plus dans \dirname{texmf/web2c} mais dans des
-sous-rpertoires de \dirname{texmf/web2c} (la recherche de fichiers
-\filename{.fmt} est nanmoins faite aussi dans \dirname{texmf/web2c}).
-Ces sous-rpertoires portent le nom du moteur utilis pour construire
-le format, par exemple \filename{tex}, \filename{pdftex} ou
-\filename{xetex}. Ce changement ne devrait pas avoir d'effet visible
-pour les utilisateurs.
-
-Le programme (plain) \texttt{tex} ignore dsormais les lignes commenant
-par \texttt{\%\&} qui permettent de dterminer le format utiliser ;
-c'est un vrai \TeX{} \og la Knuth \fg !
-\LaTeX\ et tous les autres prennent toujours en compte les lignes commenant
-par \texttt{\%\&}.
-
-Les scripts d'installation peuvent maintenant tre utiliss de manire
-non interactive (voir section~\ref{sec:noninteractive-install}) en
-positionnant des variables d'environnement.
-
-Comme chaque anne des centaines d'extensions et de programmes ont t mis
-jour, voir les sites \acro{CTAN} (\url{http://www.ctan.org}).
-
-L'arborescence utilise en interne a t rorganise avec de nouveaux outils
-qui devraient fournir une meilleure base de travail pour les dveloppements
-futurs.
-
-Enfin, en mai 2006 Thomas Esser a annonc qu'il renonait poursuivre
-le dveloppement de te\TeX{} (\url{http://tug.org/tetex}). Sa dcision a
-relanc l'intrt pour \TL, en particulier chez les distributeurs de solutions
- \acro{GNU}/Linux (un nouveau schma d'installation \texttt{tetex} a t
- ajout dans le script d'installation de \TL{} pour produire une
- distribution proche de l'ancienne te\TeX). La distribution \TL{} existe
-dj sous forme de paquets Debian, esprons que les autres acteurs du monde
-Linux (RedHat, SuSe, etc.) suivront et que les utilisateurs
-se verront proposer l'avenir des distributions \TeX{} riches et plus
-faciles installer.
-
-
-
-\subsection{Versions futures}
-
-\emph{\TL{} n'est pas un produit parfait !}
-(et ne le sera jamais). Nous prvoyons de continuer produire de
-nouvelles versions, et aimerions fournir plus d'aide, de
-fonctionnalits, de programmes d'installation, et (bien sr) une
-arborescence amliore et vrifie de macros et de fontes. Ce travail
-est effectu par des volontaires dbords, dans la limite de leur temps
-libre, et beaucoup reste faire. Si vous pouvez nous aider, n'hsitez pas
- vous proposer !
-
-Corrections, suggestions et propositions d'aide doivent
-tre envoyes :\hfill\null
-\begin{quote}
-\email{tex-live@tug.org} \\
-\url{http://tug.org/texlive}
-\end{quote}
-
-\medskip
-\noindent \textsl{Bon travail avec \TeX{} !}
-
-\end{document}
-
-%%% Local Variables:
-%%% mode: latex
-%%% mode: flyspell
-%%% ispell-local-dictionary: "francais"
-%%% TeX-master: t
-%%% coding: latin-1
-%%% End:
diff --git a/Master/texmf-doc/source/texlive/texlive-fr/live4ht.cfg b/Master/texmf-doc/source/texlive/texlive-fr/live4ht.cfg
deleted file mode 100644
index 4da18b3c746..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-fr/live4ht.cfg
+++ /dev/null
@@ -1,47 +0,0 @@
-% tex4ht configuration file for the TeX Live documentation.
-% Accumulated over many years. Public domain.
-%
-% html specifies the main output format.
-% info for extra debugging info in the log files.
-
-% better approach is to have html in one piece (including footnotes).
-% charset=utf-8 fails for French, all accented letters get lost.
-\Preamble{html,info,fn-in}
-
-% add extra stylesheet
-\Configure{@HEAD}{\HCode{%
-<link rel="stylesheet" type="text/css" href="\jobname.css" />\Hnewline
-<link rel="stylesheet" type="text/css" href="tex-live.css" />\Hnewline
-}}
-
-% or LaTeX complains it is missing.
-\begin{document}
-
-\EndPreamble
-
-% simplify output for HTML. We leave TeX and LaTeX alone, since tex4ht
-% actually does the lowered E (and raised A) in CSS.
-\def\OMEGA{Omega}
-\def\LaTeXe{LaTeX2e}
-\def\eTeX{e-\TeX}
-\def\acro#1{#1}
-\def\MF{Metafont}
-\def\BibTeX{BibTeX}
-\def\warningbox{}
-\def\endwarningbox{}
-
-\newif\ifhackliterals
-\ifx\tldocenglish\undefined \else \hackliteralstrue \fi
-\ifx\tldocrussian\undefined \else \hackliteralstrue \fi
-\ifx\tldocgerman\undefined \else \hackliteralstrue \fi
-%
-\ifhackliterals
- % these definitions cause "missing } inserted" at \end{tabularx} in
- % French and Czech. don't know why.
- %
- % don't make these into links, as happens with \path. We only have a couple
- % special characters that actually occur.
- \def\dirname{\texttt\bgroup\catcode`\$=12 \catcode`\_=12 \finishliteral}
- \def\finishliteral#1{#1\egroup}
- \let\filename=\dirname
-\fi
diff --git a/Master/texmf-doc/source/texlive/texlive-fr/tex-live.css b/Master/texmf-doc/source/texlive/texlive-fr/tex-live.css
deleted file mode 100644
index 5062bc0d229..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-fr/tex-live.css
+++ /dev/null
@@ -1,44 +0,0 @@
-/* $Id$
- Simple CSS for TeX Live that adds margins and a little color.
- original by Bzyl Wlodzimierz, edited by Karl Berry, 2005.
- Public domain. */
-
-html {
- // top left bottom right
- margin: 15pt 15pt 15pt 15pt;
- background: rgb(255,255,224);
-}
-
-body {
- margin: 0 5pt 0 5pt;
- padding: 0;
- //matw: background: rgb(224,255,224);
- // (It looks better to me to have a consistent background --karl)
-// fonts in browser are low resolution;
-// therefore generated serif are poor quality,
-// so they disturb reading (that is my opinion)
- font-family: sans-serif;
- font-style: normal;
-}
-
-/* (It looks better to me to not vary colors at every level --karl) */
-
-h3.sectionHead {
- padding: 12pt 10pt 12pt 20pt;
- //matw: background: rgb(192,224,255);
- background: rgb(224,224,255);
- color: rgb(0,0,32);
-}
-
-h4.subsectionHead {
- padding: 7pt 10pt 7pt 40pt;
- background: rgb(224,224,255);
- color: rgb(0,0,32);
-}
-
-h5.subsubsectionHead {
- padding: 3pt 10pt 3pt 40pt;
- //matw: background: rgb(224,255,255);
- background: rgb(224,224,255);
- color: rgb(0,0,32);
-}
diff --git a/Master/texmf-doc/source/texlive/texlive-fr/texlive-fr.tex b/Master/texmf-doc/source/texlive/texlive-fr/texlive-fr.tex
deleted file mode 100644
index 6b74bc3bd13..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-fr/texlive-fr.tex
+++ /dev/null
@@ -1,3148 +0,0 @@
-%Format: pdf
-%
-% Change history (started May 18th 2002)
-% 2008/07/26: synced with 2008 English version, by Daniel Flipo
-% 2007/01/18: synced with 2007 English version, by Daniel Flipo
-% 2005/11/01: synced with 2005 English version, by Daniel Flipo
-% 2005/05/05: re-added section on building binaries (Daniel Flipo)
-% 2004/10/28: synced with 2004 English version, by Daniel Flipo
-% 2003/08/28: synced with 2003 English version, by Éric Picheral & Jacques André
-% 2002/05/25: proof-reading and corrections, by Daniel Flipo
-% 2002/05/18: synced with English version, by Fabrice
-%
-\documentclass{article}
-\let\tldocfrench=1 % NOT used...
-
-\usepackage[utf8]{inputenc}
-\usepackage[T1]{fontenc}
-
-\usepackage[frenchb]{babel}
-\usepackage{xspace}
-\frenchbsetup{AutoSpacePunctuation=false, og=», fg=»}
-
-\usepackage{ifpdf}
-% tex-live.sty suppose \hyper@linkurl défini...
-\ifpdf
- \def\Status{1} % (df) Pour faire charger hyperref dans tex-live.sty
-\else
- \makeatletter
- \def\hyper@linkurl#1#2{#2} % undefined if hyperref.sty not loaded
- \makeatother
-\fi
-
-\usepackage{tex-live}
-% Correctifs à tex-live.sty (df)
-\renewcommand{\samp}[1]{\og \texttt{#1}\fg{}}
-% (df) La commande \TeXLive n'est pas utilisée en v.f.
-\renewcommand{\TL}{\TeX{} Live\xspace}% Robuste (pas besoin de \protect)...
-\renewcommand{\TK}{\TeX{} Collection\xspace}% idem.
-% tex-live.sty fait précéder les no de page d'une fine... si on veut
-% une insécable normale, décommenter la ligne suivante :
-\def\p.{page~}
-% Chez Karl, la commande \url{} ne protège pas les caractères actifs (:?),
-% d'où ceci (essai provisoire... erreurs avec le car. #) :
-%\let\urlORI\url
-%\renewcommand*{\url}[1]{\foreignlanguage{english}{\urlORI{#1}}}
-%\renewcommand*{\url}[1]{{\shorthandoff{:?!;}\urlORI{#1}}}
-% La commande \path de url.sty ajoute des espaces parasites, pas \url, d'où
-\let\path\url
-% mais ceci impose de remplacer \path|...| par \path{...}, et les \$ inclus
-% par des $.
-
-\newcommand{\THANH}{Hàn Th\'{ê} Thanh}
-
-\setlength{\parindent}{0mm}
-\addtolength{\parskip}{.25\baselineskip}
-
-\begin{document}
-
-\title{{\huge Guide pratique de \TL{} \\\smallskip}
- {\LARGE\textsf{\TL{} 2008}}%
- }
-
-\author{Karl Berry \\[3mm]
- \url{http://tug.org/texlive/}\\[5mm]
- \textit{Version française}\\[3mm]
- Daniel Flipo (GUTenberg)
- }
-
-\date{Juillet 2008}
-
-\maketitle
-\thispagestyle{empty} % no need for page number
-
-\begin{multicols}{2}
-\tableofcontents
-%\listoftables
-\end{multicols}
-
-\section{Introduction}
-\label{sec:intro}
-
-\subsection{\TeX\ Live et \TeX\ Collection}
-
-Ce document décrit les principales caractéristiques de la
-distribution \TL{}, une distribution complète de \TeX{}
-pour Linux et autres Unix, \MacOSX{} et systèmes Windows.
-
-Cette distribution peut être obtenue par téléchargement ou sur le \DVD{} \TK{}
-distribué par les groupes d'utilisateurs de \TeX{} à leurs membres.
-La section \ref{sec:tl-coll-dists} décrit brièvement le contenu de ce \DVD.
-\TL{} comme \TK{} sont produits grâce au travail des groupes d'utilisateurs de
-\TeX. La description qui suit porte essentiellement sur \TL.
-
-La distribution \TL{} comprend les binaires
-pré-compilés de \TeX{}, \LaTeXe{}, \MF, \MP, \BibTeX{} et de nombreux
-autres programmes ainsi qu'une bibliothèque étendue de macros, de
-fontes et de documentations. Elle traite aussi de la composition de textes
-dans la plupart des langues utilisées dans le monde.
-
-Les composants de la distribution \TL{} sont régulièrement mis à jour
-sur le site \acro{CTAN}, \url{http://www.ctan.org}.
-
-On trouvera à la fin du document, section~\ref{sec:history}
-(page~\pageref{sec:history}), un bref historique des principales modifications
-apportées au fil du temps à la distribution \TL.
-
-% Ajout (df)
-Les utilisateurs des éditions précédentes de \TL{} sont invités
-à lire, \emph{avant toute mise à jour}, la section~\ref{tlcurrent}
-page~\pageref{tlcurrent} qui présente les principaux changements intervenus
-cette année.
-
-\subsection{Support pour différents systèmes d'exploitation}
-\label{sec:os-support}
-
-\TL{} contient les exécutables pour les principales architectures Unix, en
-particulier Linux et \MacOSX. Les sources inclus dans la distribution
-devraient permettre de compiler les exécutables nécessaires aux autres
-systèmes d'exploitation.
-
-En ce qui concerne Windows, seuls Windows 2000 et ses successeurs (XP, Vista)
-sont supportés ; les architectures antérieures (Windows 9\textit{x}, ME et NT)
-ne le sont plus. Il n'y a pas d'exécutables 64-bit mais les versions 32-bit
-devraient fonctionner aussi sur les systèmes 64-bit.
-
-Consulter la section~\ref{sec:tl-coll-dists} pour des solutions alternatives
-sous Windows et \MacOSX.
-
-\subsection{Utilisation élémentaire de \TL{}}
-\label{sec:basic}
-
-Vous pouvez installer \TL{} de deux façons différentes : soit en utilisant
-l'installeur qui télécharge toute la distribution sur Internet, soit à partir
-du \DVD{} ce qui ne nécessite pas de connexion au réseau.
-
-Vous pouvez aussi exécuter \TL{} directement depuis le
-\DVD{} (ou depuis une image iso du \DVD{} si votre système le permet) sans
-(presque) rien installer sur le disque dur.
-
-Ces trois utilisations sont décrites en détail dans les sections suivantes,
-voici quelques remarques générales pour débuter :
-
-\begin{itemize}
-
-\item Le script d'installation globale s'appelle
-\filename{install-tl}. Il fonctionne en mode graphique (mode par défaut sous
-Windows) et en mode texte (mode par défaut pour les autres systèmes).
-Ajouter l'option \code{-gui} ou \code{-no-gui} pour imposer le mode graphique
-ou le mode texte.
-
-\item Ce script installe en particulier un nouveau programme, le
-« \TL\ Manager » appelé \prog{tlmgr}. Comme l'installeur, il peut être
-utilisé en mode graphique ou en mode texte. Il permet d'ajouter ou de
-supprimer des composants et de procéder à différents réglages de
-configuration.
-
-\end{itemize}
-
-\subsection{Obtenir de l'aide}
-\label{sec:help}
-
-La communauté \TeX{} est à la fois active et conviviale ; la plupart des
-questions finissent par obtenir une réponse. Le support est
-pourtant informel, assuré par des volontaires et des lecteurs
-occasionnels, aussi est-il particulièrement important que vous fassiez
-votre propre travail de recherche avant de poser la question (si vous
-préférez un support commercial, vous pouvez renoncer à \TL{} et
-acheter un système payant ; voir une liste à
-\url{http://tug.org/interest.html#vendors}).
-
-Voici une liste de ressources, classées selon l'ordre dans lequel nous
-recommandons de les utiliser :
-
-\begin{description}
-\item [Getting Started] -- pour ceux qui débutent en \TeX, la page web
-\url{http://tug.org/begin.html} contient une courte description
-du système.
-
-\item [\acro{FAQ} \TeX{}] -- la \acro{FAQ} \TeX{} est un vaste recueil
- de réponses à toutes sortes de questions, de la plus élémentaire à la
- plus complexe. Elle est enregistrée sur le \DVD{} dans
- \OnCD{texmf-doc/doc/english/FAQ-en/html/index.html}
- et elle est disponible sur Internet à
- l'adresse \url{http://www.tex.ac.uk/faq}.
- Merci de consulter cette FAQ avant toute question.
-
-\item [Catalogue \TeX{}] -- si vous recherchez une extension, une fonte,
- un programme, etc., le mieux est de consulter le catalogue
- \TeX{} ici : \url{http://www.ctan.org/help/Catalogue/}.
-
-\item [Ressources \TeX{} sur le Web] -- la page web
- \url{http://tug.org/interest.html} propose
- beaucoup de liens relatifs à \TeX{}, en particulier concernant des
- livres, manuels et articles portant sur tous les aspects du système.
-
-\item [Archives des forums d'aide] -- les principaux forums dédiés
- au support de \TeX{} sont les groupes de news Usenet
- \url{news:comp.text.tex} (en anglais) et \url{news:fr.comp.text.tex}
- (en français) ainsi que les listes de diffusion
- \email{texhax@tug.org} (en anglais) et \email{gut@ens.fr} (en français).
- Les archives correspondantes contiennent des
- milliers de questions et réponses déjà traitées et permettent
- une recherche fructueuse. Voir
- \url{http://groups.google.com/groups?group=fr.comp.text.tex}
- et \url{http://tug.org/mail-archives/texhax}, respectivement. Une
- question posée sur un moteur de recherche, tel que
- \url{http://google.com}, peut aussi fournir des réponses pertinentes.
-
-\item [Poster une question] -- si vous ne trouvez pas de réponse, vous
- pouvez poster la question à \dirname{fr.comp.text.tex} via Google ou
- votre lecteur de news, ou encore par messagerie à
- \email{texhax@tug.org}. Mais avant de le faire, merci de lire
- l'introduction de la \acro{FAQ} donnant les conseils sur la façon de
- rédiger la question pour avoir des chances d'obtenir une réponse pertinente :
- \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}.
-
-\item [Support de \TL{}] -- si vous voulez faire un rapport
- d'anomalie, émettre des suggestions ou des commentaires sur la
- distribution \TL{}, son installation ou sa documentation, utilisez
- la liste de diffusion \email{tex-live@tug.org}. Mais attention, si
- la question concerne l'utilisation d'un programme particulier inclus
- dans \TL{}, il vaut mieux que vous vous adressiez directement à la
- personne ou à la liste de diffusion qui maintient le programme. Il suffit
- souvent d'ajouter l'option \code{-{}-help} lors de l'exécution du programme
- pour trouver à qui adresser le rapport.
-
-\end{description}
-
-L'autre aspect du sujet concerne l'aide à apporter aux personnes
-soumettant des questions. Les forums \dirname{comp.text.tex},
-\dirname{fr.comp.text.tex} ainsi que les listes de diffusion \code{texhax}
-et \code{gut}
-sont ouverts à tous, aussi n'hésitez pas à vous y joindre, à commencer
-la lecture et à fournir de l'aide là où cela vous est possible.
-
-% No \protect needed as \TL is defined in French with \newcommand (robust).
-\section{Structure de \TK}
-\label{sec:overview-tl}
-
-Nous décrivons ici le contenu de \TK{} qui est un sur-ensemble de \TL.
-
-\subsection {\TK{} : \TL, pro\TeX{}t, Mac\TeX}
-\label{sec:tl-coll-dists}
-
-Le \DVD{} \TK{} contient les éléments suivants :
-
-\begin{description}
-
-\item [\TL{}] -- un système \TeX{} complet (\TL) qui peut au choix, être lancé à
- partir du \DVD{} (sans installation) ou être installé sur le disque dur.
-
-\item [CTAN] -- une image du site d'archives \CTAN.
-
-\item [pro\TeX{}t] -- une extension du système \MIKTEX\ pour Windows qui en
- facilite l'installation. Cette distribution est totalement indépendante de
- \TL{}, elle nécessite un mode d'installation spécifique. Le site de
- \ProTeXt\ se trouve ici : \url{http://tug.org/protext}.
-
-\item [Mac\TeX] -- un programme d'installation spécifique de \TL{} pour
- \MacOSX{} et quelques applications propres au système Mac.
- Le site de Mac\TeX{} se trouve ici : \url{http://www.tug.org/mactex/}.
-
-\item [\texttt{texmf-extra}] -- un répertoire contenant quelques extensions
- supplémentaires.
-
-\end{description}
-
-Les droits d'utilisation des fichiers présents dans \CTAN, \ProTeXt{}
-et \texttt{texmf-extra} diffèrent de ceux de \TL{}, pensez à lire
-les licences si vous envisagez de modifier ou de redistribuer certains de
-ces fichiers.
-
-\subsection{Répertoires situés à la racine de \TL{}}
-\label{sec:tld}
-
-La distribution \TL{} est dans le sous-répertoire \dirname{texlive}
-du \DVD{} \TK{}. Les répertoires les plus importants
-situés à la racine de la distribution \TL{} sont énumérés ci-dessous :
-
-\begin{ttdescription}
-\item[bin] -- programmes de la famille \TeX{}, rangés dans des
- sous-répertoires selon les plates-formes.
-%
-\item[readme.html] -- une brève introduction et quelques liens utiles sous forme
- de pages \textsc{html} dans différentes langues.
-%
-\item[source] -- le code source de tous les programmes, incluant la
- distribution \Webc{} de \TeX{} et \MF{}.
-%
-\item[support] -- ensemble d'extensions et programmes auxiliaires (en
- particulier des éditeurs et des \textit{shells} dédiés à \TeX) ; ils ne sont
- \emph{pas} installés par défaut.
-%
-\item[texmf] -- répertoire contenant les programmes et leur documentation ; ne
- contient ni les formats ni les extensions (la variable \envname{TEXMFMAIN}
- de la section suivante pointe sur ce répertoire).
-%
-\item[texmf-dist] -- répertoire principal où se trouvent les extensions,
- les fontes, etc., avec leur documentation (la variable \envname{TEXMFDIST}
- de la section suivante pointe sur ce répertoire).
-%
-\item[texmf-doc] -- répertoire contenant le reste de la documentation, le
- sous-répertoire doc est organisé par langue.
-%
-\item[tlpkg] -- scripts et programmes d'installation ; des versions de
- Perl et de Ghostscript (inaccessibles en dehors de \TL) ainsi qu'un
- nouveau visualiseur de fichiers PostScript ont été ajoutés pour
- Windows.
-\end{ttdescription}
-
-On trouve également, au même niveau que les répertoires mentionnés ci-dessus,
-les scripts d'installation et les fichiers \filename{README} (disponibles dans
-différentes langues).
-
-Le répertoire \dirname{texmf-doc} ne contient que de la documentation
-mais pas toute la documentation. Celle concernant les programmes (manuels,
-pages \textit{man} et fichiers de type \textit{info} est dans
-\dirname{texmf/doc} car les programmes correspondants sont dans
-\dirname{texmf}. De même, la documentation des extensions et formats
-est dans \dirname{texmf-dist/doc}. Les commandes \cmdname{texdoc} ou
-\cmdname{texdoctk} trouveront pour vous les documentations où qu'elles soient
-sur le disque.
-Le fichier \OnCD{doc.html} du \DVD{} contient une liste de liens bien
-utiles pour localiser les fichiers de documentation.
-
-La documentation de \TL\ proprement dite est disponible dans le répertoire
-\dirname{texmf-doc} en plusieurs langues,
-
-\begin{itemize}
-\item{anglais :} \OnCD{texmf-doc/doc/english/texlive-en},
-\item{allemand :} \OnCD{texmf-doc/doc/german/texlive-de},
-\item{chinois (simplifié) :} \OnCD{texmf-doc/doc/chinese/texlive-zh-cn},
-\item{français :} \OnCD{texmf-doc/doc/french/texlive-fr},
-\item{polonais :} \OnCD{texmf-doc/doc/polish/texlive-pl},
-\item{russe :} \OnCD{texmf-doc/doc/russian/texlive-ru},
-\item{tchèque \& slovaque :} \OnCD{texmf-doc/doc/czechslovak/texlive-cz}.
-\end{itemize}
-
-\subsection{Description des arborescences « texmf » de \TL}
-\label{sec:texmftrees}
-
-Nous donnons ici la liste complète des variables prédéfinies qui contiennent
-les noms des différentes arborescences de type « texmf » et l'usage qui
-en est fait. La commande \cmdname{texconfig conf} retourne les valeurs de ces
-variables, ce qui permet de savoir où se trouvent ces différentes
-arborescences dans une installation donnée.
-
-\begin{ttdescription}
-\item [TEXMFMAIN] -- contient les éléments essentiels du système, comme les
- scripts (\cmdname{web2c/mktexdir}, etc.), leur documentation mais pas les
- formats ni les fichiers de macros.--
-\item [TEXMFDIST] -- contient les fichiers de macros (Plain, \LaTeX, \ConTeXt,
- etc.,), les fontes, etc., de la distribution \TL{} ; rien ne devrait être
- ni ajouté ni supprimé dans cette arborescence.
-\item [TEXMFLOCAL] -- c'est là que l'administrateur de la machine doit
- placer les classes et extensions locales, les fontes non disponibles
- dans \TL, etc.
-\item [TEXMFHOME] -- contient les fichiers personnels (extensions, classes,
- fontes) de l'utilisateur ; ce répertoire est installé automatiquement dans
- le répertoire personnel de l'utilisateur.
-\item [TEXMFCONFIG] -- c'est là que les scripts \cmdname{updmap} et
- \cmdname{fmtutil} recherchent leurs fichiers de configuration en priorité.
- \cmdname{texconfig} y place les versions modifiées des fichiers de
- configuration. Sous \envname{TEXMFHOME} par défaut.
-\item [TEXMFSYSCONFIG] -- c'est là que les scripts \cmdname{updmap-sys} et
- \cmdname{fmtutil-sys} recherchent leurs fichiers de configuration en
- priorité. \cmdname{texconfig-sys} y place les versions modifiées des
- fichiers de configuration.
-\item [TEXMFVAR] -- c'est là que les scripts \cmdname{texconfig},
- \cmdname{updmap} et \cmdname{fmtutil} rangent les formats et les fichiers
- \file{.map} qu'ils produisent. Sous \verb+$HOME+ par défaut. %$
-\item [TEXMFSYSVAR] -- c'est là que les scripts \cmdname{texconfig-sys},
- \cmdname{updmap-sys} et \cmdname{fmtutil-sys} rangent les formats et les
- fichiers \file{.map} qu'ils produisent.
-\end{ttdescription}
-
-La structure de l'arborescence \TL{} est par défaut la suivante :
-\begin{description}
-\item[racine multi-utilisateurs] (par exemple \verb|/usr/local/texlive|,
- \verb|D:\texlive|,\dots) qui contient éventuellement plusieurs
- distributions :
- \begin{ttdescription}
- \item[2007] -- la distribution précédente,
- \begin{ttdescription}
- \item [...]
- \end{ttdescription}
- \item[2008] -- la distribution actuelle,
- \begin{ttdescription}
- \item [bin] ~
- \begin{ttdescription}
- \item [i386-linux] -- exécutables Linux,
- \item [...]
- \item [universal-darwin] -- exécutables \MacOSX,
- \item [win32] -- exécutables Windows,
- \end{ttdescription}
- \item [texmf] -- correspond à \envname{TEXMFMAIN},
- \item [texmf-dist] -- correspond à \envname{TEXMFDIST},
- \item [texmf-doc] -- correspond à \envname{TEXMFDOC},
- \item [texmf-var] -- correspond à \envname{TEXMFSYSVAR},
- \item [texmf-config] -- correspond à \envname{TEXMFSYSCONFIG},
- \end{ttdescription}
- \item [texmf-local] -- correspond à \envname{TEXMFLOCAL}, normalement
- commun à plusieurs distributions \TL{} (2007, 2008, etc.),
- \end{ttdescription}
- \item[répertoire personnel de l'utilisateur] \texttt{\$HOME} ou
- \texttt{\%USERPROFILE\%} :
- \begin{ttdescription}
- \item[.texlive2007] -- fichiers générés automatiquement par la
- distribution \TL{} précédente,
- \item[.texlive2008] -- fichiers générés automatiquement par la
- distribution \TL{} actuelle,
- \begin{ttdescription}
- \item [texmf-var] -- correspond à \envname{TEXMFVAR},
- \item [texmf-config] -- correspond à \envname{TEXMFCONFIG},
- \end{ttdescription}
- \item[texmf] -- correspond à \envname{TEXMFHOME}, répertoire regroupant
- tous les répertoires de macros personnelles : \dirname{texmf/tex/latex}
- par exemple pour les fichiers de macros LaTeX, etc.
- \end{ttdescription}
-\end{description}
-
-\subsection{Les extensions de \TeX}
-\label{sec:tex-extensions}
-
-\TL{} contient, à part \TeX{} lui-même (le programme \prog{tex}) qui est figé
-sauf rares corrections de bogues, plusieurs extensions de \TeX{}.
-
-\begin{description}
-
-\item [\eTeX{}] \label{text:etex} ajoute un jeu de nouvelles
- primitives et les extensions \TeXXeT{} pour l'écriture de droite
- à gauche ; \eTeX{} est, en mode normal, 100\% compatible avec
- \TeX{} standard. Pour plus de détails consulter le
- fichier \OnCD{texmf-dist/doc/etex/base/etex_man.pdf} du \DVD{}.
-
-\item [pdf\TeX{}] inclut les extensions \eTeX{} et produit, au choix,
- des fichiers au format Acrobat \acro{PDF} ou au format \dvi{}.
- C'est le moteur de base sur lequel sont construits tous les formats autres
- que plain\TeX{} (voir \url{http://www.pdftex.org/}).
- Le manuel d'utilisation se trouve sur le \DVD{}
- dans \OnCD{texmf/doc/pdftex/manual/}. Le fichier
- \OnCD{texmf/doc/pdftex/pdftex/manual/samplepdf/samplepdf.tex}
- donne des exemples d'utilisation.
-
-\item [Lua\TeX] est le successeur de pdf\TeX{}
- avec lequel il reste compatible. Il devrait également remplacer Aleph, voir
- ci-dessous. Lua\TeX{} fait appel à l'interpréteur de commande Lua (voir
- \url{http://www.lua.org/}) qui apporte des solutions élégantes
- à beaucoup de problèmes épineux en \TeX{} pur.
- La commande \filename{texlua}, qui fonctionne comme un interpréteur Lua
- indépendant, est déjà utilisée en tant que telle dans \TL.
- Voir \url{http://www.luatex.org/} et
- \OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}.
-
-\item [Xe\TeX] ajoute la possibilité d'utiliser en entrée le codage Unicode
- et en sortie les fontes OpenType et les fontes système de la machine, ceci
- grâce à des bibliothèques externes : voir \url{http://scripts.sil.org/xetex}.
-
-\item [\OMEGA{} (Omega)] fonctionne en utilisant Unicode et des
- caractères 16 bits, ce qui lui permet de travailler directement et
- simultanément avec presque toutes les écritures du monde.
- L'extension supporte aussi le chargement dynamique d'\acro{OTP}
- (\OMEGA{} \emph{Translation Processes}) qui permet à l'utilisateur
- d'appliquer sur des flux d'entrée quelconques des transformations
- complexes qu'il aura lui-même définies. Voir la documentation
- (pas vraiment à jour) dans \OnCD{texmf-dist/doc/omega/base/doc-1.8.tex}.
-
-\item [Aleph] combine les fonctionnalités de \OMEGA\ et de \eTeX.
- \OnCD{texmf-dist/doc/aleph/base} contient une documentation de base.
-
-\end{description}
-
-% Fin MAJ 15/07/2008
-\subsection{Quelques autres programmes intéressants
- dans \TL}
-
-Voici quelques autres programmes couramment utilisés et présents dans
-\TL{} :
-
-\begin{cmddescription}
-
-\item [bibtex] -- traitement de la bibliographie.
-
-\item [makeindex] -- traitement des index.
-
-\item [dvips] -- conversion \dvi{} vers \PS{}.
-
-\item [xdvi] -- visualisation \dvi{} pour le système X Window.
-
-\item [dvilj] -- pilote \dvi{} pour les imprimantes HP LaserJet.
-
-\item [dv2dt, dt2dv] -- conversion \dvi{} vers ou depuis du texte simple.
-
-\item [dviconcat, dviselect] -- couper/Coller de pages à partir de fichiers
- \dvi{}.
-
-\item [dvipdfmx] -- conversion \dvi{} vers \acro{PDF}, une autre façon de
- produire des fichiers \acro{PDF}, concurrente de pdf\TeX\ mentionné
- ci-dessus ; voir aussi les extensions \pkgname{ps4pdf} et
- \pkgname{pdftricks} pour d'autres alternatives.
-
-\item [psselect, psnup, \ldots] -- utilitaires \PS{}.
-
-\item [lacheck] -- vérification de syntaxe \LaTeX{}.
-
-\item [texexec, texmfstart] -- processeurs Con\TeX{}t et \acro{PDF}.
-
-\item [tex4ht] -- conversion \TeX{} vers \acro{HTML} et \acro{XML}.
-
-\end{cmddescription}
-
-\subsection{Fontes incluses dans \TL}
-\label{sec:tl-fonts}
-
-La distribution \TL{} contient un grand nombre de fontes vectorielles de haute
-qualité : voir \url{http://tug.org/fonts} et
-\OnCD{texmf-doc/english/free-math-fonts-survey}.
-
-
-\section{Installation}
-\label{sec:install}
-
-\subsection{Démarrage de l'installation}
-\label{sec:inst_start}
-
-La première chose à faire est de récupérer le \DVD{} \TK ou de
-télécharger le programme d'installation par le réseau.
-Le programme d'installation s'appelle \filename{install-tl} pour Unix
-et \filename{install-tl.bat} pour Windows.
-
-\begin{description}
-\item [Installeur réseau] -- à télécharger sur CTAN dans
- \dirname{systems/texlive/tlnet}; l'url
- \url{http://mirror.ctan.org/systems/texlive/tlnet} vous redirigera
- automatiquement vers le serveur d'archive le plus proche de chez vous.
- Deux versions sont disponibles, \filename{install-tl.zip} utilisable sous
- Unix et sous Windows et \filename{install-unx.tar.gz} pour Unix seulement
- (y compris \MacOSX). Après décompression de l'un de ces deux fichiers, les
- scripts \filename{install-tl} et \filename{install-tl.bat} se trouveront
- dans le sous-répertoire \dirname{install-tl}.
-
-\item [\DVD \TK{}] -- aller dans le répertoire \dirname{texlive}.
- Sous Windows, l'installation démarrera probablement
- automatiquement quand vous insérerez le \DVD, sinon, il faudra lancer le
- script d'installation \filename{install-tl} ou \filename{install-tl.bat}.
- Le \DVD \TK{} est distribué gratuitement aux membres des groupes
- d'utilisateurs de \TeX{} (Gutenberg par exemple en France, voir la liste
- des groupes sur \url{http://tug.org/usergroups.html}). Il est également
- possible de l'acheter séparément (\url{http://tug.org/store}) ou de graver
- l'image \ISO{} (\url{http://tug.org/texlive/acquire.html}).
-\end{description}
-Les sections suivantes détaillent le processus d'installation.
-
-
-\begin{figure}[tb]
-\centering
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
-
- Detected platform: Intel x86 with GNU/Linux
-
- <B> binary systems: 1 out of 16
-
- <S> Installation scheme (scheme-full)
-
- Customizing installation scheme:
- <C> standard collections
- <L> language collections
- 83 collections out of 84, disk space required: 1666 MB
-
- <D> directories:
- TEXDIR (the main TeX directory):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
- [X] install macro/font doc tree
- [X] install macro/font source tree
- [ ] create symlinks in standard directories
-
- <V> Install for running from DVD
-
-Other actions:
- <I> start installation to HD
- <H> help
- <Q> quit
-
-Enter command:
-\end{boxedverbatim}
-\caption{Écran principal de configuration (\GNU/Linux)}\label{fig:text-main}
-\end{figure}
-
-\begin{figure}[tb]
-\centering
-\tlpng{install-w32-main}{\linewidth}
-\caption{Écran principal de configuration (Windows)}\label{fig:gui-main}
-\end{figure}
-
-\subsubsection{Installation sous Unix}
-
-Dans ce qui suit l'invite du \textit{shell} est notée \texttt{>} ; les
-commandes de l'utilisateur sont en \Ucom{\texttt{gras}}.\linebreak
-Commandes à lancer dans un terminal sur tout système Unix pour travailler en
-mode texte :
-\begin{alltt}
-> \Ucom{cd /chemin/de/installeur}
-> \Ucom{perl install-tl}
-\end{alltt}
-
-Pour travailler en mode graphique :
-\begin{alltt}
-> \Ucom{cd /chemin/de/installeur}
-> \Ucom{./install-tl -gui}
-\end{alltt}
-
-La liste complète des options est donnée par
-\begin{alltt}
-> \Ucom{perl install-tl -help}
-\end{alltt}
-
-\textbf{Attention} : le matériel installé doit normalement être accessible à
-tous les utilisateurs de la machine ; si celui qui installe n'est pas
-\textit{root}, il devra s'assurer que son \code{umask} est adapté, par
-exemple \code{umask 022} ou \code{umask 002}.
-Consulter la documentation système pour plus de précisions.
-
-\subsubsection{Installation sous Mac\,OS\,X}
-
-Une distribution spécifique, Mac\TeX\ (\url{http://tug.org/mactex}), a été
-mise au point pour \MacOSX. Nous recommandons de l'utiliser plutôt que
-d'installer la distribution \TL{} en suivant la procédure indiquée pour Unix.
-
-En effet, Mac\TeX{} permet des ajustements spécifiques pour le système
-\MacOSX{} et facilite la cohabitation entre plusieurs distributions \TeX{}
-(Mac\TeX, gw\TeX, Fink, MacPorts, \ldots).
-
-Mac\TeX\ est très proche de \TL, les arborescences principales sont en tous
-points identiques, quelques répertoires contenant de la documentation et des
-applications spécifiques au Mac sont ajoutés.
-
-\subsubsection{Installation sous Windows}
-
-Si vous utilisez l'installeur réseau ou si l'insertion du \DVD{} ne lance pas
-l'installation automatiquement, double-cliquez sur \filename{install-tl.bat}.
-
-Il est également possible de travailler en ligne de commande ;
-dans ce qui suit l'invite du \textit{shell} est notée \texttt{>}, les
-commandes de l'utilisateur sont notées \Ucom{\texttt{en gras}}. Voici les
-commandes à lancer :
-\begin{alltt}
-> \Ucom{install-tl}
-\end{alltt}
-à condition d'être dans répertoire du script d'installation, sinon
-\begin{alltt}
-> \Ucom{D:\bs{}texlive\bs{}install-tl}
-\end{alltt}
-où \texttt{D:} désigne le lecteur de \DVD.
-
-Pour travailler en mode texte :
-\begin{alltt}
-> \Ucom{install-tl -no-gui}
-\end{alltt}
-La liste complète des options est donnée par
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-
-\subsubsection{Installation en mode texte}
-
-La figure~\ref{fig:text-main} page~\pageref{fig:text-main} présente l'écran
-principal de configuration en mode texte sous Unix/Linux.
-
-Taper une des lettres proposées (en respectant la casse) suivie de
-« Entrée » (retour-chariot), l'écran se mettra automatiquement à jour.
-
-L'interface est volontairement rudimentaire afin de permettre son utilisation
-sur le plus grand nombre possible de systèmes même avec des versions très
-dépouillées de Perl (un sous-ensemble de commande Perl est fourni pour Windows).
-
-\subsubsection{Installation en mode graphique}
-
-La figure~\ref{fig:gui-main} page~\pageref{fig:gui-main} présente l'écran
-principal de configuration en mode graphique sous Windows. Les différences
-entre les options disponibles en mode texte et en mode graphique s'expliquent
-par le changement de système (\GNU/Linux pour le premier, Windows pour le
-second).
-
-\subsection{Choix des options d'installation}
-\label{sec:runinstall}
-
-Les options proposées sont censées être assez explicites, voici cependant
-quelques précisions.
-
-\subsubsection{Choix des binaires (Unix seulement)}
-\label{sec:binary}
-
-\begin{figure}[tbh]
-\centering
-\begin{boxedverbatim}
-Available sets of binaries:
-===============================================================================
-
- a [ ] alpha-linux DEC Alpha with GNU/Linux
- b [ ] amd64-freebsd x86_64 with FreeBSD
- c [ ] hppa-hpux HP-UX
- d [ ] i386-freebsd Intel x86 with FreeBSD
- e [X] i386-linux Intel x86 with GNU/Linux
- f [ ] i386-openbsd Intel x86 with OpenBSD
- g [ ] i386-solaris Intel x86 with Sun Solaris
- h [ ] mips-irix SGI IRIX
- i [ ] powerpc-aix PowerPC with AIX
- j [ ] powerpc-linux PowerPC with GNU/Linux
- k [ ] sparc-linux Sparc with GNU/Linux
- l [ ] sparc-solaris Sparc with Solaris
- m [ ] universal-darwin universal binaries for MacOSX/Darwin
- o [ ] win32 Windows
- p [ ] x86_64-linux x86_64 with GNU/Linux
-\end{boxedverbatim}
-\caption{Menu pour le choix des binaires}\label{fig:bin-text}
-\end{figure}
-
-La figure~\ref{fig:bin-text} présente les choix de binaires possibles en mode
-texte. Seuls les binaires correspondant à l'architecture détectée seront
-installés par défaut. Rien n'empêche d'en sélectionner d'autres si nécessaire,
-ce qui peut être intéressant dans le cas de serveurs en réseau ou sur des
-machines en « double boot ».
-
-\subsubsection{Choix des composants de l'installation}
-\label{sec:components}
-
-\begin{figure}[tbh]
-\centering
-\begin{boxedverbatim}
-Select a scheme:
-===============================================================================
-
- a [ ] TeX Live basic scheme
- b [ ] TeX Live scheme for ConTeXt
- c [X] TeX Live full scheme
- d [ ] GUST TeX Live scheme
- e [ ] GUTenberg TeX Live scheme
- f [ ] TeX Live medium scheme
- g [ ] TeX Live minimal scheme
- h [ ] TeX Live for Omega users
- i [ ] teTeX scheme
- j [ ] XML typesetting scheme
-\end{boxedverbatim}
-\caption{Menu « Scheme »}\label{fig:scheme-text}
-\end{figure}
-
-Dans le menu « Scheme » (voir figure~\ref{fig:scheme-text}) on choisit
-un schéma général de configuration qui détermine un ensemble de collections à
-installer. Par défaut, on procède à l'installation de tout ce qui est
-disponible (option \optname{scheme-full}). Des installations plus ou moins
-complètes sont proposées : \optname{minimal} pour effectuer des tests
-uniquement, \optname{basic} pour un système de base, \optname{medium} ou
-\optname{teTeX} pour des systèmes intermédiaires.
-Pour les francophones, l'option \optname{GUTenberg} est une bonne base de
-départ. Le choix pourra être affiné à l'étape suivante.
-
-\begin{figure}[tbh]
-\centering
-\tlpng{stdcoll}{.7\linewidth}
-\caption{Menu « Collections » (Linux)}\label{fig:collections-gui}
-\end{figure}
-
-Une fois choisi le schéma général, il est possible de d'ajouter ou de
-supprimer des composants, appelés
-ici collections. Il y a deux types de collections : les
-« Standard Collections » qui concernent les fontes, les extensions, les
-formats, etc. (voir figure~\ref{fig:collections-gui}) et les
-« Language Collections » qui permettent de préciser la liste des langues
-qui seront utilisables sur le système (indispensable !). Attention, si vous
-travaillez en mode texte, dans ces menus la casse des lettres est importante.
-En mode graphique, il suffit de cocher ou de décocher les cases en cliquant.
-
-Il est possible de raffiner encore les choix mais il faudra alors utiliser
-le programme \prog{tlmgr} ultérieurement, voir la section~\ref{sec:tlmgr}.
-
-\subsubsection{Répertoires d'installation}
-\label{sec:directories}
-
-La racine de l'installation principale est donnée par \dirname{TEXDIR} qui
-vaut par défaut \dirname{/usr/local/texlive/2008} sous Unix et
-|%PROGRAMFILES%\texlive\2008| sous Windows.
-La liste des sous-répertoires de \dirname{TEXDIR} choisis par défaut est
-donnée à la section~\ref{sec:texmftrees}, page~\pageref{sec:texmftrees}.
-
-Il peut être nécessaire de changer la valeur de \dirname{TEXDIR}
-lorsque celui qui procède à l'installation n'a pas les droits d'écriture
-sur le répertoire \dirname{TEXDIR} (l'installation n'est pas réservée au
-super-utilisateur « root » ou « Administrateur »).
-Il est possible d'installer \TL{} dans le répertoire personnel d'un
-utilisateur, dans ce cas on peut choisir par exemple |~/texlive/2008|.
-
-Dans tous les cas, il est recommandé d'inclure l'année dans le chemin afin de
-pouvoir conserver plusieurs versions de \TL{} en parallèle.
-Rien n'empêche d'ajouter un lien symbolique (par exemple
-\dirname{/usr/local/texlive-current}) qui pointe sur la version actuellement
-utilisée. Ceci facilite les basculements d'une version à une autre.
-
-Le répertoire \envname{TEXMFHOME} (|~/texmf| par défaut) est destiné à
-regrouper les répertoires de macros personnelles. Le caractère |~| désignant
-le répertoire personnel est traité différemment, selon qu'il est utilisé dans
-\dirname{TEXDIR} --~il s'agit alors du répertoire de \emph{l'installateur}~--
-ou dans \envname{TEXMFHOME}, là |~| est traité dynamiquement utilisateur par
-utilisateur est vaut \envname{\$HOME} %$
-sous Unix et |%USERPROFILE%| sous Windows.
-
-\subsubsection{Options}
-\label{sec:options}
-
-\begin{figure}[tbh]
-\centering
-\begin{boxedverbatim}
-<P> use letter size instead of A4 by default: [ ]
-<F> create all format files: [X]
-<D> install font/macro doc tree: [X]
-<S> install font/macro source tree: [X]
-<L> create symlinks in standard directories: [ ]
- binaries to:
- manpages to:
- info to:
-\end{boxedverbatim}
-\caption{menu « Options » (Unix)}\label{fig:options-text}
-\end{figure}
-
-La figure~\ref{fig:options-text} présente le menu « Options » en mode
-texte. Normalement il n'y a pas lieu de modifier les choix par défaut.
-Voici quelques précisions cependant.
-
-\begin{description}
-\item[use letter size instead of A4 by default] -- la taille du papier pour
- l'impression est A4, il est possible de la changer ici, en \textit{letter}
- par exemple.
-
-\item[create all format files] -- création de tous les formats à l'installation.
- Bien que cette opération prenne un peu de temps, il est conseillé de ne pas
- la supprimer, sinon les formats seront créés au coup par coup dans les
- répertoires personnels des utilisateurs (sous \envname{TEXMFVAR}). Les
- formats personnels ainsi créés ne bénéficieront pas des mises à jour
- éventuelles effectuées ultérieurement sur l'installation \TL{}, ce qui
- peut engendrer des incompatibilités.
-
-\item[create symlinks in standard directories] (Unix seulement) --
- cette option permet d'éviter de modifier les variables d'environnement
- \envname{PATH}, \envname{MANPATH} et \envname{INFOPATH}. En revanche,
- elle peut perturber une installation \TeX{} incluse dans votre distribution
- (Debian, RedHat, etc.). La modification des trois variables d'environnement
- ci-dessus est préférable.
-\end{description}
-
-Lorsque vous êtes satisfait des réglages faits, il vous reste à taper
-\code{I} pour lancer le processus d'installation. Lorsque celui-ci sera
-terminé, sautez à la section~\ref{sec:postinstall} pour voir s'il y a
-d'autres choses à faire.
-
-\subsubsection{Utilisation de \TL{} à partir du DVD{} (mode texte uniquement)}
-\label{sec:fromdvd}
-
-Taper `|V|' pour choisir ce mode de fonctionnement, le menu qui s'affiche
-alors est présenté figure~\ref{fig:main-fromdvd}.
-\begin{figure}[tbh]
-\centering
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
- <D> directories:
- TEXDIRW (Writable root):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
-
- <V> set up for installing to hard disk
-
-Other actions:
- <I> start installation for running from DVD
- <H> help
- <Q> quit
-\end{boxedverbatim}
-\caption{Menu principal après choix de l'option « \optname{running from DVD} »}%
-\label{fig:main-fromdvd}
-\end{figure}
-Noter les changements : toutes les options concernant le choix du matériel à
-installer, les liens symboliques, ont disparu. Le menu « Directories »
-parle maintenant de \dirname{TEXDIRW} (racine accessible en écriture).
-
-L'exécution de \TL{} à partir du \DVD{} nécessite la création de quelques
-répertoires mais un minimum de fichiers sont installés sur le disque dur.
-
-La configuration après installation pour Unix est un peu plus complexe, voir
-section~\ref{sec:postinstall}.
-
-Faute de temps, cette option n'a pu être intégrée à l'interface graphique.
-Elle reste utilisable en mode texte y compris sous Windows, voir
-section~\ref{sec:cmdline}.
-
-La section \ref{sec:portable-unix} décrit une autre façon d'utiliser \TL{} à
-partir du \DVD{}. Elle ne nécessite aucune modification du système mais ne
-permet aucune personnalisation.
-
-\subsection{Options en ligne de commande}
-\label{sec:cmdline}
-
-Taper
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-pour obtenir la liste de toutes les options disponibles.
-Voici les principales :
-
-\begin{ttdescription}
-\item[-gui] -- exécution en mode graphique (si possible). Ceci nécessite le
- module Perl/Tk (\url{http://tug.org/texlive/distro.html#perltk}) ; si
- Perl/Tk n'est pas disponible, l'installation se poursuit en mode texte.
-\item[-no-gui] -- exécution en mode texte, même sous Windows ;
- ceci est utile pour exécuter \TL{} à partir du \DVD{} (option non disponible
- en mode graphique).
-\item[-lang {\sl LL}] -- impose la langue utilisée dans les menus lors de
- l'installation. Le code de langue comporte deux lettres. Sont actuellement
- disponibles les langues suivantes : : anglais (\texttt{en}, langue par
- défaut), allemand (\texttt{de}), français (\texttt{fr}), néerlandais
- (\texttt{nl}), polonais (\texttt{pl}), Slovène (\texttt{sl}) et vietnamien
- (\texttt{vi}). Le programme s'efforce de déterminer automatiquement
- la langue à utiliser et se rabat sur l'anglais en cas d'échec.
-\item[-profile {\sl profile}] -- à chaque exécution, le script d'installation
- écrit un compte-rendu dans le fichier
- \filename{texlive.profile} du répertoire \dirname{2008/tlpkg} ou
- \dirname{tlpkg}. L'option \texttt{-profile} demande au script de réutiliser
- le fichier \filename{texlive.profile}. En voici un extrait :
- \begin{fverbatim}
-# texlive.profile written on Wed Jul 9 16:13:44 2008 UTC
-# It will NOT be updated and reflects only the
-# installation profile at installation time.
-selected_scheme scheme-basic
-TEXDIR /usr/local/texlive/2008
-TEXDIRW /usr/local/texlive/2008
-...
-TEXMFSYSVAR /usr/local/texlive/2008/texmf-var
-collection-basic 1
-...
-option_symlinks 0
- \end{fverbatim}
- Il est ainsi facile de reproduire un même scéma d'installation sur plusieurs
- machines.
-\item [-location {\slshape url/path}] -- choix d'une source où récupérer le
- matériel à installer. \label{item:location}
-
-L'argument de l'option \texttt{{\slshape url/path}} peut être une url
-commençant par \texttt{ftp:}, \texttt{http:}, ou \texttt{file:/} ou bien un
-chemin local.
-
-Si l'argument correspond à un chemin local (ou une url de type
-\texttt{file:/}), le script recherche un sous-répertoire
-\dirname{archive} contenant des fichiers compressés \filename{.tar.lzma},
-ceux-ci seront utilisés en priorité.
-
-Si l'argument est une url distante (\texttt{http:} ou \texttt{ftp:})
-le `\texttt{/}' final ainsi que la chaîne `\texttt{/tlpkg}' sont ignorés.
-Par exemple, le choix du miroir \CTAN{}
-\url{http://mirrors.ircam.fr/pub/CTAN/systems/texlive/tlnet/2008/}
-est valide. La liste des miroirs \CTAN{} est ici :
-\url{http://ctan.org/mirrors}.
-
-Lorsqu'aucune option \texttt{-location} n'est spécifiée, le script
-d'installation choisit un miroir automatiquement, celui-ci servira
-pour tout le téléchargement.
-\end{ttdescription}
-
-\subsection{Terminer l'installation}
-\label{sec:postinstall}
-
-Selon les cas quelques opérations supplémentaires peuvent être nécessaires.
-
-\subsubsection{Windows}
-
-Sous Windows, le programme d'installation s'occupe de tout (normalement).
-
-\subsubsection{Cas où des liens symboliques sont créés}
-
-Si vous avez opté pour l'option créant des liens symboliques (voir
-section~\ref{sec:options}), il n'est pas nécessaire d'ajuster les variables
-d'environnement.
-
-\subsubsection{Variables d'environnement Unix}
-\label{sec:env}
-
-Le chemin des binaires correspondant à votre machine doit être ajouté à la
-variable \envname{PATH}. À chaque architecture correspond un sous-répertoire
-de \dirname{TEXDIR/bin}, voir la liste à la figure~\ref{fig:bin-text}
-\pageref{fig:bin-text}.
-
-Si vous voulez que votre système trouve les fichiers de documentation
-concernant \TL{}, il faut également ajuster les variables \envname{MANPATH}
-et \envname{INFOPATH}.
-
-Pour les \textit{shells} dits « Bourne-compatible » tels que
-\prog{bash} sous GNU/Linux, le fichier à éditer peut être
-\filename{$HOME/.bash\_profile} ou \filename{$HOME/.profile} et les lignes à
-ajouter sont de la forme suivante :
-
-\begin{sverbatim}
-PATH=/usr/local/texlive/2008/bin/i386-linux:$PATH; export PATH
-MANPATH=/usr/local/texlive/2008/texmf/doc/man:$MANPATH; export MANPATH
-INFOPATH=/usr/local/texlive/2008/texmf/doc/info:$INFOPATH; export INFOPATH
-\end{sverbatim}
-
-Pour les \textit{shells} \prog{csh} ou \prog{tcsh}, le fichier à éditer
-est en principe \filename{$HOME/.cshrc} %$
-et les lignes à ajouter sont de la forme suivante :
-\begin{sverbatim}
-setenv PATH /usr/local/texlive/2008/bin/i386-linux:$PATH
-setenv MANPATH /usr/local/texlive/2008/texmf/doc/man:$MANPATH
-setenv INFOPATH /usr/local/texlive/2008/texmf/doc/info:$INFOPATH
-\end{sverbatim}
-
-%$
-
-\subsubsection{Variables d'environnement : configuration multi-utilisateur}
-\label{sec:envglobal}
-
-Il est possible d'ajuster les variables \envname{PATH}, \envname{MANPATH}
-et \envname{INFOPATH} globalement pour tous les utilisateurs présents et
-futurs sans avoir à éditer les fichiers personnels de chacun mais les façons
-de le faire sont trop différentes d'un système à l'autre pour être présentées
-ici.
-
-Voici quelques pistes : pour \envname{MANPATH} chercher un fichier
-\filename{/etc/manpath.config}, s'il est présent lui ajouter
-des lignes du genre
-\begin{sverbatim}
-MANPATH_MAP /usr/local/texlive/2008/bin/i386-linux \
- /usr/local/texlive/2008/texmf/doc/man
-\end{sverbatim}
-Pour les deux autres, chercher un fichier\filename{/etc/environment}, il est
-éventuellement possible d'y définir les valeurs des variables d'environnement
-telles que \envname{PATH} et \envname{INFOPATH}.
-
-\subsubsection{Exécution à partir du DVD}
-
-Les programmes de \TL{} consultent le fichier \filename{texmf.cnf} pour savoir
-dans quelles arborescences se trouvent les fichiers dont ils ont besoin.
-Malheureusement, ceci ne fonctionne pas lorsque les programmes sont lancés à
-partir d'un \DVD{} ; en effet certains chemins ne sont connus qu'à
-l'installation et ne peuvent être inscrits sur le \DVD{} puisqu'il est
-accessible uniquement en lecture. Il faut donc créer un fichier
-\filename{texmf.cnf} sur le disque et préciser où il se trouve grâce à la
-variable d'environnement \envname{TEXMFCNF}. Ceci ne dispense pas de
-modifier la variable d'environnement \envname{PATH} comme indiqué ci-dessus.
-
-Le script d'installation affiche en fin de traitement, un message indiquant la
-valeur à donner à la variable \envname{TEXMFCNF}. Si ce message vous a
-échappé, cette valeur est \dirname{$TEXMFSYSVAR/web2c}, %$
-qui vaut par défaut \dirname{/usr/local/texlive/2008/texmf-var/web2c}.
-
-Voici les lignes à taper dans ce cas :
-\begin{sverbatim}
-TEXMFCNF=/usr/local/texlive/2008/texmf-var/web2c; export TEXMFCNF
-\end{sverbatim}
-ou pour [t]csh:
-\begin{sverbatim}
-setenv TEXMFCNF /usr/local/texlive/2008/texmf-var/web2c
-\end{sverbatim}
-
-\subsubsection{\ConTeXt{} Mark IV}
-
-L'ancien \ConTeXt{} devrait fonctionner sans problème. La nouvelle version,
-appelée « Mark IV » demande un peu de configuration spécifique, voir
-\url{http://wiki.contextgarden.net/Running_Mark_IV}.
-
-\subsubsection{Ajout de fichiers locaux ou personnels}
-
-Comme cela a déjà été indiqué à la section~\ref{sec:texmftrees},
-\envname{TEXMFLOCAL} (par défaut \dirname{/usr/local/texlive/texmf-local} ou
-\verb|C:\Program Files\texlive\texmf-local|) est la racine de
-l'arborescence prévue pour regrouper les fichiers de macros, les fontes et le
-matériel utilisable par l'ensemble des utilisateurs du système.
-D'autre part \envname{TEXMFHOME} (par défaut \dirname{$HOME/texmf} %$
-(ou |%USERPROFILE%\texmf|) regroupe le matériel personnel de chaque
-utilisateur.
-
-Dans les deux cas, les fichiers ajoutés doivent être placés, non pas en vrac à
-la racine de \envname{TEXMFLOCAL} ou \envname{TEXMFHOME} mais dans des
-sous-répertoires bien choisis (voir \url{http://tug.org/tds} ou lire le
-fichier \filename{texmf.cnf}). Par exemple, une classe ou une extension
-\LaTeX{} ne sera trouvée que si elle est dans \dirname{TEXMFLOCAL/tex/latex} ou
-\dirname{TEXMFHOME/tex/latex} ou dans un sous-répertoire de ceux-ci.
-
-Enfin, si les ajouts ont été faits sous \envname{TEXMFLOCAL}, il y a lieu de
-régénérer les bases de données \filename{ls-R} (commande \cmdname{mktexlsr}
-ou bouton « Reinit file database » du programme \prog{tlmgr}
-en mode graphique).
-
-L'emplacement des répertoires \envname{TEXMFLOCAL} et \envname{TEXMFHOME} est
-fixe (il ne change pas d'une version à l'autre de \TL{}). Leur contenu est
-pris en compte par toutes les versions de \TL{} aussi est-il préférable de ne
-pas changer la valeur des variables \envname{TEXMFLOCAL} et \envname{TEXMFHOME}
-à l'installation.
-
-
-\subsubsection{Ajout de fontes externes à \TL{}}
-
-Cette question est malheureusement trop complexe pour être abordée ici.
-Renoncez-y sauf si connaissez bien les arcanes d'une installation \TeX.
-Vérifiez en premier lieu ce qui existe déjà en libre : voir la
-section~\ref{sec:tl-fonts}.
-
-Une alternative possible est d'utiliser \XeTeX (voir
-section~\ref{sec:tex-extensions}) qui permet l'accès aux fontes disponibles
-sur le système sans aucune installation supplémentaire.
-
-
-\subsection{Tester l'installation}
-\label{sec:test-install}
-
-Une fois l'installation de \TL{} terminée, il faut la tester avant de créer
-des documents ou des fontes. Les tests doivent être faits par un utilisateur
-non privilégié (autre que \textit{root}).
-
-On donne ici quelques procédures de base pour vérifier que le nouveau
-système est opérationnel. On les décrit pour Unix ; pour \MacOSX{} ou
-Windows, il vaut mieux tester au travers d'une interface graphique
-mais les principes sont les mêmes.
-
-\begin{enumerate}
-
-\item S'assurer en premier lieu que le programme \cmdname{tex} fonctionne :
-
-\begin{alltt}
-> \Ucom{tex -{}-version}
-TeX 3.1415926 (Web2C 7.5.7)
-kpathsea version 3.5.7
-...
-\end{alltt}
-
-Si la réponse est \texttt{command not found} ou si le numéro de version est
-différent, il est fort probable que vous n'avez pas le bon répertoire
-de binaires dans votre \envname{PATH}.
-Voir les informations sur l'environnement page~\pageref{sec:env}.
-
-\item Traiter un fichier \LaTeX{} simple :
-
-\begin{alltt}
-> \Ucom{latex sample2e.tex}
-This is pdfeTeXk, Version 3.1415926...
-...
-Output written on sample2e.dvi (3 pages, 7484 bytes).
-Transcript written on sample2e.log.
-\end{alltt}
-Si le fichier \filename{sample2e.tex} ou d'autres ne sont pas trouvés,
-il y a probablement des interférences avec vos anciennes variables
-d'environnement ou fichiers de configuration. Pour analyser en détail
-votre problème, vous pouvez demander à \TeX{} de dire exactement ce
-qu'il cherche et trouve ; voir la section~\ref{sec:debugging}
-page~\pageref{sec:debugging}.
-
-\item Prévisualiser les résultats en ligne :
-\begin{alltt}
-> \Ucom{xdvi sample2e.dvi}
-\end{alltt}
-Sous Windows, la commande équivalente est \cmdname{dviout}.
-Une nouvelle fenêtre doit s'ouvrir et montrer un joli document expliquant les
-bases de \LaTeX{} (document dont la lecture attentive est recommandée si vous
-êtes débutant !).
-Vous devez travailler sous X pour que \cmdname{xdvi} fonctionne. Sinon, votre
-variable d'environnement \envname{DISPLAY} n'est pas correcte et vous
-aurez une erreur \samp{Can't open display}.
-
-\item Créer un fichier \PS{} pour l'imprimer ou l'afficher :
-
-\begin{alltt}
-> \Ucom{dvips sample2e.dvi -o sample2e.ps}
-\end{alltt}
-
-\item Créer un fichier \acro{PDF} au lieu de \dvi{} ;
-cet exemple traite le fichier \filename{sample2e.tex} et crée directement
-du \acro{PDF} :
-
-\begin{alltt}
-> \Ucom{pdflatex sample2e.tex}
-\end{alltt}
-
-\item Prévisualiser le fichier \acro{PDF} :
-
-\begin{alltt}
-> \Ucom{gv sample2e.pdf}
-\textrm{ou}
-> \Ucom{xpdf sample2e.pdf}
-\end{alltt}
-
-Hélas, ni \cmdname{gv} ni \cmdname{xpdf} ne sont actuellement inclus dans
-\TL{}, aussi devez-vous les installer séparément si ce n'est déjà fait.
-Voir respectivement
-\url{http://www.gnu.org/software/gv} et
-\url{http://www.foolabs.com/xpdf} (il y a bien d'autres lecteurs de
-fichiers \acro{PDF}).
-
-\item Autres fichiers de tests utiles en plus de \filename{sample2e.tex} :
-
-\begin{ttdescription}
-
-\item [small2e.tex] à compiler avant \filename{sample2e} si celui-ci pose des
- problèmes.
-
-\item [testpage.tex] teste que l'imprimante n'introduit pas de décalages.
-
-\item [nfssfont.tex] imprime des tables des fontes et des tests.
-\item [testfont.tex] aussi pour les tables de fontes mais en (plain)\TeX.
-\item [story.tex] le fichier de test de (plain)\TeX{} le plus canonique
-de tous. Il faut taper \samp{\bs bye} à la commande \code{*} après
-\samp{tex story.tex}.
-
-\end{ttdescription}
-Pour exécuter ces tests procéder comme pour \filename{sample2e.tex}.
-
-\end{enumerate}
-
-Si vous êtes débutant ou si vous avez besoin d'aide pour réaliser des
-documents \TeX{} ou \LaTeX{}, n'hésitez pas à consulter
-\url{http://tug.org/begin.html}.
-On vous recommande également l'introduction à \LaTeX{} de Tobias Oetiker
-dans sa version anglaise (la version française n'est plus à jour)
-disponible après installation sous
-\url{texmf-doc/doc/english/lshort-english/lshort.pdf}.
-
-\section{Utilisation de \TL{} en réseau}
-\label{sec:netinstall}
-
-\TL{} a été conçu comme un système multi-utilisateurs capable de fonctionner
-en réseau. Un même serveur peut proposer la distribution \TL{} à différentes
-machines, éventuellement d'architectures différentes, il suffit que le serveur
-possède les répertoires de binaires adéquats.
-
-La seule chose à faire par chaque utilisateur local ou distant est d'ajouter
-le chemin des exécutables correspondant à son architecture dans son
-\envname{PATH}%
-\footnote{Plus précisément \emph{en tête} du \envname{PATH} s'il y a d'autres
- binaires \TeX{} en concurrence.}.
-
-Ceci fonctionne parce que les répertoires de recherche des fichiers utilisés
-par \TL{} (\envname{TEXMFMAIN}, \envname{TEXMFDIST}, \envname{TEXMFSYSVAR},
-\envname{TEXMFSYSCONFIG} et \envname{TEXMFLOCAL} sont définis
-\emph{relativement aux exécutables} lors de l'installation (voir dans le fichier
-\filename{TEXMFMAIN/web2c/texmf.cnf} le rôle de la variable
-\envname{\$SELFAUTOPARENT}). %$
-
-Cette disposition permet aussi de faire une installation sur une machine et
-de la déplacer après coup sur un serveur, la seule chose à changer est le
-contenu de la variable \envname{PATH}.
-
-Ce qui précède vaut pour les utilisateurs d'Unix.
-Pour ceux qui sont sous Windows, le répertoire
-\dirname{texmf-doc/source/texlive/texlive-common/w32client}
-contient un exemple de script \filename{install-w32client} qui permet
-de partager une installation \TL{} à travers un réseau local. Il se lance
-par l'intermédiaire du fichier « batch »
-\filename{install-w32client.bat} qui se trouve dans le même répertoire.
-
-De plus amples informations sur la configuration de \TL{} et sur la recherche
-de fichiers sont disponibles à la section~\ref{sec:kpathsea}.
-
-\section{\TL{} sur une machine hôte (DVD ou USB)}
-\label{sec:portable-unix}
-
-L'utilisation de \TL{} à partir du \DVD{} décrite à la
-section~\ref{sec:fromdvd} impose la création de quelques répertoires sur le
-disque dur, ce qui n'est pas gênant sur une machine personnelle. En revanche,
-lorsqu'on travaille sur une machine hôte, il est préférable de limiter les
-ajouts et modifications à faire sur le disque dur.
-
-Les scripts \filename{tl-portable} (pour Unix) et \filename{tl-portable.bat}
-pour Windows, présents à la racine de \TL{} (ou dans le répertoire
-\dirname{texlive} du \DVD \TK) facilitent l'utilisation de \TL{} sur des
-machines hôtes. Lors de leur première exécution, ces scripts créent un
-répertoire \dirname{~/.tlportable2008} contenant divers fichiers de
-configuration qui permettront l'accès à la distribution \TL{} du \DVD.
-Ceci peut prendre un peu de temps mais lors des exécutions
-suivantes le démarrage est presque immédiat. Rien n'est modifié sur la machine
-en dehors du répertoire \dirname{~/.tlportable2008}.
-
-Pour qu'un éditeur prenne en compte la distribution \TL{} du \DVD, il suffit
-de le lancer par l'intermédiaire du script \filename{tl-portable}.
-
-Le script \filename{tl-portable} est utile aussi pour créer une distribution
-\TL{} sur une clé \acro{USB}. Pour ce faire, copier sur la clé les fichiers
-et les répertoires situés à la racine de \TL{} (au moins \dirname{bin},
-\dirname{texmf}, \dirname{texmf-dist} et \dirname{tlpkg}). Si la clé est
-formatée en \acro{FAT32}, attention aux liens symboliques (utiliser \code{cp
- -L} pour copier). Il est possible d'ajouter un répertoire
-\dirname{texmf-local} sur la clé, il sera pris en compte à l'exécution. Il
-reste à lancer le script \filename{tl-portable} à la racine de la clé comme
-ci-dessus ; celle-ci étant accessible en écriture, lors des exécutions de \TL{}
-tous les fichiers seront créés sur elle et rien ne sera écrit sur le
-disque dur.
-
-\section{Maintenance de l'installation avec \cmdname{tlmgr}}
-\label{sec:tlmgr}
-
-\begin{figure}[tb]
-\centering
-\tlpng{tlmgr-gui}{\linewidth}
-\caption{\prog{tlmgr} en mode graphique (après clic sur le bouton « Load »).}%
-\label{fig:tlmgr-gui}
-\end{figure}
-
-\begin{figure}[tb]
-\centering
-\tlpng{tlmgr-config}{\linewidth}
-\caption{\texttt{tlmgr} en mode graphique, onglet « configuration »}%
-\label{fig:tlmgr-config}
-\end{figure}
-
-Un nouveau programme appelé \prog{tlmgr} est installé avec la
-distribution \TL. Il fournit une interface conviviale pour la
-maintenance de la distribution. Les programmes \prog{updmap},
-\prog{fmtutil} et \prog{texconfig} ont été conservés et le seront à
-l'avenir bien que \prog{tlmgr} soit appelé à devenir l'interface
-standard de configuration.
-\prog{tlmgr} permet en particulier
-\begin{itemize}
-\item de voir la liste de toutes les collections et extensions
- disponibles, avec la mention \texttt{(i)} pour celles qui sont installées ;
-\item d'installer, de mettre à jour ou de désinstaller tel ou tel composant,
- en respectant les dépendances (sauf si l'utilisateur le refuse) ;
-\item de rechercher des extensions ;
-\item de voir la liste des binaires disponibles et d'en installer ;
-\item de modifier la configuration (taille du papier, choix du
- répertoire source pour le téléchargement voir option \texttt{-location}
- page~\pageref{item:location}, etc.).
-\end{itemize}
-\textit{Attention :} \prog{tlmgr} ne doit pas être utilisé lorsque \TL{} est
-exécuté à partir du \DVD{} (sans installation sur le disque dur).
-
-\subsection{\cmdname{tlmgr} en mode graphique}
-
-\prog{tlmgr} est lancé en mode graphique par la commande
-\begin{alltt}
-> \Ucom{tlmgr -gui}
-\end{alltt}
-ou sous Windows dans le menu « Démarrer » : \texttt{Démarrer} $\rightarrow$
-\texttt{Programmes} $\rightarrow$ \texttt{TeX Live 2008} $\rightarrow$
-\texttt{TeX Live Manager}.
-
-La première chose à faire est de cliquer sur le bouton « Load%
-\footnote{Dans la description qui suit, le nom des boutons est celui de la
- version anglaise par souci de cohérence avec les figures. L'affichage se
- fait normalement dans la langue de l'utilisateur (variable \envname{LANG}
- sous Unix).} » ce qui affiche la liste des collections, extensions, etc. ;
-le préfixe \texttt{(i)} indique celles qui sont déjà installées.
-
-La figure~\ref{fig:tlmgr-config} présente l'onglet « configuration ».
-
-\subsection{Exemples d'utilisation de \cmdname{tlmgr}
- en ligne de commande}
-
-Premier exemple : ajout de la collection « xetex » et de l'extension « xkeyval »
-qui devront être téléchargées à partir d'un site spécifié. La commande
-
-\begin{alltt}
-> \Ucom{tlmgr -location http://172.16.18.1/tldev install collection-xetex xkeyval}
-\end{alltt}
-retourne
-\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/2008/texmf/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-config/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-dist/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-doc/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/../texmf-local/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-var/ls-R...
-mktexlsr: Done.
-regenerating fmtutil.cnf
-running fmtutil-sys --missing
-...
-Transcript written on xelatex.log.
-fmtutil: /usr/local/texlive/2008/texmf-var/web2c/xetex/xelatex.fmt installed.
-\end{fverbatim}
-Le programme \prog{tlmgr} prend en compte les dépendances et effectue
-automatiquement toutes les opérations nécessaires comme la mise à jour des
-bases de données et la génération de formats (ici un nouveau format a été créé
-pour \XeTeX).
-
-Deuxième exemple : ajout d'une langue de travail (néerlandais) ; ceci provoque
-la régénération de plusieurs formats.
-\begin{alltt}
-> \Ucom{tlmgr install collection-langdutch}
-\end{alltt}
-
-La demande de description de l'extension « collection-wintools »
-\begin{alltt}
-> \Ucom{tlmgr show collection-wintools}
-\end{alltt}
-retourne
-\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
-\end{fverbatim}
-
-Mise à jour complète de l'installation avec les dernières versions disponibles :
-\begin{alltt}
-> \Ucom{tlmgr update -all}
-\end{alltt}
-ou juste pour voir ce qui se passerait en cas de mise à jour complète :
-\begin{alltt}
-> \Ucom{tlmgr update -all -dry-run}
-\end{alltt}
-ou bien
-\begin{alltt}
-> \Ucom{tlmgr update -list}
-\end{alltt}
-
-Documentation complète de \prog{tlmgr} :
-\begin{alltt}
-> \Ucom{tlmgr -help}
-\end{alltt}
-
-\section{Spécificités Windows}
-\label{sec:windows}
-
-Le nouveau programme d'installation de \TL{} est conçu pour
-fonctionner aussi bien sous Unix que sous Windows. Ceci nous a
-obligés à nous limiter à Windows 2000 et à ses successeurs (XP, Vista),
-au détriment des anciennes versions (9\textit{x}, ME et NT).
-
-\subsection{Installation}
-\label{sec:winfeatures}
-
-Sous Windows le programme d'installation effectue quelques tâches
-supplémentaires :
-\begin{description}
-\item[Menus et raccourcis] -- un sous-menu «\TL{}» est ajouté au menu
- « Démarrer », il contient des entrées pour les programmes \prog{tlmgr},
- \prog{texdoctk}, PS\_View et pour de la documentation.
- Une icône PS\_View est ajoutée sur le bureau, il suffit d'y déposer un
- fichier PostScript pour provoquer son affichage.
-\item[Variables d'environnement] -- leurs valeurs sont préremplies
- automatiquement sans intervention de l'utilisateur.
-\item[Désinstallation] -- une entrée est ajoutée pour \TL{} dans le menu
- « Ajout et suppression de programmes ».
-\end{description}
-
-\subsection{Programmes supplémentaires}
-
-\begin{figure}[tb]
-\centering
-\tlpng{psview}{.6\linewidth}
-\caption{PS\_View: de très forts grossissements sont possibles !}%
-\label{fig:psview}
-\end{figure}
-
-L'installation de \TL{} ajoute quelques utilitaires non fournis en standard
-avec Windows :
-\begin{description}
-\item[Perl et Ghostscript] -- \TL{} installe des copies « cachées » de ces
- programmes : ce sont des versions spécifiques adaptées à \TL{}, elles
- sont invisibles hors de \TL{} et n'interfèrent donc en aucune façon avec
- d'autres versions éventuellement présentes sur la machine.
-\item[Outils en ligne de commande] -- des versions pour Windows de programmes
- Unix sont installées, en particulier \cmdname{gzip}, \cmdname{chktex},
- \cmdname{jpeg2ps}, \cmdname{unzip}, \cmdname{wget} et quelques utilitaires
- de la suite \cmdname{xpdf} (\cmdname{xpdf} lui-même n'est pas disponible
- sous Windows mais le visualiseur \acro{PDF} Sumatra en est dérivé, voir
- \url{http://blog.kowalczyk.info/software/sumatrapdf}).
-\item[\texttt{fc-cache}] -- facilite l'accès aux fontes système pour \XeTeX.
-\item[PS\_View] -- nouveau visualiseur PostScript sous licence libre,
- voir figure~\ref{fig:psview}.
-\item[Répertoire \texttt{support}] -- ce répertoire, déjà mentionné à la
- section~\ref{sec:tld}, contient divers programmes éventuellement utiles
- comme des éditeurs adaptés aux fichiers \TeX{} ou le visualiseur Dviout
- présenté à la section suivante. Ces programmes ne sont
- pas installés automatiquement par la commande \prog{install-tl}.
-\end{description}
-
-\subsection{Visualiseur Dviout}
-
-Cette année, la distribution \TL{} ne contient malheureusement pas de
-visualiseur \dvi{} pour Windows. Le programme \prog{dviout} de
-Toshio Oshima est disponible dans le répertoire \path{support/dviout/}, il est
-accompagné d'un fichier \filename{README} (à lire attentivement) décrivant
-l'installation et la configuration de \prog{dviout} pour \TL.
-
-Lors des premières exécutions de \cmdname{dviout}, de nombreuses fontes sont
-créées à la volée pour l'écran utilisé. Ceci prend un peu de temps mais se
-produit de plus en plus rarement au fur et à mesure des utilisations.
-Une bonne aide en ligne est disponible.
-
-\subsection{Téléchargement de logiciels supplémentaires}
-
-Voici quelques liens vers des sites proposant des outils intéressants :
-\begin{description}
-\item[Ghostscript] -- \url{http://www.cs.wisc.edu/~ghost/} ;
-\item[Perl] -- \url{http://www.activestate.com/} et \acro{CPAN}
- \url{http://www.cpan.org/} ;
-\item[ImageMagick] -- \url{http://www.imagemagick.com} pour l'affichage et la
- conversion d'images ;
-\item[NetPBM] -- \url{http://netpbm.sourceforge.net/} un concurrent du
- précédent ;
-\item[Éditeurs orientés \TeX] -- le choix est large, en voici une sélection :
- \begin{itemize}
-% \item \cmdname{GNU Emacs} disponible sous Windows, see
-% \url{http://www.gnu.org/software/emacs/windows/ntemacs.html} ;
- \item \cmdname{Emacs} avec Auc\TeX\ pour Windows disponible dans le
- répertoire \path{support} de \TL{} ; le site de référence est
- \url{http://www.gnu.org/software/auctex} ;
- \item \cmdname{WinShell} disponible également dans le répertoire
- \path{support} ; le site de référence est \url{http://www.winshell.de} ;
- \item \cmdname{WinEdt} est un \textit{shareware}, voir
- \url{http://www.winedt.com} ;
- \item TeXnicCenter est libre, il est disponible sur
- \url{http://www.toolscenter.org} et dans la distribution \ProTeXt{} ;
- \item \cmdname{Vim} est libre, voir \url{http://www.vim.org} ;
- \item \cmdname{LEd} voir \url{http://www.ctan.org/support/LEd} ;
- \item \cmdname{SciTE} voir
- \url{http://www.scintilla.org/SciTE.html}.
- \end{itemize}
-\end{description}
-
-
-\subsection{Répertoire personnel}
-\label{sec:winhome}
-
-L'équivalent du répertoire personnel noté \envname{\$HOME} sous
-Unix s'appelle \verb|%USERPROFILE%| sous Windows. %
-Cette variable vaut en général
-\verb|C:\Documents and Settings\<username>| sous Windows XP et 2000
-et \verb|C:\Utilisateurs\<username>| sous Vista.
-La notation \verb|~|, utilisée dans \filename{texmf.cnf} et dans \KPS{} en
-général pour désigner un répertoire personnel, est correctement interprétée
-sous Windows comme sous Unix.
-
-
-\subsection{Base de registre Windows}
-\label{sec:registry}
-
-% (df) Je ne vois pas bien l'utilité de cette section...
-
-Windows stocke pratiquement tous les paramètres de configuration dans sa base
-de registres. Celle-ci contient un ensemble de clés organisées par niveau.
-Les clés les plus importantes pour l'installation de programmes sont
-\path{HKEY_CURRENT_USER} et \path{HKEY_LOCAL_MACHINE}, \path{HKCU} et
-\path{HKLM} en abrégé. La partie \path{HKCU} de la base de registres
-se trouve dans le répertoire personnel de l'utilisateur (voir
-section~\ref{sec:winhome}). La partie \path{HKLM} est normalement dans un
-sous-répertoire du répertoire Windows.
-
-Certaines informations système peuvent s'obtenir à partir des variables
-d'environnement mais pour d'autres, la localisation des raccourcis par
-exemple, la consultation de la base de registre est indispensable.
-La modification des variables d'environnement nécessite l'accès à la base de
-registre.
-
-
-\subsection{Droits d'accès sous Windows}
-\label{sec:winpermissions}
-
-Dans les versions récentes de Windows, la distinction est faite entre
-« utilisateurs » et « administrateurs », ces derniers ayant accès en écriture
-à la totalité du système. En pratique on devrait plutôt parler d'utilisateurs
-« non privilégiés » et d'utilisateurs « normaux » car être « administrateur »
-est la règle et non l'exception.
-
-Nous nous sommes efforcés de rendre l'installation de \TL{} possible aux
-utilisateurs non privilégiés.
-
-Si celui qui fait l'installation est « administrateur », les raccourcis
-et les entrées des menus sont créés pour tous les utilisateurs ;
-sinon, seul celui qui a fait l'installation aura accès à ces éléments.
-L'option \optname{non-admin} du programme \prog{install-tl} permet à un
-« administrateur » de faire une installation comme utilisateur non privilégié.
-
-Dans tous les cas, le répertoire proposé comme racine de l'installation est
-\verb|%PROGRAMFILES%|. %
-Le programme \prog{install-tl} vérifie si le répertoire choisi comme racine
-est accessible en écriture pour celui qui procède à l'installation.
-
-Lorsqu'une installation \TeX{} est présente sur la machine, l'installation
-de \TL{} par un utilisateur non privilégié est problématique :
-cet utilisateur n'aura jamais accès aux exécutables \TL{} car la recherche
-s'effectue d'abord dans les répertoires système, puis dans les répertoires de
-l'utilisateur. Une parade sommaire a été prévue : les raccourcis intègrent
-dans ce cas le chemin complet des exécutables qu'ils représentent. La
-distribution \TL{} est ainsi utilisable en ligne de commande à partir de ces
-raccourcis.
-
-
-\section{Guide d'utilisation du système Web2C}
-
-\Webc{} est une collection intégrée de programmes relatifs à \TeX,
-c.-à-d. \TeX{} lui-même, \MF{}, \MP, \BibTeX{}, etc.
-C'est le cœur de \TL{}. Le site de référence est \url{http://tug.org/web2c}.
-
-Un peu d'histoire : la première implémentation a été réalisée par Tomas
-Rokicki qui, en 1987, a développé un premier système \TeX{}-to-C en adaptant
-les \textit{change files} pour Unix (travail de Howard Trickey et Pavel Curtis
-principalement). Tim Morgan assura la maintenance du système, dont le nom fut
-remplacé durant cette période par Web-to-C. En 1990, Karl Berry reprit le
-travail, assisté par des dizaines de contributeurs et en 1997 il passa le
-relais à Olaf Weber qui le rendit à Karl en 2006.
-
-Le système \Webc{} fonctionne sur Unix, sur les systèmes Windows 32 bits,
-sur \MacOSX{} et sur de nombreux autres systèmes d'exploitation. Il utilise les
-sources originales de Knuth pour \TeX{} et les autres programmes de base
-écrits en \web{} (système de programmation documentée) qui sont tous traduits
-en langage C. Les composants du noyau de \TeX{} issus de ce processus sont :
-
-\begin{description}
-\item[bibtex] -- gère les bibliographies.
-\item[dmp] -- \cmdname{troff} vers MPX (dessins \MP{}).
-\item[dvicopy] -- copie le fichier \dvi{} en supprimant les fontes virtuelles.
-\item[dvitomp] -- convertit le fichier \dvi{} en MPX (dessins \MP{}).
-\item[dvitype] -- convertit le fichier \dvi{} en un texte lisible.
-\item[gftodvi] -- visualisation de fontes génériques GF.
-\item[gftopk] -- convertit les fontes génériques GF en fontes bitmap PK.
-\item[gftype] -- convertit le fichier GF en un texte lisible.
-\item[makempx] -- typographie des étiquettes \MP{}.
-\item[mf] -- création de fontes.
-\item[mft] -- mise en page de code source \MF{}.
-\item[mpost] -- création de diagrammes techniques.
-\item[mpto] -- extraction d'étiquettes \MP{}.
-\item[newer] -- comparaison de dates de modification (fichiers).
-\item[patgen] -- création de motifs de césure.
-\item[pktogf] -- convertit les fontes bitmap PK en fontes génériques GF.
-\item[pktype] -- convertit les fontes PK en un texte lisible.
-\item[pltotf] -- convertit les fichiers PL (lisibles) en TFM.
-\item[pooltype] -- affiche les fichiers \web{} pool.
-\item[tangle] -- \web{} vers Pascal.
-\item[tex] -- composition de textes.
-\item[tftopl] -- convertit les fichiers TFM en PL (lisibles).
-\item[vftovp] -- convertit les fontes virtuelles VF en VPL (lisibles).
-\item[vptovf] -- convertit les fontes VPL en fontes virtuelles VF.
-\item[weave] -- \web{} vers \TeX.
-\end{description}
-
-La syntaxe et les fonctions précises de ces programmes sont décrites dans
-la documentation des composants individuels et dans le manuel \Webc{}
-lui-même. Toutefois, connaître un certain nombre de principes régissant
-l'ensemble de la famille de programmes peut aider à exploiter de façon
-optimale votre installation \Webc{}.
-
- Presque tous ces programmes suivent les options standard de \GNU :
-\begin{description}
- \item[\texttt{-{}-help}] imprime le sommaire de l'utilisation,
- \item[\texttt{-{}-verbose}] imprime le rapport détaillé du processus,
- \item[\texttt{-{}-version}] imprime seulement le numéro de version.
-\end{description}
-
-Pour localiser les fichiers, les programmes \Webc{} utilisent la bibliothèque
-de recherche \KPS{} (\url{http://tug.org/kpathsea}). Cette bibliothèque
-utilise une combinaison de variables d'environnement et un certain nombre de
-fichiers de paramètres pour optimiser la recherche dans l'énorme arborescence
-\TeX{}. \Webc{} peut exécuter une recherche dans plusieurs arborescences
-simultanément, ce qui est utile si l'on souhaite maintenir la distribution
-standard de \TeX{} et les extensions locales dans deux arborescences
-distinctes. Afin d'accélérer la recherche de fichiers, la racine de chaque
-arborescence possède un fichier \file{ls-R} contenant une entrée donnant le
-nom et le chemin de chaque fichier situé sous la racine.
-
-\subsection{Kpathsea et la recherche de fichiers}
-\label{sec:kpathsea}
-
-Décrivons en premier lieu le mécanisme de recherche de la bibliothèque \KPS{}.
-
-Nous appelons \emph{chemin de recherche} une liste, séparée par
-« deux-points» ou « point-virgule», d'éléments, appelés
-\emph{éléments de chemin}, qui sont des noms de répertoires.
-Un chemin de recherche peut provenir de plusieurs sources.
-Pour rechercher un fichier \samp{my-file} le long
-d'un chemin \samp{.:/dir}, \KPS{} vérifie chaque élément du chemin :
-d'abord \filename{./my-file}, puis \filename{/dir/my-file} et renvoie la
-première occurrence (voire toutes).
-
-Afin d'optimiser l'adaptation à tous les systèmes d'exploitation, \KPS{} peut
-utiliser dans les noms de fichiers des séparateurs différents de deux-points
-(\samp{:}) et barre oblique (\samp{/}) pour les systèmes non-Unix.
-
-Pour vérifier un élément de chemin particulier \var{p}, \KPS{}
-vérifie d'abord si une base de données existante (voir
-page~\pageref{sec:filename-database}) contient \var{p},
-c.-à-d. si la base de données se trouve dans un
-répertoire qui est un préfixe de \var{p}. Si oui, la spécification
-du chemin est comparée avec le contenu de la base de données.
-
-Si la base de données n'existe pas, si elle ne s'applique pas à cet élément de
-chemin ou si elle ne contient aucune correspondance, la recherche est lancée
-sur tout le système de fichiers (si cela n'a pas été interdit par une commande
-commençant par \samp{!!} et si le fichier cherché est censé exister). \KPS{}
-construit la liste de répertoires qui correspondent à cet élément de chemin,
-puis cherche le fichier dans chaque élément de cette liste.
-
-La condition « le fichier est censé exister » est liée aux fichiers~\samp{.vf}
-et aux fichiers d'entrée lus par la commande \TeX\ \cs{openin}. De tels
-fichiers peuvent ne pas exister (par exemple \file{cmr10.vf}), il est donc
-inutile de les rechercher sur le disque. De plus, si vous n'actualisez pas le
-fichier \file{ls-R} lors de l'installation d'un nouveau fichier \samp{.vf}, il
-ne sera jamais trouvé. Chaque élément de chemin est alors vérifié : d'abord
-dans la base de données puis sur le disque. Si une occurrence est trouvée, la
-recherche s'arrête et le résultat est obtenu.
-
-Bien que l'élément de chemin le plus simple et le plus fréquent soit un nom de
-répertoire, \KPS{} supporte d'autres types d'éléments dans les chemins de
-recherche : des valeurs par défaut différentes pour chaque programme, des noms
-de variables d'environnement, des valeurs de fichiers de configuration, les
-répertoires de l'utilisateur et la recherche récursive de
-sous-répertoires. Nous disons alors que \KPS{} \emph{étend} un élément,
-c'est-à-dire que \KPS{} transforme toutes ces spécifications en noms de
-répertoires de base. Cette opération est décrite dans les sections suivantes.
-
-Notons que si le nom de fichier cherché est absolu ou explicitement
-relatif, c'est-à-dire commençant par \samp{/}, \samp{./} ou
-\samp{../}, \KPS{} ne vérifie que l'existence de ce fichier.
-\ifSingleColumn
-\else
-\begin{figure*}
-\centering
-\verbatiminput{examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{Un exemple de fichier de configuration}
- \label{fig:config-sample}
-\end{figure*}
-\fi
-
-\subsubsection{Les différentes sources}
-\label{sec:path-sources}
-
-Un chemin de recherche peut provenir de plusieurs sources. Voici l'ordre
-dans lequel \KPS\ les utilise.
-
-\begin{enumerate}
-\item Une variable d'environnement définie par l'utilisateur, par exemple
- \envname{TEXINPUTS}. Les variables d'environnement avec une extension
- attachée (nom de programme) sont d'abord prises en compte : par exemple, si
- \samp{latex} est le nom du programme exécuté, \envname{TEXINPUTS.latex}
- passera avant \envname{TEXINPUTS}.
-\item Un fichier de configuration de programme spécifique, par exemple une
- ligne « \texttt{S /a:/b} » dans le fichier \file{config.ps} de
- \cmdname{dvips}.
-\item Un fichier de configuration \file{texmf.cnf} de \KPS{} contenant une
- ligne telle que \\ \samp{TEXINPUTS=/c:/d} (voir ci-dessous).
-\item La valeur par défaut obtenue à la compilation.
-\end{enumerate}
-\noindent On peut voir chacune de ces valeurs pour un chemin de recherche
-donné en utilisant l'option de débogage (voir page~\pageref{sec:debugging}).
-
-\subsubsection{Fichiers de configuration}
-
-\begingroup\tolerance=3500
-\KPS{} lit dans les \emph{fichiers de configuration à
- l'exécution} appelés \file{texmf.cnf} les chemins de recherche et
-d'autres définitions. Le chemin pour accéder à ces fichiers dans
-l'arborescence est stocké dans la variable \envname{TEXMFCNF}
-(par défaut ces
-fichiers se trouvent dans le sous-répertoire \file{texmf/web2c}).
-\emph{Tous} les fichiers \file{texmf.cnf} se trouvant dans le chemin
-de recherche vont être lus et les définitions provenant
-de fichiers précédents écraseront celles des fichiers suivants. Par
-exemple, avec un chemin tel que \verb|.:$TEXMF|, les définitions du
-fichier \filename{./texmf.cnf} écrasent celles de
-\verb|$TEXMF/texmf.cnf|.
-\endgroup
-
-\begin{itemize}
-\item Les commentaires sont signalés par un \texttt{\%} et se terminent à la
- fin de la ligne.
-\item Les lignes vides sont ignorées.
-\item Un \bs{} à la fin d'une ligne joue le rôle d'un lien entre deux lignes,
- c'est-à-dire que la ligne courante se poursuit à la ligne suivante. Dans ce
- cas, les espaces présents au début de la ligne suivante ne sont pas ignorés.
-\item Toutes les autres lignes sont de la forme :
-\begin{alltt}
- \emph{variable}[.\emph{progname}] [=] \emph{value}
-\end{alltt}%
- où le \samp{=} et les espaces autour sont optionnels.
-\item Le nom de la \ttvar{variable} peut contenir n'importe quel caractère
- autre que les espaces, \samp{=}, ou \samp{.} mais on recommande d'utiliser
- \samp{A-Za-z\_} pour éviter les problèmes.
-\item Si \samp{.\var{progname}} est présent, sa définition s'applique
- seulement si le programme exécuté se nomme \texttt{\var{progname}} ou
- \texttt{\var{progname}.exe}. Ceci permet par exemple à différentes variantes
- de \TeX{} d'avoir des chemins de recherche différents.
-\item \var{value} peut contenir n'importe quel caractère excepté \code{\%} et
- \samp{@}. L'option \code{\$\var{var}.\var{prog}} n'est pas disponible à
- droite du signe \samp{=} ; à la place, on doit utiliser une variable
- supplémentaire. Un \samp{;}\ dans \var{value} est compris comme un \samp{:}\
- si on travaille sous Unix ; ceci est très utile et permet d'avoir un seul
- \file{texmf.cnf} pour les systèmes Unix, \acro{MS-DOS} et Windows.
-\item Toutes les définitions sont lues avant tout désarchivage ou
- décompactage, de telle façon que les variables peuvent être référencées
- avant d'être définies.
-\end{itemize}
-Voici un fichier de configuration illustrant les points précédents
-\ifSingleColumn
-
-%\verbatiminput{examples/ex5.tex} % trop petit (df)
-\begin{verbatim}
-TEXMF = {$TEXMFLOCAL,!!$TEXMFMAIN}
-TEXINPUTS.latex = .;$TEXMF/tex/{latex,generic;}//
-TEXINPUTS.fontinst = .;$TEXMF/tex//;$TEXMF/fonts/afm//
-% e-TeX related files
-TEXINPUTS.elatex = .;$TEXMF/{etex,tex}/{latex,generic;}//
-TEXINPUTS.etex = .;$TEXMF/{etex,tex}/{eplain,plain,generic;}//
-\end{verbatim}
-
-\else
-dans la figure~\ref{fig:config-sample}.
-\fi
-
-\subsubsection{Expansion d'un chemin de recherche}
-\label{sec:path-expansion}
-
-\KPS{} reconnaît certains caractères et constructions spéciales dans
-les chemins de recherche, semblables à ceux disponibles dans les
-\textit{shells} Unix. Ainsi, le chemin complexe,
-\verb+~$USER/{foo,bar}//baz+ %$
-étend la recherche vers tous les sous-répertoires situés sous les
-répertoires \file{foo} et \file{bar} dans le répertoire utilisateur
-\texttt{\$USER} contenant un répertoire ou un fichier appelé %$
-\file{baz}. Ces expansions sont explicitées dans les sections
-suivantes.
-
-\subsubsection{Expansion par défaut}
-\label{sec:default-expansion}
-
-\tolerance=2500
-Si le chemin de recherche le plus prioritaire (voir
-section~\ref{sec:path-sources}) contient un \samp{:}
-\emph{supplémentaire} (c.-à-d. en début ou fin de ligne ou
-double), \KPS{} insère à cet endroit le chemin suivant dont la
-priorité définie est immédiatement inférieure. Si ce chemin inséré
-possède un \samp{:} supplémentaire, le même processus se
-répète pour le chemin prioritaire suivant.
-Par exemple, étant donné une variable d'environnement définie ainsi
-
-\tolerance=1500
-
-\begin{alltt}
-> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
-la valeur de \code{TEXINPUTS} d'après le fichier \file{texmf.cnf} étant
-
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
-alors la valeur finale utilisée pour la recherche sera
-
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-
-Comme il est inutile d'insérer la valeur par défaut en plusieurs
-endroits, \KPS{} applique la substitution à seulement un \samp{:}
-supplémentaire et laisse les autres inchangés : il cherche d'abord un
-\samp{:} en début de ligne, puis en fin de ligne et enfin un double
-\samp{:}.
-
-\subsubsection{Expansion spécifiée par les accolades}
-
-Option utile, l'expansion par le biais des accolades
-signifie, par exemple, que \verb+v{a,b}w+ va permettre la recherche
-dans \verb+vaw:vbw+. Les définitions emboîtées sont autorisées. Ceci
-peut être utilisé pour établir des hiérarchies \TeX{} multiples en
-attribuant une liste entre accolades à \code{\$TEXMF}. Par exemple,
-dans \file{texmf.cnf}, on trouve une définition du type suivant
-(il y a en fait plus de répertoires) :
-\begin{verbatim}
- TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFSYSVAR,!!$TEXMFMAIN}
-\end{verbatim}
-Avec ceci, on peut écrire quelque chose comme
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-%$
-ce qui signifie que, après avoir cherché dans le répertoire courant, les
-arborescences complètes \code{\$TEXMFHOME/tex} suivie de
-\code{\$TEXMFLOCAL/tex} (sur le disque) et ensuite les arborescences
-\code{!!\$TEXMFVAR/tex} et \code{!!\$TEXMFMAIN/tex}
-(définies dans le fichier de référence \file{ls-R} \emph{seulement}) seront
-inspectées. C'est un moyen pratique permettant d'utiliser en parallèle deux
-distributions \TeX{}, une « figée » (sur un \CD, par exemple) et une
-autre régulièrement mise à jour avec de nouvelles versions quand elles
-deviennent disponibles. En utilisant la variable \code{\$TEXMF} dans toutes
-les définitions, on est toujours sûr d'inspecter d'abord l'arborescence la
-plus récente.
-
-\subsubsection{Expansion des sous-répertoires}
-\label{sec:subdirectory-expansion}
-
-Deux barres \samp{//} ou plus consécutives dans une partie d'un chemin suivant
-un répertoire \var{d} sont remplacées par tous les sous-répertoires de
-\var{d} : d'abord les sous-répertoires directement présents dans
-\var{d}, ensuite les sous-répertoires de ceux-ci et ainsi de suite. À
-chaque niveau, l'ordre dans lequel les répertoires sont inspectés est
-\emph{non-déterminé}.
-
-Dans le cas où l'on spécifie une partie de nom de fichier après le
-\samp{//}, seuls sont inclus les sous-répertoires auxquels le nom
-correspond. Par exemple, \samp{/a//b} va correspondre aux répertoires
-\file{/a/1/b}, \file{/a/2/b}, \file{/a/1/1/b} et ainsi de suite,
-mais pas à \file{/a/b/c} ni \file{/a/1}.
-
-Des \samp{//} multiples et successifs dans un chemin sont possibles,
-mais \samp{//} au début d'un chemin est ignoré.
-
-\subsubsection{Liste des caractères spéciaux et de leur signification :
- récapitulatif}
-
-La liste suivante récapitule la signification des caractères spéciaux
-dans les fichiers de configuration de \KPS{}.
-
-\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
-
-\begin{ttdescription}
-
-\item[\CODE{:}] Séparateur dans un chemin de recherche ; au début
- ou à la fin d'un chemin, il remplace le chemin par défaut.
-
-\item[\CODE{;}] Séparateur dans les systèmes non-Unix
- (joue le rôle de \code{:}).
-
-\item[\CODE{\$}] Substitue le contenu d'une variable.
-
-\item[\CODE{\string~}] Représente le répertoire racine de
- l'utilisateur.
-
-\item[\CODE{\char`\{...\char`\}}] Expansion par les accolades,
- par exemple \verb+a{1,2}b+ devient \verb+a1b:a2b+.
-
-\item[\CODE{//}] La recherche concernera aussi les sous-répertoires
- (peut être inséré n'importe où dans un chemin sauf au début).
-
-\item[\CODE{\%}] Début d'un commentaire.
-
-\item[\CODE{\bs}] Caractère de continuation de ligne (permet les
- entrées sur plusieurs lignes).
-
-\item[\CODE{!!}] Cherche \emph{seulement} dans la base de
- données pour localiser le fichier et \emph{ne cherche pas} sur le disque.
-
-\end{ttdescription}
-
-\subsection{Les bases de données}
-\label{sec:filename-database}
-
-\KPS{} a une certaine profondeur d'investigation pour minimiser les
-accès disque durant les recherches. Néanmoins, dans le cas de
-distributions comprenant beaucoup de répertoires, inspecter chaque
-répertoire possible pour un fichier donné peut durer excessivement
-longtemps (ceci est typiquement le cas quand plusieurs centaines de
-répertoires de polices de caractères doivent être parcourus). En
-conséquence, \KPS{} peut utiliser un fichier texte appelé \file{ls-R} --- en
-fait une base de données construite au préalable --- qui fait correspondre
-les fichiers à leur répertoire, ce qui permet d'éviter une recherche
-exhaustive sur le disque.
-
-Un deuxième fichier appelé \file{aliases} (qui est également une base de
-données) permet de donner des noms différents aux fichiers listés dans
-\mbox{\file{ls-R}}. Ceci peut aider à adapter ses fichiers source aux
-conventions de \acro{DOS}~8.3 pour les noms de fichiers.
-
-\subsubsection{Le fichier base de données}
-\label{sec:ls-R}
-
-Comme nous l'avons expliqué ci-dessus, le nom du principal fichier-base de
-données doit être \mbox{\file{ls-R}}.
-Dans votre installation, vous pouvez en mettre un à la racine de chaque
-arborescence \TeX{} que vous désirez voir
-inspecter (\code{\$TEXMF} par défaut) ; la plupart des sites ont
-une seule arborescence \TeX{}. \KPS{} cherche les fichiers \file{ls-R}
-dans le chemin spécifié dans la variable \code{TEXMFDBS}.
-
-La meilleure façon de créer et mettre à jour le fichier \file{ls-R}
-est d'exécuter le script \cmdname{mktexlsr} inclus dans la
-distribution. Il est appelé par les divers scripts \cmdname{mktex}\dots\
-En principe, ce script exécute uniquement la commande
-%cd \var{/your/texmf/root} && \path|\|ls -1LAR ./ >ls-R|
-% Remplacé (df) car \path|...| plante à cause de \let\path\url.
-\begin{alltt}
-cd \var{/your/texmf/root} && \boi{}ls -1LAR ./ >ls-R
-\end{alltt}
-en supposant que la commande \code{ls} de votre système produise le bon
-format de sortie (le \code{ls} de \GNU convient
-parfaitement). Pour s'assurer que la base de données est toujours à
-jour, le meilleur moyen est de la reconstruire en utilisant la table
-des \code{cron}, de telle façon que le fichier \file{ls-R} prenne
-automatiquement en compte les changements dans les fichiers
-installés, par exemple après une installation ou une
-mise à jour d'un composant \LaTeX{}.
-
-Si un fichier n'est pas trouvé dans la base de données, par défaut
-\KPS{} décide de le chercher sur le disque. Par contre, si un élément du
-chemin commence par \samp{!!}, \emph{seule} la base de données
-sera inspectée pour cet élément, jamais le disque.
-
-\subsubsection{kpsewhich : programme de recherche dans une arborescence}
-\label{sec:invoking-kpsewhich}
-
-Le programme \texttt{kpsewhich} effectue une recherche dans une
-arborescence indépendamment de toute application. On peut le
-considérer comme une sorte de \code{find} pour localiser des fichiers
-dans les arborescences \TeX{} (ceci est largement utilisé dans les
-scripts \cmdname{mktex}\dots\ de la distribution).
-
-\begin{alltt}
-> \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}}
-\end{alltt}
-Les options spécifiées dans \ttvar{option} peuvent
-commencer soit par \samp{-} soit par \samp{-{}-} ; n'importe quelle
-abréviation claire est acceptée.
-
-\KPS{} considère tout argument non optionnel dans la ligne de commande
-comme un nom de fichier et renvoie la première occurrence trouvée. Il
-n'y a pas d'option pour renvoyer tous les fichiers ayant un nom
-particulier (vous pouvez utiliser le \cmdname{find} d'Unix pour cela).
-
-Les options les plus importantes sont décrites ci-après.
-
-\begin{ttdescription}
-\item[\texttt{-{}-dpi=\var{num}}]\mbox{} \\
- Définit la résolution à \ttvar{num} ; ceci affecte
- seulement la recherche des fichiers \samp{gf} et \samp{pk}. \samp{-D} est un
- synonyme pour assurer la compatibilité avec \cmdname{dvips}. Le défaut
- est 600.
-\item[\texttt{-{}-format=\var{name}}]\mbox{}\\
- Définit le format pour la recherche à \ttvar{name}.
- Par défaut, le format est estimé en fonction du nom de fichier.
- Pour les formats qui n'ont pas de suffixe clair associé, comme les
- fichiers de support \MP{} et les fichiers de configuration
- \cmdname{dvips}, vous devez spécifier le nom connu de \KPS, comme
- \texttt{tex} ou \texttt{enc files}. Exécutez la commande
- \texttt{kpsewhich -{}-help} pour obtenir la liste précise.
-
-\item[\texttt{-{}-mode=\var{string}}]\mbox{}\\
- Définit le nom du mode comme étant \ttvar{string} ;
-ceci affecte seulement la recherche des \samp{gf} et des \samp{pk}.
-Pas d'option par défaut, n'importe quel mode sera trouvé.
-\item[\texttt{-{}-must-exist}]\mbox{}\\
- Fait tout ce qui est possible pour trouver les fichiers, ce qui
-inclut une recherche sur le disque. Par défaut, seule la base de
-données \file{ls-R} est inspectée, dans un souci d'efficacité.
-\item[\texttt{-{}-path=\var{string}}]\mbox{}\\
- Recherche dans le chemin \ttvar{string} (séparé par
-deux-points comme d'habitude), au lieu de prendre le chemin à partir
-du nom de fichier. \samp{//} et toutes les expansions habituelles sont
-supportées.
- Les options \samp{-{}-path} et \samp{-{}-format} s'excluent mutuellement.
-\item[\texttt{-{}-progname=\var{name}}]\mbox{}\\
- Définit le nom de programme comme étant \ttvar{name}.
- Ceci peut affecter les chemins de recherche via l'option
- \texttt{.\var{progname}} dans les fichiers de configuration.
- Le défaut est \cmdname{kpsewhich}.
-\item[\texttt{-{}-show-path=\var{name}}]\mbox{}\\
- Montre le chemin utilisé pour la recherche des fichiers de type
-\ttvar{name}.
- On peut utiliser soit une extension de fichier (\code{.pk}, \code{.vf},
- etc.), soit un nom de fichier, comme avec l'option \samp{-{}-format}.
-\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\
- Définit les options de débogage comme étant
- \ttvar{num}.
-\end{ttdescription}
-
-\subsubsection{Exemples d'utilisation}
-\label{sec:examples-of-use}
-
-Jetons un coup d'œil à \KPS{} en action ; voici une recherche
-toute simple :
-
-\begin{alltt}
-> \Ucom{kpsewhich article.cls}
-/usr/local/texmf-dist/tex/latex/base/article.cls
-\end{alltt}
-Nous recherchons le fichier \file{article.cls}. Puisque le suffixe
-\file{.cls} est non-ambigu, nous n'avons pas besoin de spécifier que
-nous voulons rechercher un fichier de type \optname{tex} (répertoires des
-fichiers sources de \TeX{}). Nous le trouvons dans le sous-répertoire
-\filename{tex/latex/base} du répertoire racine \samp{TEXMF}. De même,
- le suffixe non-ambigu permet de trouver facilement les autres fichiers.
-\begin{alltt}
-> \Ucom{kpsewhich array.sty}
- /usr/local/texmf-dist/tex/latex/tools/array.sty
-> \Ucom{kpsewhich latin1.def}
- /usr/local/texmf-dist/tex/latex/base/latin1.def
-> \Ucom{kpsewhich size10.clo}
- /usr/local/texmf-dist/tex/latex/base/size10.clo
-> \Ucom{kpsewhich small2e.tex}
- /usr/local/texmf-dist/tex/latex/base/small2e.tex
-> \Ucom{kpsewhich tugboat.bib}
- /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-Le dernier exemple est une base de données bibliographiques pour \BibTeX{}
-servant aux articles de \textsl{TUGBoat}.
-
-\begin{alltt}
-> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
-Les fichiers de glyphes de fontes bitmaps, de type
-\file{.pk}, sont
-utilisés pour l'affichage par des programmes comme \cmdname{dvips} et
-\cmdname{xdvi}. Rien n'est renvoyé dans ce cas puisque il n'y a pas
-de fichiers Computer Modern \file{.pk} pré-créés sur nos systèmes
-(nous utilisons les versions type~1 du \TL{}).
-\begin{alltt}
-> \Ucom{kpsewhich wsuipa10.pk}
-\ifSingleColumn
- /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
-\else /usr/local/texmf-var/fonts/pk/ljfour/public/
-... wsuipa/wsuipa10.600pk
-\fi\end{alltt}
-Pour ces fontes (alphabet phonétique de l'université Washington),
-nous avons dû créer les fichiers \file{.pk} et, puisque le mode \MF{} par
-défaut sur notre installation est \texttt{ljfour} avec une résolution de
-base de 600\dpi{} \textit{(dots per inch)}, cette instance est trouvée.
-\begin{alltt}
-> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
-\end{alltt}
-Dans ce cas, lorsque l'on spécifie que nous recherchons une
-résolution de 300\dpi{} (\texttt{-dpi=300}) nous voyons qu'aucune fonte
-pour cette résolution n'est disponible dans le système. En fait, un
-programme comme \cmdname{dvips} ou \cmdname{xdvi} ne s'en
-préoccuperait pas et créerait les fichiers \file{.pk} à la
-résolution demandée en utilisant le script \cmdname{mktexpk}.
-
-Intéressons-nous à présent aux fichiers d'en-tête et de configuration
-pour \cmdname{dvips}.
-Regardons en premier le fichier \file{tex.pro} communément utilisé
-pour le support de \TeX{} avant de regarder le fichier
-de configuration générique (\file{config.ps}) et la liste des fontes
-\PS{} \file{psfonts.map}. Depuis l'édition 2004, les fichiers
-\file{.map} et les fichiers de codage ont changé de place dans
-l'arborescence \dirname{texmf}. Comme le suffixe \file{.ps} est
-ambigu, nous devons spécifier quel type particulier du fichier
-\texttt{config.ps} nous considérons (\optname{dvips config}).
-\begin{alltt}
-> \Ucom{kpsewhich tex.pro}
- /usr/local/texmf/dvips/base/tex.pro
-> \Ucom{kpsewhich -{}-format="dvips config" config.ps}
- /usr/local/texmf-var/dvips/config/config.ps
-> \Ucom{kpsewhich psfonts.map}
- /usr/local/texmf-var/fonts/map/dvips/updmap/psfonts.map
-\end{alltt}
-
-Regardons plus en détail les fichiers de support Times
-\PS{} d'\acro{URW}. Leur nom standard dans le schéma de nommage des fontes
-est \samp{utm}. Le premier fichier que nous voyons est le
-fichier de configuration, qui contient le nom du fichier
-de la liste :
-\begin{alltt}
-> \Ucom{kpsewhich -{}-format="dvips config" config.utm}
- /usr/local/texmf-dist/dvips/psnfss/config.utm
-\end{alltt}
-Le contenu de ce fichier est
-\begin{alltt}
- p +utm.map
-\end{alltt}
-qui pointe vers le fichier \file{utm.map}, que nous cherchons à
-localiser ensuite.
-\begin{alltt}
-> \Ucom{kpsewhich utm.map}
- /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
-\end{alltt}
-Ce fichier liste les noms des fichiers des
-fontes \PS{} de type~1 dans la collection URW. Son contenu
-ressemble à (nous ne montrons qu'une partie des lignes) :
-\begin{alltt}
-utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
-utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
-utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
-Prenons par exemple le cas de Times Roman \file{utmr8a.pfb} et
-trouvons sa position dans l'arborescence \file{texmf} en utilisant une
-recherche applicable aux fichiers de fontes de type~1 :
-\begin{alltt}
-> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
-\else /usr/local/texmf-dist/fonts/type1/
-... urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
-Il devrait être clair, d'après ces quelques exemples, qu'il est facile
-de trouver l'endroit où se cache un fichier donné. C'est
-particulièrement important si vous suspectez que c'est, pour une
-raison quelconque, une mauvaise version du fichier qui est utilisée,
-puisque \cmdname{kpsewhich} va vous montrer le premier fichier
-trouvé.
-
-\subsubsection{Opérations de débogage}
-\label{sec:debugging}
-
-Il est quelquefois nécessaire de savoir comment un programme référence
-les fichiers. Pour permettre cela, \KPS{} offre
-plusieurs niveaux de débogage :
-\begin{ttdescription}
-\item[\texttt{\ 1}] Appels à \texttt{stat} (test d'existence de fichier). Lors d'une
- exécution utilisant une base de données \file{ls-R} à jour, ce niveau
- ne devrait donner presque aucune information en sortie.
-\item[\texttt{\ 2}] Références aux différentes tables (comme la base
- de données \file{ls-R}, les fichiers de correspondance de fontes, les fichiers de
- configuration).
-\item[\texttt{\ 4}] Opérations d'ouverture et de fermeture des
- fichiers.
-\item[\texttt{\ 8}] Information globale sur la localisation des types
- de fichiers recherchés par \KPS. Ceci est utile pour trouver où a été
- défini le chemin particulier pour un fichier.
-\item[\texttt{16}] Liste des répertoires pour chaque élément du
- chemin (utilisé uniquement en cas de recherche sur le disque).
-\item[\texttt{32}] Recherche de fichiers.
-\item[\texttt{64}] Valeur des variables.
-\end{ttdescription}
-Une valeur de \texttt{-1} activera toutes les options ci-dessus ; en
-pratique, c'est habituellement la valeur la plus adaptée.
-
-De la même façon, avec le programme \cmdname{dvips}, en utilisant une
-combinaison d'options de débogage, on peut suivre en détail la
-localisation des
-différents fichiers. De plus, lorsqu'un fichier n'est
-pas trouvé, la trace du débogage montre les différents répertoires dans
-lesquels le programme va chercher tel ou tel fichier, donnant ainsi
-des indices sur le problème.
-
-Généralement, comme la plupart des programmes appellent la
-bibliothèque \KPS{} en interne, on peut sélectionner une option de
-débogage en utilisant la variable d'environnement
-\envname{KPATHSEA\_DEBUG} et en la définissant égale à la valeur (ou
-à une combinaison de valeurs) décrite(s) dans la liste ci-dessus.
-
-Note à l'intention des utilisateurs de Windows : il n'est pas facile
-de rediriger les messages d'erreur vers un fichier sur ces
-systèmes. À des fins de diagnostic, vous pouvez temporairement
-affecter \texttt{KPATHSEA\_DEBUG\_OUTPUT=err.log} pour capturer le flux
-standard d'erreur dans le fichier \texttt{err.log}.
-
-Considérons comme exemple un petit fichier source \LaTeX{},
-\file{hello-world.tex}, dont le contenu est le suivant.
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
-Ce petit fichier utilise simplement la fonte \file{cmr10}, aussi
-allons voir comment \cmdname{dvips} prépare le fichier \PS{}
-(nous voulons utiliser la version type~1
-des fontes Computer Modern, d'où l'option \texttt{-Pcms}).
-\begin{alltt}
-> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
-Dans ce cas, nous avons combiné le niveau 4 de débogage de
-\cmdname{dvips} (chemins des fontes) avec l'option d'expansion des
-éléments du chemin de \KPS\ (voir \cmdname{dvips} Reference Manual,
-\OnCD{texmf/doc/html/dvips/dvips_toc.html} sur le \DVD{}).
-La sortie (légèrement formatée) apparaît dans la
-figure~\ref{fig:dvipsdbga}.
-\begin{figure*}[tp]
-\centering
-\input{examples/ex6a.tex}
-\caption{Recherche des fichiers de configuration}\label{fig:dvipsdbga}
-
-\bigskip
-
-\input{examples/ex6b.tex}
-\caption{Recherche du fichier prolog}\label{fig:dvipsdbgb}
-
-\bigskip
-
-\input{examples/ex6c.tex}
-\caption{Recherche du fichier de fontes}\label{fig:dvipsdbgc}
-\end{figure*}
-
-\cmdname{dvips} commence par localiser ses fichiers de
-fonctionnement. D'abord, \file{texmf.cnf} est trouvé, ce qui donne les
-définitions pour les chemins de recherche servant à localiser les
-autres fichiers, ensuite le fichier base de données \file{ls-R} (pour
-optimiser la recherche des fichiers) et le fichier \file{aliases}, qui
-permet de déclarer plusieurs noms (par exemple un nom \acro{DOS} de type
-8.3 court et une version longue plus naturelle) pour le même
-fichier. Ensuite \cmdname{dvips} continue en cherchant le fichier de
-configuration générique \file{config.ps} avant de rechercher le fichier
-de paramétrisation \file{.dvipsrc} (qui, dans notre cas, \emph{n'est
-pas trouvé}). Enfin, \cmdname{dvips} localise le fichier de
-configuration pour les fontes \PS{} Computer Modern
-\file{config.cms} (ceci est lancé par l'option \mbox{\texttt{-Pcms}} de la
-commande \cmdname{dvips}). Ce fichier contient la liste des fichiers
- qui définissent la relation entre les noms des fontes
-selon \TeX{}, selon \PS{} et dans le système de fichiers.
-\begin{alltt}
-> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
- p +ams.map
- p +cms.map
- p +cmbkm.map
- p +amsbkm.map
-\end{alltt}
-\cmdname{dvips} veut chercher tous ces fichiers, y compris le
-fichier générique d'association \file{psfonts.map}, qui est toujours
-chargé (il contient des déclarations pour les fontes \PS{} les
-plus communément utilisées ; voir la dernière partie de la Section
-\ref{sec:examples-of-use} pour plus de détails sur la gestion du fichier
-d'association \PS{}).
-
-Arrivé là, \cmdname{dvips} s'identifie à l'utilisateur :
- \begin{alltt}
- This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com)
- \end{alltt}
-
-\ifSingleColumn
-pour continuer ensuite en cherchant le fichier prologue \file{texc.pro},
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
-pour continuer ensuite en cherchant le fichier prologue \file{texc.pro}
-(voir la figure~\ref{fig:dvipsdbgb}).
-\fi
-
-Après avoir trouvé ce fichier, \cmdname{dvips} affiche la date et
-l'heure, nous informe qu'il va générer le fichier
-\file{hello-world.ps} puis qu'il a besoin du fichier de fonte
-\file{cmr10} et que ce dernier est déclaré comme « résident»
-(pas besoin de bitmaps) :
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
-Maintenant la recherche concerne le fichier \file{cmr10.tfm}, qui est
-trouvé, puis quelques fichiers de prologue de plus (non montrés) sont
-référencés ; finalement le fichier de la fonte type~1 \file{cmr10.pfb}
-est localisé et inclus dans le fichier de sortie (voir la dernière ligne).
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-\subsection{Options à l'exécution}
-
-\Webc{} offre la possibilité de contrôler à l'exécution bon nombre de
-paramètres concernant la mémoire (en particulier la taille des
-tableaux utilisés) à partir du fichier
-\file{texmf.cnf} qui est lu par \KPS.
-Les paramètres en question se trouvent
-dans la troisième partie du fichier inclus dans la distribution \TL{}.
- Les variables les plus importantes sont :
-\begin{ttdescription}
-\item[\texttt{main\_memory}]
- Nombre total de mots mémoire disponibles pour
- \TeX{}, \MF{} et \MP. Vous devez générer un nouveau fichier de
- format pour chaque nouveau paramétrage. Par exemple, vous pouvez
- générer une version large de \TeX{} et appeler le fichier de format
- \texttt{hugetex.fmt}. En utilisant la méthode supportée par \KPS{}
- qui consiste à suffixer la variable par le nom du programme, la valeur
- particulière de la variable \texttt{main\_memory} destinée à ce
- fichier de format sera lue dans le fichier \file{texmf.cnf}.
-\item[\texttt{extra\_mem\_bot}]
- Espace supplémentaire pour certaines structures de données de \TeX{} :
- boîtes, \textit{glue}, points d'arrêt\dots{} Surtout utile si vous utilisez
- \PiCTeX{} par exemple.
-\item[\texttt{font\_mem\_size}]
- Nombre de mots mémoire disponibles pour décrire les polices. C'est
- plus ou moins l'espace occupé par les fichiers \acro{TFM} lus.
-\item[\texttt{hash\_extra}]
- Espace supplémentaire pour la table de hachage des noms de séquences
- de contrôle. Environ 10~000 de ces noms peuvent être stockés dans la
- table principale ; si vous avez un document très volumineux avec
- beaucoup de références croisées, il se peut que ce ne soit pas
- suffisant. La valeur par défaut \texttt{hash\_extra} est \texttt{50000}.
-\end{ttdescription}
-
-\noindent Évidemment, cette possibilité ne remplace pas une véritable
-allocation dynamique des tableaux et de la mémoire mais puisque c'est
-complexe à implémenter dans le présent source \TeX{}, ces paramètres lus
-à l'exécution fournissent un compromis pratique qui procure une certaine
-souplesse.
-
-\section{Installation sur un nouveau système Unix}
-
-Si vous avez un système Unix ne correspondant à aucun des exécutables
-fournis, il faut compiler vous-même \TeX{} et tous ses programmes
-satellites à partir des sources. Cela n'est pas aussi difficile qu'il
-y paraît. Tout ce dont vous aurez besoin est contenu dans le
-répertoire \texttt{source} qui se trouve sur le \DVD.
-
-\subsection{Prérequis}
-
-Il faut au moins 400\,Mo d'espace sur disque pour compiler la
-totalité de \TeX{} et des programmes associés.
-Vous aurez aussi besoin d'un
-compilateur C \acro{ANSI}, de l'utilitaire \cmdname{make},
-d'un générateur d'analyseur lexical et d'un générateur d'analyseur
-syntaxique. Nous recommandons les versions \GNU des programmes suivants
-(\cmdname{gcc}, \GNU{}\cmdname{make}, \cmdname{m4},
-\cmdname{flex}, \cmdname{bison}). Vous pouvez utiliser d'autres compilateurs C
-et d'autres programmes \cmdname{make} si vous maîtrisez
-correctement la programmation sous Unix pour résoudre les
-problèmes éventuels. La commande \texttt{uname} doit renvoyer une valeur
-raisonnable.
-
-\subsection{Configuration}
-
-Tout d'abord, effectuez l'installation normale de \TL{} sur le disque
-dur (voir section~\ref{sec:install},
-page~\pageref{sec:install}). Vous pouvez sauter l'installation de
-tous les binaires précompilés.
-Décompactez ensuite sur le disque le fichier
-\file{source.tar.bz2} (archive compressée) trouvé dans
-le répertoire \dirname{source} et placez-vous dans
-le répertoire où vous avez transféré l'ensemble.
-\begin{alltt}
-> \Ucom{cd /tmp/tl-source}
-> \Ucom{bunzip2 source.tar.bz2}
-> \Ucom{tar xf source.tar}
-\end{alltt}
-
-Lancez maintenant \textsf{configure} de la façon suivante :
-\begin{alltt}
-> \Ucom{sh configure -prefix=/usr/local/texlive/2007}
-\end{alltt}
-
-Le répertoire \optname{-prefix} est le répertoire de base de
-l'arborescence \TL{}, il est désigné par \var{TEXDIR} dans la suite.
-\begin{comment}
-Les répertoires utilisés sont les suivants :
-
-\noindent
-\begin{tabular}{>{\ttfamily}ll@{}}
- \dirname{$TEXDIR/texmf-dist} & répertoire de base pour les fontes,
- macros, etc\\
- \dirname{$TEXDIR/man} & pages du manuel Unix\\
- \dirname{$TEXDIR/info} & manuels \GNU en format Info\\
- \dirname{$TEXDIR/bin/$archname} & exécutables.\\
-\end{tabular}\\
-\end{comment}
-%$
-
-Si vous ne voulez pas créer de répertoire \dirname{$archname} spécifique %$
-au système choisi pour stocker les exécutables (c.-à-d. les
-copier directement dans \dirname{$TEXDIR/bin}), %$
-il faut exécuter \textsf{configure} avec l'option \\
-\verb|--disable-multiplatform|.
-
-Tapez \verb|./configure --help|, le programme affichera
-les options supplémentaires disponibles (telles que supprimer l'installation
-des extensions optionnelles comme \OMEGA\ ou \eTeX).
-
-\subsection{Exécuter \textsf{make}}
-S'assurer que la variable ou l'option \texttt{noclobber} n'est pas définie.
- et lancer le \cmdname{make} à la racine de l'arborescence de la façon
-suivante :
-\begin{alltt}
->> \Ucom{make world}
-\end{alltt}
-et aller prendre un café\dots
-
-Il peut être utile de garder une trace complète dans un fichier log en tapant :
-\begin{alltt}
->> \Ucom{sh -c "make world >world.log 2>\&1" \&}
-\end{alltt}
-Avant de conclure que tout va bien, vérifier que le fichier log ne contient
-pas de message d'erreur : le \cmdname{make} de \GNU renvoie toujours
-le message \samp{***} à chaque erreur d'exécution. Vérifier aussi que
-tous les exécutables ont été créés.
-\begin{alltt}
->> \Ucom{cd \var{TEXDIR}/bin/\var{archname}}
->> \Ucom{ls | wc}
-\end{alltt}
-Le résultat doit être supérieur à 200 (on peut tester le nombre exact
-dans le répertoire \dirname{bin} de la distribution).
-
-Si vous avez besoin de droits spéciaux pour exécuter \texttt{make install},
-vous pouvez séparer \samp{make world} en deux processus différents :
-\begin{alltt}
->> \Ucom{make all}
->> \Ucom{su}
->> \Ucom{make install strip}
-\end{alltt}
-
-Après avoir installé vos nouveaux binaires, il faut suivre les procédures
-normales de la post-installation, indiquées dans la
-section~\ref{sec:postinstall}, page~\pageref{sec:postinstall}.
-
-\section{Remerciements}
-
-\TL{} est le résultat des efforts
-collectifs de pratiquement tous les groupes d'utilisateurs de \TeX.
-La présente édition de \TL{} a été coordonnée par Karl Berry.
-Voici la liste des principaux contributeurs :
-
-\begin{itemize}
-
-\item Les associations d'utilisateurs anglais, allemands, néerlandais et
- polonais (\acro{TUG}, \acro{DANTE} e.V., \acro{NTG}, and \acro{GUST},
- respectivement) qui contribuent ensemble à l'infrastructure technique et
- administrative. Soutenez votre association locale (voir la liste
- \url{http://tug.org/usergroups.html}) !
-
-\item L'équipe du \acro{CTAN}, en particulier Robin Fairbairns, Jim Hef{}feron
- et Rainer Schöpf, qui distribue les images des distributions \TL{} et
- fournit les sites d'hébergement pour le stockage et la mise à jour des
- extensions qui sont la base de \TL.
-
-\item Peter Breitenlohner et toute l'équipe \eTeX{} qui construisent
- les bases des successeurs de \TeX.
-
-\item Thomas Esser et sa merveilleuse distribution \teTeX{} sans laquelle
- \TL{} n'aurait jamais vu le jour.
-
-\item Michel Goossens, en tant que co-auteur de la documentation initiale.
-
-\item Eitan Gurari, dont le programme \TeX4ht a été utilisé pour créer la
- version \HTML{} de cette documentation et qui travaille inlassablement à
- l'améliorer, ce dans des délais très courts.
-
-\item \Thanh, Martin Schr\"oder et toute l'équipe pdf\TeX\ qui continuent
- inlassablement à étendre les performances de \TeX.
-
-\item Hans Hagen qui, outre sa participation active aux tests, a adapté le
- format \ConTeXt\ (\url{http://pragma-ade.com}) aux besoins de \TL{}.
-
-\item Hartmut Henkel, pour ses contributions au développement
- de pdf\TeX{} et Lua\TeX{} entre autres.
-
-\item Taco Hoekwater, pour ses efforts sans cesse renouvelés à l'amélioration
- de MetaPost et de (Lua)\TeX\ (\url{http://luatex.org}).
-
-\item Pawe{\l} Jackowski pour l'installeur Windows \cmdname{tlpm} et Tomasz
- {\L}uczak pour la version graphique \cmdname{tlpmgui} utilisée dans
- l'édition précédente.
-
-\item Akira Kakuto, pour son aide précieuse qui nous a permis
- d'intégrer dans \TL{} les binaires Windows de sa distribution \acro{W32TEX}
- (\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}).
-
-\item Jonathan Kew et \acro{SIL}, pour avoir produit
- Xe\TeX{}, pour l'avoir intégré dans \TL{} et pour avoir
- créé la première version de l'installeur Mac\TeX.
-
-\item Dick Koch, pour la maintenance de Mac\TeX\ (\url{http://tug.org/mactex})
- faite en symbiose avec \TL.
-
-\item Reinhard Kotucha, pour ses contributions majeures à l'infrastructure de
- \TL{} 2008 et à son programme d'installation, pour ses contributions sous
- Windows et pour son script \texttt{getnonfreefonts} en particulier.
-
-\item Siep Kroonenberg, également pour ses contributions majeures à
- l'infrastructure de \TL{} 2008 et à son programme d'installation ainsi que
- pour la réécriture de cette documentation.
-
-\item Petr Ol\v{s}ak, qui coordonna et vérifia minutieusement toute la
- partie tchèque et slovaque.
-
-\item Toshio Oshima, pour le visualisateur \cmdname{dviout} pour Windows.
-
-\item Manuel Pégourié-Gonnard, pour son aide concernant le programme de mise à
- jour de la distribution, la documentation et pour le développement de
- \cmdname{tldoc}.
-
-\item Fabrice Popineau, pionnier du développement de \TL{} sous Windows et
- pour son travail sur la documentation française.
-
-\item Norbert Preining, principal architecte de la distribution \TL{} 2008 et
- de son installeur et coordinateur (avec Frank K\"uster) de la
- version Debian de \TL.
-
-\item Sebastian Rahtz, qui a créé la distribution \TL{} et en a assuré la
- maintenance pendant de nombreuses années.
-
-\item Vladimir Volovich, pour son aide substantielle, en particulier pour
- avoir rendu possible l'intégration de \cmdname{xindy} dans \TL.
-
-\item Staszek Wawrykiewicz, principal testeur de \TL{} et coordinateur des
- contributions polonaises (fontes, installation Windows, etc.).
-
-\item Olaf Weber, pour son patient assemblage de \Webc.
-
-\item Gerben Wierda, qui a créé et maintient la partie \MacOSX{}
- et qui participe activement aux tests.
-
-\item Graham Williams, pour son travail sur le catalogue \TeX\ des
- composants.
-
-\end{itemize}
-
-Les binaires ont été compilés par :
-Tigran Aivazian (\pkgname{x86\_64-linux}),
-Tim Arnold (\pkgname{hppa-hpux}),
-Randy Au (\pkgname{amd64-freebsd}),
-Edd Barrett (\pkgname{i386-openbsd}),
-Karl Berry (\pkgname{i386-linux}),
-Akira Kakuto (\pkgname{win32}),
-Dick Koch (\pkgname{universal-darwin}),
-Manfred Lotz (\pkgname{i386-freebsd}),
-Norbert Preining (\pkgname{alpha-linux}),
-Arthur Reutenauer (\pkgname{sparc-linux}),
-Thomas Schmitz (\pkgname{powerpc-linux}),
-Apostolos Syropoulos (\pkgname{i386-solaris}),
-Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-solaris}),
-Olaf Weber (\pkgname{mips-irix}).
-
-Documentation et mises à jour des traductions :
-Karl Berry (anglais),
-Daniel Flipo (français),
-Klaus H\"oppner (allemand),
-Petr Sojka \& Jan Busa (tchèque et slovaque),
-Boris Veytsman (russe),
-Staszek Wawrykiewicz (polonais).
-
-La page d'accueil de la documentation \TL{} est
-\url{http://tug.org/texlive/doc.html}.
-
-Bien sûr, notre gratitude va en premier lieu à Donald Knuth pour avoir
-inventé \TeX{} et l'avoir offert au monde entier.
-
-\section{Historique des versions successives}
-\label{sec:history}
-
-\subsection{Les éditions précédentes}
-
-La discussion commença à la fin de 1993 quand le Groupe des Utilisateurs
-Néerlandais de \TeX{} commençait à travailler à son \CD{} 4All\TeX{} pour les
-utilisateurs de \acro{MS-DOS} et on espérait à ce moment sortir un \CD{}
-unique pour tous les systèmes. C'était un objectif beaucoup trop ambitieux
-mais il permit la naissance du \CD{} 4All\TeX{}, projet couronné de succès et
-aussi d'un groupe de travail « \acro{TUG} Technical Council » pour
-mettre en place TDS (\emph{\TeX{} Directory Structure} :
-\url{http://tug.org/tds}), qui spécifiait la gestion des fichiers \TeX{} sous
-une forme logique. La mouture finale de \TDS{} fut publiée dans le numéro de
-décembre 1995 de \textsl{TUGboat} et il était clair depuis un certain temps
-qu'il fallait proposer un produit contenant une structure modèle sur \CD{}.
-La distribution que vous possédez est le résultat direct des délibérations de
-ce groupe de travail. Il était également clair que le succès des \CD{}
-4All\TeX{} démontrait que les utilisateurs d'Unix trouveraient leur bonheur
-avec une distribution aussi simple et ceci a été l'autre objectif de
-\TL.
-
-Nous avons d'abord entrepris de créer un nouveau \CD{} \TDS{} Unix à l'automne
-1995 et nous avons rapidement choisi \teTeX{} de Thomas Esser comme étant la
-configuration idéale, car il supportait déjà plusieurs plates-formes et avait
-été construit en gardant à l'esprit la portabilité entre systèmes. Thomas
-accepta de nous aider et commença à travailler sérieusement au début de 1996.
-La première édition sortit en mai 1996. Au début de 1997, Karl Berry acheva
-une nouvelle distribution de \Webc{}, qui incluait presque toutes les
-caractéristiques que Thomas Esser avait ajoutées dans \teTeX{} et il fut décidé
-de baser la deuxième édition du \CD{} sur le standard \Webc, en y ajoutant le
-script \texttt{texconfig} de \teTeX. La troisième édition du \CD{} était
-basée sur une version majeure de \Webc, 7.2, par Olaf Weber ; en même temps,
-une nouvelle version révisée de \teTeX{} était achevée dont \TL{} partageait
-presque toutes les caractéristiques. La quatrième édition a suivi le même
-schéma, en utilisant une nouvelle version de \teTeX{} et une nouvelle version
-de \Webc{} (7.3). Le système incluait dorénavant un programme complet
-d'installation pour Windows.
-
-Pour la cinquième édition (mars 2000), de nombreuses parties du \CD{}
-ont été vérifiées et révisées, des centaines de composants
-mis à jour.
-Le contenu détaillé des composants était décrit par des
-fichiers XML. Mais le changement majeur de cette cinquième édition a
-été la suppression de tout logiciel non libre de droits.
-Tout ce qui se trouve dans \TL{} devait être compatible avec la licence
-Debian (\emph{Debian Free Software Guidelines} :
-\url{http://www.debian.org/intro/free}) ; nous avons
-fait de notre mieux pour vérifier les termes des licences de chaque
-composant et nous souhaiterions que toute erreur nous soit signalée.
-
-La sixième édition (juillet 2001) contient un grand nombre de mises à jour.
-Le changement majeur de cette version réside dans la refonte du
-processus d'installation : l'utilisateur peut désormais choisir
-les collections de manière plus précise. Les collections concernant
-les langues ont été entièrement réorganisées, aussi le choix d'une
-langue installe non seulement les macros, les fontes, etc. mais
-prépare également un fichier \file{language.dat} adéquat.
-
-La septième édition (mai 2002) a comme ajout majeur une installation
-pour \MacOSX{} et l'habituelle myriade de mises à jour de composants et
-de programmes. Un objectif important a été de fusionner à
-nouveau les sources avec ceux de \teTeX{}, alors que les versions
-5 et 6 s'en étaient éloignées.
-
-\subsubsection{2003}
-
-En 2003, le flot de mises à jour et d'additions a continué mais nous
-avons constaté que \TL{} était devenu si volumineux qu'il ne
-pouvait plus tenir sur un seul \CD, aussi l'avons-nous divisé en trois
-distributions distinctes (voir section~\ref{sec:tl-coll-dists},
-page~\pageref{sec:tl-coll-dists}). Par ailleurs :
-\begin{itemize}
-\item À la demande de l'équipe \LaTeX{}, nous avons modifié les
- commandes standard \cmdname{latex} et \cmdname{pdflatex} pour
- qu'elles utilisent \eTeX{} (voir page~\pageref{text:etex}).
-\item Les nouvelles fontes Latin Modern sont disponibles (et
- recommandées).
-\item Le support pour Alpha \acro{OSF} a été supprimé
- (celui pour \acro{HPUX} l'avait été auparavant), car personne
- disposant des machines nécessaires ne s'est
- proposé pour compiler les nouveaux binaires.
-\item L'installation pour Windows a été largement modifiée ; un environnement
- de travail intégré basé sur \cmdname{XEmacs} a été introduit.
-\item Des programmes supplémentaires importants pour Windows (Perl,
- Ghost\-script, Image\-Magick, Ispell) sont maintenant installés dans le
- répertoire d'installation de \TL{}.
-\item Les fichiers \emph{font map} utilisés par \cmdname{dvips},
- \cmdname{dvipdfm} et \cmdname{pdftex} sont maintenant générés par le
- nouveau programme \cmdname{updmap} et installés dans
- \dirname{texmf/fonts/map}.
-\item Dorénavant, \TeX{}, \MF{} et \MP{} écrivent les caractères 8-bit
- présentés en entrée sans modification et non pas avec la notation
- \verb|^^|, que ce soit dans des fichiers (par la commande
- \verb|write|), dans les fichiers de trace (\verb|.log|) ou sur le
- terminal. Dans le \TL{}~7, l'écriture de ces caractères
- 8-bit était influencée par les paramètres de localisation du
- système; maintenant ces paramètres n'influent plus du tout sur le
- comportement des programmes \TeX{}. Si pour quelque raison que ce
- soit, vous avez besoin de la notation \verb|^^| en sortie,
- renommez le fichier \verb|texmf/web2c/cp8bit.tcx|. Les prochaines
- versions disposeront d'un moyen plus propre pour contrôler cette
- sortie.
-\item La documentation de \TL{} a été largement révisée.
-\item Enfin, comme la numérotation séquentielle des versions
- devenait peu maniable, il a été décidé d'identifier désormais la version
- de \TL{} par l'année : \TL{}~2003 au lieu de \TL{}~8.
-\end{itemize}
-
-
-\subsubsection{2004}
-
-2004 a apporté beaucoup de changements (et quelques incompatibilités avec les
-versions précédentes) :
-
-\begin{itemize}
-
-\item Si vous avez installé des fontes supplémentaires qui ont leur propre
-fichier \file{.map} ou des fichiers \file{.enc} spécifiques, vous
-devrez vraisemblablement déplacer ces fichiers.
-
-Les fichiers \file{.map} sont désormais recherchés uniquement dans les
-sous-répertoires \dirname{fonts/map} (dans chaque arborescence
-\filename{texmf}), leur chemin de recherche est donné par la variable
-\envname{TEXFONTMAPS} de \filename{texmf.cnf}.
-De même, les fichiers \file{.enc} sont désormais recherchés uniquement
-dans les sous-répertoires \dirname{fonts/enc}, leur chemin de recherche est
-donné par la variable \envname{ENCFONTS} de \filename{texmf.cnf}.
-Le script \cmdname{updmap} devrait émettre des messages d'avertissement
-pour les fichiers \file{.map} et \file{.enc} mal placés.
-
-Sur les différentes façons de traiter le problème, consulter
-\url{http://tug.org/texlive/mapenc.html}.
-
-\item La distribution pour Windows a changé cette année :
-l'installation de la distribution \fpTeX{} (basée sur \Webc{}) de Fabrice
-Popineau n'est plus proposée. À la place, vous pouvez tester et installer
-la distribution \ProTeXt{} basée sur \MIKTEX{} (indépendante de \Webc{}),
-voir section~\ref{sec:overview-tl}, page~\pageref{sec:overview-tl}.
-
-\item L'ancien répertoire \dirname{texmf} a été éclaté en trois parties :
-\dirname{texmf}, \dirname{texmf-dist} et \dirname{texmf-doc}. Voir
-section~\ref{sec:tld}, page~\pageref{sec:tld}.
-
-\item Tous les fichiers relatifs aux différents avatars de \TeX{} sont
-désormais regroupés dans le même sous-répertoire \dirname{tex} des
-arborescences \dirname{texmf*} (ils étaient jusqu'ici placés dans des
-sous-répertoires spécifiques \dirname{tex}, \dirname{etex},
-\dirname{pdftex}, \dirname{pdfetex}, etc.). Voir
-\OnCD{texmf-doc/doc/english/tds/tds.html\#Extensions}.
-
-\item Les scripts auxiliaires, normalement pas exécutés directement
-par les utilisateurs, sont regroupés dans un répertoire \dirname{scripts}
-des arborescences \dirname{texmf*}. On les localise grâce à la
-commande \verb|kpsewhich -format=texmfscripts|. Au cas où vous en
-auriez, les programmes utilisant ces scripts nécessiteront une adaptation.
-Voir \OnCD{texmf-doc/doc/english/tds/tds.html\#Scripts}.
-
-\item La plupart des formats affichent en clair (dans les fichiers
-\file{.log} en particulier) les caractères imprimables au lieu
-de les transcrire en notation hexadécimale \verb|^^|. Ceci se fait
-grâce au fichier \filename{cp227.tcx}, qui considère comme imprimables
-les caractères 32 à 256, ainsi que les tabulations et les changements
-de page (caractères 9 à 11). Les formats faisant exception sont
-plain \TeX\ (seuls les caractères 32 à 127 sont déclarés imprimables),
-\ConTeXt{} (0 à 255 imprimables) et les formats basés sur \OMEGA.
-Il y a peu de différence avec le comportement de \TL\,2003
-mais la mise en œuvre est plus propre et plus facilement configurable.
-Voir \OnCD{texmf/doc/web2c/web2c.html\#TCX-files}.
-Noter que l'utilisation du codage Unicode en entrée peut provoquer
-des affichages défectueux en sortie (TeX code sur un seul octet).
-
-\item Tous les formats, sauf plain \TeX, font appel au moteur
-\textsf{pdfetex} (qui produit bien sûr par défaut des fichiers \acro{DVI}
-lorsque le format choisi est \LaTeX). Ceci permet aux formats
-\LaTeX, \ConTeXt, etc., d'avoir accès aux fonctionnalités
-micro-typographiques de pdf\TeX{} (alignement optique des marges par exemple)
-et aux fonctionnalités de \eTeX{} (\OnCD{texmf-dist/doc/etex/base/}).
-
-Ceci rend \emph{indispensable} le recours à l'extension \pkgname{ifpdf}
-(qui fonctionne aussi bien avec plain que \LaTeX) pour déterminer si
-le format de sortie est \acro{DVI} ou \acro{PDF}. Tester si la commande
-\cs{pdfoutput} est définie ou non \emph{n'est pas} un moyen fiable
-de le faire.
-
-\item pdf\TeX\ (\url{http://pdftex.org}) offre de nouvelles fonctionnalités :
-
- \begin{itemize}
-
- \item Les commandes \cs{pdfmapfile} et \cs{pdfmapline} permettent
- de spécifier le choix des fichiers \file{.map} à utiliser
- pour le document en cours.
-
- \item L'amélioration du gris typographique par variation (infime) de la
- largeur des caractères (\textit{font expansion}) est plus facile à
- mettre en œuvre, voir
- \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}
-
- \item Le fichier \filename{pdftex.cfg} n'est plus utilisé.
- Toutes les affectations de paramètres doivent désormais être
- faites dans le préambule en utilisant les primitives ad~hoc.
-
- \item Pour plus d'informations, consulter le manuel de pdf\TeX\ :
- \OnCD{texmf/doc/pdftex/manual}.
-
- \end{itemize}
-
-\item La primitive \cs{input} de \cmdname{tex}, \cmdname{mf} et
-\cmdname{mpost}, accepte désormais les espaces et autres caractères
-spéciaux dans les noms de fichiers à condition d'utiliser des
-\textit{double quotes}, en voici deux exemples typiques :
-\begin{verbatim}
-\input "filename with spaces" % plain
-\input{"filename with spaces"} % latex
-\end{verbatim}
-Consulter le manuel \Webc{} pour plus d'informations : \OnCD{texmf/doc/web2c}.
-
-\item Les fonctionnalités de enc\TeX\ sont désormais incluses dans \Webc{}.
-Ainsi, tous les formats \emph{construits avec l'option \optname{-enc}} y ont
-accès. enc\TeX\ permet le transcodage en entrée et en sortie et
-l'utilisation transparente du codage Unicode \acro{UTF}-8. Voir
-\OnCD{texmf-dist/doc/generic/enctex/} et
-\url{http://www.olsak.net/enctex.html}.
-
-\item Un nouveau moteur combinant les fonctionnalités de \eTeX\
-et d'\OMEGA, appelé Aleph, est disponible. \OnCD{texmf-dist/doc/aleph/base}
-et \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}
-fournissent une information succincte. Le format \LaTeX{} utilisant
-Aleph s'appelle \textsf{lamed}.
-
-\item La licence \acro{LPPL} de \LaTeX\ (version décembre 2003) a changé,
-elle est désormais compatible avec les prescriptions Debian.
-Les autres changements sont décrits dans le fichier \filename{ltnews}, voir
-\OnCD{texmf-dist/doc/latex/base}.
-
-\item Un nouveau programme, \cmdname{dvipng}, qui convertit les fichiers
-\acro{DVI} en images \acro{PNG} a été ajouté. Voir
-\OnCD{texmf/doc/man/man1/dvipng.1}.
-
-\item Nous avons dû réduire le nombre de fontes incluses dans l'extension
-\pkgname{cbgreek}, ceci a été fait avec l'accord et l'aide de l'auteur
-(Claudio Beccari). Les fontes exclues (invisibles, transparentes, contours)
-sont rarement utilisées et la place nous manquait. La collection complète
-des fontes \pkgname{cbgreek} est disponible sur \acro{CTAN}
-(\url{http://www.ctan.org/tex-archive/fonts/greek/cb}).
-
-\item La commande \cmdname{oxdvi} a été supprimée, il suffit utiliser
-\cmdname{xdvi} à la place.
-
-\item Les commandes \cmdname{initex}, \cmdname{virtex} et leurs
-homologues pour \cmdname{mf} et \cmdname{mpost} ont disparu.
-Vous pouvez les recréer si nécessaire mais elles sont avantageusement
-remplacées, depuis des années maintenant, par l'option \optname{-ini}
-(\cmdname{tex} \optname{-ini} pour \cmdname{initex} et \cmdname{virtex}).
-
-\item Les binaires pour l'architecture \textsf{i386-openbsd} ont été
- supprimés par manque de volontaires pour les compiler.
-
-Sur \textsf{sparc-solaris} (au moins) il sera probablement
-nécessaire de positionner la variable d'environnement
-\envname{LD\_LIBRARY\_PATH} pour utiliser les programmes de la famille
-\pkgname{t1utils}. Ceci vient du fait qu'ils sont compilés en C++ et
-que l'emplacement des bibliothèques dynamiques est variable.
-Ce n'est pas une nouveauté 2004 mais ce point n'était pas documenté
-précédemment. De même, sur \textsf{mips-irix}, les bibliothèques dynamiques
-\acro{MIPS}pro 7.4 sont nécessaires.
-
-\end{itemize}
-
-\subsubsection{2005}
-
-2005 a apporté son lot habituel d'innombrables mises à jour d'extensions
-et de programmes. L'infrastructure est restée relativement stable par rapport
-à 2004, à quelques changements inévitables près :
-
-\begin{itemize}
-
-\item Trois nouveaux scripts \cmdname{texconfig-sys}, \cmdname{updmap-sys} et
- \cmdname{fmtutil-sys} ont été introduits ; ils agissent sur la
- configuration générale de la machine, comme le faisaient les
- scripts \cmdname{texconfig}, \cmdname{updmap} et \cmdname{fmtutil}
- jusqu'à l'an dernier. Les nouveaux scripts \cmdname{texconfig},
- \cmdname{updmap} et \cmdname{fmtutil} modifient maintenant
- la configuration \emph{personnelle} de l'utilisateur qui les lance ;
- le résultat est placé dans le répertoire personnel de l'utilisateur
- (sous \dirname{$HOME/.texlive2005}). %$
-
-\item De nouvelles variables, \envname{TEXMFCONFIG} (resp.
- \envname{TEXMFSYSCONFIG}) ont été introduites ; elles définissent
- les répertoires où doivent se trouver les fichiers de configuration de
- l'utilisateur (resp. de la machine), comme \filename{fmtutil.cnf} et
- \filename{updmap.cfg}. Les utilisateurs de fichiers de configuration
- locaux \filename{fmtutil.cnf} ou \filename{updmap.cfg} devront
- probablement les déplacer ; une autre possibilité est de modifier la
- définition des variables \envname{TEXMFCONFIG} ou
- \envname{TEXMFSYSCONFIG} dans \filename{texmf.cnf}. L'important est
- de s'assurer de la cohérence entre les définitions de ces variables
- dans \filename{texmf.cnf} et l'emplacement réel de ces fichiers.
- Voir section~\ref{sec:texmftrees}, page~\pageref{sec:texmftrees} pour
- la description des différentes arborescences texmf utilisées.
-
-\item L'an dernier nous avions rendu « \texttt{undefined} » certaines
- primitives propres à \cmdname{pdftex} (comme \verb|\pdfoutput|)
- dans les formats créés à partir de \cmdname{pdfetex} (\cmdname{latex}
- \cmdname{amstex}, \cmdname{context} par exemple)).
- C'était à titre transitoire, aussi cette année, ces primitives sont de
- nouveau définies dans tous les formats à base \cmdname{pdf(e)tex},
- \emph{même lorsqu'ils sont utilisés pour produire des fichiers
- \file{.dvi}}. Ceci implique qu'il vous faudra modifier vos
- documents qui utilisent le test \verb|\ifx\pdfoutput\undefined|
- pour déterminer si la sortie est en DVI ou en PDF. Le mieux est
- d'utiliser l'extension \pkgname{ifpdf.sty} et son test
- \verb|\ifpdf| qui fonctionne même en plain \TeX.
-
-\item L'an dernier nous avions fait en sorte que la plupart des formats
- impriment dans les sorties \file{.log} des caractères 8-bit
- lisibles à la place des notations hexadécimales \verb|^^|
- (voir section précédente).
- Le nouveau fichier TCX \filename{empty.tcx} permet
- de revenir facilement à la notation traditionnelle \verb|^^|, il suffit
- de coder :
-\begin{verbatim}
-latex --translate-file=empty.tcx fichier.tex
-\end{verbatim}
-
-\item Le nouveau programme \cmdname{dvipdfmx} est disponible pour convertir
- des fichier DVI en PDF ; ce programme remplace \cmdname{dvipdfm},
- toujours disponible mais dont l'usage est maintenant déconseillé.
-
-\item Les variables \envname{HOMETEXMF} et \envname{VARTEXMF} ont été renommées
- en \envname{TEXMFHOME} et \envname{TEXMFSYSVAR} respectivement pour
- raisons de cohérence avec les autres noms de variables. Il y a aussi
- \envname{TEXMFVAR} qui désigne maintenant un répertoire personnel
- de l'utilisateur (cf. le premier point de la présente liste).
-
-\end{itemize}
-
-\subsubsection{2006--2007}
-
-En 2006--2007, la nouveauté majeure a été l'arrivée dans \TL{} de Xe\TeX{}
-disponible sous forme de deux programmes \texttt{xetex} et \texttt{xelatex},
-voir \url{http://scripts.sil.org/xetex}.
-
-MetaPost a subi une mise à jour importante et d'autres améliorations
-sont prévues, voir \url{http://tug.org/metapost/articles}. Il en va de même
-pour pdf\TeX{}, voir \url{http://tug.org/applications/pdftex}.
-
-Le format \filename{tex.fmt} et les formats pour MetaPost and \MF\ ne
-se trouvent plus dans \dirname{texmf/web2c} mais dans des
-sous-répertoires de \dirname{texmf/web2c} (la recherche de fichiers
-\filename{.fmt} est néanmoins faite aussi dans \dirname{texmf/web2c}).
-Ces sous-répertoires portent le nom du moteur utilisé pour construire
-le format, par exemple \filename{tex}, \filename{pdftex} ou
-\filename{xetex}. Ce changement ne devrait pas avoir d'effet visible
-pour les utilisateurs.
-
-Le programme (plain) \texttt{tex} ignore désormais les lignes commençant
-par \texttt{\%\&} qui permettent de déterminer le format à utiliser ;
-c'est un vrai \TeX{} « à la Knuth » !
-\LaTeX\ et tous les autres prennent toujours en compte les lignes commençant
-par \texttt{\%\&}.
-
-Comme chaque année des centaines d'extensions et de programmes ont été mis à
-jour, voir les sites \acro{CTAN} (\url{http://www.ctan.org}).
-
-L'arborescence utilisée en interne a été réorganisée avec de nouveaux outils
-qui devraient fournir une meilleure base de travail pour les développements
-futurs.
-
-Enfin, en mai 2006 Thomas Esser a annoncé qu'il renonçait à poursuivre le
-développement de te\TeX{} (\url{http://tug.org/tetex}). Sa décision a relancé
-l'intérêt pour \TL, en particulier chez les distributeurs de solutions
-\GNU/Linux (un nouveau schéma d'installation \texttt{tetex} a été ajouté dans
-le script d'installation de \TL{} pour produire une distribution proche de
-l'ancienne te\TeX). La distribution \TL{} existe déjà sous forme de paquets
-Debian, espérons que les autres acteurs du monde Linux (RedHat, SuSe, etc.)
-suivront et que les utilisateurs se verront proposer à l'avenir des
-distributions \TeX{} riches et plus faciles à installer.
-
-Remarque finale : toutes les anciennes distributions \TL{} ainsi que les
-jaquettes des \CD{} correspondants sont disponibles ici :
-\url{ftp://tug.org/historic/systems/texlive}.
-
-\subsection{L'édition 2008}
-\label{tlcurrent}
-
-En 2008, l'infrastructure de la distribution \TL{} a été entièrement remaniée.
-Un nouveau fichier texte, \filename{tlpkg/texlive.tlpdb}, regroupe toutes les
-informations concernant la configuration \TL{} de la machine.
-
-Ce fichier permet entre autres choses de procéder à des mises à jour par le
-réseau après l'installation initiale. Cette possibilité était offerte depuis
-des années par MiK\TeX. Nous espérons pouvoir fournir des mises à jour
-régulières du contenu des archives \CTAN.
-
-Le nouveau moteur Lua\TeX\ (\url{http://luatex.org}) a été intégré ;
-il offre de nouvelles fonctionnalités typographiques et repose
-sur l'excellent langage de commande Lua qui peut aussi être utilisé
-en dehors de \TeX.
-
-Les versions Windows et Unix sont beaucoup plus proches que par le passé.
-En particulier les scripts en Perl et en Lua sont communs aux deux
-architectures.
-
-\TL{} dispose d'une nouvelle interface pour la maintenance (\cmdname{tlmgr}
-voir section~\ref{sec:tlmgr}), elle permet les ajouts, mises à jour et
-suppressions de composants et prend en charge la régénération des bases
-\texttt{ls-R}, des formats et des fichiers \filename{.map} lorsque c'est
-nécessaire.
-
-Les fonctionnalités de \cmdname{tlmgr} englobent toutes les tâches dévolues
-auparavant à \cmdname{texconfig} qui ne devrait plus être utilisé (il est
-conservé mais avec un champ d'action réduit).
-
-Le programme d'indexation \cmdname{xindy} (\url{http://xindy.sourceforge.net/})
-est maintenant disponible pour la plupart des plates-formes.
-
-L'utilitaire \cmdname{kpsewhich} dispose de deux options nouvelles :
-\optname{--all} qui retourne toutes les occurrences du fichier recherché
-et \optname{--subdir} qui limite la recherche à un sous-répertoire donné.
-
-Le programme \cmdname{dvipdfmx} permet maintenant d'extraire les informations
-concernant la \textit{bounding box} par le biais de la commande
-\cmdname{extractbb}; c'était une des dernières fonctionnalités de
-\cmdname{dvipdfm} qui manquaient à \cmdname{dvipdfmx}.
-
-Les alias de polices \filename{Times-Roman}, \filename{Helvetica}, etc.
-ont été supprimés, les conflits de codage qu'ils induisaient n'ayant pas pu
-être résolus.
-
-Le format \pkgname{platex} a été supprimé afin de résoudre un conflit de nom
-avec son homonyme japonais ; le support pour le polonais est assuré
-maintenant par l'extension \pkgname{polski}.
-
-Les fichiers \web{} d'extension \filename{.pool} sont maintenant inclus dans
-les binaires afin de faciliter les mises à jour.
-
-Enfin, les changements décrits par Donald Knuth dans « \TeX\ tuneup of 2008 »
-(voir \url{http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf}) sont inclus
-dans la présente édition.
-
-\subsection{Versions futures}
-
-\emph{\TL{} n'est pas un produit parfait !} (et ne le sera jamais).
-Nous prévoyons de continuer à produire de nouvelles versions et aimerions
-fournir plus d'aide, de fonctionnalités, de programmes d'installation et
-(bien sûr) une arborescence améliorée et vérifiée de macros et de fontes. Ce
-travail est effectué par des volontaires débordés, dans la limite de leur
-temps libre et beaucoup reste à faire. Si vous pouvez nous aider, n'hésitez
-pas à nous contacter, voir \url{http://tug.org/texlive/contribute.html}.
-
-Corrections, suggestions et propositions d'aide doivent être envoyées à :
-\begin{quote}
-\email{tex-live@tug.org} \\
-\url{http://tug.org/texlive}
-\end{quote}
-
-\medskip
-\noindent \textsl{Bon travail avec \TeX{} !}
-
-\end{document}
-
-%%% Local Variables:
-%%% mode: latex
-%%% mode: flyspell
-%%% ispell-local-dictionary: "francais"
-%%% TeX-master: t
-%%% coding: utf-8
-%%% End:
diff --git a/Master/texmf-doc/source/texlive/texlive-pl/Makefile b/Master/texmf-doc/source/texlive/texlive-pl/Makefile
deleted file mode 100644
index 4f0d8cc9985..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-pl/Makefile
+++ /dev/null
@@ -1,3 +0,0 @@
-include ../texlive-en/Makefile
-doc = texlive-pl
-lang = polish
diff --git a/Master/texmf-doc/source/texlive/texlive-pl/live4ht.cfg b/Master/texmf-doc/source/texlive/texlive-pl/live4ht.cfg
deleted file mode 100644
index 2927d07cb93..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-pl/live4ht.cfg
+++ /dev/null
@@ -1,52 +0,0 @@
-% tex4ht configuration file for the TeX Live documentation.
-% Accumulated over many years. Public domain.
-%
-% html specifies the main output format.
-% info for extra debugging info in the log files.
-
-% have html in one piece (including footnotes).
-%\Preamble{charset=iso-8559-2,html,info,fn-in}
-\Preamble{html,info,fn-in}
-
-% add extra stylesheet
-\Configure{@HEAD}{\HCode{%
-<link rel="stylesheet" type="text/css" href="\jobname.css" />\Hnewline
-<link rel="stylesheet" type="text/css" href="tex-live.css" />\Hnewline
-}}
-% use png graphics as-is
-\Configure{graphics*}
- {png}
- {\Needs{""}%
- \Picture[pict]{\csname Gin@base\endcsname.png}%
- }
-% or LaTeX complains it is missing.
-\begin{document}
-
-\EndPreamble
-
-% simplify output for HTML. We leave TeX and LaTeX alone, since tex4ht
-% actually does the lowered E (and raised A) in CSS.
-%\def\OMEGA{Omega}
-\def\LaTeXe{LaTeX2e}
-\def\eTeX{e-\TeX}
-\def\acro#1{#1}
-\def\MF{Metafont}
-\def\BibTeX{BibTeX}
-\def\warningbox{}
-\def\endwarningbox{}
-\def\Thanh{H\`an Th\^e Th\`anh}
-
-\Configure{crosslinks}{[}{]
- }{nastpny}{poprzedni}{wstecz}
- {pocztek}{koniec}{spis}
-
-\ifx\tldocenglish\undefined \else
- % these definitions cause "missing } inserted" at \end{tabularx} in
- % other langs. don't know why.
- %
- % don't make these into links, as happens with \path. We only have a couple
- % special characters that actually occur.
- \def\dirname{\texttt\bgroup\catcode`\$=12 \catcode`\_=12 \finishliteral}
- \def\finishliteral#1{#1\egroup}
- \let\filename=\dirname
-\fi
diff --git a/Master/texmf-doc/source/texlive/texlive-pl/tex-livep.sty b/Master/texmf-doc/source/texlive/texlive-pl/tex-livep.sty
deleted file mode 100644
index e81908a5d47..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-pl/tex-livep.sty
+++ /dev/null
@@ -1,446 +0,0 @@
-% TeX Live documentation style. Written by many people over many years.
-% Public domain.
-%
-\NeedsTeXFormat{LaTeX2e}[1995/12/01]
-\ProvidesPackage{tex-livep}[2008/07/31 v1.6 TeX Live documentation style]
-%
-\RequirePackage{alltt}
-\RequirePackage{array}
-\RequirePackage{colortbl}
-\RequirePackage{comment}
-\RequirePackage{float}
-\RequirePackage{graphicx}
-\RequirePackage{longtable}
-\RequirePackage{shortvrb}
-\RequirePackage[normalem]{ulem}
-\RequirePackage[obeyspaces]{url}
-\RequirePackage{xspace}
-%
-\RequirePackage{lmodern}
-\usepackage{textcomp}% including \textbullet
-\usepackage[T1]{fontenc}
-%\usepackage[latin1]{inputenc}
-%
-% 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}\@}
-\def\acro#1{\textscale{.9}{#1}\@}
-%
-\RequirePackage{fancyvrb}
-\DefineVerbatimEnvironment{verbatim}{Verbatim}{fontsize=\normalsize}
-\DefineVerbatimEnvironment{fverbatim}{Verbatim}{fontsize=\footnotesize}
-\DefineVerbatimEnvironment{sverbatim}{Verbatim}{fontsize=\small}
-\DefineVerbatimEnvironment{boxedverbatim}
- {Verbatim}{fontsize=\scriptsize,frame=single}
-\DefineVerbatimEnvironment{Verbatim}{Verbatim}{fontsize=\normalsize}
-\def\verbatiminput#1{\VerbatimInput[fontsize=\scriptsize]{#1}}
-\def\boxedverbatiminput#1{\VerbatimInput[frame=single,fontsize=\scriptsize]{#1}}
-\def\listinginput#1#2{\VerbatimInput[fontsize=\scriptsize,firstnumber=#1,numbers=left]{#2}}
-\MakeShortVerb\|
-%
-%
-% Done with packages.
-%
-% Page layout.
-\advance\textwidth by 1.1in
-\advance\oddsidemargin by -.55in
-\advance\evensidemargin by -.55in
-%
-\advance\textheight by 1in
-\advance\topmargin by -.5in
-\advance\footskip by -.5in
-\pagestyle{headings}
-%
-% LaTeX parameters.
-\renewcommand{\topfraction}{0.85}
-\renewcommand{\floatpagefraction}{0.86}
-\renewcommand{\textfraction}{0.1}
-\renewcommand{\abovecaptionskip}{4pt}
-\renewcommand{\belowcaptionskip}{4pt}
-\setcounter{tocdepth}{3}
-\setcounter{secnumdepth}{3}
-\setcounter{topnumber}{5}
-\setcounter{totalnumber}{5}
-%
-% linebreaking, etc.
-\hbadness=4000
-\vbadness=4000
-\emergencystretch=.1\hsize
-\relpenalty=500
-%
-\def\slash{/\penalty\z@\hskip\z@skip }
-%
-% various sorts of names
-\newcommand*{\pkgname}[1]{\textsf{#1}}% package name
-\newcommand*{\optname}[1]{\texttt{#1}}% (package,class) option name
-\newcommand*{\cmdname}[1]{\textsf{#1}}% command name
-\newcommand*{\colname}[1]{\emph{#1}}% collection name
-\newcommand*{\dirname}[1]{\path{#1}}% directory name
-\newcommand*{\filename}[1]{\path{#1}}% file name
-\newcommand*{\envname}[1]{\texttt{#1}}% environment variable name
-\newcommand{\code}[1]{\texttt{#1}}
-\newcommand{\file}[1]{\texttt{#1}}
-\newcommand{\prog}[1]{\textsf{#1}}% same as \cmdname
-\newcommand{\samp}[1]{`\texttt{#1}'}
-\newcommand{\var}[1]{{\sl #1}}% not \textsl, for roman not typewriter slanted.
-\newcommand{\ttvar}[1]{\texttt{\var{#1}}}
-%
-% underlined command input.
-%\def\Ucom#1{%
-% \uline{\rule[-.2\baselineskip]{0pt}{.9\baselineskip}\ttfamily #1}}
-% bold command input
-\def\Ucom#1{{\bfseries\ttfamily #1}}
-
-% \CDref is for url's with a #, where we need to write the target url and
-% displayed url separately in the input, due to catcode madness.
-% (We could simplify/remove this next time, I think.)
-\def\CDref#1#2{\texttt{#1}}
-%
-% \OnCD is currently for any other reference to a file or directory in
-% the distribution. PDF readers only open .pdf files, though, so we
-% should change this to only use \href for those. Or more likely use
-% different macros in the source.
-\def\OnCD#1{\href{../../../../#1}{\path{#1}}}
-%
-% \href incorrectly appends .pdf to anything without an extension; these
-% definitions using \hyper@linkurl do not, but they fail for .pdf
-% references -- which are the only ones that work anyway. So this is
-% useless, in practice.
-%\def\CDref#1#2{\hyper@linkurl{#2}{../../../../#1}}
-%\def\OnCD#1{\hyper@linkurl{\path{#1}}{../../../../#1}}
-
-% GUI menu/button/tab sequence:
-\def\guiseq#1{\textsf{#1}}
-\def\arw{\unskip$\rightarrow$\ignorespaces}
-%
-% Special names.
-\def\dpi{$\,$dpi\xspace}
-\def\bs{{\protect\normalfont\ttfamily\char'134}}
-\DeclareRobustCommand{\cs}[1]{{\normalfont\ttfamily\char`\\#1}}
-\def\Q#1{\par\vskip6pt\leftline{#1}\par}
-\def\hyph{-}
-%
-% many abbreviations.
-\newcommand{\CS}{$\mathcal{C}\kern-.1667em\lower.5ex%
- \hbox{$\mathcal{S}$}\kern-.075em $}
-\def\AFMtoTFM{\cmdname{AFM2TFM}\null}
-\def\bv{\emph{Baskerville}}
-\let\BV=\bv
-\def\Dash{\unskip\nobreak\thinspace---\thinspace\ignorespaces}
-\def\dvicopy{\cmdname{dvicopy}}
-\def\dvidvi{\cmdname{dvidvi}}
-\def\dvips{\cmdname{dvips}}
-\def\eTeX{$\varepsilon$-\TeX}
-\def\fpTeX{\textrm{fp}\TeX\xspace}
-\def\GFtoDVI{\cmdname{GFtoDVI}\null}
-\def\GFtoPK{\cmdname{GFtoPK}\null}
-\def\GFtype{\cmdname{GFtype}}
-\def\GUI{\acro{GUI}\xspace}
-\def\KPS{Kpathsea}
-\def\La{La}
-\def\OMEGA{$\Omega$}
-\def\OzMF{OzMF}
-\def\OzMP{OzMP}
-\def\OzTeX{O\kern-.03em z\kern-.15em\TeX}
-\def\p.{p.\,}
-\def\PKtype{\cmdname{PKtype}}
-\def\PLtoTF{\cmdname{PLtoTF}\null}
-\def\ProTeXt{Pro\TeX t}
-\def\teTeX{\textrm{te}\TeX\xspace}
-\def\TeXLive{\TeX{} Live\xspace}
-\def\TFtoPL{\cmdname{TFtoPL}\null}
-\def\TK{\TeX\ Collection}
-\let\TL=\TeXLive
-\def\TypeI{Type~1}
-\def\VFtoVP{\cmdname{VFtoVP}\null}
-\def\VPtoVF{\cmdname{VPtoVF}\null}
-\def\Thanh{H\`an~Th\ifx % get Unicode char in tex4ht's HTML output
- \HCode\UnDef\^e\llap{\raise 0.5ex\hbox{\'{}}}\else
- \HCode{\string&\#x1EBF;}\fi~Th\`anh}
-\def\XEmTeX{\textrm{XEm}\TeX\xspace}
-\def\XEmacs{\textrm{XEmacs}\xspace}
-\def\XeTeX{Xe\TeX\xspace}
-\def\Webc{Web2C}
-\providecommand*{\CD}{\acro{CD}\xspace}
-\providecommand*{\CTAN}{\acro{CTAN}\xspace}
-\providecommand*{\DVD}{\acro{DVD}\xspace}
-\providecommand*{\GNU}{\acro{GNU}\xspace}
-\providecommand*{\HTML}{\acro{HTML}\xspace}
-\providecommand*{\MacOSX}{Mac\,\acro{OS\,X}\xspace}
-\providecommand*{\PS}{Post\-Script\xspace}
-\providecommand*{\TDS}{\acro{TDS}\xspace}
-\providecommand*{\dvi}{\acro{DVI}\xspace}
-\providecommand*{\web}{\texttt{WEB}\xspace}
-
-% Include an image.
-% #1 - name of image (pictures/#1.jpg, always .jpg please)
-% #2 - bb for html
-% #3 - width for TeX
-%
-\def\tlimage#1#2#3{%
- \ifnum \Status=2 % html, want relative path in output
- \includegraphics[#2]{../../general/texlive-common/pictures/#1.jpg}
- \else % not html, handled by TEXINPUTS in Makefile
- \includegraphics[width=#3]{pictures/#1.jpg}
- \fi
- \\[5mm]
-}
-
-\def\tlpng#1#2{%
- \ifnum \Status=2 % html, want relative path in output
- \includegraphics[bb=0 0 1 1]{#1.png}%
- \else % not html, handled by TEXINPUTS in Makefile
- \includegraphics[width=#2]{#1.png}%
- \fi
-}
-
-%
-% description-like environment that uses tt instead of bf, and doesn't
-% go to the left margin. Without the \hfil, get an underfull box.
-% Don't know why \descriptionlabel doesn't.
-%
-\newenvironment{ttdescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt % these lists tend to have short descriptions
- \parindent=0pt
- \let\makelabel=\ttdescriptionlabel}}%
- {\end{list}}
-\newcommand*\ttdescriptionlabel[1]{\hspace\labelsep
- \normalfont\ttfamily #1\hfil}
-%
-% Likewise, for commands using sans serif.
-\newenvironment{cmddescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt
- \let\makelabel=\cmddescriptionlabel}}%
- {\end{list}}
-\newcommand*\cmddescriptionlabel[1]{\hspace\labelsep
- \normalfont\sffamily #1\hfil}
-
-% General squeezed itemize.
-\newenvironment{itemize*}%
- {\begin{itemize}%
- \setlength{\itemsep}{0pt}%
- \setlength{\parskip}{0pt}}%
- {\end{itemize}}
-
-\newsavebox{\wbox}
-\newenvironment{warningbox}
- {\begin{lrbox}{\wbox}
- \begin{minipage}{.95\textwidth}}
- {\end{minipage}\end{lrbox}\fbox{\usebox{\wbox}}}
-%
-% lrbox is used as a representation marking. I changed it to
-% lrBox in tne source file, to get closer to logical marking
-\newsavebox{\mylrbox}
-\newenvironment{lrBox}
- {\begin{lrbox}{\mylrbox}}
- {\end{lrbox}}
-
-
-% emacs-page output setup
-%
-\ifx \HCode\UnDef
- \providecommand{\Status}{0}% running TeX
-\else
- \providecommand{\Status}{2}% running TeX4ht
-\fi
-%\typeout{Status is \Status}
-%
-\newif\ifSingleColumn
-%
-% By default, we won't be creating hyperlinks.
-\def\href#1#2{#2}
-\def\hypertarget#1#2{}
-\def\email#1{\href{mailto:#1}{\path{#1}}} % \path comes from url
-%
-\definecolor{hypercolor}{rgb}{0.5,0.0,0.5} % purplish external links.
-%
-%
-\ifcase\Status
- % \Status = 0
- \typeout{TeX Live documentation in DVI format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 1
- \typeout{TeX Live documentation in PDF format}
- \RequirePackage[breaklinks,
- colorlinks,linkcolor=hypercolor,citecolor=hypercolor,
- urlcolor=hypercolor,filecolor=hypercolor,
- bookmarksopen,
- %pdfstartview={FitBH -320000}, % fails with acrobat7
- hyperindex]
- {hyperref}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 2
- \typeout{TeX Live documentation in HTML format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- % read our config file, live4ht.cfg; q.v., for more definitions.
- % hyperref load must come after the tex4ht load.
- \RequirePackage[live4ht]{tex4ht}
- \RequirePackage[tex4ht]{hyperref} \hyperlinkfileprefix{}
- % definitions need simplifying for TeX4ht to make relative paths work.
- \def\CDref#1#2{\href{../../../../#1}{#2}}
- \def\OnCD#1{\href{../../../../#1}{#1}}
- \or
- % \Status = 3
- \typeout{TeX Live documentation as a Baskerville issue}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \RequirePackage{bvoutln}% outline of baskerville
- \SingleColumnfalse
- \RequirePackage{multicol}
- \or
- % \Status = 4
- \typeout{TeX Live documentation as a TUB article}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \SingleColumnfalse
- \newenvironment{multicols}[1]{}{}
-\fi
-%
-\ifnum \Status=4
-\else
- \RequirePackage{texnames}
- \providecommand\TeXXeT{\TeX-{}-%
- \kern-.1emX\kern-.125em\lower.5ex\hbox{E}\kern-.1667emT\@}
- \def\MP{MetaPost}
- \let\mf\MF
- \newcommand\ConTeXt{C\kern-.0333emon\-\kern-.0667em\TeX\kern-.0333emt}
- \newcommand\MIKTEX{MiK\kern-.025em \TeX}% per www.miktex.org
- % from pictex.tex:
- \ifx\PiC\undefined \def\PiC{P\kern-.12em\lower.5ex\hbox{I}\kern-.075emC} \fi
- \ifx\PiCTeX\undefined \def\PiCTeX{\PiC\kern-.11em\TeX} \fi
-\fi
-%
-% hacking at sections etc., to pay attention to baskerville status
-\newcommand{\@condend@multicols}{%
- \ifSingleColumn
- \else
- \def\@tempa{multicols}%
- \ifx\@tempa\@currenvir
- \end{multicols}%
- \fi
- \fi
-}
-\let\Section\section
-\renewcommand{\section}{%
- \@ifstar
- {\Section*}%
- {%
- \@condend@multicols
- \@dblarg\@full@section
- }%
-}
-\def\@full@section[#1]#2{%
- \Section[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-\let\SubSection\subsection
-\renewcommand{\subsection}{%
- \@ifstar{\SubSection*}%
- {%
- \@condend@multicols
- \@dblarg\@full@subsection
- }
-}
-\def\@full@subsection[#1]#2{%
- \SubSection[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-
-% calm things down a bit if we're in a multiple-column version
-\ifSingleColumn
-\else
- \def\@listI{\leftmargin\leftmargini
- \parsep \z@
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \itemsep \z@ \@plus .1\p@
- }
- \let\@listi\@listI
- \@listi
- \def\@listii{\leftmargin\leftmarginii
- \labelwidth\leftmarginii\advance\labelwidth-\labelsep
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \itemsep \z@ \@plus .1\p@
- }
- \def\@listiii{\leftmargin\leftmarginiii
- \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
- \topsep 1\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \partopsep \z@
- \itemsep \topsep
- }
- \def\@listiv{\leftmargin\leftmarginiv
- \labelwidth\leftmarginiv\advance\labelwidth-\labelsep
- }
- \def\@listv{\leftmargin\leftmarginv
- \labelwidth\leftmarginv\advance\labelwidth-\labelsep
- }
- \def\@listvi{\leftmargin\leftmarginvi
- \labelwidth\leftmarginvi\advance\labelwidth-\labelsep
- }
-\fi
-%
-% array package stuff
-\def\arraybackslash{\let\\=\@arraycr}
-\newcolumntype{P}[1]{>{\raggedright\arraybackslash}p{#1}}
-%
-% shaded rows (using facilities of colortbl)
-%
-\definecolor{pale}{gray}{.9}
-\newcount\colrow
-\gdef\RowColor{pale}
-\def\SetRowColor{%
- \rowcolor{\RowColor}%
- \global\advance\colrow by1\relax
- \ifodd\colrow
- \gdef\RowColor{pale}%
- \else
- \gdef\RowColor{white}%
- \fi
-}
-% redefine to hack up a reference even though we don't need it...
-\renewcommand\@bibitem[1]{\if@filesw \immediate\write\@auxout
- {\string\bibcite{#1}{?}}\fi\ignorespaces}
-%
-% \unknownTeXlive is a dummy texlive entry for the biblio
-\newcommand\unknownTeXlive[2][\relax]{\textbf{\textsc{unknown}}%
- \global\@all@unknown\expandafter{\the\@all@unknown{#2}}%
-}
-\newtoks\@all@unknown
-\global\@all@unknown{}
-\AtEndDocument{\@message@unknowns}
-\def\@message@unknowns{\edef\@tempa{\the\@all@unknown}%
- \ifx\@tempa\@empty
- \else
- \def\@tempa{*** TeX live package location of }%
- \expandafter\@output@unknowns\the\@all@unknown\@empty
- \fi
-}
-\def\@output@unknowns#1{\edef\@tempb{#1}%
- \ifx\@tempb\@empty
- \typeout{ unknown}%
- \else
- \message{\@tempa#1,}%
- \def\@tempa{}%
- \expandafter\@output@unknowns
- \fi
-}
-
-
-% Silence font warnings about no bold typewriter in LM.
-\def\@font@warning#1{}%
-
-% Silence hyperref warnings about \kern.
-\def\HyPsd@Warning#1{}%
-
-\endinput
diff --git a/Master/texmf-doc/source/texlive/texlive-pl/texlive-pl.tex b/Master/texmf-doc/source/texlive/texlive-pl/texlive-pl.tex
deleted file mode 100644
index 0378da6518b..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-pl/texlive-pl.tex
+++ /dev/null
@@ -1,3335 +0,0 @@
-% iso8859-2
-% $Id: live.tex, v. 36 2008/08/17
-% TeX Live documentation.
-% Originally written by Sebastian Rahtz and Michel Goossens,
-% now maintained by Karl Berry and others.
-% Polish translation and additions by Staszek Wawrykiewicz et al.
-% Public domain.
-% ----
-% UWAGA dla recenzentw/tumaczy: %%! to moje komentarze (StaW)
-\documentclass{article}
-\let\tldocenglish=0 % for live4ht.cfg
-\def\La{La}
-\let\textsl\textit
-\usepackage{tex-livep}
-\usepackage{polski} %% for PL
-\usepackage[latin2]{inputenc} %% for PL
-\exhyphenpenalty=10000 %% for PL
-\def\Dash{---}
-\widowpenalty=10000
-\clubpenalty=10000
-%% redefined MF logo! %% for PL
-%\def\MF{\textlogo{META}\-\textlogo{FONT}} %% for PL
-%\def\MP{\textlogo{META}\-\textlogo{POST}} %% *** TP ***
-\def\shac{\char178} % for PL + qtmr (HTML)
-\def\aac{\char225} % for PL + qtmr (HTML)
-\def\iac{\char237} % for PL + qtmr (HTML)
-\renewcommand{\samp}[1]{,,\texttt{#1}''} %% for PL
-%% Polish style for sections
-\makeatletter
-\renewcommand{\@seccntformat}[1]{%
- \csname the#1\endcsname.\hspace{.5em}} %%
-\def\numberline#1{\hb@xt@\@tempdima{#1.\hfill}}
-\makeatother
-\hyphenation{tex-basic la-tex pdf-tex}
-%% -----
-\begin{document}
-
-\title{{\huge \textit{Przewodnik po \protect\TL}\\[1ex]}
- {\LARGE \textsf\TL{} 2008}
-}
-
-\author{Redakcja: Karl Berry \\[3mm]
- \url{http://tug.org/texlive/}
-}
-
-\date{Sierpie 2008}
-
-\maketitle
-
-\begin{multicols}{2}
-\tableofcontents
-%\listoftables
-\end{multicols}
-%--------------------------
-\section{Wstp}\label{sec:intro}
-
-\subsection{\TeX\ Live i \TeX\ Collection}
-Niniejsza dokumentacja opisuje oprogramowanie \TL{} --
-dystrybucj \TeX-a wraz z~programami pomocniczymi, dostpn dla
-systemw \acro{GNU}/Linux, rnych wersji Unix (w~tym \MacOSX{})
-oraz Windows.
-
-\TL{} mona cign z~sieci bd otrzyma na pytce \DVD \TK{}, dostarczanej
-swoim czonkom przez Grupy Uytkownikw Systemu \TeX{} .
-Cz \ref{sec:tl-coll-dists} omawia pokrtce zawarto tej pytki.
-Zarwno \TL{}, jak i \TK{} powstay dziki zbiorowemu wysikowi Grup.
-W~tym dokumencie omwimy gwnie sam dystrybucj \TL.
-
-\TL{} zawiera skompilowane programy: \TeX{}, \LaTeXe{}, \mbox{\MF}, \MP,
-\BibTeX{} i~wiele innych oraz bogaty zestaw pakietw makr o~wielorakim
-zastosowaniu, a take fonty i~dokumentacje. Wszystko to umoliwia skad
-publikacji w~wielu jzykach.
-
-Pakiety zawarte w~\TL{} s regularnie aktualizowane z serwerw \acro{CTAN}:
-\url{http://www.ctan.org}.
-
-Lista najwaniejszych zmian dokonanych w~tej edycji \TL{}
-znajduje si w~czci~\ref{sec:tlcurrent}, na str.~\pageref{sec:tlcurrent}.
- %w~czci~\ref{sec:history}, na str.~\pageref{sec:history}.
-
-Nie opisujemy tu, czym jest system \TeX{}, a~jedynie kwesti instalacji
-i~konfiguracji oprogramowania \TL.
-Pocztkujcy uytkownicy mog si zapozna z~podstawowymi pojciami
-np. w~artykule {\it Przewodnik po systemie \TeX\/}:
-\OnCD{texmf-doc/doc/polish/tex-virtual-academy-pl/cototex.html}.
-
-\subsection{Obsugiwane systemy operacyjne}
-\label{sec:os_support}
-
-\TL{} zawiera oprogramowanie dla wielu platform linuksowych i uniksowych,
-w~tym \MacOSX. Zaczone pliki rdowe pozwalaj te na instalacj
-na dodatkowych platformach.
-
-Spord systemw Windows obsugiwane s tylko wersje 2000 i nowsze.
-Zaniechano wsparcia dla Windows~9x, ME oraz NT, ktrych obsuga bya bardzo
-pracochonna (w~porwnaniu z~Linux/Unix). Wprawdzie brak jest
-oprogramowania na wersje 64-bitowe, ale aplikacje 32-bitowe powinny na nich
-dziaa.
-
-W czci \ref{sec:tl-coll-dists} omwiono alternatywne dystrybucje,
-przeznaczone dla Windows oraz \MacOSX.
-
-\subsection{Podstawy instalacji \protect\TL{}}
-\label{sec:basic}
-
-\TL{} mona zainstalowa z~pytki \DVD{} lub internetu. Program instalacyjny
-jest niewielki i~pozwala pobra z sieci wszystkie potrzebne pakiety.
-Jest to wygodne, gdy potrzebujemy jedynie czci oprogramowania \TL.
-
-Posiadajc pytk \DVD{}, moemy nie tylko zaistalowa \TL{} na twardym dysku,
-ale i~uruchomi programy bezporednio z~niej (a~nawet z~obrazu
-\DVD{}, jeli nasz system pozwala na jego zamontowanie).
-
-Szczegowy opis instalacji \TL{} znajduje si w dalszych rozdziaach
-tego dokumentu, tu podamy jedynie skrcony przepis:
-
-\begin{itemize*}
- \item program instalacyjny \filename{install-tl} moe dziaa w~dwch
-trybach: tekstowym (domylnym dla Unix/Linux) i~graficznym (tzw. \GUI,
-domylnym dla Windows); tryb mona wymusi podajc parametr \code{-gui}
-bd \code{-no-gui};
-
-\item jednym z~instalowanych programw jest \prog{tlmgr} (meneder \TL{}),
-ktry rwnie mona uruchomi w~trybie tekstowym bd graficznym; pozwala
-on doinstalowa lub usun pakiety, aktualizowa je z~sieci, a take
-wykona rne czynnoci konfiguracyjne.
-
-\end{itemize*}
-
-\subsection{Dostpna pomoc}
-\label{sec:help}
-
-Spoeczno \TeX-owa jest bardzo aktywna i~pomocna, std te wikszo
-powanych zapyta nie pozostaje bez odpowiedzi. Przed zadaniem
-pytania warto je uprzednio dobrze przemyle i~sformuowa, poniewa
-respondenci to wolontariusze, wrd ktrych znale si mog mniej lub
-bardziej dowiadczeni uytkownicy.
-(Jeli preferujemy komercyjne wsparcie techniczne, moemy zamiast
-\TL{} zakupi system u~jednego z~dostawcw, ktrych list mona znale
-na \url{http://tug.org/interest.html#vendors}.)
-
-Oto lista rde pomocy, w~kolejnoci przez nas rekomendowanej:
-
-\begin{description}
-\item [\TeX{} \acro{FAQ}] \TeX-owy \acro{FAQ} jest obszernym zbiorem
-odpowiedzi na wszelkie rodzaje pyta, od najprostszych do najbardziej
-zaawansowanych. Jest on zaczony na \TL{} w~katalogu
-\OnCD{texmf-doc/doc/english/FAQ-en},
-a~take dostpny w~sieci: \url{http://www.tex.ac.uk/faq}. Proponujemy
-zajrze najpierw tam. Uruchomiono te serwis \acro{FAQ}
-w~jzyku polskim: \url{http://faq.gust.org.pl}.
-
-\item [\TeX{} Catalogue] Jeli poszukujemy konkretnego pakietu, fontu,
-programu itp., to polecamy \TeX{} Catalogue. Jest to obszerne zestawienie
-wszelkich pakietw dotyczcych \TeX-a. Patrz:
- %\OnCD{texmf-doc/doc/english/catalogue} lub
- \url{http://www.ctan.org/help/Catalogue/}.
-
-\item [\TeX{} Web Resources] Strona \url{http://tug.org/interest.html}
-zawiera wiele odsyaczy, w~szczeglnoci do ksiek, podrcznikw
-i~artykuw powiconych wszelkim aspektom pracy z~systemem \TeX.
-
-\item [archiwa pomocy] Dwa gwne fora pomocy to grupa
-Usenet \url{news:comp.text.tex} oraz lista dyskusyjna
-\email{texhax@tug.org}. Warto przeszuka archiwa list dyskusyjnych,
-zawierajce mnstwo pyta i odpowiedzi zbieranych przez wiele lat:
-\url{http://groups.google.com/group/comp.text.tex/topics} oraz
-\url{http://tug.org/mail-archives/texhax}. Nie zaszkodzi
-skorzystanie z~wyszukiwarki, np. \url{http://www.google.com}.
-
-\item [wysyanie pyta] Jeli nadal nie znajdujemy rozwizania problemu,
-to moemy wysa pytanie do \dirname{comp.text.tex}, korzystajc z~Google,
-czytnika wiadomoci bd piszc list na adres \email{texhax@tug.org}.
-Przedtem jednak \emph{naley} si zapozna z~poradami dotyczcymi sposobu
-zadawania pyta, zawartymi w~\acro{FAQ}:
-\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}.
-Polscy uytkownicy maj do dyspozycji list dyskusyjn GUST (polskiej Grupy
-Uytkownikw Systemu \TeX); informacje o niej
-znajdziemy na stronie \url{http://www.gust.org.pl}.
-
-\item [wsparcie \TL{}] Gdy chcemy zgosi bd bd sugestie
-i~komentarze dotyczce dystrybucji \TL{}, instalacji lub dokumentacji,
-mamy do dyspozycji list dyskusyjn \email{tex-live@tug.org}. Jeli kwestia
-dotyczy konkretnego programu (pakietu makr itp.) z~\TL{},
-to lepiej jednak skierowa pytanie do osoby opiekujcej si danym programem
-lub na specjalistyczn list dyskusyjn.
-
-\end{description}
-
-Druga strona medalu to pomaganie tym, ktrzy maj problemy. Zarwno
-\dirname{comp.text.tex}, jak i~\code{texhax} (oraz lista dyskusyjna GUST)
-s otwarte dla kadego,
-tak wic zapraszamy do wczenia si, czytania wiadomoci i~pomagania
-innym w~miar wasnych moliwoci. Witamy wrd uytkownikw
-systemu \TeX!
-
-%--------------------------
-\section{Struktura \protect\TeX\protect\ Live}\label{sec:struct-tl}
-
-Omwimy tutaj struktur i~zawarto dystrybucji \TL{}, a~take \TK{} --
-pytki \DVD, w~skad ktrej wchodzi \TL.
-
-\subsection{The \protect\TeX\protect\ Collection: \TL, pro\TeX{}t, Mac\TeX}
-\label{sec:tl-coll-dists}
-
-The \TK{} \DVD{} zawiera:
-
-\begin{description}
-
-\item [\TL] kompletny system na \acro{DVD}, z moliwoci uruchamiania
-bezporednio z~pyty bd instalacji na twardym dysku;
-
-\item [Mac\TeX] dla systemu \MacOSX; posiada on wasny program instalacyjny
-i~dodatkowe programy dla tego systemu; strona domowa projektu:
-\url{http://www.tug.org/mactex/};
-
-\item [pro\TeX{}t] dystrybucja dla Windows, oparta na dystrybucji \MIKTEX{},
-rozszerzonej o~dodatkowe narzdzia; cakowicie niezalena od \TL;
-\ProTeXt\ posiada wasny, atwy w~obsudze program instalacyjny;
- %i~rwnie moe by uruchamiany bezporednio z~pytki.
- strona domowa projektu: \url{http://tug.org/protext};
-
-\item [CTAN] zrzut zawartoci archiww \CTAN{};
-
-\item [\texttt{texmf-extra}] katalog z wybranymi pakietami dodatkowymi.
-
-\end{description}
-
-\CTAN, \pkgname{protext}, i~\texttt{texmf-extra} nie speniaj przyjtych dla
-\TL{} wymogw dotyczcych swobody kopiowania, wobec tego naley ten fakt
-uwzgldni przy redystrybucji bd modyfikacji zawartoci wymienionych
-katalogw.
-
-\subsection{Gwne katalogi \TL}
-\label{sec:tld}
-
-Poniej wymieniono waniejsze podkatalogi gwnego katalogu dystrybucji \TL.
-Na pytce \pkgname{live} \DVD caa dystrybucja \TL{} zostaa
-umieszczona w katalogu \dirname{texlive}, nie za w~katalogu gwnym
-(poniej traktujemy go jako katalog gwny we wszystkich odniesieniach
-do \TL).
-
-\begin{ttdescription}
-\item[bin] skompilowane programy \TeX-owe, zorganizowane w~podkatalogach
- wedug platform systemowych;
-
-\item[readme.html] krtki wstp z~uytecznymi odnonikami;
-
-\item[source] rda wszystkich programw, wcznie z~gwnymi dystrybucjami
- \Webc{} \TeX-a i~\MF{}-a;
-
-\item[support] rne programy pomocnicze zwizane z~\TeX-em, ktre \emph{nie}
- s domylnie instalowane;
- dla uytkownikw systemw Windows doczono ponadto szereg programw
- (edytory, ,,shelle TeX-owe''), ktrych zwykle brak w~typowej instalacji
- Windows (programy te mog by szczeglnie przydatne dla pocztkujcych);
-
-\item[texmf] drzewo katalogw plikw pomocniczych i~dokumentacji dla
- \emph{programw} (patrz: \texttt{TEXMFMAIN} w~nastpnej czci);
-
-\item[texmf-dist] gwne drzewo katalogw formatw i~pakietw (zawiera makra,
- fonty i~dokumentacje; patrz: \texttt{TEXMDIST} w~nastpnej czci);
-
-\item[texmf-doc] drzewo samodzielnych dokumentacji (m.in. podrczniki itp.),
- niezwizane z~konkretnymi pakietami, zorganizowane wedug jzykw.
-
-\item[tlpkg] skrypty, programy i~inne dane potrzebne do instalacji;
- katalog zawiera take ,,prywatne'' dla \TL{} kopie systemw Perl i~Ghostscript
- dla Windows (nie koliduj one z~posiadanymi przez uytkownika podobnymi
- programami i~dziaaj tylko w~ramach instalacji); poza tym doczono
- szybki i~wygodny program do podgldu plikw postscriptowych (a~take PDF)
- -- PS\_View dla Windows.
-\end{ttdescription}
-
-Prcz podkatalogw wymienionych powyej, katalog gwny zawiera skrypty
-instalacyjne oraz pliki \filename{README}, w~formacie tekstowym lub HTML,
-w~kilku jzykach (rwnie polskim).
-
-Katalog \dirname{texmf-doc} zawiera, jak wspomniano wyej, dokumentacje
-oglne, np. podrczniki (take po polsku). Dokumentacje programw (man, info,
-take w~formacie PDF) znajduj si w~katalogu
-\dirname{texmf/doc}, za dokumentacje pakietw makr, fontw i~formatw
-w~katalogu \dirname{texmf-dist/doc}. W~odszukaniu konkretnej
-dokumentacji w~dowolnym z~wymienionych katalogw mog pomc
-programy \cmdname{texdoc} lub \cmdname{texdoctk}. Pomocnym moe te by
-plik \OnCD{doc.html}, ktry znajdziemy w~gwnym katalogu.
-
-Niniejsza dokumentacja w~kilku jzykach znajduje si w katalogu
-\dirname{texmf-doc}:
-
-\begin{itemize*}
-\item{uproszczony chiski:} \OnCD{texmf-doc/doc/chinese/texlive-zh-cn}
-\item{czeski/sowacki:} \OnCD{texmf-doc/doc/czechslovak/texlive-cz}
-\item{angielski:} \OnCD{texmf-doc/doc/english/texlive-en}
-\item{francuski:} \OnCD{texmf-doc/doc/french/texlive-fr}
-\item{niemiecki:} \OnCD{texmf-doc/doc/german/texlive-de}
-\item{polski:} \OnCD{texmf-doc/doc/polish/texlive-pl}
-\item{rosyjski:} \OnCD{texmf-doc/doc/russian/texlive-ru}
-\end{itemize*}
-
-\subsection{Predefiniowane drzewa katalogw texmf}
-\label{sec:texmftrees}
-
-W tej czci wymieniono wszystkie uywane przez system, predefiniowane zmienne
-specyfikujce drzewa katalogw texmf, omwiono te ich przeznaczenie.
-Uruchomiajc polecenie \texttt{texconfig conf}, zobaczymy wartoci tych
-zmiennych, dziki czemu atwo ustalimy, ktre katalogi w~naszej instalacji s
-przypisane do konkretnych zmiennych.
-
-\begin{ttdescription}
-\item [TEXMFMAIN] Drzewo katalogw zawierajce podstawowe dla
- dystrybucji elementy systemu, jak skrypty (np. \verb+web2c/mktexdir+),
- i~inne pliki pomocnicze oraz ich dokumentacj (nie zawiera zatem
- pakietw makr ani formatw).
-\item [TEXMFDIST] Drzewo katalogw zawierajce pakiety makr, fontw itp.,
- tak jak s one oryginalnie dystrybuowane; drzewo to moe by
- wspdzielone z~dowoln dystybucj.
-\item [TEXMFLOCAL] Drzewo katalogw, ktre administratorzy mog wykorzysta
- do przechowywania lokalnych makr, fontw itp., dostpnych dla wszystkich
- uytkownikw serwera.
-\item [TEXMFHOME] Drzewo katalogw dla prywatnych makr, fontw itp.
- uytkownika. Rozwinicie tej zmiennej zaley domylnie od wartoci przypisanej
- zmiennej systemowej \verb+$HOME+ (w~Windows \verb+%USERPROFILE%+).
-\item [TEXMFCONFIG] Drzewo katalogw wykorzystywane przez narzdzia
- \verb+texconfig+, \verb+updmap+ oraz \verb+fmtutil+ do przechowywania
- danych konfiguracyjnych (domylnie w~ramach \envname{TEXMFHOME}).
-\item [TEXMFSYSCONFIG] Drzewo katalogw wykorzystywane przez narzdzia
- \verb+texconfig-sys+, \verb+updmap-sys+ oraz \verb+fmtutil-sys+
- do przechowywania danych konfiguracyjnych dla caej instalacji.
-\item [TEXMFVAR] Drzewo katalogw wykorzystywane przez \verb+texconfig+,
- \verb+updmap+ i~\verb+fmtutil+ do przechowywania wygenerowanych plikw
- formatw i~map fontowych (domylnie w~ramach \envname{TEXMFHOME}).
-\item [TEXMFSYSVAR] Drzewo katalogw wykorzystywane przez
- \verb+texconfig-sys+, \verb+updmap-sys+ oraz \verb+fmtutil-sys+, a~take
- przez program \verb+tlmgr+ do przechowywania wygenerowanych plikw
- formatw i~map fontowych dla caej instalacji.
-\end{ttdescription}
-
- %Wicej informacji na temat \texttt{texconfig} znajdziemy
- %w~czci~\ref{sec:texconfig}, na str.~\pageref{sec:texconfig}.
-
-\noindent
-Domylny ukad katalogw:
-\begin{description}
- \item[oglnosystemowy katalog instalacji] moe zawiera kilka wyda \TL{}:
- \begin{ttdescription}
- \item[2007] poprzednie wydanie,
- \begin{ttdescription}
- \item [...]
- \end{ttdescription}
- \item[2008] wydanie aktualne:
- \begin{ttdescription}
- \item [bin] ~
- \begin{ttdescription}
- \item [i386-linux] programy dla \GNU/Linux
- \item [...]
- \item [universal-darwin] programy dla \MacOSX
- \item [win32] programy dla Windows
- \end{ttdescription}
- \item [texmf] okrelany zmienn \envname{TEXMFMAIN}
- \item [texmf-dist] \envname{TEXMFDIST}
- \item [texmf-doc] \envname{TEXMFDOC}
- \item [texmf-var] \envname{TEXMFSYSVAR}
- \item [texmf-config] \envname{TEXMFSYSCONFIG}
- \end{ttdescription}
- \item [texmf-local] \envname{TEXMFLOCAL}, katalog zachowywany
- od wydania do wydania,
- \end{ttdescription}
- \item[katalog domowy uytkownika] (\texttt{\$HOME} lub
- \texttt{\%USERPROFILE\%})
- \begin{ttdescription}
- \item[.texlive2007] prywatne pliki konfiguracyjne
- poprzedniego wydania:
- \item[.texlive2008] prywatne pliki konfiguracyjne
- dla biecego wydania:
- \begin{ttdescription}
- \item [texmf-var] \envname{TEXMFVAR}
- \item [texmf-config] \envname{TEXMFCONFIG}
- \end{ttdescription}
- \item[texmf] \envname{TEXMFHOME} prywatne makra, fonty itp.
- \end{ttdescription}
-\end{description}
-
-\subsection{Rozszerzenia \protect\TeX-a}
-\label{sec:tex-extensions}
-
-Standardowy \TeX{} zosta zamroony, ale jest i~bdzie w~przyszoci dostpny
-w~dystrybucji. \TL{} zawiera ponadto kilka wersji rozszerzonych
-standardowego \TeX-a:
-
-\begin{description}
-\item [\eTeX] wersja \label{text:etex} programu \TeX{}, w~ktrej dodano
- poyteczny zestaw nowych polece wbudowanych
- (dotyczcych gwnie rozwijania makr, leksemw znakowych, interpretacji
- znacznikw itp.) oraz rozszerzenie \TeXXeT{} dla skadu
- od prawej do lewej. W~trybie domylnym \eTeX{} jest w~100\% zgodny ze
- standardowym programem \TeX. Wicej szczegw mona znale
- w~\OnCD{texmf-dist/doc/etex/base/etex_man.pdf}.
-
-\item [pdf\TeX] program zawierajcy silnik \eTeX, umoliwiajcy
-tworzenie plikw zarwno w~formacie PDF, jak i~\dvi{}. Jest on domylnym
-programem dla wikszoci formatw (prcz plain \TeX), nie ma wic obecnie
-rozrnienia na ,,maszyny'' \textsf{pdftex} i \textsf{pdfetex}, jak to miao
-miejsce w~poprzednich wersjach programw i~w~poprzednich dystrybucjach \TL.
-Podrczniki znajdziemy w~katalogu
-\OnCD{texmf-dist/doc/pdftex/manual/pdftex-a.pdf},
-za przykad wykorzystania -- w~pliku
-\OnCD{texmf-dist/doc/pdftex/manual/samplepdf/samplepdf.tex}.
-
-\item [Lua\TeX] docelowo sukcesor pdf\TeX-a, z~ktrym ma by zgodny wstecz.
- Powinien take zastpi Aleph (patrz niej). Zaczony
-interpreter Lua (patrz strona domowa \url{http://www.lua.org/})
-pozwala na eleganckie rozwizanie wielu trudnych problemw \TeX-a.
-Program \filename{texlua} ma funkcjonalno samodzielnego
-interpretera Lua, co sprawia, e jest uywany w~\TL{} do wielu zada.
-Patrz \url{http://www.luatex.org/} i~na \DVD{}
-\OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}.
-
-\item [Xe\TeX] umoliwia kodowanie tekstw w~Unicode oraz korzystanie
-z~fontw OpenType (take tych dostpnych w~systemie operacyjnym),
-przy czym stosuje biblioteki obce, patrz
-\OnCD{texmf-dist/doc/xetex/XeTeX-reference.pdf} lub
-\url{http://scripts.sil.org/xetex}.
-
-\item [\OMEGA{} (Omega)] program, ktry pracuje wewntrznie ze znakami
-kodowanymi 16-bitowo (Unicode), pozwalajc skada jednoczenie
-wikszo tekstw spotykanych na wiecie. Wspomaga dynamicznie
-adowane tzw. ,,procesy tumaczenia \OMEGA'' (\acro{OTP}), co pozwala
-uytkownikowi definiowa zoone transformacje, wykonywane na dowolnych
-strumieniach wejciowych. Wicej szczegw znale mona na \DVD:
-\OnCD{texmf-dist/doc/omega/base/doc-1.8.tex} (dokumentacja niezbyt aktualna;
-sam program te od dawna nie jest aktualizowany).
-
-\item [Aleph] czy rozszerzenia \OMEGA\ i~\eTeX; powsta jako niezaleny
-projekt z~potrzeby stabilnej ,,uywalnoci'' programu Omega, w~sytuacji
-gdy ten jest cigle w~fazie eksperymentalnej. Minimalna dokumentacja:
-\OnCD{texmf-dist/doc/aleph/base}.
-
-\end{description}
-
-\subsection{Inne waniejsze programy \protect\TL}
-
-Poniej zestawiono inne najczciej uywane programy dostpne
-w~dystrybucji \TL{}:
-
-\begin{cmddescription}
-
-\item[bibtex] tworzenie spisw bibliograficznych;
-
-\item[makeindex] tworzenie posortowanych skorowidzw;
-
-\item[dvips] konwersja \dvi{} do \PS{};
-
-\item[xdvi] przegldarka plikw \dvi{} dla X~Window;
-
-\item[dvilj] sterownik dla drukarek HP LaserJet;
-
-\item [dv2dt, dt2dv] konwerter \dvi{} do/z tekstu ASCII;
-
-\item [dviconcat, dviselect] programy do manipulacji stronami w~plikach
- \dvi{};
-
-\item [dvipdfmx] konwersja \dvi{} do PDF, metoda alternatywna w~stosunku
- do wspomnianego wyej programu pdf\TeX{} (pakiety
- \pkgname{ps4pdf} i~\pkgname{pdftricks} dostarczaj kolejnych moliwoci);
-
-\item [psselect, psnup, \ldots] narzdzia do manipulacji na plikach
-postscriptowych;
-
-\item [lacheck] kontrola syntaktyki plikw \LaTeX-owych;
-
-\item [texexec, texmfstart] programy uruchamiajce dla Con\TeX{}t;
-
-\item [tex4ht] postprocesor dla \TeX-a konwersji do HTML i XML.
-
-\end{cmddescription}
-
-%%! zostawiam t cz, cho wyleciaa z wersji oryginalnej!!! 27.08.2003
-
-\subsection[Pakiety i ich zestawy]{Pakiety i ich zestawy}
-\label{packages}
-Zawarto drzew \texttt{texmf} na \TL{} zostaa do celw instalacji
-zorganizowana w~szereg ,,zestaww'' (\emph{collections}),
-z~ktrych kady posiada zbir ,,pakietw'' (\emph{packages}; jest ich obecnie
-ponad 2500). Normalna instalacja pozwala uytkownikowi skopiowa
-z~\DVD{} na twardy dysk jeden lub wicej zestaww, mona te
-zainstalowa jedynie pojedynczy pakiet.
-
-Zestawy pozwalaj lepiej dobra instalowane skadniki, a~take okreli,
-jakie jzyki bd obsugiwane po instalacji. Najwaniejszy zestaw, wymagany
-dla wikszoci zastosowa, to ,,basic''. Zestawy ,,latex''
-i~,,pdftex'' s rekomendowane dla wikszoci uytkownikw. Pozostae
-zestawy s opcjonalne.
-
-Oto dostpne zestawy i~krtki opis ich zawartoci:
-
-\begin{description}
-\item[basic] podstawowe programy, pakiety makr i~fontw systemu \TeX{},
- pliki konfiguracyjne dla podstawowych sterownikw;
-\item[bibtexextra] dodatkowa, obszerna biblioteka stylw Bib\TeX-owych
- i~bazy danych bibliograficznych (podstawowe style znajduj si w~zestawie
- ,,basic'');
-\item[chemistry] pakiety makr do skadu wzorw chemicznych;
-\item[context] pakiet makr do Con\TeX{}t -- ,,dialektu'' \TeX-a
- autorstwa Hansa Hagena;
-\item[documentation] dodatkowe, uyteczne dokumentacje;
-\item[etex] pliki pomocnicze dla programu e-\TeX;
-\item[extrabin] rne programy pomocnicze; zestaw zawiera m.in.
- programy i~makra dla systemu texinfo, programy do manipulacji na plikach
- DVI itp.;
-\item[fontbin] programy do konwersji plikw fontowych oraz testowania
- i~instalacji fontw (zestaw do tworzenia fontw wirtualnych, manipulacji
- plikami .gf i~.pk, programy \texttt{mft}, \texttt{fontinst} itp.);
-\item[fontsrecommended] obszerna biblioteka czciej uywanych fontw
- w~postaci rdowej (.mf) bd fontw obwiedniowych oraz pliki z~definicjami
- i~stylami \LaTeX-a dla tych fontw;
-\item[fontsextra] biblioteka rnych rzadziej uywanych fontw;
-\item[formatsextra] pliki pomocnicze do generowania dodatkowych
- ,,formatw'' (tj. obszerne zestawy makr suce do wstpnego przetworzenia
- i~utworzenia pliku \texttt{.fmt});
-\item[games] pakiety do prezentacji zapisu rnych gier (szachy,
- bryd itp.);
-\item[genericextra] obszerna biblioteka makr, trudnych do sklasyfikowania,
- dziaajcych z~rnymi formatami (Plain, \LaTeX{} itp.);
-\item[htmlxml] pakiety konwersji \LaTeX-a do XML/HTML oraz do skadu
- dokumentw XML/SGML;
-\item[lang\dots] wsparcie poszczeglnych jzykw; zestawy zawieraj
- wzorce przenoszenia wyrazw i~makra obsugi danych jzykw, czasem te
- specyficzne fonty itp., przykadowo:
- %\item[langarmenian] armeski;
-%\item[langcjk] pakiety CJK (obsuga chiskiego, japoskiego i~koreaskiego);
-%\item[langcroatian] chorwacki;
-%\item[langcyrillic] fonty i makra do skadu cyrylic;
-%\item[langczechslovak] fonty i pakiety makr dla czeskiego i~sowackiego;
-%\item[langdanish] duski;
-%\item[langdutch] holenderski;
-%\item[langfinnish] fiski;
-%\item[langfrench] francuski;
-%\item[langgerman] niemiecki;
-%\item[langgreek] grecki;
-%\item[langhungarian] wgierski;
-%\item[langindic] wsparcie dla jzykw indyjskich;
-%\item[langitalian] woski;
-%\item[langlatin] acina;
-%\item[langmanju] jzyk Manju;
-%\item[langmongolian] mongolski;
-%\item[langnorwegian] norweski;
-%\item[langother] wzorce przenoszenia wyrazw dla innych jzykw;
-\item[langpolish] zawiera polskie pakiety: makra do tworzenia formatu MeX,
- pakiety \texttt{polski}, \texttt{mwcls}, fonty i~makra dodatkowe,
- przydatne dla polskich uytkownikw, dokumentacje w~jzyku polskim;
-%\item[langportuguese] portugalski;
-%\item[langspanish] hiszpaski;
-%\item[langswedish] szwedzki;
-%\item[langtibetan] fonty i~wsparcie do skadu tybetaskiego;
-%\item[langukenglish] angielski (brytyjski);
-%\item[langvietnamese] wietnamski;
-\item[latex] podstawowe pakiety \LaTeX-a;
-\item[latexrecommended] rekomendowany zestaw czsto uywanych pakietw
- dodatkowych;
-\item[latex3] pakiety-,,zwiastuny'' \LaTeX3, dziaajce z~\LaTeXe;
-\item[latexextra] bogaty wybr dodatkowych pakietw dla \LaTeX-a;
-\item[mathextra] dodatkowe pakiety do skadu zaawansowanej matematyki;
-\item[metapost] MetaPost i~pakiety do tworzenia rysunkw z~uyciem
- MetaFonta;
-\item[music] makra do skadu nutowego;
-\item[omega] rozszerzenie \TeX{}a autorstwa Johna Plaice'a i~Yannisa Haralambousa, dziaajce ze znakami kodowanymi 16-bitowo;
-\item[pdftex] pliki pomocnicze dla pdf\TeX{}-a, wersji programu \TeX{}
- tworzcej pliki w~formacie PDF;
-\item[pictures] pakiety do tworzenia diagramw i~innych obiektw graficznych;
-\item[plainextra] dodatkowe biblioteki makr dla Plain \TeX;
-\item[psutils] narzdzia do manipulacji plikami \PS-owymi;
-\item[publishers] pakiety makr pochodzce od rnych wydawnictw;
-\item[t1utils] narzdzia do obsugi fontw w~formacie Type~1;
-\item[texbooks] przykady i~inne materiay autorstwa D.E.~Knutha;
-\item[ttfutils] narzdzia do konwersji fontw True Type.
-\end{description}
-%--------------------------
-%%! koniec pozostawionej sekcji 27.08.2003
-
-Plik \texttt{tlpdb/texlive.tlpdb} (wykorzystywany podczas instalacji)
-zawiera spis wszystkich plikw w~kadym pakiecie.
-
-\subsection{Fonty w \protect\TL}
-\label{sec:tl-fonts}
-
-\TL{} zawiera wiele wysokiej jakoci fontw skalowanych. Patrz
-\url{http://tug.org/fonts} oraz
-\OnCD{texmf-doc/doc/english/free-math-fonts-survey}.
-
-%====
-
-\section{Instalacja}
-\label{sec:install}
-
-\subsection{Start instalacji}
-\label{sec:inst-start}
-
-Instalacj \TL{} uruchamiamy skryptem \filename{install-tl}
-(\filename{install-tl.bat} dla Windows) z~pytki \TK{} \DVD{}
-bd dostpnym w~pobranym z~sieci pakiecie instalacyjnym.
-
-\begin{description}
-\item [Instalator z sieci:] z~archiwum \CTAN, z~katalogu
-\dirname{systems/texlive/tlnet}
-(\url{http://mirror.ctan.org/systems/texlive/tlnet} automatycznie
-przekierowuje do najbliszej kopii \CTAN) naley pobra plik
-\filename{install-tl.zip} (dla Unix i Windows) lub znacznie mniejszy
-\filename{install-unx.tar.gz} (tylko dla Unix). Po rozpakowaniu,
-w~katalogu \dirname{install-tl/} znajdziemy skrypty instalacyjne
-\filename{install-tl} i~\filename{install-tl.bat}.
-
-\item [\TeX{} Collection \DVD:] po zamontowaniu pytki naley
-zmieni katalog biecy na \dirname{texlive} (w~Windows program
-instalacyjny powinien uruchomi si automatycznie). \DVD{} otrzymamy
-w ramach czonkowstwa w~dowolnej Grupie Uytkownikw Systemu \TeX{}
-(kontakt w Polsce \url{http://www.gust.org.pl}).
-\end{description}
-
-Dalsze kroki omwiono dokadniej w~nastpnych czciach.
-
-\subsubsection{Unix}
-
-\noindent
-Poniej \texttt{>} oznacza prompt systemu; to, co wpisuje uytkownik,
-zaznaczono \Ucom{\texttt{pogrubieniem}}. W~systemach zgodnych z~Unix
-naley wykona w~oknie terminala:
-\begin{alltt}
-> \Ucom{cd /path/to/installer}
-> \Ucom{perl install-tl}
-\end{alltt}
-(mona take uruchomi \Ucom{perl /path/to/installer/install-tl} lub
-\Ucom{./install-tl}; w dalszej czci nie bdziemy powtarza wszelkich
-moliwych kombinacji).
-
-Do uruchomienia w~trybie graficznym (\GUI) wymagany jest w~systemie modu
-\dirname{Perl/TK}:
-\begin{alltt}
-> \Ucom{perl install-tl -gui}
-\end{alltt}
-
-Kompletny wykaz dostpnych opcji otrzymamy, uruchamiajc:
-\begin{alltt}
-> \Ucom{perl install-tl -help}
-\end{alltt}
-
-\textbf{Uwaga dotyczca uprawnie w Unix:} program instalacyjny
-bdzie respektowa aktualn warto \code{umask}.
-Jeli wic chcemy, aby instalacja bya dostpna dla innych, to musimy
-ustawi warto np. \code{umask 002}. Wicej informacji na temat
-\code{umask} znajdziemy w~podrcznikach systemu operacyjnego.
-
-\begin{figure}[tb]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
-
- Detected platform: Intel x86 with GNU/Linux
-
- <B> binary systems: 1 out of 16
-
- <S> Installation scheme (scheme-full)
-
- Customizing installation scheme:
- <C> standard collections
- <L> language collections
- 83 collections out of 84, disk space required: 1666 MB
-
- <D> directories:
- TEXDIR (the main TeX directory):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
- [X] install macro/font doc tree
- [X] install macro/font source tree
- [ ] create symlinks in standard directories
-
- <V> Install for running from DVD
-
-Other actions:
- <I> start installation to HD
- <H> help
- <Q> quit
-
-Enter command:
-\end{boxedverbatim}
-\caption{Gwny ekran instalatora w~trybie tekstowym (\GNU/Linux)}\label{fig:text-main}
-\end{figure}
-
-\begin{figure}[tb]
-\tlpng{install-w32-main}{\linewidth}
-\caption{Gwny ekran instalatora \GUI{} (Windows)}\label{fig:gui-main}
-\end{figure}
-
-\subsubsection{Mac\,OS\,X}
-
-Jak wspomniano w czci \ref{sec:tl-coll-dists}, dla \MacOSX{}
-przygotowano odrbn dystrybucj Mac\TeX\ (\url{http://tug.org/mactex}),
-w~tym wypadku naley uy dedykowanego programu instalacyjnego, gdy
-zmienia on w~specyficzny sposb ustawienia systemu, w~szczeglnoci pozwala
-na atwe przeczanie pomidzy rnymi dystrybucjami \TeX-a dla
-\MacOSX: Mac\TeX, gw\TeX, Fink, MacPorts,\ldots
-
-Mac\TeX\ jest oparty na \TL{} i gwne drzewa katalogw s dokadnie te
-same, jedynie dodawane s katalogi ze specyficznymi dla systemu
-\MacOSX\ dokumentacjami i~aplikacjami.
-
-\subsubsection{Windows}
-
-Gdy uywamy instalatora pobranego z~sieci (bd program ten nie uruchamia si
-automatycznie po woeniu \DVD{} do napdu), naley uruchomi
-\filename{install-tl.bat} (np. podwjnym klikniciem myszy).
-Mona to uczyni take z~linii polece -- gdy katalog zawierajcy ten plik
-jest biecym, wystarczy uruchomi:
-\begin{alltt}
-> \Ucom{install-tl}
-\end{alltt}
-
-W linii polece mona te poda ciek do programu, np.:
-\begin{alltt}
-> \Ucom{D:\bs{}texlive\bs{}install-tl}
-\end{alltt}
-dla \TK\ \DVD, zakadajc, e \dirname{D:} jest napdem \DVD.
-
-Instalacja w~trybie tekstowym wymaga podania:
-\begin{alltt}
-> \Ucom{install-tl -no-gui}
-\end{alltt}
-
-Wszystkie dostpne opcje wywietlimy uruchamiajc:
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-
-\subsubsection{Instalator w trybie tekstowym}
-
-Rysunek \ref{fig:text-main} przedstawia gwny ekran programu
-\filename{install-tl} w~trybie tekstowym w~systemie Unix.
-W tym trybie nie uywamy ani klawiszy kursora, ani myszy,
-tylko wycznie klawiszy cyfr i~liter (uwaga: due i mae litery s
-rozrniane!). Wybran opcj zatwierdzamy klawiszem Enter.
-Instalator w~trybie tekstowym jest dlatego tak prosty, by dziaa na
-moliwie wielu platformach, nawet wyposaonych w~ubogie biblioteki Perla
-(dla Windows zaczono taki wanie podzbir dystrybucji Perla).
-
-\subsubsection{Instalator w trybie graficznym}
-
-Rysunek \ref{fig:gui-main} pokazuje instalator w~trybie graficznym
-(zrzut ekranu w systemie Windows).
-
-\subsection{Podczas instalacji}
-\label{sec:runinstall}
-
-Program instalacyjny jest z~zaoenia na tyle prosty, e szczegowe
-wyjanienia s zbdne. Podamy jednak kilka uwag dotyczcych rnych opcji
-i~dostpnych podmenu.
-
-\subsubsection{Menu: binary systems (tylko Unix)}
-\label{sec:binary}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Available sets of binaries: (Dostpne zestawy programw dla:)
-===============================================================================
-
- a [ ] alpha-linux DEC Alpha with GNU/Linux
- b [ ] amd64-freebsd x86_64 with FreeBSD
- c [ ] hppa-hpux HP-UX
- d [ ] i386-freebsd Intel x86 with FreeBSD
- e [X] i386-linux Intel x86 with GNU/Linux
- f [ ] i386-openbsd Intel x86 with OpenBSD
- g [ ] i386-solaris Intel x86 with Sun Solaris
- h [ ] mips-irix SGI IRIX
- i [ ] powerpc-aix PowerPC with AIX
- j [ ] powerpc-linux PowerPC with GNU/Linux
- k [ ] sparc-linux Sparc with GNU/Linux
- l [ ] sparc-solaris Sparc with Solaris
- m [ ] universal-darwin universal binaries for MacOSX/Darwin
- o [ ] win32 Windows
- p [ ] x86_64-linux x86_64 with GNU/Linux
-\end{boxedverbatim}
-\caption{Wybr platformy (systemu operacyjnego)}\label{fig:bin-text}
-\end{figure}
-
-Rysunek \ref{fig:bin-text} pokazuje (w~trybie tekstowym) wybr platformy
-(systemu operacyjnego).
-Domylnie instalowane s tylko programy dla biecej platformy,
-ale menu to pozwala wybra take zestaw dla innych platform. Moe by to
-przydatne do instalacji na serwerze i~wspdzielenia zasobw w~sieci
-dla rnych systemw operacyjnych bd dla instalacji
- %\textit{dual-boot}
- dla kilku systemw na tej samej maszynie.
-
-\subsubsection{Wybr tego, co ma by zainstalowane}
-\label{sec:components}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Select a scheme: (Wybr schematu do instalacji:)
-===============================================================================
-
- a [ ] TeX Live basic scheme
- b [ ] TeX Live scheme for ConTeXt
- c [X] TeX Live full scheme
- d [ ] GUST TeX Live scheme
- e [ ] GUTenberg TeX Live scheme
- f [ ] TeX Live medium scheme
- g [ ] TeX Live minimal scheme
- h [ ] TeX Live for Omega users
- i [ ] teTeX scheme
- j [ ] XML typesetting scheme
-\end{boxedverbatim}
-\caption{Menu: wybr schematw}\label{fig:scheme-text}
-\end{figure}
-
-Rysunek \ref{fig:scheme-text} pokazuje menu ,,Wybr schematw''. Schematy to
-obszerne zestawy pakietw, przeznaczone do wstpnego wyboru instalowanych
-komponentw. Mamy tu schematy do instalacji: podstawowej (\optname{basic}),
-typowej (\optname{medium}) i~penej (\optname{full}; jest ona
-domylna), pozostae przygotowano z~myl o~wybranych grupach
-uytkownikw (np.~GUST i~GUTenberg przygotoway schematy dla swoich
-czonkw) lub zastosowaniach (np.~XML lub Omega).
-
-\begin{figure}[tbh]
-\begin{center}
-\tlpng{stdcoll}{.7\linewidth}
-\caption{Menu Standard Collections (Kolekcje standardowe) (Linux)}\label{fig:collections-gui}
-\end{center}
-\end{figure}
-
-Wstpnie wybrane schematy mona modyfikowa. W skad ,schematw'' wchodz
-tzw. ,,kolekcje'', ktre mona wybra w~kolejnych menu o~nazwach: ,,Kolekcje
-standardowe'' i~,,Kolekcje jzykowe'' (rysunek \ref{fig:collections-gui}).
-Kolekcje stanowi niszy poziom ni schematy, a~same skadaj si z
-,,pakietw''. Dopiero pakiety zawieraj waciwe pliki makr, fontw itp.
-Jeli chcemy doda lub usun pakiet, to po instalacji waciwej uyjemy
-programu \prog{tlmgr} (patrz cz~\ref{sec:tlmgr}).
-
-\subsubsection{Katalogi}
-\label{sec:directories}
-
-Domylny ukad katalogw opisano w czci~\ref{sec:texmftrees} na
-str.~\pageref{sec:texmftrees}. Pooenie domylne caej instalacji
-(\dirname{TEXDIR}) rni si w~Windows (|%PROGRAMFILES%\texlive\2008|)
-i~w~Unix (\dirname{/usr/local/texlive/2008}).
-
-Gwnym powodem, dla ktrego zmieniamy domylne pooenie \dirname{TEXDIR},
-moe by brak uprawnie. Aby zainstalowa \TL{}, nie musimy by
-administratorem systemu, musimy jednak posiada uprawnienia do zapisu
-w~docelowym katalogu. Logiczn alternatyw moe by wtedy instalacja
-w~katalogu domowym, szczeglnie wtedy, gdy bdziemy jedynym uytkownikiem.
-Stosujemy tu zapis ,,|~|'' do zaznaczenia takiego wyboru, np.
-|~/texlive/2008|. Zalecamy stosowanie katalogu z~nazw odzwierciedlajc
-rok wydania, co pozwoli na zainstalowanie obok siebie rnych wyda \TL{}.
- %%! przegadane, na razie olewam (SW)
- %(You may wish to make a
- %version-independent name such as \dirname{/usr/local/texlive-cur} via a
- %symbolic link, which you can then update after testing the new release.)
-
-Zmiana \dirname{TEXDIR} w programie instalacyjnym zmieni take cieki
-katalogw okrelone przez zmienne \dirname{TEXMFLOCAL}, \dirname{TEXMFSYSVAR}
-i~\dirname{TEXMFSYSCONFIG}.
-
-\dirname{TEXMFHOME} jest zalecanym pooeniem dla prywatnych makr i~fontw
-uytkownika. Domylnym katalogiem jest |~/texmf|. W odrnieniu od
-\dirname{TEXDIR}, znak |~| jest zachowywany w generowanych plikach
-konfiguracyjnych, poniewa w~wygodny sposb odnosi si do katalogu domowego
-podczas kadego uruchamiania programw. Znak ten rozwijany jest do zmiennej
-\dirname{$HOME} w~Unix i~\verb|%USERPROFILE%| w~Windows.
-
-\subsubsection{Opcje}
-\label{sec:options}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-<P> use letter size instead of A4 by default: [ ]
-<F> create all format files: [X]
-<D> install font/macro doc tree: [X]
-<S> install font/macro source tree: [X]
-<L> create symlinks in standard directories: [ ]
- binaries to:
- manpages to:
- info to:
-\end{boxedverbatim}
-\caption{Menu: Options (Opcje) w Unix}\label{fig:options-text}
-\end{figure}
-
-Rysunek \ref{fig:options-text} pokazuje menu (w~trybie tekstowym)
-z~dodatkowymi opcjami. Warto tu wspomnie o~trzech z nich:
-
-\begin{description}
-\item[use letter size instead of A4 by default] (uyj domylnego formatu
-papieru letter zamiast A4): pozwala okreli domylny format papieru
-dla wielu programw. Oczywicie format papieru mona specyfikowa potem
-dla kadego dokumentu.
-
-\item[create all format files] (generuj wszystkie pliki formatw):
-chocia zbdne formaty zajmuj miejsce na dysku, to zaleca si
-pozostawi t opcj wczon; jeli tego nie zrobimy, formaty bd
-generowane automatycznie (w~razie potrzeby) w~prywatnych katalogach
-\dirname{TEXMFVAR} uytkownikw, nie bd jednak odwieane, gdy w~instalacji
-zostan zaktualizowane np. programy bd wzorce przenoszenia; wskutek tego
-formaty mog utraci zgodno ze rodowiskiem, w~ktrym s uywane.
-
-\item[create symlinks in standard directories] (utwrz dowizania
- w~standardowych katalogach, tylko Unix): opcja ta pozwala unikn ustawiania
- zmiennych rodowiska po instalacji (\envname{PATH}, \envname{MANPATH}
- i~\envname{INFOPATH}), ale jej uycie nie jest zalecane, bo moe powodowa kolizje
- z ju zainstalowanym w~systemie rodowiskiem \TeX; moe by ona przydatna
- jedynie wtedy, gdy w~standardowych katalogach (np. \dirname{/usr/local/bin})
-nie ma jakichkolwiek programw \TeX-owych.
-\end{description}
-
-Po wszystkich potrzebnych ustawieniach mona rozpocz instalacj
-(klawisz ,,I''). Po instalacji zaleca si zajrze do czci
-\ref{sec:postinstall}, bo by moe potrzebne oka si jeszcze
-dodatkowe kroki.
-
-\subsubsection{Uruchamianie bezporednio z DVD{} (tylko w trybie tekstowym)}
-\label{sec:fromdvd}
-
-Aby uruchomi programy bezporednio z~pytki \DVD{} naley wybra
-opcj ,,|V|'', co zmienia menu na przedstawione na
-rys.~~\ref{fig:main-fromdvd}.
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
- <D> directories:
- TEXDIRW (Writable root):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
-
- <V> set up for installing to hard disk
-
-Other actions:
- <I> start installation for running from DVD
- <H> help
- <Q> quit
-\end{boxedverbatim}
-\caption{Menu gwne dla uruchamiania z~\optname{DVD}}%
-\label{fig:main-fromdvd}
-\end{figure}
-
-Zwrmy uwag na nastpujce zmiany: znikny wszystkie opcje dotyczce wyboru
-pakietw, sekcja dotyczca katalogw pokazuje teraz \dirname{TEXDIRW} --
-katalog z~prawami do zapisu. Pozwoli to uruchamia dowolny program
-bezporednio z~pytki; na dysku twardym znajd si (w odpowiednich
-katalogach) jedynie niezbdne pliki konfiguracyjne.
-
-Poniewa struktura katalogw rni si nieco od domylnej, niezbdne bd
-pewne czynnoci konfiguracyjne, omwione w~czci~\ref{sec:postinstall}.
-
- %Z powodu pilniejszych prac i braku czasu
- Instalator \GUI nie posiada opcji ,,V'', dlatego
- %ale jest dostpna dla wszystkich systemw.
- uytkownicy Windows mog uruchomi program jedynie
-z~linii polece, jak opisano to w~czci~\ref{sec:cmdline}.
-
-W~rozdziale \ref{sec:portable-unix} opisano jeszcze inny, przenony sposb
-uruchamiania \TL, ktry nie wymaga zmian w~konfiguracji systemu
-(a~nawet nie pozwala na nie).
-
-\subsection{Parametry instalacji z linii polece}
-\label{sec:cmdline}
-
-Uruchom
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-aby wywietli wszystkie dostpne parametry.
- % Either |-| or |--| can be used to introduce option names.
- Najbardziej interesujce to:
-
-\begin{ttdescription}
-\item[-gui] uyj programu w~wersji graficznej (\GUI), jeli to moliwe;
- wymagane jest posiadanie moduu Perl/Tk
- (\url{http://tug.org/texlive/distro.html#perltk});
- gdy jest on niedostpny, program instalacyjny uruchomiony zostanie
- w trybie tekstowym;
-\item[-no-gui] wymusza tryb tekstowy, np. w~Windows potrzebny jest on
- dla przygotowania do uruchamiania bezporednio z~\DVD;
-\item[-lang {\sl LL}] pozwala wybra jzyk komunikatw,
- \textsl{LL} oznacza tu dwuliterowy kod jzyka; aktualnie dostpne s:
- angielski (\texttt{en}, domylny), niemiecki (\texttt{de}), francuski
- (\texttt{fr}), holenderski (\texttt{nl}), polski (\texttt{pl}),
- soweski (\texttt{sl}) i~wietnamski (\texttt{vi}); program samoczynnie
- wcza jzyk, ale jeli jest to niemoliwe, komunikaty i menu bd
- wywietlane w jzyku angielskim;
-\item[-profile {\sl profile}] program instalacyjny zapisuje plik
- \filename{texlive.profile} w~katalogu \dirname{2008/tlpkg}, co pozwala
- wykorzysta go dla powielenia wszystkich wyborw i~ustawie w~kolejnych
- instalacjach;
- %%! zbdny przykad, patrz wer. oryg. (SW)
-\item [-location {\sl url/path}] pozwala okreli inne ni domylne rdo
- instalacji (patrz poniej).
-\end{ttdescription}
-
-\subsubsection{Parametr \optname{location}}
-\label{sec:location}
-
-Parametrowi \optname{location} mona przypisa adres w sieci
-(rozpoczynajcy si od \texttt{ftp:}, \texttt{http:} lub \texttt{file:/}),
-lub pen ciek. Jeli podany argument wskazuje na lokalny dysk
-(cieka bd adres \texttt{file:/}), to automatycznie zostanie dostosowany
-typ instalacji (ze skompresowanych plikw bd nie): gdy dostpny bdzie
-katalog \dirname{archive}, zawierajcy pliki \filename{.tar.lzma}, wybrana
-zostanie instalacja z~tyche plikw, nawet jeli dostpne bd rwnolegle
-katalogi z~plikami nieskompresowanymi.
-
-%%! pki co, brak czasu na takie szczegy (SW)
-%%! When giving an \texttt{http:} or \texttt{ftp:} location, trailing
-%%! `\texttt{/}' characters and/or a trailing `\texttt{/tlpkg}' component
-%%! are ignored. For example, you could choose a particular \CTAN\ mirror
-%%! with something like:
-%%! \url{http://ctan.example.org/tex-archive/texlive/tlnet/2008},
-%%! substituting of course a proper hostname and its particular top-level
-%%! \CTAN\ path (the list of \CTAN\ mirrors is maintained at
-%%! \url{http://ctan.org/mirrors}) for |ctan.example.org/tex-archive|. The
-%%! default is to pick a mirror automatically, using
-%%! \url{http://mirror.ctan.org}; in any case, the chosen host is used for
-%%! the entire download.
-
-\subsection{Czynnoci poinstalacyjne}
-\label{sec:postinstall}
-
-Cz ta nie dotyczy systemu Windows, dla ktrego program instalacyjny
-przeprowadza ca konfiguracj, wcznie z~menu systemowym i~ikonami na
-pulpicie. Ponisze uwagi mog by przydatne dla uytkownikw innych systemw.
-
-\subsubsection{Gdy zastosujemy dowizania symboliczne}
-
-Uycie opisanej w~czci~\ref{sec:options} opcji tworzenia dowiza
-symbolicznych w~standardowych katalogach nie wymaga zmian w zmiennych
-rodowiska systemowego.
-
-\subsubsection{Zmienne rodowiska dla Unix}
-\label{sec:env}
-
-Po instalacji trzeba do zmiennej \envname{PATH} doda ciek do
-programw \TL. Kada z~obsugiwanych platform ma wasny podkatalog
-w~ramach \dirname{TEXDIR/bin}. List platform i odpowiadajcych im katalogw
-przedstawiono na rys.~\ref{fig:bin-text}.
-
-Rwnie korzystanie z~systemowych przegldarek dokumentacji \prog{man}
-i~\prog{info} staje si moliwe dopiero
-po dodaniu odpowiednich katalogw do ich cieek przeszukiwania.
-
-Dla powoki zgodnej z~Bourne shell (\cmdname{sh}, \cmdname{bash},
-\cmdname{ksh}) moemy dopisa do pliku \filename{$HOME/.profile}:
-
-\begin{sverbatim}
-PATH=/usr/local/texlive/2008/bin/i386-linux:$PATH; export PATH
-MANPATH=/usr/local/texlive/2008/texmf/doc/man:$MANPATH; export MANPATH
-INFOPATH=/usr/local/texlive/2008/texmf/doc/info:$INFOPATH; export INFOPATH
-\end{sverbatim}
-
-W~wypadku csh lub tcsh naley zmodyfikowa plik \filename{$HOME/.cshrc}, np:
-
-\begin{sverbatim}
-setenv PATH /usr/local/texlive/2008/bin/i386-linux:$PATH
-setenv MANPATH /usr/local/texlive/2008/texmf/doc/man:$MANPATH
-setenv INFOPATH /usr/local/texlive/2008/texmf/doc/info:$INFOPATH
-\end{sverbatim}
-
-%%! ??? (SW)
-%%! Of course, you may well already have settings somewhere in your ``dot''
-%%! files, and so then the \TL\ directories should simply be merged in as
-%%! appropriate.
-
-%%! ??? (SW)
-%%! \subsubsection{Environment variables: global configuration}
-%%! \label{sec:envglobal}
-%%!
-%%! If you want to make these changes globally, or for a user newly added to
-%%! the system, then you are on your own; there is just too much variation
-%%! between systems in how and where these things are configured.
-%%!
-%%! Our two hints are: 1)~you may want to check for a file
-%%! \filename{/etc/manpath.config} and, if present, add lines such as
-%%!
-%%! \begin{sverbatim}
-%%! MANPATH_MAP /usr/local/texlive/2008/bin/i386-linux \
-%%! /usr/local/texlive/2008/texmf/doc/man
-%%! \end{sverbatim}
-%%!
-%%! And 2)~check for a file \filename{/etc/environment} which may define the
-%%! search path and other default environment variables.
-
-\subsubsection{Gdy uruchamiamy programy z~DVD}
-
-Programy \TL{} wyszukuj potrzebne dane w~rnych drzewach katalogw
-korzystajc z~pliku \filename{texmf.cnf}. Plik ten znajdowany jest w caej
-serii pooe wzgldem pooenia samych programw, ale zasada ta nie dziaa,
-gdy uruchamiamy programy bezporednio z~\DVD. Wynika to z faktu, e niektre
-pliki s zapisywane na twardym dysku (\DVD{} jest medium tylko do odczytu)
-i~trac tym samym predefiniowane wzgldne pooenie. Wymagane jest zatem
-zdefiowanie w~rodowisku zmiennej \envname{TEXMFCNF}, ktra wskae pooenie
-\filename{texmf.cnf}. Nadal jest potrzebna modyfikacja zmiennej
-\envname{PATH}, jak opisano wyej.
-
-Na zakoczenie instalacji program powinien pokaza komunikat informujcy,
-jak warto naley przypisa zmiennej \envname{TEXMFCNF}. Gdybymy
-to przeoczyli -- wartoci t jest \dirname{$TEXMFSYSVAR/web2c}, czyli dla
-domylnych ustawie (\dirname{/usr/local/texlive/2008/texmf-var/web2c})
-potrzebujemy deklaracji:
-\begin{sverbatim}
-TEXMFCNF=/usr/local/texlive/2008/texmf-var/web2c; export TEXMFCNF
-\end{sverbatim}
-lub, dla [t]csh:
-\begin{sverbatim}
-setenv TEXMFCNF /usr/local/texlive/2008/texmf-var/web2c
-\end{sverbatim}
-
-\subsubsection{\ConTeXt{} Mark IV}
-
-Tak zwany ,,stary'' \ConTeXt{} dziaa jak dotychczas. Nowy \ConTeXt{}
-,,Mark~IV'' wymaga rcznego dostrojenia -- patrz:
-\url{http://wiki.contextgarden.net/Running_Mark_IV}.
-
-\subsubsection{Integracja lokalnych i prywatnych pakietw makr}
-\label{sec:local-personal-macros}
-
-Jak ju wspomniano w~czci~\ref{sec:texmftrees}, katalog \dirname{TEXMFLOCAL}
-(domylnie \dirname{/usr/local/texlive/texmf-local} lub
-\verb|C:\Program Files\texlive\texmf-local|) przeznaczony jest na lokalne
-(np. w~danej sieci komputerowej) fonty oraz pakiety makr. Z~kolei
-\dirname{TEXMFHOME} (domylnie \dirname{$HOME/texmf} lub
-\verb|%USERPROFILE%\texmf|) jest przeznaczony na prywatne makra i~fonty
-uytkownika. W zamierzeniu oba te katalogi powinny by zachowywane przy
-instalacji nowszych wersji \TL{}, a~ich zawarto ma by automatycznie
-dostpna w~kolejnych wydaniach. Zalecamy zatem, by nie
-przedefiniowywa \dirname{TEXMFLOCAL}, co pozwoli unikn rcznego
-konfigurowania w~przyszoci.
-
-W~obu drzewach katalogw pliki powinny by umieszczane w~odpowiednich
-podkatalogach, zgodnie z~zaleceniami TDS (patrz: \url{http://tug.org/tds},
-take plik \filename{texmf/web2c/texmf.cnf}). Przykadowo pliki klas lub
-makr \LaTeX-a powinny by umieszczane w~katalogu
-\dirname{TEXMFLOCAL/tex/latex/} lub \dirname{TEXMFHOME/tex/latex/}
-(lub ich podkatalogach).
-
-\dirname{TEXMFLOCAL} po zmianie zawartoci wymaga odwieenia bazy danych --
-poleceniem \cmdname{mktexlsr} lub poprzez uycie przycisku ,,Odwie bazy
-danych'' w~graficznym trybie programu \prog{tlmgr}.
-
-\subsubsection{Integracja fontw z innych rde}
-
-Jest to, niestety,
- %mocno zagmatwany temat,
- bardzo skomplikowane zagadnienie, wymagajce sporej wiedzy
-uytkownika. Warto najpierw si dowiedzie, jakie fonty mamy dostpne
-bezpatnie (patrz cz~~\ref{sec:tl-fonts}).
-
-Alternatyw jest \XeTeX{} (patrz
-czc~\ref{sec:tex-extensions}), ktry umoliwia uycie fontw systemowych
-bez potrzeby instalowania ich dla programw \TeX-owych.
-
-\subsection{Testowanie instalacji}
-\label{sec:test-install}
-
-Po zainstalowaniu \TL{} warto sprawdzi, czy programy dziaaj
-poprawnie. Opiszemy tu podstawowe procedury testujce funkcjonowanie
-systemu w~systemach Unix. W~\MacOSX{} i~Windows najczciej uyjemy
-rodowiska graficznego (\GUI), reguy jednak bd podobne.
-
-\begin{enumerate}
-\item Sprawdzamy najpierw, czy uruchamia si program \cmdname{tex}:
-
-\begin{alltt}
-> \Ucom{tex -{}-version}
-TeX 3.1415926 (Web2C 7.5.7)
-kpathsea version 3.5.7
-...
-\end{alltt}
-Jeli uruchomienie koczy si komunikatem \emph{command not found}
-(\emph{Nie znaleziono pelecenia}), oznacza to, e niepoprawnie
-zadeklarowano zmienn \envname{PATH} (patrz deklaracje zmiennych
-rodowiska na str.~\pageref{sec:env}).
-
-\item Nastpnie przetwarzamy prosty plik \LaTeX-owy:
-\begin{alltt}
-> \Ucom{latex sample2e.tex}
-This is pdfeTeXk, Version 3.1415926...
-.....
-Output written on sample2e.dvi (3 pages, 7484 bytes).
-Transcript written on sample2e.log.
-\end{alltt}
-Gdy program nie znajduje \filename{sample2e.tex} (bd innych wymaganych
-plikw), moe to oznacza, e nadal dziaaj ustawienia zmiennych rodowiska
-bd pliki konfiguracyjne z~poprzedniej instalacji.
-Szczegow analiz, gdzie pliki s szukane i~znajdowane,
-umoliwia diagnostyka opisana w~czci \ref{sec:debugging} na
-str.~\pageref{sec:debugging}.
-
-\item Podgld wyniku skadu:
-\begin{alltt}
-> \Ucom{xdvi sample2e.dvi}
-\end{alltt}
-Polecenie to wymaga uruchomionego rodowiska graficznego X~Window.
-Dla MS Windows analogicznym poleceniem jest \cmdname{dviout} (o~ile
-samodzielnie zainstalowalimy ten program).
- %%!
- %%! You should see a new window with a nice document explaining some of the
- %%! basics of \LaTeX{}. (Well worth reading, by the way if you're new to the
- %%! system.) You do have to be running under X for \cmdname{xdvi} to work; if
- %%! you're not, or your \envname{DISPLAY} environment variable is set
- %%! incorrectly, you'll get an error \samp{Can't open display}.
-
-\item Przetwarzanie wyniku skadu do \PS{} w~celu wywietlenia lub wydruku:
-\begin{alltt}
-> \Ucom{dvips sample2e.dvi -o sample2e.ps}
-\end{alltt}
-
-\item Tworzenie dokumentu bezporednio w~formacie \acro{PDF}:
-\begin{alltt}
-> \Ucom{pdflatex sample2e.tex}
-\end{alltt}
-
-\item Podgld dokumentu \acro{PDF}:
-\begin{alltt}
-> \Ucom{gv sample2e.pdf}
-\textrm{lub:}
-> \Ucom{xpdf sample2e.pdf}
-\end{alltt}
-Programy \cmdname{gv} i~\cmdname{xpdf} s zwykle dostarczane
-w~ramach systemu operacyjnego, wobec tego nie zamieszczono ich
-na \TL. Przed samodzieln instalacj warto odwiedzi strony,
-odpowiednio: \url{http://www.gnu.org/software/gv}
-i~\url{http://www.foolabs.com/xpdf}. W~sieci dostpny jest take
-bezpatny program Adobe Reader (\url{http://www.adobe.com}).
-W~systemie Windows domylnie instalowany jest dla \TL{} program
-\cmdname{psv}
-(PS\_View), pozwalajcy przeglda pliki \cmdname{.ps} i~\cmdname{.pdf}.
-Program ten mona te zainstalowa samodzielnie w~systemach Linux
-(w~katalogu \dirname{support/} znajdziemy plik \filename{psview-5.09t.zip}).
-
-\item Inne przydatne pliki testowe:
-
-\begin{ttdescription}
-\item [small2e.tex] przykad prostszy ni \filename{sample2e};
-\item [testpage.tex] test pooenia wydruku na kartce papieru, przydatny
- do sprawdzenia, czy nasza drukarka nie wprowadza przesuni;
-\item [nfssfont.tex] suy do wydruku tablic fontowych;
-\item [testfont.tex] jak wyej, z~tym e zamiast \LaTeX-a trzeba uy plain
- \TeX{};
-\item [story.tex] najbardziej kanoniczny przykad dla plain \TeX{};
- na zakoczenie przetwarzania uruchomionego poleceniem \samp{tex story},
- po ukazaniu si \code{*}, naley wpisa \samp{\bs bye}.
-\end{ttdescription}
-
-\end{enumerate}
-
-Pocztkujcym uytkownikom polecamy stron
-\url{http://tug.org/begin.html} oraz podrcznik
-Petera Flynna \textsl{Formatting Information}, dostpny pod adresem
-\url{http://www.ctan.org/tex-archive/documentation/beginlatex}.
-
-\section{Instalacje sieciowe}
-\label{sec:netinstall}
-
-\TL{} zaprojektowano tak, by mogo z~niego korzysta wielu
-uytkownikw, nawet w~rnych systemach operacyjnych w~sieci komputerowej.
-Dziki standardowej strukturze katalogw nie ma potrzeby konfiguracji
-i~okrelania konkretnych cieek: pooenie plikw wymaganych przez programy
-\TL{} jest zdefiniowane jako wzgldne wobec samych programw. Mona to
-zobaczy w~pliku \filename{$TEXMFMAIN/web2c/texmf.cnf}, ktry zawiera np.
-takie wiersze:
-\begin{sverbatim}
-TEXMFMAIN = $SELFAUTOPARENT/texmf
-...
-TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local
-\end{sverbatim}
-W konsekwencji oznacza to, e dla rnych systemw operacyjnych bd
-uytkownikw wystarczy doda do ich cieek przeszukiwania tylko ciek
-do programw \TL{}.
-
-Moliwa jest zatem np. instalacja lokalna \TL{}, po czym przeniesienie
-caej struktury w~inne miejsce w~sieci.
-
-Uytkownicy Windows mog mie take inne wymagania.
-W~katalogu \dirname{texmf-doc/source/texlive/texlive-common/w32client}
-znajdziemy przykadowy skrypt \filename{install-w32client}, ktry
-pozwala dostosowa istniejc instalacj \TL{} dla potrzeb sieci
-(wcznie z~utworzeniem skrtw w~menu systemowym). Wystarczy
-w~tym katalogu uruchomi \filename{install-w32client.bat}.
-
-W czci~\ref{sec:kpathsea} dowiemy si wicej o~konfigurowaniu \TL{}
-i~zasadach przeszukiwania cieek.
-
-%%! 2 sekcje tumaczy Kocio (Andrzej Borzyszkowski), przeredagowa StaW
-\section{Maksymalnie przenony \protect\TL{} na DVD i~USB}
-\label{sec:portable-unix}
-
-Opcja ,,uruchom z~\DVD{}'', opisana w~rozdziale~\ref{sec:fromdvd}, jest
-wprzydatna, jeli dziaamy na swoim wasnym komputerze. Gdy gocimy na
-cudzym, to prawdopodobnie wolelibymy wybra inn moliwo, bez zbdnych
-skutkw ubocznych.
-
-W~gwnym katalogu \TL{} \DVD (w~podkatalogu \dirname{texlive} \TK{} \DVD)
-znajdziemy skrypt uniksowy \filename{tl-portable} oraz widowsowy
-\filename{tl-portable.bat}, ktre uruchamiaj terminal z~ustawieniami
-odpowiednimi do bezporedniego dostpu do \TL{} na \DVD.
-
-Gdy skrypt ten jest wykonywany po raz pierwszy, generowane s pewne pliki
-w~podkatalogu \dirname{~/.tlportable2008}, co trwa kilka chwil.
-W~kolejnych wywoaniach skrypt rozpoczyna dziaanie niemal natychmiast.
-
-Reszta systemu nie jest wiadoma istnienia \TL. Jeli chcemy, by nasz edytor
-mg wsppracowa z~\TL, to musimy uruchomi go z~innej,
-rwnolegej sesji \filename{tl-portable}.
-
-Mona rwnie uy \filename{tl-portable} do wywoania \TL{} z~pendrive'a
-\acro(USB). W~tym wypadku naley skopiowa wszystkie pliki najwyszego
-poziomu oraz zawarto (co najmniej) katalogw \dirname{bin},
-\dirname{texmf}, \dirname{texmf-dist} i~\dirname{tlpkg} na pendrive. Zajmie
-to troch czasu! Jeli kopiujemy na pendrive \acro{USB} sformatowany
-z~systemem plikw \acro{FAT}32, to naley si upewni, e dowizania
-symboliczne s zastpowane plikami (polecenie \code{cp -L}). Uywany te
-bdzie katalog \dirname{texmf-local} na pendrive.
-
-Nastpnie wywoajmy \filename{tl-portable} z~katalogu gwnego pendrive'a.
-W~tym wypadku skrypt zauway, e pendrive mona zapisywa i~uyje go do
-zapisania wygenerowanych plikw. Zawarto t mona z~powrotem zapisa na
-\DVD{} (np. do przekazania innym).
-
-\section{\cmdname{tlmgr}: zarzdzanie instalacj}
-\label{sec:tlmgr}
-
-\begin{figure}[tb]
-\tlpng{tlmgr-gui}{\linewidth}
-\caption{\prog{tlmgr} w~trybie graficznym. Lista pokietw\slash
-kolekcji\slash schematw pokae si dopiero po naciniciu klawisza
-,,aduj'' (Load).}\label{fig:tlmgr-gui}
-\end{figure}
-
-\begin{figure}[tb]
-\tlpng{tlmgr-config}{\linewidth}
-\caption{\texttt{tlmgr} w~trybie graficznym: zakadka
-konfiguracji}\label{fig:tlmgr-config}
-\end{figure}
-
-Instalator instaluje program o~nazwie \prog{tlmgr}, sucy do dalszego
-zarzdzania \TL{} po pierwotnej instalacji. Programy \prog{updmap},
-\prog{fmtutil} oraz \prog{texconfig} s nadal dostpne i~bd utrzymywane
-w~przyszoci, jednake obecnie polecanym interfejsem jest \prog{tlmgr}. Jego
-moliwoci obejmuj:
-
-\begin{itemize*}
-\item pokazanie listy schematw, kolekcji i~pakietw;
-\item instalowanie, aktualizacj, tworzenie kopii zapasowych, odtwarzanie
- oraz usuwanie pojedynczych pakietw (opcjonalnie~-- z~uwzgldnieniem
- zalenoci pomidzy pakietami);
-\item wyszczeglnianie oraz dodawanie architektur (platform systemowych);
-\item zmian opcji instalacji, takich jak rozmiar papieru czy zmiana
- pooenia rda instalacji (patrz cz~\ref{sec:location}).
-\end{itemize*}
-\textit{Ostrzeenie:} \prog{tlmgr} nie zosta zaprojektowany ani
- przetestowany z~instalacjami, ktre s wywoywane bezporednio z~\DVD.
-
-\subsection{\cmdname{tlmgr} -- tryb graficzny (GUI)}
-\prog{tlmgr} moe by uruchomiony w~trybie graficznym za pomoc polecenia
-\begin{alltt}
-> \Ucom{tlmgr -gui}
-\end{alltt}
-za w~systemie Windows poprzez wybr menu: \texttt{Start} \verb+->+
-\texttt{Programy} \verb+->+ \texttt{TeX Live 2008} \verb+->+ \texttt{TeX Live
-Manager}. Po klikniciu przycisku ,,aduj'' wywietla list dostpnych
-oraz list zainstalowanych pakietw (te ostatnie poprzedzone s ,,(i)'').
-Zakadamy oczywicie, e rda instalacji s poprawne i~s dostpne.
-
-Rysunek~\ref{fig:tlmgr-config} przedstawia zakadk konfiguracji.
-
-\subsection{Przykadowe wywoania \cmdname{tlmgr} z~linii polece}
-
-Poniszy przykad dodaje kilka pakietw, wcznie z nowym ,,silnikiem'',
-z~innego ni domylne pooenia rda instalacji:
-
-\begin{alltt}
-> \Ucom{tlmgr -location http://172.16.18.1/tldev install collection-xetex xkeyval}
-\end{alltt}
-Generuje on poniszy wynik:
-\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/2008/texmf/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-config/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-dist/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-doc/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/../texmf-local/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-var/ls-R...
-mktexlsr: Done.
-regenerating fmtutil.cnf
-running fmtutil-sys --missing
-...
-Transcript written on xelatex.log.
-fmtutil: /usr/local/texlive/2008/texmf-var/web2c/xetex/xelatex.fmt installed.
-\end{fverbatim}
-Jak wida, \prog{tlmgr} instaluje zalene pakiety i~dba o~niezbdne czynnoci
-poinstalacyjne, wcznie z~aktualizacj bazy danych nazw plikw i~powtrnym
-wygenerowaniem formatw (w przykadzie wygenerowalimy nowy format dla
-\XeTeX).
-
-Poniszy przykad prezentuje instalacj nowego jzyka oraz uruchamia powtrne
-wygenerowanie formatw:
-\begin{alltt}
-> \Ucom{tlmgr install collection-langdutch}
-\end{alltt}
-Aby wywietli informacj o~pakiecie, naley uruchomi np.:
-\begin{alltt}
-> \Ucom{tlmgr show collection-wintools}
-\end{alltt}
-co daje w~wyniku
-\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
-\end{fverbatim}
-Aktualizacja caej instalacji do najnowszej dostpnej wersji:
-\begin{alltt}
-> \Ucom{tlmgr update -all}
-\end{alltt}
-Aby unikn zdenerwowania, proponujemy zacz od:
-\begin{alltt}
-> \Ucom{tlmgr update -all -dry-run}
-\end{alltt}
-albo
-\begin{alltt}
-> \Ucom{tlmgr update -list}
-\end{alltt}
-Pen dokumentacj programu pokae polecenie:
-\begin{alltt}
-> \Ucom{tlmgr -help}
-\end{alltt}
-
-\section{Uwagi dotyczce Windows}
-\label{sec:windows}
-
-\TL\ ma tylko jeden program instalacyjny, dziaajcy zarwno w~Unix,
-jak i~w~Windows. Stworzenie takiego programu byo moliwe dopiero
-po zaniechaniu wsparcia dla starszych wersji Windows. Obecnie
-\TL\ mona instalowa tylko w~Windows 2000 i~nowszych.
-
-\subsection{Cechy specyficzne w~systemie Windows}
-\label{sec:winfeatures}
-
-W systemie Windows program instalacyjny wykonuje kilka dodatkowych czynnoci:
-\begin{description}
-\item[Menu i skrty.] W~menu systemowym instalowane jest podmenu ,,\TL'',
-ktre zawiera kilka pozycji dla programw dziaajcych w~trybie graficznym
-(\prog{tlmgr}, \prog{texdoctk}, PS\_View -- przegldarka plikw
-postscriptowych) oraz dokumentacji. Dla PS\_View tworzony jest take
-skrt (ikona) na pulpicie, umoliwiajcy ,,przeciganie\dywiz upuszczanie''
-na ikonie plikw postscriptowych.
-\item[Automatyczne ustawienie zmiennych rodowiska.]
-Po instalacji nie s wymagane adne ,,rczne'' zmiany ustawie.
-\item[Odinstalowanie.] Program instalacyjny rejestruje instalacj
-w~menu ,,Dodaj/Usu programy'' w~Panelu sterowania; odinstalowanie
-odbywa si zatem w~standardowy dla Windows sposb.
-\end{description}
-
-\subsection{Programy pomocnicze dla Windows}
-
-Aby instalacja bya kompletna, \TL{} wymaga kilku pomocniczych
-programw, ktre nie s dostarczane z~systemem Windows.
-Wiele skryptw napisano w~jzyku Perl, ponadto wiele narzdzi wymaga
-programu Ghostscript (interpretera jzyka PostScript) do
-rasteryzacji bd konwersji plikw. Przydatne s take w~wielu wypadkach
-rne programy do obrbki grafiki. Ponadto posiadanie edytora
-zorientowanego na rodowisko \TeX{} znacznie uatwi prac.
-
-Wszystkie te programy dla Windows mona dosy atwo znale w~sieci,
-poniewa jednak jest ich spory wybr, postanowilimy te najbardziej istotne
-umieci w~dystrybucji \TL:
-\begin{description}
-\item[Perl i Ghostscript.] Oba te programy s niezbdne do
-poprawnego dziaania \TL, doczylimy zatem \cmdname{Ghostscript} 8.62
-i~minimaln dystrybucj \cmdname{Perl} 5.8, wystarczajc do
-uruchomienia wszystkich, zawartych w~\TL{} skryptw perlowych;
-oba programy zostay ,,ukryte'', to znaczy tylko programy \TL, ktre
-z~nich korzystaj, ,,wiedz'' gdzie je znale; tym samym nie powinny
-kolidowa z~ewentualnie zainstalowanymi w~systemie programami Perl
-i~Ghostscript;
-\item[narzdzia uruchamiane z~linii polece] -- zestaw kilku przydatnych
- programw
- %(\texttt{bzip2}, %% NIE MA!! (SW)
- (\texttt{gzip}, \texttt{unzip}, \texttt{jpeg2ps} i~\texttt{tiff2png})
- a~take kilka narzdzi z~zestawu \cmdname{xpdf}, uruchamianych z~linii
- polece (sam \cmdname{xpdf} nie jest dostpny dla Windows,
- mona jednak pobra z~internetu opart na nim przegldark \acro{PDF}:
- \url{http://blog.kowalczyk.info/software/sumatrapdf});
-\item[\texttt{fc-cache}] -- program rejestrujcy dla \XeTeX-a fonty
- systemowe lub dostarczane w~dystrybucji \TL{} fonty OpenType;
-\item[PS\_View] -- nowy program podgldu plikw postscriptowych (a~take
- plikw \acro{PDF}), patrz rys.~\ref{fig:psview}.
-\end{description}
-\begin{description}
-\item[katalog \texttt{support,}] wspomniany ju w~czci~\ref{sec:tld},
- zawiera rne programy, ktre mog by uyteczne w~rodowisku \TeX-owym
- (np. edytory/rodowiska dla \TeX-a); programy te \emph{nie s} uwzgldniane
- podczas instalacji samego \TL, naley je wic zainstalowa samodzielnie.
-\end{description}
-
-\begin{figure}[h]
-\begin{center}
-\tlpng{psview}{.6\linewidth}
-\caption{PS\_View: umoliwia bardzo due powikszenia!}\label{fig:psview}
-\end{center}
-\end{figure}
-
-Poniej zamieszczono list miejsc, z~ktrych mona pobra programy
-pomocnicze:
-
-\begin{description}
-\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/}
-\item[Perl] \url{http://www.perl.org} (uzupeniajce, przydatne
- pakiety naley pobra z~zasobw CPAN \url{http://cpan.org})
-\item[ImageMagick] -- bogaty zestaw narzdzi do wsadowego przetwarzania
- plikw graficznych (\url{http://www.imagemagick.com})
-\item[NetPBM] -- do przetwarzania i~konwersji plikw graficznych moemy
- uy alternatywnego dla \textsf{ImageMagick} programu NetPBM
- (\url{http://netpbm.sourceforge.net/})
-\item[Edytory dla systemu \TeX{}] -- spory wybr programw, uwzgldniajcy
- indywidualne preferencje uytkownika:
- \begin{itemize*}
- \item \cmdname{GNU Emacs} -- w~wersji zintegrowanej z~\textsf{AucTeX}
- dostpny jest w~\TL{} w~katalogu \path{support/}
- (\url{ftp://alpha.gnu.org/gnu/auctex})
-% http://www.gnu.org/software/emacs/windows/ntemacs.html})
-% \item \cmdname{XEmacs} -- bardziej przyjazna wersja dla Windows
-% (\url{http://www.xemacs.org/})
- \item \cmdname{WinShell} -- prosty edytor/shell, dostpny na \TL
- w~katalogu \dirname{support/WinShell} (\url{http://www.winshell.de})
- \item \cmdname{WinEdt} -- bogaty w~funkcje edytor dla \TeX-a, dostpny jako
- \emph{shareware} (\url{http://www.winedt.com})
- \item TeXnicCenter -- kolejny, dosy bogaty w~funkcje edytor
- (\url{http://www.toolscenter.org/products/texniccenter/})
- \item \cmdname{Vim} -- rozbudowany i~bardzo funkcjonalny edytor, wywodzcy si
- z~klasycznego dla systemw Unix edytora \cmdname{vi}
- %, dostpny na \TL{} w~katalogu \dirname{support/vim}
- (\url{http://www.vim.org})
- \item \cmdname{LEd} -- polski edytor, dostpny
- z~\url{http://www.ctan.org/support/LEd}
- \item \cmdname{SciTE} -- edytor dostpny
- z \url{http://www.scintilla.org/SciTE.html}
- \end{itemize*}
-\end{description}
-
-%Moemy zainstalowa z~sieci take inne narzdzia, ktrych zabrako na
-%\TL{} z~powodw licencyjnych. Przykadem jest tu \cmdname{GSView},
-%wygodny program wykorzystujcy \cmdname{Ghostscript} do wywietlania
-%i~drukowania plikw PS/PDF. Dostpny jest on m.in.
-%na \url{http://www.cs.wisc.edu/~ghost/gsview/}, a~take na kadym serwerze
-%\acro{CTAN}.
-
-\subsection{Program Dviout}
-
-Obecne wydanie \TL{} nie oferuje niestety preinstalowanego programu do
-podgldu plikw \acro{DVI} dla Windows, mona jednak samodzielnie
-zainstalowa doskonay \prog{dviout}, autorstwa Toshio Oshimy. Znajdziemy go
-w~katalogu \path{support/dviout/}, zawierajcym rwnie krtki plik
-\filename{README} omawiajcy, jak zaistalowa i~skonfigurowa \prog{dviout}
-dla \TL. Przed instalacj zalecamy przeczyta informacje tam zawarte.
-
-Pierwsze uruchomienie \verb+dviout+ zazwyczaj automatycznie generuje wymagane
-fonty ekranowe. Po kilku sesjach komunikaty dotyczce generowania fontw
-stan si rzadsze. Wicej informacji mona znale w~bardzo dobrym
-poradniku \emph{on-line} tego programu.
-
-\subsection{User Profile to inaczej Home (katalog domowy)}
-\label{sec:winhome}
-
-Odpowiednikiem uniksowego katalogu domowego uytkownika (HOME) jest
-w~Windows katalog okrelany zmienn \verb|%USERPROFILE%|. W~Windows
-2000 i~XP jest to zazwyczaj katalog
-\verb|C:\Documents and Settings\<nazwa_uytkownika>|, za w~Windows Vista
-\verb|C:\Users\<nazwa_uytkownika>|. W~pliku konfiguracyjnym
-\filename{texmf.cnf} i~bibliotekach \KPS{} znak \verb|~|
-jest poprawnie rozwijany do odpowiedniej zmiennej zarwno w~Windows, jak
-i~w~Unix.
-
-\subsection{Rejestr Windows}
-\label{sec:registry}
-
-W systemie Windows prawie wszystkie dane konfiguracyjne przechowywane s
-w~tzw. rejestrze. Zawiera on hierachicznie zorganizowane klucze, w~ramach
-kilku kluczy gwnych. Najbardziej istotne dla programw instalacyjnych
-s klucze \path{HKEY_CURRENT_USER} oraz \path{HKEY_LOCAL_MACHINE}
-(w~skrcie \path{HKCU} i \path{HKLM}). Cz \path{HKCU} dotyczy katalogw
-domowych uytkownikw (patrz~\ref{sec:winhome}), za \path{HKLM} -- podkatalogw
-systemowych (w~katalogu Windows).
-
-Informacje o~ustawieniach systemu mona czasem uzyska ze zmiennych
-rodowiska, ale po inne informacje, np. pooenie tzw. skrtw, trzeba
-odwoa si do rejestru. Take zapis zmiennych rodowiska na stae wymaga
-dostpu do rejestru.
-
-\subsection{Uprawnienia w Windows}
-\label{sec:winpermissions}
-
-%%! UWAGA SW: caa ta cz jest mocno niejasna w oryginale. Tumaczyem
-%%! j majc na uwadze oglny sens, w niektrych miejscach doprecyzowujc
-%%! sformuowania. Ale i tak jest, wg mnie, do bani :-)
-
-W nowszych wersjach Windows istnieje wyrane rozrnienie midzy
-zwykymi uytkownikami i~administratorami, przy czym tylko ci ostatni maj
-pen swobod dostpu do caoci systemu.
- %%! ???
- %In practice, though, you could better describe
- %these classes of users as unprivileged users and normal users: being an
- %administrator is the rule, not the exception.
- Dooono wielu stara, aby umoliwi instalacj \TL{} take osobom bez
- uprawnie administratora.
-
-Jeli osoba instalujca jest administratorem, to skrty s tworzone dla
-wszystkich uytkownikw, take zmienne rodowiska s ustawiane dla caego
-systemu. W~przeciwnym wypadku skrty i~menu s tworzone jedynie dla konkretnego
-uytkownika, take definiowane zmienne rodowiska dotycz zwykych
-uytkownikw. Majc uprawnienia admistratora moemy zainstalowa \TL{} tylko
-dla uytkownikw; naley wtedy uruchomi \prog{install-tl} z~parametrem
-\optname{-non-admin}.
-
-Bez wzgldu na status uytkownika domylnym katalogiem gwnym instalacji
-jest katalog w~ramach \verb|%PROGRAMFILES%|. Program instalacyjny zawsze
-sprawdza, czy ten katalog jest dostpny do zapisu dla aktualnego uytkownika.
-
-Problem moe si pojawi wtedy, gdy uytkownik instalujcy \TL{} nie jest
-administratorem, a~programy \TeX-owe ju s w~ciece przeszukiwania.
-Wynikowa cieka zawiera wtedy ciek systemow, do ktrej dodano ciek do
-programw uytkownika. W~konsekwencji nie bd znajdowane nowo instalowane
-programy. W~celu obejcia tego problemu program instalacyjny tworzy skrt do
-okna z~wierszem polece, w~ktrym cieka do nowych programw \TL{} ma
-priorytet. W~ten sposb, po uruchomieniu tego skrtu, bdzie mona korzysta
-z~\TL.
-
-%%% Zostawione z poprzedniej wersji tylko w polskim tumaczeniu!
-
-\subsection{\cmdname{WinShell}}\label{sec:winshell}
-
-Jeli nie decydujemy si na instalowanie rozbudowanego (ale i~bardzo
-bogatego w~funkcje) edytora Emacs, moemy samodzielnie zainstalowa prosty
-i~atwy w~obsudze edytor WinShell. Znajdziemy go na pytce w~katalogu
-\dirname{support/winshell}. Wystarczy dwukrotnie klikn klawiszem myszy
-na znajdujcym si tam pliku \texttt{.exe}.
-Program uruchamiamy z~menu Start bd z~ikony/skrtu na pulpicie.
-Dostosowanie do polskiej wersji Windows wymaga, prcz okrelenia jzyka
-dla menu i~komunikatw, uycia menu
-\verb+Opcje+ (Options) \verb+->+ \verb+Font+ \verb+->+ \verb+Zmie+
-i~wyboru w~wywietlonym oknie \texttt{Skrypt}
-napisu \texttt{Europa rodkowa}.
-Dziki temu poprawnie bd wywietlane polskie znaki diakrytyczne,
-wpisywane za pomoc prawego klawisza Alt.
-
-Aby skonfigurowa uruchamianie programw, otwieramy menu
-\texttt{Options} \verb+->+ \texttt{Program Calls}.
-
-\begin{itemize}\itemsep 0pt
-\item W zakadce DVIWin, w~polu ,,exe-file'', wpisujemy
-\texttt{dviout.exe} (o~ile go wczeniej zaistalowalimy).
-\item W zakadce Ghostview wpisujemy psv.bat.
- %sprawdzi, czy prawidowo podano
- %ciek dla gsview32.exe:\\
- %\hspace*{1em} \verb+C:\ghostgum\gsview\gsview32.exe+ (dla wersji 3.6
- %i~nowszych).
-\end{itemize}
-Po wciniciu przycisku \texttt{OK} zatwierdzamy zmiany.
-
-Instalacja programu ustawia w~Windows skojarzenie plikw \texttt{.tex}
-z~uruchamianiem \cmdname{WinShell}. O~ile nie zamierzamy korzysta
-z~innego edytora (jak WinEdt lub Emacs), jest to poprawne.
-
-\cmdname{WinShell} jest wyposaony w~modu pomocy, dostpnej po
-naciniciu symbolu $\textbf{\underbar{?}}$ na pasku z~narzdziami.
-
-\subsubsection{Uycie plikw ,,projektu''}
- Wielokrotnie mamy do czynienia z~dokumentami skadajcymi si z~wielu
-czci. Najwygodniej gdy s one zapisane w~odrbnych plikach.
-\cmdname{WinShell} umoliwia utworzenie pliku projektu (\textit{Project
-file}), w~ktrym deklarujemy poszczeglne czci wikszego dokumentu. Nazwy
-plikw projektu: traktowanego jako gwny (\textit{Main file}) oraz plikw
-czci s wywietlane w~lewym oknie edytora. Dwukrotne kliknicie mysz na
-nazwie pliku powoduje jego wywietlenie w~gwnym oknie edytora. Nacinicie
-ikony LaTeX na belce narzdziowej uruchamia zawsze przetwarzanie gwnego
-pliku, bez wzgldu na to, ktry plik jest aktualnie wywietlany.
-
-Na belce narzdziowej mamy dodatkowe przyciski, pozwalajce wyczy lub
-wczy wywietlanie okna projektu (po lewej stronie) i~okna zapisu sesji
-(log) -- u~dou. Gdy plik projektu nie jest uywany, lew cz okna mona
-zamkn, zyskujc w~ten sposb ca szeroko ekranu dla edytowanego pliku.
-
-\subsubsection{Drukowanie z~\cmdname{WinShell} na drukarce PostScriptowej}
-\label{winshell:print}
- Ikona Dvips belki narzdziowej uruchamia program, ktry wynik pracy
-zapisuje zwykle w~pliku \verb+.ps+. Ogldanie i/lub drukowanie takiego pliku
-wymaga uruchomienia
- %GSView.
- PS\_View.
- \cmdname{WinShell} pozwala zdefiniowa
-wygodne wywoanie polecenia dvips, ktre wynik przetwarzania wyle od razu
-do drukarki wyposaonej w~interpreter PostScript. Przykadowo, dla drukarki
-o~nazwie \texttt{vclw}, postpowanie bdzie nastpujce:
-\begin{enumerate}
-\item Deklaracja danej drukarki w programie:
-\begin{itemize}
-\item otworzy \cmdname{WinShell}, wybra menu \texttt{Opcje} \verb+->+
- \texttt{Programy uytkownika}.
-\item wybra \texttt{Tool 1} w~spisie po prawej stronie i~wypeni pola
- po stronie lewej, np.:\vspace{-3pt}
- \begin{quote}
- Name: \verb+Drukuj+\\
- exe file: \verb+dvips+\\
- cmd-line: \verb+ -D600 %c.dvi -o vclw+\\
- skasowa zaznaczenie okienka ,,najpierw DVIPS''
-\end{quote}%\vspace{-12pt}
-\item nacisn \texttt{OK}.
-\end{itemize}
-\item Dodanie polecenia ,,Drukuj'' do belki narzdziowej:
-\begin{itemize}
-\item wybra menu \texttt{Opcje} \verb+->+ \texttt{Przegldaj} \verb+->+
- \texttt{Dostosuj paski};
-\item w~okienku \verb+Kategoria+ wybra \texttt{Programy uytkownika};
-\item wskaza \texttt{Drukuj} i~przecign go mysz na belk narzdziow,
- umieszczajc w~dowolnym miejscu obok innych polece;
-\item w kolejno wywietlanym oknie dokona wyboru: ,,Tylko obrazek''
- (\textit{Image only}), ,,Tylko tekst'' lub ,,Tekst i~obrazek''; najprociej
- wybra ,,Tylko tekst'' i~zatwierdzi guzikiem \texttt{OK}.
- Napis \texttt{Drukuj} ukae si na belce. (Bardziej wymagajcy uytkownicy
- mog wybra opcj ,,Tylko obrazek'', nastpnie ,,Edytuj'' i~skonstruowa
- sobie wasn ikonk.)
-\end{itemize}
-\end{enumerate}
-Uruchamianie polecenia zostao zdefiniowane. Aby drukowa bezporednio na
-drukarce, wystarczy teraz nacisn guzik z~napisem ,,Drukuj''.
-
-\subsection{W razie problemw}
-\label{troubleshooting}
-
-\subsubsection{Co zrobi gdy \texttt{latex} nie moe znale potrzebnych
-plikw?}
-
-\begin{itemize}
-\item Program \cmdname{kpsewhich} jest podstawowym narzdziem do diagnozowania
- problemw. Wyprowadza on informacje diagnostyczne na wyjcie stderr, przy
-czym konsole (okienka wierszy polece) starszych systemw Windows nie
-potrafi przekierowa stderr do pliku. Umoliwia to dopiero system Windows
-NT i~pniejsze, ale rozwizanie przedstawione poniej dziaa dla kadej
-konsoli (okienka wierszy polece). Ot dla celw diagnostycznych mona
-tymczasowo zdefiniowa zmienn rodowiska (w~oknie polece):
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=err.log
-\end{verbatim}
-Mona rwnie zada zakres diagnostyki:
-\begin{verbatim}
-SET KPATHSEA_DEBUG=-1
-\end{verbatim}
-
-Podobnie, aby przekierowa wyjcie stderr na stdout:
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=con:
-\end{verbatim}
-W ten sposb mona skierowa zarwno stderr, jak i stdout do tego samego pliku.
-\item Przy zaoeniu, e instalacj wykonano w \path|c:/TeX|, naley
- sprawdzi (porwna) nastpujce wartoci:\\
- {\small
- \begin{tabular}{ll}
- \path|kpsewhich -expand-path $SELFAUTOPARENT| & \path|c:/TeX| \\
- \path|kpsewhich -expand-path $TEXMF| & \path|c:/TeX/texmf....| \\
- \path|kpsewhich -expand-var $TEXINPUTS| & \path|.;c:/TeX/texmf/tex//|
- \end{tabular}
-}
-
-Jeli w otoczeniu systemowym s zdefiniowane zmienne zwizane z~\TeX-em,
-naley je usun, maj bowiem pierwszestwo przed tymi,
-ktre okrelono w~pliku \filename{texmf.cnf}.
-\item Nastpnie naley sprawdzi (porwna) wartoci:\\
-{\small
- \begin{tabular}{ll}
- \texttt{kpsewhich cmr10.tfm} & \path|c:/TeX/texmf-dist/fonts/tfm/public/cm/cmr10.tfm|\\
- \texttt{kpsewhich latex.fmt}& \path|c:/TeX/texmf-var/web2c/pdftex/latex.fmt|
- \end{tabular}
-}
-
-Jeli sprawdzenia nie wykazay odstpstw, to \TeX{} i~programy towarzyszce
-powinny dziaa. Jeli tak nie jest, naley poeksperymentowa z opcj
-\path|-debug=n| programu \path|kpsewhich| i~zweryfikowa wszystkie uzyskane
-wartoci. Po zidentyfikowaniu problemu warto go zgosi.
-\end{itemize}
-
-%--------------------------
-% don't use \Webc so the \uppercase in the headline works.
-\section{Instrukcja obsugi systemu Web2C}
-
-\Webc{} to zestaw programw zwizanych z~\TeX-em, tj. sam \TeX{}, \MF{},
-\MP, \BibTeX{} itd. Stanowi one rdze dystrybucji \TL.
-
-Oryginalna implementacja wykonana zostaa przez Tomasa Rokickiego, ktry
-w~roku 1987 stworzy pierwszy system \TeX{}-to-C, adaptujc pliki wymiany
-(\emph{change files}) pod Unix-em (pierwotnie byy one dzieem Howarda
-Trickey'a oraz Pavela Curtisa). W~czasie, gdy Tim Morgan zajmowa si
-systemem, jego nazwa zostaa zmieniona na Web-to-C\@. W~1990 roku prace nad
-projektem przej Karl Berry wraz z~dziesitkami wsppracownikw, a~w~roku
-1997 paeczk przej Olaf Weber.
-
-\Webc{} dziaa na platformach systemowych, takich jak Unix (w~tym \MacOSX),
-Windows 9x/\acro{NT/2K/XP} i~innych.
-System wykorzystuje oryginalne rda \TeX-owe autorstwa Donalda Knutha
-oraz inne programy napisane w~\web{} i~tumaczy je na kod rdowy~C.
-Ponadto system udostpnia spory zestaw makr i~funkcji stworzonych dla
-zwikszenia funkcjonalnoci oryginalnych zasobw oprogramowania
-zwizanego z~\TeX-em. Podstawowymi skadnikami systemu s:
-
-\begin{cmddescription}
-\item[bibtex] tworzenie spisw bibliograficznych;
-\item[dmp] konwersja \cmdname{troff} do MPX (rysunki \MP{}-owe);
-\item[dvicopy] modyfikowanie pliku \dvi;
-\item[dvitomp] konwersja \dvi{} do MPX (rysunki \MP{}-owe);
-\item[dvitype] konwersja \dvi{} na plik tekstowy (ASCII);
-\item[gftodvi] zamiana fontu GF na plik \dvi;
-\item[gftopk] zamiana fontu w~formacie GF na font spakowany (PK);
-\item[gftype] zamiana fontu GF na plik tekstowy (ASCII);
-\item[makempx] skad etykiet \MP{}-owych;
-\item[mf] generowanie fontw bitmapowych w formacie GF;
-\item[mft] skad plikw rdowych \MF{}-a;
-\item[mpost] tworzenie rysunkw oraz diagramw technicznych;
-\item[mpto] ekstrakcja etykiet \MP{}-owych;
-\item[newer] porwnywanie czasw modyfikacji;
-\item[patgen] tworzenie wzorcw przenoszenia wyrazw;
-\item[pktogf] zamiana fontw w formacie PK na fonty GF;
-\item[pktype] zamiana fontu PK na plik tekstowy (ASCII);
-\item[pltotf] konwersja tekstowej listy waciwoci do TFM;
-\item[pooltype] wywietlanie \web-owych plikw pool;
-\item[tangle] konwersja \web{} do jzyka Pascal;
-\item[tex] skad tekstu;
-\item[tftopl] konwersja TFM do tekstowej listy waciwoci (PL);
-\item[vftovp] konwersja fontw wirtualnych do wirtualnej listy
- waciwoci (VPL);
-\item[vptovf] konwersja wirtualnej listy waciwoci do fontw wirtualnych;
-\item[weave] konwersja \web{} do \TeX-a.
-\end{cmddescription}
-
-\noindent
-Dokadny opis funkcji oraz skadni tych programw zawarty jest
-w~dokumentacji poszczeglnych pakietw samego \Webc{}.
-Do optymalnego korzystania z~instalacji \Webc{}
-przyda si znajomo kilku zasad rzdzcych ca rodzin programw.
-
-Wszystkie programy obsuguj standardowe opcje \acro{GNU}:
-\begin{description}
-\item[\texttt{-{}-help\ \ \ }] podaje podstawowe zasady uytkowania;
-\item[\texttt{-{}-verbose}] podaje dokadny raport z~dziaania programu;
-\item[\texttt{-{}-version}] podaje informacj o~wersji, po czym koczy
- dziaanie programu.
-\end{description}
-
-Do lokalizowania plikw programy oparte na \Webc{} uywaj biblioteki do
-przeszukiwania cieek zwanej \KPS{}.
-Dla optymalizacji przeszukiwania \TeX-owego drzewa podkatalogw biblioteka ta
-uywa kombinacji zmiennych rodowiskowych oraz kilku plikw konfiguracyjnych.
-\Webc{} potrafi obsugiwa jednoczenie wicej ni jedno drzewo
-podkatalogw, co jest uyteczne w~wypadku, gdy chce si przechowywa
-standardow dystrybucj \TeX-a jak i~lokalne rozszerzenia w~dwch rnych
-drzewach katalogw.
-Aby przyspieszy poszukiwanie plikw, katalog gwny kadego drzewa ma swj
-plik \file{ls-R}, zawierajcy pozycje okrelajce nazw i~wzgldn ciek
-dla wszystkich plikw zawartych w~tym katalogu.
-
-\subsection{Przeszukiwanie cieek przez Kpathsea}
-\label{sec:kpathsea}
-
-Opiszemy najpierw oglny mechanizm przeszukiwania cieek przez bibliotek
-\KPS{}.
-
-Tym, co nazywamy \emph{ciek przeszukiwania}, jest rozdzielona dwukropkami
-lub rednikami lista \emph{elementw cieki}, ktre zasadniczo s nazwami
-podkatalogw. cieka przeszukiwania moe pochodzi z~(kombinacji) wielu
-rde. Przykadowo, aby odnale plik \samp{my-file} w~ciece
-\samp{.:/dir}, \KPS{} sprawdza istnienie danego elementu cieki
-w~nastpujcej kolejnoci: najpierw \file{./my-file}, potem
-\file{/dir/my-file}, zwracajc pierwszy odnaleziony (lub moliwie wszystkie).
-
-Aby optymalnie zaadaptowa si do konwencji wszystkich systemw operacyjnych,
-na systemach nieunixowych \KPS{} moe uywa
-jako separatorw nazw cieek znakw innych
-ni dwukropek (\samp{:}) oraz ,,ciach'' (\samp{/}).
-
-W~celu sprawdzenia konkretnego elementu \var{p} cieki, \KPS{} najpierw
-sprawdza, czy zbudowana wczeniej baza danych (patrz ,,Baza nazw plikw'' na
-stronie~\pageref{Filename-database}) odnosi sie do \var{p}, tj.
-czy baza danych znajduje si w~podkatalogu z~prefiksem~\var{p}.
-Jeeli tak, to specyfikacja cieki jest porwnywana z~zawartoci bazy.
-
-Jeli baza danych nie istnieje bd nie odnosi si do danego elementu
-cieki albo te nie zawiera elementw zgodnych, to przeszukiwany jest system
-plikw (jeeli nie zostao to zabronione przez specyfikacj rozpoczynajc
-si od~\samp{!!}\ oraz jeeli poszukiwany plik musi istnie).
-\KPS{} konstruuje list podkatalogw, ktre koresponduj z~danym elementem
-cieki, a~nastpnie sprawdza w~kadym z~nich, czy nie ma tam poszukiwanego
-pliku.
-
-Warunek mwicy, e ,,plik musi istnie'' dotyczy np. plikw \samp{.vf}
-i~plikw doczanych \TeX-owym poleceniem \cs{openin}.
-Takiego pliku moe nie by (np. \file{cmr10.vf}), bdne byoby zatem
-poszukiwanie go na dysku.
-Jeli wic zapomnisz o~aktualizacji \file{ls-R} po instalacji nowego
-pliku \samp{.vf}, to nie zostanie on odnaleziony.
-Kady element cieki sprawdzany jest w~nastpujcej kolejnoci: najpierw
-w~bazie danych, potem na dysku.
-Jeeli plik si znajdzie, to przeszukiwanie zostanie zatrzymane i~zwrcony
-zostanie wynik.
-
-Poniewa najprostszym i~najbardziej powszechnym elementem cieki jest
-nazwa katalogu, \KPS{} korzysta z~dodatkowych moliwoci w~przeszukiwaniu
-cieek:
-wielowarstwowych wartoci domylnych, zmiennych rodowiskowych, wartoci
-pliku konfiguracyjnego, lokalnych
-podkatalogw uytkownika oraz rekursywnego przeszukiwania podkatalogw.
-Mona wic powiedzie, e \KPS{} \emph{rozwija} element cieki, tzn.
-transformuje wszystkie specyfikacje do podstawowej nazwy lub nazw katalogw.
-Jest to opisane w~kolejnych akapitach, w~kolejnoci w~jakiej ma to miejsce.
-
-Trzeba zauway, e jeeli nazwa poszukiwanego pliku jest
-absolutna lub jawnie wzgldna, tj. zaczyna si od \samp{/} lub \samp{./}
-lub \samp{../}, to \KPS{} ogranicza si do sprawdzenia, czy ten plik istnieje.
-
-\ifSingleColumn
-\else
-\begin{figure*}
-\verbatiminput{examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{Przykad pliku konfiguracyjnego}
- \label{fig:config-sample}
-\end{figure*}
-\fi
-
-\subsubsection{rda cieek}
-\label{Path-sources}
-
-Nazwa przeszukiwanej cieki moe pochodzi z~wielu rde.
-Oto kolejno, w~jakiej \KPS{} ich uywa:
-
-\begin{enumerate}
-\item
- Zmienna rodowiskowa ustawiana przez uytkownika, np.
- \envname{TEXINPUTS}.
- Zmienne rodowiskowe z~doczon kropk i~nazw programu zastpuj inne,
- np. jeeli \samp{latex} jest nazw uruchomionego programu, wtedy zamiast
- \envname{TEXINPUTS} wykorzystana zostanie zmienna \envname{TEXINPUTS.latex}.
-\item
- Plik konfiguracyjny konkretnego programu, np. linia ,,\texttt{S /a:/b}''
- w~pliku \file{config.ps} programu \cmdname{dvips}.
-\item Plik konfiguracyjny \KPS{} \file{texmf.cnf}, zawierajcy tak lini,
- jak \samp{TEXINPUTS=/c:/d} (patrz poniej).
-\item Wartoci domylne dla uruchamianych programw.
-\end{enumerate}
-\noindent Kad z~tych wartoci dla danej cieki przeszukiwania mona
-zobaczy, uywajc opcji diagnostyki bdw (patrz ,,Diagnostyka bdw'' na
-stronie~\pageref{sec:debugging}).
-
-\subsubsection{Pliki konfiguracyjne}
-
-\tolerance=3500
- \KPS{} szuka cieek przeszukiwania i~innych definicji w~\emph{plikach
-konfiguracyjnych} o~nazwach \file{texmf.cnf}.
-cieka przeszukiwania uywana do znajdowania tych plikw okrelana jest
-przez zmienn \envname{TEXMFCNF} (domylnie taki plik znajduje si w~podkatalogu
-\file{texmf/web2c}).
-Czytane bd \emph{wszystkie} pliki \file{texmf.cnf} w~ciece
-przeszukiwania,
-a~definicje we wczeniejszych plikach zastpi te w~pniejszych.
-Tak wic w~ciece \verb|.:$TEXMF| wartoci pochodzce z~\file{./texmf.cnf}
-zastpi te z~\verb|$TEXMF/texmf.cnf|.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-Dociekliwy czytelnik moe by zainteresowany sposobem, w~jaki programy
-znajduj plik \file{texmf.cnf}, skoro nie ma koniecznoci deklarowania
-specyficznej zmiennej rodowiskowej systemu. Ot pooenie domylne jest
-wkompilowane w~programy jako wzgldne do ich pooenia (okrelanego, jak
-wiemy, w~ciece specyfikowanej przez \texttt{\$PATH}):
-\path{../../texmf/web2c/} bd \path{../texmf/web2c/}. Jeli jawnie
-deklarujemy zmienn \envname{TEXMFCNF}, wymagane jest podanie bezwzgldnej
-cieki.
-
-Czytajc zamieszczony poniej opis formatu pliku \file{texmf.cnf},
-warto przeglda jego zawarto. Pooenie \emph{aktywnego} pliku
-znajdziemy za pomoc polecenia \texttt{kpsewhich texmf.cnf}.
-
-\begin{itemize}
-\item
- Komentarze zaczynaj si od ,,\texttt{\%}'', a~kocz na kocu wiersza.
-\item
- Puste wiersze nie s brane pod uwag.
-\item
- Znak \bs{} na kocu wiersza dziaa jako znak kontynuacji, tzn.
- oznacza, e kolejny wiersz jest kontynuacj biecego.
- Spacja na pocztku kolejnego wiersza nie jest ignorowana.
-\item
- Pozostae wiersze maj posta:
-\begin{alltt}
- \emph{zmienna}[.\emph{program}] [=] \emph{warto}
-\end{alltt}%
- gdzie \samp{=} i~otaczajce spacje s opcjonalne.
-\item
- ,,\texttt{\var{zmienna}}'' zawiera moe dowolne znaki poza spacj,
- \samp{=}, lub \samp{.} (kropk), najbezpieczniej jednak uywa znakw
- z~zakresu \samp{A-Za-z\_}.
-\item
- Napis ,,\texttt{.\var{program}}'' ma zastosowanie w~wypadku, gdy
- uruchamiany program nosi nazw \texttt{\var{program}} lub
- \texttt{\var{program}.exe}. Pozwala to rnym odmianom \TeX-a stosowa
- rne cieki przeszukiwania.
-\item ,,\texttt{\var{warto}}'' zawiera moe dowolne znaki poza
- ,,\texttt{\%}'' i \samp{@}.
- Nie mona uywa konstrukcji ,,\texttt{\$\var{zmienna}.\var{program}}''
- po prawej stronie. Zamiast tego trzeba zastosowa zmienn pomocnicz.
- rednik \samp{;}\ uyty w~,,\texttt{\var{warto}}'' zamieniany jest na
- \samp{:}\ jeeli systemem operacyjnym jest Unix; umoliwia to istnienie
- wsplnego pliku \file{texmf.cnf} dla systemw Unix oraz Windows.
-\item
- Wszystkie definicje czytane s zanim cokolwiek zostanie rozwinite, tak
- wic do zmiennych mona si odwoywa przed ich zdefiniowaniem.
-\end{itemize}
-Oto fragment pliku konfiguracyjnego, ilustrujcy wikszo opisanych powyej
-regu notacji:
-\ifSingleColumn
-\verbatiminput{examples/ex5.tex}
-\else
-jest pokazany na rys.~\ref{fig:config-sample}.
-\fi
-
-\subsubsection{Rozwijanie cieek}
-\label{Path-expansion}
-
-\KPS{} rozpoznaje w~ciekach przeszukiwania pewne specjalne znaki oraz
-konstrukcje, podobne do tych dostpnych w~powokach Unix.
-Jako oglny przykad: zoona cieka
-\verb+~$USER/{foo,bar}//baz+ rozwija si do wszystkich podkatalogw pod
-katalogami \file{foo} i~\file{bar} w~katalogu gwnym \texttt{\$USER},
-ktre zawieraj katalog lub plik \file{baz}.
-Rozwinicia te opisane s w~poniszych podrozdziaach.
-
-\subsubsection{Rozwijanie domylne}
-\label{Default-expansion}
-
-\tolerance=2500
-Jeeli cieka przeszukiwania najwikszego uprzywilejowania (patrz ,,rda
-cieek'' na stronie~\pageref{Path-sources}) zawiera
-\emph{dodatkowy dwukropek} (np. na pocztku, na kocu lub podwjny) to \KPS{}
-wstawia w~tym miejscu nastpn zdefiniowan w~hierarchii uprzywilejowania
-ciek przeszukiwania.
-Jeeli ta wstawiona cieka ma dodatkowy dwukropek, to dzieje si dalej to samo.
-Przykadowo, jeeli ustawi zmienn rodowiskow
-\tolerance=1500
-
-\begin{alltt}
-> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
-oraz warto \code{TEXINPUTS} pobran z~\file{texmf.cnf}
-
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
-kocow wartoci uyt w~przeszukiwaniu bdzie:
-
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-
-Poniewa nieuytecznym byoby wstawia warto domyln w~wicej ni jednym
-miejscu, \KPS{} zmienia tylko jeden dodatkowy \samp{:}\ i~pozostawia
-inne bez zmian. \KPS{} najpierw szuka dwukropkw na pocztku linii, potem na kocu,
-a~nastpnie podwjnych.
-
-\subsubsection{Rozwijanie nawiasw}
-
-Uyteczna jest moliwo rozwijania nawiasw, co oznacza, e np.
-\verb+v{a,b}w+ rozwija si do \verb+vaw:vbw+.
-Nawiasy mona te zagnieda.
-Funkcji tej mona uy do zaimplementowania rnych hierarchii \TeX-owych
-przez przypisanie listy nawiasw do \code{\$TEXMF}. Przykadowo,
-w~pliku \file{texmf.cnf} mona znale nastpujc definicj:
-\begin{verbatim}
- TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN}
-\end{verbatim}
-Uywajc jej, mona nastpnie napisa co w~rodzaju:
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-co oznacza, e po szukaniu w~katalogu biecym bd przeszukane kolejno
-\code{\$TEXMFHOME/tex}, \code{\$TEXMFLOCAL/tex}, \code{\$TEXMFVAR/tex}
-i~\code{\$TEXMFMAIN/tex} (wszystkie wraz z~katalogami niszego poziomu;
-dwie ostatnie cieki \emph{wycznie} na podstawie zawartoci
-pliku \file{ls-R}).
-Jest to wygodny sposb na uruchamianie dwch rwnolegych struktur \TeX-owych,
-jednej ,,zamroonej'' (np. na \CD), a~drugiej cigle uaktualnianej nowo
-pojawiajcymi si wersjami.
-Uywajc zmiennej \code{\$TEXMF} we wszystkich definicjach daje pewno,
-e najpierw przeszukiwane jest drzewo uaktualnione.
-
-\subsubsection{Rozwijanie podkatalogw}
-\label{Subdirectory-expansion}
-
-Dwa lub wicej kolejnych ,,ciachw'' (,,/'') w~elemencie cieki,
-wystpujcych po nazwie katalogu~\var{d}, zastpowanych jest przez wszystkie
-podkatalogi~\var{d}, najpierw podkatalogi znajdujce si bezporednio
-pod~\var{d}, potem te pod powyszymi i~tak dalej. Na kadym etapie
-kolejno, w~jakiej przeszukiwane s katalogi, jest \emph{nieokrelona}.
-
-Jeli wyszczeglni si czony nazwy pliku po \samp{//}, to uwzgldnione zostan
-tylko te podkatalogi, ktre zawieraj powysze czony.
-Na przykad \samp{/a//b} rozwija si do katalogw \file{/a/1/b},
-\file{/a/2/b}, \file{/a/1/1/b} itd., ale nie do \file{/a/b/c} czy \file{/a/1}.
-
-Moliwe jest wielokrotne uycie \samp{//} w~ciece, jednake \samp{//}
-wystpujce na pocztku cieki nie jest brane pod uwag.
-
-\subsubsection{Lista znakw specjalnych i~ich znacze -- podsumowanie}
-
-Ponisza lista podsumowuje znaczenie znakw specjalnych w~plikach
-konfiguracyjnych.
-
-\newcommand{\CODE}[1]{\makebox[2.2em][l]{\code{#1}}}
-\begin{description}
-\item[\CODE{:}] znak rozdzielajcy w~specyfikacji cieki; umieszczony na
-pocztku lub na kocu cieki zastpuje domylne rozwinicie cieki;
-\item[\CODE{;}] znak rozdzielajcy dla systemw nieuniksowych
- (dziaa tak jak ,,\code{:}'');
-\item[\CODE{\$}] rozwijanie zmiennej;
-\item[\CODE{\string~}] oznacza katalog gwny uytkownika;
-\item[\CODE{\char`\{\dots\char`\}}] rozwijanie nawiasw, np.
- \verb+a{1,2}b+ zmieni si w~\verb+a1b:a2b+;
-\item[\CODE{//}] rozwijanie podkatalogw (moe wystpi gdziekolwiek
- w~ciece, poza jej pocztkiem);
-\item[\CODE{\%}] pocztek komentarza, obejmujcego wszystkie znaki do koca
- linii;
-\item[\CODE{\bs}] znak kontynuacji (pozwala na przeamanie wiersza
- z~wyraeniem);
-\item[\CODE{!!}] przeszukiwanie \emph{tylko} bazy danych,
- a~\emph{nie} dysku.
-\end{description}
-
-
-\subsection{Bazy nazw plikw}
-\label{Filename-database}
-
-Podczas przeszukiwania \KPS{} stara si zminimalizowa dostp do dysku.
-Niemniej, w~przypadku instalacji ze zbyt du liczb katalogw
-przegldanie kadego dopuszczalnego katalogu w~poszukiwaniu pliku moe
-zabiera sporo czasu (ma to miejsce zwaszcza, jeeli przeszuka trzeba setki
-katalogw z~fontami).
-Dlatego te \KPS{} moe uywa zewntrznego pliku z~,,baz danych''
-o~nazwie \file{ls-R}, ktry zawiera przypisania plikw do katalogw.
-Unika si w~ten sposb czasochonnego przeszukiwania dysku.
-
-Drugi plik z~baz danych -- \file{aliases} -- pozwala na nadawanie
-dodatkowych nazw plikom zawartym w~\file{ls-R}.
-Moe to by pomocne do adaptacji do DOS-owej konwencji ,,8.3'' nazewnictwa
-plikw w~plikach rdowych.
-
-\subsubsection{Baza nazw plikw}
-\label{ls-R}
-
-Jak ju wspomniano powyej, plik zawierajcy gwn baz nazw
-plikw musi nosi nazw \file{ls-R}.
-W~katalogu podstawowym kadej hierarchii \TeX-owej (domylnie \code{\$TEXMF}),
-ktr chcemy wczy w~mechanizm przeszukiwania, umieszcza mona po jednym
-pliku \file{ls-R}; w~wikszoci przypadkw istnieje tylko jedna hierarchia.
-\KPS{} szuka pliku \file{ls-R} w~ciece \code{TEXMFDBS}.
-
-Najlepszym sposobem stworzenia i~utrzymywania pliku \file{ls-R} jest
-uruchomienie skryptu \code{mktexlsr}, bdcego skadnikiem dystrybucji.
-Jest on wywoywany przez rne skrypty typu \samp{mktex...}.
-W~zasadzie skrypt ten jedynie wykonuje polecenie
-\begin{alltt}
-cd \var{/your/texmf/root} && ls -LAR ./ >ls-R
-\end{alltt}
-zakadajc, e polecenie \code{ls} danego systemu utworzy waciwy format
-strumienia wyjciowego (\acro{GNU} \code{ls} dziaa prawidowo).
-Aby mie pewno, e baza danych jest zawsze aktualna, wygodnie jest
- przebudowywa j regularnie za pomoc demona \code{cron}.
- %tak e wraz ze zmianami
- %w~instalowanych plikach -- np. po instalacji lub uaktualnianiu pakietu
- %\LaTeX{} -- plik \file{ls-R} jest uaktualniany automatycznie.
-
-Jeli pliku nie ma w~bazie danych, \KPS{} domylnie przechodzi do
-przeszukiwania dysku. Jeeli jednak dany element cieki zaczyna sie od
-\samp{!!}, w~poszukiwaniu tego elementu sprawdzona zostanie \emph{jedynie}
-baza danych, a~nigdy dysk.
-
-\subsubsection{kpsewhich -- program do przeszukiwania cieek}
-\label{Invoking-kpsewhich}
-
-Przeszukiwanie cieek przez program \texttt{kpsewhich} jest niezalene od
-jakiejkolwiek aplikacji.
-Moe on by przydatny jako rodzaj programu \code{find}, za pomoc ktrego
-lokalizowa mona pliki w~hierarchiach \TeX-owych (jest on uywany
-intensywnie w~skryptach \samp{mktex...} tej dystrybucji).
-
-\begin{alltt}
-> \Ucom{kpsewhich \var{opcje}\dots{} \var{nazwa-pliku}\dots{}}
-\end{alltt}
-Parametry wyszczeglnione w~,,\texttt{\var{opcje}}'' mog zaczyna si zarwno od
-\samp{-}, jak i~od \samp{-{}-}, a~dozwolony jest kady jednoznaczny skrt.
-
-\KPS{} traktuje kady argument nie bdcy parametrem jako nazw pliku
-i~zwraca pierwsz odnalezion nazw.
-Nie ma parametru nakazujcego zwracanie wszystkich nazw plikw o~okrelonej
-nazwie (w~tym celu mona wykorzysta Unix-owy program \samp{find}).
-
-Waniejsze parametry opisane s poniej.
-
-\begin{ttdescription}
-\item[\texttt{-{}-dpi=\var{num}}]\mbox{}\\*
- Ustaw rozdzielczo na ,,\texttt{\var{num}}''; ma to tylko wpyw na
- przeszukiwanie fontw \samp{gf} i~\samp{pk}. Dla zgodnoci
- z~\cmdname{dvips} parametr
- \samp{-D} dziaa identycznie. Domyln wartoci jest 600.
-\item[\texttt{-{}-format=\var{nazwa}}]\mbox{}\\
- Ustawienie formatu (typu pliku) przeszukiwania na ,,\texttt{\var{nazwa}}''.
- Domylnie format odgadywany jest z~nazwy pliku.
- Dla formatw, ktre nie maj przydzielonego jednoznacznego rozszerzenia,
- takich jak niektre pliki \MP{}-owe czy pliki konfiguracyjne
- \cmdname{dvips}-a, naley wyszczeglni nazw, ktrych list wywietli
- uruchomienie \texttt{kpsewhich -{}-help}.
-
-\item[\texttt{-{}-mode=\var{napis}}]\mbox{}\\*
- Ustaw nazw trybu na ,,\texttt{\var{napis}}''; dotyczy to jedynie szukania
- fontw \samp{gf} oraz \samp{pk}.
- Brakuje wartoci domylnej -- odnaleziony zostanie dowolny
- wyszczeglniony tryb.
-\item[\texttt{-{}-must-exist}]\mbox{}\\
- Zrb wszystko co moliwe, aby odnale pliki, wczajc w~to przede wszystkim
- przeszukanie dysku.
- Domylnie, w~celu zwikszeniu efektywnoci dziaania, sprawdzana jest
- tylko baza \file{ls-R}.
-\item[\texttt{-{}-path=\var{napis}}]\mbox{}\\
- Szukaj w~ciece ,,\texttt{\var{napis}}'' (rozdzielonej, jak
- zwykle, dwukropkami), zamiast zgadywa ciek przeszukiwania z~nazwy
- pliku.
- \samp{//} i~wszystkie zwyke rozszerzenia s moliwe.
- Parametry \samp{-{}-path} oraz \samp{-{}-format} wzajemnie si wykluczaj.
-\item[\texttt{-{}-progname=\var{nazwa}}]\mbox{}\\
- Ustaw nazw programu na ,,\texttt{\var{nazwa}}''.
- Moe to mie wpyw na ciek przeszukiwania poprzez
- ,,\texttt{.\var{program}}'' w~plikach konfiguracyjnych.
- Ustawieniem domylnym jest \samp{kpsewhich}.
-\item[\texttt{-{}-show-path=\var{nazwa}}]\mbox{}\\
- Pokazuje ciek uywan do poszukiwania plikw typu
- ,,\texttt{\var{nazwa}}''.
- Uyte moe by zarwno rozszerzenie (\samp{.pk}, \samp{.vf}, etc.), jak
- i~nazwa pliku, tak jak w~wypadku parametru \samp{-{}-format}.
-\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\
- ustawia parametry wykrywania bdw na ,,\texttt{\var{num}}''.
-\end{ttdescription}
-
-%Zmienne rodowiskowe domylnie ustawiane s w~pliku konfiguracyjnym
-%\file{texmf.cnf}. W~wypadku gdy chce si uniewani wartoci zmiennych
-%wyszczeglnione w~tym pliku, mona narzuci ich ustawienie w~rodowisku,
-%w~ktrym uruchamiane s programy.
-
-\subsubsection{Przykady uycia}
-\label{SExamplesofuse}
-
-Przyjrzyjmy sie teraz, jak dziaa \KPS{}.
-
-\begin{alltt}
-> \Ucom{kpsewhich article.cls}
-/usr/local/texmf-dist/tex/latex/base/article.cls
-\end{alltt}
-Szukamy pliku \file{article.cls}.
-Poniewa rozszerzenie \samp{.cls} jest jednoznaczne, nie musimy zaznacza, e
-poszukujemy pliku typu ,,tex'' (katalogi plikw rdowych \TeX-a).
-Znajdujemy go w~podkatalogu \file{tex/latex/base}, pod katalogiem nadrzdnym
-\samp{texmf-dist}.
-Podobnie wszystkie ponisze pliki odnajdowane s bez\-pro\-ble\-mo\-wo
-dziki swoim jednoznacznym rozszerzeniom:
-\begin{alltt}
-> \Ucom{kpsewhich array.sty}
-/usr/local/texmf-dist/tex/latex/tools/array.sty
-> \Ucom{kpsewhich latin1.def}
-/usr/local/texmf-dist/tex/latex/base/latin1.def
-> \Ucom{kpsewhich size10.clo}
-/usr/local/texmf-dist/tex/latex/base/size10.clo
-> \Ucom{kpsewhich small2e.tex}
-/usr/local/texmf-dist/tex/latex/base/small2e.tex
-> \Ucom{kpsewhich tugboat.bib}
-/usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-\noindent (ostatni plik to \BibTeX-owa baza bibliograficzna dla artykuw
-\textsl{TUGBoat}).
-
-\begin{alltt}
-> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
-Pliki czcionek bitmapowych typu \file{.pk} uywane s przez sterowniki,
-takie jak \cmdname{dvips} % ??? dvips to chyba nie przegldarka ---
-czy \cmdname{xdvi}. % w oryg. byo display programs like dvips...
-W~tym wypadku wynik przeszukiwania okae si pusty, poniewa
-w~systemie brak gotowych wygenerowanych czcionek \samp{.pk} Computer Modern
-(wynika to z~faktu uywania w~\TL{} fontw PostScript-owych Type1).
-\begin{alltt}
-> \Ucom{kpsewhich wsuipa10.pk}
-\ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
-\else /usr/local/texmf-var/fonts/pk/ljfour/public/
-..... wsuipa/wsuipa10.600pk
-\fi\end{alltt}
-Dla tych fontw (alfabetu fonetycznego) musielimy wygenerowa pliki
-\samp{.pk}, a~poniewa domylnym \MF{}-owym trybem naszej instalacji jest
-\texttt{ljfour} z~podstawow rozdzielczoci 600dpi, zwracany jest taki
-wanie wynik.
-\begin{alltt}
-> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
-\end{alltt}
-W~tym wypadku, kiedy zaznaczamy, e interesuje nas rozdzielczo
-300dpi (\texttt{-dpi=300}), to widzimy, e w~naszej instalacji taka
-czcionka nie jest dostpna.
-Program taki jak \cmdname{dvips} czy \cmdname{xdvi} zatrzymaby si, aby
-utworzy pliki \texttt{.pk} w~wymaganej rozdzielczoci (uywajc skryptu
-\cmdname{mktexpk}).
-
-Zwrcimy teraz nasz uwag na pliki nagwkowe i~konfiguracyjne
-programu \cmdname{dvips}.
-Najpierw szukamy pliku PostScript-owego prologu \file{tex.pro},
-wykorzystywanego dla potrzeb \TeX-a. Drugi przykad pokazuje
-poszukiwanie pliku konfiguracyjnego \file{config.ps}, za trzeci --
-szukanie pliku mapy czcionek PostScriptowych \file{psfonts.map}
-(poczwszy od obecnej edycji, pliki \file{.map} i~\file{.enc}
-maj wasne reguy przeszukiwania cieek i~zmienione pooenie w~ramach
-drzew \dirname{texmf}).
-Poniewa rozszerzenie \samp{.ps} nie jest jednoznaczne, musimy zaznaczy
-wyranie jaki typ jest wymagany dla pliku
-\texttt{config.ps} (,,\texttt{dvips config}'').
-\begin{alltt}
-> \Ucom{kpsewhich tex.pro}
-/usr/local/texmf/dvips/base/tex.pro
-> \Ucom{kpsewhich --format="dvips config" config.ps}
-/usr/local/texmf-var/dvips/config/config.ps
-> \Ucom{kpsewhich psfonts.map}
-/usr/local/texmf-var/fonts/map/dvips/updmap/psfonts.map
-\end{alltt}
-
-Nastpnie przyjrzymy si bliej plikom pomocniczym fontw Times z~kolekcji
-URW. W~standardzie nazewnictwa fontw maj one prefiks \samp{utm}.
-Pierwszy plik ktrego szukamy, to plik konfiguracyjny, zawierajcy nazw
-pliku z~przemapowaniem fontw:
-\begin{alltt}
-> \Ucom{kpsewhich --format="dvips config" config.utm}
- /usr/local/texmf-dist/dvips/psnfss/config.utm
-\end{alltt}
-W~pliku tym znajduje si wiersz:
-\begin{alltt}
- p +utm.map
-\end{alltt}
-wskazujcy na plik \file{utm.map}, ktry chcemy zlokalizowa w~nastpnej
-kolejnoci:
-\begin{alltt}
-> \Ucom{kpsewhich utm.map}
- /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
-\end{alltt}
-Plik z~przemapowaniem definiuje nazwy czcionek PostScriptowych Type~1
-w~zestawie fontw URW, za jego zawarto wyglda nastpujco
-(pokazane s tylko fragmenty wierszy):
-\begin{alltt}
-utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
-utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
-utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
-Uywajc przeszukiwania plikw z~fontami Type1, znajdmy font
-Times Roman \file{utmr8a.pfb} w~drzewie katalogw \file{texmf}:
-\begin{alltt}
-> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
-\else /usr/local/texmf-dist/fonts/type1/
-... urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
-Powysze przykady pokazuj, jak atwo mona znajdowa lokalizacj danego
-pliku. Jest to wane zwaszcza wwczas, gdy istnieje podejrzenie, e gdzie
-zawieruszya si bdna wersja jakiego pliku; \cmdname{kpsewhich} pokae tylko
-pierwszy napotkany plik.
-
-\subsubsection{Diagnostyka bdw}
-\label{sec:debugging}
-
-Czasami niezbdne s informacje o~tym, jak program sobie radzi
-z~odniesieniami do plikw. Aby dao si je uzyska w~wygodny sposb,
-\KPS{} oferuje rne poziomy diagnostyki bdw:
-\begin{itemize}
-\item[\texttt{\ 1}] wywoania \texttt{stat} (testy pliku). Podczas
- uruchamiania z~uaktualnion baz danych \file{ls-R} nie powinno to
- przewanie dawa adnego wyniku.
-\item[\texttt{\ 2}] Zapis odwoa do tablic asocjacyjnych (\emph{hash
- tables}), takich jak baza \file{ls-R}, pliki przemapowa, pliki konfiguracyjne.
-\item[\texttt{\ 4}] Operacje otwarcia i~zamknicia pliku.
-\item[\texttt{\ 8}] Oglne informacje o~ciekach dla typw
- plikw szukanych przez \KPS; uyteczne dla znalezienia cieki
- zdefiniowanej dla danego pliku.
-\item[\texttt{16}] Lista katalogw dla kadego z~elementw cieki
- (odnosi si tylko do poszukiwa na dysku).
-\item[\texttt{32}] Poszukiwania plikw.
-\end{itemize}
-Warto \texttt{-1} ustawia wszystkie powysze opcje -- w~praktyce,
-poszukujc przyczyny bdw, prawdopodobnie bdziesz zawsze uywa
-tych poziomw.
-
-Podobnie, w~przypadku programu \cmdname{dvips}, ustawiajc kombinacj
-przecznikw wykrywania bdw, mona dokadnie ledzi, skd pochodz pliki.
-W~sytuacji, gdy plik nie zostanie odnaleziony, wida, w~ktrych katalogach
-program szuka danego pliku, dziki czemu mona si zorientowa, w~czym
-problem.
-
-Oglnie mwic, poniewa programy odwouj si wewntrznie do
-biblioteki \KPS{}, opcje wykrywania bdw mona wybra przy uyciu
-zmiennej rodowiskowej \envname{KPATHSEA\_DEBUG}, ustawiajc j
-na opisan powyej warto (kombinacj wartoci).
-
-\noindent
-\textbf{Uwaga dla uytkownikw Windows:} w~systemie tym nieatwo
-przekierowa komunikaty programu do pliku. Do celw diagnostycznych
-mona chwilowo ustawi zmienne (w~oknie CMD):
-\begin{verbatim}
-SET KPATHSEA_DEBUG_OUTPUT=err.log
-SET KPATHSEA_DEBUG=-1
-\end{verbatim}
-
-Rozwamy na przykad may \LaTeX-owy plik rdowy \file{hello-world.tex},
-ktry zawiera:
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
-Ten may plik korzysta jedynie z~fontu \file{cmr10}. Przyjrzyjmy si, jak
-\cmdname{dvips} przygotowuje plik PostScript-owy (chcemy uy wersji Type1
-fontu Computer Modern, std opcja \texttt{-Pcms}).
-\begin{alltt}
-> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
-Mamy tu do czynienia jednoczenie z~czwart klas wykrywania bdw
-programu \cmdname{dvips} (cieki fontowe) oraz z~rozwijaniem elementu
-cieki przez \KPS{} (patrz: \emph{Dvips Reference Manual},
-\OnCD{texmf/doc/dvips/dvips.pdf}).
- %Komunikaty z~uruchomienia programu (lekko zmodyfikowane) znajduj si
- %na~rys.~\ref{fig:dvipsdbga}.
- %\begin{figure*}[tp]
- %\centering
- %\input{examples/ex6a.tex}
- %\caption{Szukanie pliku konfiguracyjnego}\label{fig:dvipsdbga}
- %
- %\bigskip
- %
- %\input{examples/ex6b.tex}
- %\caption{Szukanie pliku prologu}\label{fig:dvipsdbgb}
- %
- %\bigskip
- %
- %\input{examples/ex6c.tex}
- %\caption{Szukanie pliku fontu}\label{fig:dvipsdbgc}
- %\end{figure*}
- Program \cmdname{dvips} zaczyna prac od zlokalizowania potrzebnych mu plikw.
-Najpierw znajduje plik \file{texmf.cnf}, ktry zawiera cieki
-przeszukiwania dla innych plikw. Potem znajduje baz danych \file{ls-R}
-(w~celu optymalizacji szukania plikw), nastpnie plik \file{aliases},
-ktry umoliwia deklarowanie rnych nazw (np. krtkie \acro{DOS}-owe ,,8.3''
-i~bardziej naturalne dusze wersje) dla tych samych plikw.
-Nastpnie \cmdname{dvips} znajduje podstawowy plik konfiguracyjny
-\file{config.ps}, zanim poszuka pliku z~ustawieniami uytkownika
-\file{.dvipsrc} (ktry w~tym wypadku \emph{nie} zostaje odnaleziony).
-W~kocu \cmdname{dvips} lokalizuje plik konfiguracyjny \file{config.cms}
-dla fontw PostScript-owych Computer Modern (jest to inicjowane przez
-dodanie parametru \texttt{-Pcms} przy uruchamianiu programu).
-Plik ten zawiera list plikw z~,,mapami'', ktre definiuj relacje
-pomidzy \TeX-owymi, PostScript-owymi i~systemowymi nazwami fontw.
-\begin{alltt}
-> \Ucom{more /usr/local/texmf/dvips/config/config.cms}
-p +bsr.map
-p +bakomaextra.map
-\end{alltt}
-W~ten sposb \cmdname{dvips} wyszukuje wszystkie te pliki oraz gwny plik
-z~przemapowaniem
-\file{psfonts.map}, ktry adowany jest domylnie (zawiera on deklaracje
-czsto uywanych fontw postscriptowych; wicej szczegw na temat
-postscriptowych plikw przemapowa fontw mona znale w~ostatniej czci
-rozdziau \ref{SExamplesofuse}).
-
-W~tym miejscu \cmdname{dvips} zgasza si uytkownikowi:
-\begin{alltt}\ifSingleColumn
-This is dvips 5.86 Copyright 1999 Radical Eye Software (www.radicaleye.com)
-\else\small{}This is dvips 5.86 Copyright 1999 Radical Eye...
-\fi\end{alltt}% decided to accept slight overrun in tub case
-\ifSingleColumn
-\ldots potem szuka pliku prologu \file{texc.pro}:
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
-potem szuka pliku prologu \file{texc.pro}.
- %(patrz rys.~\ref{fig:dvipsdbgb}).
-
-\fi
-Po znalezieniu szukanego pliku \cmdname{dvips} podaje dat i~czas
-oraz informuje o~generowaniu pliku \file{hello-world.ps}.
-Poniewa potrzebuje pliku z~fontem \file{cmr10}, a~jest on
-zadeklarowany jako dostpny, wywietla komunikat:
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
-Teraz trwa poszukiwanie pliku \file{cmr10.tfm}, ktry zostaje znaleziony,
-po czym \cmdname{dvips} powouje si na kilka innych plikw startowych
-(nie pokazanych). W~kocu przykadowy font Type1 \file{cmr10.pfb}
-zostaje zlokalizowany i~doczony do pliku wynikowego (patrz ostatnia linia):
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-\subsection{Parametry kontrolujce dziaanie programw}
-Inn uyteczn cech \Webc{} jest moliwo ustalania wielu parametrw
-okrelajcych wielko pamici za pomoc pliku \texttt{texmf.cnf}.
- %Zacznik~\ref{app:texmf.cnf} zaczynajcy si na
- %stronie~\pageref{app:texmf.cnf} zawiera listing pliku \texttt{texmf.cnf}.
- Ustawienia wszystkich parametrw znajduj si w~czci trzeciej pliku.
-Najwaniejszymi zmiennymi s:
-\begin{description}
-\item[\code{main\_memory}] Cakowita wielko pamici dostpnej dla
- \TeX-a, \MF{}-a i~\MP{}-a. Dla kadego nowego ustawienia tej zmiennej
- naley wykona nowy format.
- %Przykadowo, moesz wygenerowa ,,ogromn'' wersj formatu \TeX{} i~nazwa
- %taki plik \texttt{hugetex.fmt}.
- %Dziki standardowemu sposobowi nazywania programw przez
- %\KPS{}, okrelona warto zmiennej \verb|main_memory| bdzie
- %przeczytana z~pliku \texttt{texmf.cnf} (por. warto standardow
- %oraz warto ,,ogromn'', wykorzystywan przez program \texttt{hugetex},
- %itd.).
- %
-\item[\code{extra\_mem\_bot}] Dodatkowa wielko pamici przeznaczonej
- na ,,due'' struktury danych \TeX-a, takie jak: pudeka, kleje itd.;
- przydatna zwaszcza w~wypadku korzystania z~pakietu \PiCTeX{}.
- %
-\item[\code{font\_mem\_size}] Wielko pamici przeznaczonej przez
- \TeX-a na informacje o~fontach. Jest to mniej wicej oglna
- wielko wczytywanych przez \TeX-a plikw TFM.
- %
-\item[\code{hash\_extra}] Dodatkowa wielko pamici przeznaczonej
- na tablic zawierajc nazwy instrukcji. Tablica gwna
- moe zmieci w~przyblieniu 10000 nazw; wielko ta moe si okaza
- zbyt maa, np. w~wypadku obszernej ksiki zawierajcej liczne
- odsyacze. Domylna warto \texttt{hash\_extra} to \texttt{50000}.
-\end{description}
- %
-Oczywicie powysza moliwo nie zastpi prawdziwej, dynamicznej
-alokacji pamici. Jest to jednak niezwykle trudne
-do zaimplementowania w~obecnej wersji \TeX-a i~dlatego
-powysze parametry stanowi praktyczny kompromis, pozwalajc
-na pewn elastyczno.
-
-Naley tu jednak nadmieni, i nie wszystkie programy korzystaj
-z tych zmiennych. Np. Lua\TeX\ posiada nowoczesn,
-w~peni dynamiczn alokacj pamici, a zatem powysze zmienne s
-w tym przypadku po prostu ignorowane.
-
-%%====
-%\begin{comment} %% nie wiem czemu rezygnowa z tej czci (SW)
-\section{Budowa systemu na nowej platformie uniksowej}\label{sec:build}
-Jeeli mamy do czynienia z~platform, dla ktrej nie s dostarczone binaria,
-trzeba bdzie skompilowa \TeX-a oraz towarzyszce mu programy.
-Nie jest to takie trudne, jak si wydaje.
-Wszystko czego potrzebujemy, znajduje si na \DVD{} w~katalogu
-\texttt{source}.
-
-Najpierw naley zainstalowa gwne drzewo plikw \TeX-owych z~\CD{}
-\TL{} (najlepiej wykona instalacj podstawow, bez wybierania
-binariw systemowych).
-
-\subsection{Warunki wstpne}
-Do skompilowania caego \TeX-a i~jego programw pomocniczych potrzeba
-okoo 100 megabajtw wolnego miejsca na dysku.
-Potrzebny jest take kompilator \acro{ANSI}~C, oprogramowanie \cmdname{make},
-skaner leksykalny oraz generator parserw.
-Programy uytkowe \acro{GNU} (\cmdname{gcc}, \acro{GNU}
-\cmdname{make}, \cmdname{m4}, \cmdname{flex}, \cmdname{bison})
-s najlepiej przetestowanymi na rnych platformach.
-Poprawnie powinny pracowa \cmdname{gcc}-2.7.*, \cmdname{flex}-2.4.7
-i~\acro{GNU}\,\cmdname{make}-3.72.1 lub nowszy.
-Mona te korzysta z~innych kompilatorw C i~programw
-\cmdname{make}, wymaga to jednak dobrego zrozumienia zasad tworzenia
-programw uniksowych, aby mc poradzi sobie z~ewentualnymi problemami.
- %W~wyniku wykonania polecenia \texttt{uname} powinnimy
- %otrzyma jak rozsdn warto.
-
-\subsection{Konfiguracja}
-Naley rozpakowa rda ze skompresowanego pliku \texttt{tar}
-z~katalogu \dirname{source} na twardy dysk, a~potem przej do katalogu,
-do ktrego zostay one skopiowane.
-Teraz trzeba si zdecydowa, gdzie bdzie gwny katalog instalacji,
-np.\ \path|/usr/TeX| lub \path|/usr/local/TeX|.
-Naturalnie, naley uy tej samej lokalizacji, ktra zostaa uyta
-podczas instalacji gwnego drzewa \TeX-owego.
-
-Uruchomi \textsf{configure} z~linii polece:
-\begin{alltt}
-> \Ucom{./configure --prefix=/usr/local/TeX}
-\end{alltt}
-
-Katalog ,,prefix'' to ten, w~ktrym zainstalowane zostao gwne drzewo
-\TeX-owe. Zostanie uyty nastpujcy ukad katalogw
- (\verb|$TEXDIR| oznacza wybrany powyej katalog):
-
-\noindent
-\begin{tabular}{>{\ttfamily}ll@{}}
- \dirname{$TEXDIR/man} & strony manuala uniksowego,\\
- \dirname{$TEXDIR/share/texmf} & gwne drzewo \TeX-owe,
- zawierajce makra itp.,\\
- \dirname{$TEXDIR/info} & podrczniki w formacie \acro{GNU}
- info,\\
- \dirname{$TEXDIR/bin/$PLATFORM} & binaria\\
-\end{tabular}
-%$
-
-Mona unikn stosowania ,,\dirname{share/}'' przed katalogiem
-\dirname{texmf}, poniewa \dirname{$TEXDIR/share/texmf}
-i~\dirname{$TEXDIR/texmf} s wykrywane automatycznie przez skrypt \cmdname{configure}.
-W~razie wybrania innego katalogu, trzeba ten katalog wyszczeglni
-parametrem \verb|--datadir| skryptu \cmdname{configure}.
-
-Jeeli nie chcemy uywa katalogu \dirname{$PLATFORM}
-(a~wic umieci binaria bezporednio w~\dirname{$TEXDIR/bin}), to
-w~wywoaniu skryptu \cmdname{configure} naley uy parametru
-\verb|--disable-multiplatform|.
-
-Wicej dostpnych parametrw (np. pomijanie pakietw opcjonalnych, takich
-jak \OMEGA) mona zobaczy, uruchamiajc
-\texttt{./configure -{}-help}.
-
-\subsection{Uruchamianie \textsf{make}}
-Po upewnieniu si, e nie jest ustawiona zmienna powoki \texttt{noclobber},
-naley napisa:
-\begin{alltt}
-> \Ucom{make world}
-\end{alltt}
-i~\ldots zaparzy sobie kaw.
-
-Moe si te przyda zapisanie caego procesu
-kompilacji w~pliku \texttt{.log}:
-\begin{alltt}
-> \Ucom{sh -c "make world >world.log 2>\&1" \&}
-\end{alltt}
-Zanim stwierdzimy, e wszystko jest w~porzdku, warto sprawdzi, czy w~pliku
-\texttt{.log} nie ma komunikatw bdw (kiedy polecenie zwraca kod bdu,
-\acro{GNU} \cmdname{make} zawsze uywa sekwencji \samp{***}),
-i~czy utworzone zostay wszystkie binaria:
-\begin{alltt}
-> \Ucom{cd \var{TEXDIR}/bin/\var{archname}}
-> \Ucom{ls | wc}
-\end{alltt}
-Oczekiwanym rezultatem jest ponad 200. Polecenie \texttt{make world} jest
-rwnowane z~\texttt{make all install strip}.
-Jeli do uruchamiania \texttt{make install} potrzebne s specjalne
-uprawnienia, mona uruchomi dwie oddzielne sesje \cmdname{make}:
-\begin{alltt}
-> \Ucom{make all}
-> \Ucom{su}
-> \Ucom{make install strip}
-\end{alltt}
-
-\subsection{Kocowe kroki konfiguracyjne}
-Naley uaktualni zmienn \envname{PATH} o~nazw katalogu zawierajcego
-wanie zainstalowane binaria (np.\
-\dirname{/usr/local/TeX/bin/mips-sgi-irix6.3}); podobnie postpi trzeba
-z~\envname{MANPATH} i~\envname{INFOPATH} i~doczy do nich
-odpowiednie nazwy podkatalogw, tj.\
-\dirname{$TEXDIR/man} oraz \dirname{$TEXDIR/info}.
-Patrz cz~\ref{sec:postinstall} (str.~\pageref{sec:postinstall}).
-
-Jeli zechcesz udostpni skompilowane przez siebie programy, skontaktuj
-si z~nami (\url{tex-live@tug.org}); chtnie umiecimy je na stronie \TL.
-%\end{comment}
-
-%--------------------------
-\section{Podzikowania} %\label{sec:acknowl}
-
-\TL{} jest wsplnym dzieem prawie wszystkich grup \TeX-owych.
-Niniejsza edycja \TL{} zostaa opracowana pod kierownictwem Karla Berry'ego,
-przy gwnym wspudziale:
-
-\begin{itemize*}
-\item grup \TeX-owych: midzynarodowej, niemieckiej, holenderskiej i~polskiej
- (odpowiednio: \acro{TUG}, \acro{DANTE} e.V., \acro{NTG}, i~\acro{GUST}),
- ktre wsplnie zapewniaj potrzebn infrastruktur techniczn
- i~organizacyjn. Docz do swojej grupy \TeX-owej!;
-\item zespou \acro{CTAN} (w~szczeglnoci Robina Fairbairnsa, Jima
- Hef{}ferona i~Rainera Sch\"opfa), ktry dystrybuuje obrazy \TL{} i~udostpnia
- wspln infrastruktur suc aktualizacji pakietw, od ktrej zaley \TL{};
-\item Petera Breitenlohnera i~zespou \eTeX, ktrzy stworzyli stabiln
- podstaw przyszych wersji \TeX-a (Peter dodatkowo suy nieustann pomoc
- w~wykorzystaniu narzdzi autotools w~\TL);
-\item Thomasa Essera, autora wspaniaego \teTeX-a, bez ktrego
- \TL{} z~ca pewnoci by nie powsta, i~ktrego staa
- pomoc umoliwia doskonalenie tej dystrybucji;
-\item Michaela Goossensa, ktry by wspautorem pierwotnej dokumentacji;
-\item Eitana Gurari, autora programu \TeX4ht{} (wykorzystanego do
- tworzenia niniejszej dokumentacji w~wersji \HTML), ktry niezmordowanie
- pracowa nad jego ulepszaniem i~byskawicznie dostarcza poprawki;
-\item Hansa Hagena, ktry dostosowywa \ConTeXt\ do potrzeb \TL;
-\item \Thanh{}a, Martina Schr\"odera i~zespou pdf\TeX-a, ktrzy cigle
- ulepszali moliwoci \TeX-a;
-\item Hartmuta Henkela, majcego istotny udzia w~rozwoju pdf\TeX-a,
- Lua\TeX-a i~innych programw;
-\item Taco Hoekwatera, ktry wznowi rozwj MetaPosta i~pracowa nad
- Lua\TeX-em, jak te pomg w~integracji \ConTeXt\ w~\TL;
-\item Pawa Jackowskiego, ktry wykona instalator dla Windows \cmdname{tlpm}
- i~Tomka uczaka, twrcy \cmdname{tlpmgui} (programy te byy wykorzystane
- w~poprzednich edycjach);
-\item Akira Kakuto, ktry dostarczy programy dla Windows, pochodzce
- z~dystrybucji \acro{W32TEX}
- (\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}),
- stale dostosowywane i~aktualizowane dla potrzeb \TL;
-\item Jonathana Kew z firmy \acro{SIL}, ktry zainicjowa now ciek
- rozwojow -- Xe\TeX{}, i~ktry woy sporo wysiku w~zintegrowanie
- tego programu z~\TL, jak rwnie zapocztkowa prace nad instalatorem dla
- Mac\TeX;
-\item Dicka Kocha, ktry pielgnuje Mac\TeX-a (\url{http://tug.org/mactex})
- w~cisym poczeniu z~\TL i~bardzo sympatycznie wsppracuje;
-\item Reinharda Kotuchy, majcego istotny udzia w~stworzeniu nowej infrastruktury
- i~programu instalacyjnego dla \TL{} 2008, uparcie dcego do ujednolicenia
- dziaania \TL{} w~Windows i~Unix, ktry rwnie opracowa skrypt
- \texttt{getnonfreefonts} i~wykona wiele innych prac;
-\item Siep Kroonenberg, ktra rwnie wzia udzia w~stworzeniu nowej
- infrastruktury i~programu instalacyjnego dla \TL{} 2008 (szczeglnie dla
- Windows) oraz woya ogrom pracy aktualizujc t dokumentacj;
-\item Petra Ol\shac{}\aac{}ka, ktry koordynowa i~sprawdza
- przygotowanie czeskich i~sowackich pakietw;
-\item Toshio Oshimy, ktry opracowa przegldark \cmdname{dviout} dla Windows;
-\item Manuela P\'egouri\'e-Gonnarda, ktry pomg w~aktualizacji pakietw
- i~pracowa nad \cmdname{tldoc}.
-\item Fabrice'a Popineau, ktry pierwszy stworzy wersje oprogramowania
- dla Windows;
-\item Norberta Preininga, gwnego architekta infrastruktury i~programu
- instalacyjnego \TL{} 2008, a~przyczyni si te do aktualizacji pakietw,
- koordynowania (wraz z~Frankiem K\"usterem) debianowej wersji \TL{},
- i~przedstawi wiele sugestii ulepsze;
-\item Sebastiana Rahtza, ktry stworzy \TL{} i~kierowa projektem przez
- wiele lat;
-\item Vladimira Volovicha, ktry wydatnie pomg w~rozwizywaniu problemw
- przenonoci, szczeglnie za umoliwi doczenia \cmdname{xindy};
-\item Staszka Wawrykiewicza, gwnego testujcego \TL{} w~rnych systemach,
- ktry ponadto koordynowa przygotowanie wszystkich polskich dodatkw (fontw,
- programw instalacyjnych i~wielu innych);
-\item Olafa Webera, ktry cierpliwie pielgnowa Web2C, od ktrego wszystko zaley;
-\item Gerbena Wierda, ktry przygotowa oprogramowanie i~wsparcie dla
- \MacOSX{};
-\item Grahama Williamsa, ktrego prace nad katalogiem pakietw bardzo
- pomogy w~przygotowaniu dystrybucji.
-\end{itemize*}
-
-Binaria dla rnych platform skompilowali:
-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}),
-Akira Kakuto (\pkgname{win32}),
-Dick Koch (\pkgname{universal-darwin}),
-Manfred Lotz (\pkgname{i386-freebsd}),
-Norbert Preining (\pkgname{alpha-linux}),
-Arthur Reutenauer (\pkgname{sparc-linux}),
-Thomas Schmitz (\pkgname{powerpc-linux}),
-Apostolos Syropoulos (\pkgname{i386-solaris}),
-Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-solaris}),
-Olaf Weber (\pkgname{mips-irix}).
-Informacje na temat procesu budowy \TL{} mona znale na stonie:
-\url{http://tug.org/texlive/build.html}.
-
-Aktualizacje i~tumaczenia dokumentacji wykonali:
-Siep Kroonenberg i~Karl Berry (angielski),
-Daniel Flipo (francuski),
-Klaus H\"oppner (niemiecki),
-Petr Sojka i~Jan Busa (czeski\slash sowacki),
-Boris Veytsman (rosyjski),
-Staszek Wawrykiewicz (polski).
-Na stronie \url{http://tug.org/texlive/doc.html} bd umieszczane ewentualne
-aktualizacje tej dokumentacji.
-
-Oczywicie, najwaniejsze podzikowania nale si Donaldowi Knuthowi
-za stworzenie systemu \TeX{} i~ofiarowanie go nam wszystkim.
-
-%%%
-\section{Historia}
-\label{sec:history}
-
-\subsection{Poprzednie wersje}
-
-Dystrybucja \TL{} jest wsplnym przedsiwziciem
-grup Uytkownikw Systemu \TeX{} z Niemiec, Holandii, Wielkiej
-Brytanii, Francji, Czech, Sowacji, Polski, Indii i~Rosji oraz grupy
-midzynarodowej TUG (\emph{\TeX{} Users Group}).
-Dyskusje nad projektem rozpoczy si pod koniec 1993 roku, kiedy holenderska
-Grupa Uytkownikw \TeX-a rozpocza prace nad swoim
-4All\TeX{} \CD{} dla uytkownikw \acro{MS-DOS}. W~tym te
-czasie pojawiy si nadzieje na opracowanie jednego \CD{} dla
-wszystkich systemw.
-Projekt ten by wprawdzie zbyt ambitny, zrodzi jednak nie tylko bardzo
-popularny i~uwieczony duym powodzeniem projekt 4All\TeX{} \CD{},
-lecz rwnie spowodowa powstanie Grupy Roboczej TUG ds. Standardu Katalogw
-\TeX-owych (\emph{\TeX{} Directory Structure}), okrelajcego, w~jaki
-sposb tworzy zgodne i~atwe do zarzdzania zestawy pakietw \TeX-owych.
-Kocowy raport \TDS{} zosta opublikowany w~grudniowym numerze
-\textsl{TUGboat}-a, i~jasnym si stao, e
-jednym z~oczekiwanych wynikw wprowadzenia tego standardu mogaby
-by modelowa struktura na pytce \CD.
-Wydana wwczas pytka \CD{} bya bezporednim rezultatem rozwaa i~zalece
-Grupy Roboczej ds. \TDS.
-Jasne take byo, e sukces 4All\TeX{} \CD{} pokaza, e
-uytkownicy Unixa take wiele by zyskali, mogc korzysta
-z~podobnie atwego w~instalacji/pielgnacji i~uytkowaniu systemu.
-Byo to jednym z~celw projektu \TL.
-
-Projekt przygotowania pytki \CD, opartej na standardzie \TDS i~zorientowanej
-na systemy uniksowe, rozpocz si jesieni 1995 roku. Szybko
-zdecydowalimy si na wykorzystanie \teTeX-a autorstwa Thomasa Essera, poniewa
-dziaa na wielu platformach i~zosta zaprojektowany z~myl
-o~przenonoci pomidzy rnymi systemami plikw. Thomas zgodzi si pomc
-i~prace rozpoczy si na dobre na pocztku 1996 roku. Pierwsze wydanie
-ukazao si w~maju 1996 roku. Na pocztku 1997 roku Karl Berry udostpni
-now, istotnie zmienion wersj swojego pakietu \Webc, zawierajc prawie
-wszystkie funkcje wprowadzone do \teTeX-a przez Thomasa Essera. W~zwizku
-z~tym zdecydowalimy si oprze drugie wydanie \CD{} na standardowej
-bibliotece \Webc, z~dodaniem skryptu \texttt{texconfig} z~pakietu \teTeX.
-Trzecie wydanie \CD{} byo oparte na \Webc{} wersji 7.2, przygotowanej przez
-Olafa Webera. W~tym samym czasie zostaa przygotowana nowa wersja \teTeX-a
-i~\TL{} udostpnia prawie wszystkie jego nowe funkcje.
-Czwarta edycja bya przygotowana podobnie,
-z~uyciem nowej wersji te\TeX-a i~nowej wersji \Webc{} (7.3).
-Wtedy to te zapocztkowano kompletn dystrybucj dla Windows.
-
-Edycja pita (marzec 2000) zawieraa wiele poprawek i~uzupenie;
-zaktualizowano setki pakietw. Szczegow zawarto pakietw
-zapisano w~plikach XML.
-Gwn zmian w~\TeX\ Live~5 byo usunicie programw, ktre nie miay
-statusu {\it public domain}. Zawarto caej pytki powinna odpowiada ustaleniom
-Debian Free Software Guidelines (\url{http://www.debian.org/intro/free}).
-Dooylimy wszelkich stara, aby sprawdzi warunki licencyjne pakietw,
-nadal jednak bardzo prosimy o~zgaszanie zauwaonych pomyek.
-
-Szsta edycja (lipiec 2001) zawieraa aktualizacje caego materiau. Gwn
-zmian byo wprowadzenie nowej koncepcji programw instalacyjnych -- uytkownik
-mia odtd moliwo dokadniejszego wyboru potrzebnych zestaww i~pakietw.
-Zestawy dotyczce obsugi poszczeglnych jzykw zostay cakowicie
-zreorganizowane, dziki czemu wybr jednego z~nich nie tylko instalowa
-potrzebne makra i~fonty, ale te przygotowywa odpowiedni plik
-\texttt{language.dat}.
-
-\TL~7 (rok 2002) zawiera po raz pierwszy oprogramowanie dla \MacOSX{}
-i -- jak zwykle -- aktualizacj wszelkich programw i~pakietw.
-Wanym zadaniem, ktre wykonano, byo ujednolicenie plikw rdowych
-programw z~dystrybucj te\TeX. W~programach instalacyjnych wprowadzono
-moliwo wyboru bardziej oglnych, predefiniowanych zestaww pakietw
-(m.in. dla uytkownikw francuskojzycznych oraz polskich). Nowoci
-byo take wprowadzenie procedury aktualizacji map fontowych dla Dvips
-i~PDFTeX podczas instalacji oraz doinstalowywania pakietw fontowych.
-
-W~2003~r., wraz z~napywem aktualizacji i~dodatkowych nowych pakietw,
-okazao si, e \TL{} nie mieci si na pojedynczym \CD.
-Zmuszeni bylimy podzieli \TL{} na trzy dystrybucje, ktre wydano
-na \DVD{} i~dwch pytkach \CD. Ponadto:
-
-\begin{itemize*}
-\item na yczenie ,,\LaTeX{} team'' zmieniono standardowe uycie
- programw \cmdname{latex} i~\cmdname{pdflatex}~-- by korzystay
- one z~\eTeX{} (patrz str.~\pageref{text:etex});
-\item zaczono nowe fonty obwiedniowe Latin Modern, ktre zastpuj
- m.in. fonty EC (zawierajc komplet znakw europejskich), szczeglnie
- do tworzenia poprawnych plikw PDF;
-\item usunito binaria dla platformy Alpha \acro{OSF} (poprzednio
- usunito take binaria dla \acro{HPUX}), niestety nie udao si znale
- osb chtnych do wykonania kompilacji;
-\item zmieniono instalacj w~systemach Windows, wprowadzajc po raz pierwszy
- zintegrowane rodowisko pracy, oparte na edytorze XEmacs;
-\item potrzebne programy pomocnicze dla Windows (Perl, Ghost\-script,
- Image\-Magick, Ispell) instalowano w~strukturze katalogw
- instalacji \TL;
-\item mapy fontowe, z~ktrych korzystaj programy \cmdname{dvips},
- \cmdname{dvipdfm} oraz \cmdname{pdftex}, generowano odtd w~katalogu
- \dirname{texmf/fonts/map};
-\item \TeX{}, \MF{} oraz \MP{} domylnie pozwalay wypisywa komunikaty
- na ekranie i~w~pliku .log, a~take w~operacjach \verb|\write| w~ich
- reprezentacji 8-bitowej, zamiast tradycyjnej notacji \verb|^^|;
- w~\TL{}~7 eksperymentalnie wprowadzono zaleno przekodowania
- wyjcia programw od systemowej strony kodowej, potem ten pomys
- zarzucono;
-\item znacznie zmieniono niniejsz dokumentacj;
-\item wreszcie, poniewa numery wersji kolejnych edycji mogy wprowadza
- w~bd, postanowiono identyfikowa edycje \TL{} zgodnie z~rokiem
- wydania.
-\end{itemize*}
-
-\subsection{Edycja 2004}
-
-Jak w~kadej kolejnej wersji, w~2004 roku uaktualniono wiele pakietw
-i~programw. Poniej wymieniamy najbardziej istotne zmiany.
-
-\begin{itemize}
-\item Gdy mielimy ju lokalnie zainstalowane fonty, ktre korzystay
-z~wasnych plikw \filename{.map} i/lub \filename{.enc}, \emph{naleao}
-przenie te pliki w~nowe miejsce w~strukturze \filename{texmf/}.
-
-Pliki \filename{.map} (map fontowych) s odtd wyszukiwane w~podkatalogach
-\dirname{fonts/map} (w~kadym drzewie \filename{texmf}), zgodnie ze ciek
-okrelon przez zmienn \envname{TEXFONTMAPS}. Analogicznie, pliki
-\filename{.enc} (przekodowa fontw) s odtd wyszukiwane w~podkatalogach
-\dirname{fonts/enc}, zgodnie ze ciek okrelon przez zmienn
-\envname{ENCFONTS}. O~niewaciwie umieszczonych plikach tego typu
-zostaniemy ostrzeeni podczas uruchomienia programu \cmdname{updmap}.
-Zmiany te wprowadzono w~celu uporzdkowania struktury katalogw: wszystkie
-pliki dotyczce fontw znajduj si odtd w~ramach jednego podkatalogu
-\dirname{fonts/}.
-
-Metody radzenia sobie z~sytuacjami zwizanymi z~przejciem na nowy ukad
-katalogw omawia artyku \url{http://tug.org/texlive/mapenc.html}.
-
-\item Do \TK\ \DVD{} dodano now dystrybucj dla Windows o~nazwie
-pro\TeX{}t (opart na \MIKTEX-u). Bya ona dostpna take na odrbnym \CD.
-Cho pro\TeX{}t nie bazuje na implementacji Web2C, stosuje ukad katalogw
-zgodny z~\TDS (patrz cz~\ref{sec:struct-tl} na
-str.~\pageref{sec:struct-tl}).
-
-\item W ramach \TL{} dotychczasowe pojedyncze drzewo katalogw
-\dirname{texmf} zostao rozdzielone na trzy mniejsze: \dirname{texmf},
-\dirname{texmf-dist} i~\dirname{texmf-doc} (patrz
-cz~\ref{sec:tld}, str.~\pageref{sec:tld}) oraz pliki \filename{README}
-w~kadym z~tych katalogw).
-
-\item Wszystkie pliki makr wczytywane przez \TeX-a zostay
-umieszczone wycznie w~podkalogu \dirname{tex} w~ramach
-\dirname{texmf*}. Tym samym usunito zbdne katalogi
-\dirname{etex}, \dirname{pdftex}, \dirname{pdfetex} itp. i~uproszczono
-metody wyszukiwania plikw.
-
-\item Pomocnicze skrypty wykonywalne, niezalene od platformy
-i~zwykle uruchamiane w~sposb automatyczny, byy odtd
-umieszczone w~nowym podkatalogu \dirname{scripts} w~ramach \dirname{texmf*}.
-Znajdowane s poleceniem \verb|kpsewhich -format=texmfscripts|.
-Programy korzystajce z tych skryptw mogy wymaga modyfikacji.
-Patrz \CDref{texmf-doc/doc/english/tds/tds.html\#Scripts}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Scripts}}.
-
-\item Prawie wszystkie formaty traktuj od tego wydania wikszo znakw jako
-jawnie ,,wywietlalne'' (\emph{printable}), nie za, jak byo dotychczas,
-konwertowane na \TeX-ow notacj \verb|^^|. Byo to moliwe dziki domylnemu
-wczytywaniu tablicy przekodowa \filename{cp227.tcx}. Dokadniej, znaki
-o~kodach 32--256, HT, VT oraz FF zostay potraktowane dosownie podczas
-wywietlania komunikatw. Wyjtkiem jest plain \TeX{} (tylko znaki z~zakresu
-32--127 s nie zmieniane), \ConTeXt{} (znaki z zakresu 0--255) oraz formaty
-bazujce na Omedze. Podobna domylna waciwo wystpowaa w~\TL\,2003, ale
-w~tej edycji zostaa zaimplementowana w~bardziej elegancki sposb
-i~z~wikszymi moliwociami indywidualnego dostosowania (patrz
-\CDref{texmf/doc/web2c/web2c.html\#TCX-files} {\texttt{texmf/doc/web2c/web2c.
-tml\#TCX-files}}. (Warto wspomnie, e wczytujc Unicode, \TeX{} moe
-w~komunikatach bdw pokazywa niekompletne sekwencje znakw, poniewa
-zosta zaprojektowany ,,bajtowo''.)
- %%! hmmm, cay akapit by o strumieniach we-wy?
-
-\item Program \textsf{pdfetex} zosta domyln ,,maszyn'' dla
-wikszoci formatw (nie dotyczy to samego Plain \textsf{tex}).
-Domylnie, gdy uruchamiamy polecenie \textsf{latex}, \textsf{mex}
-itp., generowane s pliki \acro{DVI}. Moliwe jest jednak wykorzystanie
-w~\LaTeX, \ConTeXt{} itp. m.in. waciwoci mikrotypograficznych
-zaimplementowanych w~\textsf{pdftex}, a~take rozszerzonych cech \eTeX-a
-(\OnCD{texmf-dist/doc/etex/base/}).
-
-Oznacza to take, co warto podkreli, e \emph{zalecane} jest odtd uycie
-pakietu \pkgname{ifpdf} (ktry dziaa zarwno z~plain, jak i~\LaTeX)
-lub analogicznych makr. Zwyke sprawdzanie czy zdefiniowano \cs{pdfoutput}
-bd kilka innych polece pierwotnych moe nie wystarczy do rozstrzygnicia
-czy nie jest generowany plik \acro{PDF}. W~2004 roku podjlimy
-wysiek by zachowa, najlepiej jak to moliwe, kompatybilno
-z~dotychczasowymi przyzwyczajeniami uytkownikw. Brano wwczas pod uwag,
-e \cs{pdfoutput} moe by zdefiniowany nawet wtedy,
-gdy generowany jest plik \acro{DVI}.
-
-\item pdf\TeX\ (\url{http://pdftex.org}) zyska wwczas wiele nowych
-cech:
-
- \begin{itemize*}
- \item \cs{pdfmapfile} i~\cs{pdfmapline} pozwalaj okreli
- z~poziomu dokumentu uyte mapy fontowe, a~take pojedyncze
- dodatkowe wpisy w~tych mapach.
-
- \item mikrotypograficzne operacje z~fontami s atwiejsze w uyciu;\\
- \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}
-
- \item wszystkie parametry pracy pdf\TeX-a, dotychczas okrelane
- w~specjalnym pliku konfiguracyjnym \filename{pdftex.cfg}, musz by
- odtd ustawiane poleceniami wbudowanymi, jak w~pliku
- \filename{pdftexconfig.tex}; plik \filename{pdftex.cfg}
- nie jest ju w~ogle wykorzystywany. Po zmianie \filename{pdftexconfig.tex}
- naleao na nowo wygenerowa pliki formatw (wci jednak uytkownik mia
- pen swobod okrelania parametrw w~redagowanym dokumencie);
-
- \item wicej informacji zawarto w~podrczniku pdf\TeX-a:
- \OnCD{texmf-dist/doc/pdftex/manual/pdftex-a.pdf}.
-
- \end{itemize*}
-
-\item Polecenie \cs{input} w~programach \cmdname{tex},
- \cmdname{mf} oraz \cmdname{mpost} akceptowao odtd nazwy
- plikw ograniczone podwjnymi apostrofami, zawierajce spacje i~inne
- znaki, np.:
-\begin{verbatim}
-\input "nazwa_pliku ze spacjami" % plain
-\input{"nazwa_pliku ze spacjami"} % latex
-\end{verbatim}
-Wicej informacji zawarto w~podrczniku Web2C: \OnCD{texmf/doc/web2c}.
-
-\item \texttt{-output-directory} -- nowa opcja programw \cmdname{tex},
- \cmdname{mf} oraz \cmdname{mpost} -- pozwalaa na zapisanie wyniku pracy
- w~wyspecyfikowanym katalogu (np. mona uruchomi program \texttt{tex}
- z~plikiem znajdujcym si na dysku tylko do odczytu, za wynik zapisa
- na dysku pozwalajcym na~to);
-
-\item Rozszerzenie enc\TeX\ zostao szczliwie wczone do Web2C.
- Aby uaktywni to rozszerzenie, naleao podczas generowania formatu
- uy opcji \optname{-enc}. Oglnie mwic, enc\TeX\ obsuguje
- przekodowanie wejcia i~wyjcia, wczajc take Unicode (\acro{UTF}-8)
- (patrz \OnCD{texmf-dist/doc/generic/enctex/} oraz
- \url{http://www.olsak.net/enctex.html}).
-
-\item Udostpniono nowy program Aleph, ktry czy cechy \eTeX\ i~\OMEGA.
- Skromna dokumentacja jest dostpna na \OnCD{texmf-dist/doc/aleph/base}
- oraz \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}.
- Format oparty na \LaTeX-u dla programu Aleph nazwano \textsf{lamed}.
-
-\item Dystrybucja \LaTeX-a zostaa po raz pierwszy zaopatrzona w~now
- licencj \acro{LPPL}, odtd w~peni zgodn i~aprobowan przez zalecenia
- okrelone w~licencji Debiana. O~nowociach i~uaktualnieniach mona si
- dowiedzie przegldajc pliki \filename{ltnews}
- w~\OnCD{texmf-dist/doc/latex/base}.
-
-\item Doczono take program \cmdname{dvipng} konwertujcy pliki \acro{DVI}
-do formatu graficznego \acro{PNG} (\OnCD{texmf/doc/man/man1/dvipng.1}).
-
-\item W~porozumieniu i~z~pomoc autora, Claudio Beccariego, ograniczono
- pakiet \pkgname{cbgreek} do zestawu fontw rozsdnego rozmiaru. Usunito
- sporadycznie uywane fonty konturowe i~suce do prezentacji. Peen
- zestaw by oczywicie nadal dostpny z~serwerw \acro{CTAN}
- (\url{http://www.ctan.org/tex-archive/fonts/greek/cb}).
-
-\item Usunito program \cmdname{oxdvi}; jego funkcje przej
- \cmdname{xdvi}.
-
-\item Programy z~przedrostkiem \cmdname{ini} oraz \cmdname{vir}
- (np. \cmdname{initex}), ktre zwykle byy dowizaniami do programw
- \cmdname{tex}, \cmdname{mf} i~\cmdname{mpost}, nie byy od tej pory dostpne
- -- w~zupenoci wystarcza uycie w~wierszu polece opcji \optname{-ini}.
-
-\item Dystrybucja nie zawieraa binariw dla platformy \textsf{i386-openbsd}
- (gwnie z~powodu braku chtnych do wykonania kompilacji).
-
-\item W~systemie \textsf{sparc-solaris} naleao ustawi zmienn systemow
- \envname{LD\_LIBRARY\_PATH}, aby uruchomi programy \pkgname{t1utils}.
- Binaria byy kompilowane w~C++, ale w~tym systemie brakowao standardowego
- pooenia bibliotek uruchomieniowych. Wiedziano o~tym ju wczeniej,
- nie byo to jednak dotychczas udokumentowane. Z~kolei dla systemu
- \textsf{mips-irix} wymagana bya obecno bibliotek \acro{MIPS}pro 7.4.
-
-\end{itemize}
-
-\subsection{Edycja 2005}
-
-Kolejna edycja przyniosa, jak zwykle, mnstwo aktualizacji pakietw
-i~programw. Struktura dystrybucji ustabilizowaa si, niemniej
-pojawio si nieco zmian w~konfiguracji:
-
-\begin{itemize}
-
-\item Wprowadzono nowe skrypty \cmdname{texconfig-sys}, \cmdname{updmap-sys}
- i~\cmdname{fmtutil-sys}, ktrych zadaniem jest modyfikowanie plikw
- konfiguracyjnych w~gwnych drzewach katalogw systemu. Dotychczasowe
- skrypty \cmdname{texconfig}, \cmdname{updmap} i~\cmdname{fmtutil}
- modyfikuj odtd pliki uytkownika w~katalogu \dirname{$HOME/.texlive2005}.
- %(Patrz cz~\ref{sec:texconfig}, str.~\pageref{sec:texconfig}).
-
-\item Dodano nowe zmienne rodowiskowe \envname{TEXMFCONFIG}
- i~\envname{TEXMFSYSCONFIG}, ktre wskazuj pooenie drzew katalogw
- z~plikami konfiguracyjnymi, odpowiednio: uytkownika i~systemu. Tak wic
- mogo okaza si koniecznym przeniesienie wasnych wersji
- \filename{fmtutil.cnf} i~\filename{updmap.cfg} w~odpowiednie miejsca.
- Inn moliwoci byo przedefiniowanie \envname{TEXMFCONFIG} lub
- \envname{TEXMFSYSCONFIG} w~pliku \file{texmf.cnf}. W~kadym z~przypadkw
- pooenie tych plikw i~przypisania
- \envname{TEXMFCONFIG} i~\envname{TEXMFSYSCONFIG} musz by zgodne.
- (Patrz cz~\ref{sec:texmftrees}, str.~\pageref{sec:texmftrees}.)
-
-\item W~wydaniu z~poprzedniego roku podczas tworzenia wynikowego pliku
- DVI \verb|\pdfoutput| i~podobne polecenia pozostaway niezdefiniowane, mimo
- e uywany by program \cmdname{pdfetex}. Zgodnie z~obietnic,
- w~2005 roku zarzucono to rozwizanie (jego celem byo zapewnienie
- kompatybilnoci). Z~tego powodu uytkownik by zmuszony zmieni te dokumenty,
- ktre uyway \verb|\ifx\pdfoutput\undefined| do sprawdzania, czy plik
- wynikowy ma by w~formacie PDF. Zamiast tego naleao zastosowa pakiet
- \pkgname{ifpdf.sty}, ktry dziaa zarwno z~plain \TeX-em jak i~\LaTeX-em,
- albo zapoyczy zastosowane w~nim rozwizania.
-
-\item W~wydaniu z~2004 roku zmieniono wikszo formatw tak, by
- na wyjciu 8-bitowe znaki byy reprezentowane przez same siebie (por.
- poprzednia cz). Nowy plik TCX o~nazwie \filename{empty.tcx} pozwala
- w~atwy sposb uzyska w~razie potrzeby oryginaln notacj (\verb|^^|),
- np.:
-
-\begin{verbatim}
-latex --translate-file=empty.tcx twojplik.tex
-\end{verbatim}
-
-\item Doczono nowy program \cmdname{dvipdfmx}, sucy do konwersji DVI
- do PDF. Program jest aktywnie pielgnowan wersj programu
- \cmdname{dvipdfm}, ktry wci jest dostpny, ale nie jest ju jednak
- polecany.
-
-\item Nowe programy \cmdname{pdfopen} i~\cmdname{pdfclose} pozwalay na
- przeadowanie plikw PDF w~Adobe Acrobat Reader, bez koniecznoci ponownego
- uruchamiania programu. (Inne przegldarki formatu PDF, jak \cmdname{xpdf},
- \cmdname{gv} i~\cmdname{gsview}, nigdy na t przypado nie cierpiay.)
-
-\item Dla spjnoci, zmienne \envname{HOMETEXMF} i~\envname{VARTEXMF} zostay
- przemianowane odpowiednio na \envname{TEXMFHOME} i~\envname{TEXMFSYSVAR}.
- Zachowano zmienn \envname{TEXMFVAR}, przeznaczon domylnie dla
- uytkownika. Patrz te punkt pierwszy, powyej.
-
-\end{itemize}
-
-\subsection{Edycja 2007}
-
-Najwiksz nowoci edycji lat 2006 i~2007 by Xe\TeX{},
-w~postaci programw \texttt{xetex} i~\texttt{xelatex}; patrz
-\OnCD{texmf-dist/doc/xetex/XeTeX-reference.pdf} lub
-\url{http://scripts.sil.org/xetex}.
-
-W istotny sposb zosta zaktualizowany MetaPost, zaplanowano take jego
-dalszy rozwj (\url{http://tug.org/metapost/articles}); to samo dotyczy
-pdf\TeX-a (\url{http://tug.org/applications/pdftex}).
-
-Pliki formatw (pdf)TeX-a (\filename{.fmt}) oraz analogiczne dla MetaPosta
-i~Meta\-Fonta s od tej edycji zapisywane w~podkatalogach
-\dirname{texmf/web2c}, cho sam ten katalog jest nadal przeszukiwany.
-Podkatalogi te maj nazw zgodn z~zastosowanym podczas generowania
-,,silnikiem'', np. \filename{tex}, \filename{pdftex} lub \filename{xetex}.
-Zmiana ta nie powinna by zauwaalna w~typowym uyciu.
-
-Program \texttt{tex} (plain) od tej edycji ju nie analizowa pierwszego
-wiersza rozpoczynajcego si znakami \texttt{\%\&}, aby ustali jaki ma
-wczyta format. Pozosta zatem czysty, Knuthowy \TeX. \LaTeX\ i~wszystkie
-pozostae formaty nadal analizuj pierwszy wiersz z~\texttt{\%\&}.
-
-Oczywicie, jak zwykle, w~okresie od poprzedniego wydania opracowano setki
-innych aktualizacji pakietw i programw. Kolejne aktualizacje mona znale
-tradycyjnie na \acro{CTAN} (\url{http://www.ctan.org}).
-
-Drzewo rdowe \TL{} jest odtd przechowywane w~Subversion. Przegldanie
-umoliwia standardowy interfejs www, a~jego adres zamieszczono na stronie
-\url{http://tug.org.pl/texlive}.
-Mimo i nie wida efektw tej zmiany w kocowej dystrybucji, mamy nadziej,
-e w~nadchodzcych latach bdzie to stabilne repozytorium oprogramowania
-dla rozwoju \TL{}.
-
-W~maju 2006~r. Thomas Esser ogosi, e zaprzestaje aktualizowania
-dystrybucji te\TeX{} (\url{http://tug.org/tetex}). Spowodowao to znaczny
-wzrost zainteresowanie \TL, szczeglnie wrd dystrybutorw
-\acro{GNU}/Linuksa. (W~\TL{} zdefiniowano w przyblieniu rwnowany, nowy
-schemat instalacyjny pod nazw \texttt{tetex}.) Mamy nadziej, e
-w~przyszoci doprowadzi to do takich ulepsze w~otoczeniu \TeX-owym, na
-ktrych skorzystaj wszyscy.
-
-\medskip \noindent
- %%!Kocowa uwaga, dotyczca przeszoci:
- Wszystkie wydania \TL{}, wraz z~dodatkowymi materiaami (np. okadkami
-pytek), s dostpne na stronie:
-\url{ftp://tug.org/historic/systems/texlive}.
-
-\subsection{Wydanie obecne}
-\label{sec:tlcurrent}
-
-W 2008 roku caa infrastruktura \TL{} zostaa przeprojektowana
-i~przeprogramowana. Informacja dotyczca instalacji jest przechowywana
-obecnie w~zwykym pliku tekstowym \filename{tlpkg/texlive.tlpdb}.
-
-Po zainstalowaniu \TL{} wreszcie jest moliwa jego aktualizacja z~internetu,
-podobnie jak od paru lat umoliwia to dystrybucja MiK\TeX. Zamierzamy
-regularnie aktualizowa pakiety, w~miar jak bd si pojawia na serwerach
-\CTAN.
-
-W~tym wydaniu pojawi si nowy ,,silnik'', Lua\TeX\
-(\url{http://luatex.org}). Prcz nowych, elastycznych moliwoci
-dotyczcych skadu, udostpnia on doskonay jzyk skryptowy do
-zastosowania zarwno w~dokumentach \TeX-owych, jak i~poza nimi.
-
-Obsuga dla Windows i~platform opartych na Unix zostaa obecnie znacznie
-bardziej zunifikowana. W~szczeglnoci wikszo skryptw w~Perlu i~Lua
-dostpna jest teraz take dla Windows (zastosowano ,,wewntrzny'' Perl,
-dostarczany wraz z~\TL).
-
-Pojawi si nowy skrypt \cmdname{tlmgr} (patrz cz~\ref{sec:tlmgr}), ktry
-staje si gwnym narzdziem do zarzdzania \TL{} po jego instalacji.
-Umoliwia on aktualizacj pakietw wraz z~niezbdnymi wtedy czynnociami,
-jak regenerowanie formatw, aktualizacja map fontowych itp.
-
-Wraz z pojawieniem si \cmdname{tlmgr} niektre funkcje \cmdname{texconfig}
-zostay zablokowane (edycja plikw konfiguracyjnych formatw i~wzorcw
-przenoszenia).
-
-Program \cmdname{xindy} do tworzenia skorowidzw
-(\url{http://xindy.sourceforge.net/}) jest obecnie dostpny dla wikszoci
-platform.
-
-Narzdzie \cmdname{kpsewhich} moe obecnie raportowa wszystkie wyniki
-przeszukiwania danego pliku (parametr \optname{--all}), jak rwnie
-ograniczy wyszukiwanie do jednego katalogu (parametr \optname{--subdir}).
-
-Program \cmdname{dvipdfmx} posiada obecnie funkcj \cmdname{extractbb}
-uzyskania informacji o~prostokcie ograniczajcym (\textit{bounding box});
-jest to jedna z~ostatnich cech przejtych od dawniej uywanego programu
-\cmdname{dvipdfm} (ktry jest nadal dostpny).
-
-Usunito aliasy fontw \filename{Times-Roman}, \filename{Helvetica}, itd.
-Rne pakiety korzystay z~nich w~nieoczekiwany sposb (np. spodziewajc
-si, e fonty te bd miay rne kodowanie). Nie ma obecnie dobrego sposobu
-na rozwizanie tych sprzecznoci.
-
-Usunito format \pkgname{platex}, by unikn konfliktu nazwy z~uywanym od
-wielu lat japoskim pakietem \pkgname{platex}; pakiet \pkgname{polski} (czyli
-dawny \pkgname{platex}) jest obecnie wystarczajcym sposobem na polonizacj
-dla \LaTeX-a.
-
-Usunito pliki \filename{.pool}, ktre s obecnie wkompilowane w~programy,
-co uatwia ich aktualizacj.
-
-Do tego wydania wczono take ostatnie zmiany dokonane przez
-Donalda Knutha (tzw. \textit{\TeX\ tuneup of 2008}); patrz:
-\url{http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf}.
-
-\subsection{Przysze wersje}
-
-\emph{Niniejsza dystrybucja nie jest doskonaa!} Planujemy kontynuowa
-wydawanie nowych wersji i~chcielibymy, eby zawieray one jeszcze wicej
-pomocnej dokumentacji, wicej programw uytkowych, lepsze programy
-instalacyjne oraz stale ulepszany i~poprawiany katalog makr
-i~fontw. Zadanie to jest wykonywane przez ciko pracujcych ochotnikw,
-powicajcych na to wiele swojego wolnego czasu. Wiele jeszcze zostao do
-zrobienia. Jeeli moesz pomc, nie zastanawiaj si i~przycz si do nas.
-Patrz: \url{http://tug.org/texlive/contribute.html}.
-
-Prosimy o~przesyanie poprawek, sugestii i~uzupenie oraz deklaracji
-pomocy w~opracowywaniu kolejnych edycji pod adres:
-%\begin{quote}
-\email{tex-live@tug.org}
-%\url{http://tug.org/texlive}
-%\end{quote}
-
-%Uaktualnienia, ogoszenia i~wskazwki bd dostpne na stronie
-%\url{http://tug.org/texlive.html}.
-
-\end{document}
-
diff --git a/Master/texmf-doc/source/texlive/texlive-ru/Makefile b/Master/texmf-doc/source/texlive/texlive-ru/Makefile
deleted file mode 100644
index 93708128b74..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-ru/Makefile
+++ /dev/null
@@ -1,3 +0,0 @@
-include ../texlive-en/Makefile
-doc = texlive-ru
-lang = russian
diff --git a/Master/texmf-doc/source/texlive/texlive-ru/live4ht.cfg b/Master/texmf-doc/source/texlive/texlive-ru/live4ht.cfg
deleted file mode 100644
index 508ccca27c8..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-ru/live4ht.cfg
+++ /dev/null
@@ -1,47 +0,0 @@
-% tex4ht configuration file for the TeX Live documentation.
-% Accumulated over many years. Public domain.
-%
-% html specifies the main output format.
-% info for extra debugging info in the log files.
-
-% better approach is to have html in one piece (including footnotes).
-% also the newest TeX4ht could produce UTF-8 output (-utf8 option)
-\Preamble{charset=iso-8859-5,html,info,fn-in}
-
-% add extra stylesheet
-\Configure{@HEAD}{\HCode{%
-<link rel="stylesheet" type="text/css" href="\jobname.css" />\Hnewline
-<link rel="stylesheet" type="text/css" href="tex-live.css" />\Hnewline
-}}
-
-% or LaTeX complains it is missing.
-\begin{document}
-
-\EndPreamble
-
-% simplify output for HTML. We leave TeX and LaTeX alone, since tex4ht
-% actually does the lowered E (and raised A) in CSS.
-\def\OMEGA{Omega}
-\def\LaTeXe{LaTeX2e}
-\def\eTeX{e-\TeX}
-\def\acro#1{#1}
-\def\MF{Metafont}
-\def\BibTeX{BibTeX}
-\def\warningbox{}
-\def\endwarningbox{}
-
-\newif\ifhackliterals
-\ifx\tldocenglish\undefined \else \hackliteralstrue \fi
-\ifx\tldocrussian\undefined \else \hackliteralstrue \fi
-\ifx\tldocgerman\undefined \else \hackliteralstrue \fi
-%
-\ifhackliterals
- % these definitions cause "missing } inserted" at \end{tabularx} in
- % French and Czech. don't know why.
- %
- % don't make these into links, as happens with \path. We only have a couple
- % special characters that actually occur.
- \def\dirname{\texttt\bgroup\catcode`\$=12 \catcode`\_=12 \finishliteral}
- \def\finishliteral#1{#1\egroup}
- \let\filename=\dirname
-\fi
diff --git a/Master/texmf-doc/source/texlive/texlive-ru/texlive-ru.tex b/Master/texmf-doc/source/texlive/texlive-ru/texlive-ru.tex
deleted file mode 100644
index 9184449b75c..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-ru/texlive-ru.tex
+++ /dev/null
@@ -1,2998 +0,0 @@
-% $Id$
-%
-%\def\Status{1}
-\documentclass{article}
-\let\tldocrussian=1 % for live4ht.cfg
-\usepackage{tex-live}
-\usepackage[koi8-r]{inputenc}
-\usepackage[russian]{babel}
-\newcommand\Unix{Unix}
-\newcommand\Windows{Windows}
-\usepackage{indentfirst, cmap}
-\def\p.{.~}%
-\renewcommand{\samp}[1]{<<\texttt{#1}>>}
-%
-\begin{document}
-
-\title{%
- {\huge \textit{ \protect\TL{}}\\\strut}
- {\LARGE \textsf{\TL{} 2008}}
-}
-
-\author{: \\[3mm]
- \url{http://tug.org/texlive/}}
-\date{ 2008}
-
-\maketitle
-
-
-\begin{multicols}{2}
-\tableofcontents
-\listoftables
-\end{multicols}
-
-\section{}
-\label{sec:intro}
-
-\subsection{\TeX\ Live \TeX\ Collection}
-
-
-
-\TL{} "--- \TeX{}
-\acro{GNU}/ , \MacOSX (32-) Windows.
-
-\TL{} , \DVD{} <<\TK{}>>.
-\DVD{} \TeX .
-\ref{sec:tl-coll-dists} \DVD{}.
-\TL{}, \TK{} \TeX .
- \TL{}.
-
- \TL{} \TeX{}, \LaTeXe{}, \ConTeXt, \MF, \MP,
-\BibTeX{} ; ,
-; ף .
-
-
- , ޣ ,
- \acro{CTAN}, \url{http://www.ctan.org}.
-
- \TeXLive{}
- ~\ref{sec:history}, \p.\pageref{sec:history}.
-
-
-\subsection{ }
-\label{sec:os-support}
-
- \TL{}
-, \MacOSX. ,
- \TL{} ,
- .
-
- Windows: Windows 2000
-. Windows 9\textit{x}, ME NT.
- .
- 64- Windows, 32-
- 64- .
-
- Windows \MacOSX{}
-~\ref{sec:tl-coll-dists}.
-
-\subsection{ \protect\TL{}}
-\label{sec:basic}
-
-\TL{} \DVD{} .
- "---
-. , \TL{}.
-
- \DVD{} \TL{}
-, \TL{} \DVD{}
-( \DVD{},
- ).
-
-
-\noindent ӣ . :
-\begin{itemize*}
-\item \texttt{install-tl}.
- : (
- Windows) (
- ).
- \code{-gui} \code{-no-gui}.
-
-\item << \TL{}>>,
- \prog{tlmgr}. ,
- , .
- , .
-\end{itemize*}
-
-
-\subsection{ }
-\label{sec:help}
-
- \TeX{} ,
- أ ģ .
-, , ,
- , . (
- , \'
-\TL{} \TeX{}, .
- \url{http://tug.org/interest.html#vendors}).
-
- , ,
- :
-
-\begin{description}
-
-\item[ :] "--- ,
- \url{http://tug.org/begin.html} .
-
-\item [\TeX{} \acro{FAQ}:] \TeX{} \acro{FAQ} (,
- ) "--- ,
- .
- \TL{} \OnCD{texmf-doc/doc/english/FAQ-en/html/index.html}
- \url{http://www.tex.ac.uk/faq}.
- , .
-
-\item [\TeX{} Catalogue:] - , ,
- .., \TeX{} Catalogue.
- , \TeX{}. .
- \url{http://www.ctan.org/help/Catalogue}.
-
-\item [\TeX{} :] ,
- \TeX{}, ,
- : \url{http://tug.org/interest.html}.
-
-\item [ :]
- "--- \url{news:comp.text.tex}
- \email{texhax@tug.org}.
- . .
- \url{http://groups.google.com/groups?group=comp.text.tex}
- \url{http://tug.org/mail-archives/texhax}. , ,
- (\url{http://google.com}) .
-
-\item [ ]
- , \dirname{comp.text.tex}
- Google ,
- \email{texhax@tug.org}.
- \emph{} ,
- :
- \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}.
-
-\item [ \TL{}]
- \TL{},
- ,
- \email{tex-live@tug.org}.
- , \TL{},
- ţ
- .
- \code{-{}-help} .
-
-\item[ ] \emph{( )}
- \dirname{ru.tex} ,
- ( \url{news:fido7.ru.tex}).
- , \code{demos.ddt.su}. FAQ
- ( "--- )
- .
-
-\end{description}
-
- , , .
- \dirname{comp.text.tex}, \code{texhax}, \dirname{fido7.ru.tex}
- , ,
- .
-
-
-% don't use \TL so the \uppercase in the headline works. Also so
-% tex4ht ends up with the right TeX. Likewise the \protect's.
-
-\section{ \protect\TeX\protect\ Live}
-\label{sec:overview-tl}
-
- \TK{}
- \TL{}.
-
-
-\subsection{\protect\TeX\protect\ Collection: \TL, pro\TeX{}t, Mac\TeX}
-\label{sec:tl-coll-dists}
-
-\DVD{} \TK{} :
-
-\begin{description}
-
-\item [\TL:] ,
- \DVD{}, .
-
-\item [Mac\TeX:] \MacOSX{}. \TL{}
- \MacOSX{} .
- "--- \url{http://www.tug.org/mactex/}.
-
-
-\item[pro\TeX{}t:] \MIKTEX\ Windows.
- \ProTeXt\ ݣ
- . \TL{}
- . \ProTeXt{} "---
- \url{http://tug.org/protext}.
-
-\item [CTAN:] \CTAN.
-
-\item[\texttt{texmf-extra}:]
- .
-
-
-\end{description}
-
- \CTAN{}, \pkgname{protext}
-\texttt{texmf-extra} \TL{},
- ,
- .
-
-
-\subsection{ }
-\label{sec:tld}
-
- \TL{}.
- \DVD \TK{} \TL{}
-\dirname{texlive}, .
-
-\begin{ttdescription}
-\item[bin:] \TeX{}, .
-%
-\item[readme.html:] WWW
- , .
-%
-\item[source:] , \Webc{}
- \TeX{} \MF{}.
-%
-\item[support:] .
- \emph{} .
- \TeX{}.
-%
-\item[texmf:] . \dirname{TEXMFMAIN} .
-%
-\item[texmf-dist:] . \dirname{TEXMFDIST} .
-%
-\item[texmf-doc:] ,
- .
-%
-\item[tlpkg:] , .
- Perl
- Ghostscript, \TL{},
- Windows, PSView.
-\end{ttdescription}
-
-
- ,
- \filename{README} ( ).
-
- \dirname{texmf-doc} ,
- .
- (, man, info)
-\dirname{texmf/doc}.
- \dirname{texmf-dist/doc}.
- \cmdname{texdoc}
-\cmdname{texdoctk}.
-\OnCD{doc.html} .
-
- \TL{}
-\dirname{texmf-doc} :
-\begin{itemize*}
-\item{:} \OnCD{texmf-doc/doc/english/texlive-en}
-\item{ :} \OnCD{texmf-doc/doc/chinese/texlive-zh-cn}
-\item{:} \OnCD{texmf-doc/doc/german/texlive-de}
-\item{:} \OnCD{texmf-doc/doc/polish/texlive-pl}
-\item{:} \OnCD{texmf-doc/doc/russian/texlive-ru}
-\item{:} \OnCD{texmf-doc/doc/french/texlive-fr}
-\item{ :} \OnCD{texmf-doc/doc/czechslovak/texlive-cz}
-\end{itemize*}
-
-\subsection{ texmf}
-\label{sec:texmftrees}
-
- ,
- texmf .
-\texttt{texconfig conf} ,
- ,
- .
-
-\begin{ttdescription}
-\item [TEXMFMAIN] , ,
- , (,
- \verb+web2c/mktexdir+),
- . \TeX .
-\item [TEXMFDIST] ,
- .. .
-\item [TEXMFLOCAL] ,
- ,
- .., .
-\item [TEXMFHOME] ,
- , .., ̣
- .
- .
-\item [TEXMFCONFIG]
- \verb+texconfig+, \verb+updmap+ \verb+fmtutil+
- .
- \envname{TEXMFHOME}.
-\item [TEXMFSYSCONFIG]
- \verb+texconfig-sys+, \verb+updmap-sys+ \verb+fmtutil-sys+
-
- , .
-\item [TEXMFVAR] \verb+texconfig+,
- \verb+updmap+ \verb+fmtutil+
- : , .
- \envname{TEXMFHOME}.
-\item [TEXMFSYSVAR]
- \verb+texconfig-sys+, \verb+updmap-sys+, \verb+fmtutil-sys+,
- \verb+tlmgr+
- :
- , , "--- .
-\end{ttdescription}
-
-\noindent
- :
-\begin{description}
- \item[ ] \TL{}:
- \begin{ttdescription}
- \item[2007] .
- \begin{ttdescription}
- \item [...]
- \end{ttdescription}
- \item[2008] .
- \begin{ttdescription}
- \item [bin] ~
- \begin{ttdescription}
- \item [i386-linux] \GNU/Linux
- \item [...]
- \item [universal-darwin] \MacOSX
- \item [win32] Windows
- \end{ttdescription}
- \item [texmf] \envname{TEXMFMAIN}.
- \item [texmf-dist] \envname{TEXMFDIST}
- \item [texmf-doc] \envname{TEXMFDOC}
- \item [texmf-var] \envname{TEXMFSYSVAR}
- \item [texmf-config] \envname{TEXMFSYSCONFIG}
- \end{ttdescription}
- \item [texmf-local] \envname{TEXMFLOCAL},
- \TL{}.
- \end{ttdescription}
- \item[ ] (\texttt{\$HOME}
- \texttt{\%USERPROFILE\%})
- \begin{ttdescription}
- \item[.texlive2007]
- .
- \item[.texlive2008]
- .
- \begin{ttdescription}
- \item [texmf-var] \envname{TEXMFVAR}
- \item [texmf-config] \envname{TEXMFCONFIG}
- \end{ttdescription}
- \item[texmf] \envname{TEXMFHOME} .
- \textit{etc.}
- \end{ttdescription}
-\end{description}
-
-\subsection{ \protect\TeX{}}
-\label{sec:tex-extensions}
-
- \TeX "---
- , . ݣ
- \TL{} \prog{tex}
- . \TL{} \TeX{}:
-
-\begin{description}
-
-\item [\eTeX]
-\label{text:etex}
-( , ,
- ) \TeXXeT{}
-ף . \eTeX{}
-100\% \TeX{}. .
-\OnCD{texmf-dist/doc/etex/base/etex_man.pdf}.
-
-\item [pdf\TeX] \eTeX ,
- \acro{PDF}, \dvi{}.
- , , \prog{etex},
- \prog{latex}, \prog{pdflatex}. . \url{http://www.pdftex.org/}.
- \OnCD{texmf/doc/pdftex/manual/}
- \OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex}
- .
-
-\item[Lua\TeX] pdf\TeX{} .
- , .
- Aleph, . . Lua (.
- \url{http://www.lua.org/})
- \TeX .
- \filename{texlua}, Lua,
- \TL{}. . \url{http://www.luatex.org/}
- \OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}.
-
-\item [Xe\TeX] Unicode
- OpenType, . .
- \url{http://scripts.sil.org/xetex}.
-
-\item [\OMEGA\ ()] Unicode ( 16-
- ),
- . <<
- \OMEGA{}>> (\acro{OTP}s)
- . .
- \OnCD{texmf-dist/doc/omega/base/doc-1.8.tex} ( ).
-
-
-\item[Aleph] \OMEGA\ \eTeX. .
- \OnCD{texmf-dist/doc/aleph/base}.
-
-\end{description}
-
-
-\subsection{ \protect\TL}
-
- \TL{}:
-
-\begin{cmddescription}
-
-\item [bibtex] .
-
-\item [makeindex] .
-
-\item [dvips] \dvi{} \PS{}.
-
-\item [xdvi] \dvi{} X Window System.
-
-\item [dvilj] HP LaserJet.
-
-\item [dv2dt, dt2dv] \dvi{} .
-
-\item [dviconcat, dviselect] \dvi{}.
-
-\item [dvipdfmx] \dvi{} \acro{PDF},
- pdf\TeX{}, . \pkgname{ps4pdf}
-\pkgname{pdftricks} .
-
-\item [psselect, psnup, \ldots] \PS{}.
-
-\item [lacheck] \LaTeX{}.
-
-\item [texexec, texmfstart] Con\TeX{}t \acro{PDF}.
-
-\item [tex4ht] \TeX{} \acro{HTML}, \acro{XML}
- .
-
-\end{cmddescription}
-
-\subsection{ \protect\TL{}}
-\label{sec:tl-fonts}
-
- \TL{} .
-. \url{http://tug.org/fonts}
-\OnCD{texmf-doc/english/free-math-fonts-survey}.
-
-\section{}
-\label{sec:install}
-
-\subsection{ }
-\label{sec:inst-start}
-
- \DVD{} \TK{} \TL{}
- . : \filename{install-tl}
-, \filename{install-tl.bat} Windows.
-
-\begin{description}
-\item [ :] \CTAN,
-\dirname{systems/texlive/tlnet};
-\url{http://mirror.ctan.org/systems/texlive/tlnet}
- .
-\filename{install-tl.zip} ( Windows),
-
-\filename{install-unx.tar.gz} ( ).
- \filename{install-tl}
-\filename{install-tl.bat} \dirname{install-tl}.
-
-\item [\TeX{} Collection \DVD:]
- \dirname{texlive}. Windows
- , \DVD{} .
- \DVD, \TeX (
- ,
- \url{http://tug.org/usergroups.html}),
- (\url{http://tug.org/store}), ,
- \ISO\ (\url{http://tug.org/texlive/acquire.html}).
-
-\end{description}
-
-
- .
-
-\subsubsection{}
-
-\begin{figure}[tb]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
-
- Detected platform: Intel x86 with GNU/Linux
-
- <B> binary systems: 1 out of 16
-
- <S> Installation scheme (scheme-full)
-
- Customizing installation scheme:
- <C> standard collections
- <L> language collections
- 83 collections out of 84, disk space required: 1666 MB
-
- <D> directories:
- TEXDIR (the main TeX directory):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
- [X] install macro/font doc tree
- [X] install macro/font source tree
- [ ] create symlinks in standard directories
-
- <V> Install for running from DVD
-
-Other actions:
- <I> start installation to HD
- <H> help
- <Q> quit
-
-Enter command:
-\end{boxedverbatim}
-\caption{
- (\GNU/Linux)}\label{fig:text-main}
-\end{figure}
-
-
-\begin{figure}[tb]
-\tlpng{install-w32-main}{\linewidth}
-\caption{
- (Windows)}\label{fig:gui-main}
-\end{figure}
-
-\noindent
- \texttt{>} ; ,
-, \Ucom{\texttt{ }}.
- , :
-\begin{alltt}
-> \Ucom{cd /path/to/installer}
-> \Ucom{perl install-tl}
-\end{alltt}
-(, \Ucom{perl
- /path/to/installer/install-tl},
-\Ucom{./install-tl}, ,
-.. .)
-
-
- (
-\dirname{Perl/TK})
-\begin{alltt}
-> \Ucom{perl install-tl -gui}
-\end{alltt}
-
-
-\begin{alltt}
-> \Ucom{perl install-tl -help}
-\end{alltt}
-
-\textbf{ :}
-\TL{} \code{umask}.
- ,
-, , , , \code{
- umask 022}. \code{umask}
- .
-
-\subsubsection{Mac\,OS\,X}
-
- ~\ref{sec:tl-coll-dists}, \MacOSX{}
- , Mac\TeX{}
-(\url{http://tug.org/mactex}).
- , \TL{},
- , , ,
- \TeX \MacOSX{}
-(Mac\TeX, gw\TeX, Fink, MacPorts, \ldots).
-
-Mac\TeX{} \TL{},
-.
-, .
-
-\subsubsection{Windows}
-
- ,
-\DVD{} ,
-\filename{install-tl.bat}.
-
- . \texttt{>}
- ; , ,
-\Ucom{\texttt{ }}.
- , :
-\begin{alltt}
-> \Ucom{install-tl}
-\end{alltt}
-
- , ,
-\begin{alltt}
-> \Ucom{D:\bs{}texlive\bs{}install-tl}
-\end{alltt}
-(, \dirname{D:} \DVD{} \TK{}).
-
-
-\begin{alltt}
-> \Ucom{install-tl -no-gui}
-\end{alltt}
-
-
-
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-
-\subsubsection{ }
-
- ~\ref{fig:text-main}
- .
-
- :
-. ,
-<<Tab>>. - ( !)
- <<Enter>>, .
-
- :
- , ,
- Perl ( Windows
-Perl ).
-
-\subsubsection{ }
-
- ~\ref{fig:gui-main}
- . ~\ref{fig:text-main}
- , Windows,
-"--- GNU/Linux.
-
-\subsection{ }
-\label{sec:runinstall}
-
- .
- .
-
-\subsubsection{ ( )}
-\label{sec:binary}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Available sets of binaries:
-====================================================================
-
- a [ ] alpha-linux DEC Alpha with GNU/Linux
- b [ ] amd64-freebsd x86_64 with FreeBSD
- c [ ] hppa-hpux HP-UX
- d [ ] i386-freebsd Intel x86 with FreeBSD
- e [X] i386-linux Intel x86 with GNU/Linux
- f [ ] i386-openbsd Intel x86 with OpenBSD
- g [ ] i386-solaris Intel x86 with Sun Solaris
- h [ ] mips-irix SGI IRIX
- i [ ] powerpc-aix PowerPC with AIX
- j [ ] powerpc-linux PowerPC with GNU/Linux
- k [ ] sparc-linux Sparc with GNU/Linux
- l [ ] sparc-solaris Sparc with Solaris
- m [ ] universal-darwin universal binaries for MacOSX/Darwin
- o [ ] win32 Windows
- p [ ] x86_64-linux x86_64 with GNU/Linux
-\end{boxedverbatim}
-\caption{ }\label{fig:bin-text}
-\end{figure}
-
- ~\ref{fig:bin-text} .
-
-.
- . ,
- \TeX{}
-,
-.
-
-\subsubsection{ }
-\label{sec:components}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Select a scheme:
-====================================================================
-
- a [ ] TeX Live basic scheme
- b [ ] TeX Live scheme for ConTeXt
- c [X] TeX Live full scheme
- d [ ] GUST TeX Live scheme
- e [ ] GUTenberg TeX Live scheme
- f [ ] TeX Live medium scheme
- g [ ] TeX Live minimal scheme
- h [ ] TeX Live for Omega users
- i [ ] teTeX scheme
- j [ ] XML typesetting scheme
-\end{boxedverbatim}
-\caption{ }\label{fig:scheme-text}
-\end{figure}
-
- ~\ref{fig:scheme-text}
- () \TL{}. <<>>,
-.. .
-\optname{full}, .. \TL{},
-\optname{basic} , \optname{minimal}
- \optname{medium} \optname{teTeX}.
- ,
- .
-
-\begin{figure}[tbh]
-\tlpng{stdcoll}{.7\linewidth}
-\caption{ ()}\label{fig:collections-gui}
-\end{figure}
-
- <<>>
-(~\ref{fig:collections-gui},
- ).
-
-
- \TL{}. , ,
- , ( \TL{})
-, ..
-
- , ,
- \prog{tlmgr}
-(. ~\ref{sec:tlmgr}).
- .
-
-\subsubsection{}
-\label{sec:directories}
-
- ~\ref{sec:texmftrees},
-\p.\pageref{sec:texmftrees}.
-\dirname{TEXDIR} Windows
-(|%PROGRAMFILES%\texlive\2008|)
-(\dirname{/usr/local/texlive/2008}).
-
- ,
-"--- .
- \TL{},
- , .
-
- ,
- ,
- .
- `|~|' `|~/texlive/2008|'.
-
- ,
- \TL{}.
- \dirname{/usr/local/texlive-cur}
- .
-
- \dirname{TEXDIR} \dirname{TEXMFLOCAL},
-\dirname{TEXMFSYSVAR} \dirname{TEXMFSYSCONFIG}.
-
-
-\dirname{TEXMFHOME}. |~/texmf|.
-\dirname{TEXDIR}, |~| .
- \dirname{$HOME}
-\verb|%USERPROFILE%| Windows.
-
-\subsubsection{}
-\label{sec:options}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-<P> use letter size instead of A4 by default: [ ]
-<F> create all format files: [X]
-<D> install font/macro doc tree: [X]
-<S> install font/macro source tree: [X]
-<L> create symlinks in standard directories: [ ]
- binaries to:
- manpages to:
- info to:
-\end{boxedverbatim}
-\caption{ (Unix)}\label{fig:options-text}
-\end{figure}
-
- ~\ref{fig:options-text} (
-). :
-\begin{description}
-\item[use letter size instead of A4 by default (
- letter A4):]
- . ,
- .
-
-\item[create all format files ( ):]
- ,
- .
- \dirname{TEXMFVAR} .
-
- ,
- .
-
-\item[create symlinks in standard directories (
- )] ( ):
- . ţ \TL{}
- \envname{PATH}, \envname{MANPATH} \envname{INFOPATH}.
- .
- \TeX{}
- .
- \dirname{/usr/local/bin},
- \TeX .
-\end{description}
-
- , ,
- <<|I|>>. ,
-~\ref{sec:postinstall}.
-
-\subsubsection{ DVD{} ( )}
-\label{sec:fromdvd}
-
- <<|V|>>.
-, ~\ref{fig:main-fromdvd}.
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
- <D> directories:
- TEXDIRW (Writable root):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
-
- <V> set up for installing to hard disk
-
-Other actions:
- <I> start installation for running from DVD
- <H> help
- <Q> quit
-\end{boxedverbatim}
-\caption{ \optname{from
- DVD}}\label{fig:main-fromdvd}
-\end{figure}
-
- : ,
-, \dirname{TEXDIRW},
-.. .
-.
-
-
-, \dirname{texmf},
-\dirname{texmf-dist} \dirname{texmf-doc}.
-
- ,
- ,
- ; . ~\ref{sec:postinstall}.
-
-- ,
- , Wiindows. Windows
- ,
-. ~\ref{sec:cmdline}.
-
- ~\ref{sec:portable-unix} \TL{}
-, "---
- \TL{}.
-
-\subsection{ }
-\label{sec:cmdline}
-
-
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
- .
- |-|, |--|. :
-
-\begin{ttdescription}
-\item[-gui] , .
- Perl/Tk (\url{http://tug.org/texlive/distro.html#perltk});
- ,
- .
-\item[-no-gui] , Windows.
- , \TL{} \DVD{},
- .
-\item[-lang {\sl LL}]
- ( \textsl{LL}). :
- (\texttt{en}, ),
- (\texttt{de}), (\texttt{fr}), (\texttt{nl}),
- (\texttt{pl}), (\texttt{sl})
- (\texttt{vi}).
- ,
- , .
-\item[-profile {\sl profile}]
- \filename{texlive.profile} \dirname{2008/tlpkg}
- \dirname{tlpkg}.
- . :
- \begin{fverbatim}
-# texlive.profile written on Wed Jul 9 16:13:44 2008 UTC
-# It will NOT be updated and reflects only the
-# installation profile at installation time.
-selected_scheme scheme-basic
-TEXDIR /usr/local/texlive/2008
-TEXDIRW /usr/local/texlive/2008
-...
-TEXMFSYSVAR /usr/local/texlive/2008/texmf-var
-collection-basic 1
-...
-option_symlinks 0
- \end{fverbatim}
- \TL{}
- .
-\item [-location {\sl url/path}]
- ; . .
-\end{ttdescription}
-
-\subsubsection{ \optname{location}}
-\label{sec:location}
-
- URL, \texttt{ftp:},
-\texttt{http:}, \texttt{file:/} .
- (
-\texttt{file:/}), ,
- : \dirname{archive}
- \filename{.tar.lzma}, ,
- .
-
- \texttt{http:} \texttt{ftp:},
-\texttt{/} \texttt{/tlpkg}
-. ,
-\CTAN{}:
-\url{http://ctan.example.org/tex-archive/texlive/tlnet/2008}.
-, \dirname{example.ctan.org}
- (
- \url{http://mirror.ctan.org}).
- \url{http://mirror.ctan.org};
- .
-
-
-\subsection{ }
-\label{sec:postinstall}
-
- .
-
-\subsubsection{Windows}
-
- Windows .
-
-\subsubsection{ }
-
-
-(. ~\ref{sec:options}),
-.
-
-\subsubsection{ }
-\label{sec:env}
-
-
- .
- \dirname{TEXDIR/bin}. .
-
-~\ref{fig:bin-text}.
-
- man
-info , ,
- .
-
-
-Intel86 GNU/Linux.
-
- Bourne (\prog{bash} ..)
- \filename{$HOME/.profile} ( ,
-\filename{.profile}) :
-
-\begin{sverbatim}
-PATH=/usr/local/texlive/2008/bin/i386-linux:$PATH; export PATH
-MANPATH=/usr/local/texlive/2008/texmf/doc/man:$MANPATH; export MANPATH
-INFOPATH=/usr/local/texlive/2008/texmf/doc/info:$INFOPATH; export INFOPATH
-\end{sverbatim}
-
- \prog{csh} \prog{tcsh}
-\filename{$HOME/.cshrc}, -
-
-\begin{sverbatim}
-setenv PATH /usr/local/texlive/2008/bin/i386-linux:$PATH
-setenv MANPATH /usr/local/texlive/2008/texmf/doc/man:$MANPATH
-setenv INFOPATH /usr/local/texlive/2008/texmf/doc/info:$INFOPATH
-\end{sverbatim}
-
-,
- ; \TL{}.
-
-\subsubsection{ : }
-\label{sec:envglobal}
-
- ,
- ,
- :
--.
-
- : 1)~,
-\filename{/etc/manpath.config} :
-
-\begin{sverbatim}
-MANPATH_MAP /usr/local/texlive/2008/bin/i386-linux \
- /usr/local/texlive/2008/texmf/doc/man
-\end{sverbatim}
-
- 2)~
- \filename{/etc/environment}.
-
-\subsubsection{ DVD}
-
- \TL{} , ,
- \filename{texmf.cnf}. , ,
- . ,
- \DVD{}. \DVD{} , ,
- \filename{texmf.cnf},
-, \DVD{},
- . ,
- \envname{TEXMFCNF},
-\TL{}, \filename{texmf.cnf}.
- \envname{PATH}, .
-
- , ,
- \envname{TEXMFCNF}. ,
- : \dirname{$TEXMFSYSVAR/web2c}.
- \dirname{/usr/local/texlive/2008/texmf-var/web2c},
- ţ :
-\begin{sverbatim}
-TEXMFCNF=/usr/local/texlive/2008/texmf-var/web2c; export TEXMFCNF
-\end{sverbatim}
-, [t]csh:
-\begin{sverbatim}
-setenv TEXMFCNF /usr/local/texlive/2008/texmf-var/web2c
-\end{sverbatim}
-
-\subsubsection{\ConTeXt{} Mark IV}
-
-<<>> \ConTeXt{} << >>.
-Mark~IV ;
-. \url{http://wiki.contextgarden.net/Running_Mark_IV}.
-
-
-\subsubsection{ }
-\label{sec:local-personal-macros}
-
- ~\ref{sec:texmftrees}:
-
-\dirname{TEXMFLOCAL} ( ,
-\dirname{/usr/local/texlive/texmf-local}
-\verb|C:\Program Files\texlive\texmf-local|),
- "--- \dirname{TEXMFHOME} ( ,
-\dirname{$HOME/texmf} \verb|%USERPROFILE%\texmf|).
- \TL{}, \TL{}
- .
-\dirname{TEXMFLOCAL},
-.
-
-
-; . \url{http://tug.org/tds}
-\filename{texmf/web2c/texmf.cnf}. , \LaTeX
- \dirname{TEXMFLOCAL/tex/latex}
-\dirname{TEXMFHOME/tex/latex} - .
-
- \dirname{TEXMFLOCAL}
- , .
- \cmdname{mktexlsr} <<Reinit file
-database>> \prog{tlmgr}.
-
-\subsubsection{ }
-
- , . ,
- \TeX . ,
- , . ~\ref{sec:tl-fonts}.
-
- "--- \XeTeX{} (.
-~\ref{sec:tex-extensions}),
- \TeX .
-
-\subsection{ }
-\label{sec:test-install}
-
-
- \TL{} , ,
-, /
-.
-
- .
- Unix; \MacOSX{}
-Windows , , ,
- .
-
-\begin{enumerate}
-
-\item ,
- \cmdname{tex}:
-
-\begin{alltt}
-> \Ucom{tex -{}-version}
-TeX 3.1415926 (Web2C 7.5.7)
-kpathsea version 3.5.7
-...
-\end{alltt}
- <<command not found>>
- , , ,
- \envname{PATH}. .
-~\pageref{sec:env}.
-
-
-\item \LaTeX{} :
-\begin{alltt}
-> \Ucom{latex sample2e.tex}
-This is pdfeTeXk, Version 3.1415926...
-...
-Output written on sample2e.dvi (3 pages, 7484 bytes).
-Transcript written on sample2e.log.
-\end{alltt}
- \filename{sample2e.tex}
-, , :
- .
- , \TeX . (
- \TeX{} , ; . <<>>
-.~\pageref{sec:debugging}.)
-
-\item :
-\begin{alltt}
-> \Ucom{xdvi sample2e.dvi}
-\end{alltt}
-( Windows \cmdname{dviout}.)
- ף ,
-\LaTeX{}. ( "--- , \' .)
- \cmdname{xdvi} , X Window;
- , \envname{DISPLAY}
-, \samp{Can't open display}.
-
-\item \PS{} :
-\begin{alltt}
-> \Ucom{dvips sample2e.dvi -o sample2e.ps}
-\end{alltt}
-
-\item \acro{PDF} \dvi{};
- \filename{.tex} \acro{PDF}:
-\begin{alltt}
-> \Ucom{pdflatex sample2e.tex}
-\end{alltt}
-
-\item :
-\begin{alltt}
-> \Ucom{gv sample2e.pdf}
-\textrm{:}
-> \Ucom{xpdf sample2e.pdf}
-\end{alltt}
- , \cmdname{gv}, \cmdname{xpdf}
- \TL{}, ģ
-. .
-\url{http://www.gnu.org/software/gv}
-\url{http://www.foolabs.com/xpdf}. (,
- \acro{PDF}).
-
-\item , :
-
-\begin{ttdescription}
-\item [small2e.tex] , \filename{sample2e},
- , .
-\item [testpage.tex]
- .
-\item [nfssfont.tex] .
-\item [testfont.tex] plain \TeX{}.
-\item [story.tex] (plain) \TeX.
- \samp{\bs bye} \code{*}
- \samp{tex story.tex}.
-\end{ttdescription}
-\end{enumerate}
-
-
- \TeX{},
- \TeX{} \LaTeX{},
-\url{http://tug.org/begin.html}.
-
-\section{ }
-\label{sec:netinstall}
-
-\TL{}
- .
- : \TL{}
-, , ,
- . , ,
- \filename{$TEXMFMAIN/web2c/texmf.cnf}
-
-\begin{sverbatim}
-TEXMFMAIN = $SELFAUTOPARENT/texmf
-...
-TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local
-\end{sverbatim}
- ,
- \TL{} .
-
- \TL{} ,
- .
-
-, Windows .
-\dirname{texmf-doc/source/texlive/texlive-common/w32client}
- \filename{install-w32client},
- \TL{} .
- \filename{install-w32client.bat},
- .
-
- \TL{}
- ~\ref{sec:kpathsea}.
-
-\section{ \protect\TL{} DVD USB}
-\label{sec:portable-unix}
-
- << \DVD>>, ~\ref{sec:fromdvd},
- , "---
-- , ,
- .
-
- \DVD{} \TL{}, \dirname{texlive}
-\DVD{} \TK{} \filename{tl-portable} ()
-\filename{tl-portable.bat} (Windows),
- , \TL{}
- \DVD{}.
-
- ,
- \dirname{~/.tlportable2008},
- .
-.
-
- \TL{}. ,
- \TL{},
-\filename{tl-portable}.
-
- \filename{tl-portable},
-\TL{} \acro{USB}.
-, \dirname{bin},
-\dirname{texmf}, \dirname{texmf-dist} \dirname{tlpkg} .
- !
-\acro{FAT}32, (\code{cp -L}).
- \dirname{texmf-local},
-.
-
- \filename{tl-portable}
- , .
-, ,
- . \DVD{},
-(, - \TL{}).
-
-\section{ \cmdname{tlmgr}}
-\label{sec:tlmgr}
-
-\begin{figure}[tb]
-\tlpng{tlmgr-gui}{\linewidth}
-\caption{\prog{tlmgr} .
- //
- <<Load>>}\label{fig:tlmgr-gui}
-\end{figure}
-
-\begin{figure}[tb]
-\tlpng{tlmgr-config}{\linewidth}
-\caption{\texttt{tlmgr} :
- }\label{fig:tlmgr-config}
-\end{figure}
-
-\TL{} \prog{tlmgr}
- . \prog{updmap}, \prog{fmtutil}
-\prog{texconfig} ݣ ,
- \prog{tlmgr}. ţ :
-\begin{itemize*}
-\item , ;
-\item , , ,
- , ;
-\item ;
-\item ;
-\item , ,
- (. ~\ref{sec:location}).
-\end{itemize*}
-\textit{:} \prog{tlmgr} \TL{}
-\DVD{}, .
-
-\subsection{ \cmdname{tlmgr} }
- \prog{tlmgr} :
-\begin{alltt}
-> \Ucom{tlmgr -gui}
-\end{alltt}
- Windows Start: \texttt{Start}, \texttt{Programs},
-\texttt{TeX Live 2008}, \texttt{TeX Live Manager}.
- <<Load>>,
- "--- <<(i)>>. , ,
- , .
-
- ~\ref{fig:tlmgr-config} .
-
-\subsection{ \cmdname{tlmgr} }
-
- ,
-, :
-\begin{alltt}
-> \Ucom{tlmgr -location http://172.16.18.1/tldev install collection-xetex xkeyval}
-\end{alltt}
- :
-\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/2008/texmf/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-config/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-dist/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-doc/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/../texmf-local/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-var/ls-R...
-mktexlsr: Done.
-regenerating fmtutil.cnf
-running fmtutil-sys --missing
-...
-Transcript written on xelatex.log.
-fmtutil: /usr/local/texlive/2008/texmf-var/web2c/xetex/xelatex.fmt installed.
-\end{fverbatim}
- , \prog{tlmgr}
- ,
- ( \XeTeX ).
-
- .
- :
-\begin{alltt}
-> \Ucom{tlmgr install collection-langdutch}
-\end{alltt}
- :
-\begin{alltt}
-> \Ucom{tlmgr show collection-wintools}
-\end{alltt}
- :
-\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
-\end{fverbatim}
- :
-\begin{alltt}
-> \Ucom{tlmgr update -all}
-\end{alltt}
- ,
-\begin{alltt}
-> \Ucom{tlmgr update -all -dry-run}
-\end{alltt}
-
-\begin{alltt}
-> \Ucom{tlmgr update -list}
-\end{alltt}
-:
-\begin{alltt}
-> \Ucom{tlmgr -help}
-\end{alltt}
-
-\section{ Windows}
-\label{sec:windows}
-
- \TL{} , Windows,
- . ,
- Windows, \TL{}
- Windows 2000 .
-
-\subsection{ Windows}
-\label{sec:winfeatures}
-
- Windows :
-\begin{description}
-\item[ .] <<\TL{}>>
- <<Start>>,
- (\prog{tlmgr}, \prog{texdoctk}, PS\_View
- PostScript) .
- PS\_View , .
-\item[ .]
- .
-\item[ .]
- <<Add/Remove Programs>> <<\TL{}>>. <<>>
- \prog{tlmgr} .
-\end{description}
-
-
-
-\subsection{ Windows}
-
-\begin{figure}[tb]
-\tlpng{psview}{.6\linewidth}
-\caption{PS\_View: !}\label{fig:psview}
-\end{figure}
-
-
- \TL ,
- Windows. \TL{}
- :
-\begin{description}
-\item[Perl Ghostscript.] , \TL{}
- <<>> . \TL{}, ,
- , ,
- .
- Perl Ghostscript, .
-\item[ .] \TL{}
- Windows
- : \cmdname{gzip}, \cmdname{chktex},
- \cmdname{jpeg2ps}, \cmdname{unzip}, \cmdname{wget}
- \cmdname{xpdf}. ( \cmdname{xpdf} Windows ,
- Sumatra:
- \url{http://blog.kowalczyk.info/software/sumatrapdf}.)
-\item[\texttt{fc-cache}] \XeTeX
- .
-\item[PS\_View.] PS\_View,
- PostScript ,
- . ~\ref{fig:psview}.
-\end{description}
-\begin{description}
-\item[ \texttt{support},]
- ~\ref{sec:tld}.
- , \TeX , ,
- .
- .
- \dvi{} "--- \cmdname{dviout},
- .
-\end{description}
-
-\subsection{ Dviout}
-
- , \TL{}
- \dvi{} Windows.
- \prog{dviout}
-\path{support/dviout/}.
-\filename{README}, \prog{dviout}
- \TL{}. .
-
- .
- ,
- ,
- .
- ( ) .
-
-\subsection{ }
-
- ,
-:
-\begin{description}
-\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/}
-\item[Perl] \url{http://www.activestate.com/}
- \acro{CPAN}, \url{http://www.cpan.org/}
-\item[ImageMagick] \url{http://www.imagemagick.com},
- .
-\item[NetPBM] \url{http://netpbm.sourceforge.net/}, /
-
-\item[ \TeX ] , "---
- . , :
- \begin{itemize*}
- \item \cmdname{GNU Emacs} Windows, .
- \url{http://www.gnu.org/software/emacs/windows/ntemacs.html}.
- \item \cmdname{Emacs} Auc\TeX Windows
- \path{support} \TL{}; :
- \url{http://www.gnu.org/software/auctex}.
- \item \cmdname{WinShell} \path|support| \TL{};
- : \url{http://www.winshell.de}.
- \item \cmdname{WinEdt} shareware,
- \url{http://www.winedt.com}.
- \item \cmdname{Vim} ,
- \url{http://www.vim.org}.
- \item TeXnicCenter ,
- \url{http://www.toolscenter.org} pro\TeX{}t.
- \item \cmdname{LEd} \url{http://www.ctan.org/support/LEd}.
- \item \cmdname{SciTE}
- \url{http://www.scintilla.org/SciTE.html}.
- \end{itemize*}
-\end{description}
-
-\subsection{ Windows}
-\label{sec:winhome}
-
-
-\verb|%USERPROFILE%|. Windows XP Windows 2000
-\verb|C:\Documents and Settings\<username>|, Windows Vista "---
-\verb|C:\Users\<username>|. \filename{texmf.cnf}
- \KPS{}, \verb|~| Windows,
- .
-
-\subsection{ Windows}
-\label{sec:registry}
-
-Windows .
- ,
- .
-\path{HKEY_CURRENT_USER} \path{HKEY_LOCAL_MACHINE},
-\path{HKCU} \path{HKLM}. , \path{HKCU}
- (. ~\ref{sec:winhome}),
-\path{HKLM} "--- Windows.
-
- ,
- (, ) .
-, ,
- .
-
-\subsection{ Windows}
-\label{sec:winpermissions}
-
- Windows
- ,
- .
-
-<< >> << >>:
- , .
- \TL{}
-.
-
- ,
-, .
- ,
- .
- , ,
- \optname{non-admin} \prog{install-tl}.
-
- , \TL{},
- ,
-\verb|%PROGRAMFILES%|. ,
- .
-
- ,
-, \TeX{}.
- , \TeX{} \TL{}
- . ,
- , \TL{}
- .
-\TL{}.
-
-\section{ Web2C}
-
-\Webc{} "--- ,
-\TeX{}: \TeX{}, \MF{}, \MP, \BibTeX{}, ..
-\TL{}. \Webc{}
- \url{http://tug.org/web2c}.
-
- .
-, 1987 \TeX{}-to-C,
- ,
-. , ţ
- Web-to-C\@. 1990
- , , 1997
- .
-
- \Webc{} , 32- Windows, \MacOSX{},
- .
- \TeX{} , \web{}
-ģ C. :
-
-\begin{cmddescription}
-\item[bibtex] .
-\item[dmp] \cmdname{troff} MPX ( \MP{}).
-\item[dvicopy] \dvi{}.
-\item[dvitomp] \dvi{} MPX ( \MP{}).
-\item[dvitype] \dvi{} .
-\item[gftodvi] .
-\item[gftopk]
-\item[gftype] GF .
-\item[makempx] \MP{}.
-\item[mf] .
-\item[mft] \MF{}.
-\item[mpost] .
-\item[mpto] \MP{}.
-\item[newer] .
-\item[patgen] .
-\item[pktogf] PK GF.
-\item[pktype] PK
-\item[pltotf] TFM.
-\item[pooltype] pool \web{}.
-\item[tangle] \web{} Pascal.
-\item[tex] .
-\item[tftopl] TFM .
-\item[vftovp] .
-\item[vptovf] .
-\item[weave] \web{} \TeX.
-\end{cmddescription}
-
-\noindent
- \Webc{}.
-
- \Webc{}.
-
- \acro{GNU}:
-\begin{ttdescription}
-\item[-{}-help]
-\item[-{}-verbose]
-\item[-{}-version] .
-\end{ttdescription}
-
- \Webc{} \KPS{}
-(\url{http://tug.org/kpathsea}).
- ,
- \TeX{}. \Webc{}
- ,
- \TeX{} .
- \file{ls-R},
-
-.
-
-\subsection{ Kpathsea}
-\label{sec:kpathsea}
-
- \KPS.
-
- \emph{ԣ } ̣
- \emph{ },
- .
-. \samp{my-file}
-\samp{.:/dir}, \KPS{} :
- \file{./my-file}, \file{/dir/my-file},
- (, , ).
-
- , \KPS{} ,
- ,
-\samp{:} \samp{/}.
-
- ̣ \var{p}, \KPS{}
- (. <<
->> .~\pageref{sec:filename-database}), ..,
-, \var{p}. ,
- .
-
- ,
-, ,
-( , \samp{!!},
- ). \KPS{} ,
- ,
-.
-
- << >> \samp{.vf}
-, \TeX{} \cs{openin}.
- (, \file{cmr10.vf}),
- . ,
-\file{ls-R} \samp{.vf},
-. : ,
- . , ,
- .
-
- "---
- , \KPS{} :
- , ,
- ,
-, . ,
- \KPS{} \emph{} , ..,
- .
- , .
-
-,
-, .. \samp{/}, \samp{./},
-\samp{../}, \KPS{} , .
-
-\ifSingleColumn
-\else
-\begin{figure*}
-\verbatiminput{examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{ }
- \label{fig:config-sample}
-\end{figure*}
-\fi
-
-\subsubsection{ }
-\label{sec:path-sources}
-
- . \KPS{}
- :
-
-\begin{enumerate}
-\item ,
- \envname{TEXINPUTS}\@.
- ; \samp{latex} "---
- . \envname{TEXINPUTS.latex}
- \envname{TEXINPUTS}.
-\item
- , , ,
-
- \samp{S /a:/b} \file{config.ps} \cmdname{dvips}.
-\item
- \KPS{} \file{texmf.cnf},
-
- \samp{TEXINPUTS=/c:/d} (. ).
-\item , .
-\end{enumerate}
-\noindent
-, (. <<>>
- .~\pageref{sec:debugging}).
-
-\subsubsection{ }
-
-\begingroup\tolerance=3500
-\KPS{} \emph{ }
-\file{texmf.cnf} .
- \envname{TEXMFCNF} ( ,
- \file{texmf/web2c}). \emph{}
- \file{texmf.cnf} ,
- .
-, \verb|.:$TEXMF|,
-\file{./texmf.cnf}
-\verb|$TEXMF/texmf.cnf|.
-\endgroup
-
-\begin{itemize}
-\item
- \code{\%} .
-\item
-
-\item
- \bs{} , ..
- .
- .
-\item
-
-\begin{alltt}
- \emph{variable}[.\emph{progname}] [=] \emph{value}
-\end{alltt}%
- \samp{=} .
-\item
- \ttvar{variable} , ,
- \samp{=} \samp{.}, ģ
- \samp{A-Za-z\_}.
-\item
- \samp{.\var{progname}},
- ,
- \texttt{\var{progname}} \texttt{\var{progname}.exe}.
- , \TeX{} .
-\item \var{value} ,
- \code{\%} \samp{@}.
- \code{\$\var{var}.\var{prog}} ;
- .
- \samp{;} \samp{:} \samp{:};
- , , \acro{MS-DOS}
- Windows.
-\item
- ,
- , .
-\end{itemize}
- , , e
-\ifSingleColumn
-:
-
-\verbatiminput{examples/ex5.tex}
-\else
-e .~\ref{fig:config-sample}.
-\fi
-
-\subsubsection{ }
-\label{sec:path-expansion}
-
-
-\KPS{} ̣
- ,
-. ,
-\verb+~$USER/{foo,bar}//baz+,
-\file{foo} \file{bar}
-\texttt{\$USER}, \file{baz}.
- .
-
-%$
-\subsubsection{ }
-\label{sec:default-expansion}
-
-\tolerance=2500
-
- (. <<
->> .~\pageref{sec:path-sources}) \emph{
- } ( , , ), \KPS{}
- ԣ.
- , ԣ.
-,
-
-\tolerance=1500
-
-\begin{alltt}
-> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
- \code{TEXINPUTS} \file{texmf.cnf}
-
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
- ԣ
-
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-
-
- , \KPS{} ,
-: , ,
- .
-
-\subsubsection{ }
-
- , - , ,
-\verb+v{a,b}w+ \verb+vaw:vbw+. .
- , ԣ
- \code{\$TEXMF}.
-, \file{texmf.cnf},
-( , ݣ ):
-\begin{verbatim}
- TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN}
-\end{verbatim}
- :
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-%$
- ,
-\emph{} \code{\$TEXMFHOME/tex}, \code{\$TEXMFLOCAL/tex},
-\code{\$TEXMFVAR/tex} \code{\$TEXMFMAIN/tex} (
- \file{ls-R}).
- , <<>> (, \CD)
- .
-\code{\$TEXMF} ,
- .
-
-\subsubsection{ }
-\label{sec:subdirectory-expansion}
-
- \samp{/}
-\var{d} \var{d} .
- \emph{ ̣}.
-
- \samp{//},
- .
-, \samp{/a//b} \file{/a/1/b},
-\file{/a/2/b}, \file{/a/1/1/b}, .., \file{/a/b/c}
-\file{/a/1}.
-
- \samp{//} ,
-\samp{//} .
-
-\subsubsection{ }
-
-
- \KPS{}.
-
-\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
-\begin{ttdescription}
-\item[\CODE{:}] ;
- .
-\item[\CODE{;}] - ( , \code{:}).
-\item[\CODE{\$}] .
-\item[\CODE{\string~}] .
-\item[\CODE{\char`\{...\char`\}}] .
-\item[\CODE{//}] (
- , ).
-\item[\CODE{\%}] .
-\item[\CODE{\bs}] ( ).
-\item[\CODE{!!}] \emph{} , \emph{}
- .
-\end{ttdescription}
-
-
-\subsection{ }
-\label{sec:filename-database}
-
-\KPS{} .
-
- ( ,
- ). \KPS{}
- ,
-<< >> \file{ls-R}, ,
-, .
-
-ݣ , \file{aliases}
- \file{ls-R}. ,
- \acro{DOS} <<8.3>>.
-
-\subsubsection{ \texttt{ls-R}}
-\label{sec:ls-R}
-
- , \file{ls-R}.
- ţ \TeX{},
- \KPS{} ( , \code{\$TEXMF});
- . \KPS{} \file{ls-R}
-\code{TEXMFDBS}.
-
- \samp{ls-R} "---
-\code{mktexlsr}, ޣ .
- \samp{mktex}\dots.
-
-\begin{alltt}
-cd \var{/your/texmf/root} && \path|\|ls -1LAR ./ >ls-R
-\end{alltt}
- , \code{ls}
-(\acro{GNU} \code{ls} ).
- , ţ
-\code{cron},
- .
-
- , \KPS{} .
- \samp{!!},
-\emph{} .
-
-
-\subsubsection{kpsewhich: }
-\label{sec:invoking-kpsewhich}
-
- \texttt{kpsewhich}
-, .
- \code{find} \TeX{}
-( \samp{mktex}\dots).
-
-\begin{alltt}
-> \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}}
-\end{alltt}
-, \ttvar{option}, \samp{-}
- \samp{-{}-}, .
-
-\KPS{} , ,
-, .
- ( \samp{find}).
-
- .
-
-\begin{ttdescription}
-\item[\texttt{-{}-dpi=\var{num}}]\mbox{}\\
- \ttvar{num};
- \samp{gf} \samp{pk}. \samp{-D},
- \cmdname{dvips}. 600.
-
-\item[\texttt{-{}-format=\var{name}}]\mbox{}\\
- \ttvar{name}. ,
- . ,
- , , \MP{}
-
- \cmdname{dvips}, , \KPS{},
- , \texttt{tex} \texttt{enc files}.
- \texttt{kpsewhich -{}-help}.
-
-\item[\texttt{-{}-mode=\var{string}}]\mbox{}\\
- \ttvar{string};
- \samp{gf} \samp{pk}. :
- .
-
-\item[\texttt{-{}-must-exist}]\mbox{}\\
- ӣ , .
-
- \file{ls-R}.
-
-\item[\texttt{-{}-path=\var{string}}]\mbox{}\\
- \ttvar{string} ( , ̣
- ), ,
- . \samp{//} .
- \samp{-{}-path} \samp{-{}-format} .
-
-\item[\texttt{-{}-progname=\var{name}}]\mbox{}\\
- \texttt{\var{name}}.
- - \texttt{.\var{progname}}.
- \cmdname{kpsewhich}.
-
-\item[\texttt{-{}-show-path=\var{name}}]\mbox{}\\
- ,
- \texttt{\var{name}}. (\code{.pk},
- \code{.vf} ..) , \samp{-{}-format}.
-
-\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\
- \texttt{\var{num}}.
-\end{ttdescription}
-
-
-
-\subsubsection{ }
-\label{sec:examples-of-use}
-
- \KPS{} . :
-
-\begin{alltt}
-> \Ucom{kpsewhich article.cls}
- /usr/local/texmf-dist/tex/latex/base/article.cls
-\end{alltt}
- \file{article.cls}. \samp{.cls}
-, ,
-\optname{tex} ( \TeX{}).
-\file{tex/latex/base} \samp{temf-dist} \TL. ,
-ӣ :
-\begin{alltt}
-> \Ucom{kpsewhich array.sty}
- /usr/local/texmf-dist/tex/latex/tools/array.sty
-> \Ucom{kpsewhich latin1.def}
- /usr/local/texmf-dist/tex/latex/base/latin1.def
-> \Ucom{kpsewhich size10.clo}
- /usr/local/texmf-dist/tex/latex/base/size10.clo
-> \Ucom{kpsewhich small2e.tex}
- /usr/local/texmf-dist/tex/latex/base/small2e.tex
-> \Ucom{kpsewhich tugboat.bib}
- /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-, "---
-\textsl{TUGBoat}.
-
-\begin{alltt}
-> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
- \file{.pk}
-\cmdname{dvips} \cmdname{xdvi}. ,
- Computer Modern \samp{.pk} (
- Type~1 \TL{}).
-\begin{alltt}
-> \Ucom{kpsewhich wsiupa10.pk}
-\ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
-\else /usr/local/texmf-var/fonts/pk/ljfour/public/
-... wsuipa/wsuipa10.600pk
-\fi\end{alltt}
- ( ,
- )
-\samp{.pk}, \MF{} [
-\texttt{ljfour} of 600\dpi{} ( ),
- .
-\begin{alltt}
-> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
-\end{alltt}
- 300\dpi{} (\texttt{-dpi=300});
-, .
-\cmdname{dvips} \cmdname{xdvi}
-\texttt{.pk} \cmdname{mktexpk}.
-
-
-\cmdname{dvips}.
- , \file{tex.pro} \TeX{},
- \file{config.ps}
- \file{psfonts.map} ( 2004
- \dirname{texmf}).
-\samp{.ps} , ,
-: (\optname{dvips config}) \texttt{config.ps}.
-\begin{alltt}
-> \Ucom{kpsewhich tex.pro}
- /usr/local/texmf/dvips/base/tex.pro
-> \Ucom{kpsewhich --format="dvips config" config.ps}
- /usr/local/texmf/dvips/config/config.ps
-> \Ucom{kpsewhich psfonts.map}
- /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map
-\end{alltt}
-
- \acro{URW} Times (\PS{}).
- \samp{utm}.
- ,
- :
-\begin{alltt}
-> \Ucom{kpsewhich --format="dvips config" config.utm}
-/usr/local/texmf-dist/dvips/psnfss/config.utm
-\end{alltt}
- :
-\begin{alltt}
- p +utm.map
-\end{alltt}
- \file{utm.map}, .
-\begin{alltt}
-> \Ucom{kpsewhich --format="dvips config" utm.map}
- /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
-\end{alltt}
- Type~1 (\PS{})
- URW. ( ):
-\begin{alltt}
-utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
-utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
-utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
- ģ, , Times Roman
-\file{utmr8a.pfb}:
-\begin{alltt}
-> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
-\else /usr/local/texmf-dist/fonts/type1/
-... urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
- , .
- , ,
- , \cmdname{kpsewhich}
- .
-
-\subsubsection{}
-\label{sec:debugging}
-
- , .
-\KPS{} :
-
-\begin{ttdescription}
-\item[\texttt{\ 1}] .
- \file{ls-R} .
-\item[\texttt{\ 2}] (, \file{ls-R},
- ..).
-\item[\texttt{\ 4}] .
-\item[\texttt{\ 8}] ,
- \KPS. , ,
- .
-\item[\texttt{16}] (
- ).
-\item[\texttt{32}] .
-\item[\texttt{64}] .
-\end{ttdescription}
- \texttt{-1} ;
- .
-
-, \cmdname{dvips}
- , , .
-, , , ,
- , ޣ .
-
- ,
-\KPS{},
- \envname{KPATHSEA\_DEBUG}, ţ
- .
-
-( Windows:
- .
- \texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log}).
-
-
- \LaTeX{},
-\file{hello-world.tex}, :
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
- \file{cmr10},
- , \cmdname{dvips} \PS{}
-( Type~1,
-\texttt{-Pcms}).
-\begin{alltt}
-> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
- 4 \cmdname{dvips}
-( ) \KPS (.
- \cmdname{dvips},
-\OnCD{texmf/doc/html/dvips/dvips_toc.html}). (
-) ~\ref{fig:dvipsdbga}.
-\begin{figure*}[tp]
-\centering
-\input{examples/ex6a.tex}
-\caption{ }\label{fig:dvipsdbga}
-
-\bigskip
-
-\input{examples/ex6b.tex}
-\caption{ }\label{fig:dvipsdbgb}
-
-\bigskip
-
-\input{examples/ex6c.tex}
-\caption{ }\label{fig:dvipsdbgc}
-\end{figure*}
-
- \cmdname{dvips} .
- \file{texmf.cnf},
- , \file{ls-R} (
- ) \file{aliases},
- ͣ (, 8.3 )
- . \cmdname{dvips}
-\file{config.ps}
-\file{.dvipsrc} ( \emph{ }). ,
-\cmdname{dvips} Computer
-Modern \PS{} \file{config.cms} ( \texttt{-Pcms}
- ). ,
- \TeX{}, \PS{}
- :
-\begin{alltt}
-> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
- p +ams.map
- p +cms.map
- p +cmbkm.map
- p +amsbkm.map
-\end{alltt}
-\cmdname{dvips}
-\file{psfonts.map}, (
- \PS{}; .
-~\ref{sec:examples-of-use}).
-
- \cmdname{dvips} :
-\begin{alltt}
-This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com)
-\end{alltt}
-\ifSingleColumn
- \file{texc.pro}:
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
- \file{texc.pro} (.
-~\ref{fig:dvipsdbgb}).
-\fi
-
- , \cmdname{dvips} ,
-, \file{hello-world.ps},
- \file{cmr10}, <<>>
-( ):
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
- \file{cmr10.tfm}, , ݣ
- ( ), Type~1
-\file{cmr10.pfb} ޣ (,
-):
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-\subsection{ }
-
-ݣ \Webc{} "---
-( ) ,
-\file{texmf.cnf} \KPS{}.
-~3 \TL{}. :
-
-\begin{ttdescription}
-\item[\texttt{main\_memory}]
- \TeX{}, \MF{} \MP.
- . , <<>>
- \TeX{},
- \texttt{hugetex.fmt}. \KPS{},
- \texttt{main\_memory} \file{texmf.cnf}.
-\item[\texttt{extra\_mem\_bot}] <<>>
- , \TeX{}: , ..
- \PiCTeX{}.
-\item[\texttt{font\_mem\_size}]
- \TeX{}. TFM,
- \TeX.
-\item[\texttt{hash\_extra}]
- ͣ . 10\,000
- .
- ң , .
- \texttt{hash\_extra} \texttt{50000}.
-\end{ttdescription}
-
-,
- ,
- \TeX{},
-
-.
-
-
-\begin{comment}
-\section{ Unix}
-
-
- , ,
-ģ . . ӣ,
-, \texttt{source}.
-
-\subsection{ }
-
- 100\,Mb \TeX{}
- . \acro{ANSI} C,
-\cmdname{make}, .
- \acro{GNU}
-(\cmdname{gcc}, \acro{GNU} \cmdname{make}, \cmdname{m4}, \cmdname{flex},
-\cmdname{bison}).
- \cmdname{make}, ,
- .
-
- , \texttt{uname} .
-
-
-\subsection{}
-
- \TL{} (.
-~\ref{sec:unix-install-disk}
-\p.~\pageref{sec:unix-install-disk}).
- .
-
- \dirname{source}
- , .
-
- \cmdname{configure}, , :
-\begin{alltt}
-> \Ucom{sh configure -prefix=/usr/local/TeX}
-\end{alltt}
-
- \optname{-prefix} "--- ,
- .
-(\$TEXDIR ):
-
-\noindent
-\begin{tabular}{>{\ttfamily}ll@{}}
- \dirname{$TEXDIR/share/texmf} & ,\\
- & \qquad ..\\
- \dirname{$TEXDIR/man} & Unix man\\
- \dirname{$TEXDIR/info} & \acro{GNU} Info \\
- \dirname{$TEXDIR/bin/$PLATFORM} & \\
-\end{tabular}
-%$
-
- \dirname{$PLATFORM},
-.. \dirname{$TEXDIR/bin},
- \verb|--disable-multiplatform|.
-
- \verb|./configure --help|
-. , \OMEGA{}
-\eTeX{}.
-
-
-\subsection{ \cmdname{make}}
-
-, \texttt{noclobber}
-. \cmdname{make}:
-\begin{alltt}
-> \Ucom{make world}
-\end{alltt}
- \ldots
-
- , :
-\begin{alltt}
-> \Ucom{sh -c "make world >world.log 2>\&1" \&}
-\end{alltt}
-
- , , ӣ ,
-; \acro{GNU} \cmdname{make} \samp{***}
- . , ,
-:
-\begin{alltt}
-> \Ucom{cd \emph{TEXDIR}/bin/\emph{archname}}
-> \Ucom{ls | wc}
-\end{alltt}
- 200 ( ,
-
-\dirname{bin} ).
-
- \texttt{make install},
- \samp{make world} ɣ:
-\begin{alltt}
-> \Ucom{make all}
-> \Ucom{su}
-> \Ucom{make install strip}
-\end{alltt}
-
- ,
-, ~\ref{sec:postinstall},
-\p.~\pageref{sec:postinstall}.
-
- , ,
- , .
-\TL{} .
-
-\end{comment}
-
-\section{}
-
-\TL{} "--- Σ
- \TeX . \TL{}
-. , , .
- :
-
-\begin{itemize*}
-
-\item , ,
- \TeX{} (\acro{TUG}, \acro{DANTE} e.V., \acro{NTG}
- \acro{GUST})
- . , \TeX
- (. \url{http://tug.org/usergroups.html}).
-
-\item \acro{CTAN}, ,
- \TL{}
- ,
- \TL.
-
-\item \eTeX
- \TeX ,
- GNU autoools \TL{}.
-
-
-\item , \teTeX{} \TL{}
- , \TL.
-
-\item , .
-
-
-\item , \TeX4ht{}
- \HTML{}, ,
- .
-
-\item , ң pdf\TeX a
- (\url{http://pdftex.org}) \TeX
- .
-
-
-\item
- \ConTeXt\ (\url{http://pragma-ade.com}) .
-
-\item pdf\TeX\, Lua\TeX{}
- .
-
-
-\item \MP{} (Lua)\TeX
- (\url{http://luatex.org}) \ConTeXt \TL.
-
-\item Windows \cmdname{tlpm},
- \cmdname{tlpmgui},
- \TL{}.
-
-\item
- Windows \acro{W32TEX}
- (\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/})
- .
-
-\item \acro{SIL}
- Xe\TeX{}, ţ \TL{}
- Mac\TeX.
-
-\item Mac\TeX (\url{http://tug.org/mactex})
- \TL{}, .
-
-\item
- \TL{} 2008, Windows,
- \texttt{getnonfreefonts} .
-
-
-\item , \TL{}
- 2008 , Windows,
- .
-
-\item
- .
-
-\item \cmdname{dviout} Windows.
-
-
-\item - ,
- \cmdname{tldoc}.
-
-\item , Windows \TL{}
- .
-
-\item ,
- \TL{} 2008,
- \TL{} (
- ), .
-
-
-\item , \TL{}
- .
-
-
-\item
- , \cmdname{xindy},
- .
-
-\item a , \TL{}
- : ,
- Windows .
-
-\item \Webc.
-
-\item \MacOSX,
- .
-
-\item , \TeX\ Catalogue.
-
-\end{itemize*}
-
- :
- (\pkgname{x86\_64-linux}),
- (\pkgname{hppa-hpux}),
- (\pkgname{amd64-freebsd}),
- (\pkgname{i386-openbsd}),
- (\pkgname{i386-linux}),
- (\pkgname{win32}),
- (\pkgname{universal-darwin}),
- (\pkgname{i386-freebsd}),
- (\pkgname{alpha-linux}),
- (\pkgname{sparc-linux}),
- (\pkgname{powerpc-linux}),
- (\pkgname{i386-solaris}),
- (\pkgname{powerpc-aix}, \pkgname{sparc-solaris}),
- (\pkgname{mips-irix}).
- \TL{}
-\url{http://tug.org/texlive/build.html}.
-
-
- : (),
- (),
- (),
- ( ),
- (),
- ().
- \TL{}: \url{http://tug.org/texlive/doc.html}.
-
-, "--- , -,
- \TeX , -, , .
-
-\section{ }
-\label{sec:history}
-
-\subsection{}
-
- 1993 \TeX{}
- 4All\TeX{} \CD{}
-\acro{MS-DOS} .
- \CD{} .
-, \CD{}
-4All\TeX{},
-\acro{TUG} \TeX{}
-(\url{http://tug.org/tds}),
- \TeX{} ,
- \TeX . \TDS{}
- \textsl{TUGboat} 1995 ,
- , \CD{}. ,
- , "--- .
- 4All\TeX{} ,
-ģ ,
-\TL.
-
- \CD{} \TDS{}
-1995 , , \teTeX{}
- .
-, 1996 أ
-. 1996 . 1997
- Web2C,
- ,
-\teTeX, \Webc,
- \texttt{texconfig} \teTeX{}.
-\CD{} \Webc{} 7.2, ;
- \teTeX{}, \TL{}
- . ,
- \teTeX{} \Webc{} (7.3). Σ
- Windows.
-
- ( 2000 ) \CD{}
- .
-XML. \TeX\ Live 5
- . ӣ \TL{}
-
-(\url{http://www.debian.org/intro/free}); ӣ, ,
- ,
- .
-
- ( 2001 ) .
- :
- . ,
- ,
-.., \texttt{language.dat}.
-
- 2002 \MacOSX{},
- .
- \teTeX{}, ,
-~5 ~6.
-
-\subsubsection{2003}
-
- 2003 , ,
-\TL{} , \CD.
- . :
-
-\begin{itemize*}
-\item \LaTeX{},
- \cmdname{latex} \cmdname{pdflatex}: \eTeX{}
- (. .~\pageref{text:etex}).
-\item Latin Modern .
-\item Alpha \acro{OSF}
- ( \acro{HPUX} ),
- ( )
- .
-\item Windows:
- XEmacs.
-\item Windows
- (Perl, Ghost\-script, Image\-Magick, Ispell).
-\item Fontmap \cmdname{dvips}, \cmdname{dvipdfm}
- \cmdname{pdftex}
- \cmdname{updmap} \dirname{texmf/fonts/map}.
-\item \TeX{}, \MF{}, and \MP{}
- ASCII ,
- \verb|\write|, ,
- .. \emph{} \verb|^^|. \TL{}~7
- , .
- \verb|^^|,
- \verb|texmf/web2c/cp8bit.tcx|.
- .
-\item .
-\item , - , ,
- : \TL{} 2003.
-\end{itemize*}
-
-\subsubsection{2004}
-
- 2004 .
-
-\begin{itemize}
-
-\item
- \filename{.map} \filename{.enc},
- .
-
- \filename{.map}
- \dirname{fonts/map} ( \filename{texmf})
- \envname{TEXFONTMAPS}. \filename{.enc}
- \dirname{fonts/enc}
- \envname{ENCFONTS}. \cmdname{updmap} ,
- , .
-
- .
- \url{http://tug.org/texlive/mapenc.html}.
-
-\item \TK{} \CD{}
- \MIKTEX{} , \MIKTEX{}
- , \Webc. . ~\ref{sec:overview-tl}
- (\p.\pageref{sec:overview-tl}).
-
-
-\item \dirname{texmf} \TL{} :
- \dirname{texmf}, \dirname{texmf-dist} \dirname{texmf-doc}.
- . ~\ref{sec:tld} (\p.\pageref{sec:tld})
- \filename{README} .
-
-\item , \TeX,
- \dirname{tex} \dirname{texmf*}
- \dirname{tex}, \dirname{etex}, \dirname{pdftex}, \dirname{pdfetex}
- .. . \CDref{texmf-doc/doc/english/tds/tds.html\#Extensions}
- {\texttt{texmf-doc/doc/english/tds/tds.html\#Extensions}}.
-
-
-\item ( ,
- )
- \dirname{scripts} \dirname{texmf*}
- \verb|kpsewhich -format=texmfscripts|.
- , , . .
- \CDref{texmf-doc/doc/english/tds/tds.html\#Scripts}
- {\texttt{texmf-doc/doc/english/tds/tds.html\#Scripts}}.
-
-
-\item
- , << >> \filename{cp227.tcx}
- \verb|^^|. , 32--256
- ,
- . plain \TeX{} (
- 32--127), \ConTeXt{} (0--255) ,
- \OMEGA. ,
- \TL\,2003, , \'
- . . \CDref{texmf/doc/web2c/web2c.html\#TCX-files}
- {\texttt{texmf/doc/web2c/web2c.html\#TCX-files}}. (,
- Unicode, \TeX\
- , \TeX\ ).
-
-
-\item \textsf{pdfetex} ,
- plain \textsf{tex}. (,
- \acro{DVI}, \textsf{latex} ..). ,
- , \textsf{pdftex}a
- \eTeX \LaTeX, \ConTeXt{}
- .. (\OnCD{texmf-dist/doc/etex/base/}).
-
- , \emph{ }
- \pkgname{ifpdf} ( plain, \LaTeX)
- , , ̣ \cs{pdfoutput}
- , ,
- . ӣ
- , \cs{pdfoutput}
- ̣ \acro{DVI}.
-
-
-\item pdf\TeX\ (\url{http://pdftex.org})
- :
-
- \begin{itemize*}
-
- \item
- \cs{pdfmapfile} \cs{pdfmapline}.
-
- \item
-
- .\\
- \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}
-
-
- \item ,
- \filename{pdftex.cfg},
- , ,
- \filename{pdftexconfig.tex}. \filename{pdftex.cfg}
- . \filename{pdftexconfig.tex}
- \filename{.fmt} .
-
- \item
- pdf\TeX: \OnCD{texmf/doc/pdftex/manual}.
-
- \end{itemize*}
-
-
-\item \cs{input} \cmdname{tex} ( \cmdname{mf}
- \cmdname{mpost})
- . :
-\begin{verbatim}
-\input "filename with spaces" % plain
-\input{"filename with spaces"} % latex
-\end{verbatim}
-. \Webc: \OnCD{texmf/doc/web2c}.
-
-
-\item enc\TeX \Webc,
- \TeX, \optname{-enc}
- ( ). enc\TeX{}
- ,
- Unicode ( \acro{UTF}-8).
- . \OnCD{texmf-dist/doc/generic/enctex/}
- \url{http://www.olsak.net/enctex.html}.
-
-\item Aleph,
- \eTeX\ \OMEGA.
- \OnCD{texmf-dist/doc/aleph/base}
- \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}.
- \LaTeX \textsf{lamed}.
-
-\item \LaTeX
- \acro{LPPL} "--- Debian.
- \filename{ltnews}
- \OnCD{texmf-dist/doc/latex/base}.
-
-\item \cmdname{dvipng},
- \acro{DVI} \acro{PNG}.
- . \OnCD{texmf/doc/man/man1/dvipng.1}.
-
-\item \pkgname{cbgreek}
- , ( ).
- , ,
- , .
- \acro{CTAN}
- (\url{http://www.ctan.org/tex-archive/fonts/greek/cb}).
-
-
-\item \cmdname{oxdvi} ;
- \cmdname{xdvi}.
-
-
-\item \cmdname{ini} \cmdname{vir} \cmdname{tex},
- \cmdname{mf} \cmdname{mpost} (, \cmdname{initex})
- . \optname{-ini}
- .
-
-\item \textsf{i386-openbsd}.
- BSD \pkgname{tetex},
- \acro{GNU/}Linux Free\acro{BSD}, ,
- \'
- -.
-
-
-\item \textsf{sparc-solaris}
- \envname{LD\_LIBRARY\_PATH}
- \pkgname{t1utils}. ,
- C++, C++
- ( 2004 ,
- ). , \textsf{mips-irix}
- \acro{MIPS}pro~7.4.
-
-\end{itemize}
-
-\subsubsection{2005}
-
- 2005 , ,
-. 2004
-, .
-
-\begin{itemize}
-
-\item \cmdname{texconfig-sys},
- \cmdname{updmap-sys} \cmdname{fmtutil-sys},
- .
- \cmdname{texconfig}, \cmdname{updmap} \cmdname{fmtutil}
-
- \dirname{$HOME/.texlive2005}.
-
-\item \envname{TEXMFCONFIG}
- \envname{TEXMFSYSCONFIG} ,
- ( ).
- ,
- \filename{fmtutil.cnf} \filename{texmf.cnf}.
- \envname{TEXMFCONFIG}
- \envname{TEXMFSYSCONFIG} .
- . ~\ref{sec:texmftrees}, \p.\pageref{sec:texmftrees}.
-
-\item ̣ \verb|\pdfoutput|
- DVI,
- \cmdname{pdfetex}. ,
- , .
- \verb|\ifx\pdfoutput\undefined|,
- . \pkgname{ifpdf.sty}
- ( plain \TeX{} \LaTeX) .
-
-\item ,
- 8- . ӣ
- \verb|^^|, \filename{empty.tcx}:
-\begin{verbatim}
-latex --translate-file=empty.tcx yourfile.tex
-\end{verbatim}
-
-
-\item \cmdname{dvipdfmx} DVI
- PDF;
- \cmdname{dvipdfm}, ݣ ,
- .
-
-\item \cmdname{pdfopen}
- \cmdname{pdfclose}, PDF Adobe
- Acrobat Reader, (
- PDF, \cmdname{xpdf}, \cmdname{gv}
- \cmdname{gsview}, ).
-
-\item \envname{HOMETEXMF}
- \envname{VARTEXMF} \envname{TEXMFHOME} \envname{TEXMFSYSVAR}.
- \envname{TEXMFVAR},
- (. ).
-\end{itemize}
-
-\subsubsection{2006--2007}
-
- 2006--2007 Xe\TeX{},
- \texttt{xetex} \texttt{xelatex};
-. \url{http://scripts.sil.org/xetex}.
-
- \MP;
- (\url{http://tug.org/metapost/articles}).
-̣ pdf\TeX{} (\url{http://tug.org/applications/pdftex}).
-
- \filename{.fmt} ..
-\dirname{texmf/web2c}, ( ӣ ݣ
- , ,
-). , ,
-\filename{tex}, \filename{pdftex}, \filename{xetex}.
- .
-
- (plain) \texttt{tex} \texttt{\%\&}
- , :
-\TeX{} (\LaTeX{} ݣ \texttt{\%\&}).
-
-, , ,
-. , ̣ \acro{CTAN}
-(\url{http://www.ctan.org}).
-
- \TL{} Subversion,
-WWW- . ,
- .
-
-, 2006
-te\TeX (\url{http://tug.org/tetex}).
- \TL, \acro{GNU}/ (
- \texttt{tetex}, ,
- te\TeX ). , ģ
- \TeX .
-
-\medskip \noindent
- : \TL{}
- \CD{}
-\url{ftp://tug.org/historic/systems/texlive}.
-\url{ftp://tug.org/historic/systems/texlive}.
-
-\subsection{}
-\label{sec:tlcurrent}
-
-
- 2008
-\TL{}.
- \filename{tlpkg/texlive.tlpdb}.
-
- , \TL{} "---
-, MiK\TeX{}.
- , \CTAN.
-
- <<>> Lua\TeX\ (\url{http://luatex.org});
- ,
- \TeX , .
-
- Windows
- . ,
-Perl Lua Windows Perl,
- \TL{}.
-
- \cmdname{tlmgr} (. ~\ref{sec:tlmgr})
- \TL{}
-.
-, , .
-
- \cmdname{tlmgr},
-\cmdname{texconfig}
- .
-
- \cmdname{xindy} (\url{http://xindy.sourceforge.net/})
- .
-
- \cmdname{kpsewhich}
- ( \optname{--all})
- ( \optname{--subdir}).
-
- \cmdname{dvipdfmx}
-, \cmdname{extractbb};
- \cmdname{dvipdfm},
-\cmdname{dvipdfmx}.
-
- \filename{Times-Roman}, \filename{Helvetica} .. .
- (
-), .
-
- \pkgname{platex} -
-\pkgname{platex};
- \pkgname{polski}.
-
- \web\
- .
-
-, ,
-<< \TeX 2008 >>, .
-\url{http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf}.
-
-\subsection{}
-
-\emph{\TL{} !} ( .)
- , ,
-, () ,
- .
- , .
- ,
-. . \url{http://tug.org/texlive/contribute.html}.
-
-, , :\hfill\null
-\begin{quote}
-\email{tex-live@tug.org} \\
-\url{http://tug.org/texlive}
-\end{quote}
-
-\medskip
-\noindent \textsl{Happy \TeX ing!}
-
-\end{document}
-
-%%% Local Variables:
-%%% mode: latex
-%%% TeX-master: t
-%%% LaTeX-command-style: (("." "pdflatex"))
-%%% TeX-view-style: (("." "acroread %s.pdf"))
-%%% End:
diff --git a/Master/texmf-doc/source/texlive/texlive-zh-cn/Makefile b/Master/texmf-doc/source/texlive/texlive-zh-cn/Makefile
deleted file mode 100644
index 6541a022547..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-zh-cn/Makefile
+++ /dev/null
@@ -1,47 +0,0 @@
-# $Id:$
-# Makefile for TeX Live documentation. Public domain.
-TEX = xelatex
-doc = texlive-zh-cn
-source = $(doc).tex
-pdf = $(doc).pdf
-lang = chinese
-
-all: $(pdf)
-
-env = TEXINPUTS=../texlive-common:../texlive-zh-cn:; export TEXINPUTS;
-
-$(pdf): $(source)
- $(env) $(TEX) $<
- $(env) $(TEX) $<
-
-clean:
- rm -f *.aux *.log *.blg *.toc *.out *.lot tex4ht.ps *.4*
- rm -f *.xref* *.lg *.idv *.out *.otc *.tmp tmp.*
- rm -f $(doc).dvi $(doc).ps
-
-realclean: clean
- rm -f $(doc).pdf
- rm -f *.html *.htm $(doc).css *.gif *.jpg
-
-
-insttop = ../../../doc
-instfiles = $(doc)*html $(doc).css $(doc).pdf
-copyfiles = *.png
-install:
-# lang=`dirname \`pwd\` | sed 's,.*/,,'`;
- lang=$(lang); \
- tldir=`pwd | sed 's,.*/,,'`; \
- instdir=$(insttop)/$$lang/$$tldir; \
- echo tldoc install to $$instdir; \
- for f in $(instfiles); do \
- cmp -s $$f $$instdir/$$f && rm -v $$f && continue; \
- mv -v $$f $$instdir/$$f; \
- done; \
- lang=$(lang); \
- tldir=`pwd | sed 's,.*/,,'`; \
- instdir=$(insttop)/$$lang/$$tldir; \
- for f in $(copyfiles); do \
- cmp -s $$f $$instdir/$$f && continue; \
- cp -v $$f $$instdir/$$f; \
- done; echo "$$instdir"
-
diff --git a/Master/texmf-doc/source/texlive/texlive-zh-cn/README-live.ZH-CN b/Master/texmf-doc/source/texlive/texlive-zh-cn/README-live.ZH-CN
deleted file mode 100644
index a308e7daaa1..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-zh-cn/README-live.ZH-CN
+++ /dev/null
@@ -1,34 +0,0 @@
-TeX Live Guide Translation (Simplified Chinese)
-===============================================
-
-To compile live.tex, you need:
-
-1. Xe(La)TeX (and related packages like fontspec)
-0.997+ (a recent version is bundled with TeX Live).
-
-2. xeCJK macro package.
-
-3. At least one CJK font (with Simpified Chinese
-glyphs), preferably two, one for normal text,
-another for emphasized text. To change the font,
-open tex-live.sty (line 23 - 25):
-
- \setCJKmainfont[BoldFont=Adobe Heiti Std]{Adobe Song Std}
- \setCJKmonofont[Scale=0.9]{Adobe Kaiti Std}
- \setCJKfamilyfont{song}[BoldFont=Adobe Heiti Std]{Adobe Song Std}
-
-Replace "Adobe Heiti Std" and "Adobe Song Std" to
-some OpenType/TrueType fonts you already installed.
-
-4. Type make or simply
-
- xelatex texlive-zh-cn.tex
-
-for several times to make sure cross-references are
-correctly generated.
-
-5. If you have any problems, please contact:
- gzjjgod at gmail dot com
-
-jjgod, 2007/01/03.
-
diff --git a/Master/texmf-doc/source/texlive/texlive-zh-cn/tex-live.sty b/Master/texmf-doc/source/texlive/texlive-zh-cn/tex-live.sty
deleted file mode 100644
index 2289ab97ace..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-zh-cn/tex-live.sty
+++ /dev/null
@@ -1,464 +0,0 @@
-% $Id: tex-live.sty 9758 2008-07-25 00:47:03Z karl $
-% TeX Live documentation style. Written by many people over many years.
-% Public domain.
-%
-\NeedsTeXFormat{LaTeX2e}[1995/12/01]
-\ProvidesPackage{tex-live}[2005/09/24 v1.5 TeX Live documentation style]
-%
-\RequirePackage{alltt}
-\RequirePackage{array}
-\RequirePackage{colortbl}
-\RequirePackage{comment}
-\RequirePackage{float}
-\RequirePackage{graphicx}
-\RequirePackage{longtable}
-\RequirePackage{shortvrb}
-\RequirePackage[normalem]{ulem}
-\RequirePackage[obeyspaces]{url}
-\RequirePackage{xspace}
-
-% Chinese support (with XeTeX 0.997+)
-\RequirePackage{xeCJK}
-\def\Status{1}
-\parindent=20pt
-\defaultfontfeatures{Mapping=tex-text}
-\setCJKmainfont[BoldFont=Adobe Heiti Std]{Adobe Song Std}
-\setCJKmonofont[Scale=0.9]{Adobe Kaiti Std}
-\setCJKfamilyfont{song}[BoldFont=Adobe Heiti Std]{Adobe Song Std}
-
-\renewcommand\contentsname{目录}
-\renewcommand\listfigurename{插图列表}
-\renewcommand\listtablename{表格列表}
-\renewcommand\refname{参考文献}
-\renewcommand\indexname{索引}
-\renewcommand\figurename{图}
-\renewcommand\tablename{表}
-\renewcommand\partname{部分}
-\renewcommand\appendixname{附录}
-\renewcommand\abstractname{摘要}
-\setlength{\parskip}{5pt}
-
-%
-%\RequirePackage{lmodern}
-%\usepackage{textcomp}% including \textbullet
-\def\p.{p.\,}
-
-% for a proper \acro command.
-\RequirePackage{relsize}
-%\DeclareRobustCommand{\acro}[1]{\textscale{.9}{#1}\@}
-\def\acro#1{\textscale{.9}{#1}\@}
-%
-\RequirePackage{fancyvrb}
-\DefineVerbatimEnvironment{verbatim}{Verbatim}{fontsize=\normalsize}
-\DefineVerbatimEnvironment{fverbatim}{Verbatim}{fontsize=\footnotesize}
-\DefineVerbatimEnvironment{sverbatim}{Verbatim}{fontsize=\small}
-\DefineVerbatimEnvironment{boxedverbatim}
- {Verbatim}{fontsize=\scriptsize,frame=single}
-\DefineVerbatimEnvironment{Verbatim}{Verbatim}{fontsize=\normalsize}
-\def\verbatiminput#1{\VerbatimInput[fontsize=\scriptsize]{#1}}
-\def\boxedverbatiminput#1{\VerbatimInput[frame=single,fontsize=\scriptsize]{#1}}
-\def\listinginput#1#2{\VerbatimInput[fontsize=\scriptsize,firstnumber=#1,numbers=left]{#2}}
-\MakeShortVerb\|
-%
-%
-% Done with packages.
-%
-% Page layout.
-\advance\textwidth by 1.1in
-\advance\oddsidemargin by -.55in
-\advance\evensidemargin by -.55in
-%
-\advance\textheight by 1in
-\advance\topmargin by -.5in
-\advance\footskip by -.5in
-\pagestyle{headings}
-%
-% LaTeX parameters.
-\renewcommand{\topfraction}{0.85}
-\renewcommand{\floatpagefraction}{0.86}
-\renewcommand{\textfraction}{0.1}
-\renewcommand{\abovecaptionskip}{4pt}
-\renewcommand{\belowcaptionskip}{4pt}
-\setcounter{tocdepth}{3}
-\setcounter{secnumdepth}{3}
-\setcounter{topnumber}{5}
-\setcounter{totalnumber}{5}
-%
-% linebreaking, etc.
-\hbadness=4000
-\vbadness=4000
-\emergencystretch=.1\hsize
-\relpenalty=500
-%
-\def\slash{/\penalty\z@\hskip\z@skip }
-%
-% various sorts of names
-\newcommand*{\pkgname}[1]{\textsf{#1}}% package name
-\newcommand*{\optname}[1]{\texttt{#1}}% (package,class) option name
-\newcommand*{\cmdname}[1]{\textsf{#1}}% command name
-\newcommand*{\colname}[1]{\emph{#1}}% collection name
-\newcommand*{\dirname}[1]{\path{#1}}% directory name
-\newcommand*{\filename}[1]{\path{#1}}% file name
-\newcommand*{\envname}[1]{\texttt{#1}}% environment variable name
-\newcommand{\code}[1]{\texttt{#1}}
-\newcommand{\file}[1]{\texttt{#1}}
-\newcommand{\prog}[1]{\textsf{#1}}% same as \cmdname
-\newcommand{\samp}[1]{`\texttt{#1}'}
-\newcommand{\var}[1]{{\sl #1}}% not \textsl, for roman not typewriter slanted.
-\newcommand{\ttvar}[1]{\texttt{\var{#1}}}
-%
-% underlined command input.
-%\def\Ucom#1{%
-% \uline{\rule[-.2\baselineskip]{0pt}{.9\baselineskip}\ttfamily #1}}
-% bold command input
-\def\Ucom#1{{\bfseries\ttfamily #1}}
-%
-% \CDref is for url's with a #, where we need to write the target url and
-% displayed url separately in the input, due to catcode madness.
-% (We could simplify/remove this next time, I think.)
-% \def\CDref#1#2{\texttt{#1}}
-%
-% \OnCD is currently for any other reference to a file or directory in
-% the distribution. PDF readers only open .pdf files, though, so we
-% should change this to only use \href for those. Or more likely use
-% different macros in the source.
-% \def\OnCD#1{\href{../../../../#1}{\path{#1}}}
-%
-% \href incorrectly appends .pdf to anything without an extension; these
-% definitions using \hyper@linkurl do not, but they fail for .pdf
-% references -- which are the only ones that work anyway. So this is
-% useless, in practice.
-\def\CDref#1#2{\hyper@linkurl{#2}{../../../../#1}}
-\def\OnCD#1{\hyper@linkurl{\path{#1}}{../../../../#1}}
-
-% GUI menu/button/tab sequence:
-\def\guiseq#1{\textsf{#1}}
-\def\arw{\unskip$\rightarrow$\ignorespaces}
-%
-% Special names.
-\def\dpi{$\,$dpi\xspace}
-\def\bs{{\protect\normalfont\ttfamily\char'134}}
-\DeclareRobustCommand{\cs}[1]{{\normalfont\ttfamily\char`\\#1}}
-\def\Q#1{\par\vskip6pt\leftline{#1}\par}
-\def\hyph{-}
-%
-% many abbreviations.
-\newcommand{\CS}{$\mathcal{C}\kern-.1667em\lower.5ex%
- \hbox{$\mathcal{S}$}\kern-.075em $}
-\def\AFMtoTFM{\cmdname{AFM2TFM}\null}
-\def\bv{\emph{Baskerville}}
-\let\BV=\bv
-\def\Dash{\unskip\nobreak\thinspace---\thinspace\ignorespaces}
-\def\dvicopy{\cmdname{dvicopy}}
-\def\dvidvi{\cmdname{dvidvi}}
-\def\dvips{\cmdname{dvips}}
-\def\eTeX{$\varepsilon$-\TeX}
-\def\fpTeX{\textrm{fp}\TeX\xspace}
-\def\GFtoDVI{\cmdname{GFtoDVI}\null}
-\def\GFtoPK{\cmdname{GFtoPK}\null}
-\def\GFtype{\cmdname{GFtype}}
-\def\GUI{\acro{GUI}\xspace}
-\def\KPS{Kpathsea}
-\def\La{La}
-\def\OMEGA{$\Omega$}
-\def\OzMF{OzMF}
-\def\OzMP{OzMP}
-\def\OzTeX{O\kern-.03em z\kern-.15em\TeX}
-\def\PKtype{\cmdname{PKtype}}
-\def\PLtoTF{\cmdname{PLtoTF}\null}
-\def\ProTeXt{Pro\TeX t}
-\def\teTeX{\textrm{te}\TeX\xspace}
-\def\TeXLive{\TeX{} Live\xspace}
-\def\TFtoPL{\cmdname{TFtoPL}\null}
-\def\TK{\TeX\ Collection}
-\let\TL=\TeXLive
-\def\TypeI{Type~1}
-\def\VFtoVP{\cmdname{VFtoVP}\null}
-\def\VPtoVF{\cmdname{VPtoVF}\null}
-\def\Thanh{H\`an~Th\^e\llap{\raise 0.5ex\hbox{\'{}}}~Th\`anh}
-\def\XEmTeX{\textrm{XEm}\TeX\xspace}
-\def\XEmacs{\textrm{XEmacs}\xspace}
-\def\XeTeX{Xe\TeX\xspace}
-\def\Webc{Web2C}
-\providecommand*{\CD}{\acro{CD}\xspace}
-\providecommand*{\CTAN}{\acro{CTAN}\xspace}
-\providecommand*{\DVD}{\acro{DVD}\xspace}
-\providecommand*{\GNU}{\acro{GNU}\xspace}
-\providecommand*{\ISO}{\acro{ISO}\xspace}
-\providecommand*{\HTML}{\acro{HTML}\xspace}
-\providecommand*{\MacOSX}{Mac\,\acro{OS\,X}\xspace}
-\providecommand*{\PS}{Post\-Script\xspace}
-\providecommand*{\TDS}{\acro{TDS}\xspace}
-\providecommand*{\dvi}{\acro{DVI}\xspace}
-\providecommand*{\web}{\texttt{WEB}\xspace}
-
-% Include an image.
-% #1 - name of image (pictures/#1.jpg, always .jpg please)
-% #2 - bb for html
-% #3 - width for TeX
-%
-\def\tlimage#1#2#3{%
- \ifnum \Status=2 % html, want relative path in output
- \includegraphics[#2]{../../general/texlive-common/pictures/#1.jpg}
- \else % not html, handled by TEXINPUTS in Makefile
- \includegraphics[width=#3]{pictures/#1.jpg}
- \fi
- \\[5mm]
-}
-
-\def\tlpng#1#2{%
- \ifnum \Status=2 % html, want relative path in output
- \includegraphics[bb=0 0 1 1]{#1.png}%
- \else % not html, handled by TEXINPUTS in Makefile
- \includegraphics[width=#2]{#1.png}%
- \fi
-}
-%
-% description-like environment that uses tt instead of bf, and doesn't
-% go to the left margin. Without the \hfil, get an underfull box.
-% Don't know why \descriptionlabel doesn't.
-%
-\newenvironment{ttdescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt % these lists tend to have short descriptions
- \parindent=0pt
- \let\makelabel=\ttdescriptionlabel}}%
- {\end{list}}
-\newcommand*\ttdescriptionlabel[1]{\hspace\labelsep
- \normalfont\ttfamily #1\hfil}
-%
-% Likewise, for commands using sans serif.
-\newenvironment{cmddescription}
- {\begin{list}{label must be supplied}{%
- \itemsep=0pt
- \let\makelabel=\cmddescriptionlabel}}%
- {\end{list}}
-\newcommand*\cmddescriptionlabel[1]{\hspace\labelsep
- \normalfont\sffamily #1\hfil}
-
-% General squeezed itemize.
-\newenvironment{itemize*}%
- {\begin{itemize}%
- \setlength{\itemsep}{0pt}%
- \setlength{\parskip}{0pt}}%
- {\end{itemize}}
-
-\newsavebox{\wbox}
-\newenvironment{warningbox}
- {\begin{lrbox}{\wbox}
- \begin{minipage}{.95\textwidth}}
- {\end{minipage}\end{lrbox}\fbox{\usebox{\wbox}}}
-%
-% lrbox is used as a representation marking. I changed it to
-% lrBox in tne source file, to get closer to logical marking
-\newsavebox{\mylrbox}
-\newenvironment{lrBox}
- {\begin{lrbox}{\mylrbox}}
- {\end{lrbox}}
-
-
-% emacs-page output setup
-%
-\ifx \HCode\UnDef
- \providecommand{\Status}{0}% running TeX
-\else
- \providecommand{\Status}{2}% running TeX4ht
-\fi
-%\typeout{Status is \Status}
-%
-\newif\ifSingleColumn
-%
-% By default, we won't be creating hyperlinks.
-\def\href#1#2{#2}
-\def\hypertarget#1#2{}
-\def\email#1{\href{mailto:#1}{\path{#1}}} % \path comes from url
-%
-\definecolor{hypercolor}{rgb}{0.5,0.0,0.5} % purplish external links.
-%
-%
-\ifcase\Status
- % \Status = 0
- \typeout{TeX Live documentation in DVI format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 1
- \typeout{TeX Live documentation in PDF format}
- \RequirePackage[breaklinks,
- colorlinks,linkcolor=hypercolor,citecolor=hypercolor,
- urlcolor=hypercolor,filecolor=hypercolor,
- bookmarksopen,
- %pdfstartview={FitBH -320000}, % fails with acrobat7
- hyperindex]
- {hyperref}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- \or
- % \Status = 2
- \typeout{TeX Live documentation in HTML format}
- \SingleColumntrue
- \newenvironment{multicols}[1]{}{}
- % read our config file, live4ht.cfg; q.v., for more definitions.
- % hyperref load must come after the tex4ht load.
- \RequirePackage[live4ht]{tex4ht}
- \RequirePackage[tex4ht]{hyperref} \hyperlinkfileprefix{}
- % definitions need simplifying for TeX4ht to make relative paths work.
- \def\CDref#1#2{\href{../../../../#1}{#2}}
- \def\OnCD#1{\href{../../../../#1}{#1}}
- \or
- % \Status = 3
- \typeout{TeX Live documentation as a Baskerville issue}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \RequirePackage{bvoutln}% outline of baskerville
- \SingleColumnfalse
- \RequirePackage{multicol}
- \or
- % \Status = 4
- \typeout{TeX Live documentation as a TUB article}
- \@ifundefined{Fonts}%
- {\RequirePackage{ae}}%
- {\RequirePackage[T1]{\Fonts}}
- \SingleColumnfalse
- \newenvironment{multicols}[1]{}{}
-\fi
-%
-\ifnum \Status=4
-\else
- \RequirePackage{texnames}
- \providecommand\TeXXeT{\TeX-{}-%
- \kern-.1emX\kern-.125em\lower.5ex\hbox{E}\kern-.1667emT\@}
- \def\MP{MetaPost}
- \let\mf\MF
- \newcommand\ConTeXt{C\kern-.0333emon\-\kern-.0667em\TeX\kern-.0333emt}
- \newcommand\MIKTEX{MiK\kern-.025em \TeX}% per www.miktex.org
- % from pictex.tex:
- \ifx\PiC\undefined \def\PiC{P\kern-.12em\lower.5ex\hbox{I}\kern-.075emC} \fi
- \ifx\PiCTeX\undefined \def\PiCTeX{\PiC\kern-.11em\TeX} \fi
-\fi
-%
-% hacking at sections etc., to pay attention to baskerville status
-\newcommand{\@condend@multicols}{%
- \ifSingleColumn
- \else
- \def\@tempa{multicols}%
- \ifx\@tempa\@currenvir
- \end{multicols}%
- \fi
- \fi
-}
-\let\Section\section
-\renewcommand{\section}{%
- \@ifstar
- {\Section*}%
- {%
- \@condend@multicols
- \@dblarg\@full@section
- }%
-}
-\def\@full@section[#1]#2{%
- \Section[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-\let\SubSection\subsection
-\renewcommand{\subsection}{%
- \@ifstar{\SubSection*}%
- {%
- \@condend@multicols
- \@dblarg\@full@subsection
- }
-}
-\def\@full@subsection[#1]#2{%
- \SubSection[#1]{#2}%
- \ifSingleColumn\else\begin{multicols}{2}\fi
-}
-
-% calm things down a bit if we're in a multiple-column version
-\ifSingleColumn
-\else
- \def\@listI{\leftmargin\leftmargini
- \parsep \z@
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \itemsep \z@ \@plus .1\p@
- }
- \let\@listi\@listI
- \@listi
- \def\@listii{\leftmargin\leftmarginii
- \labelwidth\leftmarginii\advance\labelwidth-\labelsep
- \topsep 2\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \itemsep \z@ \@plus .1\p@
- }
- \def\@listiii{\leftmargin\leftmarginiii
- \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
- \topsep 1\p@ \@plus 1\p@ \@minus 1\p@
- \parsep \z@
- \partopsep \z@
- \itemsep \topsep
- }
- \def\@listiv{\leftmargin\leftmarginiv
- \labelwidth\leftmarginiv\advance\labelwidth-\labelsep
- }
- \def\@listv{\leftmargin\leftmarginv
- \labelwidth\leftmarginv\advance\labelwidth-\labelsep
- }
- \def\@listvi{\leftmargin\leftmarginvi
- \labelwidth\leftmarginvi\advance\labelwidth-\labelsep
- }
-\fi
-%
-% array package stuff
-\def\arraybackslash{\let\\=\@arraycr}
-\newcolumntype{P}[1]{>{\raggedright\arraybackslash}p{#1}}
-%
-% shaded rows (using facilities of colortbl)
-%
-\definecolor{pale}{gray}{.9}
-\newcount\colrow
-\gdef\RowColor{pale}
-\def\SetRowColor{%
- \rowcolor{\RowColor}%
- \global\advance\colrow by1\relax
- \ifodd\colrow
- \gdef\RowColor{pale}%
- \else
- \gdef\RowColor{white}%
- \fi
-}
-% redefine to hack up a reference even though we don't need it...
-\renewcommand\@bibitem[1]{\if@filesw \immediate\write\@auxout
- {\string\bibcite{#1}{?}}\fi\ignorespaces}
-%
-% \unknownTeXlive is a dummy texlive entry for the biblio
-\newcommand\unknownTeXlive[2][\relax]{\textbf{\textsc{unknown}}%
- \global\@all@unknown\expandafter{\the\@all@unknown{#2}}%
-}
-\newtoks\@all@unknown
-\global\@all@unknown{}
-\AtEndDocument{\@message@unknowns}
-\def\@message@unknowns{\edef\@tempa{\the\@all@unknown}%
- \ifx\@tempa\@empty
- \else
- \def\@tempa{*** TeX live package location of }%
- \expandafter\@output@unknowns\the\@all@unknown\@empty
- \fi
-}
-\def\@output@unknowns#1{\edef\@tempb{#1}%
- \ifx\@tempb\@empty
- \typeout{ unknown}%
- \else
- \message{\@tempa#1,}%
- \def\@tempa{}%
- \expandafter\@output@unknowns
- \fi
-}
-
-
-% Silence font warnings about no bold typewriter in LM.
-\def\@font@warning#1{}%
-
-% Silence hyperref warnings about \kern.
-\def\HyPsd@Warning#1{}%
-
-\endinput
diff --git a/Master/texmf-doc/source/texlive/texlive-zh-cn/texlive-zh-cn.tex b/Master/texmf-doc/source/texlive/texlive-zh-cn/texlive-zh-cn.tex
deleted file mode 100644
index c444dca64c2..00000000000
--- a/Master/texmf-doc/source/texlive/texlive-zh-cn/texlive-zh-cn.tex
+++ /dev/null
@@ -1,2576 +0,0 @@
-% $Id$
-% TeX Live documentation. Originally written by Sebastian Rahtz and
-% Michel Goossens, now maintained by Karl Berry and others.
-% Translated by Jjgod Jiang <gzjjgod@gmail.com>,
-% Jinsong Zhao <jinsong.zhao@gmail.com>,
-% Yue Wang <yulewang@gmail.com>
-% Helin Gai <helin.gai@gmail.com>
-% Public domain.
-%
-\documentclass{article}
-\let\tldocenglish=1 % for live4ht.cfg
-
-\usepackage{tex-live, indentfirst}
-
-\begin{document}
-
-\title{%
- {\huge \textit{\TeX\ Live 指南}\\\smallskip}%
- {\LARGE \textsf{\TL{} 2008}}
-}
-
-\author{Karl Berry 编写 \\[3mm]
- \url{http://tug.org/texlive/}
- }
-
-\date{2008 年 7 月}
-
-\maketitle
-
-\begin{multicols}{2}
-\tableofcontents
-%\listoftables
-\end{multicols}
-
-\section{简介}
-\label{sec:intro}
-
-\subsection{\TeX\ Live 与 \TeX\ Collection}
-
-本文档描述 \TL{} 软件的主要功能和特性,\TL{} 是 \TeX{} 及其相关程序在
-\acro{GNU}/Linux 及其他类 Unix 系统、\MacOSX\ 和 Windows
-系统下的一套发行版。
-
-你可以直接下载 \TL{},也可以在 \TeX{} 用户组织给会员分发的 \TK{}
-\DVD 中找到。第 \ref{sec:tl-coll-dists} 节中,简要地介绍了
-\DVD 的内容。这两套发行版都是用户组织共同协作完成的。
-这篇文档, 主要介绍 \TL{} 本身。
-
-\TL{} 包括了 \TeX{}, \LaTeXe{}, \ConTeXt, \MF, \MP, \BibTeX{}
-等许多可执行程序;种类繁多的宏包、字体和文档,并支持世界上许多
-不同的语言。
-
-\TL{} 中的安装包定期根据 \acro{CTAN}:\url{http://www.ctan.org}
-上的内容进行更新。
-
-文档末尾的第 \ref{sec:history} 节 (第 \pageref{sec:history} 页)
-介绍了这一版 \TL{} 的重要改变。
-
-\subsection{操作系统支持}
-\label{sec:os-support}
-
-\TL{} 为包括 \MacOSX 在内的多种基于 Unix 的操作系统提供了可执行
-文件。它还包含了源代码,可供在没有提供可执行文件的平台上编译安装。
-
-至于 Windows,\TL{} 仅支持 Windows 2000 或后续版本。
-不再支持 Windows 9\textit{x}, ME 和 NT。
-因为这一改变,Windows 支持相对于 Unix 支持系统而言不再需要很多的
-特殊对待。我们没有包含 64 位的 Windows 可执行文件,不过 32 位的可
-执行文件也能 64 位的系统上正常运行。
-
-除了 \TL{} 以外,Windows 和 \MacOSX 用户还有其它的选择,请参考第
-\ref{sec:tl-coll-dists} 节。
-
-\subsection{\protect\TL{} 的基本安装}
-\label{sec:basic}
-
-你可以使用 \DVD{} 方式或者网络方式来安装 \TL{}。
-通过网络的安装程序本身非常小,它可以从网上下载所有的你所要求的软
-件包。网络安装程序对仅使用 \TL{} 一小部分的用户来说非常适宜。
-
-\DVD{} 安装程序可以把 \TL{} 安装到你的本地磁盘上,也可以直接从
-\DVD{} 上运行 \TL{} (其实如果你的系统支持挂载 DVD 镜像,你也可以
-从 \DVD 镜像上运行)。
-
-\noindent 安装方法将在下面的章节介绍,这里提供一个快速入门:
-
-\begin{itemize*}
-
-\item 安装脚本的名称是 \filename{install-tl}。它可以在 \GUI{} 模式
-(Windows 下的默认模式) 和文本模式 (其它系统下默认模式) 下工作,你可
-以分别使用 \code{-gui} 或 \code{-no-gui} 命令行参数来强制以某一模式
-运行程序。
-
-\item 安装完成后可以得到一个名为 \prog{tlmgr} 的程序:`\TL\ Manager'。
-和安装程序一样,它可以在 \GUI{} 模式或文本模式下运行。你不但可以用它
-来安装或卸载软件包,还可以用来完成各种配置工作。
-
-\end{itemize*}
-
-
-\subsection{获得帮助}
-\label{sec:help}
-
-\TeX{} 社群是活跃而友好的,几乎所有认真的提问都能得到回答。尽管如此,这种由志愿者
-和业余读者组成的技术支持仍然显得不太正式,所以,在提问前最好做好功课。(如果你更喜欢
-有保障的商业性技术支持,可以放弃 \TL{},改为购买商业 \TeX{} 系统,在
-\url{http://tug.org/interest.html#vendors} 上有一份销售商的列表。)
-
-按照推荐使用的顺序,我们列出了这样一份资源列表:
-
-\begin{description}
-\item [起步] 如果你刚刚接触 \TeX,\url{http://tug.org/begin.html}
-这个网页提供了这个系统的简短介绍。
-
-\item [\TeX{} \acro{FAQ}] 这套庞大的 \TeX{} \acro{FAQ} 对各种各样的
-问题——从最基础到最晦涩的——都给予了简明的回答,它在 \TL{} 的
-\OnCD{texmf-doc/doc/english/FAQ-en/html/index.html},也可以在
-\url{http://www.tex.ac.uk/faq} 网站上找到。有问题时请先看看这里能否找
-到解答。
-
-\item [\TeX{} Catalogue] 如果你在寻找某个特定的宏包、字体、程序等等,\TeX{}
-Catalogue 就是你首先该找的地方。这里是所有 \TeX{} 相关内容的一个巨大集合。参见
-\url{http://www.ctan.org/help/Catalogue/}。
-
-\item [\TeX{} 网上资源] \url{http://tug.org/interest.html} 页面上有
-许多和 \TeX{} 相关的链接,包括讨论这个系统方方面面的许多书籍、手册和文章。
-
-\item [支持信息的归档] 最重要的两个技术支持论坛是 Usenet 的新闻组
-\url{news:comp.text.tex} 和邮件列表 \email{texhax@tug.org}。它们的内容
-归档中有多年以来的提问和回答供你搜索。你可以分别从
-\url{http://groups.google.com/groups?group=comp.text.tex} 和
-\url{http://tug.org/mail-archives/texhax} 进行查询。当然,一般性的搜索
-方式,比如用 \url{http://google.com} 找找,总没有坏处。
-
-\item [提问] 如果你还是找不到答案,就可以通过 Google 或者你的新闻组阅读器在
-\dirname{comp.text.tex} 上提问,或者发送邮件到 \email{texhax@tug.org}。
-不过,在提问之前\emph{请一定}先阅读 \acro{FAQ} 上的这一条:
-\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion},
-它能提高你获得回答的可能性。
-
-\item [\TL{} 技术支持] 如果你需要报告 bug,或者提出对 \TL{} 的发行、安装或
-文档的建议和意见,可以使用 \email{tex-live@tug.org} 这个邮件列表。不过,如果问题
-是针对 \TL{} 中包含的某个特定程序,那最好还是写信给这个程序的维护者或邮件列表。
-用 \code{-{}-help} 参数来运行程序都一般能得到用来报告其 bug 的地址。
-
-\end{description}
-
-另一方面,你也不妨帮助其他有问题的朋友,\dirname{comp.text.tex} 与
-\code{texhax} 都是对所有人开放的,请尽管参与进去,在你能力所及的范围内提供帮助。
-
-% don't use \TL so the \uppercase in the headline works. Also so
-% tex4ht ends up with the right TeX. Likewise the \protect's.
-\section{\protect\TeX\protect\ Live 概览}
-\label{sec:overview-tl}
-
-这个小节描述的是 \TL{} 的内容,以及包含 \TL{} 的 \TK{}。
-
-\subsection{\TL, pro\TeX{}t, Mac\TeX\ 的大集合:\TK}
-\label{sec:tl-coll-dists}
-
-\TK{} 的 \DVD{} 包含了以下内容:
-
-\begin{description}
-
-\item [\TL] 是一个完整的 \TeX{} 系统,它可以直接在光盘上运行,也可以安装在本
-地磁盘上。
-
-\item [Mac\TeX] 在 \TL{} 的基础上增加了原生的 \MacOSX\ 的安装程序和一些其它的
-Mac 应用程序。它的主页在 \url{http://www.tug.org/mactex/}。
-
-\item [pro\TeX{}t] 是 Windows 下的 \MIKTEX\ 发行版的一个增强版本。\ProTeXt\ 在
-\MIKTEX\ 基础上增加了一些工具,简化了安装。它完全独立于 \TL{},有其
-自己的安装步骤。\ProTeXt\ 的主页在 \url{http://tug.org/protext}。
-
-\item [CTAN] 一份 \CTAN{} 仓库的快照。
-
-\item[\texttt{texmf-extra}] 一个提供额外的配套软件包的目录。
-
-\end{description}
-
-\CTAN{}, \pkgname{protext} 和 \dirname{texmf-extra} 并不一定遵循 \TL{}
-的版权协议,因此在分发或修改时要格外地小心。
-
-\subsection{\TL{} 的顶层目录}
-\label{sec:tld}
-
-这里是 \TL{} 发行版顶层目录的一个简短的列表和描述。注意在 \pkgname{live}
-\DVD\ 中,整个 \TL{} 目录结构都存放于 \dirname{texlive} 子目录中,而非
-光盘的顶层目录下。
-
-\begin{ttdescription}
-\item[bin] \TeX{} 系统程序,按平台组织。
-%
-\item[readme.html] 网页,提供了多种语言的简介和有用的链接。
-%
-\item[source] 所有程序的源代码,包括主要的 \Webc{} \TeX{} 和 \MF{}
- 发行版。
-%
-\item[support] 各类辅助性宏包与程序。这些内容\emph{不会}自动安装。
-包括配套的编辑器和 \TeX\ 的前端 (外壳) 程序。
-%
-\item[texmf] 见下文的 \dirname{TEXMFMAIN}。
-%
-\item[texmf-dist] 见下文的 \dirname{TEXMFDIST}。
-%
-\item[texmf-doc] 这个目录树用于存放和具体程序、宏包关系不大的纯粹
-文档,按语言组织。
-%
-\item[tlpkg] 用来维护安装程序所用到的脚本,程序和数据。还内置了
-Windows 下 Perl 和 Ghostscript 的专有版本,它们不能在 \TL 外使用。
-还有一个新的 Windows PostScript 阅读器 PSView。
-\end{ttdescription}
-
-上述目录之外,安装脚本和 (多种语言的) \filename{README} 文件也存放在发行版的顶层目录下。
-
-\dirname{texmf-doc} 目录包含了那些不隶属于任何特定宏包或程序的文档。
-程序的文档 (手册,man page, Info 文件等) 在 \dirname{texmf/doc}
-目录下,因为这些程序本身是属于 \dirname{texmf} 目录的。\TeX\ 宏包与格式文件
-的文档则放在 \dirname{texmf-dist/doc} 目录。但不管放在哪个地方,你都可以使用
-\cmdname{texdoc} 或 \cmdname{texdoctk} 程序来寻找这些文档。顶层目录下的
-\OnCD{doc.html} 文件中提供的完整的链接也会有所帮助。
-
-\TL\ 本身的文档在 \dirname{texmf-doc} 目录下,有以下这些语言的版本:
-
-\begin{itemize*}
-\item{简体中文:} \OnCD{texmf-doc/doc/chinese/texlive-zh-cn}
-\item{捷克/斯洛伐克语:} \OnCD{texmf-doc/doc/czechslovak/texlive-cz}
-\item{英语:} \OnCD{texmf-doc/doc/english/texlive-en}
-\item{法语:} \OnCD{texmf-doc/doc/french/texlive-fr}
-\item{德语:} \OnCD{texmf-doc/doc/german/texlive-de}
-\item{波兰语:} \OnCD{texmf-doc/doc/polish/texlive-pl}
-\item{俄语:} \OnCD{texmf-doc/doc/russian/texlive-ru}
-\end{itemize*}
-
-
-\subsection{预定义的 texmf 目录树概览}
-\label{sec:texmftrees}
-
-本小节列出了系统中用于指定 texmf 目录的所有预定义变量及其用途,
-还有一个 \TL{} 系统的默认布局。\texttt{texconfig conf} 命令可
-以列出这些变量的值,这样你可以很容易找到它们和你所安装到的目录
-名称的对应关系。
-
-\begin{ttdescription}
-\item [TEXMFMAIN] 存储系统核心部件的目录树,包括辅助脚本 (比如
-\verb+web2c/mktexdir+) 和其他支持文件和文档。
-这个目录不包含 \TeX\ 格式文件和宏包。
-\item [TEXMFDIST] 存储主要的宏包、字体等等,即一开始就在发行版中包括的而非自己
-后续添加的那些文件。
-\item [TEXMFLOCAL] 系统管理员用来安装供整个系统使用的额外的或更新过的宏包、字体的目录。
-\item [TEXMFHOME] 给用户存放它们自己独立安装的的宏包、字体等等。
-这个变量根据不同的用户选择不同的主目录。
-\item [TEXMFCONFIG] 给 \verb+texconfig+、\verb+updmap+、和 \verb+fmtutil+
-这些程序存储修改过的配置文件。默认在 \envname{TEXMFHOME} 目录树下。
-\item [TEXMFSYSCONFIG] 给 \verb+texconfig-sys+、\verb+updmap-sys+ 和
-\verb+fmtutil-sys+ 这些程序存储修改过的文件.
-\item [TEXMFVAR] 这个目录是给 \verb+texconfig+、\verb+updmap+ 和
- \verb+fmtutil+ 存储 (缓存) 格式文件、生成 map 文件这类运行时数据的。默认在
- \envname{TEXMFHOME} 目录下。
-\item [TEXMFSYSVAR] 给 \verb+texconfig-sys+、\verb+updmap-sys+ 和
-\verb+fmtutil-sys+ 还有 \verb+tlmgr+ 这几个命令存储、缓存运行时使用的格式文件和
-生成的 map 文件。
-\end{ttdescription}
-
-\noindent
-默认的目录结构:
-\begin{description}
- \item[全系统根目录] 可以包含多个 \TL{} 版本:
- \begin{ttdescription}
- \item[2007] 上一个版本。
- \begin{ttdescription}
- \item [...]
- \end{ttdescription}
- \item[2008] 当前版本。
- \begin{ttdescription}
- \item [bin] ~
- \begin{ttdescription}
- \item [i386-linux] \GNU/Linux 二进制文件
- \item [...]
- \item [universal-darwin] \MacOSX 二进制文件
- \item [win32] Windows 二进制文件
- \end{ttdescription}
- \item [texmf] 这是 \envname{TEXMFMAIN}。
- \item [texmf-dist] \envname{TEXMFDIST}
- \item [texmf-doc] \envname{TEXMFDOC}
- \item [texmf-var] \envname{TEXMFSYSVAR}
- \item [texmf-config] \envname{TEXMFSYSCONFIG}
- \end{ttdescription}
- \item [texmf-local] \envname{TEXMFLOCAL} 用来存放在不同版本间共享的数据。
- \end{ttdescription}
- \item[用户主 (home) 目录] (\texttt{\$HOME} 或
- \texttt{\%USERPROFILE\%})
- \begin{ttdescription}
- \item[.texlive2007] 给上个版本的,个人生成和配置的数据。
- \item[.texlive2008] 给这个版本的,个人生成和配置的数据。
- \begin{ttdescription}
- \item [texmf-var] \envname{TEXMFVAR}
- \item [texmf-config] \envname{TEXMFCONFIG}
- \end{ttdescription}
- \item[texmf] \envname{TEXMFHOME} 个人的宏包文件。
- \textit{等等。}
- \end{ttdescription}
-\end{description}
-
-
-\subsection{\protect\TeX\ 的扩展版本}
-\label{sec:tex-extensions}
-
-\TeX{} 的开发已经冻结了,仅仅修改除去发现的极其少量的错误。
-在现在以及可预见的未来,\TL\ 中仍然提供 \prog{tex} 这个程序。
-除此以外,\TL{} 包括了一些建立在 \TeX\ 基础上的的扩展程序。
-\TL{} 包括下列 \TeX\ 扩展版本:
-
-\begin{description}
-
-\item [\eTeX] 为 \TeX\ 增加了一套新的原语 (primitive)。
-\label{text:etex} (包括宏展开,字符扫描,mark 的分类,额外的调试功能,等等)
-以及用于双向排版的 \TeXXeT{} 扩展模式。在默认模式下,\eTeX{} 是与原始的 \TeX\
-100\% 兼容的。参见 \OnCD{texmf-dist/doc/etex/base/etex_man.pdf}。
-
-\item [pdf\TeX] 在 \eTeX\ 扩展的基础上构建,在 \dvi{} 输出之外增加对
-\acro{PDF} 输出的支持。
-这是针对 \prog{etex}, \prog{latex} 或 \prog{pdflatex} 这些格式使用的缺省程序。
-见 \url{http://www.pdftex.org}。它的手册在 \OnCD{texmf/doc/pdftex/manual}。展
-示其一些功能的例子可以在 \OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex}
-中找到。
-
-\item [Lua\TeX] 是 pdf\TeX\ 指定的后继者,尽可能对 pdf\TeX\ 保持向前兼容。
-它同时也是 Aleph (见后) 的继任者。
-它内置的 Lua 语言解释器 (\url{http://www.lua.org}) 为许多 \TeX{} 的棘手问题
-提供了优雅的解决方案。
-当以 \filename{texlua} 命令执行时,它就像一个标准的 Lua 解释器一样工作,
-所以,Lua\TeX\ 在 \TL\ 中也被作为 Lua 程序的解释器。
-见 \url{http://www.luatex.org} 和 \OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}。
-
-\item [Xe\TeX] 通过第三方库,增加对 Unicode 输入文本和 OpenType 字体的支持,
-能够直接使用系统字体。参见 \url{http://scripts.sil.org/xetex}。
-
-\item [\OMEGA\ (Omega)] 基于 Unicode (16 位字符集),因而同时支持处理世界上
-几乎所有的语言。它同时还支持所谓的 `\OMEGA{} Translation Processes' (\acro{OTP}),
-用于对任意输入进行复杂的变换操作。参见
-\OnCD{texmf-dist/doc/omega/base/doc-1.8.tex} (文档的更新可能不是很及时)。
-
-\item [Aleph] 将 \OMEGA\ 与 \eTeX\ 扩展合并到一起得到的。
-在 \OnCD{texmf-dist/doc/aleph/base} 可以找到一些简短的文档。
-
-\end{description}
-
-
-\subsection{\protect\TL\ 中其他值得一提的程序}
-
-这里是在 \TL{} 中其他的一些常用程序:
-
-\begin{cmddescription}
-
-\item [bibtex] 参考文献支持。
-
-\item [makeindex] 索引支持。
-
-\item [dvips] 将 \dvi{} 转换为 \PS{}。
-
-\item [xdvi] X Window System 下的 \dvi{} 阅读器。
-
-\item [dvilj] HP LaserJet 系列打印机的 \dvi{} 驱动。
-
-\item [dv2dt, dt2dv] \dvi{} 和纯文本之间的相互转换。
-
-\item [dviconcat, dviselect] 从 \dvi{} 文件中复制和粘贴页面。
-
-\item [dvipdfmx] 将 \dvi{} 转换为 \acro{PDF},是 (前面提到过的)
-pdf\TeX\ 的一套替换方案。参见 \pkgname{ps4pdf} 和
-\pkgname{pdftricks} 软件包以了解其他的方案。
-
-\item [psselect, psnup, \ldots] \PS{}
-实用程序。
-
-\item [lacheck] \LaTeX{} 语法检查器。
-
-\item [texexec, texmfstart] Con\TeX{}t 和 \acro{PDF} 处理工具。
-
-\item [tex4ht] \TeX{} 到 \acro{HTML} (还有 \acro{XML} 等其他格式)
-的转换器。
-
-\end{cmddescription}
-
-
-\subsection{\TL\ 中的字体}
-\label{sec:tl-fonts}
-
-\TL{} 中包括了很多的高质量矢量字体,参见 \url{http://tug.org/fonts} 和
-\OnCD{texmf-doc/english/free-math-fonts-survey}。
-
-\section{安装}
-\label{sec:install}
-
-\subsection{启动安装程序}
-\label{sec:inst-start}
-
-首先请找来一张 \TK{} 的 \DVD{},或者下载 \TL{} 的网络安装程序,然后
-找到这个安装脚本:Unix 下是 \filename{install-tl},Windows 下是
-\filename{install-tl.bat}。
-
-\begin{description}
-\item [网络安装程序:] 在 \CTAN 的 \dirname{systems/texlive/tlnet}
-目录下可以下载,\url{http://mirror.ctan.org/systems/texlive/tlnet} 这个地址能
-自动将你导向一个附近的、保持更新的镜像。你可以下载同时支持 Unix 和
-Windows 的 \filename{install-tl.zip} 或者小得多但只支持 Unix 的
-\filename{install-unx.tar.gz}。解压后,\filename{install-tl} 和
-\filename{install-tl.bat} 就会出现在 \dirname{install-tl} 子目录中。
-
-\item [\TeX{} Collection \DVD:] 打开 \dirname{texlive} 这个子目录。
-在 Windows 下安装程序应该在插入 \DVD 后就自动启动了。要获得 \DVD 的
-话可以加入一个 \TeX\ 用户组织 (推荐这么做,参见
-\url{http://tug.org/usergroups.html}) 或是单独购买 (通过
-\url{http://tug.org/store}),又或者是自己从 \ISO\ 镜像刻录
-(\url{http://tug.org/texlive/acquire.html})。
-
-\end{description}
-
-下面的章节介绍得更为详细。
-
-\subsubsection{Unix}
-
-\begin{figure}[tb]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
-
- Detected platform: Intel x86 with GNU/Linux
-
- <B> binary systems: 1 out of 16
-
- <S> Installation scheme (scheme-full)
-
- Customizing installation scheme:
- <C> standard collections
- <L> language collections
- 83 collections out of 84, disk space required: 1666 MB
-
- <D> directories:
- TEXDIR (the main TeX directory):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
- [X] install macro/font doc tree
- [X] install macro/font source tree
- [ ] create symlinks in standard directories
-
- <V> Install for running from DVD
-
-Other actions:
- <I> start installation to HD
- <H> help
- <Q> quit
-
-Enter command:
-\end{boxedverbatim}
-\caption{文本模式主安装界面 (\GNU/Linux)}\label{fig:text-main}
-\end{figure}
-
-\begin{figure}[tb]
-\tlpng{install-w32-main}{\linewidth}
-\caption{\GUI{} 模式主安装界面 (Windows)}\label{fig:gui-main}
-\end{figure}
-
-\noindent
-下面的 \texttt{>} 表示 shell 提示符;用户的输入则用
-\Ucom{\texttt{bold}} 体表示。
-在 Unix 兼容的系统的一个终端窗口下,最简单的方式是:
-\begin{alltt}
-> \Ucom{cd /path/to/installer}
-> \Ucom{perl install-tl}
-\end{alltt}
-(或者你可以直接运行 \Ucom{perl /path/to/installer/install-tl},或者
-\Ucom{./install-tl},如果这个文件有可执行属性,我们不会把所有这些执
-行方法列出来。)
-
-要在 \GUI\ 模式下安装 (你需要 \dirname{Perl/TK} 模块),使用:
-\begin{alltt}
-> \Ucom{perl install-tl -gui}
-\end{alltt}
-
-要列出所有这些选项:
-\begin{alltt}
-> \Ucom{perl install-tl -help}
-\end{alltt}
-
-\textbf{关于 Unix 下权限的警告:} 在安装过程中,\TL{} 安装程序将会
-遵照你的 \code{umask} 行事。所以如果你需要让你的安装能给其他用户使
-用,就必须保证你设置的权限足够,比如 \code{umask 002}。更多关于
-\code{umask} 的信息请参见你自己系统的文档。
-
-\subsubsection{Mac\,OS\,X}
-
-如第 \ref{sec:tl-coll-dists} 节提到的,我们给 \MacOSX 准备了一套独立的
-发行版,叫做 Mac\TeX\ (\url{http://tug.org/mactex})。我们推荐使用原生的
-Mac\TeX\ 安装程序,而不是 \TL\ 自带的那个,因为原生的这个能进行一些专门
-针对 Mac 的调整,尤其方便在多个 \MacOSX 下的 \TeX\ 发行版 (Mac\TeX, gw\TeX,
-Fink, MacPorts, \ldots) 之间切换。
-
-Mac\TeX\ 是严格依赖 \TL 构建的,所以主 \TeX\ 树也是完全一致的。不过它添
-加了一些用来存放 Mac 专有文档和程序的目录。
-
-\subsubsection{Windows}
-
-如果你使用的是网络安装程序,又或者 \DVD 安装程序无法自动启动了,请
-双击 \filename{install-tl.bat}。
-
-你也可以从命令行提示符下启动安装程序。下面 \texttt{>} 表示的就是提示符,
-用户输入用 \Ucom{\texttt{bold}} 体表示。如果你正在安装程序目录下,只需要
-运行:
-\begin{alltt}
-> \Ucom{install-tl}
-\end{alltt}
-
-或者你也可以通过绝对路径来运行,比如:
-\begin{alltt}
-> \Ucom{D:\bs{}texlive\bs{}install-tl}
-\end{alltt}
-这是对 \TK\ \DVD 而言的,假定 \dirname{D:} 是光驱。
-
-要在文本模式下安装,使用:
-\begin{alltt}
-> \Ucom{install-tl -no-gui}
-\end{alltt}
-
-要列出所有可用的选项:
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-
-\subsubsection{文本界面安装程序}
-
-图~\ref{fig:text-main} 展示了 Unix 下文本模式的主界面。
-
-这是一个完全用命令行操作的安装程序,完全不支持光标移动。所以你无法
-在多选框或者输入框之间用 Tab 上下切换,只能在提示符下输入特定的字符
-(大小写敏感的) 然后按下 Enter,整个终端窗口就会把新的内容刷新出来。
-
-文本安装程序之所以这么简陋是因为它要尽可能支持最多的平台,就算
-只有一个 Perl 的系统也能运行它 (对于 Windows 我们自带了一个 Perl
-的裁剪版本)。
-
-\subsubsection{图形界面安装程序}
-
-图~\ref{fig:gui-main} 展示了 Windows 下的的图形界面安装程序。图中
-选项的差别主要是因为这张图是从 Windows 下截取的,而上面的文本模式
-界面来自 \GNU/Linux。
-
-\subsection{执行安装程序}
-\label{sec:runinstall}
-
-安装程序应该不需要文档就足够明确。不过对这些选项和子菜单还需要点小说明。
-
-\subsubsection{二进制系统菜单 (只对 Unix 适用)}
-\label{sec:binary}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Available sets of binaries:
-===============================================================================
-
- a [ ] alpha-linux DEC Alpha with GNU/Linux
- b [ ] amd64-freebsd x86_64 with FreeBSD
- c [ ] hppa-hpux HP-UX
- d [ ] i386-freebsd Intel x86 with FreeBSD
- e [X] i386-linux Intel x86 with GNU/Linux
- f [ ] i386-openbsd Intel x86 with OpenBSD
- g [ ] i386-solaris Intel x86 with Sun Solaris
- h [ ] mips-irix SGI IRIX
- i [ ] powerpc-aix PowerPC with AIX
- j [ ] powerpc-linux PowerPC with GNU/Linux
- k [ ] sparc-linux Sparc with GNU/Linux
- l [ ] sparc-solaris Sparc with Solaris
- m [ ] universal-darwin universal binaries for MacOSX/Darwin
- o [ ] win32 Windows
- p [ ] x86_64-linux x86_64 with GNU/Linux
-\end{boxedverbatim}
-\caption{Binaries (二进制程序) 菜单}\label{fig:bin-text}
-\end{figure}
-
-图~\ref{fig:bin-text} 展示了文本模式下的 binaries (二进制程序)
-菜单。默认情况下只会安装你当前平台下的二进制程序。在这个菜单下,
-你可以选择安装其他架构的二进制程序。这对你要将 \TeX\ 树共享在
-异构网络上的情况比较有用,又或者用于双启动的系统。
-
-\subsubsection{选择要安装的组件}
-\label{sec:components}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-Select a scheme:
-===============================================================================
-
- a [ ] TeX Live basic scheme
- b [ ] TeX Live scheme for ConTeXt
- c [X] TeX Live full scheme
- d [ ] GUST TeX Live scheme
- e [ ] GUTenberg TeX Live scheme
- f [ ] TeX Live medium scheme
- g [ ] TeX Live minimal scheme
- h [ ] TeX Live for Omega users
- i [ ] teTeX scheme
- j [ ] XML typesetting scheme
-\end{boxedverbatim}
-\caption{Scheme (安装方案) 菜单}\label{fig:scheme-text}
-\end{figure}
-
-图~\ref{fig:scheme-text} 展示了 \TL\ 的安装方案菜单;从这里你选择的是
-一套``安装方案'',也就是对软件包集合的一个统一划分。默认的 \optname{full}
-方案会把所有可用的都装上,不过你也可以给小点的系统选择 \optname{basic} 方
-案,为测试选用 \optname{minimal} 方案,又或者是 \optname{medium} 或
-\optname{teTeX} 来选择介乎其间的方案。还有许多特殊或者专门针对特定国家
-的方案。
-
-\begin{figure}[tbh]
-\tlpng{stdcoll}{.7\linewidth}
-\caption{Collections (集合) 菜单 (Linux)}\label{fig:collections-gui}
-\end{figure}
-
-你可以使用 `standard collections' 与 `language collections' 菜单来详细
-选择安装方案。(图~\ref{fig:collections-gui} 显示了 \GUI 模式下修改的情
-况。)
-
-Collection (安装集合) 是比 scheme (方案) 要更细的一层 \Dash 实际上一个
-方案包含了多个集合,而一个集合又包含了一到多个软件包,然后每个软件包
-(\TL 中最小的组织单位) 则包含了实际的 \TeX\ 宏文件,字体文件,等等。
-
-如果你觉得 collection 菜单对安装控制还不够细,可以在安装后使用
-\prog{tlmgr} 程序 (参见第~\ref{sec:tlmgr} 节),它能在软件包一层
-控制安装。
-
-\subsubsection{目录}
-\label{sec:directories}
-
-缺省的目录布局在第~\ref{sec:texmftrees} 节有过叙述,见第
-\pageref{sec:texmftrees} 页。默认的 \dirname{TEXDIR} 路径
-则是 Windows 下的 |%PROGRAMFILES%\texlive\2008| 和 Unix
-下的 \dirname{/usr/local/texlive/2008}。
-
-更改默认值的主要原因大概是你可能没有默认位置的写权限。虽然要安装
-\TL 不需要是管理员或者 root 用户,但你至少得对安装的目的目录有写
-权限。
-
-一个合理的选择是你自己主目录下的一个子目录,尤其在只有你一个人
-使用的时候。使用 `|~|' 来表示主目录,比如 `|~/texlive/2008|'。
-
-我们建议在目录名称中保留年份,这样可以让你保留多个不同版本的
-\TL{}。(你可能希望用一个类似 \dirname{/usr/local/texlive-cur}
-这样的名字作为指向当前版本的符号链接,这样的目录名就和版本无
-关了,你只要在新版本出来直接更新符号链接即可。)
-
-在安装程序中修改 \dirname{TEXDIR} 之后还会同时修改
-\dirname{TEXMFLOCAL}, \dirname{TEXMFSYSVAR} 和
-\dirname{TEXMFSYSCONFIG}。
-
-\dirname{TEXMFHOME} 是推荐用来存放个人宏文件和软件包的目录。
-其缺省值是 |~/texmf|。与 \dirname{TEXDIR} 不同,其中包含的
-|~| 会被不加转换地写进配置文件,因为它能在 \TeX 系统运行时
-自动被替换为每个用户自己的主目录。在 Unix 它会被展开为
-\dirname{$HOME},而 Windows 下展开为 \verb|%USERPROFILE%|。
-
-\subsubsection{选项}
-\label{sec:options}
-
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-<P> use letter size instead of A4 by default: [ ]
-<F> create all format files: [X]
-<D> install font/macro doc tree: [X]
-<S> install font/macro source tree: [X]
-<L> create symlinks in standard directories: [ ]
- binaries to:
- manpages to:
- info to:
-\end{boxedverbatim}
-\caption{Options 菜单 (Unix)}\label{fig:options-text}
-\end{figure}
-
-图~\ref{fig:options-text} 显示了文本模式的选项菜单。其中有
-三个选项值得一提:
-
-\begin{description}
-\item[use letter size instead of A4 by default:] 常见的缺省纸张大小选择。
-当然如果需要,每份文档都可以单独设定一个纸张大小。
-
-\item[create all format files:] 虽然创建不必要的格式文件会浪费一
-点时间,也会多占一些磁盘空间,但
-我们还是建议现在保持这个选项的选定状态,因为如果这次不生成,下次
-用到的时候格式文件就会在用户个人的 \dirname{TEXMFVAR} 目录树内生
-成。这样每次二进制文件或者断字模式更新的时候,这些格式文件也得不
-到更新,所以可能会导致它们的不兼容。
-
-\item[create symlinks in standard directories] (只对 Unix 有效):
-这个选项可以省下设定环境变量的步骤。如果没有选择它,就必须把
-\TL{} 的对应目录添加到 \envname{PATH}, \envname{MANPATH} 和
-\envname{INFOPATH} 中。如果要创建符号链接,你需要对这些目标
-目录的写权限。我们不建议你用这个命令来覆盖现有的 \TeX\ 系统,
-它主要是为了在用户已知的标准目录中创建符号链接设计的,这些
-目录并不包含任何 \TeX\ 文件。
-\end{description}
-
-如果所有的设置已经齐备,你就可以按下 `I' 来开始安装了。安装完成后,
-你可以跳至第 \ref{sec:postinstall} 节来了解还需要做些什么工作。
-
-\subsubsection{设置从 DVD{} 运行 (只对文本模式适用)}
-\label{sec:fromdvd}
-
-按 `|V|' 来选择这个选项。它将主菜单改变为类似图~\ref{fig:main-fromdvd}
-的界面。
-\begin{figure}[tbh]
-\begin{boxedverbatim}
-======================> TeX Live installation procedure <=====================
-
-=======> Note: Letters/digits in <angle brackets> indicate menu items <=======
-=======> for commands or configurable options <=======
-
- <D> directories:
- TEXDIRW (Writable root):
- !! default location: /usr/local/texlive/2008
- !! is not writable, please select a different one!
- TEXMFLOCAL (directory for site-wide local files):
- /usr/local/texlive/texmf-local
- TEXMFSYSVAR (directory for variable and automatically generated data):
- /usr/local/texlive/2008/texmf-var
- TEXMFSYSCONFIG (directory for local config):
- /usr/local/texlive/2008/texmf-config
- TEXMFHOME (directory for user-specific files):
- ~/texmf
-
- <O> options:
- [ ] use letter size instead of A4 by default
- [X] create all format files
-
- <V> set up for installing to hard disk
-
-Other actions:
- <I> start installation for running from DVD
- <H> help
- <Q> quit
-\end{boxedverbatim}
-\caption{启用 \optname{from DVD} 集合后的主菜单}\label{fig:main-fromdvd}
-\end{figure}
-
-注意变化之处:所有关于安装内容的选项都消失了,而目录这部分
-的设置现在是根据 \dirname{TEXDIRW} (或者一个可写的根目录)
-来设置的。创建符号链接的选项也没有了。
-
-这样安装程序仍然会创建一些目录和配置文件,但并不会把 \dirname{texmf},
-\dirname{texmf-dist} 或 \dirname{texmf-doc} 目录复制到本地硬盘上。
-
-Unix 系统下的安装后配置步骤要稍微复杂一些,因为这样目录布局就和缺
-省情况有所区别了,参见第 \ref{sec:postinstall} 节。
-
-因为时间限制,这个选项还来不及集成进入 \GUI{} 安装程序。不过它的确
-是同时支持 Unix 和 Windows 的。Windows 用户需要从命令行选项来启动
-这个安装程序,参见第 \ref{sec:cmdline} 节。
-
-第 \ref{sec:portable-unix} 节描述了一套更具可移植性地运行 \TL{}
-的方法,它不需要对系统配置做任何改动,但也做不了任何配置。
-
-\subsection{命令行安装选项}
-\label{sec:cmdline}
-
-输入
-\begin{alltt}
-> \Ucom{install-tl -help}
-\end{alltt}
-可以列出所有的命令行参数。你既可以用 |-| 也可以用 |--| 来指定一个
-参数。这里有些比较有趣的:
-
-\begin{ttdescription}
-\item[-gui] 尽可能用 \GUI{} 模式的安装程序。它需要安装了
- Perl/Tk 模块 (\url{http://tug.org/texlive/distro.html#perltk});
- 如果找不到 Perl/Tk,安装程序就会在文本模式下出现。
-\item[-no-gui] 强制使用文本模式安装程序,就算在 Windows 下也是如此。
-如果你需要 `from \DVD' 安装方式就需要用到这个选项,因为这个方式在
-\GUI{} 模式下没有提供。
-\item[-lang {\sl LL}] 指定安装程序界面的语言,使用两个字符的语言
-代码 \textsl{LL}。目前支持的语言有:英语 (\texttt{en}, 默认值),
-德语 (\texttt{de}), 法语 (\texttt{fr}), 荷兰语 (\texttt{nl}), 波兰语
-(\texttt{pl}), 斯洛文尼亚语 (\texttt{sl}) 和越南语 (\texttt{vi})。
-安装程序会尝试自己判断出合适的语言,如果判断出的语言没有支持就会
-使用英语替代。
-\item[-profile {\sl profile}] 安装程序会在 \dirname{2008/tlpkg}
-目录或者安装到的子目录 \dirname{tlpkg} 中创建一个叫
-\filename{texlive.profile} 的文件。这个选项可以让安装程序重用
-现成的这种文件。这里有个例子:
- \begin{fverbatim}
-# texlive.profile written on Wed Jul 9 16:13:44 2008 UTC
-# It will NOT be updated and reflects only the
-# installation profile at installation time.
-selected_scheme scheme-basic
-TEXDIR /usr/local/texlive/2008
-TEXDIRW /usr/local/texlive/2008
-...
-TEXMFSYSVAR /usr/local/texlive/2008/texmf-var
-collection-basic 1
-...
-option_symlinks 0
- \end{fverbatim}
-这样一来,通过这个选项你就可以在后来的系统里进行批量安装了,可以
-保证选项和第一次安装的完全一样。
-\item [-location {\sl url/path}] 为软件包指定一个非官方的来源,参见下文。
-\end{ttdescription}
-
-\subsubsection{\optname{location} 参数}
-\label{sec:location}
-
-location 值可以是一个以 \texttt{ftp:}, \texttt{http:}, 或
-\texttt{file:/} 起始的 URL,或者一个本地路径。如果给定的地
-址在本地磁盘上 (或者是路径或者是 \texttt{file:/} 开头的 URL),
-我们可以立即判断出安装的类型 (压缩的 CD 还是 live DVD):如果
-能找到一个叫 \dirname{archive} 子目录而且它下面都是
-\filename{.tar.lzma} 格式的压缩文件,那就会用它进行安装,就算
-没压缩的文件也存在。
-
-如果给定了一个 \texttt{http:} 或 \texttt{ftp:} 地址,其末尾的
-`\texttt{/}' 字符和末尾的 `\texttt{/tlpkg}' 这段都会被忽略。
-比如你可以选择这样的一个 \CTAN 镜像:
-\url{http://ctan.example.org/tex-archive/texlive/tlnet/2008},
-当然你应该把 |ctan.example.org/tex-archive| 替换为具体镜像的
-域名和特定的顶层 \CTAN 路径 (\url{http://ctan.org/mirrors})
-维护了一个 \CTAN 的镜像列表)。缺省值是使用 \url{http://mirror.ctan.org}
-来自动判断的。不管是什么情况,选定的镜像都会被用来下载所有的
-内容。
-
-\subsection{安装后的操作}
-\label{sec:postinstall}
-
-安装后可能需要一些额外的操作。
-
-\subsubsection{Windows}
-
-在 Windows 下安装程序会完成所有的操作。
-
-\subsubsection{如果创建了符号链接}
-
-如果你选择了在标准路径下创建符号连接 (在第~\ref{sec:options} 节提到),
-那就不需要设置环境变量了。
-
-\subsubsection{Unix 下的环境变量}
-\label{sec:env}
-
-你应该将自己使用的平台下二进制程序的目录加入搜索路径中。每个支
-持的平台都在 \dirname{TEXDIR/bin} 下有自己的子目录。参见图~\ref{fig:bin-text}
-以了解所有的这些子目录和它们对应的平台。
-
-如果希望 man 和 info 能够找到,你还可以把文档的 man 和 Info 目录加
-入其对应的搜索路径中。
-
-对于 \prog{bash} 这样的 Bourne 兼容 shell 而言,以 Intel x86 下的
-GNU/Linux、默认的目录设置为例,需要修改的文件是 \filename{$HOME/.profile}
-(或者其他由 \filename{.profile} 载入的文件),应该添加的内容应该类似
-这样:
-
-\begin{sverbatim}
-PATH=/usr/local/texlive/2008/bin/i386-linux:$PATH; export PATH
-MANPATH=/usr/local/texlive/2008/texmf/doc/man:$MANPATH; export MANPATH
-INFOPATH=/usr/local/texlive/2008/texmf/doc/info:$INFOPATH; export INFOPATH
-\end{sverbatim}
-
-对于 csh 或者 tcsh,需要修改的文件通常是 \filename{$HOME/.cshrc},而
-应该添加的内容类似:
-
-\begin{sverbatim}
-setenv PATH /usr/local/texlive/2008/bin/i386-linux:$PATH
-setenv MANPATH /usr/local/texlive/2008/texmf/doc/man:$MANPATH
-setenv INFOPATH /usr/local/texlive/2008/texmf/doc/info:$INFOPATH
-\end{sverbatim}
-
-当然,你可能已经在你的配置文件里写过了这样的路径设置,那就只需要
-把 \TL\ 的这些目录加进去就行了。
-
-\subsubsection{环境变量的全局配置}
-\label{sec:envglobal}
-
-如果你希望在整个系统范围内修改这些变量,或这样系统新增的用户自动
-继承这些变量,就得自寻方法了,因为不同的系统之间这方面的配置差异
-太大。
-
-我们的建议是: 1)~你可能应该看看 \filename{/etc/manpath.config}
-这个文件是否存在,如果有的话,添加下面这样的内容:
-
-\begin{sverbatim}
-MANPATH_MAP /usr/local/texlive/2008/bin/i386-linux \
- /usr/local/texlive/2008/texmf/doc/man
-\end{sverbatim}
-
-然后 2)~检查 \filename{/etc/environment} 是否定义了默认的搜索路径
-和其他的默认环境变量。
-
-\subsubsection{如果从 DVD 运行}
-
-通常来说 \TL{} 程序都会寻找一个叫做 \filename{texmf.cnf} 的文件
-来获知所有的 \TeX 树位置。它会在一系列和其本身位置相关的地方寻
-找这个文件。不过如果直接在 \DVD 上运行,这套规则就不适用了:因为
-\DVD{} 是只读的,而某些路径只能在安装时确定下来并写入这个文件,
-所以这个文件没法放在 \DVD{} 上,只能另置一处。所以可能会需要定义
-\envname{TEXMFCNF} 来告知 \TL{} 程序该从哪儿找到这个 \filename{texmf.cnf}
-文件。当然,如前所述 \envname{} 环境变量还是要改的。
-
-在安装结束时,安装程序会输出一段告诉你如何设置 \envname{TEXMFCNF}
-的信息,如果你忽略了话,它应该是 \dirname{$TEXMFSYSVAR/web2c},默认
-情况下就是 \dirname{/usr/local/texlive/2008/texmf-var/web2c},你需要
-在 bash 下使用:
-\begin{sverbatim}
-TEXMFCNF=/usr/local/texlive/2008/texmf-var/web2c; export TEXMFCNF
-\end{sverbatim}
-或者 [t]csh 下使用:
-\begin{sverbatim}
-setenv TEXMFCNF /usr/local/texlive/2008/texmf-var/web2c
-\end{sverbatim}
-
-
-\subsubsection{\ConTeXt{} Mark IV}
-
-`老版'的 \ConTeXt{} 正常就应该能工作。新的 `Mark IV' \ConTeXt{}
-则需要一些手动设置。参见
-\url{http://wiki.contextgarden.net/Running_Mark_IV}。
-
-\subsubsection{集成本地与个人宏文件}
-\label{sec:local-personal-macros}
-
-这在第~\ref{sec:texmftrees} 节已经顺带提到过了:\dirname{TEXMFLOCAL}
-目录 (它的默认值是 \dirname{/usr/local/texlive/texmf-local} 或者
-\verb|C:\Program Files\texlive\texmf-local|) 这个目录就是为了存储
-面向整个系统的本地字体和宏文件的;而 \dirname{TEXMFHOME} 目录 (其
-默认值是 \dirname{$HOME/texmf} 或者 \verb|%USERPROFILE%\texmf|),
-则是用来存储个人的字体和宏文件的。这些目录应该在各个 \TL{}
-版本之间共享,每个版本都能看到其内容。因此不应该把
-\dirname{TEXMFLOCAL} 改得和主 \TL{} 目录差别太大,否则新的版本出来
-你又得再改。
-
-对于这两个目录树而言,文件都应该放到合适的子目录中,参见
-\url{http://tug.org/tds} 或者 \filename{texmf/web2c/texmf.cnf}
-文件。比如一个 \LaTeX{} 文档类或者宏包应该放在
-\dirname{TEXMFLOCAL/tex/latex} 或者 \dirname{TEXMFHOME/tex/latex}
-目录下,要不然就是它们的一个子目录下。
-
-\dirname{TEXMFLOCAL} 目录需要一个保持更新的文件名数据库,否则新增
-的文件就无法找到。你可以使用 \cmdname{mktexlsr} 命令或者
-\prog{tlmgr} \GUI\ 模式下,configuration 选项卡中的
-`Reinit file database' 按钮来刷新它。
-
-\subsubsection{集成第三方字体}
-
-不幸的是,这是一个非常复杂而混乱的主题。除非你对 \TeX{} 安装非常
-熟悉,否则请不要涉足这个领域。别忘了事先看看我们附带的字体,参见
-第 \ref{sec:tl-fonts} 节。
-
-\XeTeX 是一套可行的替代方案 (参见第 \ref{sec:tex-extensions} 节),
-它能让你使用操作系统的字体而不必将它安装到 \TeX 中。
-
-\subsection{测试安装是否成功}
-\label{sec:test-install}
-
-在完成你所需要的 \TL{} 安装之后,自然你会希望试试看它是否正常工作,好让你在以后能够
-创建优美的文档和字体。
-
-这个小节给出了一些测试系统是否正常工作的基本步骤。我们这里使用的是 Unix 命令,在
-\MacOSX{} 和 Windows 下你更可能是使用图形界面运行这些测试的,不过其原理并无不同。
-
-\begin{enumerate}
-
-\item 首先确认你可以执行 \cmdname{tex} 程序:
-\begin{alltt}
-> \Ucom{tex -{}-version}
-TeX 3.1415926 (Web2C 7.5.7)
-kpathsea version 3.5.7
-...
-\end{alltt}
-如果返回的结果是 `command not found' 而非版本和版权信息,或者显示了
-旧版本的信息,很有可能是因为你没有把正确的 \dirname{bin} 子目录添加
-到 \envname{PATH} 中。参见第 \pageref{sec:env} 页关于设置环境变量
-的说明。
-
-\item 处理一个基本的 \LaTeX{} 文件:
-\begin{alltt}
-> \Ucom{latex sample2e.tex}
-This is pdfeTeXk, Version 3.141592...
-...
-Output written on sample2e.dvi (3 pages, 7484 bytes).
-Transcript written on sample2e.log.
-\end{alltt}
-如果无法找到 \filename{sample2e.tex} 或其他什么文件,很可能是因为旧的环境变量
-或配置文件影响了判断。我们建议你重置所有 \TeX 相关的环境变量然后重试。(你可以
-让 \TeX{} 报告具体搜索的路径,以便仔细分析出错的原因。参见第 \pageref{sec:debugging}
-页的``调试操作''一节以了解更多信息。)
-
-\item 即时预览结果:
-\begin{alltt}
-> \Ucom{xdvi sample2e.dvi}
-\end{alltt}
-(Windows 下类似的命令叫 \cmdname{dviout}。) 你应该可以看到在新窗口中出现了一篇
-介绍 \LaTeX{} 基础的有趣文档。(如果你刚接触 \TeX\ 系统,还是值得一读的。) \cmdname{xdvi}
-需要运行在 X 窗口系统下才能工作,如果没有运行窗口环境或 \envname{DISPLAY} 环境变量设置
-错误,都会得到 \samp{Can't open display} 这句错误信息。
-
-\item 创建用于打印或显示的 \PS{} 文件:
-\begin{alltt}
-> \Ucom{dvips sample2e.dvi -o sample2e.ps}
-\end{alltt}
-
-\item 创建 \acro{PDF} 文件而非 \dvi{},这里采用直接处理 \filename{.tex}
-文件输出 \acro{PDF} 的方式:
-\begin{alltt}
-> \Ucom{pdflatex sample2e.tex}
-\end{alltt}
-
-\item 预览 \acro{PDF} 文件:
-\begin{alltt}
-> \Ucom{gv sample2e.pdf}
-\textrm{或:}
-> \Ucom{xpdf sample2e.pdf}
-\end{alltt}
-不幸的是 \cmdname{gv} 和 \cmdname{xpdf} 现在都不包含在 \TL{} 中,你
-必须单独安装它们。请分别参阅 \url{http://www.gnu.org/software/gv} 和
-\url{http://www.foolabs.com/xpdf}。(还有许多其他的 \acro{PDF} 查看器。)
-
-\item 除 \filename{sample2e.tex} 外可能会对你有用的标准测试文件:
-
-\begin{ttdescription}
-\item [small2e.tex] 比 \filename{sample2e} 更为简单的文档,供你在遇到问题
-时尝试减少输入的内容。
-\item [testpage.tex] 测试你的打印机是否带有预设的偏移量。
-\item [nfssfont.tex] 打印一份字体表格 (proofsheet) 以供测试。
-\item [testfont.tex] 用 plain \TeX{} 打印字体表格。
-\item [story.tex] 最经典的 (plain) \TeX{} 测试文件。在执行
-\samp{tex story.tex} 之后,你还要在 \code{*} 提示符下键入 \samp{\bs bye}。
-\end{ttdescription}
-你可以用与我们处理 \filename{sample2e.tex} 文件时相同的方式来处理这些文件。
-
-\end{enumerate}
-
-如果你还是个 \TeX{} 新手,或者在编辑 \TeX{} 或 \LaTeX{} 文档时需要帮助,
-请访问 \url{http://tug.org/begin.html} 寻找引导性的资源。
-
-
-\section{网络安装}
-\label{sec:netinstall}
-
-\TL{} 的设计可以使它在不同的用户间共享,甚至可以在网络上不同的系统间共
-享。在标准的目录结构下,不需要配置固定的绝对路径:\TL{} 程序所需要的文
-件都能通过都在这些程序自身的相对路径找到。你可以在
-\filename{$TEXMFMAIN/web2c/texmf.cnf} 配置文件中看到实际的处理,
-它包含了类似下面的内容:
-\begin{verbatim}
-TEXMFMAIN = $SELFAUTOPARENT/texmf
-...
-TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local
-\end{verbatim}
-这就意味着,其它的系统或用户只需要把 \TL{} 的可执行文件的位置添加到其
-系统的搜索路径中即可。
-
-同理,你也可以先把 \TL{} 安装在本地,然后再把整个安装目录转移到网络上。
-
-当然,Windows 用户会有不同的期望。\dirname{texmf-doc/source/texlive/texlive-common/w32client}
-目录包含了一个样例脚本 \filename{install-w32client},它可以为局域网上的
-\TL{} 安装产生配置文件和菜单快捷方式。它可以通过在相同目录的
-\filename{install-w32client.bat} 调用。
-
-你可以在第~\ref{sec:kpathsea}~节中了解更多有关 \TL{} 配置和
-路径搜索的内容。
-
-\section{在 DVD 或 USB 上最具可移植性地运行 \protect\TL{}}
-\label{sec:portable-unix}
-
-在第 \ref{sec:fromdvd} 节中介绍的``从 \DVD{} 运行''选项可以使发行版在
-你的系统上很好地运行,但是如果你在别人的机器上用非管理员帐号工作,
-那你就可能希望使用对系统本身的影响最小的运行方式。
-
-在 \TL{} \DVD 的根目录,或者 \TK{} \DVD 的 \dirname{texlive} 子目录中,
-有一个为 Unix 系统提供的脚本 \filename{tl-portable} 和一个为 Windows
-系统提供的批处理文件 \filename{tl-portable.bat}。它们能开启一个设置好
-环境变量的终端或命令提示符,在其中就能直接运行 \DVD 上的 \TL{}。
-
-头一次执行时它会花点时间在 \dirname{~/.tlportable2008} 目录下生成一些
-文件,此后就可以在很短的时间内启动了。
-
-而此时系统的其它程序并不知道 \TL{} 的存在,如果你需要让你的文本编辑器
-使用这个 \TL,可以再打开一个这样的 \filename{tl-portable} 会话来使用
-该编辑器。
-
-你还能通过 \filename{tl-portable} 在 \acro{USB} 驱动器上运行 \TL。
-在这种情况下,请 (至少) 把所有的顶层目录下的所有文件和 \dirname{bin},
-\dirname{texmf}, \dirname{texmf-dist} 和 \dirname{tlpkg} 下的所有内容
-复制到 USB 驱动器上。这会花一定的时间。如果你把它复制到一个 \acro{FAT}32
-格式的 \acro{USB} 驱动上,请保证复制操作是跟踪 (dereference) 所有的
-符号链接到实际数据文件的 (\code{cp -L})。运行时都会查找并使用驱动器上
-的 \dirname{texmf-local} 目录。
-
-然后你就可以在驱动器的根目录下像上面那样运行 \filename{tl-portable}
-了。此时脚本能判断出这个驱动是可写的,并把产生的文件写到这里。
-为了方便起见 (比如你想把它提供给别人),你也可以把驱动器上的最终内容
-刻录回到 \DVD{} 上。
-
-\section{\cmdname{tlmgr}: 管理你的安装}
-\label{sec:tlmgr}
-
-
-\begin{figure}[tb]
-\tlpng{tlmgr-gui}{\linewidth}
-\caption{图形界面模式运行的 \prog{tlmgr} 程序。
-安装包/集合/方案仅在按下 `Load' 按钮后显示。}\label{fig:tlmgr-gui}
-\end{figure}
-
-\begin{figure}[tb]
-\tlpng{tlmgr-config}{\linewidth}
-\caption{图形界面模式的 \texttt{tlmgr}: Configuration 选项卡}\label{fig:tlmgr-config}
-\end{figure}
-
-安装程序会装上一个叫 \prog{tlmgr} 的程序,它可以用来管理安装后的
-系统。像 \prog{updmap}, \prog{fmtutil} 和 \prog{texconfig} 这些程序
-仍然包含在发行版中,而且在将来也不会剔除,但是 \prog{tlmgr} 是一个
-优选的界面。它的功能包括:
-
-\begin{itemize*}
-\item 列出方案 (scheme),集合和安装包;
-\item 安装、升级、备份、恢复、卸载软件包,并且能自动计算依赖关系;
-\item 查找软件包;
-\item 列出和添加可执行文件的架构;
-\item 改变安装选项,比如纸张大小和源文件位置 (参见第~\ref{sec:location}~节)。
-\end{itemize*}
-\textit{警告:} \prog{tlmgr} 并不为在 \DVD 中运行设计,也从未做过相
-关的测试。
-
-\subsection{图形界面模式的 \cmdname{tlmgr}}
-\prog{tlmgr} 可以用以下命令以图形模式启动:
-\begin{alltt}
-> \Ucom{tlmgr -gui}
-\end{alltt}
-Windows 下可以通过开始菜单:\texttt{开始},\texttt{程序},
-\texttt{TeX Live 2008},\texttt{TeX Live Manager}。
-在假定安装包源是有效且可及的情况下,在点击 `Load' 以后,它会列出
-所有可获取的或已安装 (前面用 `(i)' 表示) 的软件包。
-
-图~\ref{fig:tlmgr-config} 展示了配置选项卡。
-
-\subsection{\cmdname{tlmgr} 命令行使用示例}
-
-下面的例子会从一个非默认的地址安装一些包,其中包括一个新的`引擎'。
-
-\begin{alltt}
-> \Ucom{tlmgr -location http://172.16.18.1/tldev install collection-xetex xkeyval}
-\end{alltt}
-它会产生下面的输出:
-\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/2008/texmf/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-config/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-dist/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-doc/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/../texmf-local/ls-R...
-mktexlsr: Updating /usr/local/texlive/2008/texmf-var/ls-R...
-mktexlsr: Done.
-regenerating fmtutil.cnf
-running fmtutil-sys --missing
-...
-Transcript written on xelatex.log.
-fmtutil: /usr/local/texlive/2008/texmf-var/web2c/xetex/xelatex.fmt installed.
-\end{fverbatim}
-如你所见,\prog{tlmgr} 会安装所有依赖的包,也会处理所有包括刷新文件名
-数据库和重新生成格式文件在内的所有必要的安装后工作。(在这里,我们生成
-了新的 \XeTeX\ 格式文件)。
-
-下面这个例子安装了一个新的语言支持,也会触发格式文件的重新生成。
-\begin{alltt}
-> \Ucom{tlmgr install collection-langdutch}
-\end{alltt}
-如果想得到安装包的说明:
-\begin{alltt}
-> \Ucom{tlmgr show collection-wintools}
-\end{alltt}
-会产生
-\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
-\end{fverbatim}
-把你的整个安装更新到最新版本:
-\begin{alltt}
-> \Ucom{tlmgr update -all}
-\end{alltt}
-如果你觉得这样太冒险了,可以先尝试
-\begin{alltt}
-> \Ucom{tlmgr update -all -dry-run}
-\end{alltt}
-或
-\begin{alltt}
-> \Ucom{tlmgr update -list}
-\end{alltt}
-程序的完整文档:
-\begin{alltt}
-> \Ucom{tlmgr -help}
-\end{alltt}
-
-\section{有关 Windows 平台的说明}
-\label{sec:windows}
-
-\TL{} 拥有可运行于 Windows 和 Unix 平台的单一安装程序。当然,只有在放弃对
-较老版本 Windows 的支持的情况下,这才成为可能。因此,现在 \TL{} 只能安装
-于 Windows 2000 或更新的版本。
-
-
-\subsection{针对 Windows 的特征}
-\label{sec:winfeatures}
-
-在 Windows 下,安装程序额外地做了以下一些事情:
-\begin{description}
-\item[菜单与快捷方式。] 在开始菜单上加入了新的`\TL{}'程序菜单,主要是一些
-\GUI{} 程序 (如 \prog{tlmgr}、\prog{texdoctk}、PS\_View PostScript 预览程
-序) 和一些文档的菜单。PS\_View 还有一个桌面快捷方式,可以作为拖放 PostScript
-文件的目标。
-\item[自动设置环境变量。] 不再需要手动的配置步骤。
-\item[反安装程序。] 安装程序为 \TL{} 创建了`添加/删除程序'条目。这与
-\prog{tlmgr} 的删除按钮相对应。
-\end{description}
-
-\subsection{附加的软件}
-
-\begin{figure}[tb]
-\tlpng{psview}{.6\linewidth}
-\caption{PS\_View:可以获得很高的放大倍数!}\label{fig:psview}
-\end{figure}
-
-为了使安装更加完整,\TL{} 需要支持那些 Windows 机器上不常见的软件包。
-\TL{} 提供了以下缺失的部分:
-\begin{description}
-\item[Perl 和 Ghostscript。] 由于 Perl 和 Ghostscript 的重要性,\TL{}
-提供了这些程序的`隐藏'拷贝。需要这些软件支持的 \TL{} 程序知道它们的位置,
-但它们不会通过环境变量和注册表设置来暴露所在的位置。它们不是完整的发行
-版本,也不会与任何 Perl 或 Ghostscript 系统安装程序冲突。
-\item[命令行工具。] 与常见的 \TL{} 二进制文件一起,安装了一些常见的
-Unix 命令行工具的 Windows 移植版本。它们包括 \cmdname{gzip}、
-\cmdname{chktex}、\cmdname{jpeg2ps}、\cmdname{unzip}、\cmdname{wget}
-和来自于 \cmdname{xpdf} 套装中的一些命令行工具。(虽然 \cmdname{xpdf}
-浏览器本身没有 Windows 版本,但 Sumatra \acro{PDF} 浏览器是基于它的:
-\url{http://blog.kowalczyk.info/software/sumatrapdf}。)
-\item[\texttt{fc-cache}。] 有助于 \XeTeX{} 更有效率地处理字体。
-\item[PS\_View。] 同时安装的还有 PS\_View,一个具有自由许可证的全新的
-PostScript 浏览器;见图~\ref{fig:psview}。
-\end{description}
-\begin{description}
- \item[\texttt{support} 目录。] 在 \ref{sec:tld} 节提到过它。这个目录包括各种在
- \TeX{} 使用过程中非常有用的软件,主要是一些 \TeX{} 文件编辑器和 \TeX{}
- 前端。这具目录中的软件不受安装程序影响。同时,这个目录中还包括 \dvi{}
- 预览器 \cmdname{dviout};参见下一节的介绍。
-\end{description}
-
-\subsection{Dviout 预览器}
-
-不幸的是,\TL{} 发行版没有为 Windows 预装 \dvi{} 预览器。不过,你可以从
-\path{support/dviout/} 目录安装 Toshio Oshima 提供的
-\prog{dviout}。这个目录下包括了一份简短的 \filename{README},描述了如何为
-\TL{} 安装和配置 \prog{dviout}。请在安装前仔细阅读。
-
-当你第一次使用 \cmdname{dviout} 预览文件时,因为没有安装屏幕显示字体,它
-将生成字体。一段时间后,你所使用的大部分字体都将生成,随后,你将很少再看
-到生成字体的窗口。你可以从 (非常棒的) 在线帮助中获得更加详细的信息。
-
-\subsection{可下载的附加软件的链接}
-
-你可能考虑安装的其它工具的下载链接:
-\begin{description}
-\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/}
-\item[Perl] \url{http://www.activestate.com/},辅助的包可以从 \acro{CPAN}
-下载,\url{http://www.cpan.org/}
-\item[ImageMagick] \url{http://www.imagemagick.com},用于图像处理及转换
-\item[NetPBM] \url{http://netpbm.sourceforge.net/},同样用于图像
-
-\item[面向 \TeX 的编辑器] 有很大选择余地,通常是一个用户偏好的问题。下
-面是一些精选的编辑器,当然,没有依特定顺序排列:
- \begin{itemize*}
- \item \cmdname{GNU Emacs} 有 Windows 下可用的原生版本,参见 \url{http://www.gnu.org/software/emacs/windows/ntemacs.html}。
- \item 带 Auc\TeX{} 支持的 \cmdname{Emacs} 的 Windows 版本可在 \TL{} 下的 \path{support} 目录下找到;它的主页是 \url{http://www.gnu.org/software/auctex}。
- \item \cmdname{WinShell} 可以在 \TL{} 的 \path{support} 目录下找到。它的主页在 \url{http://www.winshell.de}。
- \item \cmdname{WinEdt} 是一个共享软件,可以从 \url{http://www.winedt.com} 获得。
- \item \cmdname{Vim} 是自由软件,可以从 \url{http://www.vim.org} 获得。
- \item TeXnicCenter 是自由软件,可以从 \url{http://www.toolscenter.org} 和 pro\TeX{}t 发行版中获得。
- \item \cmdname{LEd} 可以从 \url{http://www.ctan.org/support/LEd} 获得。
- \item \cmdname{SciTE} 可以从 \url{http://www.scintilla.org/SciTE.html} 获得。
- \end{itemize*}
-\end{description}
-
-
-\subsection{User Profile 目录相当于主目录}
-\label{sec:winhome}
-
-Windows 下对应于 Unix 下的主目录的是 \verb|%USERPROFILE%|。在 Windows XP
-和 Windows 2000 下,它通常位于 \verb|C:\Documents and Settings\<username>|;
-在 Windows Vista 下是 \verb|C:\Users\<username>|。通常情况下,在
-\filename{texmf.cnf} 文件和 \KPS{} 中,\verb|~| 在 Windows 和 Unix 下均可以
-进行合适的展开。
-
-
-\subsection{Windows 注册表}
-\label{sec:registry}
-
-Windows 将几乎所有的配置数据存放在注册表中。注册表是包含几个主支的一系
-列分层组织的分支。对于安装的程序而言,最重要的主支是 \path{HKEY_CURRENT_USER}
-和 \path{HKEY_LOCAL_MACHINE},通常简写为 \path{HKCU} 和 \path{HKLM}。注册表的
-\path{HKCU} 部分位于用户的主目录 (参见 \ref{sec:winhome} 节)。\path{HKLM}
-通常位于 Windows 目录的子目录中。
-
-在某些情况下,系统信息可以从环境变量获得,但对于其它信息,如快捷方式的位置,
-则需要访问注册表。设置永久环境变量也需要访问注册表。
-
-
-\subsection{Windows 权限}
-\label{sec:winpermissions}
-
-在较新的 Windows 版本中,普通用户与管理员是有区别的。只有管理员能自由访问
-整个操作系统。尽管如此,在实际中,作为受限用户与普通用户,你最能好能够描
-述所处的用户类别:作为一个管理员是惯例,而不是特例。无论如何,我们努力使得
-\TL{} 的安装不需要管理员权限。
-
-如果用户是管理员身份,安装程序将会为所有用户建立快捷方式,并且修改
-系统环境变量。否则,安装程序只为当前用户创建快捷方式,并改变用户环境变量。
-作为管理员,如果倾向于使用用户级设置,可以使用 \prog{install-tl} 的
-\optname{non-admin} 选项。
-
-无论管理员状态如何,\TL{} 预设的默认根目录总是位于 \verb|%PROGRAMFILES%|
-下。对于当前用户安装程序总是要测试,根目录是否可写。
-
-如果用户不是管理员,并且 \TeX{} 已经存在搜索路径中,则可能会出现问题。因为有效路径是由系统路径后接用户路径组成,新安装的 \TL{} 可能永远不会优先运行。在这种情况下,一个变通的方案是,安装程序为命令提示符创建快捷方式。在这个快捷方式中,新安装的 \TL{} 的可执行目录被预设于本地的搜索路径中。当从这个快捷方式启动命令行任务时,便可以使用新的 \TL{}。
-
-
-\section{Web2C 用户指南}
-
-\Webc{} 是一整套 \TeX{} 相关程序的集合:\TeX{} 本身、\MF{}、\MP{}、\BibTeX{},
-等等。它是 \TL{} 的核心。\Webc{} 的主页及最新的手册等都在
-\url{http://tug.org/web2c}。
-
-我们简单的介绍一下它的历史:最早它是由 Tomas Rokicki 在 1987 年实现的,他开发了第一套
-将 \TeX{} 系统的代码转换为 C 语言代码的系统,基于的是 Unix 下 change files
-的原理,change files 的
-工作是 Howard Trickey 和 Pavel Curtis 完成的。Tim Morgan 后来成为了这套系统的维护
-者,在这期间,软件的名称改为了 Web-to-C\@。在许多其他贡献者的帮助下,1990 年 Karl Berry
-接手了这个工作,到 1997 年,他把这项工作交给了 Olaf Weber。Olaf Weber 在 2006 年又
-把这项工作交还给了 Karl。
-
-\Webc{} 系统可以在 Unix、32 位 Windows 系统、\MacOSX{} 和其他的一些操作系统下运行。
-它使用的是 Knuth 用 \web{} 文学编程语言编写的 \TeX{} 和其他基本程序的原始代码,将其转换为 C
-源码。用这种方法处理的核心的 \TeX{} 程序包括:
-
-\begin{cmddescription}
-\item[bibtex] 维护参考文献。
-\item[dmp] 从 \cmdname{troff} 格式转换为 MPX (\MP{} 图片)。
-\item[dvicopy] 展开 \dvi{} 中的虚拟字体 (virtual font) 引用。
-\item[dvitomp] 将 \dvi{} 转换为 MPX (MetaPost 图片)。
-\item[dvitype] 将 \dvi{} 转换为可读文本。
-\item[gftodvi] 生成 Generic 格式字体的 proofsheet。
-\item[gftopk] 将 Generic 格式字体转换为 packed 格式字体。
-\item[gftype] 将 Generic 格式字体转换为可读文本。
-\item[makempx] 排版 \MP{} label。
-\item[mf] 创建字体。
-\item[mft] 以漂亮的方式排版输出 \MF{} 的代码。
-\item[mpost] 创建技术性插图。
-\item[mpto] 展开 \MP{} 的 label。
-\item[newer] 比较文件的修改时间。
-\item[patgen] 创建断字规则文件。
-\item[pktogf] 将 Packed 格式字体转换为 generic 格式字体。
-\item[pktype] 将 PK 格式转换为可读的文本。
-\item[pltotf] 将纯文本的 property list 转换为 TFM 格式。
-\item[pooltype] 显示 \web{} 的 pool 文件。
-\item[tangle] 将 \web{} 转换为 Pascal 代码。
-\item[tex] 排版。
-\item[tftopl] 将 TFM 格式转换为纯文本的 property list 格式。
-\item[vftovp] 将虚拟字体格式转换为 virtual property list 格式。
-\item[vptovf] 将 virtual property list 格式转换为虚拟字体格式。
-\item[weave] 将 \web{} 转换为 \TeX。
-\end{cmddescription}
-
-\noindent 这些程序的详细功能和调用语法都在其各自软件包的文档中有说明,在 \Webc{} 的文
-档中也有相关介绍。不过,有些规则对所有这些程序都是通用的,了解这些规则有助于你更好的使用
-\Webc{}。
-
-所有的程序都接受这些 \GNU 标准的选项:
-\begin{ttdescription}
-\item[-{}-help] 显示基本使用说明。
-\item[-{}-verbose] 显示详细的执行过程。
-\item[-{}-version] 显示版本信息,然后退出。
-\end{ttdescription}
-
-所有的 \Webc{} 程序均使用 \KPS{} (\url{http://tug.org/kpathsea}) 路径搜索库来查找文件,
-这套库结合环境变量和配置文件的
-使用来优化大量 \TeX{} 文件的搜索。\Webc{} 可以在多于一套的目录树下执行查找,这可以方
-便维护类似 \TeX{} 标准发行版和本地版本的扩展这样两套目录树。为了优化搜索的速度,每个目
-录树的顶层目录下都有一个 \file{ls-R} 文件,这个文件里包含了所有此目录下文件的名称和对
-应的相对路径。
-
-\subsection{Kpathsea 路径搜索}
-\label{sec:kpathsea}
-
-我们首先介绍一下 \KPS{} 库的的通用路径搜索方式。
-
-我们将目录名称称作\emph{路径元素},而把用冒号或者分号分隔的路径元素列表称
-作\emph{搜索路径}。搜索路径可能是许多种来源的组合,比如在 \samp{.:/dir} 路径下
-搜索 \samp{my-file} 这个文件,\KPS{} 将逐个尝试路径中的每个元素:首先是
-\file{./my-file},然后是 \file{/dir/my-file},并返回找到的第一个结果 (或者
-也可以返回所有的结果)。
-
-为了符合所有操作系统下的习惯,\KPS{} 在非 Unix 系统下使用的路径分隔符可能不是冒号
-(\samp{:}) 和斜杠 (\samp{/})。
-
-在检查一个具体的路径元素 \var{p} 时,\KPS{} 首先检查是否有符合 \var{p} 的文件名
-数据库 (见第 \pageref{sec:filename-database} 页的``文件名数据库'') 存在,也就是说,
-是否有数据库正好对应着 \var{p} 的一个前缀。如果存在,就在数据库中寻找符合的路径后缀。
-
-要是没有这种数据库存在、又或者所有的数据库都不能和指定的路径前缀匹配上、再或者找到的数
-据库里没有进一步的匹配,就要搜索文件系统了 (前提是我们没在路径前加上 \samp{!!} ,又
-或者搜索时就指定了这是一次``必定存在 (must exist)''型的搜索方式)。此时 \KPS{} 将
-根据路径元素构建一个需要检查的目录列表,逐个尝试这些目录,试图找到指定的文件。
-
-搜索 \samp{.vf} 文件和 \TeX{} 用 \cs{openin} 命令读入的文件时,会指定``文件必
-定存在 (must exist)''这个选项。而有些文件 (比如 \file{cmr10.vf}) 可能不存在,
-花费时间在磁盘上对它进行搜索是不值得的。因此,如果你安装了新的 \samp{.vf} 文件后没有
-更新 \file{ls-R},那这个文件将永远找不到。搜索时会优先在数据库寻找,然后再去搜索磁盘。
-一旦找到了就立即停止搜索,返回结果。
-
-尽管最简单也最常见的路径元素是目录名称,\KPS{} 搜索的路径里还是可以使用其他额外功能的:
-多层默认值,环境变量名称、配置文件值、用户主目录,以及递归式子目录查找。所以我们把 \KPS{}
-将搜索路径变换为一个或多个基本目录名的过程称为\emph{展开}路径元素的过程。展开的方式
-按执行的顺序在后续小节里有叙述。
-
-注意,如果搜索的文件给出了绝对路径或者明确的相对路径,即以 \samp{/} 或 \samp{./} 或
-\samp{../} 起始,\KPS{} 将只检查该文件是否存在。
-
-\ifSingleColumn
-\else
-\begin{figure*}
-\verbatiminput{examples/ex5.tex}
-\setlength{\abovecaptionskip}{0pt}
- \caption{一份示例性的配置文件的例子}
- \label{fig:config-sample}
-\end{figure*}
-\fi
-
-\subsubsection{路径的来源}
-\label{sec:path-sources}
-
-搜索路径可能来自许多地方,\KPS{} 是按照下面的顺序查找的:
-
-\begin{enumerate}
-\item
- 用户设置的环境变量,例如 \envname{TEXINPUTS}\@。以 . 连接某个程序名称的环境变量
-有更高的优先级,比如若正在运行的程序是 \samp{latex},那 \envname{TEXINPUTS.latex}
-将比 \envname{TEXINPUTS} 优先级更高。
-\item
- 专门针对某个程序的配置文件,比如 \cmdname{dvips} 的 \file{config.ps} 里出现
-\samp{S /a:/b} 这样一行。
-\item \KPS{} 配置文件 \file{texmf.cnf},包含类似
- \samp{TEXINPUTS=/c:/d} 这样的一行 (参见下面的解释)。
-\item 编译时的缺省值。
-\end{enumerate}
-\noindent 你可以通过调试选项看到所有的这些值 (参见第 \pageref{sec:debugging} 页的
-``调试操作'')。
-
-\subsubsection{配置文件}
-
-\begingroup\tolerance=3500
-\KPS{} 读入\emph{运行时配置文件} \file{texmf.cnf} 来获得搜索路径和其他定义。
-而这个 \file{texmf.cnf} 存放的路径则是在 \envname{TEXMFCNF} 变量里定义的,
-默认是在 \file{texmf/web2c} 目录下。搜索路径里\emph{所有的} \file{texmf.cnf}
-文件都会被读入,而先读入的优先级更高。所以,如果搜索路径是 \verb|.:$TEXMF|,那么
-文件 \file{./texmf.cnf} 里面的值要比 \verb|$TEXMF/texmf.cnf| 里边的优先。
-\endgroup
-
-\begin{itemize}
-\item
- 以 \code{\%} 表示单行注释。
-\item
- 忽略空行。
-\item
- 行末的 \bs{} 作为连接符,即把下一行直接接上。但保留下一行行首的空白。
-\item
- 所有剩余的行格式如下:
-\begin{alltt}
- \var{variable}[.\var{progname}] [=] \var{value}
-\end{alltt}%
- \samp{=} 号和空白都是可选的。
-\item
- \ttvar{variable} (变量) 允许包含任何字符,除空白、\samp{=}、\samp{.}
- 之外。不过只用 \samp{A-Za-z\_} 是最保险的。
-\item
- 如果 \samp{.\var{progname}} (程序名) 存在,则该定义只对正在运行的名叫
- \texttt{\var{progname}} 或 \texttt{\var{progname}.exe}
- 的程序起作用。这可以让给不同种类的 \TeX{} 程序设置不同的搜索路径。
-\item \var{value} (值) 允许任何 \code{\%} 与 \samp{@} 之外的字符出现。
- 不支持在等号右侧使用 \code{\$\var{var}.\var{prog}} 这样的写法。
- 如果在 Unix 下,\var{value} 中的 \samp{;}\ 字符会被转换为
- \samp{:}。如果你希望让 Unix, \acro{MS-DOS} 和 Windows 里都用同一个
- \file{texmf.cnf},这会很有用。
-\item
- 在读入所有定义后再开始展开,所以你可以引用后边才定义的变量。
-\end{itemize}
-展示上面所有内容的一段配置文件
-\ifSingleColumn
-如下:
-
-\verbatiminput{examples/ex5.tex}
-\else
-见图~\ref{fig:config-sample}.
-\fi
-
-\subsubsection{路径展开}
-\label{sec:path-expansion}
-
-和 Unix shell 类似,\KPS{} 能够识别搜索路径中的特殊字符。比如一个复杂的路径
-\verb+~$USER/{foo,bar}//baz+,将展开为这样的子目录:在 \texttt{\$USER}
-的主目录下的 \file{foo} 或 \file{bar} 目录中,且包含 \file{baz}
-文件或目录。这种展开将在下面解释。
-%$
-\subsubsection{默认展开}
-\label{sec:default-expansion}
-
-\tolerance=2500
-如果最高优先级 (参见第 \pageref{sec:path-sources} 页的``路径来源'')
-的搜索路径中包含一个\emph{额外的冒号} (即前置、后置或连续的冒号),\KPS{} 将在
-此处插入次高优先级的搜索路径。如果插入的那个路径里也有额外的冒号,同样的步骤将发生
-在更次以及优先级的路径上。假设环境变量设置为
-
-\tolerance=1500
-
-\begin{alltt}
-> \Ucom{setenv TEXINPUTS /home/karl:}
-\end{alltt}
-
-而 \file{texmf.cnf} 里的 \code{TEXINPUTS} 值为
-
-\begin{alltt}
- .:\$TEXMF//tex
-\end{alltt}
-
-则用于搜索的最终值为:
-
-\begin{alltt}
- /home/karl:.:\$TEXMF//tex
-\end{alltt}
-
-因为没必要插入多个相同的值,所以 \KPS{} 只会修改一个额外的 \samp{:},其他的不变。
-它首先检查前置的 \samp{:},然后是末尾的 \samp{:},最后是连续的 \samp{:}。
-
-\subsubsection{大括号展开}
-
-大括号展开是一项有用的特性,其作用是把 \verb+v{a,b}w+ 这样的转换为
-\verb+vaw:vbw+,允许嵌套使用。通过把 \code{\$TEXMF} 赋值为一个括号列表,
-可以构造出多套 \TeX{} 层级结构。例如在 \file{texmf.cnf} 里有下面的定义
-(这只是个近似的例子,实际情况定义的目录树还要更多):
-\begin{verbatim}
- TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN}
-\end{verbatim}
-这样一来,当你设置
-\begin{verbatim}
- TEXINPUTS = .;$TEXMF/tex//
-\end{verbatim}
-%$
-的时候,检查完当前目录后,依次检查的路径是
-\code{\$TEXMFHOME/tex}, \code{\$TEXMFLOCAL/tex}, \code{\$TEXMFVAR/tex}
-和 \code{\$TEXMFMAIN/tex} (后两个只在 \file{ls-R} 数据库中搜索)。这样维护
-两套并行的 \TeX{} 结构就很方便的,一套是``固定 (frozen)''的 (比如放在 \CD\ 上)
-而另一套是在新版本出现时就更新的。因为所有的定义里都用到了 \code{\$TEXMF},
-所以你可以确信时常更新的那个版本肯定是先被找到的。
-
-\subsubsection{子目录展开}
-\label{sec:subdirectory-expansion}
-
-在路径元素里的目录名称 \var{d} 后面接连使用两个或更多连续的斜杠,表示 \var{d} 的
-所有子目录:首先是直接处于 \var{d} 下的那些,然后是这些子目录的子目录,依此类推。
-每层的目录出现的顺序是\emph{不一定}的。
-
-如果你在 \samp{//} 后面还指定了文件名,匹配的将只是那些包含了指定文件的路径。
-比如 \samp{/a//b} 将展开为路径 \file{/a/1/b}, \file{/a/2/b},
-\file{/a/1/1/b} 等等,但不会展开为 \file{/a/b/c} 或 \file{/a/1}。
-
-可以在单个路径元素里使用多个 \samp{//},但出现在路径开头的 \samp{//}
-将被忽略。
-
-\subsubsection{特殊字符与其意义:简要说明}
-
-下面的列表总结了 \KPS{} 配置文件中出现的特殊字符:
-
-% need a wider space for the item labels here.
-\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
-\begin{ttdescription}
-\item[\CODE{:}] 路径分隔符,在路径的前边或者末尾时表示默认的展开方式。\par
-\item[\CODE{;}] 非 Unix 系统下的路径分隔符 (和 \code{:} 功能一样)。
-\item[\CODE{\$}] 变量展开。
-\item[\CODE{\string~}] 表示用户的个人主目录。
-\item[\CODE{\char`\{...\char`\}}] Brace expansion.
-\item[\CODE{//}] 子目录展开 (可以出现在除路径开头外的任意位置)。
-\item[\CODE{\%}] 注释的起始。
-\item[\CODE{\bs}] 连接下一行的字符 (以支持跨行的设置项)。
-\item[\CODE{!!}] \emph{只}在数据库中搜索文件,\emph{不}搜寻磁盘。
-\end{ttdescription}
-
-
-\subsection{文件名数据库}
-\label{sec:filename-database}
-
-\KPS{} 使用了一些方法来减少搜索时的磁盘访问次数。尽管如此,如果安装的文件足够多,在各
-个可能的目录下搜索某个文件仍然可能花上很长时间 (尤其是在必须遍历数百个字体目录的时候)。
-因此,\KPS{} 使用一个专门构建的纯文本``数据库''文件,这个文件叫做 \file{ls-R},它将
-文件和目录进行映射,避免对磁盘的大量搜索。
-
-第二个数据库 \file{aliases} 允许你给 \file{ls-R} 中的文件指定其他的名字。有助于
-帮助源文件符合 \acro{DOS} 8.3 命名规范。
-
-\subsubsection{文件名数据库}
-\label{sec:ls-R}
-
-前边已经解释过,主文件名数据库的名称必须是 \file{ls-R}。你可以在每个需要搜索的
-\TeX{} 目录树 (缺省是 \code{\$TEXMF}) 下放置一个这样的文件。\KPS{} 在
-\code{TEXMFDBS} 指定的路径中寻找这些 \file{ls-R} 文件。
-
-推荐使用发行版中包含的 \code{mktexlsr} 脚本来创建和维护 \samp{ls-R} 文件。各类
-\samp{mktex} 脚本也可能会间接调用这个脚本。实际上,这个脚本只是执行下面的命令:
-
-\begin{alltt}
-cd \var{/your/texmf/root} && \path|\|ls -1LAR ./ >ls-R
-\end{alltt}
-
-意味着你的系统的 \code{ls} 命令的输出格式必须正确 (\GNU \code{ls} 是没
-问题的)。要保证数据库及时更新,最简单的方法是定期通过 \code{cron} 来重建。
-
-如果文件在数据库中找不到,缺省情况下 \KPS{} 会在磁盘上搜索。如果某个特定的路径元素
-是以 \samp{!!} 起始的,就\emph{只会}在针对这一元素的数据库中查找而不搜索磁盘。
-
-
-\subsubsection{kpsewhich: 独立的路径搜索}
-\label{sec:invoking-kpsewhich}
-
-\texttt{kpsewhich} 程序将路径搜索从其他专用程序中独立出来,它可以作为类似 \code{find}
-一样的程序,专门在 \TeX{} 层级结构中定位文件 (这在发行版中的 \samp{mktex}\dots\
-脚本中使用得非常多)。
-
-\begin{alltt}
-> \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}}
-\end{alltt}
-\ttvar{option} 处的选项可以用 \samp{-} 也可以用 \samp{-{}-} 来起始,并接受
-任何不造成疑义的缩写。
-
-\KPS{} 将第一个非选项的参数作为文件名来查找,并返回找到的第一个文件。它不提供
-寻找所有相同名称文件的功能 (你可以使用 Unix 的 \samp{find} 程序来达到这个功能)。
-
-下面介绍了一些比较常见的选项。
-
-\begin{ttdescription}
-\item[\texttt{-{}-dpi=\var{num}}]\mbox{}
- 将解析度设置为 \ttvar{num},这个选项只影响 \samp{gf} 文件和 \samp{pk}
- 文件的查找。为了与 \cmdname{dvips} 兼容,提供 \samp{-D}
- 这个同义的参数,默认值是 600。
-
-\item[\texttt{-{}-format=\var{name}}]\mbox{}\\
- 将查找的文件格式设置为 \ttvar{name}。默认情况下是通过文件名来猜测格式的。对于扩展名
-有二义性的格式,比如 \MP{} 支持文件和 \cmdname{dvips} 配置文件,必须以 \KPS{} 已知
-的名称指定格式,比如 \texttt{tex} 或 \texttt{enc files}。运行
- \texttt{kpsewhich -{}-help} 会显示格式的列表。
-
-\item[\texttt{-{}-mode=\var{string}}]\mbox{}\\
- 设置模式为 \ttvar{string},只影响 \samp{gf} 和 \samp{pk}
- 文件的查找。默认情况匹配所有的模式。
-\item[\texttt{-{}-must-exist}]\mbox{}\\
- 尽一切可能找到文件,包括直接在磁盘上搜寻。默认情况下为了效率考虑,只检查
- \file{ls-R} 数据库里的内容。
-\item[\texttt{-{}-path=\var{string}}]\mbox{}\\
- 不通过文件名来猜测路径,沿 \ttvar{string} 指出的路径搜索
- (也使用冒号分隔)。支持 \samp{//} 和所有常见的展开方式。\samp{-{}-path} 选项
- 和 \samp{-{}-format} 选项是互斥的。
-\item[\texttt{-{}-progname=\var{name}}]\mbox{}\\
- 将执行查找的程序名称设为 \texttt{\var{name}}。
- 这会通过 \texttt{.\var{progname}} 特性影响搜索路径。
- 缺省值是 \cmdname{kpsewhich}。
-\item[\texttt{-{}-show-path=\var{name}}]\mbox{}\\
- 显示用于查找 \texttt{\var{name}} 类型文件的路径。和 \samp{-{}-format}
- 选项一样,可以使用扩展名 (\code{.pk}, \code{.vf}, 等等) 也可以使用全名。
-\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\
- 将调试选项 (等级) 设置为 \texttt{\var{num}}。
-\end{ttdescription}
-
-
-\subsubsection{使用举例}
-\label{sec:examples-of-use}
-
-现在我们看看实际使用 \KPS{} 的例子。这里是一个简单的搜索:
-
-\begin{alltt}
-> \Ucom{kpsewhich article.cls}
- /usr/local/texmf-dist/tex/latex/base/article.cls
-\end{alltt}
-我们寻找的是 \file{article.cls} 文件。因为 \samp{.cls} 后缀已经说明了文件的类型,所以
-我们不需要特别指明查找的是 \optname{tex} 类型的文件 (也就是要在 (\TeX{} 源文件目录下查找)。
-我们在 \samp{texmf-dist} 的 \file{tex/latex/base} 子目录下找到了这个文件。与之类似,
-下列所有文件都顺利找到,因为其扩展名没有二义。
-\begin{alltt}
-> \Ucom{kpsewhich array.sty}
- /usr/local/texmf-dist/tex/latex/tools/array.sty
-> \Ucom{kpsewhich latin1.def}
- /usr/local/texmf-dist/tex/latex/base/latin1.def
-> \Ucom{kpsewhich size10.clo}
- /usr/local/texmf-dist/tex/latex/base/size10.clo
-> \Ucom{kpsewhich small2e.tex}
- /usr/local/texmf-dist/tex/latex/base/small2e.tex
-> \Ucom{kpsewhich tugboat.bib}
- /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
-\end{alltt}
-
-另外,最后一个是 \textsl{TUGBoat} 文章的 \BibTeX{} 参考文献数据库。
-
-\begin{alltt}
-> \Ucom{kpsewhich cmr10.pk}
-\end{alltt}
-
-\file{.pk} 类型的字体位图文件是给 \cmdname{dvips} 或者 \cmdname{xdvi}
-这种显示程序提供的。因为 \TL{} 里没有预生成的 Computer Modern \samp{.pk}
-字体,所以没有找到任何内容\Dash \TL{} 默认使用 Type~1 版本的。
-
-\begin{alltt}
-> \Ucom{kpsewhich wsuipa10.pk}
-\ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
-\else /usr/local/texmf-var/fonts/pk/ljfour/public/
-... wsuipa/wsuipa10.600pk
-\fi\end{alltt}
-
-而这个字体 (Washington 大学的一套注音字母表) 就需要生成 \samp{.pk} 文件了。我们默认的
-\MF{} 模式是 \texttt{ljfour},基础解析度是 600\dpi{} (dots per inch),所以会得到这样一个文件。
-\begin{alltt}
-> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
-\end{alltt}
-
-一旦指明我们需要寻找的只是 300\dpi{} 的文件时 (\texttt{-dpi=300}),就会发现系统里
-没有符合要求的文件。这样 \cmdname{dvips} 或 \cmdname{xdvi} 会使用 \cmdname{mktexpk}
-脚本去创建所需的 \texttt{.pk} 文件。
-
-下面我们将注意力转向 \cmdname{dvips} 的头文件和配置文件。首先看看最常用的一个,\file{tex.pro}
-prologue 文件,然后检查通用配置文件 \file{config.ps} 和 \PS{} 字体映射文件
-\file{psfonts.map}\Dash 从 2004 年开始,映射文件和编码文件都在 \dirname{texmf}
-目录树下有其自己的搜索路径了。因为 \samp{.ps} 后缀可能会有二义,我们必须指明意思是
-\optname{dvips config}。
-
-\begin{alltt}
-> \Ucom{kpsewhich tex.pro}
- /usr/local/texmf/dvips/base/tex.pro
-> \Ucom{kpsewhich --format="dvips config" config.ps}
- /usr/local/texmf/dvips/config/config.ps
-> \Ucom{kpsewhich psfonts.map}
- /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map
-\end{alltt}
-
-这样我们可以更仔细地分析一下 \acro{URW} Times 的 \PS{} 支持文件。依照标准的字体
-命名方案,这些文件的前缀是 \samp{utm}。首先查询的是配置文件,其中包含的是 map
-文件的名称:
-
-\begin{alltt}
-> \Ucom{kpsewhich --format="dvips config" config.utm}
- /usr/local/texmf-dist/dvips/psnfss/config.utm
-\end{alltt}
-
-这个文件的内容是
-
-\begin{alltt}
- p +utm.map
-\end{alltt}
-
-即指向 \file{utm.map} 文件,也就是我们下一步要找的。
-
-\begin{alltt}
-> \Ucom{kpsewhich utm.map}
- /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
-\end{alltt}
-
-这个 map 文件定义了 URW 集合中的 Type~1 \PS{} 字体文件名。内容差不多是下边这样
-(我们只列出了其中一部分):
-
-\begin{alltt}
-utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
-utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
-utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
-utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
-\end{alltt}
-
-比如我们可以以一个 Times Roman 字体 \file{utmr8a.pfb} 为例,在 \file{texmf}
-目录下的 Type~1 字体文件中寻找它的位置:
-
-\begin{alltt}
-> \Ucom{kpsewhich utmr8a.pfb}
-\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
-\else /usr/local/texmf-dist/fonts/type1/
-... urw/utm/utmr8a.pfb
-\fi\end{alltt}
-
-现在你可以发现,追寻某个文件的下落是如此方便。尤其是在你怀疑找到的文件错了的时候,这些
-功能非常重要,因为 \cmdname{kpsewhich} 只能告诉你找到的第一个文件。
-
-\subsubsection{调试操作}
-\label{sec:debugging}
-
-有时你可能会需要分析程序是如何解析文件引用的。\KPS{} 提供了多层调试输出来实现这个功能:
-
-\begin{ttdescription}
-\item[\texttt{\ 1}] \texttt{stat} 调用 (磁盘上的查询)。在 \file{ls-R}
- 数据库及时更新的情况下几乎不会有什么输出。
-\item[\texttt{\ 2}] 对散列表的引用 (例如 \file{ls-R} 数据库,映射文件,配置文件)。
-\item[\texttt{\ 4}] 文件的打开与关闭操作。
-\item[\texttt{\ 8}] \KPS{} 搜索的文件类型的通用路径信息。有助于寻找针对某一文件的
-特定路径。
-\item[\texttt{16}] 每个路径元素的目录列表 (只在本地磁盘上搜索时有用)。
-\item[\texttt{32}] 文件搜索。
-\item[\texttt{64}] 变量的值。
-\end{ttdescription}
-等级 \texttt{-1} 将启用上述所有选项,实际上这是最方便的设置方法了。
-
-类似地,在 \cmdname{dvips} 程序中设置上述调试选项的组合,你就可以出 \cmdname{dvips}
-是从哪里找到它所需的文件的。另一方面,如果找不到某个文件,调试输出也会显示程序从哪些目录进行
-了查找,你也可以据此判断出问题出在哪里。
-
-一般而言,因为所有的程序都在其内部调用 \KPS{} 库,你可以设置 \envname{KPATHSEA\_DEBUG}
-环境变量来选择调试参数,将这个变量设置为上述参数的组合 (加法) 以获得对应的功能。
-
-(Windows 用户请注意:因为在 Windows 下不容易把所有信息都重定向到固定的文件中,为了方便诊断,
-你可以临时设置 \texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log})。
-
-让我们以一个简单的 \LaTeX{} 源文件 \file{hello-world.tex} 为例,其内容如下:
-\begin{verbatim}
- \documentclass{article}
- \begin{document}
- Hello World!
- \end{document}
-\end{verbatim}
-这个小文件只使用了 \file{cmr10} 字体,我们可以看看 \cmdname{dvips} 是如何生成 \PS{}
-文件的 (我们希望使用 Type~1 版本的 Computer Modern 字体,所以使用了 \texttt{-Pcms}
-参数)。
-\begin{alltt}
-> \Ucom{dvips -d4100 hello-world -Pcms -o}
-\end{alltt}
-此时我们将 \cmdname{dvips} 的调试等级 4 (表示字体路径) 和 \KPS\ 的路径元素展开组合到
-一起 (参见 \cmdname{dvips} 参考手册,\OnCD{texmf/doc/html/dvips/dvips_toc.html})。
-(稍作整理的) 输出见图~\ref{fig:dvipsdbga}。
-\begin{figure*}[tp]
-\centering
-\input{examples/ex6a.tex}
-\caption{寻找配置文件}\label{fig:dvipsdbga}
-
-\bigskip
-
-\input{examples/ex6b.tex}
-\caption{寻找 prolog 文件}\label{fig:dvipsdbgb}
-
-\bigskip
-
-\input{examples/ex6c.tex}
-\caption{寻找字体文件}\label{fig:dvipsdbgc}
-\end{figure*}
-
-\cmdname{dvips} 启动后就开始搜寻其需要使用的文件。首先找到的是 \file{texmf.cnf},
-它给出了用于进一步查询其他文件的路径,然后找到的是 \file{ls-R} 文件名数据库 (用于
-优化文件搜索速度) 和 \file{aliases} 文件 (用于创建同一文件的多个别名,比如为较自然
-的长文件名创建 \acro{DOS} 8.3 风格的短别名)。然后 \cmdname{dvips} 去寻找它的通用
-配置文件 \file{config.ps},接下来查找个人定制文件 \file{.dvipsrc} (不过上述例子中并
-未找到,显示 \emph{not found})。最后 \cmdname{dvips} 找到了 Computer Modern
-\PS{} 字体的配置文件 \file{config.cms} (因为执行 \cmdname{dvips} 时使用了
-\texttt{-Pcms} 选项)。这个文件里包含了字体的 \TeX{} 名称, \PS{} 名称和文件名的对
-应关系。
-
-\begin{alltt}
-> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
- p +ams.map
- p +cms.map
- p +cmbkm.map
- p +amsbkm.map
-\end{alltt}
-于是 \cmdname{dvips} 接下来寻找这些文件,再加上固定载入的,通用映射文件
-\file{psfonts.map} (这个文件里包含常用 \PS{} 字体的映射,参见第
-\ref{sec:examples-of-use} 节的最后一部分,讨论了 \PS{} 映射文件的处理)。
-
-这时候 \cmdname{dvips} 向用户表示它的存在:
-\begin{alltt}
-This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com)
-\end{alltt}
-\ifSingleColumn
-然后开始寻找 prolog 文件 \file{texc.pro}:
-\begin{alltt}\small
-kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
-\end{alltt}
-\else
-然后开始寻找 prolog 文件 \file{texc.pro} (见图~\ref{fig:dvipsdbgb})。
-\fi
-
-找到所需文件后,\cmdname{dvips} 输出日期和时间,并告知我们它将生成
-\file{hello-world.ps} 文件,需要用到 \file{cmr10} 字体文件,
-这个字体属于``常驻 (resident) 的'',也就是不需要载入位图文件的字体:
-\begin{alltt}\small
-TeX output 1998.02.26:1204' -> hello-world.ps
-Defining font () cmr10 at 10.0pt
-Font cmr10 <CMR10> is resident.
-\end{alltt}
-寻找并找到了 \file{cmr10.tfm} 文件。然后再次引用了一些 prolog 文件 (此处略去),
-最终找到了 \file{cmr10.pfb} 这个 Type~1 字体,并将它包含在输出文件中 (见最后
-一行)。
-\begin{alltt}\small
-kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
- path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
- /var/tex/fonts/tfm//).
-kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
-kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
- ...
-<texps.pro>
-kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
- path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
- ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
-kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
-<cmr10.pfb>[1]
-\end{alltt}
-
-\subsection{运行时选项}
-
-\Webc{} 另一项有用的特性是可以通过 \KPS{} 读入的运行时文件 \file{texmf.cnf}
-来控制一系列的内存参数 (具体而言是数组的大小)。内存的设置可以在这个文件的第三部分找到。
-比较重要的几个设置是:
-
-\begin{ttdescription}
-\item[\texttt{main\_memory}]
- 总的可用内存数,以 word 为单位,\TeX{}, \MF{} 和 \MP\ 受此限制。
- 每修改一次都必须重新生成一个新的格式文件。比如你可以生成一个``巨型''版本的
- \TeX{},将其存为 \texttt{hugetex.fmt}。
-\item[\texttt{extra\_mem\_bot}]
- 为``大型'' \TeX{} 数据结构预留的额外空间:boxes, glue, breakpoint 等。如果你使用
- \PiCTeX{} 时特别有用。
-\item[\texttt{font\_mem\_size}]
- \TeX{} 用于存储字体数据的 word 数。大致等于载入的所有 \acro{TFM} 文件的总和。
-\item[\texttt{hash\_extra}]
- 为存储控制序列而设置的散列表的额外空间。一般散列表足够存储将近 10,000
- 个控制序列。如果你排版的是一本有大量交叉引用的书籍,这个值可能不够用。默认的
- \texttt{hash\_extra} 是 \texttt{50000}。
-\end{ttdescription}
-
-\noindent 当然,这项功能并非真正的动态内存和数组分配的替代,但考虑到动态分配在现在的 \TeX{}
-太难实现,才通过这些选项提供了一些灵活性。
-
-\begin{comment}
-\section{在 Unix 平台下编译}
-
-If you have a platform for which executables are not included, you will
-need to compile \TeX{} and friends. This is not as hard as it
-sounds. What you need is all in the directory \texttt{source} in the
-distribution.
-
-\subsection{需求}
-
-You will need at least 100 megabytes of disk space to compile all of
-\TeX{} and its support programs. You'll also need an \acro{ANSI} C
-compiler, a \cmdname{make} utility, a lexical scanner, and a parser
-generator. We recommend the \GNU version of these programs
-(\cmdname{gcc}, \GNU \cmdname{make}, \cmdname{m4}, \cmdname{flex},
-\cmdname{bison}). You may be able to work with other C compilers and
-\cmdname{make} programs, but you will need a good understanding of
-building Unix programs to sort out problems.
-
-Also, the command \texttt{uname} must return a sensible value.
-
-
-\subsection{配置}
-
-To begin, perform a normal installation of \TL{} to your disk (see
-section~\ref{sec:install-disk} on
-\p.\pageref{sec:install-disk}). You may wish to skip installing
-all of the prebuilt binaries.
-
-Then, unpack the source from the compressed \texttt{tar} file in the
-directory \dirname{source} to your disk and change directory to where
-you placed it.
-
-Next, run \cmdname{configure} with a command line like this:
-\begin{alltt}
-> \Ucom{sh configure -prefix=/usr/local/TeX}
-\end{alltt}
-
-The \optname{-prefix} directory is the one where you installed the
-support tree; the directory layout will be as follows (where \$TEXDIR
-stands for the directory you chose):
-
-\noindent
-\begin{tabular}{>{\ttfamily}ll@{}}
- \dirname{$TEXDIR/share/texmf} & main tree with fonts,\\
- & \qquad macros, etc\\
- \dirname{$TEXDIR/man} & Unix manual pages\\
- \dirname{$TEXDIR/info} & \GNU style Info manuals\\
- \dirname{$TEXDIR/bin/$PLATFORM} & binaries\\
-\end{tabular}
-%$
-
-If you want to leave out the \dirname{$PLATFORM} directory level,
-i.e., put the binaries directly into \dirname{$TEXDIR/bin}, specify
-the \verb|--disable-multiplatform| option to \cmdname{configure}.
-
-Have a look at the output of \verb|./configure --help| for more
-options you can use. For example, you can skip building of \OMEGA{} and
-\eTeX{}.
-
-
-\subsection{运行 \cmdname{make}}
-
-Make sure the shell variable or option \texttt{noclobber} is not set.
-Then, run the main \cmdname{make} like this:
-\begin{alltt}
-> \Ucom{make world}
-\end{alltt}
-and relax\ldots
-
-Alternatively, you want to log all the output, as in:
-\begin{alltt}
-> \Ucom{sh -c "make world >world.log 2>\&1" \&}
-\end{alltt}
-
-Before you believe that everything went ok, please check the log file
-for errors: \GNU \cmdname{make} always uses the string \samp{***}
-whenever a command fails. Also, check if all the programs were built:
-
-\begin{alltt}
-> \Ucom{cd \var{TEXDIR}/bin/\var{archname}}
-> \Ucom{ls | wc}
-\end{alltt}
-The result should be over 200 (you can check the exact number with the
-\dirname{bin} directory contents in the distribution).
-
-If you need special privileges for \texttt{make install}, you can
-separate the \samp{make world} into two different runs, like this:
-\begin{alltt}
-> \Ucom{make all}
-> \Ucom{su}
-> \Ucom{make install strip}
-\end{alltt}
-
-After you've installed your new binaries, you should follow the normal
-post-installation procedures, given in section~\ref{sec:postinstall}
-(\p.\pageref{sec:postinstall}).
-
-Also, if you'd like to make your binaries available to others, please
-contact us. We'll be happy to put them on the \TL\ web pages.
-\end{comment}
-
-\section{致谢}
-
-\TL{} 是在几乎所有 \TeX{} 用户组织的协力下完成的。这个版本由 Karl Berry
-监制。下面列出了过去和现在主要的贡献者:
-
-\begin{itemize*}
-
-\item 英国、德国、荷兰和波兰的 \TeX{} 用户组织
-(分别为 \acro{TUG}, \acro{DANTE} e.V., \acro{NTG}, 和 \acro{GUST}),他们为所在
-地区的 \TeX{} 社群提供了必备的技术和管理基础设施。请加入本地的 \TeX 用户组织!
-(参见 \url{http://tug.org/usergroups.html}。)
-
-\item \acro{CTAN} 团队,特别值得一提的是 Robin Fairbairns, Jim Hef{}feron,
-和 Rainer Sch\"opf。他们负责分发 \TL{} 光盘镜像,为软件包更新提供支撑,\TL{}
-正是基于这些软件包构建的。
-
-\item Peter Breitenlohner 和 \eTeX\ 团队,他们创造了未来 \TeX\ 的稳定基础。
-同时特别感谢 Peter,他为整个 \TL 中 GNU autotools 的使用提供了主要的帮助。
-
-\item Thomas Esser,如果没有他优秀的 \teTeX{} 套件,\TL{} 根本不可能存在。
-
-\item Michel Goossens,他一起编写了原始的文档。
-
-\item Eitan Gurari,他不知疲倦地改进着的 \TeX4ht 程序用于创建这份文档的 \HTML{}
-版本。
-
-\item \Thanh, Martin Schr\"oder,和 pdf\TeX\ 团队,他们持续不断地改进 \TeX\
-的功能。
-
-\item Hans Hagen,他对 \ConTeXt\ 格式 (\url{http://pragma-ade.com}) 做了
-许多测试和修改,使之能够包含在 \TL{} 的框架下。
-
-\item Hartmut Henkel,他对 pdf\TeX\, Lua\TeX 等程序的开发起到了重要的贡献。
-
-\item Taco Hoekwater,他对 \MP{} 和 (Lua)\TeX\ (\url{http://luatex.org})
-的开发使之焕发新的活力。他还参与了将 \ConTeXt\ 融入 \TL 的工作。
-
-\item Pawe{\l} Jackowski,他创建了 Windows 下的安装程序 \cmdname{tlpm},
-和 Tomasz {\L}uczak,因为他的 \cmdname{tlpmgui} 被用在了以前的版本。
-
-\item Akira Kakuto,以他的 \acro{W32TEX} 发行版
-(\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}) 为基础提供了
-Windows 下的二进制文件,以及许多其他的贡献。
-
-\item Jonathan Kew 和 \acro{SIL},因为 Xe\TeX{} 是如此新颖而重大
-的改进。他还花了大量时间和精力来将其集成到 \TL{} 中。以及 Mac\TeX 安装程序
-的早期版本。
-
-\item Dick Koch 他维护了 Mac\TeX\ (\url{http://tug.org/mactex}) 这个和
-\TL{} 联系非常紧密的发行版本。
-
-\item Reinhard Kotucha,他对 \TL{} 2008 的基础架构和安装程序起到了重要贡献,
-以及 Windows 下的研究性工作,\texttt{getnonfreefonts} 脚本,等等。
-
-\item Siep Kroonenberg,也因为他对 \TL{} 2008 基础架构和安装程序的重要贡献,
-尤其是在 Windows 上。他还花了大量的时间更新手册,介绍了这些新的特性。
-
-\item Petr Ol\v{s}ak,他非常认真地协调和检查所有的捷克语和斯洛伐克语资料。
-
-\item Toshio Oshima,他提供了 Windows 下的 \cmdname{dviout} 预览工具。
-
-\item Manuel P\'egouri\'e-Gonnard,他对宏包更新、文档改进以及
-\cmdname{tldoc} 开发上的努力。
-
-\item Fabrice Popineau,他创建了 \TL{} 最早的 Windows 支持。
-
-\item Norbert Preining,他是 \TL{} 2008 基础架构和安装程序的总设计师,还
-负责协调了 Debian 版本的 \TL{} 工作 (和 Frank K\"uster 一起),并提供了许
-多建议。
-
-\item Sebastian Rahtz,他是 \TL{} 的创始者,并维护了它许多年。
-
-\item Vladimir Volovich,他很大地帮助解决了许多移植和维护的问题,尤其是令我们能够
-将 \cmdname{xindy} 包含进来。
-
-\item Staszek Wawrykiewicz,\TL{} 主要的测试人员,同时还是许多重要波兰语支持的协调
-人员:字体、Windows 安装,和其他许多工作。
-
-\item Olaf Weber,他对 \Webc{} 耐心的维护。
-
-\item Gerben Wierda,他创建和维护 \MacOSX\ 支持,并参与了大量集成和测试工作。
-
-\item Graham Williams,他整理了软件包的依赖情况的 \TeX\ Catalogue。
-
-\end{itemize*}
-
-二进制版本的编译者:
-Tigran Aivazian (\pkgname{x86\_64-linux}),
-Tim Arnold (\pkgname{hppa-hpux}),
-Randy Au (\pkgname{amd64-freebsd}),
-Edd Barrett (\pkgname{i386-openbsd}),
-Karl Berry (\pkgname{i386-linux}),
-Akira Kakuto (\pkgname{win32}),
-Dick Koch (\pkgname{universal-darwin}),
-Manfred Lotz (\pkgname{i386-freebsd}),
-Norbert Preining (\pkgname{alpha-linux}),
-Arthur Reutenauer (\pkgname{sparc-linux}),
-Thomas Schmitz (\pkgname{powerpc-linux}),
-Apostolos Syropoulos (\pkgname{i386-solaris}),
-Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-solaris}),
-Olaf Weber (\pkgname{mips-irix})。
-关于 \TL{} 编译进程的信息,请查阅 \url{http://tug.org/texlive/build.html}。
-
-文档和翻译的更新:
-Karl Berry (英语),
-Daniel Flipo (法语),
-Klaus H\"oppner (德语),
-Petr Sojka \& Jan Busa (捷克\slash 斯洛伐克语),
-Boris Veytsman (俄语),
-Staszek Wawrykiewicz (波兰语)。\TL{} 文档的主页是
-\url{http://tug.org/texlive/doc.html}。
-
-当然,最重要的感谢应该致予 Donald Knuth,感谢他发明了 \TeX,也感谢他将
-\TeX\ 赠与全世界。
-
-\section{发行历史}
-\label{sec:history}
-
-\subsection{过去}
-
-1993 年末荷兰 \TeX{} 用户组开始为 \acro{MS-DOS} 用户开发 4All\TeX{} \CD{} 时,
-我们就开始了相关的讨论,并希望在此时为所有的操作系统提供一个单一的、合理的 \CD{}。当时
-那是一个过于宏伟的目标,但的确滋生了非常成功的 4All\TeX{} \CD{},同时 \acro{TUG}
-技术委员会工作组也开始设计 \emph{\TeX{} 目录结构} (\url{http://tug.org/tds}),
-以指明如何创建一套一致而可控的集合,囊括所有 \TeX{} 相关的文件。\TDS{} 的完整草案在 1995
-年 12 月的 \textsl{TUGboat} 上出版,并初步确定期望的产品将是在 \CD{} 上出现的范例
-结构。你现在使用的这个发行版正是工作组审议的直接结果。4All\TeX{} \CD{} 的成功也说明
-如果有一个类似这样的易于使用的系统,对 Unix 用户肯定很有帮助,这是 \TL{} 最主要的出发点。
-
-我们在 1995 年秋天开始尝试构建一个新的 \CD{} (基于 \TDS{}),并很快发现 Thomas Esser
-的 \teTeX{} 已经是比较理想的配置,并因为在它构建时就已经考虑了跨文件系统的兼容性问题,
-也已具有多平台支持。Thomas 同意帮助我们,并在 1996 年初开始了正式的工作。第一版是在
-1996 年五月发行的。到 1997 年初,Karl Berry 完成了 \Webc{} 的一个重大的更新版本,
-将几乎所有 Thomas Esser 加入 \teTeX{} 的特性囊括在内,这样我们决定在 \teTeX{} 的
-\texttt{texconfig} 脚本的辅助下,基于标准的 \Webc{} 来制作第二版的 \CD{}。
-第 3 版的 \CD{} 基于 Olaf Weber 完成的 \Webc{} 的一个重大修正版本,7.2。与此同时,
-\teTeX{} 的一个新版本出现了,\TL{} 也包含了其中绝大多数特性。第 4 版依照上面的模式进
-行,使用了新版本的 \teTeX{} 和新版本的 \Webc{} (7.3)。系统此时也包括了完整的 Windows
-下的配置。
-
-在第 5 版 (2000 年 3 月) 中检查并修正了 \CD{} 的许多部分,更新了数百个软件包。软件
-包的详细说明现在存放在 XML 文件中。不过 \TeX\ Live 5 的首要变化还是移除了所有的非自由软
-件。\TL{} 的所有部分现在都在向 Debian Free Software Guidelines 兼容的方向改进,
-我们尽最大努力检查了所有软件包的授权协议,欢迎为我们指出错误。
-
-第 6 版 (2001 年 7 月) 更新了许多内容。最重大的一项是新的安装形式,用户可以更精确
-地选择所需的软件集合。与语言相关的集合也重新组织过了,这样一来,选定某个语言集合时会自
-动安装宏包、字体等文件,并自动设置好 \texttt{language.dat}。
-
-2002 年出现的第 7 版里显著的更新是添加了 \MacOSX{} 的支持,还有大量各类宏包和程序
-的更新。这个版本的一个重要的目标是将源代码重新与 \teTeX{} 集成,因为在第 5 和第 6
-版中它们偏离得太远了。
-
-\subsubsection{2003}
-
-2003 年,在更新和增添持续不断到来的情况下,我们发现 \TL{} 已经过于庞大,无法在一张
-\CD\ 中容纳,于是将其切分为三套不同的发行版 (参见第~\ref{sec:tl-coll-dists}
-节,\p.\pageref{sec:tl-coll-dists})。此外:
-
-\begin{itemize*}
-\item 在 \LaTeX{} 团队的要求下,我们将 \cmdname{latex} 和 \cmdname{pdflatex}
- 命令改为使用 \eTeX{} 引擎 (参见 \p.\pageref{text:etex})。
-\item 包含了新的 Latin Modern 字体 (并推荐使用)。
-\item 因为不再有人拥有 (或主动提供) 用于编译新的二进制程序的硬件,去除了
- Alpha \acro{OSF} 的支持 (先前已经去除了 \acro{HPUX} 的支持)。
-\item Windows 下的安装有很大改变,首次提供了基于 XEmacs 的集成环境。
-\item Windows 下重要的辅助性程序 (Perl, Ghost\-script, Image\-Magick, Ispell)
- 现在放在 \TL{} 的安装目录。
-\item \cmdname{dvips}, \cmdname{dvipdfm} 和 \cmdname{pdftex}
- 使用的字体映射文件现在通过 \cmdname{updmap} 这套新程序生成,并安装到
- \dirname{texmf/fonts/map} 目录下。
-\item \TeX{}, \MF{}, 和 \MP{} 现在缺省直接输出大多数的输入字符 (位置 32 及其以上)
- (比如通过 \verb|\write|),包括输出到文件、日志和终端上。也就是说,\emph{不再}使用
- \verb|^^| 标记来转换。在 \TL{}~7 中是否转换根据系统区域 (locale)
- 设置而定,而这一版里 locale 设置不再影响 \TeX{} 程序的行为,所以如果你需要
- \verb|^^| 形式的输出,请将 \verb|texmf/web2c/cp8bit.tcx|
- 文件改名。(后续版本将提供更简洁的方式来控制。)
-\item 对文档作了大量更新。
-\item 最后,因为版本号增长得实在太快,现在简单地使用年份来标识版本:\TL{} 2003。
-\end{itemize*}
-
-
-\subsubsection{2004}
-
-2004 年有许多改变:
-
-\begin{itemize}
-
-\item 如果你在本地安装的字体时涉及了 \filename{.map} 或 \filename{.enc}
-(附带这种文件的可能性很小) 辅助文件,可能需要转移这些文件的位置。
-
-现在根据 \envname{TEXFONTMAPS} 变量中的路径设置,只在 (所有 \filename{texmf}
-目录树下的) \dirname{fonts/map} 子目录下搜索 \filename{.map}
-文件。与之类似,\filename{.enc} 文件现在只在 \dirname{fonts/enc}
-目录下搜索,根据 \envname{ENCFONTS} 变量中的路径设置。如果遇到有问题的文
-件,\cmdname{updmap} 会提出警告。
-
-关于这种搜索方式的其他信息,请参见 \url{http://tug.org/texlive/mapenc.html}。
-
-\item 因为有人可能更愿意使用 \MIKTEX\ 而非 \Webc{} 系统,\TK\
-现在包含了一套基于 \MIKTEX\ 的可安装 \CD,参见第~\ref{sec:overview-tl} 节
-(\p.\pageref{sec:overview-tl})。
-
-\item 在原来旧版本 \TL\ 中单一的 \dirname{texmf} 目录树被分拆为三
-个:\dirname{texmf}, \dirname{texmf-dist}, 和 \dirname{texmf-doc}。参见
-第~\ref{sec:tld} 节 (\p.\pageref{sec:tld}) 及各目录下的 \filename{README}
-文件。
-
-\item 所有 \TeX\ 输入文件现在统一收集到了 \dirname{texmf*} 下的
-\dirname{tex} 子目录中,不再分散在各个 \dirname{tex}, \dirname{etex},
-\dirname{pdftex}, \dirname{pdfetex} 目录。见~
-\CDref{texmf-doc/doc/english/tds/tds.html\#Extensions}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Extensions}}。
-
-\item 辅助性脚本 (并非直接提供给用户调用的) 现在放在 \dirname{texmf*} 目录树下
-新的 \dirname{scripts} 子目录中,并可以通过 \verb|kpsewhich -format=texmfscripts|
-来搜索。如果你的程序调用了这些脚本,必须修改路径。参见
-\CDref{texmf-doc/doc/english/tds/tds.html\#Scripts}
-{\texttt{texmf-doc/doc/english/tds/tds.html\#Scripts}}。
-
-\item 几乎所有格式,都用 \filename{cp227.tcx} 这个转换文件将大多数的可见 (printable)
-字符保留下来,而不再使用 \verb|^^| 标识来转换这些字符。具体而言,在位置 32--256 的
-字符,加上 tab, vertical tab, 和 form feed 字符都作为可见字符而不再转换。例外情况是
-plain \TeX\ (只将位置 32--126 的字符视为可见), \ConTeXt\ (0--255 都视为可见) 和与
-\OMEGA\ 相关的格式。缺省的情况几乎与 \TL\,2003 完全一致,但通过更简洁的方式实现,并允许
-更多定制。参见 \CDref{texmf/doc/web2c/web2c.html\#TCX-files}
-{\texttt{texmf/doc/web2c/web2c.html\#TCX-files}}。
-(另外,如果遇到 Unicode 输入,\TeX\ 可能会在显示错误上下文时输出半个字符,因为它是基于
-字节流来处理输入的。)
-
-\item \textsf{pdfetex} 现在是除 (plain) \textsf{tex} 外所有格式的默认引擎 (当然
-以 \textsf{latex} 这种方式运行时它还是生成 \acro{DVI})。这样一来,至少 \textsf{pdftex}
-的微调排版 (microtypographic) 技术可以在 \LaTeX, \ConTeXt 等格式中使用,另外 \eTeX\
-的特性也包含在其中 (\OnCD{texmf-dist/doc/etex/base/})。
-
-这还说明\emph{比以前任何时候都更有必要}使用 (对 plain 和 \LaTeX\ 都适用的)
-\pkgname{ifpdf} 宏包或其类似代码,因为只检查 \cs{pdfoutput} 或其他原语是否已经定义
-不再是判断是否处于 \acro{PDF} 输出状态的可靠方法。我们在这一年尽可能地保持向下兼容,但以后
-即使在输出 \acro{DVI} 时 \cs{pdfoutput} 也可能已经定义。
-
-\item pdf\TeX\ (\url{http://pdftex.org}) 新增了许多特性:
-
- \begin{itemize*}
-
- \item 可以使用 \cs{pdfmapfile} 和 \cs{pdfmapline} 来在单独文档内指定字体映射文件。
-
- \item 可以更方便地使用排版微调 (Microtypographic) 和字体延展 (font expansion)
- 技术了。\\
- \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}
-
- \item 原来使用专有格式的配置文件 \filename{pdftex.cfg} 里的选项现在都必须改用
- \TeX{} 原语来设置,通常放在 \filename{pdftexconfig.tex} 里面,不再支持
- \filename{pdftex.cfg} 的配置方式。每次修改 \filename{pdftexconfig.tex}
- 之后都必须重新生成 \filename{.fmt} 文件。
-
- \item 参见 pdf\TeX\ 手册以了解更多信息:\OnCD{texmf/doc/pdftex/manual}。
-
- \end{itemize*}
-
-\item \cmdname{tex} (以及 \cmdname{mf} 和 \cmdname{mpost}) 中的 \cs{input}
-原语现在支持通过双引号来引用包含空格和特殊字符的文件。一个典型的例子如下:
-\begin{verbatim}
-\input "filename with spaces" % plain
-\input{"filename with spaces"} % latex
-\end{verbatim}
-参阅 \Webc{} 文档以了解更多信息:\OnCD{texmf/doc/web2c}。
-
-\item enc\TeX\ 的支持现在已被包含在 \Webc{} 中,因而所有 \TeX\ 程序都可以通过
-\optname{-enc} 参数启用这一支持 \Dash \emph{前提是构建好了格式文件}。enc\TeX\
-提供了对输入输出通用的重新编码功能,实现对 Unicode (以 \acro{UTF}-8 编码的形式)
-的完整支持。参见 \OnCD{texmf-dist/doc/generic/enctex/} 和
-\url{http://www.olsak.net/enctex.html}。
-
-\item 提供了 Aleph 这套新的 \TeX{} 引擎,它将 \eTeX\ 和 \OMEGA\ 合并到了一起。
-关于 Aleph 的部分信息可以在 \OnCD{texmf-dist/doc/aleph/base}
-和 \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph} 找到。Aleph
-的 \LaTeX 格式文件称做 \textsf{lamed}。
-
-\item 最新发布的 \LaTeX\ 包含了是新版的 \acro{LPPL} 授权协议\Dash 这一协议已被
-Debian 首肯。\LaTeX\ 其他的更新请见 \OnCD{texmf-dist/doc/latex/base} 下的
-\filename{ltnews} 文件。
-
-\item 包含了一个叫做 \cmdname{dvipng} 的新程序,用于将 \acro{DVI} 转换为
-\acro{PNG} 图像文件。参见 \OnCD{texmf/doc/man/man1/dvipng.1}。
-
-\item 我们在作者 (Claudio Beccari) 的同意下,将 \pkgname{cbgreek} 包含的
-字体数量减少到中等。去除了不可见、轮廓和透明版本的字体,这些字体几乎很少用到。而我们
-的光盘镜像需要空间。完整版本当然还是在 \acro{CTAN} 提供
-(\url{http://www.ctan.org/tex-archive/fonts/greek/cb})。
-
-\item 去掉了 \cmdname{oxdvi},改为只使用 \cmdname{xdvi}。
-
-\item 不再为 \cmdname{tex}, \cmdname{mf}, 和 \cmdname{mpost} 程序创建
-\cmdname{ini} 和 \cmdname{vir} 开头的命令链接,比如
-\cmdname{initex}。\cmdname{ini} 的功能早在几年前就通过 \optname{-ini}
-命令行参数提供了。
-
-\item 去掉了 \textsf{i386-openbsd} 平台的支持。因为在 \acro{BSD} Ports
-系统中已经包含了 \pkgname{tetex} 软件包,而 \acro{GNU/}Linux 和
-Free\acro{BSD} 下的二进制版本都已存在,所以志愿者的时间可以花在其他的地方了。
-
-\item 至少在 \textsf{sparc-solaris} 平台下,你必须设置好
-\envname{LD\_LIBRARY\_PATH} 环境变量才能执行 \pkgname{t1utils} 包含的程序。
-因为这些程序是使用 C++ 编写的,其运行时库没有固定的位置。(这一情况并非在 2004 版
-中首次出现,但现在才写入文档) 与之类似,\textsf{mips-irix} 平台下需要用到
-\acro{MIPS}pro 7.4 运行时库。
-
-\end{itemize}
-
-\subsubsection{2005}
-
-2005 年一如往常,宏包和程序都有大量的更新。底层结构和 2004 年相比保持了稳定,
-不过仍然存在一些变化。
-
-\begin{itemize}
-
-\item 引入了新的 \cmdname{texconfig-sys}, \cmdname{updmap-sys}, 和
- \cmdname{fmtutil-sys} 安装脚本,用于修改系统目录树下的配置。而原有的
- \cmdname{texconfig}, \cmdname{updmap}, 和 \cmdname{fmtutil}
- 则用于修改针对单个用户的文件 (放在 \dirname{$HOME/.texlive2005}
- 目录下的)。
-
-\item 增加了对应的 \envname{TEXMFCONFIG} 和 \envname{TEXMFSYSCONFIG}
- 变量,分别用于设置针对用户和系统的,专门存放配置文件的目录树。所以你需要将个人使用的
- \filename{fmtutil.cnf} 和 \filename{updmap.cfg}
- 放到合适位置。不过还有一种方法是在 \filename{texmf.cnf} 里边重新定义
- \envname{TEXMFCONFIG} 或 \envname{TEXMFSYSCONFIG}
- 变量。无论如何,这两个值对应的实际目录都必须正确存在。参见第
- \pageref{sec:texmftrees} 页的第 \ref{sec:texmftrees} 节。
-
-\item 虽然我们在上一年就已经使用了 \cmdname{pdfetex} 作为输出程序,但在它输出 \dvi\
- 格式时会禁用 \verb|\pdfoutput| 等原语
- (primitive)。这一年,我们按照预期计划取消了这一兼容性限制。所以,如果你的文档里使用了
- \verb|\ifx\pdfoutput\undefined| 这样的语句来判断是否正在 PDF
- 输出模式下,现在就必须修改了。你可以使用 \pkgname{ifpdf.sty} 宏包 (对 plain \TeX\
- 和 \LaTeX{} 都适用) 来判断,或者仿照这个文件里的判断原理自己写一个。
-
-\item 上一年,我们将格式文件的输出改成了和这些文件本身一样的 8
- 位字符。在你需要的情况下,可以使用新的 TCX 文件 \filename{empty.tcx} 来获得原有的
- \verb|^^| 表示方式。例如:
-
-\begin{verbatim}
-latex --translate-file=empty.tcx yourfile.tex
-\end{verbatim}
-
-\item 新增了用于转换 DVI 为 PDF 的 \cmdname{dvipdfmx} 程序,这是
- \cmdname{dvipdfm} 的一个比较活跃更新的版本 (我们仍然提供
- \cmdname{dvipdfm},但不建议你继续使用)。
-
-\item 新增了叫 \cmdname{pdfopen} 和 \cmdname{pdfclose} 的两个程序,用于控制
- Adobe Acrobat\slash Reader 在不重启程序的情况下重新载入 pdf 文件。(其他的
- pdf 阅读器,如 \cmdname{xpdf}, \cmdname{gv}, 和
- \cmdname{gsview},都不会遇到这个问题。)
-
-\item 为了保持一致性,将 \envname{HOMETEXMF} 和 \envname{VARTEXMF}
- 环境变量分别更名为 \envname{TEXMFHOME} 和
- \envname{TEXMFSYSVAR}。还有一个针对单独用户的 \envname{TEXMFVAR}
- 环境变量可用。参见上面的第一点。
-
-\end{itemize}
-
-
-\subsubsection{2006--2007}
-
-2006--2007 年,\TL{} 的一个重大变化是增加了 \XeTeX{},以 \texttt{xetex} 和
-\texttt{xelatex} 程序的形式提供。请参见 \url{http://scripts.sil.org/xetex}。
-
-\MP{} 也有可观的更新,并计划在未来实现更多的改进
-(\url{http://tug.org/metapost/articles}),pdf\TeX{} 同样如此
-(\url{http://tug.org/applications/pdftex})。
-
-\TeX\ \filename{.fmt} (缓存格式) 文件和用于 MetaPost 和 \MF\ 的类似文件
-现在存储在 \dirname{texmf/web2c} 的子目录中而不直接放在 \dirname{texmf/web2c}
-目录下 (不过考虑到现有的 \filename{.fmt} 文件,直接放置在这个目录下的文件仍然
-能被搜索到)。子目录的名称是根据当前使用的``引擎''决定的,比如 \filename{tex}
-或 \filename{pdftex} 或 \filename{xetex}。这个变化不会对日常使用带来任何
-影响。
-
-(plain) \texttt{tex} 程序不再通过读取 \texttt{\%\&} 开头的第一行来决定
-执行何种格式,而遵循纯粹的 Knuth 风格 \TeX\ 的传统。(\LaTeX\ 和其他所有的程序
-仍然读取 \texttt{\%\&} 开头的行。)
-
-当然,和往常一样,这一年里你能看到成百上千的宏包与程序得到更新。也和往常一样,
-进一步的更新请使用 \acro{CTAN} (\url{http://www.ctan.org})。
-
-从内部角度上看,源代码树现在改为使用 Subversion 管理,并在我们的主页上提供了
-到 Web 界面的链接,用于浏览代码树。我们希望它能成为未来几年中稳定的开发
-平台。
-
-末了,2006 年五月 Thomas Esser 宣布他将停止 te\TeX{}
-(\url{http://tug.org/tetex}) 的更新。这样一来,大家对 \TL{} 的兴趣大增,尤其是在
-\GNU/Linux 发行版中。(\TL{} 提供了一套新的 \texttt{tetex} 安装方案,
-几乎和原有的 te\TeX{} 毫无二致。) 我们希望这些变化将最终转换为对整个 \TeX\
-环境的改进,从而每个人都会受益。
-
-\medskip \noindent
-对过去历史的最终一点提示: 所有版本的 \TL{},包括 \CD\ 标签这些附属材料,都在
-\url{ftp://tug.org/historic/systems/texlive} 提供。
-
-
-\subsection{现状}
-\label{sec:tlcurrent}
-
-在 2008 年,整个 \TL{} 的基础架构都重新设计过并重新实现了。安装的完整
-信息被存放在 \filename{tlpkg/texlive.tlpdb} 这个纯文本文件中。
-
-除了许多其他的功能外,我们终于可以通过 Internet 在安装后更新 \TL{}
-了,这是 MiK\TeX\ 早已提供了许多年的特性。我们希望能定期更新 \CTAN 上
-新发布的软件包。
-
-包含了一个重要的新引擎 Lua\TeX\ (\url{http://luatex.org}),除了
-在排版上灵活性更上一层楼以外,它还提供了一个优秀的脚本语言供 \TeX\
-文档内外使用。
-
-对 Windows 和基于 Unix 系统的支持现在要一致得多了。尤其是大部分 Perl 和
-Lua 脚本都能在 Windows 下使用,通过 \TL 内部包含的 Perl。
-
-新的 \cmdname{tlmgr} 脚本 (第 \ref{sec:tlmgr} 节) 是在初始安装后管理
-\TL{} 的通用界面。它处理了软件包更新和后续的格式文件、map 文件和语言文件
-的重新生成,并可选地包含了本地添加的内容。
-
-随着 \cmdname{tlmgr} 到来,禁用了 \cmdname{texconfig} 中编辑格式和
-断字配置文件的功能。
-
-今年还提供了大多数平台的 \cmdname{xindy} 索引生成程序
-(\url{http://xindy.sourceforge.net})。
-
-\cmdname{kpsewhich} 现在可以报告给定文件的所有匹配 (\optname{--all}
-参数) 并限制列出特定目录下的匹配 (\optname{--subdir} 参数)。
-
-\cmdname{dvipdfmx} 程序现在支持用 \cmdname{extractbb} 命令来解析
-bounding box 信息,这是 \cmdname{dvipdfm} 包含但未曾出现在
-\cmdname{dvipdfmx} 中的最后一个功能。
-
-去除了 \filename{Times-Roman}, \filename{Helvetica} 等字体别名。不同的
-宏包对它们的理解不同 (尤其是编码的处理不一样),所以没有什么好的办法能解
-决。
-
-去除了 \pkgname{platex} 格式文件,以避免与日文 \pkgname{platex} 的命名
-冲突,\pkgname{polski} 宏包现在被用作主要的波兰语支持。
-
-从内部而言 \web\ 字符串 pool 文件被编译进了二进制文件中,这样可以方便
-升级。
-
-最终 Donald Knuth 在他的 `\TeX\ tuneup of 2008' 中的更新也被包含在这次
-发布中。参见 \url{http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf}。
-
-\subsection{未来}
-
-\emph{\TL{} 并不完美!} (也永远不会达到完美。) 我们希望继续发行新的版本,也希望
-提供更多的帮助文档、更多的实用程序、更多的安装程序,当然还有更多更新的宏包与字体。这个
-工作是由压力巨大的志愿者在其空闲时间完成的,也有很多不够完善的地方。请参见
-\url{http://tug.org/texlive/contribute.html}。
-
-请把更正、建议或者提供帮助的意愿发送到:
-\begin{quote}
-\email{tex-live@tug.org} \\
-\url{http://tug.org/texlive}
-\end{quote}
-
-\medskip
-\noindent \textsl{祝你使用 \TeX\ 愉快!}
-
-\section{翻译说明}
-
-这里对简体中文版本《\TL{} 指南》,即本文档中遵循的翻译惯例作一简要说明:
-
-\begin{itemize}
-
-\item package, 视上下文,有时翻译为软件包,有时翻译为宏包。
-\item format file, 即 \TeX{} 程序一般都会预载入的 \texttt{.fmt}
-文件。本文档中翻译为格式文件。
-\item scheme, 本文档中译为 (安装) 方案。
-\item collection, 本文档中译为 (软件) 集合。
-\item 本文档中有时对原文没有采用逐字逐句的对比翻译,而是总括其意思,转换为
-更易为中文 \TeX{} 用户习惯的表达方式。
-\item architecture/platform, 是意思比较相近的词,基本上是只某种 CPU
-和对应这个 CPU 的操作系统。比如 i386-linux。本文里翻译为架构、平台、体系
-结构等等。
-\item binary, 二进制文件,其实就是说可执行程序文件和库文件了。
-
-\end{itemize}
-
-2007 年的简体中文版本由 Jiang Jiang, Jinsong Zhao, Yue Wang,
-Helin Gai 翻译。其中 Jinsong Zhao 负责 Windows 部分的翻译,Yue Wang
-和 Helin Gai 进行了校对,Jiang Jiang 则负责其余的翻译和统稿。
-
-2008 年的简体中文版本由 Jiang Jiang, Yue Wang 和 Jinsong Zhao 翻译。
-
-\end{document}