diff options
author | Siep Kroonenberg <siepo@cybercomm.nl> | 2008-07-05 19:48:35 +0000 |
---|---|---|
committer | Siep Kroonenberg <siepo@cybercomm.nl> | 2008-07-05 19:48:35 +0000 |
commit | deffcda0da0aea0fe97410eabe8f00c99b76a6fe (patch) | |
tree | 010e9ceccb78bd9008617c9fa91103bc026fddbd /Master | |
parent | 659f80c2e524fb2a939fb42e8383ec4f0947f3ec (diff) |
Updated chapters 1 and 2 of live.tex
git-svn-id: svn://tug.org/texlive/trunk@9277 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r-- | Master/texmf-doc/doc/english/texlive-en/live.css | 76 | ||||
-rw-r--r-- | Master/texmf-doc/doc/english/texlive-en/live.html | 1452 | ||||
-rw-r--r-- | Master/texmf-doc/doc/english/texlive-en/live.pdf | bin | 789887 -> 792772 bytes | |||
-rw-r--r-- | Master/texmf-doc/source/english/texlive-en/installation.tex | 172 | ||||
-rw-r--r-- | Master/texmf-doc/source/english/texlive-en/intro.tex | 123 | ||||
-rw-r--r-- | Master/texmf-doc/source/english/texlive-en/live.tex | 2 | ||||
-rw-r--r-- | Master/texmf-doc/source/english/texlive-en/macosx.tex | 4 | ||||
-rw-r--r-- | Master/texmf-doc/source/english/texlive-en/maintenance.tex | 213 | ||||
-rw-r--r-- | Master/texmf-doc/source/english/texlive-en/overview.tex | 86 | ||||
-rw-r--r-- | Master/texmf-doc/source/english/texlive-en/releasehist.tex | 2 | ||||
-rw-r--r-- | Master/texmf-doc/source/english/texlive-en/tex-live.sty | 25 | ||||
-rw-r--r-- | Master/texmf-doc/source/english/texlive-en/web2c.tex | 4 |
12 files changed, 1114 insertions, 1045 deletions
diff --git a/Master/texmf-doc/doc/english/texlive-en/live.css b/Master/texmf-doc/doc/english/texlive-en/live.css index 4d685793354..0d76902122b 100644 --- a/Master/texmf-doc/doc/english/texlive-en/live.css +++ b/Master/texmf-doc/doc/english/texlive-en/live.css @@ -96,25 +96,6 @@ .ec-lmss-10{ font-family: sans-serif;} .ec-lmss-10{ font-family: sans-serif;} .ec-lmss-10{ font-family: sans-serif;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} -.ec-lmbx-10{ font-weight: bold;} .ec-lmri-10{ font-style:italic;} .ec-lmri-10{ font-style:italic;} .ec-lmri-10{ font-style:italic;} @@ -134,25 +115,25 @@ .ec-lmri-10{ font-style:italic;} .ec-lmri-10{ font-style:italic;} .ec-lmri-10{ font-style:italic;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} -.ec-lmro-10{ font-style: oblique;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} .ec-lmtk-10{ font-family: monospace;} .ec-lmtk-10{ font-family: monospace;} .ec-lmtk-10{ font-family: monospace;} @@ -172,6 +153,25 @@ .ec-lmtk-10{ font-family: monospace;} .ec-lmtk-10{ font-family: monospace;} .ec-lmtk-10{ font-family: monospace;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} .ec-lmr-9{font-size:90%;} .ec-lmr-8{font-size:80%;} .ec-lmss-8{font-size:80%; font-family: sans-serif;} diff --git a/Master/texmf-doc/doc/english/texlive-en/live.html b/Master/texmf-doc/doc/english/texlive-en/live.html index 8a2d5da8731..ca21f5a97f8 100644 --- a/Master/texmf-doc/doc/english/texlive-en/live.html +++ b/Master/texmf-doc/doc/english/texlive-en/live.html @@ -2,13 +2,13 @@ "http://www.w3.org/TR/html4/loose.dtd"> <html > <head> - <title>The TEX Live Guide TeX Live 2007 </title> + <title>The TEX Live Guide TeX Live 2008 </title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta name="generator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)"> <meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)"> <!-- charset=utf-8,html,info,fn-in --> <meta name="src" content="live.tex"> -<meta name="date" content="2008-07-03 13:59:00"> +<meta name="date" content="2008-07-05 21:39:00"> <link rel="stylesheet" type="text/css" href="live.css"> <link rel="stylesheet" type="text/css" href="live.css" /> <link rel="stylesheet" type="text/css" href="tex-live.css" /> @@ -23,7 +23,7 @@ <h2 class="titleHead">The <span class="TEX">T<span class="E">E</span>X</span> Live Guide<br /> <span class="TEX">T<span -class="E">E</span>X</span> Live 2007 </h2> +class="E">E</span>X</span> Live 2008 </h2> <div class="author" ><span class="ec-lmr-12">Karl Berry, editor</span> <br /> <a @@ -39,190 +39,209 @@ class="ec-lmr-12">July 2008</span></div> <span class="sectionToc" >1 <a href="#x1-30001" id="QQ2-1-3">Introduction</a></span> <br />  <span class="subsectionToc" >1.1 <a -href="#x1-40001.1" id="QQ2-1-4">Operating system support</a></span> +href="#x1-40001.1" id="QQ2-1-4">TEX Live and the TEX Collection</a></span> <br />  <span class="subsectionToc" >1.2 <a -href="#x1-50001.2" id="QQ2-1-5">Basic usage of <span class="TEX">T<span -class="E">E</span>X</span> Live</a></span> +href="#x1-50001.2" id="QQ2-1-5">Operating system support</a></span> <br />  <span class="subsectionToc" >1.3 <a -href="#x1-60001.3" id="QQ2-1-6">Getting help</a></span> +href="#x1-60001.3" id="QQ2-1-6">Basic usage of <span class="TEX">T<span +class="E">E</span>X</span> Live</a></span> +<br />  <span class="subsectionToc" >1.4 <a +href="#x1-70001.4" id="QQ2-1-7">Getting help</a></span> <br /> <span class="sectionToc" >2 <a -href="#x1-70002" id="QQ2-1-7">Structure of <span class="TEX">T<span +href="#x1-80002" id="QQ2-1-8">Overview of <span class="TEX">T<span class="E">E</span>X</span> Live</a></span> <br />  <span class="subsectionToc" >2.1 <a -href="#x1-80002.1" id="QQ2-1-8">Multiple distributions: <span +href="#x1-90002.1" id="QQ2-1-9">Multiple distributions: <span class="ec-lmss-10">live</span>, <span -class="ec-lmss-10">inst</span>, <span -class="ec-lmss-10">protext</span></a></span> +class="ec-lmss-10">protext</span>, <span +class="ec-lmss-10">MacTEX</span></a></span> <br />  <span class="subsectionToc" >2.2 <a -href="#x1-90002.2" id="QQ2-1-9">Top level directories</a></span> +href="#x1-100002.2" id="QQ2-1-10">Top level directories</a></span> <br />  <span class="subsectionToc" >2.3 <a -href="#x1-100002.3" id="QQ2-1-10">Overview of the predefined texmf trees</a></span> +href="#x1-110002.3" id="QQ2-1-11">Overview of the predefined texmf trees</a></span> <br />  <span class="subsectionToc" >2.4 <a -href="#x1-110002.4" id="QQ2-1-11">Extensions to <span class="TEX">T<span +href="#x1-120002.4" id="QQ2-1-12">Extensions to <span class="TEX">T<span class="E">E</span>X</span></a></span> <br />  <span class="subsectionToc" >2.5 <a -href="#x1-120002.5" id="QQ2-1-12">Other notable programs in <span class="TEX">T<span +href="#x1-130002.5" id="QQ2-1-13">Other notable programs in <span class="TEX">T<span class="E">E</span>X</span> Live</a></span> <br /> <span class="sectionToc" >3 <a -href="#x1-130003" id="QQ2-1-13">Unix installation</a></span> +href="#x1-140003" id="QQ2-1-14">Installation</a></span> <br />  <span class="subsectionToc" >3.1 <a -href="#x1-140003.1" id="QQ2-1-14">Portable <span class="TEX">T<span +href="#x1-150003.1" id="QQ2-1-15">Portable <span class="TEX">T<span class="E">E</span>X</span> Live on DVD and USB (Unix)</a></span> <br />  <span class="subsectionToc" >3.2 <a -href="#x1-150003.2" id="QQ2-1-15">Installing <span class="TEX">T<span +href="#x1-160003.2" id="QQ2-1-16">Installing <span class="TEX">T<span class="E">E</span>X</span> Live to disk</a></span> <br />  <span class="subsectionToc" >3.3 <a -href="#x1-170003.3" id="QQ2-1-19">Installing individual packages to disk</a></span> +href="#x1-180003.3" id="QQ2-1-20">Testing the installation</a></span> <br /> <span class="sectionToc" >4 <a -href="#x1-180004" id="QQ2-1-20">Post-installation</a></span> +href="#x1-190004" id="QQ2-1-21">Post-installation</a></span> <br />  <span class="subsectionToc" >4.1 <a -href="#x1-190004.1" id="QQ2-1-21">The <span -class="ec-lmss-10">texconfig </span>program</a></span> +href="#x1-200004.1" id="QQ2-1-22">Installing individual packages to disk</a></span> <br />  <span class="subsectionToc" >4.2 <a -href="#x1-200004.2" id="QQ2-1-22">Testing the installation</a></span> +href="#x1-210004.2" id="QQ2-1-23">The <span +class="ec-lmss-10">texconfig </span>program</a></span> <br /> <span class="sectionToc" >5 <a -href="#x1-210005" id="QQ2-1-23">Mac OS X installation</a></span> +href="#x1-220005" id="QQ2-1-24">Mac OS X installation</a></span> <br /> <span class="sectionToc" >6 <a -href="#x1-220006" id="QQ2-1-24">Windows installation</a></span> +href="#x1-230006" id="QQ2-1-25">Windows installation</a></span> <br />  <span class="subsectionToc" >6.1 <a -href="#x1-230006.1" id="QQ2-1-25">Portable <span class="TEX">T<span +href="#x1-240006.1" id="QQ2-1-26">Portable <span class="TEX">T<span class="E">E</span>X</span> Live on DVD and USB (Windows)</a></span> <br />  <span class="subsectionToc" >6.2 <a -href="#x1-240006.2" id="QQ2-1-26">Starting the installer</a></span> +href="#x1-250006.2" id="QQ2-1-27">Starting the installer</a></span> <br />  <span class="subsectionToc" >6.3 <a -href="#x1-250006.3" id="QQ2-1-27">Installing <span class="TEX">T<span +href="#x1-260006.3" id="QQ2-1-28">Installing <span class="TEX">T<span class="E">E</span>X</span> Live to disk</a></span> <br />  <span class="subsectionToc" >6.4 <a -href="#x1-280006.4" id="QQ2-1-30">Support packages for Windows</a></span> +href="#x1-290006.4" id="QQ2-1-31">Support packages for Windows</a></span> <br /> <span class="sectionToc" >7 <a -href="#x1-290007" id="QQ2-1-31">Maintenance of the installation in Windows</a></span> +href="#x1-300007" id="QQ2-1-32">Maintenance of the installation in Windows</a></span> <br />  <span class="subsectionToc" >7.1 <a -href="#x1-300007.1" id="QQ2-1-32">Adding/removing packages</a></span> +href="#x1-310007.1" id="QQ2-1-33">Adding/removing packages</a></span> <br />  <span class="subsectionToc" >7.2 <a -href="#x1-310007.2" id="QQ2-1-33">Configuring and other management tasks</a></span> -<br />  <span class="subsectionToc" >7.3 <a -href="#x1-320007.3" id="QQ2-1-34">Uninstalling <span class="TEX">T<span -class="E">E</span>X</span> Live</a></span> +href="#x1-320007.2" id="QQ2-1-34">Configuring and other management tasks</a></span> +<br />  <span class="subsectionToc" >7.3 <a +href="#x1-330007.3" id="QQ2-1-35">Uninstalling <span class="TEX">T<span +class="E">E</span>X</span> Live</a></span> <br />  <span class="subsectionToc" >7.4 <a -href="#x1-330007.4" id="QQ2-1-35">Adding your own packages to the installation</a></span> +href="#x1-340007.4" id="QQ2-1-36">Adding your own packages to the installation</a></span> <br />  <span class="subsectionToc" >7.5 <a -href="#x1-340007.5" id="QQ2-1-36">Running <span +href="#x1-350007.5" id="QQ2-1-37">Running <span class="ec-lmtt-10">tlmp.exe </span>from the command line</a></span> <br />  <span class="subsectionToc" >7.6 <a -href="#x1-350007.6" id="QQ2-1-37">Network installation</a></span> +href="#x1-360007.6" id="QQ2-1-38">Network installation</a></span> <br />  <span class="subsectionToc" >7.7 <a -href="#x1-360007.7" id="QQ2-1-38">What’s different in Windows?</a></span> +href="#x1-370007.7" id="QQ2-1-39">What’s different in Windows?</a></span> <br />  <span class="subsectionToc" >7.8 <a -href="#x1-370007.8" id="QQ2-1-39">Personal configurations</a></span> +href="#x1-380007.8" id="QQ2-1-40">Personal configurations</a></span> <br />  <span class="subsectionToc" >7.9 <a -href="#x1-420007.9" id="QQ2-1-44">Testing</a></span> +href="#x1-430007.9" id="QQ2-1-45">Testing</a></span> <br />  <span class="subsectionToc" >7.10 <a -href="#x1-430007.10" id="QQ2-1-45">Printing</a></span> +href="#x1-440007.10" id="QQ2-1-46">Printing</a></span> <br />  <span class="subsectionToc" >7.11 <a -href="#x1-440007.11" id="QQ2-1-46">Tips and tricks for Win32</a></span> +href="#x1-450007.11" id="QQ2-1-47">Tips and tricks for Win32</a></span> <br />  <span class="subsectionToc" >7.12 <a -href="#x1-510007.12" id="QQ2-1-53">In case of problems</a></span> +href="#x1-520007.12" id="QQ2-1-54">In case of problems</a></span> <br /> <span class="sectionToc" >8 <a -href="#x1-540008" id="QQ2-1-56">A user’s guide to Web2C</a></span> +href="#x1-550008" id="QQ2-1-57">A user’s guide to Web2C</a></span> <br />  <span class="subsectionToc" >8.1 <a -href="#x1-550008.1" id="QQ2-1-57">Kpathsea path searching</a></span> +href="#x1-560008.1" id="QQ2-1-58">Kpathsea path searching</a></span> <br />  <span class="subsectionToc" >8.2 <a -href="#x1-630008.2" id="QQ2-1-65">Filename databases</a></span> +href="#x1-640008.2" id="QQ2-1-66">Filename databases</a></span> <br />  <span class="subsectionToc" >8.3 <a -href="#x1-680008.3" id="QQ2-1-73">Runtime options</a></span> +href="#x1-690008.3" id="QQ2-1-74">Runtime options</a></span> <br /> <span class="sectionToc" >9 <a -href="#x1-690009" id="QQ2-1-74">Acknowledgements</a></span> +href="#x1-700009" id="QQ2-1-75">Acknowledgements</a></span> <br /> <span class="sectionToc" >10 <a -href="#x1-7000010" id="QQ2-1-75">Release history</a></span> +href="#x1-7100010" id="QQ2-1-76">Release history</a></span> <br />  <span class="subsectionToc" >10.1 <a -href="#x1-7100010.1" id="QQ2-1-76">Past</a></span> +href="#x1-7200010.1" id="QQ2-1-77">Past</a></span> <br />  <span class="subsectionToc" >10.2 <a -href="#x1-7500010.2" id="QQ2-1-80">Present</a></span> +href="#x1-7600010.2" id="QQ2-1-81">Present</a></span> <br />  <span class="subsectionToc" >10.3 <a -href="#x1-7600010.3" id="QQ2-1-81">Future</a></span> +href="#x1-7700010.3" id="QQ2-1-82">Future</a></span> </div> <h3 class="likesectionHead"><a id="x1-2000"></a>List of Tables</h3> <div class="tableofcontents"><span class="lotToc" >1 <a -href="#x1-15001r1">Main menu options for the installation.</a></span><br /><span class="lotToc" >2 <a -href="#x1-15006r2">Supported system architectures.</a></span><br /> +href="#x1-16001r1">Main menu options for the installation.</a></span><br /><span class="lotToc" >2 <a +href="#x1-16006r2">Supported system architectures.</a></span><br /> </div> <!--l. 1--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">1 </span> <a id="x1-30001"></a>Introduction</h3> -<!--l. 4--><p class="noindent" >This document describes the main features of the <span class="TEX">T<span +<!--l. 4--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">1.1 </span> <a + id="x1-40001.1"></a><span class="TEX">T<span +class="E">E</span>X</span> Live and the <span class="TEX">T<span +class="E">E</span>X</span> Collection</h4> +<!--l. 6--><p class="noindent" >This document describes the main features of the <span class="TEX">T<span class="E">E</span>X</span> Live software distribution — <span class="TEX">T<span -class="E">E</span>X</span> and friends for -GNU/Linux and other Unix flavors, Mac OS X, and (32-bit) Windows systems. (Warning: it is not -especially useful for older Mac, Windows or MS-DOS systems.) -<!--l. 9--><p class="indent" > <span class="TEX">T<span -class="E">E</span>X</span> Live includes executables for <span class="TEX">T<span -class="E">E</span>X</span>, LaTeX2e, Con<span class="TEX">T<span -class="E">E</span>X</span>t, Metafont, MetaPost, 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 <span class="TEX"><span +class="E">E</span>X</span> and related +programs for GNU/Linux and other Unix flavors, Mac OS X, and Windows systems. +<!--l. 10--><p class="indent" > You may have acquired <span class="TEX">T<span +class="E">E</span>X</span> Live by downloading, or on the <span class="TEX"><span class="ec-lmss-10">T</span><span class="E"><span class="ec-lmss-10">E</span></span><span class="ec-lmss-10">X</span></span><span -class="ec-lmss-10"> Collection</span> -(briefly described below in section <a -href="#x1-70002">2<!--tex4ht:ref: sec:struct-tl --></a>, p. <a -href="#x1-70002">6<!--tex4ht:ref: sec:struct-tl --></a>). Both are cooperative efforts by the <span class="TEX">T<span -class="E">E</span>X</span> user -groups. -<!--l. 17--><p class="indent" > For newer versions of the packages included here, please check CTAN: <a +class="ec-lmss-10"> Collection </span>DVD, which <span class="TEX">T<span +class="E">E</span>X</span> +usergroups distribute among their members. Section <a +href="#x1-90002.1">2.1<!--tex4ht:ref: sec:multiple-dist --></a> briefly describes the contents of this DVD. Both +<span class="TEX">T<span +class="E">E</span>X</span> Live and the <span class="TEX"><span +class="ec-lmss-10">T</span><span +class="E"><span +class="ec-lmss-10">E</span></span><span +class="ec-lmss-10">X</span></span><span +class="ec-lmss-10"> Collection </span>are cooperative efforts by the <span class="TEX">T<span +class="E">E</span>X</span> user groups. This document mainly +describes <span class="TEX">T<span +class="E">E</span>X</span> Live itself. +<!--l. 16--><p class="indent" > <span class="TEX">T<span +class="E">E</span>X</span> Live includes executables for <span class="TEX">T<span +class="E">E</span>X</span>, LaTeX2e, Con<span class="TEX">T<span +class="E">E</span>X</span>t, Metafont, MetaPost, 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. +<!--l. 21--><p class="indent" > <span class="TEX">T<span +class="E">E</span>X</span> Live packages are regularly updated from CTAN: <a href="http://www.ctan.org" class="url" ><span class="ec-lmtt-10">http://www.ctan.org</span></a>. -<!--l. 20--><p class="indent" > For a brief summary of the major changes in this edition of <span class="TEX">T<span +<!--l. 24--><p class="indent" > For a brief summary of the major changes in this edition of <span class="TEX">T<span class="E">E</span>X</span> Live, see the end of the document, section <a -href="#x1-7000010">10<!--tex4ht:ref: sec:history --></a> (p. <a -href="#x1-7000010">68<!--tex4ht:ref: sec:history --></a>). -<!--l. 24--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">1.1 </span> <a - id="x1-40001.1"></a>Operating system support</h4> -<!--l. 27--><p class="noindent" ><span class="TEX">T<span -class="E">E</span>X</span> Live supports Unix/Linux and Windows. -<!--l. 29--><p class="indent" > The DVD contains binaries for many Linux- and Unix architectures. Users of other Unices have to -compile from source, which is included. - - -<!--l. 33--><p class="indent" > Mac OS X users may prefer the MacTeX distribution, which is based on <span class="TEX">T<span -class="E">E</span>X</span> Live. Although -Mac OS X is supported, it is treated here as any other Unix, without taking the unique characteristics of -the OS and its community into account. -<!--l. 38--><p class="indent" > As to Windows: only Windows 2000 and later are supported. Windows 9x, ME and NT have been -dropped. This restriction allowed us to treat Windows a bit more like Unix. -<!--l. 42--><p class="noindent" > +href="#x1-7100010">10<!--tex4ht:ref: sec:history --></a> (p. <a +href="#x1-7100010">69<!--tex4ht:ref: sec:history --></a>). + + +<!--l. 28--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">1.2 </span> <a - id="x1-50001.2"></a>Basic usage of <span class="TEX">T<span + id="x1-50001.2"></a>Operating system support</h4> +<!--l. 31--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> Live contains binaries for many Linux- and Unix architectures, including Mac OS X. The included +sources should enable installation on additional Linux- and Unix platforms. +<!--l. 35--><p class="indent" > As to Windows: only Windows 2000 and later are supported. Windows 9<span +class="ec-lmri-10">x</span>, ME and NT have been +dropped. Because of this restriction, Windows requires less special treatment compared to Linux and +Unix. There are no 64-bit executables for Windows, but the 32-bit executables should run on 64-bit +systems. +<!--l. 41--><p class="indent" > See section <a +href="#x1-90002.1">2.1<!--tex4ht:ref: sec:multiple-dist --></a> for alternative <span class="TEX">T<span +class="E">E</span>X</span> systems for Windows and Mac OS X. +<!--l. 44--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">1.3 </span> <a + id="x1-60001.3"></a>Basic usage of <span class="TEX">T<span class="E">E</span>X</span> Live</h4> -<!--l. 45--><p class="noindent" >You can install <span class="TEX">T<span +<!--l. 47--><p class="noindent" >You can install <span class="TEX">T<span class="E">E</span>X</span> Live either from DVD or over the internet. The net installer itself is very small and -downloads everything from the internet. The net installer is an attractive option if you need only a -fraction of the complete <span class="TEX">T<span +downloads everything needed from the internet. The net installer is an attractive option if you need only +a fraction of the complete <span class="TEX">T<span class="E">E</span>X</span> Live. -<!--l. 50--><p class="indent" > The DVD installer lets you install to a local disk, but you can also run <span class="TEX">T<span +<!--l. 52--><p class="indent" > The DVD installer lets you install to a local disk, but you can also run <span class="TEX">T<span class="E">E</span>X</span> Live directly from the DVD (or from a DVD image, if your system supports that). -<!--l. 54--><p class="noindent" >This is described in the installation sections following, but here is a quick start: +<!--l. 56--><p class="noindent" >This is described in the installation sections following, but here is a quick start: <ul class="itemize1"> <li class="itemize">The installation script is <span class="ec-lmtt-10">install-tl</span>, which has both a text mode (default for Unix) and a GUI mode (default for Windows). </li> - <li class="itemize">One of the installed items is tlmgr or <span class="TEX">T<span + <li class="itemize">One of the installed items is <span +class="ec-lmtt-10">tlmgr </span>or <span class="TEX">T<span class="E">E</span>X</span> Live Manager, which can also be used in GUI mode and in text mode. You can use it to install and uninstall packages and do various configuration tasks. </li></ul> -<!--l. 70--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">1.3 </span> <a - id="x1-60001.3"></a>Getting help</h4> -<!--l. 73--><p class="noindent" >The <span class="TEX">T<span +<!--l. 73--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">1.4 </span> <a + id="x1-70001.4"></a>Getting help</h4> +<!--l. 76--><p class="noindent" >The <span class="TEX">T<span class="E">E</span>X</span> 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 @@ -231,8 +250,8 @@ class="E">E</span>X</span> Live completely and purchase a vendor’s system; <a href="http://tug.org/interest.html#vendors" class="url" ><span class="ec-lmtt-10">http://tug.org/interest.html#vendors</span></a> has a list.) -<!--l. 81--><p class="indent" > Here is a list of resources, approximately in the order we recommend using them: -<!--l. 84--><p class="indent" > +<!--l. 84--><p class="indent" > Here is a list of resources, approximately in the order we recommend using them: +<!--l. 87--><p class="indent" > <dl class="description"><dt class="description"> <span class="ec-lmbx-10">Getting Started</span> </dt><dd @@ -257,6 +276,8 @@ href="../../../../texmf-doc/doc/english/FAQ-en" >texmf-doc/doc/english/FAQ-en</a href="http://www.tex.ac.uk/faq" class="url" ><span class="ec-lmtt-10">http://www.tex.ac.uk/faq</span></a>. Please check here first. + + </dd><dt class="description"> <span class="TEX"><span class="ec-lmbx-10">T</span><span @@ -272,8 +293,7 @@ class="E">E</span>X</span>-related items. See <a href="../../../../texmf-doc/doc/english/catalogue" >texmf-doc/doc/english/catalogue</a>, or <a href="http://www.ctan.org/tex-archive/help/Catalogue" class="url" ><span -class="ec-lmtt-10">http://www.ctan.org/tex-archive/help/Catalogue</span></a>. - +class="ec-lmtt-10">http://www.ctan.org/tex-archive/help/Catalogue</span></a>. </dd><dt class="description"> <span class="TEX"><span class="ec-lmbx-10">T</span><span @@ -334,17 +354,17 @@ class="ec-lmtt-10">tex-live@tug.org</span></a>. class="E">E</span>X</span> Live, you are better off writing to that program’s maintainer or mailing list. </dd></dl> -<!--l. 129--><p class="indent" > The other side of the coin is helping others who have questions. Both <span +<!--l. 132--><p class="indent" > The other side of the coin is helping others who have questions. Both <span class="ec-lmtt-10">comp.text.tex </span>and <span class="ec-lmtt-10">texhax </span>are open to anyone, so feel free to join, start reading, and help out where you can. Welcome to <span class="TEX">T<span class="E">E</span>X</span>! -<!--l. 137--><p class="noindent" > +<!--l. 4--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">2 </span> <a - id="x1-70002"></a>Structure of <span class="TEX">T<span + id="x1-80002"></a>Overview of <span class="TEX">T<span class="E">E</span>X</span> Live</h3> -<!--l. 140--><p class="noindent" >This section describes the structure and contents of <span class="TEX">T<span +<!--l. 7--><p class="noindent" >This section describes the structure and contents of <span class="TEX">T<span class="E">E</span>X</span> Live and the <span class="TEX"><span class="ec-lmss-10">T</span><span class="E"><span @@ -352,46 +372,34 @@ class="ec-lmss-10">E</span></span><span class="ec-lmss-10">X</span></span><span class="ec-lmss-10"> Collection </span>of which it is a part. -<!--l. 145--><p class="noindent" > +<!--l. 12--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">2.1 </span> <a - id="x1-80002.1"></a>Multiple distributions: <span + id="x1-90002.1"></a>Multiple distributions: <span class="ec-lmss-10">live</span>, <span -class="ec-lmss-10">inst</span>, <span -class="ec-lmss-10">protext</span></h4> -<!--l. 148--><p class="noindent" >Space limitations of CD-ROM format have forced us to divide <span class="TEX"><span +class="ec-lmss-10">protext</span>, <span +class="ec-lmss-10">Mac</span><span class="TEX"><span +class="ec-lmss-10">T</span><span +class="E"><span +class="ec-lmss-10">E</span></span><span +class="ec-lmss-10">X</span></span></h4> +<!--l. 15--><p class="noindent" >The <span class="TEX"><span class="ec-lmss-10">T</span><span class="E"><span class="ec-lmss-10">E</span></span><span class="ec-lmss-10">X</span></span><span -class="ec-lmss-10"> Collection </span>into several distributions, -as follows. -<!--l. 151--><p class="indent" > +class="ec-lmss-10"> Collection </span>DVD comprises the following: +<!--l. 17--><p class="indent" > <dl class="description"><dt class="description"> <span class="ec-lmbx-10">live</span> </dt><dd -class="description">A complete system on DVD; it is too large for CD. It can be run live or installed to disk. - It also includes a snapshot of the CTAN repository, the <span -class="ec-lmss-10">protext </span>distribution for Windows - and the Mac<span class="TEX">T<span -class="E">E</span>X</span> distribution for Mac OS X, entirely independent of <span class="TEX">T<span -class="E">E</span>X</span> Live, as well as - assorted other packages in a <span -class="ec-lmtt-10">texmf-extra </span>directory. - <!--l. 160--><p class="noindent" >CTAN, <span -class="ec-lmss-10">protext</span>, Mac<span class="TEX">T<span -class="E">E</span>X</span>, and <span -class="ec-lmtt-10">texmf-extra </span>do not follow the same copying conditions as - <span class="TEX">T<span -class="E">E</span>X</span> Live, so be careful when redistributing or modifying. - - +class="description">A complete <span class="TEX">T<span +class="E">E</span>X</span> system which can be run live or installed to disk. It is too large for CD. </dd><dt class="description"> <span -class="ec-lmbx-10">inst(allable)</span> </dt><dd -class="description">A complete system on CD; in order to make this fit, the packages and programs are - compressed. Therefore, it is not possible to run <span class="TEX">T<span -class="E">E</span>X</span> directly from the installable CD, you - have to install it to disk (hence its name). Installation is described in subsequent sections. +class="ec-lmbx-10">CTAN</span> </dt><dd +class="description">A snapshot of the CTAN repository + + </dd><dt class="description"> <span class="ec-lmbx-10">protext</span> </dt><dd @@ -406,23 +414,36 @@ class="E">E</span>X</span>t home page is <a href="http://tug.org/protext" class="url" ><span class="ec-lmtt-10">http://tug.org/protext</span></a>. - <!--l. 175--><p class="noindent" >Pro<span class="TEX">T<span -class="E">E</span>X</span>t is provided as both the top level of the <span -class="ec-lmss-10">live </span>DVD and on its own CD (for those - who cannot use the DVD). + </dd><dt class="description"> +<span +class="ec-lmbx-10">Mac</span><span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> </dt><dd +class="description">for Mac OS X is independent of but based on <span class="TEX">T<span +class="E">E</span>X</span> Live. + </dd><dt class="description"> +<span +class="ec-lmtk-10">texmf-extra</span> </dt><dd +class="description">A directory with assorted additional packages. </dd></dl> -<!--l. 180--><p class="noindent" >You can tell which type of distribution you’re in by looking for a <span -class="ec-lmtt-10">00</span><span -class="ec-lmro-10">type</span><span -class="ec-lmtt-10">.TL </span>file at the top of the <span class="TEX">T<span -class="E">E</span>X</span> -Live directory. This file also contains the <span class="TEX">T<span +<!--l. 36--><p class="indent" > CTAN, <span +class="ec-lmss-10">protext</span>, Mac<span class="TEX">T<span +class="E">E</span>X</span>, and <span +class="ec-lmtt-10">texmf-extra </span>do not follow the same copying conditions as <span class="TEX">T<span +class="E">E</span>X</span> Live, +so be careful when redistributing or modifying. +<!--l. 40--><p class="noindent" >You can tell which type of distribution you’re in by looking for a <span +class="ec-lmtt-10">release-texlive.txt </span>file at the top of +the <span class="TEX">T<span +class="E">E</span>X</span> Live directory. This file also contains the <span class="TEX">T<span class="E">E</span>X</span> Live release date. -<!--l. 184--><p class="indent" > Naturally, each user group chooses what to distribute to its own members. -<!--l. 1--><p class="noindent" > +<!--l. 44--><p class="indent" > Naturally, each user group chooses what to distribute to its own members. +<!--l. 46--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">2.2 </span> <a - id="x1-90002.2"></a>Top level directories</h4> -<!--l. 4--><p class="noindent" >Here is a brief listing and description of the top level directories in the <span class="TEX">T<span + id="x1-100002.2"></a>Top level directories</h4> +<!--l. 49--><p class="noindent" >Here is a brief listing and description of the top level directories in the <span class="TEX">T<span class="E">E</span>X</span> Live distribution. On the <span class="ec-lmss-10">live</span> DVD, the entire <span class="TEX">T<span @@ -436,35 +457,35 @@ id="TBL-2-1"><col id="TBL-2-2"></colgroup><tr style="vertical-align:baseline;" id="TBL-2-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-1-1" class="td11"> <span -class="ec-lmtt-10">bin </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-1-2" -class="td11"> <!--l. 13--><p class="noindent" >The <span class="TEX">T<span +class="ec-lmtt-10">bin </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-1-2" +class="td11"> <!--l. 58--><p class="noindent" >The <span class="TEX">T<span class="E">E</span>X</span> system programs, arranged by platform. </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-2-1" class="td11"> <span -class="ec-lmtt-10">source </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-2-2" -class="td11"> <!--l. 14--><p class="noindent" >The source of all programs, including the main Web2C <span class="TEX">T<span -class="E">E</span>X</span> and Metafont - distributions. These are stored in a <span -class="ec-lmss-10">bzip2</span>-compressed tar archive. </td> +class="ec-lmtt-10">readme.html </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-2-2" +class="td11"> <!--l. 59--><p class="noindent" >Readme html pages in various languages, with a quick introduction and useful + links </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-3-1" class="td11"> <span -class="ec-lmtt-10">setuptl </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-3-2" -class="td11"> <!--l. 17--><p class="noindent" >Installation programs for GNU/Linux and Windows. </td> +class="ec-lmtt-10">source </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-3-2" +class="td11"> <!--l. 61--><p class="noindent" >The source of all programs, including the main Web2C <span class="TEX">T<span +class="E">E</span>X</span> and Metafont + distributions. These are stored in various compressed archives. </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-4-1" class="td11"> <span -class="ec-lmtt-10">support </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-4-2" -class="td11"> <!--l. 18--><p class="noindent" >Assorted auxiliary packages and programs. These are <span +class="ec-lmtt-10">support </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-4-2" +class="td11"> <!--l. 64--><p class="noindent" >Various auxiliary packages and programs. These are <span class="ec-lmri-10">not </span>installed automatically. This includes assorted editors and <span class="TEX">T<span class="E">E</span>X</span> shells. </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-5-1" class="td11"> <span -class="ec-lmtt-10">texmf </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-5-2" -class="td11"> <!--l. 21--><p class="noindent" >Tree for the programs, along with their support files and documentation. +class="ec-lmtt-10">texmf </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-5-2" +class="td11"> <!--l. 67--><p class="noindent" >Tree for the programs, along with their support files and documentation. Does not include <span class="TEX">T<span class="E">E</span>X</span> formats and packages. (<span class="ec-lmtt-10">TEXMFMAIN </span>in the next @@ -472,35 +493,43 @@ class="ec-lmtt-10">TEXMFMAIN </span>in the next </tr><tr style="vertical-align:baseline;" id="TBL-2-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-6-1" class="td11"> <span -class="ec-lmtt-10">texmf-dist </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-6-2" -class="td11"> <!--l. 24--><p class="noindent" >The main tree of formats and packages. (<span +class="ec-lmtt-10">texmf-dist </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-6-2" +class="td11"> <!--l. 70--><p class="noindent" >The main tree of formats and packages. (<span class="ec-lmtt-10">TEXMFDIST </span>in the next section.) </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-7-1" class="td11"> <span -class="ec-lmtt-10">texmf-doc </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-7-2" -class="td11"> <!--l. 26--><p class="noindent" >Tree for self-contained pure documentation, arranged by language. </td> +class="ec-lmtt-10">texmf-doc </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-7-2" +class="td11"> <!--l. 72--><p class="noindent" >Tree for self-contained pure documentation, arranged by language. </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-8-1" class="td11"> <span -class="ec-lmtt-10">texmf-var </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-8-2" -class="td11"> <!--l. 28--><p class="noindent" >Tree for files automatically generated and stored. (<span -class="ec-lmtt-10">TEXMFSYSVAR </span>in the next - section.) </td> +class="ec-lmtt-10">texmf-var </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-8-2" +class="td11"> <!--l. 74--><p class="noindent" >This is not strictly part of the distribution, but will be located next to + the above texmf trees in a default installation; it can be located elsewhere. + This tree contains files which are automatically generated and stored. + (<span +class="ec-lmtt-10">TEXMFSYSVAR </span>in the next section.) </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-9-1" -class="td11"> </td> </tr></table> -</div> -<!--l. 35--><p class="indent" > In addition to the directories above, the installation scripts and <span +class="td11"> <span +class="ec-lmtt-10">tlpkg </span></td><td style="white-space:wrap; text-align:left;" id="TBL-2-9-2" +class="td11"> <!--l. 79--><p class="noindent" >Scripts, programs and data for managing the installation. It also contains + private copies of Perl and Ghostscript for Windows, which are invisible + outside <span class="TEX">T<span +class="E">E</span>X</span> Live, and a new Windows PostScript viewer PSView. </td> +</tr></table></div> +<!--l. 88--><p class="indent" > In addition to the directories above, the installation scripts and <span class="ec-lmtt-10">README </span>files (in various languages) are at the top level of the distribution. -<!--l. 39--><p class="indent" > The <span +<!--l. 92--><p class="indent" > The <span class="ec-lmtt-10">texmf-doc </span>directory contains only documentation, but it does not contain all the documentation. The documentation for the programs (manuals, man pages, Info files) is in <span class="ec-lmtt-10">texmf/doc</span>, since the programs are in <span class="ec-lmtt-10">texmf</span>. Similarly, the documentation for <span class="TEX">T<span class="E">E</span>X</span> packages and formats is in + <span class="ec-lmtt-10">texmf-dist/doc</span>. You can use the <span class="ec-lmss-10">texdoc </span>or <span @@ -508,39 +537,37 @@ class="ec-lmss-10">texdoctk </span>programs to find any documentation wherever it’s located. The comprehensive links in the top-level file <a href="../../../../doc.html" >doc.html</a> may also be helpful. - - -<!--l. 49--><p class="noindent" > +<!--l. 102--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">2.3 </span> <a - id="x1-100002.3"></a>Overview of the predefined texmf trees</h4> -<!--l. 52--><p class="noindent" >This section lists all predefined variables specifying texmf trees used by the system, and their intended + id="x1-110002.3"></a>Overview of the predefined texmf trees</h4> +<!--l. 105--><p class="noindent" >This section lists all predefined variables specifying texmf trees used by the system, and their intended purpose. The command <span class="ec-lmtt-10">texconfig conf </span>shows you the values of these variables, so that you can easily find out how they map to directory names in your installation. -<!--l. 57--><p class="noindent" > +<!--l. 110--><p class="noindent" > <dl class="list1"><dt class="list"> <span class="ec-lmtt-10">TEXMFMAIN</span> </dt><dd class="list"> - <!--l. 58--><p class="noindent" >The tree which holds vital parts of the system such as helper scripts (e.g., <span class="obeylines-h"><span class="verb"><span + <!--l. 111--><p class="noindent" >The tree which holds vital parts of the system such as helper scripts (e.g., <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">web2c/mktexdir</span></span></span>), pool files and other support files. </dd><dt class="list"> <span class="ec-lmtt-10">TEXMFDIST</span> </dt><dd class="list"> - <!--l. 61--><p class="noindent" >The tree which holds the main set of macro packages, fonts, etc., as originally distributed. + <!--l. 114--><p class="noindent" >The tree which holds the main set of macro packages, fonts, etc., as originally distributed. </dd><dt class="list"> <span class="ec-lmtt-10">TEXMFLOCAL</span> </dt><dd class="list"> - <!--l. 63--><p class="noindent" >The tree which administrators can use for system-wide installation of additional or updated + <!--l. 116--><p class="noindent" >The tree which administrators can use for system-wide installation of additional or updated macros, fonts, etc. </dd><dt class="list"> <span class="ec-lmtt-10">TEXMFHOME</span> </dt><dd class="list"> - <!--l. 65--><p class="noindent" >The tree which users can use for their own individual installations of additional or updated + <!--l. 118--><p class="noindent" >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 <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">$HOME</span></span></span> by default, which dynamically adjusts for each user to an individual directory. @@ -548,7 +575,7 @@ class="ec-lmtt-10">$HOME</span></span></span> by default, which <span class="ec-lmtt-10">TEXMFCONFIG</span> </dt><dd class="list"> - <!--l. 70--><p class="noindent" >The tree used by te<span class="TEX">T<span + <!--l. 123--><p class="noindent" >The tree used by te<span class="TEX">T<span class="E">E</span>X</span>’s utilities <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">texconfig</span></span></span>, <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">updmap</span></span></span>, and <span class="obeylines-h"><span class="verb"><span @@ -559,7 +586,7 @@ class="ec-lmtt-10">$HOME</span></span></span> by default. <span class="ec-lmtt-10">TEXMFSYSCONFIG</span> </dt><dd class="list"> - <!--l. 73--><p class="noindent" >The tree used by te<span class="TEX">T<span + <!--l. 126--><p class="noindent" >The tree used by te<span class="TEX">T<span class="E">E</span>X</span>’s utilities <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">texconfig-sys</span></span></span>, <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">updmap-sys</span></span></span>, and <span class="obeylines-h"><span class="verb"><span @@ -569,7 +596,7 @@ class="ec-lmtt-10">fmtutil-sys</span></span></span> to store <span class="ec-lmtt-10">TEXMFVAR</span> </dt><dd class="list"> - <!--l. 76--><p class="noindent" >The tree used by <span class="obeylines-h"><span class="verb"><span + <!--l. 129--><p class="noindent" >The tree used by <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">texconfig</span></span></span>, <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">updmap</span></span></span> and <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">fmtutil</span></span></span> to store (cached) runtime data such as @@ -579,25 +606,28 @@ class="ec-lmtt-10">$HOME</span></span></span> by default. <span class="ec-lmtt-10">TEXMFSYSVAR</span> </dt><dd class="list"> - <!--l. 79--><p class="noindent" >The tree used by <span class="obeylines-h"><span class="verb"><span + <!--l. 132--><p class="noindent" >The tree used by <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">texconfig-sys</span></span></span>, <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">updmap-sys</span></span></span> and <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">fmtutil-sys</span></span></span> to store (cached) runtime data such as format files and generated map files.</dd></dl> -<!--l. 84--><p class="indent" > For more discussion of <span +<!--l. 137--><p class="indent" > For more discussion of <span class="ec-lmtt-10">texconfig </span>and related utilities, please see section <a -href="#x1-190004.1">4.1<!--tex4ht:ref: sec:texconfig --></a>, p. <a -href="#x1-190004.1">27<!--tex4ht:ref: sec:texconfig --></a>. -<!--l. 88--><p class="noindent" > +href="#x1-210004.2">4.2<!--tex4ht:ref: sec:texconfig --></a>, p. <a +href="#x1-210004.2">30<!--tex4ht:ref: sec:texconfig --></a>. + + +<!--l. 141--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">2.4 </span> <a - id="x1-110002.4"></a>Extensions to <span class="TEX">T<span + id="x1-120002.4"></a>Extensions to <span class="TEX">T<span class="E">E</span>X</span></h4> -<!--l. 91--><p class="noindent" ><span class="TEX">T<span +<!--l. 144--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> itself is frozed, apart from rare bug fixes. It is still present in <span class="TEX">T<span +class="E">E</span>X</span> Live, and will remain so in the +foreseeable future. <span class="TEX">T<span class="E">E</span>X</span> Live contains several extended versions of <span class="TEX">T<span class="E">E</span>X</span>: -<!--l. 93--><p class="indent" > - - +<!--l. 148--><p class="indent" > <dl class="description"><dt class="description"> <span class="ec-lmbx-10">e-</span><span class="TEX"><span @@ -605,13 +635,13 @@ class="ec-lmbx-10">T</span><span class="E"><span class="ec-lmbx-10">E</span></span><span class="ec-lmbx-10">X</span></span> </dt><dd -class="description">adds a small but powerful set of new primitives (related to macro expansion, character - scanning, classes of marks, additional debugging features, and more) and the <span class="TEX">T<span -class="E">E</span>X</span>--XE T - extensions for bidirectional typesetting. In default mode, e-<span class="TEX">T<span -class="E">E</span>X</span> is 100% compatible with - ordinary <span class="TEX">T<span -class="E">E</span>X</span>. See <a +class="description">adds a set of new primitives (related to macro expansion, character scanning, classes + of marks, additional debugging features, and more) and the <span class="TEX">T<span +class="E">E</span>X</span>--XE T extensions for + bidirectional typesetting. In default mode, e-<span class="TEX">T<span +class="E">E</span>X</span> is 100% compatible with ordinary <span class="TEX">T<span +class="E">E</span>X</span>. + See <a href="../../../../texmf-dist/doc/etex/base/etex_man.pdf" >texmf-dist/doc/etex/base/etex_man.pdf</a>. </dd><dt class="description"> <span @@ -630,13 +660,34 @@ href="../../../../texmf/doc/pdftex/manual/samplepdf/samplepdf.tex" >texmf/doc/pd class="E">E</span>X</span>. </dd><dt class="description"> <span +class="ec-lmbx-10">Lua</span><span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> </dt><dd +class="description">(see <a +href="http://www.luatex.org/" class="url" ><span +class="ec-lmtt-10">http://www.luatex.org/</span></a> and <a +href="../../../../texmf-dist/doc/luatex/luatexref-t.pdf" >texmf-dist/doc/luatex/luatexref-t.pdf</a>) is the + designated successor of pdf<span class="TEX">T<span +class="E">E</span>X</span>, with which it should be backward-compatible. It should also + supersede Aleph, see below. The incorporated Lua interpreter (see <a +href="http://www.lua.org/" class="url" ><span +class="ec-lmtt-10">http://www.lua.org/</span></a>) + enables elegant solutions for many thorny <span class="TEX">T<span +class="E">E</span>X</span> problems. When called as <span +class="ec-lmtt-10">texlua</span>, it functions + as a standalone Lua interpreter, and is already used as such within <span class="TEX">T<span +class="E">E</span>X</span> Live. + </dd><dt class="description"> +<span class="ec-lmbx-10">Xe</span><span class="TEX"><span class="ec-lmbx-10">T</span><span class="E"><span class="ec-lmbx-10">E</span></span><span class="ec-lmbx-10">X</span></span> </dt><dd -class="description">adds support for Unicode input and OpenType fonts, using third-party libraries. See - <a +class="description">adds support for Unicode input, OpenType- and system fonts, using third-party libraries. + See <a href="http://scripts.sil.org/xetex" class="url" ><span class="ec-lmtt-10">http://scripts.sil.org/xetex</span></a>. </dd><dt class="description"> @@ -656,55 +707,54 @@ class="E">E</span>X</span> extensions. See <a href="../../../../texmf-dist/doc/aleph/base" >texmf-dist/doc/aleph/base</a> for some minimal documentation. </dd></dl> -<!--l. 123--><p class="noindent" > +<!--l. 189--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">2.5 </span> <a - id="x1-120002.5"></a>Other notable programs in <span class="TEX">T<span + id="x1-130002.5"></a>Other notable programs in <span class="TEX">T<span class="E">E</span>X</span> Live</h4> -<!--l. 125--><p class="noindent" >Here are a few other commonly-used programs included in <span class="TEX">T<span +<!--l. 191--><p class="noindent" >Here are a few other commonly-used programs included in <span class="TEX">T<span class="E">E</span>X</span> Live: -<!--l. 127--><p class="indent" > +<!--l. 193--><p class="indent" > <dl class="list1"><dt class="list"> <span class="ec-lmss-10">bibtex</span> </dt><dd class="list"> - <!--l. 129--><p class="noindent" >bibliography support. + <!--l. 195--><p class="noindent" >bibliography support. </dd><dt class="list"> <span class="ec-lmss-10">makeindex</span> </dt><dd class="list"> - <!--l. 131--><p class="noindent" >index support. + <!--l. 197--><p class="noindent" >index support. + </dd><dt class="list"> <span class="ec-lmss-10">dvips</span> </dt><dd class="list"> - <!--l. 133--><p class="noindent" >convert DVI to PostScript. + <!--l. 199--><p class="noindent" >convert DVI to PostScript. </dd><dt class="list"> <span class="ec-lmss-10">xdvi</span> </dt><dd class="list"> - <!--l. 135--><p class="noindent" >DVI previewer for the X Window System. + <!--l. 201--><p class="noindent" >DVI previewer for the X Window System. </dd><dt class="list"> <span class="ec-lmss-10">dvilj</span> </dt><dd class="list"> - <!--l. 137--><p class="noindent" >DVI drive for the HP LaserJet family. - - + <!--l. 203--><p class="noindent" >DVI drive for the HP LaserJet family. </dd><dt class="list"> <span class="ec-lmss-10">dv2dt, dt2dv</span> </dt><dd class="list"> - <!--l. 139--><p class="noindent" >convert DVI to/from plain text. + <!--l. 205--><p class="noindent" >convert DVI to/from plain text. </dd><dt class="list"> <span class="ec-lmss-10">dviconcat, dviselect</span> </dt><dd class="list"> - <!--l. 141--><p class="noindent" >cut and paste pages from DVI files. + <!--l. 207--><p class="noindent" >cut and paste pages from DVI files. </dd><dt class="list"> <span class="ec-lmss-10">dvipdfmx</span> </dt><dd class="list"> - <!--l. 144--><p class="noindent" >convert DVI to PDF, an alternative approach to pdf<span class="TEX">T<span + <!--l. 210--><p class="noindent" >convert DVI to PDF, an alternative approach to pdf<span class="TEX">T<span class="E">E</span>X</span> (mentioned above). See the <span class="ec-lmss-10">ps4pdf</span> and <span @@ -714,43 +764,45 @@ class="ec-lmss-10">pdftricks </span>packages for still more alternatives. class="ec-lmss-10">psselect, psnup, </span><span class="ec-lmss-10">…</span> </dt><dd class="list"> - <!--l. 148--><p class="noindent" >PostScript utilities. + <!--l. 214--><p class="noindent" >PostScript utilities. </dd><dt class="list"> <span class="ec-lmss-10">lacheck</span> </dt><dd class="list"> - <!--l. 151--><p class="noindent" ><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span + <!--l. 217--><p class="noindent" ><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span class="E">E</span>X</span></span> syntax checker. </dd><dt class="list"> <span -class="ec-lmss-10">texexec</span> </dt><dd +class="ec-lmss-10">texexec / texmfstart</span> </dt><dd class="list"> - <!--l. 153--><p class="noindent" >Con<span class="TEX">T<span + <!--l. 219--><p class="noindent" >Con<span class="TEX">T<span class="E">E</span>X</span>t and PDF processor. </dd><dt class="list"> <span class="ec-lmss-10">tex4ht</span> </dt><dd class="list"> - <!--l. 155--><p class="noindent" ><span class="TEX">T<span + <!--l. 221--><p class="noindent" ><span class="TEX">T<span class="E">E</span>X</span> to HTML converter. </dd></dl> <!--l. 1--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">3 </span> <a - id="x1-130003"></a>Unix installation</h3> + id="x1-140003"></a>Installation</h3> <!--l. 4--><p class="noindent" >As introduced in section <a -href="#x1-50001.2">1.2<!--tex4ht:ref: sec:basic --></a> (p. <a -href="#x1-50001.2">5<!--tex4ht:ref: sec:basic --></a>), <span class="TEX">T<span +href="#x1-60001.3">1.3<!--tex4ht:ref: sec:basic --></a> (p. <a +href="#x1-60001.3">5<!--tex4ht:ref: sec:basic --></a>), <span class="TEX">T<span class="E">E</span>X</span> Live has three principal uses: <!--l. 7--><p class="indent" > <ol class="enumerate1" > <li - class="enumerate" id="x1-13002x1">Run directly from media. + class="enumerate" id="x1-14002x1">Run directly from media. </li> <li - class="enumerate" id="x1-13004x2">Install to disk. + class="enumerate" id="x1-14004x2">Install to disk. + + </li> <li - class="enumerate" id="x1-13006x3">Integrate a particular package or collection into your existing <span class="TEX">T<span + class="enumerate" id="x1-14006x3">Integrate a particular package or collection into your existing <span class="TEX">T<span class="E">E</span>X</span> installation.</li></ol> <!--l. 14--><p class="noindent" >The following sections describes the Unix-specific procedures for each of these. <!--l. 17--><p class="indent" > <hr class="figure"><div class="figure" @@ -785,7 +837,7 @@ discussion below assumes you have been able to mount the CDs with full Rock Ridg <!--l. 32--><p class="indent" > </td></tr></table></div><hr class="endfigure"> <h4 class="subsectionHead"><span class="titlemark">3.1 </span> <a - id="x1-140003.1"></a>Portable <span class="TEX">T<span + id="x1-150003.1"></a>Portable <span class="TEX">T<span class="E">E</span>X</span> Live on DVD and USB (Unix)</h4> <!--l. 74--><p class="noindent" >It is possible to use the <span class="TEX">T<span class="E">E</span>X</span> system directly from the <span @@ -795,8 +847,8 @@ class="E">E</span>X</span> ‘Live’, in fact.) It is <span class="ec-lmri-10">not </span>possible to run <span class="TEX">T<span class="E">E</span>X</span> directly from the other CDs (see section <a -href="#x1-80002.1">2.1<!--tex4ht:ref: sec:multiple-dist --></a>, p. <a -href="#x1-80002.1">6<!--tex4ht:ref: sec:multiple-dist --></a>). To start, you mount the CD or DVD, with Rock Ridge extensions enabled. +href="#x1-90002.1">2.1<!--tex4ht:ref: sec:multiple-dist --></a>, p. <a +href="#x1-90002.1">6<!--tex4ht:ref: sec:multiple-dist --></a>). 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 GNU/Linux, except the name of the device (<span class="ec-lmtt-10">/dev/cdrom</span>, here) may vary. (All our examples will use <span @@ -867,15 +919,15 @@ others. <!--l. 113--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">3.2 </span> <a - id="x1-150003.2"></a>Installing <span class="TEX">T<span + id="x1-160003.2"></a>Installing <span class="TEX">T<span class="E">E</span>X</span> Live to disk</h4> <!--l. 116--><p class="noindent" >It is possible, indeed typical, to install the <span class="TEX">T<span class="E">E</span>X</span> Live distribution to hard disk. This can be done from either the <span class="ec-lmss-10">live </span>or <span class="ec-lmss-10">inst </span>distributions. (See section <a -href="#x1-80002.1">2.1<!--tex4ht:ref: sec:multiple-dist --></a>, p. <a -href="#x1-80002.1">6<!--tex4ht:ref: sec:multiple-dist --></a>, for an explanation of the different +href="#x1-90002.1">2.1<!--tex4ht:ref: sec:multiple-dist --></a>, p. <a +href="#x1-90002.1">6<!--tex4ht:ref: sec:multiple-dist --></a>, for an explanation of the different distributions.) <!--l. 122--><p class="indent" > 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 GNU/Linux, except the name of the device @@ -932,7 +984,7 @@ enter a command. Do this by typing the desired character and hitting return; don the angle brackets shown. Either uppercase or lowercase is ok; we’ll use lowercase in our examples. <!--l. 136--><p class="indent" > Table <a -href="#x1-15001r1">1<!--tex4ht:ref: tab:main-menu-options --></a> briefly lists the options in the main menu. The order in which you select the options makes +href="#x1-16001r1">1<!--tex4ht:ref: tab:main-menu-options --></a> briefly lists the options in the main menu. The order in which you select the options makes little difference, except that <span class="uline"><span class="ec-lmtt-10">i</span></span> must be last. It’s reasonable to go through them in the order presented here. @@ -940,14 +992,14 @@ here. <!--l. 142--><p class="indent" > <a - id="x1-15001r1"></a><hr class="float"><div class="float" + id="x1-16001r1"></a><hr class="float"><div class="float" ><table class="float"><tr class="float"><td class="float" > <table class="caption" ><tr style="vertical-align:baseline;" class="caption"><td class="id">Table 1: </td><td -class="content">Main menu options for the installation.</td></tr></table><!--tex4ht:label?: x1-15001r1 --> +class="content">Main menu options for the installation.</td></tr></table><!--tex4ht:label?: x1-16001r1 --> <div class="tabular"> <table class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-3-1g"><col @@ -1013,9 +1065,9 @@ From this menu, you can select installation of binaries for other architectures installing the current platform). This can be useful if you are sharing a <span class="TEX">T<span class="E">E</span>X</span> tree across a network of heterogenous machines. For a list of the supported architectures, see table <a -href="#x1-15006r2">2<!--tex4ht:ref: tab:archlist --></a>, +href="#x1-16006r2">2<!--tex4ht:ref: tab:archlist --></a>, p. <a -href="#x1-15006r2">22<!--tex4ht:ref: tab:archlist --></a>. +href="#x1-16006r2">23<!--tex4ht:ref: tab:archlist --></a>. <!--l. 173--><p class="indent" > <span class="ec-lmtk-10">s </span><span class="ec-lmbx-10">– Base installation scheme. </span>From this menu, you can choose an overall set of package @@ -1155,8 +1207,8 @@ class="ec-lmss-10">texconfig-sys </span>puts files that <span class="ec-lmri-10">are </span>version-specific. The default value is <span class="ec-lmtt-10">TEXDIR/texmf-var</span>, and there’s generally no reason to change it. See section <a -href="#x1-190004.1">4.1<!--tex4ht:ref: sec:texconfig --></a>, p. <a -href="#x1-190004.1">27<!--tex4ht:ref: sec:texconfig --></a> for +href="#x1-210004.2">4.2<!--tex4ht:ref: sec:texconfig --></a>, p. <a +href="#x1-210004.2">30<!--tex4ht:ref: sec:texconfig --></a> for more information. </dd><dt class="list"> <span @@ -1224,8 +1276,8 @@ do the installation from the media to your chosen locations. class="ec-lmtt-10">TEXDIR/bin </span>in your <span class="ec-lmtt-10">PATH</span>, so the newly-installed programs can be found. The architecture names are listed in table <a -href="#x1-15006r2">2<!--tex4ht:ref: tab:archlist --></a>, p. <a -href="#x1-15006r2">22<!--tex4ht:ref: tab:archlist --></a>, or you can simply list the directory <span +href="#x1-16006r2">2<!--tex4ht:ref: tab:archlist --></a>, p. <a +href="#x1-16006r2">23<!--tex4ht:ref: tab:archlist --></a>, or you can simply list the directory <span class="ec-lmtt-10">TEXDIR/bin</span>. <!--l. 321--><p class="indent" > The syntax for doing this, and the initialization file to use, depends on your shell. If you use a Bourne-compatible shell (<span @@ -1262,8 +1314,8 @@ run <span class="ec-lmss-10">texconfig </span>or <span class="ec-lmss-10">texconfig-sys </span>to customize your installation to your needs. This is explained in section <a -href="#x1-190004.1">4.1<!--tex4ht:ref: sec:texconfig --></a>, p. <a -href="#x1-190004.1">27<!--tex4ht:ref: sec:texconfig --></a>. +href="#x1-210004.2">4.2<!--tex4ht:ref: sec:texconfig --></a>, p. <a +href="#x1-210004.2">30<!--tex4ht:ref: sec:texconfig --></a>. <!--l. 342--><p class="indent" > 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, <span class="uline"><span class="ec-lmtt-10">i</span></span> for install. The <span @@ -1324,8 +1376,8 @@ class="ec-lmtt-10"> #</span><span class="ec-lmtt-10"> see</span><span class="ec-lmtt-10"> section</span><span class="ec-lmtt-10"> </span><a -href="#x1-190004.1"><span -class="ec-lmtt-10">4.1</span><!--tex4ht:ref: sec:texconfig --></a> +href="#x1-210004.2"><span +class="ec-lmtt-10">4.2</span><!--tex4ht:ref: sec:texconfig --></a> <br /><span class="ec-lmtt-10">#</span><span class="ec-lmtt-10"> New</span><span @@ -1365,9 +1417,9 @@ class="verbatim"><tr class="verbatim"><td class="verbatim"><div class="verbatim"> <div class="fancyvrb" id="fancyvrb1"> <a - id="x1-15003r1"></a>  MANPATH_MAP /usr/local/texlive/2007/bin/i386-linux \ + id="x1-16003r1"></a>  MANPATH_MAP /usr/local/texlive/2007/bin/i386-linux \ <br class="fancyvrb" /><a - id="x1-15005r2"></a>              /usr/local/texlive/2007/texmf/doc/man + id="x1-16005r2"></a>              /usr/local/texlive/2007/texmf/doc/man </div> </div> </td></tr></table> @@ -1379,14 +1431,14 @@ your personal initialization files can and do vary from site to site. <!--l. 370--><p class="indent" > <a - id="x1-15006r2"></a><hr class="float"><div class="float" + id="x1-16006r2"></a><hr class="float"><div class="float" ><table class="float"><tr class="float"><td class="float" > <table class="caption" ><tr style="vertical-align:baseline;" class="caption"><td class="id">Table 2: </td><td -class="content">Supported system architectures.</td></tr></table><!--tex4ht:label?: x1-15006r2 --> +class="content">Supported system architectures.</td></tr></table><!--tex4ht:label?: x1-16006r2 --> <div class="tabular"> <table class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-4-1g"><col @@ -1475,7 +1527,7 @@ class="td11"> </td> </td></tr></table></div><hr class="endfloat" /> <h5 class="subsubsectionHead"><span class="titlemark">3.2.1 </span> <a - id="x1-160003.2.1"></a>Non-interactive installation</h5> + id="x1-170003.2.1"></a>Non-interactive installation</h5> <!--l. 398--><p class="noindent" >It is possible to override the default directories with environment variables, and then install non-interactively. Example: <div class="alltt"> <!--l. 400--><p class="noindent" ><div class="obeylines-v"> @@ -1542,22 +1594,255 @@ class="ec-lmtt-10">$HOME/texmf</span>.</dd></dl> <!--l. 430--><p class="indent" > It would be better to support a standard GNU-style <span class="ec-lmtt-10">configure </span>with options, instead of these environment variables. Volunteers are welcome! -<!--l. 436--><p class="noindent" > +<!--l. 434--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">3.3 </span> <a - id="x1-170003.3"></a>Installing individual packages to disk</h4> -<!--l. 438--><p class="noindent" >You can add individual packages or collections from the current distribution to an existing non-<span class="TEX">T<span + id="x1-180003.3"></a>Testing the installation</h4> +<!--l. 437--><p class="noindent" >After installing <span class="TEX">T<span +class="E">E</span>X</span> Live as best you can, you naturally want to test it out, so you can start creating +beautiful documents and/or fonts. +<!--l. 440--><p class="indent" > This section gives some basic procedures for testing that the new system is functional. We give Unix +commands; under Mac OS X and Windows, you’re more likely to run the tests through a graphical +interface, but the principles are the same. +<!--l. 445--><p class="indent" > + + <ol class="enumerate1" > + <li + class="enumerate" id="x1-18002x1">Make sure that you can run the <span +class="ec-lmss-10">tex </span>program in the first place: + <div class="alltt"> + <!--l. 450--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span class="uline"><span +class="ec-lmtt-10">tex</span> <span +class="ec-lmtt-10">--version</span></span> + <br /><span +class="ec-lmtt-10">TeX</span><span +class="ec-lmtt-10"> 3.141592</span><span +class="ec-lmtt-10"> (Web2C</span><span +class="ec-lmtt-10"> 7.5.5)</span> + <br /><span +class="ec-lmtt-10">kpathsea</span><span +class="ec-lmtt-10"> version</span><span +class="ec-lmtt-10"> 3.5.5</span> + <br /><span +class="ec-lmtt-10">...</span> +</div> + </div> If this comes back with ‘command not found’ instead of version and copyright information, most + likely you don’t have the correct <span +class="ec-lmtt-10">bin </span>subdirectory in your <span +class="ec-lmtt-10">PATH</span>. See the environment-setting + information on p. <span +class="ec-lmbx-10">??</span>. + </li> + <li + class="enumerate" id="x1-18004x2">Process a basic <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> file: <div class="alltt"> + <!--l. 462--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span class="uline"><span +class="ec-lmtt-10">latex</span> <span +class="ec-lmtt-10">sample2e.tex</span></span> + <br /><span +class="ec-lmtt-10">This</span><span +class="ec-lmtt-10"> is</span><span +class="ec-lmtt-10"> pdfeTeXk,</span><span +class="ec-lmtt-10"> Version</span><span +class="ec-lmtt-10"> 3.141592...</span> + <br /><span +class="ec-lmtt-10">...</span> + <br /><span +class="ec-lmtt-10">Output</span><span +class="ec-lmtt-10"> written</span><span +class="ec-lmtt-10"> on</span><span +class="ec-lmtt-10"> sample2e.dvi</span><span +class="ec-lmtt-10"> (3</span><span +class="ec-lmtt-10"> pages,</span><span +class="ec-lmtt-10"> 7496</span><span +class="ec-lmtt-10"> bytes).</span> + <br /><span +class="ec-lmtt-10">Transcript</span><span +class="ec-lmtt-10"> written</span><span +class="ec-lmtt-10"> on</span><span +class="ec-lmtt-10"> sample2e.log.</span> +</div> + </div> If this fails to find <span +class="ec-lmtt-10">sample2e.tex </span>or other files, perhaps you have interference from old + environment variables or configuration files. For a deep analysis, you can always ask <span class="TEX">T<span +class="E">E</span>X</span> to + report on exactly what it is searching for, and finding; see “Debugging actions” on + page <a +href="#x1-680008.2.4">62<!--tex4ht:ref: Debugging --></a>. + </li> + <li + class="enumerate" id="x1-18006x3">Preview the result online: <div class="alltt"> + <!--l. 476--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span class="uline"><span +class="ec-lmtt-10">xdvi</span> <span +class="ec-lmtt-10">sample2e.dvi</span></span> +</div> + </div> (Under Windows, the analogous command is <span +class="ec-lmss-10">dviout</span>.) You should see a new window with a nice + document explaining some of the basics of <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>. (Well worth reading, by the way if you’re new + to the system.) You do have to be running under X for <span +class="ec-lmss-10">xdvi </span>to work; if you’re not, or + your <span +class="ec-lmtt-10">DISPLAY </span>environment variable is set incorrectly, you’ll get an error ‘<span +class="ec-lmtt-10">Can’t open</span> + <span +class="ec-lmtt-10">display</span>’. + </li> + <li + class="enumerate" id="x1-18008x4">Create a PostScript file for printing or display: <div class="alltt"> + + + <!--l. 487--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span class="uline"><span +class="ec-lmtt-10">dvips</span> <span +class="ec-lmtt-10">sample2e.dvi</span> <span +class="ec-lmtt-10">-o</span> <span +class="ec-lmtt-10">sample2e.ps</span></span> +</div> + </div> + </li> + <li + class="enumerate" id="x1-18010x5">Create a PDF file instead of DVI; this processes the <span +class="ec-lmtt-10">.tex </span>file and writes PDF directly: + <div class="alltt"> + <!--l. 493--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span class="uline"><span +class="ec-lmtt-10">pdflatex</span> <span +class="ec-lmtt-10">sample2e.tex</span></span> +</div> + </div> + </li> + <li + class="enumerate" id="x1-18012x6">Preview the PDF file: <div class="alltt"> + <!--l. 498--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span class="uline"><span +class="ec-lmtt-10">gv</span> <span +class="ec-lmtt-10">sample2e.pdf</span></span> + <br />or: + <br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span class="uline"><span +class="ec-lmtt-10">xpdf</span> <span +class="ec-lmtt-10">sample2e.pdf</span></span> +</div> + </div> Unfortunately neither <span +class="ec-lmss-10">gv </span>nor <span +class="ec-lmss-10">xpdf </span>are currently included in <span class="TEX">T<span +class="E">E</span>X</span> Live, so you must install them + separately. See <a +href="http://www.gnu.org/software/gv" class="url" ><span +class="ec-lmtt-10">http://www.gnu.org/software/gv</span></a> and <a +href="http://www.foolabs.com/xpdf" class="url" ><span +class="ec-lmtt-10">http://www.foolabs.com/xpdf</span></a>, + respectively. + </li> + <li + class="enumerate" id="x1-18014x7">Other standard test files you may find useful: + <!--l. 510--><p class="noindent" > + <dl class="list2"><dt class="list"> + <span +class="ec-lmtt-10">small2e.tex</span> </dt><dd +class="list"> + <!--l. 511--><p class="noindent" >A simpler document than <span +class="ec-lmtt-10">sample2e</span>, to reduce the input size if you’re having troubles. + </dd><dt class="list"> + <span +class="ec-lmtt-10">testpage.tex</span> </dt><dd +class="list"> + <!--l. 513--><p class="noindent" >Test if your printer introduces any offsets. + </dd><dt class="list"> + <span +class="ec-lmtt-10">nfssfont.tex</span> </dt><dd +class="list"> + <!--l. 514--><p class="noindent" >For printing font tables and tests. + </dd><dt class="list"> + <span +class="ec-lmtt-10">testfont.tex</span> </dt><dd +class="list"> + <!--l. 515--><p class="noindent" >Also for font tables, but using plain <span class="TEX">T<span +class="E">E</span>X</span>. + </dd><dt class="list"> + <span +class="ec-lmtt-10">story.tex</span> </dt><dd +class="list"> + <!--l. 516--><p class="noindent" >The most canonical (plain) <span class="TEX">T<span +class="E">E</span>X</span> test file of all. You must type ‘<span +class="ec-lmtt-10">\bye</span>’ to the <span +class="ec-lmtt-10">* </span>prompt + after ‘<span +class="ec-lmtt-10">tex story.tex</span>’.</dd></dl> + + <!--l. 520--><p class="noindent" >You can process these in the same way as we did with <span +class="ec-lmtt-10">sample2e.tex</span>. + </li></ol> +<!--l. 525--><p class="indent" > If you are new to <span class="TEX">T<span +class="E">E</span>X</span>, or otherwise need help with actually constructing <span class="TEX">T<span +class="E">E</span>X</span> or <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> +documents, please visit <a +href="http://tug.org/begin.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/begin.html</span></a> for some introductory resources. +<!--l. 1--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">4 </span> <a + id="x1-190004"></a>Post-installation</h3> +<!--l. 4--><p class="noindent" >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. +<!--l. 8--><p class="indent" > Another sort of post-installation is to acquire packages, fonts, or programs that were not included in +<span class="TEX">T<span +class="E">E</span>X</span> Live. The basic idea is to install such additions in the <span +class="ec-lmtt-10">TEXMFLOCAL </span>tree (if you installed to +disk), or <span +class="ec-lmtt-10">TEXMFSYSVAR </span>(if you are running live). See the “Installation directories” option on +p. <a +href="#x1-160003.2">18<!--tex4ht:ref: text:instdir --></a>. +<!--l. 14--><p class="indent" > 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: + <ul class="itemize1"> + <li class="itemize"> <a +href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages" class="url" ><span +class="ec-lmtt-10">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages</span></a> + </li> + <li class="itemize"> <a +href="http://www.ctan.org/installationadvice" class="url" ><span +class="ec-lmtt-10">http://www.ctan.org/installationadvice</span></a> + </li> + <li class="itemize"> <a +href="http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst" class="url" ><span +class="ec-lmtt-10">http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst</span></a> + </li> + <li class="itemize"> <a +href="http://www.ctan.org/tex-archive/info/Type1fonts" class="url" ><span +class="ec-lmtt-10">http://www.ctan.org/tex-archive/info/Type1fonts</span></a> for installation information for + fonts in particular.</li></ul> +<!--l. 30--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">4.1 </span> <a + id="x1-200004.1"></a>Installing individual packages to disk</h4> +<!--l. 32--><p class="noindent" >You can add individual packages or collections from the current distribution to an existing non-<span class="TEX">T<span class="E">E</span>X</span> Live setup, or an earlier <span class="TEX">T<span class="E">E</span>X</span> Live installation. -<!--l. 442--><p class="indent" > To start, you mount the CD or DVD, with Rock Ridge extensions enabled. The exact command to do +<!--l. 36--><p class="indent" > 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 GNU/Linux, except the name of the device (<span class="ec-lmtt-10">/dev/cdrom</span>, here) may vary. (All our examples will use <span class="ec-lmtt-10">> </span>as the shell prompt; user input is <span class="uline"><span -class="ec-lmtt-10">underlined</span></span>.) <div class="alltt"> - -<!--l. 442--><p class="noindent" ><div class="obeylines-v"> <span +class="ec-lmtt-10">underlined</span></span>.) <div class="alltt"> +<!--l. 36--><p class="noindent" ><div class="obeylines-v"> <span class="ec-lmtt-10">> </span><span class="uline"><span class="ec-lmtt-10">mount</span> <span class="ec-lmtt-10">-t</span> <span @@ -1566,17 +1851,18 @@ class="ec-lmtt-10">/dev/cdrom</span> <span class="ec-lmtt-10">/mnt/cdrom</span></span> </div> </div> -<!--l. 442--><p class="noindent" >Change the current directory to the mount point: <div class="alltt"> -<!--l. 442--><p class="noindent" ><div class="obeylines-v"> <span +<!--l. 36--><p class="noindent" >Change the current directory to the mount point: <div class="alltt"> +<!--l. 36--><p class="noindent" ><div class="obeylines-v"> <span class="ec-lmtt-10">> </span><span class="uline"><span class="ec-lmtt-10">cd</span> <span class="ec-lmtt-10">/mnt/cdrom</span></span> </div> </div> -<!--l. 442--><p class="noindent" >(Under Mac OS X, the directory is typically under <span +<!--l. 36--><p class="noindent" >(Under Mac OS X, the directory is typically under <span class="ec-lmtt-10">/Volumes</span>, and the media will be mounted -automatically.) -<!--l. 442--><p class="indent" > Your <span +automatically.) + +<!--l. 36--><p class="indent" > Your <span class="ec-lmtt-10">umask </span>at the time of installation will be respected by the <span class="TEX">T<span class="E">E</span>X</span> Live installer. Therefore, if you want your installation to be usable by users other than you, make sure your setting is sufficiently @@ -1584,11 +1870,11 @@ permissive, for instance, <span class="ec-lmtt-10">umask 002</span>. For more information about <span class="ec-lmtt-10">umask</span>, consult your system documentation. -<!--l. 444--><p class="indent" > Run the installation script <span +<!--l. 38--><p class="indent" > Run the installation script <span class="ec-lmtt-10">install-pkg.sh </span>(not <span class="ec-lmtt-10">install-tl.sh</span>, which is intended for complete installations only): <div class="alltt"> -<!--l. 447--><p class="noindent" ><div class="obeylines-v"> +<!--l. 41--><p class="noindent" ><div class="obeylines-v"> <span class="ec-lmtt-10">></span><span class="ec-lmtt-10"> </span><span class="uline"><span @@ -1597,49 +1883,48 @@ class="ec-lmtt-10">install-pkg.sh</span> <span class="ec-lmro-10">options</span></span> </div> </div> -<!--l. 451--><p class="indent" > The first set of options controls what gets read: -<!--l. 453--><p class="noindent" > +<!--l. 45--><p class="indent" > The first set of options controls what gets read: +<!--l. 47--><p class="noindent" > <dl class="list1"><dt class="list"> <span class="ec-lmtt-10">--package=</span><span class="ec-lmro-10">pkgname</span> </dt><dd class="list"> - <!--l. 454--><p class="noindent" >The individual package to work on. + <!--l. 48--><p class="noindent" >The individual package to work on. </dd><dt class="list"> <span class="ec-lmtt-10">--collection=</span><span class="ec-lmro-10">colname</span> </dt><dd class="list"> - <!--l. 456--><p class="noindent" >The individual collection to work on. + <!--l. 50--><p class="noindent" >The individual collection to work on. </dd><dt class="list"> <span class="ec-lmtt-10">--nodoc</span> </dt><dd class="list"> - <!--l. 458--><p class="noindent" >Exclude documentation files from the operation. + <!--l. 52--><p class="noindent" >Exclude documentation files from the operation. </dd><dt class="list"> <span class="ec-lmtt-10">--nosrc</span> </dt><dd class="list"> - <!--l. 460--><p class="noindent" >Exclude source files from the operation. + <!--l. 54--><p class="noindent" >Exclude source files from the operation. </dd><dt class="list"> <span class="ec-lmtt-10">--cddir=</span><span class="ec-lmro-10">dir</span> </dt><dd class="list"> - <!--l. 462--><p class="noindent" >Source directory to read from; defaults to the current directory. If you followed the + <!--l. 56--><p class="noindent" >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. </dd><dt class="list"> <span class="ec-lmtt-10">--listdir=</span><span class="ec-lmro-10">dir</span> </dt><dd class="list"> - <!--l. 466--><p class="noindent" >The so-called ‘lists’ directory within <span + <!--l. 60--><p class="noindent" >The so-called ‘lists’ directory within <span class="ec-lmro-10">cddir </span>from which to read the package information. The only reason to change the default is if you’re making changes to <span class="TEX">T<span class="E">E</span>X</span> Live yourself. - </dd></dl> - -<!--l. 473--><p class="indent" > What actually happens is controlled by the following options. If neither of these are specified, the + </dd></dl> +<!--l. 67--><p class="indent" > 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 <span class="ec-lmtt-10">$TEXMFMAIN</span> with <span @@ -1647,49 +1932,51 @@ class="ec-lmss-10">kpsewhich</span>. You can override it by setting either the e class="ec-lmtt-10">TEXMFMAIN </span>or <span class="ec-lmtt-10">TEXMF</span>. -<!--l. 480--><p class="noindent" > +<!--l. 74--><p class="noindent" > <dl class="list1"><dt class="list"> <span class="ec-lmtt-10">--listonly</span> </dt><dd class="list"> - <!--l. 481--><p class="noindent" >List the files that would be installed, but don’t actually install anything. + <!--l. 75--><p class="noindent" >List the files that would be installed, but don’t actually install anything. + + </dd><dt class="list"> <span class="ec-lmtt-10">--archive=</span><span class="ec-lmro-10">tarfile</span> </dt><dd class="list"> - <!--l. 484--><p class="noindent" >Instead of installing the files into the <span class="TEX">T<span + <!--l. 78--><p class="noindent" >Instead of installing the files into the <span class="TEX">T<span class="E">E</span>X</span> system, make a <span class="ec-lmss-10">tar </span>archive. </dd></dl> -<!--l. 489--><p class="indent" > Additional options: -<!--l. 491--><p class="noindent" > +<!--l. 83--><p class="indent" > Additional options: +<!--l. 85--><p class="noindent" > <dl class="list1"><dt class="list"> <span class="ec-lmtt-10">--config</span> </dt><dd class="list"> - <!--l. 493--><p class="noindent" >After installation, run <span + <!--l. 87--><p class="noindent" >After installation, run <span class="ec-lmtt-10">texconfig init</span>. </dd><dt class="list"> <span class="ec-lmtt-10">--nohash</span> </dt><dd class="list"> - <!--l. 495--><p class="noindent" >After installation, don’t run <span + <!--l. 89--><p class="noindent" >After installation, don’t run <span class="ec-lmss-10">mktexlsr </span>to rebuild the filename database. </dd><dt class="list"> <span class="ec-lmtt-10">--verbose</span> </dt><dd class="list"> - <!--l. 498--><p class="noindent" >Give more information as the script runs. + <!--l. 92--><p class="noindent" >Give more information as the script runs. </dd></dl> -<!--l. 502--><p class="indent" > Here are some usage examples: -<!--l. 504--><p class="indent" > +<!--l. 96--><p class="indent" > Here are some usage examples: +<!--l. 98--><p class="indent" > <ol class="enumerate1" > <li - class="enumerate" id="x1-17002x1">To see the files in the package <span + class="enumerate" id="x1-20002x1">To see the files in the package <span class="ec-lmss-10">fancyhdr </span>without installing it: <div class="alltt"> - <!--l. 509--><p class="noindent" ><div class="obeylines-v"> + <!--l. 103--><p class="noindent" ><div class="obeylines-v"> <span class="ec-lmtt-10">></span><span class="ec-lmtt-10"> </span><span class="uline"><span @@ -1708,12 +1995,10 @@ class="ec-lmtt-10">...</span> </div> </li> <li - class="enumerate" id="x1-17004x2">Install the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span + class="enumerate" id="x1-20004x2">Install the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span class="E">E</span>X</span></span> package <span class="ec-lmss-10">natbib</span>: <div class="alltt"> - - - <!--l. 520--><p class="noindent" ><div class="obeylines-v"> + <!--l. 114--><p class="noindent" ><div class="obeylines-v"> <span class="ec-lmtt-10">></span><span class="ec-lmtt-10"> </span><span class="uline"><span @@ -1724,10 +2009,12 @@ class="ec-lmtt-10">--package=natbib</span></span> </div> </li> <li - class="enumerate" id="x1-17006x3">Install the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span + class="enumerate" id="x1-20006x3">Install the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span class="E">E</span>X</span></span> package <span class="ec-lmss-10">alg </span>without source files or documentation: <div class="alltt"> - <!--l. 526--><p class="noindent" ><div class="obeylines-v"> + + + <!--l. 120--><p class="noindent" ><div class="obeylines-v"> <span class="ec-lmtt-10">></span><span class="ec-lmtt-10"> </span><span class="uline"><span @@ -1740,9 +2027,9 @@ class="ec-lmtt-10">--nodoc</span></span> </div> </li> <li - class="enumerate" id="x1-17008x4">Install all the packages in the collection of additional plain <span class="TEX">T<span + class="enumerate" id="x1-20008x4">Install all the packages in the collection of additional plain <span class="TEX">T<span class="E">E</span>X</span> macros: <div class="alltt"> - <!--l. 534--><p class="noindent" ><div class="obeylines-v"> + <!--l. 128--><p class="noindent" ><div class="obeylines-v"> <span class="ec-lmtt-10">></span><span class="ec-lmtt-10"> </span><span class="uline"><span @@ -1753,11 +2040,11 @@ class="ec-lmtt-10">--collection=tex-plainextra</span></span> </div> </li> <li - class="enumerate" id="x1-17010x5">Write all files in the <span + class="enumerate" id="x1-20010x5">Write all files in the <span class="ec-lmss-10">pstricks </span>package to a <span class="ec-lmss-10">tar </span>file in <span class="ec-lmtt-10">/tmp</span>: <div class="alltt"> - <!--l. 540--><p class="noindent" ><div class="obeylines-v"> + <!--l. 134--><p class="noindent" ><div class="obeylines-v"> <span class="ec-lmtt-10">></span><span class="ec-lmtt-10"> </span><span class="uline"><span @@ -1768,64 +2055,31 @@ class="ec-lmtt-10">--archive=/tmp/pstricks.tar</span></span> </div> </div> </li></ol> -<!--l. 549--><p class="indent" > If in doubt, please ask any local system gurus to help you with problems; for example, the way to +<!--l. 143--><p class="indent" > If in doubt, please ask any local system gurus to help you with problems; for example, the way to mount the <span class="TEX">T<span class="E">E</span>X</span> Live 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. -<!--l. 1--><p class="noindent" > - <h3 class="sectionHead"><span class="titlemark">4 </span> <a - id="x1-180004"></a>Post-installation</h3> -<!--l. 4--><p class="noindent" >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. -<!--l. 8--><p class="indent" > Another sort of post-installation is to acquire packages, fonts, or programs that were not included in -<span class="TEX">T<span -class="E">E</span>X</span> Live. The basic idea is to install such additions in the <span -class="ec-lmtt-10">TEXMFLOCAL </span>tree (if you installed to -disk), or <span -class="ec-lmtt-10">TEXMFSYSVAR </span>(if you are running live). See the “Installation directories” option on -p. <a -href="#x1-150003.2">17<!--tex4ht:ref: text:instdir --></a>. -<!--l. 14--><p class="indent" > 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: - - <ul class="itemize1"> - <li class="itemize"> <a -href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages" class="url" ><span -class="ec-lmtt-10">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages</span></a> - </li> - <li class="itemize"> <a -href="http://www.ctan.org/installationadvice" class="url" ><span -class="ec-lmtt-10">http://www.ctan.org/installationadvice</span></a> - </li> - <li class="itemize"> <a -href="http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst" class="url" ><span -class="ec-lmtt-10">http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst</span></a> - </li> - <li class="itemize"> <a -href="http://www.ctan.org/tex-archive/info/Type1fonts" class="url" ><span -class="ec-lmtt-10">http://www.ctan.org/tex-archive/info/Type1fonts</span></a> for installation information for - fonts in particular.</li></ul> -<!--l. 29--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">4.1 </span> <a - id="x1-190004.1"></a>The <span +<!--l. 146--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">4.2 </span> <a + id="x1-210004.2"></a>The <span class="ec-lmss-10">texconfig </span>program</h4> -<!--l. 32--><p class="noindent" >At any time after installation, you can and should use the program <span +<!--l. 149--><p class="noindent" >At any time after installation, you can and should use the program <span class="ec-lmss-10">texconfig </span>to configure the system to fit your local needs. It is installed in the architecture-specific subdirectory <span class="ec-lmtt-10">TEXDIR/bin/</span><span class="ec-lmro-10">arch </span>along with everything else. -<!--l. 37--><p class="indent" > If you run it without arguments, it will enter full-screen mode and allow you to view and change +<!--l. 154--><p class="indent" > If you run it without arguments, it will enter full-screen mode and allow you to view and change options interactively. -<!--l. 40--><p class="indent" > You can also run it with various command-line options. Here are some of the most common (<span class="TEX">T<span +<!--l. 157--><p class="indent" > You can also run it with various command-line options. Here are some of the most common (<span class="TEX">T<span class="E">E</span>X</span> Live is configured for the A4 paper size by default): -<!--l. 43--><p class="noindent" > +<!--l. 160--><p class="noindent" > <dl class="list1"><dt class="list"> <span class="ec-lmtt-10">texconfig paper letter</span> </dt><dd class="list"> - <!--l. 45--><p class="noindent" >Set default paper size for various programs and drivers (<span + <!--l. 162--><p class="noindent" >Set default paper size for various programs and drivers (<span class="ec-lmss-10">pdftex</span>, <span class="ec-lmss-10">dvips</span>, <span class="ec-lmss-10">dvipdfm</span>, <span @@ -1836,13 +2090,14 @@ class="ec-lmtt-10">a4</span>, which is the default. <span class="ec-lmtt-10">texconfig rehash</span> </dt><dd class="list"> - <!--l. 50--><p class="noindent" >Update all the <span class="TEX">T<span -class="E">E</span>X</span> “filename databases”, after adding or removing files. + <!--l. 167--><p class="noindent" >Update all the <span class="TEX">T<span +class="E">E</span>X</span> “filename databases”, after adding or removing files. + </dd><dt class="list"> <span class="ec-lmtt-10">texconfig faq</span> </dt><dd class="list"> - <!--l. 53--><p class="noindent" >Show the te<span class="TEX">T<span + <!--l. 170--><p class="noindent" >Show the te<span class="TEX">T<span class="E">E</span>X</span> FAQ. (See also the main <span class="TEX">T<span class="E">E</span>X</span> FAQ in <a href="../../../../texmf-doc/doc/english/FAQ-en" >texmf-doc/doc/english/FAQ-en</a>.) @@ -1850,10 +2105,10 @@ href="../../../../texmf-doc/doc/english/FAQ-en" >texmf-doc/doc/english/FAQ-en</a <span class="ec-lmtt-10">texconfig help</span> </dt><dd class="list"> - <!--l. 56--><p class="noindent" >Output help information for <span + <!--l. 173--><p class="noindent" >Output help information for <span class="ec-lmss-10">texconfig</span>. </dd></dl> -<!--l. 60--><p class="indent" > Of course, <span +<!--l. 177--><p class="indent" > Of course, <span class="ec-lmss-10">texconfig </span>can only support changing a few of the many options and configuration parameters in a <span class="TEX">T<span class="E">E</span>X</span> system. The main configuration file for the base Web2C programs is named @@ -1861,7 +2116,7 @@ class="E">E</span>X</span> system. The main configuration file for the base Web2 class="ec-lmtt-10">texmf.cnf</span>. You can find its location by running ‘<span class="ec-lmtt-10">kpsewhich texmf.cnf</span>’; it contains many comments explaining the default settings and useful alternatives. -<!--l. 67--><p class="indent" > <span +<!--l. 184--><p class="indent" > <span class="ec-lmss-10">texconfig </span>alters files in a user-specific directory, as in <span class="ec-lmtt-10">$HOME/.texlive2007</span>. If you install <span class="TEX">T<span class="E">E</span>X</span> just @@ -1871,233 +2126,32 @@ want to change the configuration for the whole system. In this case, run <span class="ec-lmss-10">texconfig-sys </span>instead of <span class="ec-lmss-10">texconfig</span>. -<!--l. 74--><p class="indent" > Likewise, the <span +<!--l. 191--><p class="indent" > Likewise, the <span class="ec-lmss-10">updmap </span>and <span class="ec-lmss-10">fmtutil </span>scripts were changed, to work under <span class="ec-lmtt-10">$HOME/.texliveYYYY</span>. To alter system directories, use <span class="ec-lmss-10">updmap-sys </span>and <span class="ec-lmss-10">fmtutil-sys</span>. -<!--l. 78--><p class="indent" > In particular, for multi-user systems, you will probably want to pregenerate the standard formats +<!--l. 195--><p class="indent" > In particular, for multi-user systems, you will probably want to pregenerate the standard formats with <span -class="ec-lmtt-10">fmtutil-sys –missing</span>. Otherwise, each user will end up with their own formats. - -<!--l. 82--><p class="indent" > Also, if you have a personally-modified copy of <span +class="ec-lmtt-10">fmtutil-sys –missing</span>. Otherwise, each user will end up with their own formats. +<!--l. 199--><p class="indent" > Also, if you have a personally-modified copy of <span class="ec-lmtt-10">fmtutil.cnf </span>or <span class="ec-lmtt-10">updmap.cfg</span>, instead of using the ones generated by installation, they must be installed in the tree referenced by the variable <span class="ec-lmtt-10">TEXMFSYSCONFIG</span>. -<!--l. 87--><p class="indent" > The variables specifying the directories altered by these commands are listed in section <a -href="#x1-100002.3">2.3<!--tex4ht:ref: sec:texmftrees --></a>, p. <a -href="#x1-100002.3">8<!--tex4ht:ref: sec:texmftrees --></a>. You +<!--l. 204--><p class="indent" > The variables specifying the directories altered by these commands are listed in section <a +href="#x1-110002.3">2.3<!--tex4ht:ref: sec:texmftrees --></a>, p. <a +href="#x1-110002.3">8<!--tex4ht:ref: sec:texmftrees --></a>. You can see the actual directories by running <span class="ec-lmtt-10">texconfig conf</span>, and you can change them by editing <span class="ec-lmtt-10">texmf.cnf</span>. -<!--l. 93--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">4.2 </span> <a - id="x1-200004.2"></a>Testing the installation</h4> -<!--l. 96--><p class="noindent" >After installing <span class="TEX">T<span -class="E">E</span>X</span> Live as best you can, you naturally want to test it out, so you can start creating -beautiful documents and/or fonts. -<!--l. 99--><p class="indent" > This section gives some basic procedures for testing that the new system is functional. We give Unix -commands; under Mac OS X and Windows, you’re more likely to run the tests through a graphical -interface, but the principles are the same. -<!--l. 104--><p class="indent" > - <ol class="enumerate1" > - <li - class="enumerate" id="x1-20002x1">Make sure that you can run the <span -class="ec-lmss-10">tex </span>program in the first place: - <div class="alltt"> - <!--l. 109--><p class="noindent" ><div class="obeylines-v"> - <span -class="ec-lmtt-10">></span><span -class="ec-lmtt-10"> </span><span class="uline"><span -class="ec-lmtt-10">tex</span> <span -class="ec-lmtt-10">--version</span></span> - <br /><span -class="ec-lmtt-10">TeX</span><span -class="ec-lmtt-10"> 3.141592</span><span -class="ec-lmtt-10"> (Web2C</span><span -class="ec-lmtt-10"> 7.5.5)</span> - <br /><span -class="ec-lmtt-10">kpathsea</span><span -class="ec-lmtt-10"> version</span><span -class="ec-lmtt-10"> 3.5.5</span> - <br /><span -class="ec-lmtt-10">...</span> -</div> - </div> If this comes back with ‘command not found’ instead of version and copyright information, most - likely you don’t have the correct <span -class="ec-lmtt-10">bin </span>subdirectory in your <span -class="ec-lmtt-10">PATH</span>. See the environment-setting - information on p. <span -class="ec-lmbx-10">??</span>. - </li> - <li - class="enumerate" id="x1-20004x2">Process a basic <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> file: <div class="alltt"> - <!--l. 121--><p class="noindent" ><div class="obeylines-v"> - <span -class="ec-lmtt-10">></span><span -class="ec-lmtt-10"> </span><span class="uline"><span -class="ec-lmtt-10">latex</span> <span -class="ec-lmtt-10">sample2e.tex</span></span> - <br /><span -class="ec-lmtt-10">This</span><span -class="ec-lmtt-10"> is</span><span -class="ec-lmtt-10"> pdfeTeXk,</span><span -class="ec-lmtt-10"> Version</span><span -class="ec-lmtt-10"> 3.141592...</span> - <br /><span -class="ec-lmtt-10">...</span> - <br /><span -class="ec-lmtt-10">Output</span><span -class="ec-lmtt-10"> written</span><span -class="ec-lmtt-10"> on</span><span -class="ec-lmtt-10"> sample2e.dvi</span><span -class="ec-lmtt-10"> (3</span><span -class="ec-lmtt-10"> pages,</span><span -class="ec-lmtt-10"> 7496</span><span -class="ec-lmtt-10"> bytes).</span> - <br /><span -class="ec-lmtt-10">Transcript</span><span -class="ec-lmtt-10"> written</span><span -class="ec-lmtt-10"> on</span><span -class="ec-lmtt-10"> sample2e.log.</span> -</div> - </div> If this fails to find <span -class="ec-lmtt-10">sample2e.tex </span>or other files, perhaps you have interference from old - environment variables or configuration files. For a deep analysis, you can always ask <span class="TEX">T<span -class="E">E</span>X</span> to - report on exactly what it is searching for, and finding; see “Debugging actions” on - page <a -href="#x1-670008.2.4">61<!--tex4ht:ref: Debugging --></a>. - </li> - <li - class="enumerate" id="x1-20006x3">Preview the result online: <div class="alltt"> - - <!--l. 135--><p class="noindent" ><div class="obeylines-v"> - <span -class="ec-lmtt-10">></span><span -class="ec-lmtt-10"> </span><span class="uline"><span -class="ec-lmtt-10">xdvi</span> <span -class="ec-lmtt-10">sample2e.dvi</span></span> -</div> - </div> (Under Windows, the analogous command is <span -class="ec-lmss-10">dviout</span>.) You should see a new window with a nice - document explaining some of the basics of <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>. (Well worth reading, by the way if you’re new - to the system.) You do have to be running under X for <span -class="ec-lmss-10">xdvi </span>to work; if you’re not, or - your <span -class="ec-lmtt-10">DISPLAY </span>environment variable is set incorrectly, you’ll get an error ‘<span -class="ec-lmtt-10">Can’t open</span> - <span -class="ec-lmtt-10">display</span>’. - </li> - <li - class="enumerate" id="x1-20008x4">Create a PostScript file for printing or display: <div class="alltt"> - <!--l. 146--><p class="noindent" ><div class="obeylines-v"> - <span -class="ec-lmtt-10">></span><span -class="ec-lmtt-10"> </span><span class="uline"><span -class="ec-lmtt-10">dvips</span> <span -class="ec-lmtt-10">sample2e.dvi</span> <span -class="ec-lmtt-10">-o</span> <span -class="ec-lmtt-10">sample2e.ps</span></span> -</div> - </div> - </li> - <li - class="enumerate" id="x1-20010x5">Create a PDF file instead of DVI; this processes the <span -class="ec-lmtt-10">.tex </span>file and writes PDF directly: - <div class="alltt"> - <!--l. 152--><p class="noindent" ><div class="obeylines-v"> - <span -class="ec-lmtt-10">></span><span -class="ec-lmtt-10"> </span><span class="uline"><span -class="ec-lmtt-10">pdflatex</span> <span -class="ec-lmtt-10">sample2e.tex</span></span> -</div> - </div> - </li> - <li - class="enumerate" id="x1-20012x6">Preview the PDF file: <div class="alltt"> - <!--l. 157--><p class="noindent" ><div class="obeylines-v"> - <span -class="ec-lmtt-10">></span><span -class="ec-lmtt-10"> </span><span class="uline"><span -class="ec-lmtt-10">gv</span> <span -class="ec-lmtt-10">sample2e.pdf</span></span> - <br />or: - <br /><span -class="ec-lmtt-10">></span><span -class="ec-lmtt-10"> </span><span class="uline"><span -class="ec-lmtt-10">xpdf</span> <span -class="ec-lmtt-10">sample2e.pdf</span></span> -</div> - </div> Unfortunately neither <span -class="ec-lmss-10">gv </span>nor <span -class="ec-lmss-10">xpdf </span>are currently included in <span class="TEX">T<span -class="E">E</span>X</span> Live, so you must install them - separately. See <a -href="http://www.gnu.org/software/gv" class="url" ><span -class="ec-lmtt-10">http://www.gnu.org/software/gv</span></a> and <a -href="http://www.foolabs.com/xpdf" class="url" ><span -class="ec-lmtt-10">http://www.foolabs.com/xpdf</span></a>, - respectively. - </li> - <li - class="enumerate" id="x1-20014x7">Other standard test files you may find useful: - <!--l. 169--><p class="noindent" > - <dl class="list2"><dt class="list"> - <span -class="ec-lmtt-10">small2e.tex</span> </dt><dd -class="list"> - <!--l. 170--><p class="noindent" >A simpler document than <span -class="ec-lmtt-10">sample2e</span>, to reduce the input size if you’re having troubles. - - </dd><dt class="list"> - <span -class="ec-lmtt-10">testpage.tex</span> </dt><dd -class="list"> - <!--l. 172--><p class="noindent" >Test if your printer introduces any offsets. - </dd><dt class="list"> - <span -class="ec-lmtt-10">nfssfont.tex</span> </dt><dd -class="list"> - <!--l. 173--><p class="noindent" >For printing font tables and tests. - </dd><dt class="list"> - <span -class="ec-lmtt-10">testfont.tex</span> </dt><dd -class="list"> - <!--l. 174--><p class="noindent" >Also for font tables, but using plain <span class="TEX">T<span -class="E">E</span>X</span>. - </dd><dt class="list"> - <span -class="ec-lmtt-10">story.tex</span> </dt><dd -class="list"> - <!--l. 175--><p class="noindent" >The most canonical (plain) <span class="TEX">T<span -class="E">E</span>X</span> test file of all. You must type ‘<span -class="ec-lmtt-10">\bye</span>’ to the <span -class="ec-lmtt-10">* </span>prompt - after ‘<span -class="ec-lmtt-10">tex story.tex</span>’.</dd></dl> - <!--l. 179--><p class="noindent" >You can process these in the same way as we did with <span -class="ec-lmtt-10">sample2e.tex</span>. - </li></ol> -<!--l. 184--><p class="indent" > If you are new to <span class="TEX">T<span -class="E">E</span>X</span>, or otherwise need help with actually constructing <span class="TEX">T<span -class="E">E</span>X</span> or <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> -documents, please visit <a -href="http://tug.org/begin.html" class="url" ><span -class="ec-lmtt-10">http://tug.org/begin.html</span></a> for some introductory resources. <!--l. 1--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">5 </span> <a - id="x1-210005"></a>Mac OS X installation</h3> + id="x1-220005"></a>Mac OS X installation</h3> <!--l. 4--><p class="noindent" >The recommended way to install <span class="TEX">T<span class="E">E</span>X</span> on Mac OS X is from the Mac<span class="TEX">T<span class="E">E</span>X</span> distribution, new in @@ -2128,27 +2182,27 @@ Internet, or more likely upgrade your system. <!--l. 21--><p class="indent" > Once you have <span class="ec-lmss-10">bash</span>, the Unix installation documentation in the previous section can be followed. See section <a -href="#x1-130003">3<!--tex4ht:ref: sec:unix-install --></a> on p. <a -href="#x1-130003">10<!--tex4ht:ref: sec:unix-install --></a>; Mac OS X-specific notes are included there where needed. +href="#x1-140003">3<!--tex4ht:ref: sec:install --></a> on p. <a +href="#x1-140003">10<!--tex4ht:ref: sec:install --></a>; Mac OS X-specific notes are included there where needed. <!--l. 1--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">6 </span> <a - id="x1-220006"></a>Windows installation</h3> + id="x1-230006"></a>Windows installation</h3> <!--l. 4--><p class="noindent" >In this release of <span class="TEX">T<span class="E">E</span>X</span> Live, the same installer should work under Windows as Unix, except that it defaults to GUI mode<span class="footnote-mark"><a href="#fn1x0" id="fn1x0-bk"><sup class="textsuperscript">1</sup></a></span><a - id="x1-22001f1"></a>. + id="x1-23001f1"></a>. + + <!--l. 12--><p class="indent" > <span class="TEX">T<span class="E">E</span>X</span> Live can be installed on systems running 2K, XP or Vista. Older versions of Windows (ME, 9<span class="ec-lmri-10">x</span>, NT Windows (3.1x) and MS-DOS) are not supported. <!--l. 16--><p class="indent" > The necessary environment settings are created without user intervention. The installer also creates menu entries and an uninstaller. - - <!--l. 22--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">6.1 </span> <a - id="x1-230006.1"></a>Portable <span class="TEX">T<span + id="x1-240006.1"></a>Portable <span class="TEX">T<span class="E">E</span>X</span> Live on DVD and USB (Windows)</h4> <!--l. 24--><p class="noindent" >It is possible to use the <span class="TEX">T<span class="E">E</span>X</span> system directly from the <span @@ -2158,8 +2212,8 @@ class="E">E</span>X</span> ‘Live’, in fact.) It is <span class="ec-lmri-10">not </span>possible to run <span class="TEX">T<span class="E">E</span>X</span> directly from the other CDs (see section <a -href="#x1-80002.1">2.1<!--tex4ht:ref: sec:multiple-dist --></a>, p. <a -href="#x1-80002.1">6<!--tex4ht:ref: sec:multiple-dist --></a>). +href="#x1-90002.1">2.1<!--tex4ht:ref: sec:multiple-dist --></a>, p. <a +href="#x1-90002.1">6<!--tex4ht:ref: sec:multiple-dist --></a>). <!--l. 26--><p class="indent" > Then, view the DVD contents and double-click <span class="ec-lmtt-10">tl-portable.bat</span>. (Alternatively, start a ‘Command Prompt’ and run it that way.) The first time this batch script runs, some files will be generated in a @@ -2170,14 +2224,14 @@ script will start almost instantaneously. class="E">E</span>X</span>. <!--l. 35--><p class="indent" > For information about running <span class="TEX">T<span class="E">E</span>X</span> Live from a USB stick, see section <a -href="#x1-140003.1">3.1<!--tex4ht:ref: sec:portable-unix --></a>. +href="#x1-150003.1">3.1<!--tex4ht:ref: sec:portable-unix --></a>. <!--l. 40--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">6.2 </span> <a - id="x1-240006.2"></a>Starting the installer</h4> + id="x1-250006.2"></a>Starting the installer</h4> <!--l. 42--><p class="noindent" >Beschrijf ook net installer, met screenshot <!--l. 46--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">6.3 </span> <a - id="x1-250006.3"></a>Installing <span class="TEX">T<span + id="x1-260006.3"></a>Installing <span class="TEX">T<span class="E">E</span>X</span> Live to disk</h4> <!--l. 48--><p class="noindent" >After inserting the <span class="TEX">T<span class="E">E</span>X</span> Live CD into the CD drive, Windows’ autostart feature should activate @@ -2199,7 +2253,7 @@ class="E">E</span>X</span> Live CD (or TeX Collection DVD), and then click OK. <!--l. 57--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">6.3.1 </span> <a - id="x1-260006.3.1"></a>Selecting what to install</h5> + id="x1-270006.3.1"></a>Selecting what to install</h5> <!--l. 59--><p class="noindent" ><span class="TEX">T<span class="E">E</span>X</span> Live contains a lot of packages, and you probably don’t want to go through the entire list to decide what to install and what not. If you have the space, there is nothing wrong with selecting ‘full’. @@ -2209,11 +2263,13 @@ some more fine-grained choices. But you can also add or remove packages afterwar ... <!--l. 68--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">6.3.2 </span> <a - id="x1-270006.3.2"></a>Selecting where to install</h5> + id="x1-280006.3.2"></a>Selecting where to install</h5> <!--l. 70--><p class="noindent" >The <span class="TEX">T<span class="E">E</span>X</span> Live installer proposes a standard directory layout in a standard location. You can simply change its root ‘TEXDIR’ and other directories will be modified accordingly. You can also customize the layout itself. + + <!--l. 75--><p class="indent" > The installer will warn you if a directory isn’t writable or cannot be created. E.g. if you don’t have write permissions for Program Files, you can choose <img src="live0x.png" alt="˜/ " class="tilde" ><span @@ -2236,8 +2292,6 @@ class="ec-lmss-10">Select systems</span>, <span class="ec-lmss-10">Directories </span>and <span class="ec-lmss-10">Options</span>. - - <!--l. 89--><p class="indent" > By default, <span class="ec-lmss-10">tlpmgui </span>tries to detect if <span class="TEX">T<span class="E">E</span>X</span> is already installed and depending on the result starts @@ -2339,15 +2393,14 @@ class="ec-lmss-10">Start</span><span class="lmsy-10">→</span><span class="ec-lmss-10">Programs</span><span class="lmsy-10">→</span><span -class="ec-lmss-10">TeXLive2007</span>. +class="ec-lmss-10">TeXLive2007</span>. + <!--l. 161--><p class="indent" > If it is needed (Win9x/WinME), you will be asked to reboot your computer. <!--l. 163--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">6.4 </span> <a - id="x1-280006.4"></a>Support packages for Windows</h4> + id="x1-290006.4"></a>Support packages for Windows</h4> <!--l. 166--><p class="noindent" >To be complete, a <span class="TEX">T<span class="E">E</span>X</span> Live 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 PostScript interpreter to render or to convert files. A graphic file toolbox is also needed in some cases. Last but not least, a <span class="TEX">T<span @@ -2433,7 +2486,8 @@ class="ec-lmtt-10">http://www.winshell.de</span></a> <li class="itemize"><span class="ec-lmss-10">WinEdt </span>is shareware available from <a href="http://www.winedt.com" class="url" ><span -class="ec-lmtt-10">http://www.winedt.com</span></a> +class="ec-lmtt-10">http://www.winedt.com</span></a> + </li> <li class="itemize"><span class="ec-lmss-10">Vim </span>is available from <a @@ -2444,8 +2498,6 @@ class="ec-lmtt-10">http://www.vim.org</span></a> href="http://www.toolscenter.org" class="url" ><span class="ec-lmtt-10">http://www.toolscenter.org</span></a> and in the proTeXt distribution. - - </li> <li class="itemize"><span class="ec-lmss-10">LEd </span>is available from <a @@ -2469,14 +2521,14 @@ href="http://www.cs.wisc.edu/~ghost/gsview/" class="url" ><span class="ec-lmtt-10">http://www.cs.wisc.edu/~ghost/gsview/</span></a> or any CTAN site. <!--l. 227--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">7 </span> <a - id="x1-290007"></a>Maintenance of the installation in Windows</h3> + id="x1-300007"></a>Maintenance of the installation in Windows</h3> <!--l. 229--><p class="noindent" >If you have <span class="TEX">T<span class="E">E</span>X</span> Live installed, you can use <span class="ec-lmss-10">tlpmgui </span>again for modifying and maintaining your installation. <!--l. 232--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">7.1 </span> <a - id="x1-300007.1"></a>Adding/removing packages</h4> + id="x1-310007.1"></a>Adding/removing packages</h4> <!--l. 234--><p class="noindent" >As the <span class="ec-lmss-10">tlpmgui </span>shortcut is available in the <span class="ec-lmss-10">Start</span><span @@ -2523,17 +2575,16 @@ class="ec-lmss-10">Buttons </span>section displays a short description of the se in the <span class="ec-lmss-10">Info about the selected item </span>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. + the mouse pointer while holding down the left mouse button. + </li> <li class="itemize">Click the <span class="ec-lmss-10">Install </span>or <span class="ec-lmss-10">Remove </span>button in the <span class="ec-lmss-10">Buttons </span>section to perform the appropriate action.</li></ul> - - <!--l. 273--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">7.2 </span> <a - id="x1-310007.2"></a>Configuring and other management tasks</h4> + id="x1-320007.2"></a>Configuring and other management tasks</h4> <!--l. 275--><p class="noindent" >The functions available in the tab labelled <span class="ec-lmss-10">Manage the installation </span>are helpful in performing actions needed when you want to add support for a language which was not selected during the installation, or @@ -2562,11 +2613,11 @@ class="ec-lmtt-10">updmap.cfg</span>), followed by a <span class="ec-lmtt-10">ls-R </span>database files refresh. <!--l. 296--><p class="indent" > For more information about the configuration see section <a -href="#x1-370007.8">7.8<!--tex4ht:ref: sec:persconf --></a>, p. <a -href="#x1-370007.8">38<!--tex4ht:ref: sec:persconf --></a>. +href="#x1-380007.8">7.8<!--tex4ht:ref: sec:persconf --></a>, p. <a +href="#x1-380007.8">39<!--tex4ht:ref: sec:persconf --></a>. <!--l. 299--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">7.3 </span> <a - id="x1-320007.3"></a>Uninstalling <span class="TEX">T<span + id="x1-330007.3"></a>Uninstalling <span class="TEX">T<span class="E">E</span>X</span> Live</h4> <!--l. 301--><p class="noindent" >The tab labelled <span class="ec-lmss-10">Remove the TeX Live installation </span>opens a window which contains functionality not worth @@ -2579,7 +2630,7 @@ class="ec-lmss-10">tlpmgui </span>and related files will not be deleted. You wil manual cleanup to actually remove them. <!--l. 311--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">7.4 </span> <a - id="x1-330007.4"></a>Adding your own packages to the installation</h4> + id="x1-340007.4"></a>Adding your own packages to the installation</h4> <!--l. 313--><p class="noindent" >First, whatever changes you make, <span class="ec-lmbx-10">do not forget to rebuild the ls-R database files</span>. Otherwise, your new files will not be found. You can do this either via the <span @@ -2593,7 +2644,8 @@ class="E">E</span>X</span> Live distribution, it is recommended to put them in the <span class="ec-lmtt-10">$TEXMFLOCAL </span>directory. This way, you will be safe against upgrades of the <span class="TEX">T<span class="E">E</span>X</span> Live -software. +software. + <!--l. 323--><p class="indent" > The directory pointed to by <span class="ec-lmtt-10">$TEXMFLOCAL </span>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 @@ -2605,7 +2657,7 @@ class="newline" /><span class="ec-lmtt-10">c:\TeXLive2007\texmf-local\doc\latex\maple\</span> <!--l. 329--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">7.5 </span> <a - id="x1-340007.5"></a>Running <span + id="x1-350007.5"></a>Running <span class="ec-lmtt-10">tlmp.exe </span>from the command line</h4> <!--l. 330--><p class="noindent" >The <span class="ec-lmss-10">tlpm.exe </span>program which is used as engine by <span @@ -2618,7 +2670,7 @@ class="verbatim"><tr class="verbatim"><td class="verbatim"><div class="verbatim"> <div class="fancyvrb" id="fancyvrb2"> <a - id="x1-34002r1"></a>  tlpm --help + id="x1-35002r1"></a>  tlpm --help </div> </div> </td></tr></table> @@ -2627,7 +2679,7 @@ class="verbatim"><div class="verbatim"> class="ec-lmtt-10">tlpm.readme</span>. <!--l. 338--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">7.6 </span> <a - id="x1-350007.6"></a>Network installation</h4> + id="x1-360007.6"></a>Network installation</h4> <!--l. 340--><p class="noindent" >Kpathsea 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 <span @@ -2653,7 +2705,7 @@ class="ec-lmtt-10">$TEXMFVAR </span>to be a local directory which will hold local configuration files and on-the-fly generated files.</li></ul> <!--l. 359--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">7.7 </span> <a - id="x1-360007.7"></a>What’s different in Windows?</h4> + id="x1-370007.7"></a>What’s different in Windows?</h4> <!--l. 361--><p class="noindent" >The Windows version of Web2C has some specific features that should be pointed out. <!--l. 364--><p class="indent" > <dl class="description"><dt class="description"> @@ -2696,10 +2748,10 @@ class="ec-lmtt-10">time</span> </dd></dl> <!--l. 401--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">7.8 </span> <a - id="x1-370007.8"></a>Personal configurations</h4> + id="x1-380007.8"></a>Personal configurations</h4> <!--l. 404--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">7.8.1 </span> <a - id="x1-380007.8.1"></a>Dvips</h5> + id="x1-390007.8.1"></a>Dvips</h5> <!--l. 406--><p class="noindent" >The configuration file for dvips can be found in<br class="newline" /><span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">C:\TeXLive2007\texmf-var\dvips\config\config.ps</span></span></span><br @@ -2728,11 +2780,11 @@ class="verbatim"><tr class="verbatim"><td class="verbatim"><div class="verbatim"> <div class="fancyvrb" id="fancyvrb3"> <a - id="x1-38002r1"></a>  o lpt1: + id="x1-39002r1"></a>  o lpt1: <br class="fancyvrb" /><a - id="x1-38004r2"></a>  % o | lpr -S server -P myprinter + id="x1-39004r2"></a>  % o | lpr -S server -P myprinter <br class="fancyvrb" /><a - id="x1-38006r3"></a>  % o \\server\myprinter + id="x1-39006r3"></a>  % o \\server\myprinter </div> </div> </td></tr></table> @@ -2759,7 +2811,7 @@ class="ec-lmtt-10">updmap.cfg</span></span></span> in <span class="ec-lmtt-10">$TEXMFVAR/web2c</span>. <!--l. 444--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">7.8.2 </span> <a - id="x1-390007.8.2"></a>PdfTeX</h5> + id="x1-400007.8.2"></a>PdfTeX</h5> <!--l. 446--><p class="noindent" >If you use the program pdflatex to write PDF format directly, and you are using US letter-size paper, edit the file <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">C:\TeXLive2007\texmf-var\tex\generic\config\pdftexconfig.tex</span></span></span> and change @@ -2779,7 +2831,7 @@ class="ec-lmtt-10"> in</span> </div> Save the file and exit the editor. <!--l. 457--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">7.8.3 </span> <a - id="x1-400007.8.3"></a>Xe<span class="TEX">T<span + id="x1-410007.8.3"></a>Xe<span class="TEX">T<span class="E">E</span>X</span></h5> <!--l. 458--><p class="noindent" >Xe<span class="TEX">T<span class="E">E</span>X</span> for Windows is linked statically with fontconfig 2.4.2. A configuration file for fontconfig is @@ -2792,7 +2844,7 @@ class="ec-lmtt-10">kpsewhich –var-value=FONTCONFIG_PATH</span>. <!--l. 463--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">7.8.4 </span> <a - id="x1-410007.8.4"></a>GSView</h5> + id="x1-420007.8.4"></a>GSView</h5> <!--l. 464--><p class="noindent" >GSView is distributed under the AFPL (which is not a free software license), and therefore is not included in <span class="TEX">T<span class="E">E</span>X</span> Live. @@ -2815,13 +2867,13 @@ class="ec-lmtt-10">.eps </span>files to automatically open with <span class="ec-lmss-10">GSView</span>. <!--l. 477--><p class="indent" > For printing instructions, see section <a -href="#x1-430007.10">7.10<!--tex4ht:ref: printing --></a> below. +href="#x1-440007.10">7.10<!--tex4ht:ref: printing --></a> below. <!--l. 480--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">7.9 </span> <a - id="x1-420007.9"></a>Testing</h4> + id="x1-430007.9"></a>Testing</h4> <!--l. 482--><p class="noindent" >For generic verification procedures, see section <a -href="#x1-200004.2">4.2<!--tex4ht:ref: sec:test-install --></a> (p. <a -href="#x1-200004.2">28<!--tex4ht:ref: sec:test-install --></a>). This section describes Windows-specific +href="#x1-180003.3">3.3<!--tex4ht:ref: sec:test-install --></a> (p. <a +href="#x1-180003.3">24<!--tex4ht:ref: sec:test-install --></a>). This section describes Windows-specific tests. <!--l. 486--><p class="indent" > Open the file <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">sample2e.tex</span></span></span> in your editor (Xemacs, WinShell), found in <span @@ -2848,7 +2900,7 @@ class="E">E</span>X</span></span> cannot find a file, you can press Ctrl-z to quit. <!--l. 501--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">7.10 </span> <a - id="x1-430007.10"></a>Printing</h4> + id="x1-440007.10"></a>Printing</h4> <!--l. 504--><p class="noindent" >It is possible to print from <span class="ec-lmss-10">dviout</span>. 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 @@ -2893,10 +2945,10 @@ class="ec-lmss-10">Device </span>list.) <!--l. 532--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">7.11 </span> <a - id="x1-440007.11"></a>Tips and tricks for Win32</h4> + id="x1-450007.11"></a>Tips and tricks for Win32</h4> <!--l. 534--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">7.11.1 </span> <a - id="x1-450007.11.1"></a>Different flavors of Win32</h5> + id="x1-460007.11.1"></a>Different flavors of Win32</h5> <!--l. 536--><p class="noindent" >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 SDK) that you can use to write programs for different operating systems of the Windows family. @@ -2931,7 +2983,7 @@ are true multitasking environments, with protected memory. They are much more re because of better memory management, better file system and so on. <!--l. 576--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">7.11.2 </span> <a - id="x1-460007.11.2"></a>Command line prompt</h5> + id="x1-470007.11.2"></a>Command line prompt</h5> <!--l. 578--><p class="noindent" >You may wonder, “Why would I need to use a command line prompt when I have Windows?” <!--l. 581--><p class="indent" > 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 @@ -2987,7 +3039,7 @@ class="ec-lmri-10">DOS</span> <!--l. 616--><p class="indent" > These locations may change across different Windows versions. <!--l. 618--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">7.11.3 </span> <a - id="x1-470007.11.3"></a>Path separators</h5> + id="x1-480007.11.3"></a>Path separators</h5> <!--l. 620--><p class="noindent" >The Win32 API understands both <span class="ec-lmtt-10">/ </span>and <span class="ec-lmtt-10">\ </span>characters as PATH separators. But the command @@ -3003,7 +3055,7 @@ class="E">E</span>X</span> Live is a port of Web2C, and aims to be compatible ac the configuration files that need to specify path names use the Unix convention. <!--l. 632--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">7.11.4 </span> <a - id="x1-480007.11.4"></a>File systems</h5> + id="x1-490007.11.4"></a>File systems</h5> <!--l. 635--><p class="noindent" >The worst feature of Win9x with regard to <span class="TEX">T<span class="E">E</span>X</span> is probably the so-called FAT file system. <span class="TEX">T<span class="E">E</span>X</span> uses @@ -3020,7 +3072,7 @@ needs. manage clusters of 4kB only. (You can lower the limit to 512 bytes on NTFS.) <!--l. 648--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">7.11.5 </span> <a - id="x1-490007.11.5"></a>How to add some directory to your PATH</h5> + id="x1-500007.11.5"></a>How to add some directory to your PATH</h5> <!--l. 650--><p class="noindent" >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 @@ -3047,7 +3099,7 @@ class="verbatim"><tr class="verbatim"><td class="verbatim"><div class="verbatim"> <div class="fancyvrb" id="fancyvrb4"> <a - id="x1-49002r1"></a>  PATH=c:\windows;c:\windows\system;c:\TeXLive2007\bin\win32 + id="x1-50002r1"></a>  PATH=c:\windows;c:\windows\system;c:\TeXLive2007\bin\win32 </div> </div> </td></tr></table> @@ -3109,14 +3161,14 @@ class="verbatim"><tr class="verbatim"><td class="verbatim"><div class="verbatim"> <div class="fancyvrb" id="fancyvrb5"> <a - id="x1-49004r1"></a>  set VARIABLE + id="x1-50004r1"></a>  set VARIABLE </div> </div> </td></tr></table> <!--l. 706--><p class="nopar" >which should return the corresponding value. <!--l. 709--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">7.11.6 </span> <a - id="x1-500007.11.6"></a><span class="TEX">T<span + id="x1-510007.11.6"></a><span class="TEX">T<span class="E">E</span>X</span> engines</h5> <!--l. 711--><p class="noindent" >If you have a look at the Web2C documentation, you will read that all the various <span class="TEX">T<span class="E">E</span>X</span> @@ -3201,10 +3253,10 @@ class="ec-lmtt-10">irun.exe </span>is provided to build the equivalent of Unix h executable files only under Win32. <!--l. 738--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">7.12 </span> <a - id="x1-510007.12"></a>In case of problems</h4> + id="x1-520007.12"></a>In case of problems</h4> <!--l. 741--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">7.12.1 </span> <a - id="x1-520007.12.1"></a>What to do if <span + id="x1-530007.12.1"></a>What to do if <span class="ec-lmtt-10">latex </span>does not find your files?</h5> <ul class="itemize1"> <li class="itemize"><span @@ -3221,7 +3273,7 @@ class="verbatim"><tr class="verbatim"><td class="verbatim"><div class="verbatim"> <div class="fancyvrb" id="fancyvrb6"> <a - id="x1-52002r1"></a>  SET KPATHSEA_DEBUG_OUTPUT=err.log + id="x1-53002r1"></a>  SET KPATHSEA_DEBUG_OUTPUT=err.log </div> </div> </td></tr></table> @@ -3233,7 +3285,7 @@ class="verbatim"><tr class="verbatim"><td class="verbatim"><div class="verbatim"> <div class="fancyvrb" id="fancyvrb7"> <a - id="x1-52004r1"></a>  SET KPATHSEA_DEBUG=-1 + id="x1-53004r1"></a>  SET KPATHSEA_DEBUG=-1 </div> </div> </td></tr></table> @@ -3246,7 +3298,7 @@ class="verbatim"><tr class="verbatim"><td class="verbatim"><div class="verbatim"> <div class="fancyvrb" id="fancyvrb8"> <a - id="x1-52006r1"></a>  SET KPATHSEA_DEBUG_OUTPUT=con: + id="x1-53006r1"></a>  SET KPATHSEA_DEBUG_OUTPUT=con: </div> </div> </td></tr></table> @@ -3323,23 +3375,23 @@ class="ec-lmtt-10">kpsewhich</span>, and check back all the values. Try to identify and report the problem.</li></ul> <!--l. 792--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">7.12.2 </span> <a - id="x1-530007.12.2"></a>What to do if your setup still does not work as expected?</h5> + id="x1-540007.12.2"></a>What to do if your setup still does not work as expected?</h5> <!--l. 794--><p class="noindent" >Here are several questions to investigate: <!--l. 796--><p class="indent" > <ol class="enumerate1" > <li - class="enumerate" id="x1-53002x1">Is <span + class="enumerate" id="x1-54002x1">Is <span class="ec-lmtt-10">tex.exe </span>in my <span class="ec-lmtt-10">PATH</span>? </li> <li - class="enumerate" id="x1-53004x2">Is the <span + class="enumerate" id="x1-54004x2">Is the <span class="ec-lmtt-10">TEXMFCNF </span>variable correctly set to <span class="ec-lmtt-10">c:/TeXLive2007/texmf-var/web2c </span>(default value)? </li> <li - class="enumerate" id="x1-53006x3">Are there any errors in the log file generated by the <span + class="enumerate" id="x1-54006x3">Are there any errors in the log file generated by the <span class="ec-lmtt-10">tlmpgui.exe </span>program? <span class="ec-lmtt-10">tlmpgui.log</span> can be found in your <span @@ -3349,7 +3401,7 @@ class="ec-lmtt-10">Error</span>’. perhaps some formats weren’t already installed. </li> <li - class="enumerate" id="x1-53008x4">Are there any relevant bug fixes at <a + class="enumerate" id="x1-54008x4">Are there any relevant bug fixes at <a href="http://tug.org/texlive/" class="url" ><span class="ec-lmtt-10">http://tug.org/texlive/</span></a>? (Unlikely, but it doesn’t hurt to check.) @@ -3359,11 +3411,11 @@ class="ec-lmtt-10">http://tug.org/texlive/</span></a>? (Unlikely, but it doesn&# class="E">E</span>X</span> Live 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 <a -href="#x1-60001.3">1.3<!--tex4ht:ref: sec:help --></a>, p. <a -href="#x1-60001.3">5<!--tex4ht:ref: sec:help --></a>.) +href="#x1-70001.4">1.4<!--tex4ht:ref: sec:help --></a>, p. <a +href="#x1-70001.4">5<!--tex4ht:ref: sec:help --></a>.) <!--l. 1--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">8 </span> <a - id="x1-540008"></a>A user’s guide to Web2C</h3> + id="x1-550008"></a>A user’s guide to Web2C</h3> <!--l. 3--><p class="noindent" >Web2C is an integrated collection of <span class="TEX">T<span class="E">E</span>X</span>-related programs: <span class="TEX">T<span class="E">E</span>X</span> itself, Metafont, MetaPost, BibTeX, @@ -3547,7 +3599,7 @@ class="ec-lmtt-10">ls-R</span>, containing an entry showing the name and relativ root. <!--l. 69--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">8.1 </span> <a - id="x1-550008.1"></a>Kpathsea path searching</h4> + id="x1-560008.1"></a>Kpathsea path searching</h4> <!--l. 71--><p class="noindent" >Let us first describe the generic path searching mechanism of the Kpathsea library. <!--l. 74--><p class="indent" > We call a <span class="ec-lmri-10">search path </span>a colon- or semicolon-separated list of <span @@ -3566,7 +3618,7 @@ class="ec-lmtt-10">/</span>’). <!--l. 86--><p class="indent" > To check a particular path element <span class="ec-lmro-10">p</span>, Kpathsea first checks if a prebuilt database (see “Filename database” on page <a -href="#x1-630008.2">57<!--tex4ht:ref: Filename-database --></a>) applies to <span +href="#x1-640008.2">58<!--tex4ht:ref: Filename-database --></a>) applies to <span class="ec-lmro-10">p</span>, i.e., if the database is in a directory that is a prefix of <span class="ec-lmro-10">p</span>. If so, the path specification is matched against the contents of the database. @@ -3601,12 +3653,12 @@ class="ec-lmtt-10">./</span>’ or ‘<span class="ec-lmtt-10">../</span>’, Kpathsea simply checks if that file exists. <!--l. 131--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">8.1.1 </span> <a - id="x1-560008.1.1"></a>Path sources</h5> + id="x1-570008.1.1"></a>Path sources</h5> <!--l. 134--><p class="noindent" >A search path can come from many sources. In the order in which Kpathsea uses them: <!--l. 137--><p class="indent" > <ol class="enumerate1" > <li - class="enumerate" id="x1-56002x1">A user-set environment variable, for instance, <span + class="enumerate" id="x1-57002x1">A user-set environment variable, for instance, <span class="ec-lmtt-10">TEXINPUTS</span>. Environment variables with a period and a program name appended override; e.g., if ‘<span class="ec-lmtt-10">latex</span>’ is the name of the program @@ -3615,25 +3667,25 @@ class="ec-lmtt-10">TEXINPUTS.latex </span>will override <span class="ec-lmtt-10">TEXINPUTS</span>. </li> <li - class="enumerate" id="x1-56004x2">A program-specific configuration file, for example, a line ‘<span + class="enumerate" id="x1-57004x2">A program-specific configuration file, for example, a line ‘<span class="ec-lmtt-10">S /a:/b</span>’ in <span class="ec-lmss-10">dvips</span>’s <span class="ec-lmtt-10">config.ps</span>. </li> <li - class="enumerate" id="x1-56006x3">A Kpathsea configuration file <span + class="enumerate" id="x1-57006x3">A Kpathsea configuration file <span class="ec-lmtt-10">texmf.cnf</span>, containing a line like ‘<span class="ec-lmtt-10">TEXINPUTS=/c:/d</span>’ (see below). </li> <li - class="enumerate" id="x1-56008x4">The compile-time default.</li></ol> + class="enumerate" id="x1-57008x4">The compile-time default.</li></ol> <!--l. 150--><p class="noindent" >You can see each of these values for a given search path by using the debugging options (see “Debugging actions” on page <a -href="#x1-670008.2.4">61<!--tex4ht:ref: Debugging --></a>). +href="#x1-680008.2.4">62<!--tex4ht:ref: Debugging --></a>). <!--l. 154--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">8.1.2 </span> <a - id="x1-570008.1.2"></a>Config files</h5> + id="x1-580008.1.2"></a>Config files</h5> <!--l. 157--><p class="noindent" >Kpathsea reads <span class="ec-lmri-10">runtime configuration files </span>named <span class="ec-lmtt-10">texmf.cnf </span>for search path and other definitions. The @@ -3715,7 +3767,7 @@ class="ec-lmtt-10">texmf.cnf </span>for Unix, MS-DOS and <!--l. 207--><p class="indent" > <div class="fancyvrb" id="fancyvrb9"> <a - id="x1-57002r1"></a><span + id="x1-58002r1"></a><span class="ec-lmtt-8x-x-87"> </span><span class="ec-lmtt-8x-x-87"> TEXMF</span><span class="ec-lmtt-8x-x-87"> </span><span @@ -3734,7 +3786,7 @@ class="ec-lmtt-8x-x-87"> </span><span class="ec-lmtt-8x-x-87"> =</span><span class="ec-lmtt-8x-x-87"> {$TEXMFLOCAL,!!$TEXMFMAIN}</span> <br class="fancyvrb" /><a - id="x1-57004r2"></a><span + id="x1-58004r2"></a><span class="ec-lmtt-8x-x-87"> </span><span class="ec-lmtt-8x-x-87"> TEXINPUTS.latex</span><span class="ec-lmtt-8x-x-87"> </span><span @@ -3743,20 +3795,20 @@ class="ec-lmtt-8x-x-87"> </span><span class="ec-lmtt-8x-x-87"> =</span><span class="ec-lmtt-8x-x-87"> .;$TEXMF/tex/{latex,generic;}//</span> <br class="fancyvrb" /><a - id="x1-57006r3"></a><span + id="x1-58006r3"></a><span class="ec-lmtt-8x-x-87"> </span><span class="ec-lmtt-8x-x-87"> TEXINPUTS.fontinst</span><span class="ec-lmtt-8x-x-87"> =</span><span class="ec-lmtt-8x-x-87"> .;$TEXMF/tex//;$TEXMF/fonts/afm//</span> <br class="fancyvrb" /><a - id="x1-57008r4"></a><span + id="x1-58008r4"></a><span class="ec-lmtt-8x-x-87"> </span><span class="ec-lmtt-8x-x-87"> %</span><span class="ec-lmtt-8x-x-87"> e-TeX</span><span class="ec-lmtt-8x-x-87"> related</span><span class="ec-lmtt-8x-x-87"> files</span> <br class="fancyvrb" /><a - id="x1-57010r5"></a><span + id="x1-58010r5"></a><span class="ec-lmtt-8x-x-87"> </span><span class="ec-lmtt-8x-x-87"> TEXINPUTS.elatex</span><span class="ec-lmtt-8x-x-87"> </span><span @@ -3764,7 +3816,7 @@ class="ec-lmtt-8x-x-87"> </span><span class="ec-lmtt-8x-x-87"> =</span><span class="ec-lmtt-8x-x-87"> .;$TEXMF/{etex,tex}/{latex,generic;}//</span> <br class="fancyvrb" /><a - id="x1-57012r6"></a><span + id="x1-58012r6"></a><span class="ec-lmtt-8x-x-87"> </span><span class="ec-lmtt-8x-x-87"> TEXINPUTS.etex</span><span class="ec-lmtt-8x-x-87"> </span><span @@ -3776,7 +3828,7 @@ class="ec-lmtt-8x-x-87"> .;$TEXMF/{etex,tex}/{eplain,plain,generic;}//</s </div> <!--l. 212--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">8.1.3 </span> <a - id="x1-580008.1.3"></a>Path expansion</h5> + id="x1-590008.1.3"></a>Path expansion</h5> <!--l. 216--><p class="noindent" >Kpathsea recognizes certain special characters and constructions in search paths, similar to those available in Unix shells. As a general example, the complex path, <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">~$USER/{foo,bar}//baz</span></span></span>, expands to @@ -3787,9 +3839,9 @@ class="ec-lmtt-10">$USER</span>’s home directory that contain a directory <span class="ec-lmtt-10">baz</span>. These expansions are explained in the sections below. <h5 class="subsubsectionHead"><span class="titlemark">8.1.4 </span> <a - id="x1-590008.1.4"></a>Default expansion</h5> + id="x1-600008.1.4"></a>Default expansion</h5> <!--l. 228--><p class="noindent" >If the highest-priority search path (see “Path sources” on page <a -href="#x1-560008.1.1">52<!--tex4ht:ref: Path-sources --></a>) contains an <span +href="#x1-570008.1.1">53<!--tex4ht:ref: Path-sources --></a>) contains an <span class="ec-lmri-10">extra colon </span>(i.e., leading, trailing, or doubled), Kpathsea inserts at that point the next-highest-priority search path that is defined. If that inserted path has an extra colon, the same happens with the next highest. For example, given an @@ -3830,7 +3882,7 @@ doubled ‘<span class="ec-lmtt-10">:</span>’. <!--l. 256--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">8.1.5 </span> <a - id="x1-600008.1.5"></a>Brace expansion</h5> + id="x1-610008.1.5"></a>Brace expansion</h5> <!--l. 258--><p class="noindent" >A useful feature is brace expansion, which means that, for instance, <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">v{a,b}w</span></span></span> expands to <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">vaw:vbw</span></span></span>. @@ -3847,7 +3899,7 @@ class="verbatim"><tr class="verbatim"><td class="verbatim"><div class="verbatim"> <div class="fancyvrb" id="fancyvrb10"> <a - id="x1-60002r1"></a>    TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN} + id="x1-61002r1"></a>    TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN} </div> </div> </td></tr></table> @@ -3859,7 +3911,7 @@ class="verbatim"><tr class="verbatim"><td class="verbatim"><div class="verbatim"> <div class="fancyvrb" id="fancyvrb11"> <a - id="x1-60004r1"></a>    TEXINPUTS = .;$TEXMF/tex// + id="x1-61004r1"></a>    TEXINPUTS = .;$TEXMF/tex// </div> </div> </td></tr></table> @@ -3879,7 +3931,7 @@ class="ec-lmtt-10">$TEXMF </span>variable in all definitions, one is sure to alw first. <!--l. 282--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">8.1.6 </span> <a - id="x1-610008.1.6"></a>Subdirectory expansion</h5> + id="x1-620008.1.6"></a>Subdirectory expansion</h5> <!--l. 285--><p class="noindent" >Two or more consecutive slashes in a path element following a directory <span class="ec-lmro-10">d </span>is replaced by all subdirectories of <span @@ -3903,7 +3955,7 @@ class="ec-lmtt-10">//</span>’ at the beginning of a path is ignored. <!--l. 299--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">8.1.7 </span> <a - id="x1-620008.1.7"></a>List of special characters and their meaning: a summary</h5> + id="x1-630008.1.7"></a>List of special characters and their meaning: a summary</h5> <!--l. 301--><p class="noindent" >The following list summarizes the special characters in Kpathsea configuration files. <!--l. 306--><p class="noindent" > <dl class="list1"><dt class="list"> @@ -3959,7 +4011,7 @@ class="ec-lmri-10">only </span>database to locate file, <span class="ec-lmri-10">do not </span>search the disk.</dd></dl> <!--l. 322--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">8.2 </span> <a - id="x1-630008.2"></a>Filename databases</h4> + id="x1-640008.2"></a>Filename databases</h4> <!--l. 325--><p class="noindent" >Kpathsea 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, Kpathsea @@ -3972,7 +4024,7 @@ class="ec-lmtt-10">ls-R</span>. This can be helpful to confirm to DOS 8.3 filename conventions in source files. <!--l. 337--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">8.2.1 </span> <a - id="x1-640008.2.1"></a>The filename database</h5> + id="x1-650008.2.1"></a>The filename database</h5> <!--l. 340--><p class="noindent" >As explained above, the name of the main filename database must be <span class="ec-lmtt-10">ls-R</span>. You can put one at the root of each <span class="TEX">T<span @@ -4017,7 +4069,7 @@ never the disk. <!--l. 365--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">8.2.2 </span> <a - id="x1-650008.2.2"></a>kpsewhich: Standalone path searching</h5> + id="x1-660008.2.2"></a>kpsewhich: Standalone path searching</h5> <!--l. 368--><p class="noindent" >The <span class="ec-lmtt-10">kpsewhich </span>program exercises path searching independent of any particular application. This can be useful as a sort of <span @@ -4142,7 +4194,7 @@ class="newline" />sets the debugging options to <span class="ec-lmro-10">num</span>.</dd></dl> <!--l. 426--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">8.2.3 </span> <a - id="x1-660008.2.3"></a>Examples of use</h5> + id="x1-670008.2.3"></a>Examples of use</h5> <!--l. 429--><p class="noindent" >Let us now have a look at Kpathsea in action. Here’s a straightforward search: <div class="alltt"> <!--l. 431--><p class="noindent" ><div class="obeylines-v"> @@ -4421,7 +4473,7 @@ This is especially important if you suspect that the wrong version of a file is class="ec-lmss-10">kpsewhich </span>will show you the first file encountered. <!--l. 545--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">8.2.4 </span> <a - id="x1-670008.2.4"></a>Debugging actions</h5> + id="x1-680008.2.4"></a>Debugging actions</h5> <!--l. 548--><p class="noindent" >Sometimes it is necessary to investigate how a program resolves file references. To make this practical, Kpathsea offers various levels of debugging output: <!--l. 552--><p class="noindent" > @@ -4487,13 +4539,13 @@ class="verbatim"><tr class="verbatim"><td class="verbatim"><div class="verbatim"> <div class="fancyvrb" id="fancyvrb12"> <a - id="x1-67002r1"></a>    \documentclass{article} + id="x1-68002r1"></a>    \documentclass{article} <br class="fancyvrb" /><a - id="x1-67004r2"></a>    \begin{document} + id="x1-68004r2"></a>    \begin{document} <br class="fancyvrb" /><a - id="x1-67006r3"></a>    Hello World! + id="x1-68006r3"></a>    Hello World! <br class="fancyvrb" /><a - id="x1-67008r4"></a>    \end{document} + id="x1-68008r4"></a>    \end{document} </div> </div> </td></tr></table> @@ -4519,11 +4571,11 @@ expansion (see <span class="ec-lmss-10">dvips </span>Reference Manual, <a href="../../../../texmf/doc/html/dvips/dvips_toc.html" >texmf/doc/html/dvips/dvips_toc.html</a>). The output (slightly rearranged) appears in Figure <a -href="#x1-67031r1">1<!--tex4ht:ref: fig:dvipsdbga --></a>. +href="#x1-68031r1">1<!--tex4ht:ref: fig:dvipsdbga --></a>. <!--l. 603--><p class="indent" > <a - id="x1-67031r1"></a><a - id="x1-67036r2"></a><a - id="x1-67049r3"></a><hr class="float"><div class="float" + id="x1-68031r1"></a><a + id="x1-68036r2"></a><a + id="x1-68049r3"></a><hr class="float"><div class="float" ><table class="float"><tr class="float"><td class="float" > @@ -4621,7 +4673,7 @@ class="ec-lmtt-9">=>/usr/local/texmf/dvips/cms/config.cms</span> </div> <table class="caption" ><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 1: </td><td -class="content">Finding configuration files</td></tr></table><!--tex4ht:label?: x1-67031r1 --> +class="content">Finding configuration files</td></tr></table><!--tex4ht:label?: x1-68031r1 --> <div class="BVerbatimInput"> <span class="ec-lmtt-9">kdebug:start</span><span @@ -4646,7 +4698,7 @@ class="ec-lmtt-9"> /usr/local/texmf/dvips/base/texc.pro</span> </div> <table class="caption" ><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 2: </td><td -class="content">Finding the prolog file</td></tr></table><!--tex4ht:label?: x1-67036r2 --> +class="content">Finding the prolog file</td></tr></table><!--tex4ht:label?: x1-68036r2 --> <div class="BVerbatimInput"> <span class="ec-lmtt-9">kdebug:start</span><span @@ -4704,7 +4756,7 @@ class="ec-lmtt-9"><cmr10.pfb>[1]</span> </div> <table class="caption" ><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 3: </td><td -class="content">Finding the font file</td></tr></table><!--tex4ht:label?: x1-67049r3 --> +class="content">Finding the font file</td></tr></table><!--tex4ht:label?: x1-68049r3 --> </td></tr></table></div><hr class="endfloat" /> @@ -4761,7 +4813,7 @@ class="ec-lmtt-10"> +amsbkm.map</span> class="ec-lmss-10">dvips </span>thus goes on to find all these files, plus the generic map file <span class="ec-lmtt-10">psfonts.map</span>, which is always loaded (it contains declarations for commonly used PostScript fonts; see the last part of Section <a -href="#x1-660008.2.3">8.2.3<!--tex4ht:ref: SExamplesofuse --></a> for more +href="#x1-670008.2.3">8.2.3<!--tex4ht:ref: SExamplesofuse --></a> for more details about PostScript map file handling). <!--l. 646--><p class="indent" > At this point <span class="ec-lmss-10">dvips </span>identifies itself to the user: <div class="alltt"> @@ -4894,7 +4946,7 @@ class="ec-lmtt-9"><cmr10.pfb>[1]</span> </div> </div> <h4 class="subsectionHead"><span class="titlemark">8.3 </span> <a - id="x1-680008.3"></a>Runtime options</h4> + id="x1-690008.3"></a>Runtime options</h4> <!--l. 694--><p class="noindent" >Another useful feature of Web2C is its possibility to control a number of memory parameters (in particular, array sizes) via the runtime file <span class="ec-lmtt-10">texmf.cnf </span>read by Kpathsea. The memory @@ -4948,7 +5000,7 @@ practical compromise allowing some flexibility. <!--l. 1--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">9 </span> <a - id="x1-690009"></a>Acknowledgements</h3> + id="x1-700009"></a>Acknowledgements</h3> <!--l. 3--><p class="noindent" ><span class="TEX">T<span class="E">E</span>X</span> Live is a joint effort by virtually all of the <span class="TEX">T<span class="E">E</span>X</span> user groups. This edition of <span class="TEX">T<span @@ -5066,10 +5118,10 @@ class="E">E</span>X</span>, and then for giving it to the world. <!--l. 1--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">10 </span> <a - id="x1-7000010"></a>Release history</h3> + id="x1-7100010"></a>Release history</h3> <!--l. 4--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">10.1 </span> <a - id="x1-7100010.1"></a>Past</h4> + id="x1-7200010.1"></a>Past</h4> <!--l. 6--><p class="noindent" >Discussion began in late 1993 when the Dutch <span class="TEX">T<span class="E">E</span>X</span> Users Group was starting work on its 4All<span class="TEX">T<span class="E">E</span>X</span> CD @@ -5136,13 +5188,13 @@ te<span class="TEX">T<span class="E">E</span>X</span>, to correct the drift apart in versions 5 and 6. <!--l. 58--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">10.1.1 </span> <a - id="x1-7200010.1.1"></a>2003</h5> + id="x1-7300010.1.1"></a>2003</h5> <!--l. 60--><p class="noindent" >In 2003, with the continuing flood of updates and additions, we found that <span class="TEX">T<span class="E">E</span>X</span> Live had grown so large it could no longer be contained on a single CD, so we split it into three different distributions (see section <a -href="#x1-80002.1">2.1<!--tex4ht:ref: sec:multiple-dist --></a>, p. <a -href="#x1-80002.1">6<!--tex4ht:ref: sec:multiple-dist --></a>). In addition: +href="#x1-90002.1">2.1<!--tex4ht:ref: sec:multiple-dist --></a>, p. <a +href="#x1-90002.1">6<!--tex4ht:ref: sec:multiple-dist --></a>). In addition: <ul class="itemize1"> <li class="itemize">At the request of the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span class="E">E</span>X</span></span> team, we changed the standard <span @@ -5150,7 +5202,7 @@ class="ec-lmss-10">latex </span>and <span class="ec-lmss-10">pdflatex </span>commands to now use e-<span class="TEX">T<span class="E">E</span>X</span> (see p. <a -href="#x1-110002.4">9<!--tex4ht:ref: text:etex --></a>). +href="#x1-120002.4">9<!--tex4ht:ref: text:etex --></a>). </li> <li class="itemize">The new Latin Modern fonts were included (and are recommended). </li> @@ -5196,7 +5248,7 @@ class="ec-lmtt-10">texmf/web2c/cp8bit.tcx</span></span></span>. (Future releases class="E">E</span>X</span> Live 2003.</li></ul> <!--l. 98--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">10.1.2 </span> <a - id="x1-7300010.1.2"></a>2004</h5> + id="x1-7400010.1.2"></a>2004</h5> <!--l. 100--><p class="noindent" >2004 saw many changes: <ul class="itemize1"> <li class="itemize">If you have locally-installed fonts which use their own <span @@ -5228,8 +5280,8 @@ class="ec-lmss-10">X</span></span><span class="ec-lmss-10"> Collection</span> has been expanded with the addition of a MiK<span class="TEX">T<span class="E">E</span>X</span>-based installable CD, for those who prefer that implementation to Web2C. See section <a -href="#x1-70002">2<!--tex4ht:ref: sec:struct-tl --></a> (p. <a -href="#x1-70002">6<!--tex4ht:ref: sec:struct-tl --></a>). +href="#x1-80002">2<!--tex4ht:ref: sec:overview-tl --></a> (p. <a +href="#x1-80002">6<!--tex4ht:ref: sec:overview-tl --></a>). </li> <li class="itemize">Within <span class="TEX">T<span class="E">E</span>X</span> Live, the single large <span @@ -5238,8 +5290,8 @@ class="ec-lmtt-10">texmf </span>tree of previous releases has been replaced by t class="ec-lmtt-10">texmf</span>, <span class="ec-lmtt-10">texmf-dist</span>, and <span class="ec-lmtt-10">texmf-doc</span>. See section <a -href="#x1-90002.2">2.2<!--tex4ht:ref: sec:tld --></a> (p. <a -href="#x1-90002.2">7<!--tex4ht:ref: sec:tld --></a>), and the <span +href="#x1-100002.2">2.2<!--tex4ht:ref: sec:tld --></a> (p. <a +href="#x1-100002.2">7<!--tex4ht:ref: sec:tld --></a>), and the <span class="ec-lmtt-10">README </span>files for each. </li> <li class="itemize">All <span class="TEX">T<span @@ -5349,9 +5401,9 @@ class="verbatim"><tr class="verbatim"><td class="verbatim"><div class="verbatim"> <div class="fancyvrb" id="fancyvrb13"> <a - id="x1-73002r1"></a>  \input "filename with spaces"   % plain + id="x1-74002r1"></a>  \input "filename with spaces"   % plain <br class="fancyvrb" /><a - id="x1-73004r2"></a>  \input{"filename with spaces"}  % latex + id="x1-74004r2"></a>  \input{"filename with spaces"}  % latex </div> </div> </td></tr></table> @@ -5436,7 +5488,7 @@ class="ec-lmss-10">mips-irix</span>, the MIPSpro 7.4 runtimes are <!--l. 247--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">10.1.3 </span> <a - id="x1-7400010.1.3"></a>2005</h5> + id="x1-7500010.1.3"></a>2005</h5> <!--l. 249--><p class="noindent" >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: <ul class="itemize1"> @@ -5450,8 +5502,8 @@ class="ec-lmss-10">updmap</span>, and <span class="ec-lmss-10">fmtutil </span>scripts now modify user-specific files, under <span class="ec-lmtt-10">$HOME/.texlive2005</span>. See section <a -href="#x1-190004.1">4.1<!--tex4ht:ref: sec:texconfig --></a>, p. <a -href="#x1-190004.1">27<!--tex4ht:ref: sec:texconfig --></a>. +href="#x1-210004.2">4.2<!--tex4ht:ref: sec:texconfig --></a>, p. <a +href="#x1-210004.2">30<!--tex4ht:ref: sec:texconfig --></a>. </li> <li class="itemize">Corresponding new variables <span class="ec-lmtt-10">TEXMFCONFIG </span>and <span @@ -5467,9 +5519,9 @@ class="ec-lmtt-10">texmf.cnf</span>. In any case the real location of these files and the values of <span class="ec-lmtt-10">TEXMFCONFIG </span>and <span class="ec-lmtt-10">TEXMFSYSCONFIG </span>must agree. See section <a -href="#x1-100002.3">2.3<!--tex4ht:ref: sec:texmftrees --></a>, +href="#x1-110002.3">2.3<!--tex4ht:ref: sec:texmftrees --></a>, p. <a -href="#x1-100002.3">8<!--tex4ht:ref: sec:texmftrees --></a>. +href="#x1-110002.3">8<!--tex4ht:ref: sec:texmftrees --></a>. </li> <li class="itemize">Last year, we kept <span class="obeylines-h"><span class="verb"><span class="ec-lmtt-10">\pdfoutput</span></span></span> and other primitives undefined for DVI output, even though @@ -5495,7 +5547,7 @@ class="verbatim"><tr class="verbatim"><td class="verbatim"><div class="verbatim"> <div class="fancyvrb" id="fancyvrb14"> <a - id="x1-74002r1"></a>  latex --translate-file=empty.tcx yourfile.tex + id="x1-75002r1"></a>  latex --translate-file=empty.tcx yourfile.tex </div> </div> </td></tr></table> @@ -5527,7 +5579,7 @@ class="ec-lmtt-10">TEXMFVAR</span>, which is by default user-specific. See the f </li></ul> <!--l. 309--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">10.2 </span> <a - id="x1-7500010.2"></a>Present</h4> + id="x1-7600010.2"></a>Present</h4> <!--l. 312--><p class="noindent" >In 2006–2007, the major new addition to <span class="TEX">T<span class="E">E</span>X</span> Live was the Xe<span class="TEX">T<span class="E">E</span>X</span> program, available as the <span @@ -5564,7 +5616,7 @@ class="E">E</span>X</span></span> and everything else do still read <span class="ec-lmtt-10">%& </span>lines). <!--l. 332--><p class="indent" > The installation scripts now accept various environment variables to allow for non-interactive installation; see section <a -href="#x1-160003.2.1">3.2.1<!--tex4ht:ref: sec:noninteractive-install --></a>. +href="#x1-170003.2.1">3.2.1<!--tex4ht:ref: sec:noninteractive-install --></a>. <!--l. 336--><p class="indent" > Of course the year also saw (the usual) hundreds of other updates to packages and programs. As usual, please check CTAN ( <a href="http://www.ctan.org" class="url" ><span @@ -5588,7 +5640,7 @@ class="E">E</span>X</span> environment for everyone. <!--l. 354--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">10.3 </span> <a - id="x1-7600010.3"></a>Future</h4> + id="x1-7700010.3"></a>Future</h4> <!--l. 356--><p class="noindent" ><span class="TEX"><span class="ec-lmri-10">T</span><span class="E"><span diff --git a/Master/texmf-doc/doc/english/texlive-en/live.pdf b/Master/texmf-doc/doc/english/texlive-en/live.pdf Binary files differindex 345144e87fd..6d303e62135 100644 --- a/Master/texmf-doc/doc/english/texlive-en/live.pdf +++ b/Master/texmf-doc/doc/english/texlive-en/live.pdf diff --git a/Master/texmf-doc/source/english/texlive-en/installation.tex b/Master/texmf-doc/source/english/texlive-en/installation.tex index 29b6be4eb7c..b8d6d7721ab 100644 --- a/Master/texmf-doc/source/english/texlive-en/installation.tex +++ b/Master/texmf-doc/source/english/texlive-en/installation.tex @@ -1,5 +1,5 @@ -\section{Unix installation} -\label{sec:unix-install} +\section{Installation} +\label{sec:install} As introduced in section~\ref{sec:basic} (\p.\pageref{sec:basic}), \TL{} has three principal uses: @@ -111,7 +111,7 @@ your personal initialization files can and do vary from site to site. % \subsection{Installing \protect\TeX\protect\ Live to disk} -\label{sec:unix-install-disk} +\label{sec: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 @@ -431,122 +431,100 @@ It would be better to support a standard \acro{GNU}-style \filename{configure} with options, instead of these environment variables. Volunteers are welcome! +\subsection{Testing the installation} +\label{sec:test-install} -% -\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. +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. -\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: +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 To see the files in the package \pkgname{fancyhdr} without -installing it: +\item Make sure that you can run the \cmdname{tex} program in the first +place: \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 +> \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 Install the \LaTeX{} package \pkgname{natbib}: +\item Process a basic \LaTeX{} file: \begin{alltt} -> \Ucom{sh install-pkg.sh --package=natbib} +> \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 Install the \LaTeX{} package \pkgname{alg} without source files or -documentation: +\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} -\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} +> \Ucom{dvips sample2e.dvi -o sample2e.ps} +\end{alltt} -\item Install all the packages in the collection of additional -plain \TeX\ macros: +\item Create a \acro{PDF} file instead of \dvi{}; this processes the +\filename{.tex} file and writes \acro{PDF} directly: \begin{alltt} -> \Ucom{sh install-pkg.sh --collection=tex-plainextra} +> \Ucom{pdflatex sample2e.tex} \end{alltt} -\item Write all files in the \pkgname{pstricks} package to a -\cmdname{tar} file in \path|/tmp|: +\item Preview the \acro{PDF} file: \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} +> \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} -\textifindoubt +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. % diff --git a/Master/texmf-doc/source/english/texlive-en/intro.tex b/Master/texmf-doc/source/english/texlive-en/intro.tex index ae535b1b6b6..daa653a1839 100644 --- a/Master/texmf-doc/source/english/texlive-en/intro.tex +++ b/Master/texmf-doc/source/english/texlive-en/intro.tex @@ -1,20 +1,24 @@ \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 friends for \acro{GNU}/Linux and other Unix -flavors, \MacOSX, and (32-bit) Windows systems. (Warning: it is not -especially useful for older Mac, Windows 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 +distribution\Dash \TeX{} and related programs for \acro{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:multiple-dist} 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{}, @@ -24,31 +28,29 @@ see the end of the document, section~\ref{sec:history} \subsection{Operating system support} \label{sec:os_support} -\TL{} supports Unix/Linux and Windows. - -The \DVD{} contains binaries for many Linux- and Unix -architectures. Users of other Unices have to compile from source, -which is included. - -\MacOSX{} users may prefer the MacTeX distribution, which is based on -\TL. Although \MacOSX{} is supported, it is treated here as any -other Unix, without taking the unique characteristics of the OS and -its community into account. +\TL{} contains binaries for many Linux- and Unix architectures, +including \MacOSX. The included sources should enable installation +on additional Linux- and Unix platforms. As to Windows: only Windows 2000 and later are supported. Windows -9x, ME and NT have been dropped. This restriction allowed us to -treat Windows a bit more like Unix. +9\textit{x}, ME and NT have been dropped. Because of this +restriction, Windows requires less special treatment compared to +Linux and Unix. There are no 64-bit executables for Windows, but the +32-bit executables should run on 64-bit systems. + +See section~\ref{sec:multiple-dist} for alternative \TeX{} systems +for Windows and \MacOSX. \subsection{Basic usage of \protect\TL{}} \label{sec:basic} You can install \TL{} either from \DVD{} or over the internet. The -net installer itself is very small and downloads everything from the -internet. The net installer is an attractive option if you need only -a fraction of the complete \TL. +net installer itself is very small and downloads everything needed +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 +also run \TL{} directly from the \DVD{} (or from a \DVD{} image, if your system supports that). \noindent This is described in the @@ -56,13 +58,14 @@ installation sections following, but here is a quick start: \begin{itemize*} -\item The installation script is \texttt{install-tl}, which has -both a text mode (default for Unix) and a GUI mode (default for +\item The installation script is \filename{install-tl}, which has +both a text mode (default for Unix) and a \GUI{} mode (default for Windows). -\item One of the installed items is tlmgr or \TL\ Manager, which can - also be used in GUI mode and in text mode. You can use it to - install and uninstall packages and do various configuration tasks. +\item One of the installed items is \prog{tlmgr} or \TL\ Manager, + which can also be used in \GUI{} mode and in text mode. You can + use it to install and uninstall packages and do various + configuration tasks. \end{itemize*} @@ -132,55 +135,3 @@ 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. - - diff --git a/Master/texmf-doc/source/english/texlive-en/live.tex b/Master/texmf-doc/source/english/texlive-en/live.tex index c3188587047..e40508a2ca6 100644 --- a/Master/texmf-doc/source/english/texlive-en/live.tex +++ b/Master/texmf-doc/source/english/texlive-en/live.tex @@ -10,7 +10,7 @@ \title{% {\huge \textit{The \protect\TL{} Guide}\\\strut} - {\LARGE \textsf{\TL{} 2007}} + {\LARGE \textsf{\TL{} 2008}} } \author{Karl Berry, editor \\[3mm] diff --git a/Master/texmf-doc/source/english/texlive-en/macosx.tex b/Master/texmf-doc/source/english/texlive-en/macosx.tex index 78a97a2e2d5..971416be757 100644 --- a/Master/texmf-doc/source/english/texlive-en/macosx.tex +++ b/Master/texmf-doc/source/english/texlive-en/macosx.tex @@ -19,7 +19,7 @@ an earlier \MacOSX{} version, however, the default shell is 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 +previous section can be followed. See section~\ref{sec:install} on +\p.\pageref{sec:install}; \MacOSX-specific notes are included there where needed. diff --git a/Master/texmf-doc/source/english/texlive-en/maintenance.tex b/Master/texmf-doc/source/english/texlive-en/maintenance.tex index 6954d852a13..0d48dba7b0e 100644 --- a/Master/texmf-doc/source/english/texlive-en/maintenance.tex +++ b/Master/texmf-doc/source/english/texlive-en/maintenance.tex @@ -26,6 +26,123 @@ installation information for fonts in particular. \end{itemize*} +% +\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 + + \subsection{The \protect\cmdname{texconfig} program} \label{sec:texconfig} @@ -90,99 +207,3 @@ 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. - - diff --git a/Master/texmf-doc/source/english/texlive-en/overview.tex b/Master/texmf-doc/source/english/texlive-en/overview.tex index 0f884f05943..2fab2d2c482 100644 --- a/Master/texmf-doc/source/english/texlive-en/overview.tex +++ b/Master/texmf-doc/source/english/texlive-en/overview.tex @@ -1,3 +1,48 @@ + +% 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 structure and contents of \TL{} and the +\TK{} of which it is a part. + +\subsection{Multiple distributions: \protect\pkgname{live}, + \protect\pkgname{protext}, + \protect\pkgname{Mac\TeX}} +\label{sec:multiple-dist} + +The \TK{} \DVD{} comprises the following: + +\begin{description} + +\item [live] A complete \TeX{} system which can be run live or + installed to disk. It is too large for \acro{CD}. + +\item [CTAN] A snapshot of the \CTAN{} repository + +\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}. + +\item [Mac\TeX] for \MacOSX is independent of but based on \TL{}. + +\item [\texttt{texmf-extra}] A directory with assorted additional packages. + +\end{description} + +\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. + +\noindent You can tell which type of distribution you're in by +looking for a \texttt{release-texlive.txt} 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} @@ -11,11 +56,12 @@ level of the disc. \renewcommand{\arraystretch}{1.3} % open up interrow spacing \begin{tabular}{>{\ttfamily}lp{.78\hsize}} bin & The \TeX{} system programs, arranged by platform. \\ +readme.html & Readme html pages in various languages, with a quick + introduction and useful links \\ 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 GNU/Linux and Windows. \\ -support & Assorted auxiliary packages and programs. These are + \TeX{} and \MF{} distributions. These are stored in +various compressed archives. \\ +support & Various 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 @@ -25,8 +71,15 @@ 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. +texmf-var & This is not strictly part of the distribution, but will + be located next to the above texmf trees in a default + installation; it can be located elsewhere. This tree contains + files which are automatically generated and stored. (\texttt{TEXMFSYSVAR} in the next section.) \\ +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{tabular} \endgroup @@ -88,11 +141,13 @@ 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: +\TeX{} itself is frozed, apart from rare bug fixes. It is still +present in \TL, and will remain so in the foreseeable future. \TL{} +contains several extended versions of \TeX: \begin{description} -\item [\eTeX] adds a small but powerful set of new primitives +\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, @@ -105,8 +160,19 @@ writing \acro{PDF} output as well as \dvi{}. See \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 [Lua\TeX] (see \url{http://www.luatex.org/} and + \OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}) is the designated + successor of pdf\TeX, with which it should 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 \texttt{texlua}, it + functions as a standalone Lua interpreter, and is already used as + such within \TL. + +\item [Xe\TeX] adds support for Unicode input, OpenType- and system + 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 @@ -150,7 +216,7 @@ utilities. \item [lacheck] \LaTeX{} syntax checker. -\item [texexec] Con\TeX{}t and \acro{PDF} processor. +\item [texexec / texmfstart] Con\TeX{}t and \acro{PDF} processor. \item [tex4ht] \TeX{} to \acro{HTML} converter. diff --git a/Master/texmf-doc/source/english/texlive-en/releasehist.tex b/Master/texmf-doc/source/english/texlive-en/releasehist.tex index 61df1a0b8b2..c4eb705a50b 100644 --- a/Master/texmf-doc/source/english/texlive-en/releasehist.tex +++ b/Master/texmf-doc/source/english/texlive-en/releasehist.tex @@ -117,7 +117,7 @@ For methods of handling this and other information, please see \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}). +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}, diff --git a/Master/texmf-doc/source/english/texlive-en/tex-live.sty b/Master/texmf-doc/source/english/texlive-en/tex-live.sty index 06ca922536f..5b4263b859c 100644 --- a/Master/texmf-doc/source/english/texlive-en/tex-live.sty +++ b/Master/texmf-doc/source/english/texlive-en/tex-live.sty @@ -1,7 +1,7 @@ % $Id$ % 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] % @@ -49,7 +49,7 @@ % % % Done with packages. -% +% % Page layout. \advance\textwidth by 1.1in \advance\oddsidemargin by -.55in @@ -68,13 +68,13 @@ \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 @@ -97,14 +97,14 @@ \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. +% 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. +% different macros in the source. \def\OnCD#1{\href{../../../../#1}{\path{#1}}} % % \href incorrectly appends .pdf to anything without an extension; these @@ -140,6 +140,7 @@ \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$} @@ -175,7 +176,7 @@ % #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} @@ -188,7 +189,7 @@ % 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 @@ -229,7 +230,7 @@ % emacs-page output setup -% +% \ifx \HCode\UnDef \providecommand{\Status}{0}% running TeX \else @@ -237,7 +238,7 @@ \fi %\typeout{Status is \Status} % -\newif\ifSingleColumn +\newif\ifSingleColumn % % By default, we won't be creating hyperlinks. \def\href#1#2{#2} @@ -295,7 +296,7 @@ \SingleColumnfalse \newenvironment{multicols}[1]{}{} \fi -% +% \ifnum \Status=4 \else \RequirePackage{texnames} @@ -394,7 +395,7 @@ \global\advance\colrow by1\relax \ifodd\colrow \gdef\RowColor{pale}% - \else + \else \gdef\RowColor{white}% \fi } diff --git a/Master/texmf-doc/source/english/texlive-en/web2c.tex b/Master/texmf-doc/source/english/texlive-en/web2c.tex index e3d62627320..52b310c6d4c 100644 --- a/Master/texmf-doc/source/english/texlive-en/web2c.tex +++ b/Master/texmf-doc/source/english/texlive-en/web2c.tex @@ -752,8 +752,8 @@ 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 +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 |