diff options
| author | Karl Berry <karl@freefriends.org> | 2009-05-23 00:00:20 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2009-05-23 00:00:20 +0000 |
| commit | 8518c1ff40dd53799254c0b0f88a6a8ae85173e6 (patch) | |
| tree | 002f196f79f8a91aa93c8cd99dbb1c7075cae814 /Master/texmf/doc | |
| parent | 56a35b336eb85e90dc82c6eee12e9fe992172dd6 (diff) | |
move texlive-en out of texmf-doc
git-svn-id: svn://tug.org/texlive/trunk@13401 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc')
| -rw-r--r-- | Master/texmf/doc/texlive/texlive-en/install-w32-main.png | bin | 0 -> 50021 bytes | |||
| -rw-r--r-- | Master/texmf/doc/texlive/texlive-en/psview.png | bin | 0 -> 10129 bytes | |||
| -rw-r--r-- | Master/texmf/doc/texlive/texlive-en/stdcoll.png | bin | 0 -> 10661 bytes | |||
| -rw-r--r-- | Master/texmf/doc/texlive/texlive-en/tex-live.css | 44 | ||||
| -rw-r--r-- | Master/texmf/doc/texlive/texlive-en/texlive-en.css | 320 | ||||
| -rw-r--r-- | Master/texmf/doc/texlive/texlive-en/texlive-en.html | 6425 | ||||
| -rw-r--r-- | Master/texmf/doc/texlive/texlive-en/texlive-en.pdf | bin | 0 -> 822374 bytes | |||
| -rw-r--r-- | Master/texmf/doc/texlive/texlive-en/tlmgr-config.png | bin | 0 -> 10167 bytes | |||
| -rw-r--r-- | Master/texmf/doc/texlive/texlive-en/tlmgr-gui.png | bin | 0 -> 11806 bytes |
9 files changed, 6789 insertions, 0 deletions
diff --git a/Master/texmf/doc/texlive/texlive-en/install-w32-main.png b/Master/texmf/doc/texlive/texlive-en/install-w32-main.png Binary files differnew file mode 100644 index 00000000000..a8cc55f6070 --- /dev/null +++ b/Master/texmf/doc/texlive/texlive-en/install-w32-main.png diff --git a/Master/texmf/doc/texlive/texlive-en/psview.png b/Master/texmf/doc/texlive/texlive-en/psview.png Binary files differnew file mode 100644 index 00000000000..8322bdda693 --- /dev/null +++ b/Master/texmf/doc/texlive/texlive-en/psview.png diff --git a/Master/texmf/doc/texlive/texlive-en/stdcoll.png b/Master/texmf/doc/texlive/texlive-en/stdcoll.png Binary files differnew file mode 100644 index 00000000000..16a699ba3c6 --- /dev/null +++ b/Master/texmf/doc/texlive/texlive-en/stdcoll.png diff --git a/Master/texmf/doc/texlive/texlive-en/tex-live.css b/Master/texmf/doc/texlive/texlive-en/tex-live.css new file mode 100644 index 00000000000..b8aa763a0df --- /dev/null +++ b/Master/texmf/doc/texlive/texlive-en/tex-live.css @@ -0,0 +1,44 @@ +/* $Id: tex-live.css 3436 2007-01-13 22:34:01Z karl $ + Simple CSS for TeX Live that adds margins and a little color. + original by Bzyl Wlodzimierz, edited by Karl Berry, 2005. + Public domain. */ + +html { + // top left bottom right + margin: 15pt 15pt 15pt 15pt; + background: rgb(255,255,224); +} + +body { + margin: 0 5pt 0 5pt; + padding: 0; + //matw: background: rgb(224,255,224); + // (It looks better to me to have a consistent background --karl) +// fonts in browser are low resolution; +// therefore generated serif are poor quality, +// so they disturb reading (that is my opinion) + font-family: sans-serif; + font-style: normal; +} + +/* (It looks better to me to not vary colors at every level --karl) */ + +h3.sectionHead { + padding: 12pt 10pt 12pt 20pt; + //matw: background: rgb(192,224,255); + background: rgb(224,224,255); + color: rgb(0,0,32); +} + +h4.subsectionHead { + padding: 7pt 10pt 7pt 40pt; + background: rgb(224,224,255); + color: rgb(0,0,32); +} + +h5.subsubsectionHead { + padding: 3pt 10pt 3pt 40pt; + //matw: background: rgb(224,255,255); + background: rgb(224,224,255); + color: rgb(0,0,32); +} diff --git a/Master/texmf/doc/texlive/texlive-en/texlive-en.css b/Master/texmf/doc/texlive/texlive-en/texlive-en.css new file mode 100644 index 00000000000..2d02a9934ac --- /dev/null +++ b/Master/texmf/doc/texlive/texlive-en/texlive-en.css @@ -0,0 +1,320 @@ + +/* start css.sty */ +.ec-lmri-12x-x-172{font-size:206%; font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmss-17{font-size:170%; font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmr-12{font-size:120%;} +.ec-lmtt-12{font-size:120%; font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.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;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtt-8x-x-87{font-size:69%; font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ 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-lmtt-8{font-size:80%; font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-9{font-size:90%; font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +p.noindent { text-indent: 0em } +td p.noindent { text-indent: 0em; margin-top:0em; } +p.nopar { text-indent: 0em; } +p.indent{ text-indent: 1.5em } +@media print {div.crosslinks {visibility:hidden;}} +a img { border-top: 0; border-left: 0; border-right: 0; } +center { margin-top:1em; margin-bottom:1em; } +td center { margin-top:0em; margin-bottom:0em; } +.Canvas { position:relative; } +img.math{vertical-align:middle;} +li p.indent { text-indent: 0em } +.enumerate1 {list-style-type:decimal;} +.enumerate2 {list-style-type:lower-alpha;} +.enumerate3 {list-style-type:lower-roman;} +.enumerate4 {list-style-type:upper-alpha;} +div.newtheorem { margin-bottom: 2em; margin-top: 2em;} +.obeylines-h,.obeylines-v {white-space: nowrap; } +div.obeylines-v p { margin-top:0; margin-bottom:0; } +.overline{ text-decoration:overline; } +.overline img{ border-top: 1px solid black; } +td.displaylines {text-align:center; white-space:nowrap;} +.centerline {text-align:center;} +.rightline {text-align:right;} +div.verbatim {font-family: monospace; white-space: nowrap; text-align:left; clear:both; } +.fbox {padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +div.fbox {display:table} +div.center div.fbox {text-align:center; clear:both; padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +table.minipage{width:100%;} +div.center, div.center div.center {text-align: center; margin-left:1em; margin-right:1em;} +div.center div {text-align: left;} +div.flushright, div.flushright div.flushright {text-align: right;} +div.flushright div {text-align: left;} +div.flushleft {text-align: left;} +.underline{ text-decoration:underline; } +.underline img{ border-bottom: 1px solid black; margin-bottom:1pt; } +.framebox-c, .framebox-l, .framebox-r { padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +.framebox-c {text-align:center;} +.framebox-l {text-align:left;} +.framebox-r {text-align:right;} +span.thank-mark{ vertical-align: super } +span.footnote-mark sup.textsuperscript, span.footnote-mark a sup.textsuperscript{ font-size:80%; } +div.footnotes{border-top:solid 1px black; border-bottom:solid 1px black; padding-bottom:1ex; padding-top:0.5ex; margin-right:15%; margin-top:2ex; font-style:italic; font-size:85%;} +div.footnotes p{margin-top:0; margin-bottom:0; text-indent:0;} +div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em; } +table.tabular td p{margin-top:0em;} +table.tabular {margin-left: auto; margin-right: auto;} +div.td00{ margin-left:0pt; margin-right:0pt; } +div.td01{ margin-left:0pt; margin-right:5pt; } +div.td10{ margin-left:5pt; margin-right:0pt; } +div.td11{ margin-left:5pt; margin-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +td.td00{ padding-left:0pt; padding-right:0pt; } +td.td01{ padding-left:0pt; padding-right:5pt; } +td.td10{ padding-left:5pt; padding-right:0pt; } +td.td11{ padding-left:5pt; padding-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +.hline hr, .cline hr{ height : 1px; margin:0px; } +.tabbing-right {text-align:right;} +span.TEX {letter-spacing: -0.125em; } +span.TEX span.E{ position:relative;top:0.5ex;left:-0.0417em;} +a span.TEX span.E {text-decoration: none; } +span.LATEX span.A{ position:relative; top:-0.5ex; left:-0.4em; font-size:85%;} +span.LATEX span.TEX{ position:relative; left: -0.4em; } +div.float img, div.float .caption {text-align:center;} +div.figure img, div.figure .caption {text-align:center;} +.marginpar {width:20%; float:right; text-align:left; margin-left:auto; margin-top:0.5em; font-size:85%; text-decoration:underline;} +.marginpar p{margin-top:0.4em; margin-bottom:0.4em;} +table.equation {width:100%;} +.equation td{text-align:center; } +td.equation { margin-top:1em; margin-bottom:1em; } +td.equation-label { width:5%; text-align:center; } +td.eqnarray4 { width:5%; white-space: normal; } +td.eqnarray2 { width:5%; } +table.eqnarray-star, table.eqnarray {width:100%;} +div.eqnarray{text-align:center;} +div.array {text-align:center;} +div.pmatrix {text-align:center;} +table.pmatrix {width:100%;} +span.pmatrix img{vertical-align:middle;} +div.pmatrix {text-align:center;} +table.pmatrix {width:100%;} +img.cdots{vertical-align:middle;} +div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em; } +table.tabular td p{margin-top:0em;} +table.tabular {margin-left: auto; margin-right: auto;} +div.td00{ margin-left:0pt; margin-right:0pt; } +div.td01{ margin-left:0pt; margin-right:5pt; } +div.td10{ margin-left:5pt; margin-right:0pt; } +div.td11{ margin-left:5pt; margin-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +td.td00{ padding-left:0pt; padding-right:0pt; } +td.td01{ padding-left:0pt; padding-right:5pt; } +td.td10{ padding-left:5pt; padding-right:0pt; } +td.td11{ padding-left:5pt; padding-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +.hline hr, .cline hr{ height : 1px; margin:0px; } +div.array {text-align:center;} +.partToc a, .partToc, .likepartToc a, .likepartToc {line-height: 200%; font-weight:bold; font-size:110%;} +.index-item, .index-subitem, .index-subsubitem {display:block} +.caption td.id{font-weight: bold; white-space: nowrap; } +table.caption {text-align:center;} +h1.partHead{text-align: center} +p.bibitem { text-indent: -2em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; } +p.bibitem-p { text-indent: 0em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; } +.paragraphHead, .likeparagraphHead { margin-top:2em; font-weight: bold;} +.subparagraphHead, .likesubparagraphHead { font-weight: bold;} +.quote {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; margin-right:1em; text-align:justify;} +.verse{white-space:nowrap; margin-left:2em} +div.maketitle {text-align:center;} +h2.titleHead{text-align:center;} +div.maketitle{ margin-bottom: 2em; } +div.author, div.date {text-align:center;} +div.thanks{text-align:left; margin-left:10%; font-size:85%; font-style:italic; } +.quotation {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; } +.abstract p {margin-left:5%; margin-right:5%;} +table.abstract {width:100%;} +.alltt P { margin-bottom : 0em; margin-top : 0em; } +.alltt { margin-bottom : 1em; margin-top : 1em; } +.figure img.graphics {margin-left:10%;} +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +div.longtable{text-align:center;} +.uline{ text-decoration:underline; } +.uuline{ text-decoration:underline; } +span.sout {text-decoration: line-through } +span.xout {text-decoration: line-through } +span.uwave {text-decoration:underline } +P.fancyvrb {white-space: nowrap; margin:0em;} +div#fancyvrb1{ border-top: solid 0.4pt; } +div#fancyvrb1{ border-left: solid 0.4pt; } +div#fancyvrb1{ border-bottom: solid 0.4pt; } +div#fancyvrb1{ border-right: solid 0.4pt; } +div#fancyvrb2{ border-top: solid 0.4pt; } +div#fancyvrb2{ border-left: solid 0.4pt; } +div#fancyvrb2{ border-bottom: solid 0.4pt; } +div#fancyvrb2{ border-right: solid 0.4pt; } +div#fancyvrb3{ border-top: solid 0.4pt; } +div#fancyvrb3{ border-left: solid 0.4pt; } +div#fancyvrb3{ border-bottom: solid 0.4pt; } +div#fancyvrb3{ border-right: solid 0.4pt; } +div#fancyvrb4{ border-top: solid 0.4pt; } +div#fancyvrb4{ border-left: solid 0.4pt; } +div#fancyvrb4{ border-bottom: solid 0.4pt; } +div#fancyvrb4{ border-right: solid 0.4pt; } +div#fancyvrb5{ border-top: solid 0.4pt; } +div#fancyvrb5{ border-left: solid 0.4pt; } +div#fancyvrb5{ border-bottom: solid 0.4pt; } +div#fancyvrb5{ border-right: solid 0.4pt; } +/* end css.sty */ + diff --git a/Master/texmf/doc/texlive/texlive-en/texlive-en.html b/Master/texmf/doc/texlive/texlive-en/texlive-en.html new file mode 100644 index 00000000000..110a182ca1f --- /dev/null +++ b/Master/texmf/doc/texlive/texlive-en/texlive-en.html @@ -0,0 +1,6425 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html > +<head> + <title>The TeX Live Guide +TeX Live 2008</title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<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=iso-8859-1,html,info,fn-in --> +<meta name="src" content="texlive-en.tex"> +<meta name="date" content="2008-08-22 00:27:00"> +<link rel="stylesheet" type="text/css" href="texlive-en.css"> +<link rel="stylesheet" type="text/css" href="texlive-en.css" /> +<link rel="stylesheet" type="text/css" href="tex-live.css" /> +</head><body +> + <div class="maketitle"> + + + + + +<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 2008</h2> + <div class="author" ><span +class="ec-lmr-12">Karl Berry, editor</span> +<br /> <a +href="http://tug.org/texlive/" class="url" ><span +class="ec-lmtt-12">http://tug.org/texlive/</span></a> </div> +<br /> +<div class="date" ><span +class="ec-lmr-12">August 2008</span></div> + </div> + <h3 class="likesectionHead"><a + id="x1-1000"></a>Contents</h3> + <div class="tableofcontents"> + <span class="sectionToc" >1 <a +href="#x1-20001" id="QQ2-1-2">Introduction</a></span> +<br />  <span class="subsectionToc" >1.1 <a +href="#x1-30001.1" id="QQ2-1-3">TEX Live and the TEX Collection</a></span> +<br />  <span class="subsectionToc" >1.2 <a +href="#x1-40001.2" id="QQ2-1-4">Operating system support</a></span> +<br />  <span class="subsectionToc" >1.3 <a +href="#x1-50001.3" id="QQ2-1-5">Basic installation of <span class="TEX">T<span +class="E">E</span>X</span> Live</a></span> +<br />  <span class="subsectionToc" >1.4 <a +href="#x1-60001.4" id="QQ2-1-6">Getting help</a></span> +<br /> <span class="sectionToc" >2 <a +href="#x1-70002" id="QQ2-1-7">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">The <span class="TEX">T<span +class="E">E</span>X</span> Collection: TEX Live, proTEXt, MacTEX</a></span> +<br />  <span class="subsectionToc" >2.2 <a +href="#x1-90002.2" id="QQ2-1-9">Top level TEX Live 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> +<br />  <span class="subsectionToc" >2.4 <a +href="#x1-110002.4" id="QQ2-1-11">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 +class="E">E</span>X</span> Live</a></span> +<br />  <span class="subsectionToc" >2.6 <a +href="#x1-130002.6" id="QQ2-1-13">Fonts in <span class="TEX">T<span +class="E">E</span>X</span> Live</a></span> +<br /> <span class="sectionToc" >3 <a +href="#x1-140003" id="QQ2-1-14">Installation</a></span> +<br />  <span class="subsectionToc" >3.1 <a +href="#x1-150003.1" id="QQ2-1-15">Starting the installer</a></span> +<br />   <span class="subsubsectionToc" >3.1.1 <a +href="#x1-160003.1.1" id="QQ2-1-16">Unix</a></span> +<br />   <span class="subsubsectionToc" >3.1.2 <a +href="#x1-170003.1.2" id="QQ2-1-19">Mac OS X</a></span> +<br />   <span class="subsubsectionToc" >3.1.3 <a +href="#x1-180003.1.3" id="QQ2-1-20">Windows</a></span> +<br />   <span class="subsubsectionToc" >3.1.4 <a +href="#x1-190003.1.4" id="QQ2-1-21">The text installer</a></span> +<br />   <span class="subsubsectionToc" >3.1.5 <a +href="#x1-200003.1.5" id="QQ2-1-22">The graphical installer</a></span> +<br />  <span class="subsectionToc" >3.2 <a +href="#x1-210003.2" id="QQ2-1-23">Running the installer</a></span> +<br />   <span class="subsubsectionToc" >3.2.1 <a +href="#x1-220003.2.1" id="QQ2-1-24">Binary systems menu (Unix only)</a></span> +<br />   <span class="subsubsectionToc" >3.2.2 <a +href="#x1-230003.2.2" id="QQ2-1-26">Selecting what is going to be installed</a></span> +<br />   <span class="subsubsectionToc" >3.2.3 <a +href="#x1-240003.2.3" id="QQ2-1-29">Directories</a></span> +<br />   <span class="subsubsectionToc" >3.2.4 <a +href="#x1-250003.2.4" id="QQ2-1-30">Options</a></span> +<br />   <span class="subsubsectionToc" >3.2.5 <a +href="#x1-260003.2.5" id="QQ2-1-32">Set up for running from DVD (text mode only)</a></span> +<br />  <span class="subsectionToc" >3.3 <a +href="#x1-270003.3" id="QQ2-1-34">Command-line install options</a></span> +<br />   <span class="subsubsectionToc" >3.3.1 <a +href="#x1-280003.3.1" id="QQ2-1-35">The <span +class="ec-lmtt-10">location </span>parameter</a></span> +<br />  <span class="subsectionToc" >3.4 <a +href="#x1-290003.4" id="QQ2-1-36">Post-install actions</a></span> + +<br />   <span class="subsubsectionToc" >3.4.1 <a +href="#x1-300003.4.1" id="QQ2-1-37">Windows</a></span> +<br />   <span class="subsubsectionToc" >3.4.2 <a +href="#x1-310003.4.2" id="QQ2-1-38">If symlinks were created</a></span> +<br />   <span class="subsubsectionToc" >3.4.3 <a +href="#x1-320003.4.3" id="QQ2-1-39">Environment variables for Unix</a></span> +<br />   <span class="subsubsectionToc" >3.4.4 <a +href="#x1-330003.4.4" id="QQ2-1-40">Environment variables: global configuration</a></span> +<br />   <span class="subsubsectionToc" >3.4.5 <a +href="#x1-340003.4.5" id="QQ2-1-41">When running from DVD</a></span> +<br />   <span class="subsubsectionToc" >3.4.6 <a +href="#x1-350003.4.6" id="QQ2-1-42">ConTEXt Mark IV</a></span> +<br />   <span class="subsubsectionToc" >3.4.7 <a +href="#x1-360003.4.7" id="QQ2-1-43">Integrating local and personal macros</a></span> +<br />   <span class="subsubsectionToc" >3.4.8 <a +href="#x1-370003.4.8" id="QQ2-1-44">Integrating third-party fonts</a></span> +<br />  <span class="subsectionToc" >3.5 <a +href="#x1-380003.5" id="QQ2-1-45">Testing the installation</a></span> +<br /> <span class="sectionToc" >4 <a +href="#x1-390004" id="QQ2-1-46">Network installations</a></span> +<br /> <span class="sectionToc" >5 <a +href="#x1-400005" id="QQ2-1-47">Maximally portable <span class="TEX">T<span +class="E">E</span>X</span> Live on DVD and USB</a></span> +<br /> <span class="sectionToc" >6 <a +href="#x1-410006" id="QQ2-1-48"><span +class="ec-lmss-10">tlmgr</span>: Managing your installation</a></span> +<br />  <span class="subsectionToc" >6.1 <a +href="#x1-420006.1" id="QQ2-1-51"><span +class="ec-lmss-10">tlmgr </span>GUI mode</a></span> +<br />  <span class="subsectionToc" >6.2 <a +href="#x1-430006.2" id="QQ2-1-52">Sample <span +class="ec-lmss-10">tlmgr </span>command-line invocations</a></span> +<br /> <span class="sectionToc" >7 <a +href="#x1-440007" id="QQ2-1-53">Notes on Windows</a></span> +<br />  <span class="subsectionToc" >7.1 <a +href="#x1-450007.1" id="QQ2-1-54">Windows-specific features</a></span> +<br />  <span class="subsectionToc" >7.2 <a +href="#x1-460007.2" id="QQ2-1-55">Additional included software</a></span> +<br />  <span class="subsectionToc" >7.3 <a +href="#x1-470007.3" id="QQ2-1-57">The Dviout previewer</a></span> +<br />  <span class="subsectionToc" >7.4 <a +href="#x1-480007.4" id="QQ2-1-58">Links for additional downloadable software</a></span> +<br />  <span class="subsectionToc" >7.5 <a +href="#x1-490007.5" id="QQ2-1-59">User Profile is Home</a></span> +<br />  <span class="subsectionToc" >7.6 <a +href="#x1-500007.6" id="QQ2-1-60">The Windows registry</a></span> +<br />  <span class="subsectionToc" >7.7 <a +href="#x1-510007.7" id="QQ2-1-61">Windows permissions</a></span> +<br /> <span class="sectionToc" >8 <a +href="#x1-520008" id="QQ2-1-62">A user’s guide to Web2C</a></span> +<br />  <span class="subsectionToc" >8.1 <a +href="#x1-530008.1" id="QQ2-1-63">Kpathsea path searching</a></span> +<br />   <span class="subsubsectionToc" >8.1.1 <a +href="#x1-540008.1.1" id="QQ2-1-64">Path sources</a></span> +<br />   <span class="subsubsectionToc" >8.1.2 <a +href="#x1-550008.1.2" id="QQ2-1-65">Config files</a></span> +<br />   <span class="subsubsectionToc" >8.1.3 <a +href="#x1-560008.1.3" id="QQ2-1-66">Path expansion</a></span> +<br />   <span class="subsubsectionToc" >8.1.4 <a +href="#x1-570008.1.4" id="QQ2-1-67">Default expansion</a></span> +<br />   <span class="subsubsectionToc" >8.1.5 <a +href="#x1-580008.1.5" id="QQ2-1-68">Brace expansion</a></span> +<br />   <span class="subsubsectionToc" >8.1.6 <a +href="#x1-590008.1.6" id="QQ2-1-69">Subdirectory expansion</a></span> +<br />   <span class="subsubsectionToc" >8.1.7 <a +href="#x1-600008.1.7" id="QQ2-1-70">List of special characters and their meaning: a summary</a></span> +<br />  <span class="subsectionToc" >8.2 <a +href="#x1-610008.2" id="QQ2-1-71">Filename databases</a></span> +<br />   <span class="subsubsectionToc" >8.2.1 <a +href="#x1-620008.2.1" id="QQ2-1-72">The filename database</a></span> +<br />   <span class="subsubsectionToc" >8.2.2 <a +href="#x1-630008.2.2" id="QQ2-1-73">kpsewhich: Standalone path searching</a></span> +<br />   <span class="subsubsectionToc" >8.2.3 <a +href="#x1-640008.2.3" id="QQ2-1-74">Examples of use</a></span> +<br />   <span class="subsubsectionToc" >8.2.4 <a +href="#x1-650008.2.4" id="QQ2-1-75">Debugging actions</a></span> +<br />  <span class="subsectionToc" >8.3 <a +href="#x1-660008.3" id="QQ2-1-79">Runtime options</a></span> +<br /> <span class="sectionToc" >9 <a +href="#x1-670009" id="QQ2-1-80">Acknowledgements</a></span> +<br /> <span class="sectionToc" >10 <a +href="#x1-6800010" id="QQ2-1-81">Release history</a></span> +<br />  <span class="subsectionToc" >10.1 <a +href="#x1-6900010.1" id="QQ2-1-82">Past</a></span> +<br />   <span class="subsubsectionToc" >10.1.1 <a +href="#x1-7000010.1.1" id="QQ2-1-83">2003</a></span> +<br />   <span class="subsubsectionToc" >10.1.2 <a +href="#x1-7100010.1.2" id="QQ2-1-84">2004</a></span> +<br />   <span class="subsubsectionToc" >10.1.3 <a +href="#x1-7200010.1.3" id="QQ2-1-85">2005</a></span> +<br />   <span class="subsubsectionToc" >10.1.4 <a +href="#x1-7300010.1.4" id="QQ2-1-86">2006–2007</a></span> +<br />  <span class="subsectionToc" >10.2 <a +href="#x1-7400010.2" id="QQ2-1-87">Present</a></span> +<br />  <span class="subsectionToc" >10.3 <a +href="#x1-7500010.3" id="QQ2-1-88">Future</a></span> + </div> + + +<!--l. 32--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">1 </span> <a + id="x1-20001"></a>Introduction</h3> +<!--l. 35--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">1.1 </span> <a + id="x1-30001.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. 37--><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 related +programs for GNU/Linux and other Unix flavors, Mac OS X, and Windows systems. +<!--l. 41--><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">T<span +class="E">E</span>X</span> Collection DVD, which <span class="TEX">T<span +class="E">E</span>X</span> +usergroups distribute among their members. Section <a +href="#x1-80002.1">2.1<!--tex4ht:ref: sec:tl-coll-dists --></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">T<span +class="E">E</span>X</span> Collection 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. 47--><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. 52--><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. 55--><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-6800010">10<!--tex4ht:ref: sec:history --></a> (p. <a +href="#x1-6800010">75<!--tex4ht:ref: sec:history --></a>). +<!--l. 59--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">1.2 </span> <a + id="x1-40001.2"></a>Operating system support</h4> +<!--l. 62--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> Live contains binaries for many Unix-based architectures, including Mac OS X. The included +sources should enable installation on platforms for which we do not have binaries. +<!--l. 66--><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 change, Windows requires much less special treatment compared to the Unix +systems. There are no 64-bit executables for Windows, but the 32-bit executables should run on 64-bit +systems. +<!--l. 72--><p class="indent" > See section <a +href="#x1-80002.1">2.1<!--tex4ht:ref: sec:tl-coll-dists --></a> for alternate solutions for Windows and Mac OS X. +<!--l. 75--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">1.3 </span> <a + id="x1-50001.3"></a>Basic installation of <span class="TEX">T<span +class="E">E</span>X</span> Live</h4> +<!--l. 78--><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 small, and +downloads everything requested 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. 83--><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. 87--><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 named <span +class="ec-lmtt-10">install-tl</span>. It can operate in both a GUI mode (default + for Windows) and a text mode (default for everything else). You can force one mode or the + other with the options <span +class="ec-lmtt-10">-gui </span>and <span +class="ec-lmtt-10">-no-gui</span>, respectively. + </li> + <li class="itemize">One of the installed items is a new program, the ‘<span class="TEX">T<span +class="E">E</span>X</span> Live Manager’, named <span +class="ec-lmss-10">tlmgr</span>. Like + the installer, it can be used in both GUI mode and in text mode. You can use it to install + and uninstall packages and do various configuration tasks. + </li></ul> + + +<!--l. 105--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">1.4 </span> <a + id="x1-60001.4"></a>Getting help</h4> +<!--l. 108--><p class="noindent" >The <span class="TEX">T<span +class="E">E</span>X</span> community is both active and friendly, and most serious questions end up getting answered. +However, the support is informal, done by volunteers and casual readers, so it’s especially important that +you do your homework before asking. (If you prefer guaranteed commercial support, you can forego <span class="TEX">T<span +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. 115--><p class="indent" > Here is a list of resources, approximately in the order we recommend using them: +<!--l. 118--><p class="indent" > + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">Getting Started</span> </dt><dd +class="description">If you are new to <span class="TEX">T<span +class="E">E</span>X</span>, the web page <a +href="http://tug.org/begin.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/begin.html</span></a> gives a + brief introduction to the system. + </dd><dt class="description"> +<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> <span +class="ec-lmbx-10">FAQ</span> </dt><dd +class="description">The <span class="TEX">T<span +class="E">E</span>X</span> FAQ is a huge compendium of answers to all sorts of questions, + from the most basic to the most arcane. It is included on <span class="TEX">T<span +class="E">E</span>X</span> Live in + <a +href="../../../../texmf-doc/doc/english/FAQ-en/html/index.html" >texmf-doc/doc/english/FAQ-en/html/index.html</a>, and is available on the Internet through + <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 +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> <span +class="ec-lmbx-10">Catalogue</span> </dt><dd +class="description">If you are looking for a specific package, font, program, etc., the <span class="TEX">T<span +class="E">E</span>X</span> + Catalogue is the place to look. It is a huge collection of all <span class="TEX">T<span +class="E">E</span>X</span>-related items. See + <a +href="http://www.ctan.org/help/Catalogue/" class="url" ><span +class="ec-lmtt-10">http://www.ctan.org/help/Catalogue/</span></a>. + </dd><dt class="description"> +<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> <span +class="ec-lmbx-10">Web Resources</span> </dt><dd +class="description">The web page <a +href="http://tug.org/interest.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/interest.html</span></a> has many <span class="TEX">T<span +class="E">E</span>X</span>-related + links, in particular for numerous books, manuals, and articles on all aspects of the system. + </dd><dt class="description"> +<span +class="ec-lmbx-10">support archives</span> </dt><dd +class="description"> + The two principal support forums are the Usenet newsgroup <a +href="news:comp.text.tex" class="url" ><span +class="ec-lmtt-10">news:comp.text.tex</span></a> and the + mailing list <a +href="mailto:texhax@tug.org" ><span +class="ec-lmtt-10">texhax@tug.org</span></a>. Their archives have years of past questions and answers for + your searching pleasure, via <a +href="http://groups.google.com/group/comp.text.tex/topics" class="url" ><span +class="ec-lmtt-10">http://groups.google.com/group/comp.text.tex/topics</span></a> + and <a +href="http://tug.org/mail-archives/texhax" class="url" ><span +class="ec-lmtt-10">http://tug.org/mail-archives/texhax</span></a>, respectively. And a general web search, for + example on <a +href="http://google.com" class="url" ><span +class="ec-lmtt-10">http://google.com</span></a>, never hurts. + </dd><dt class="description"> +<span +class="ec-lmbx-10">asking questions</span> </dt><dd +class="description">If you cannot find an answer, you can post to <span +class="ec-lmtt-10">comp.text.tex </span>through + Google or your newsreader, or to <a +href="mailto:texhax@tug.org" ><span +class="ec-lmtt-10">texhax@tug.org</span></a> through email. But before you post, + <span +class="ec-lmri-10">please </span>read this FAQ entry, to maximize your chances of getting a useful answer: + <a +href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion" class="url" ><span +class="ec-lmtt-10">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion</span></a>. + </dd><dt class="description"> +<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> <span +class="ec-lmbx-10">Live support</span> </dt><dd +class="description">If you want to report a bug or have suggestions or comments on the <span class="TEX">T<span +class="E">E</span>X</span> + Live distribution, installation, or documentation, the mailing list is <a +href="mailto:tex-live@tug.org" ><span +class="ec-lmtt-10">tex-live@tug.org</span></a>. + However, if your question is about how to use a particular program included in <span class="TEX">T<span +class="E">E</span>X</span> Live, + please write to that program’s maintainer or mailing list. Often running a program with the + <span +class="ec-lmtt-10">--help </span>option will provide a bug reporting address. + </dd></dl> +<!--l. 164--><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. + + +<!--l. 171--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">2 </span> <a + id="x1-70002"></a>Overview of <span class="TEX">T<span +class="E">E</span>X</span> Live</h3> +<!--l. 174--><p class="noindent" >This section describes the contents of <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 of which it is a +part. +<!--l. 177--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">2.1 </span> <a + id="x1-80002.1"></a>The <span class="TEX">T<span +class="E">E</span>X</span> Collection: <span class="TEX">T<span +class="E">E</span>X</span> Live, pro<span class="TEX">T<span +class="E">E</span>X</span>t, Mac<span class="TEX">T<span +class="E">E</span>X</span></h4> +<!--l. 180--><p class="noindent" >The <span class="TEX">T<span +class="E">E</span>X</span> Collection DVD comprises the following: +<!--l. 182--><p class="indent" > + <dl class="description"><dt class="description"> +<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> <span +class="ec-lmbx-10">Live</span> </dt><dd +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. + </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, this adds a native Mac OS X installer and other Mac applications to + <span class="TEX">T<span +class="E">E</span>X</span> Live. Its home page is <a +href="http://www.tug.org/mactex/" class="url" ><span +class="ec-lmtt-10">http://www.tug.org/mactex/</span></a>. + </dd><dt class="description"> +<span +class="ec-lmbx-10">pro</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><span +class="ec-lmbx-10">t</span> </dt><dd +class="description">An enhancement of the MiK<span class="TEX">T<span +class="E">E</span>X</span> distribution for Windows, Pro<span class="TEX">T<span +class="E">E</span>X</span>t adds a + few extra tools to MiK<span class="TEX">T<span +class="E">E</span>X</span>, and simplifies installation. It is entirely independent + of <span class="TEX">T<span +class="E">E</span>X</span> Live, and has its own installation instructions. The Pro<span class="TEX">T<span +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>. + </dd><dt class="description"> +<span +class="ec-lmbx-10">CTAN</span> </dt><dd +class="description">A snapshot of the CTAN repository. + </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. 203--><p class="indent" > CTAN, <span +class="ec-lmss-10">protext</span>, and <span +class="ec-lmtt-10">texmf-extra </span>do not necessarily 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. 208--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">2.2 </span> <a + id="x1-90002.2"></a>Top level <span class="TEX">T<span +class="E">E</span>X</span> Live directories</h4> +<!--l. 211--><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 +class="E">E</span>X</span> Live hierarchy is in a subdirectory <span +class="ec-lmtt-10">texlive</span>, not at the top level of the +disc. +<!--l. 216--><p class="noindent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmtt-10">bin</span> </dt><dd +class="list"> + <!--l. 217--><p class="noindent" >The <span class="TEX">T<span +class="E">E</span>X</span> system programs, arranged by platform. + </dd><dt class="list"> + <span +class="ec-lmtt-10">readme.html</span> </dt><dd +class="list"> + <!--l. 219--><p class="noindent" >Web pages with a quick introduction and useful links, in various languages. + </dd><dt class="list"> + <span +class="ec-lmtt-10">source</span> </dt><dd +class="list"> + <!--l. 222--><p class="noindent" >The source to all included programs, including the main Web2C <span class="TEX">T<span +class="E">E</span>X</span> and Metafont + distributions. + + </dd><dt class="list"> + <span +class="ec-lmtt-10">support</span> </dt><dd +class="list"> + <!--l. 225--><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. + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf</span> </dt><dd +class="list"> + <!--l. 229--><p class="noindent" >See <span +class="ec-lmtt-10">TEXMFMAIN </span>below. + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-dist</span> </dt><dd +class="list"> + <!--l. 231--><p class="noindent" >See <span +class="ec-lmtt-10">TEXMFDIST </span>below. + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-doc</span> </dt><dd +class="list"> + <!--l. 233--><p class="noindent" >Tree for self-contained pure documentation, arranged by language. + </dd><dt class="list"> + <span +class="ec-lmtt-10">tlpkg</span> </dt><dd +class="list"> + <!--l. 236--><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.</dd></dl> +<!--l. 242--><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. 246--><p class="indent" > The <span +class="ec-lmtt-10">texmf-doc </span>directory contains documentation which does not belong to any particular package or +program. The documentation for the programs (manuals, man pages, Info files) is in <span +class="ec-lmtt-10">texmf/doc</span>. 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 +class="ec-lmss-10">texdoctk</span> +programs to find any documentation wherever it is located. The comprehensive links in the top-level file +<a +href="../../../../doc.html" >doc.html</a> may also be helpful. +<!--l. 255--><p class="indent" > This <span class="TEX">T<span +class="E">E</span>X</span> Live documentation itself is in <span +class="ec-lmtt-10">texmf-doc </span>and is available in several languages: + <ul class="itemize1"> + <li class="itemize">Simplified Chinese: <a +href="../../../../texmf-doc/doc/chinese/texlive-zh-cn" >texmf-doc/doc/chinese/texlive-zh-cn</a> + </li> + <li class="itemize">Czech/Slovak: <a +href="../../../../texmf-doc/doc/czechslovak/texlive-cz" >texmf-doc/doc/czechslovak/texlive-cz</a> + </li> + <li class="itemize">English: <a +href="../../../../texmf-doc/doc/english/texlive-en" >texmf-doc/doc/english/texlive-en</a> + </li> + <li class="itemize">French: <a +href="../../../../texmf-doc/doc/french/texlive-fr" >texmf-doc/doc/french/texlive-fr</a> + </li> + <li class="itemize">German: <a +href="../../../../texmf-doc/doc/german/texlive-de" >texmf-doc/doc/german/texlive-de</a> + </li> + <li class="itemize">Polish: <a +href="../../../../texmf-doc/doc/polish/texlive-pl" >texmf-doc/doc/polish/texlive-pl</a> + </li> + <li class="itemize">Russian: <a +href="../../../../texmf-doc/doc/russian/texlive-ru" >texmf-doc/doc/russian/texlive-ru</a></li></ul> +<!--l. 268--><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. 271--><p class="noindent" >This section lists all predefined variables specifying the texmf trees used by the system, and their +intended purpose, and the default layout of a <span class="TEX">T<span +class="E">E</span>X</span> Live system. 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. 277--><p class="noindent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmtt-10">TEXMFMAIN</span> </dt><dd +class="list"> + <!--l. 278--><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>) + and other support files and their documentation. Does not include <span class="TEX">T<span +class="E">E</span>X</span> formats and + packages. + </dd><dt class="list"> + <span +class="ec-lmtt-10">TEXMFDIST</span> </dt><dd +class="list"> + <!--l. 282--><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. 284--><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. 286--><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 dynamically adjusts for each user to their + own individual directory. + </dd><dt class="list"> + <span +class="ec-lmtt-10">TEXMFCONFIG</span> </dt><dd +class="list"> + <!--l. 290--><p class="noindent" >The tree used by the 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 +class="ec-lmtt-10">fmtutil</span></span></span> to store modified + configuration data. Under <span +class="ec-lmtt-10">TEXMFHOME </span>by default. + </dd><dt class="list"> + <span +class="ec-lmtt-10">TEXMFSYSCONFIG</span> </dt><dd +class="list"> + <!--l. 293--><p class="noindent" >The tree used by the 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 +class="ec-lmtt-10">fmtutil-sys</span></span></span> to store + modified configuration data. + </dd><dt class="list"> + <span +class="ec-lmtt-10">TEXMFVAR</span> </dt><dd +class="list"> + <!--l. 296--><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 + format files and generated map files. Under <span +class="ec-lmtt-10">TEXMFHOME </span>by default. + </dd><dt class="list"> + <span +class="ec-lmtt-10">TEXMFSYSVAR</span> </dt><dd +class="list"> + <!--l. 299--><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>, and also by <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">tlmgr</span></span></span>, to + store (cached) runtime data such as format files and generated map files.</dd></dl> +<!--l. 304--><p class="noindent" >The default layout is: + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">system-wide root</span> </dt><dd +class="description">can span multiple <span class="TEX">T<span +class="E">E</span>X</span> Live releases: + <dl class="list2"><dt class="list"> + <span +class="ec-lmtt-10">2007</span> </dt><dd +class="list"> + <!--l. 309--><p class="noindent" >A previous release. + + <dl class="list3"><dt class="list"> + <span +class="ec-lmtt-10">...</span> </dt><dd +class="list"> + <!--l. 311--><p class="noindent" ></dd></dl> + </dd><dt class="list"> + <span +class="ec-lmtt-10">2008</span> </dt><dd +class="list"> + <!--l. 313--><p class="noindent" >The current release. + <dl class="list3"><dt class="list"> + <span +class="ec-lmtt-10">bin</span> </dt><dd +class="list"> + <!--l. 315--><p class="noindent" >  + <dl class="list4"><dt class="list"> + <span +class="ec-lmtt-10">i386-linux</span> </dt><dd +class="list"> + <!--l. 317--><p class="noindent" >GNU/Linux binaries + </dd><dt class="list"> + <span +class="ec-lmtt-10">...</span> </dt><dd +class="list"> + <!--l. 318--><p class="noindent" > + </dd><dt class="list"> + <span +class="ec-lmtt-10">universal-darwin</span> </dt><dd +class="list"> + <!--l. 319--><p class="noindent" >Mac OS X binaries + </dd><dt class="list"> + <span +class="ec-lmtt-10">win32</span> </dt><dd +class="list"> + <!--l. 320--><p class="noindent" >Windows binaries</dd></dl> + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf</span> </dt><dd +class="list"> + <!--l. 322--><p class="noindent" >This is <span +class="ec-lmtt-10">TEXMFMAIN</span>. + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-dist</span> </dt><dd +class="list"> + <!--l. 323--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFDIST</span> + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-doc</span> </dt><dd +class="list"> + <!--l. 324--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFDOC</span> + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-var</span> </dt><dd +class="list"> + <!--l. 325--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFSYSVAR</span> + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-config</span> </dt><dd +class="list"> + <!--l. 326--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFSYSCONFIG</span></dd></dl> + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-local</span> </dt><dd +class="list"> + <!--l. 328--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFLOCAL</span>, intended to be retained from release to release.</dd></dl> + </dd><dt class="description"> +<span +class="ec-lmbx-10">user’s home</span> </dt><dd +class="description">(<span +class="ec-lmtt-10">$HOME </span>or <span +class="ec-lmtt-10">%USERPROFILE%</span>) + <dl class="list2"><dt class="list"> + <span +class="ec-lmtt-10">.texlive2007</span> </dt><dd +class="list"> + <!--l. 334--><p class="noindent" >Privately generated and configuration data for a previous release. + </dd><dt class="list"> + <span +class="ec-lmtt-10">.texlive2008</span> </dt><dd +class="list"> + <!--l. 336--><p class="noindent" >Privately generated and configuration data for the current release. + <dl class="list3"><dt class="list"> + <span +class="ec-lmtt-10">texmf-var</span> </dt><dd +class="list"> + + <!--l. 339--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFVAR</span> + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-config</span> </dt><dd +class="list"> + <!--l. 340--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFCONFIG</span></dd></dl> + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf</span> </dt><dd +class="list"> + <!--l. 342--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFHOME </span>Personal macros. <span +class="ec-lmri-10">etc.</span></dd></dl> + </dd></dl> +<!--l. 348--><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 +class="E">E</span>X</span></h4> +<!--l. 351--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> itself is frozen, apart from rare bug fixes. It is still present in <span class="TEX">T<span +class="E">E</span>X</span> Live as the program <span +class="ec-lmss-10">tex</span>, +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. 355--><p class="indent" > + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">e-</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 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 +class="ec-lmbx-10">pdf</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">builds on the e-<span class="TEX">T<span +class="E">E</span>X</span> extensions, adding support for writing PDF output as well + as DVI. This is the program invoked for most formats, e.g., <span +class="ec-lmss-10">etex</span>, <span +class="ec-lmss-10">latex</span>, <span +class="ec-lmss-10">pdflatex</span>. See + <a +href="http://www.pdftex.org/" class="url" ><span +class="ec-lmtt-10">http://www.pdftex.org/</span></a>. <a +href="../../../../texmf-dist/doc/pdftex/manual/pdftex-a.pdf" >texmf-dist/doc/pdftex/manual/pdftex-a.pdf</a> for the manual, and + <a +href="../../../../texmf-dist/doc/pdftex/manual/samplepdf/samplepdf.tex" >texmf-dist/doc/pdftex/manual/samplepdf/samplepdf.tex</a> for example usage of some of its + features. + </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">is the designated successor of pdf<span class="TEX">T<span +class="E">E</span>X</span>, with which it is intended to 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. 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>. + </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- and system fonts, implemented using + standard 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"> +<span +class="ec-lmbx-10">Omega</span><span +class="ec-lmbx-10"> (Omega)</span> </dt><dd +class="description">is based on Unicode (16-bit characters), thus supports working with almost + all the world’s scripts simultaneously. It also supports so-called ‘Omega Translation + Processes’ (OTPs), for performing complex transformations on arbitrary input. See + <a +href="../../../../texmf-dist/doc/omega/base/doc-1.8.tex" >texmf-dist/doc/omega/base/doc-1.8.tex</a> (not completely up-to-date). + </dd><dt class="description"> +<span +class="ec-lmbx-10">Aleph</span> </dt><dd +class="description">combines the Omega and e-<span class="TEX">T<span +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. 397--><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 +class="E">E</span>X</span> Live</h4> +<!--l. 399--><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. 401--><p class="indent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmss-10">bibtex</span> </dt><dd +class="list"> + <!--l. 403--><p class="noindent" >bibliography support. + </dd><dt class="list"> + <span +class="ec-lmss-10">makeindex</span> </dt><dd +class="list"> + <!--l. 405--><p class="noindent" >index support. + </dd><dt class="list"> + <span +class="ec-lmss-10">dvips</span> </dt><dd +class="list"> + <!--l. 407--><p class="noindent" >convert DVI to PostScript. + </dd><dt class="list"> + <span +class="ec-lmss-10">xdvi</span> </dt><dd +class="list"> + <!--l. 409--><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. 411--><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. 413--><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. 415--><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. 418--><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 +class="ec-lmss-10">pdftricks </span>packages for still more alternatives. + </dd><dt class="list"> + <span +class="ec-lmss-10">psselect, psnup, </span><span +class="ec-lmss-10">…</span> </dt><dd +class="list"> + <!--l. 422--><p class="noindent" >PostScript utilities. + </dd><dt class="list"> + <span +class="ec-lmss-10">lacheck</span> </dt><dd +class="list"> + <!--l. 425--><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, texmfstart</span> </dt><dd +class="list"> + <!--l. 427--><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. 429--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> to HTML (and XML and more) converter. + </dd></dl> + + +<!--l. 434--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">2.6 </span> <a + id="x1-130002.6"></a>Fonts in <span class="TEX">T<span +class="E">E</span>X</span> Live</h4> +<!--l. 437--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> Live comes with many high-quality scalable fonts. See <a +href="http://tug.org/fonts" class="url" ><span +class="ec-lmtt-10">http://tug.org/fonts</span></a> and +<a +href="../../../../texmf-doc/doc/english/free-math-font-survey" >texmf-doc/doc/english/free-math-font-survey</a>. +<!--l. 443--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">3 </span> <a + id="x1-140003"></a>Installation</h3> +<!--l. 446--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.1 </span> <a + id="x1-150003.1"></a>Starting the installer</h4> +<!--l. 449--><p class="noindent" >To start with, get the <span class="TEX">T<span +class="E">E</span>X</span> Collection DVD or download the <span class="TEX">T<span +class="E">E</span>X</span> Live net installer, and locate the +installer script: <span +class="ec-lmtt-10">install-tl </span>for Unix, <span +class="ec-lmtt-10">install-tl.bat </span>for Windows. +<!--l. 453--><p class="indent" > + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">Net installer:</span> </dt><dd +class="description">Download from CTAN, under <span +class="ec-lmtt-10">systems/texlive/tlnet</span>; + the url <a +href="http://mirror.ctan.org/systems/texlive/tlnet" class="url" ><span +class="ec-lmtt-10">http://mirror.ctan.org/systems/texlive/tlnet</span></a> will automatically redirect to a + nearby, up-to-date, mirror. You can retrieve either <span +class="ec-lmtt-10">install-tl.zip </span>which can be used under + Unix and Windows and <span +class="ec-lmtt-10">install-unx.tar.gz </span>which is considerably smaller, for Unix only. + After unpacking, <span +class="ec-lmtt-10">install-tl </span>and <span +class="ec-lmtt-10">install-tl.bat </span>will be in the <span +class="ec-lmtt-10">install-tl </span>subdirectory. + </dd><dt class="description"> +<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> <span +class="ec-lmbx-10">Collection DVD:</span> </dt><dd +class="description">go to its <span +class="ec-lmtt-10">texlive </span>subdirectory. Under Windows, the installer should + start automatically when you insert the DVD. You can get the DVD by becoming a + member of a <span class="TEX">T<span +class="E">E</span>X</span> user group (highly recommended, <a +href="http://tug.org/usergroups.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/usergroups.html</span></a>), + or purchasing it separately (<a +href="http://tug.org/store" class="url" ><span +class="ec-lmtt-10">http://tug.org/store</span></a>), or burning your own from the + ISO image (<a +href="http://tug.org/texlive/acquire.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/acquire.html</span></a>). + </dd></dl> +<!--l. 473--><p class="noindent" >The following sections explain in more detail. +<!--l. 475--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.1.1 </span> <a + id="x1-160003.1.1"></a>Unix</h5> +<!--l. 477--><p class="noindent" ><hr class="figure"><div class="figure" +><table class="figure"><tr class="figure"><td class="figure" +> + + +<a + id="x1-16091r1"></a> + + +<div class="fancyvrb" id="fancyvrb1"> +<a + id="x1-16002r1"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> ======================></span><span +class="ec-lmtt-8x-x-87"> TeX</span><span +class="ec-lmtt-8x-x-87"> Live</span><span +class="ec-lmtt-8x-x-87"> installation</span><span +class="ec-lmtt-8x-x-87"> procedure</span><span +class="ec-lmtt-8x-x-87"> <=====================</span> +<br class="fancyvrb" /><a + id="x1-16004r2"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-16006r3"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> =======></span><span +class="ec-lmtt-8x-x-87"> Note:</span><span +class="ec-lmtt-8x-x-87"> Letters/digits</span><span +class="ec-lmtt-8x-x-87"> in</span><span +class="ec-lmtt-8x-x-87"> <angle</span><span +class="ec-lmtt-8x-x-87"> brackets></span><span +class="ec-lmtt-8x-x-87"> indicate</span><span +class="ec-lmtt-8x-x-87"> menu</span><span +class="ec-lmtt-8x-x-87"> items</span><span +class="ec-lmtt-8x-x-87"> <=======</span> +<br class="fancyvrb" /><a + id="x1-16008r4"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> =======></span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> commands</span><span +class="ec-lmtt-8x-x-87"> or</span><span +class="ec-lmtt-8x-x-87"> configurable</span><span +class="ec-lmtt-8x-x-87"> options</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <=======</span> +<br class="fancyvrb" /><a + id="x1-16010r5"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-16012r6"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-16014r7"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Detected</span><span +class="ec-lmtt-8x-x-87"> platform:</span><span +class="ec-lmtt-8x-x-87"> Intel</span><span +class="ec-lmtt-8x-x-87"> x86</span><span +class="ec-lmtt-8x-x-87"> with</span><span +class="ec-lmtt-8x-x-87"> GNU/Linux</span> +<br class="fancyvrb" /><a + id="x1-16016r8"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-16018r9"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <B></span><span +class="ec-lmtt-8x-x-87"> binary</span><span +class="ec-lmtt-8x-x-87"> systems:</span><span +class="ec-lmtt-8x-x-87"> 1</span><span +class="ec-lmtt-8x-x-87"> out</span><span +class="ec-lmtt-8x-x-87"> of</span><span +class="ec-lmtt-8x-x-87"> 16</span> +<br class="fancyvrb" /><a + id="x1-16020r10"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-16022r11"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <S></span><span +class="ec-lmtt-8x-x-87"> Installation</span><span +class="ec-lmtt-8x-x-87"> scheme</span><span +class="ec-lmtt-8x-x-87"> (scheme-full)</span> +<br class="fancyvrb" /><a + id="x1-16024r12"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-16026r13"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Customizing</span><span +class="ec-lmtt-8x-x-87"> installation</span><span +class="ec-lmtt-8x-x-87"> scheme:</span> +<br class="fancyvrb" /><a + id="x1-16028r14"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <C></span><span +class="ec-lmtt-8x-x-87"> standard</span><span +class="ec-lmtt-8x-x-87"> collections</span> +<br class="fancyvrb" /><a + id="x1-16030r15"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <L></span><span +class="ec-lmtt-8x-x-87"> language</span><span +class="ec-lmtt-8x-x-87"> collections</span> +<br class="fancyvrb" /><a + id="x1-16032r16"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> 83</span><span +class="ec-lmtt-8x-x-87"> collections</span><span +class="ec-lmtt-8x-x-87"> out</span><span +class="ec-lmtt-8x-x-87"> of</span><span +class="ec-lmtt-8x-x-87"> 84,</span><span +class="ec-lmtt-8x-x-87"> disk</span><span +class="ec-lmtt-8x-x-87"> space</span><span +class="ec-lmtt-8x-x-87"> required:</span><span +class="ec-lmtt-8x-x-87"> 1666</span><span +class="ec-lmtt-8x-x-87"> MB</span> +<br class="fancyvrb" /><a + id="x1-16034r17"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-16036r18"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <D></span><span +class="ec-lmtt-8x-x-87"> directories:</span> +<br class="fancyvrb" /><a + id="x1-16038r19"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXDIR</span><span +class="ec-lmtt-8x-x-87"> (the</span><span +class="ec-lmtt-8x-x-87"> main</span><span +class="ec-lmtt-8x-x-87"> TeX</span><span +class="ec-lmtt-8x-x-87"> directory):</span> +<br class="fancyvrb" /><a + id="x1-16040r20"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> !!</span><span +class="ec-lmtt-8x-x-87"> default</span><span +class="ec-lmtt-8x-x-87"> location:</span><span +class="ec-lmtt-8x-x-87"> /usr/local/texlive/2008</span> +<br class="fancyvrb" /><a + id="x1-16042r21"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> !!</span><span +class="ec-lmtt-8x-x-87"> is</span><span +class="ec-lmtt-8x-x-87"> not</span><span +class="ec-lmtt-8x-x-87"> writable,</span><span +class="ec-lmtt-8x-x-87"> please</span><span +class="ec-lmtt-8x-x-87"> select</span><span +class="ec-lmtt-8x-x-87"> a</span><span +class="ec-lmtt-8x-x-87"> different</span><span +class="ec-lmtt-8x-x-87"> one!</span> +<br class="fancyvrb" /><a + id="x1-16044r22"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXMFLOCAL</span><span +class="ec-lmtt-8x-x-87"> (directory</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> site-wide</span><span +class="ec-lmtt-8x-x-87"> local</span><span +class="ec-lmtt-8x-x-87"> files):</span> +<br class="fancyvrb" /><a + id="x1-16046r23"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> /usr/local/texlive/texmf-local</span> +<br class="fancyvrb" /><a + id="x1-16048r24"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXMFSYSVAR</span><span +class="ec-lmtt-8x-x-87"> (directory</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> variable</span><span +class="ec-lmtt-8x-x-87"> and</span><span +class="ec-lmtt-8x-x-87"> automatically</span><span +class="ec-lmtt-8x-x-87"> generated</span><span +class="ec-lmtt-8x-x-87"> data):</span> +<br class="fancyvrb" /><a + id="x1-16050r25"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> /usr/local/texlive/2008/texmf-var</span> +<br class="fancyvrb" /><a + id="x1-16052r26"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXMFSYSCONFIG</span><span +class="ec-lmtt-8x-x-87"> (directory</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> local</span><span +class="ec-lmtt-8x-x-87"> config):</span> +<br class="fancyvrb" /><a + id="x1-16054r27"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> /usr/local/texlive/2008/texmf-config</span> +<br class="fancyvrb" /><a + id="x1-16056r28"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXMFHOME</span><span +class="ec-lmtt-8x-x-87"> (directory</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> user-specific</span><span +class="ec-lmtt-8x-x-87"> files):</span> +<br class="fancyvrb" /><a + id="x1-16058r29"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> ~/texmf</span> +<br class="fancyvrb" /><a + id="x1-16060r30"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-16062r31"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <O></span><span +class="ec-lmtt-8x-x-87"> options:</span> +<br class="fancyvrb" /><a + id="x1-16064r32"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> use</span><span +class="ec-lmtt-8x-x-87"> letter</span><span +class="ec-lmtt-8x-x-87"> size</span><span +class="ec-lmtt-8x-x-87"> instead</span><span +class="ec-lmtt-8x-x-87"> of</span><span +class="ec-lmtt-8x-x-87"> A4</span><span +class="ec-lmtt-8x-x-87"> by</span><span +class="ec-lmtt-8x-x-87"> default</span> +<br class="fancyvrb" /><a + id="x1-16066r33"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> [X]</span><span +class="ec-lmtt-8x-x-87"> create</span><span +class="ec-lmtt-8x-x-87"> all</span><span +class="ec-lmtt-8x-x-87"> format</span><span +class="ec-lmtt-8x-x-87"> files</span> +<br class="fancyvrb" /><a + id="x1-16068r34"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> [X]</span><span +class="ec-lmtt-8x-x-87"> install</span><span +class="ec-lmtt-8x-x-87"> macro/font</span><span +class="ec-lmtt-8x-x-87"> doc</span><span +class="ec-lmtt-8x-x-87"> tree</span> +<br class="fancyvrb" /><a + id="x1-16070r35"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> [X]</span><span +class="ec-lmtt-8x-x-87"> install</span><span +class="ec-lmtt-8x-x-87"> macro/font</span><span +class="ec-lmtt-8x-x-87"> source</span><span +class="ec-lmtt-8x-x-87"> tree</span> +<br class="fancyvrb" /><a + id="x1-16072r36"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> create</span><span +class="ec-lmtt-8x-x-87"> symlinks</span><span +class="ec-lmtt-8x-x-87"> in</span><span +class="ec-lmtt-8x-x-87"> standard</span><span +class="ec-lmtt-8x-x-87"> directories</span> +<br class="fancyvrb" /><a + id="x1-16074r37"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-16076r38"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <V></span><span +class="ec-lmtt-8x-x-87"> Install</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> running</span><span +class="ec-lmtt-8x-x-87"> from</span><span +class="ec-lmtt-8x-x-87"> DVD</span> +<br class="fancyvrb" /><a + id="x1-16078r39"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-16080r40"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Other</span><span +class="ec-lmtt-8x-x-87"> actions:</span> +<br class="fancyvrb" /><a + id="x1-16082r41"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <I></span><span +class="ec-lmtt-8x-x-87"> start</span><span +class="ec-lmtt-8x-x-87"> installation</span><span +class="ec-lmtt-8x-x-87"> to</span><span +class="ec-lmtt-8x-x-87"> HD</span> +<br class="fancyvrb" /><a + id="x1-16084r42"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <H></span><span +class="ec-lmtt-8x-x-87"> help</span> +<br class="fancyvrb" /><a + id="x1-16086r43"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <Q></span><span +class="ec-lmtt-8x-x-87"> quit</span> +<br class="fancyvrb" /><a + id="x1-16088r44"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-16090r45"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Enter</span><span +class="ec-lmtt-8x-x-87"> command:</span> +</div> +<br /> <table class="caption" +><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 1: </td><td +class="content">Main text installer screen (GNU/Linux)</td></tr></table><!--tex4ht:label?: x1-16091r1 --> + + +<!--l. 526--><p class="noindent" ></td></tr></table></div><hr class="endfigure"> +<!--l. 528--><p class="indent" > <hr class="figure"><div class="figure" +><table class="figure"><tr class="figure"><td class="figure" +> + + +<a + id="x1-16092r2"></a> + + + +<!--l. 529--><p class="noindent" ><img +src="install-w32-main.png" alt="pict" +> +<br /> <table class="caption" +><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 2: </td><td +class="content">Main GUI installer screen (Windows)</td></tr></table><!--tex4ht:label?: x1-16092r2 --> + + +<!--l. 531--><p class="indent" > </td></tr></table></div><hr class="endfigure"> +<!--l. 533--><p class="noindent" >Below, <span +class="ec-lmtt-10">> </span>denotes the shell prompt; user input is <span +class="ec-lmtk-10">bold</span>. Starting in a terminal window on a +Unix-compatible system, the simplest way: <div class="alltt"> +<!--l. 538--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">cd</span><span +class="ec-lmtk-10"> /path/to/installer</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">perl</span><span +class="ec-lmtk-10"> install-tl</span> +</div> +</div> (Or you can invoke <span +class="ec-lmtk-10">perl /path/to/installer/install-tl</span>, or <span +class="ec-lmtk-10">./install-tl </span>if it stayed executable, +etc.; we won’t repeat all these variations.) +<!--l. 546--><p class="indent" > To install in GUI mode (you’ll need the <span +class="ec-lmtt-10">Perl/TK </span>module), use: <div class="alltt"> +<!--l. 547--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">perl</span><span +class="ec-lmtk-10"> install-tl</span><span +class="ec-lmtk-10"> -gui</span> +</div> +</div> +<!--l. 551--><p class="indent" > For a complete listing of the various options: <div class="alltt"> +<!--l. 552--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">perl</span><span +class="ec-lmtk-10"> install-tl</span><span +class="ec-lmtk-10"> -help</span> +</div> +</div> +<!--l. 556--><p class="indent" > <span +class="ec-lmbx-10">Warning about Unix permissions: </span>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 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. + <h5 class="subsubsectionHead"><span class="titlemark">3.1.2 </span> <a + id="x1-170003.1.2"></a>Mac OS X</h5> +<!--l. 566--><p class="noindent" >As mentioned in section <a +href="#x1-80002.1">2.1<!--tex4ht:ref: sec:tl-coll-dists --></a>, a separate distribution is prepared for Mac OS X, named +Mac<span class="TEX">T<span +class="E">E</span>X</span> (<a +href="http://tug.org/mactex" class="url" ><span +class="ec-lmtt-10">http://tug.org/mactex</span></a>). We recommend using the native Mac<span class="TEX">T<span +class="E">E</span>X</span> installer instead of the +<span class="TEX">T<span +class="E">E</span>X</span> Live installer on Mac OS X, because the native installer can make a few Mac-specific adjustments, +in particular to allow easily switching between the various <span class="TEX">T<span +class="E">E</span>X</span> distributions for Mac OS X (Mac<span class="TEX">T<span +class="E">E</span>X</span>, +gw<span class="TEX">T<span +class="E">E</span>X</span>, Fink, MacPorts, …). +<!--l. 574--><p class="indent" > Mac<span class="TEX">T<span +class="E">E</span>X</span> is firmly based on <span class="TEX">T<span +class="E">E</span>X</span> Live, and the main <span class="TEX">T<span +class="E">E</span>X</span> trees are precisely the same. It does add a +few extra folders with Mac-specific documentation and applications. +<!--l. 579--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.1.3 </span> <a + id="x1-180003.1.3"></a>Windows</h5> +<!--l. 581--><p class="noindent" >If you are using the net installer, or the DVD installer failed to start automatically, double-click +<span +class="ec-lmtt-10">install-tl.bat</span>. +<!--l. 584--><p class="indent" > You can also start the installer from the command-prompt. Below, <span +class="ec-lmtt-10">> </span>denotes the prompt; user input +is <span +class="ec-lmtk-10">bold</span>. If you are in the installer directory, run just: <div class="alltt"> +<!--l. 587--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">install-tl</span> + +</div> +</div> +<!--l. 591--><p class="indent" > Or you can invoke it with an absolute location, such as: <div class="alltt"> +<!--l. 592--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">D:</span><span +class="ec-lmtt-10">\</span><span +class="ec-lmtk-10">texlive</span><span +class="ec-lmtt-10">\</span><span +class="ec-lmtk-10">install-tl</span> +</div> +</div> for the <span class="TEX">T<span +class="E">E</span>X</span> Collection DVD, supposing that <span +class="ec-lmtt-10">D: </span>is the optical drive. +<!--l. 597--><p class="indent" > To install in text mode, use: <div class="alltt"> +<!--l. 598--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">install-tl</span><span +class="ec-lmtk-10"> -no-gui</span> +</div> +</div> +<!--l. 602--><p class="indent" > For a complete listing of the various options: <div class="alltt"> +<!--l. 603--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">install-tl</span><span +class="ec-lmtk-10"> -help</span> +</div> +</div> +<!--l. 607--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.1.4 </span> <a + id="x1-190003.1.4"></a>The text installer</h5> +<!--l. 609--><p class="noindent" >Figure <a +href="#x1-16091r1">1<!--tex4ht:ref: fig:text-main --></a> displays the main text mode screen under Unix. +<!--l. 612--><p class="indent" > This is only a command-line installer; there is no cursor support at all. For instance, you cannot tab +around checkboxes or input fields. You just type something (case-sensitive) at the prompt and +press the Enter key, and then the entire terminal screen will be rewritten, with adjusted +content. +<!--l. 618--><p class="indent" > The text installer interface is this primitive for a reason: it is designed to run on as many platforms as +possible, even with a very barebones Perl (for Windows, a Perl subset is included). +<!--l. 622--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.1.5 </span> <a + id="x1-200003.1.5"></a>The graphical installer</h5> +<!--l. 624--><p class="noindent" >Figure <a +href="#x1-16092r2">2<!--tex4ht:ref: fig:gui-main --></a> displays the graphical installer under Windows. Most differences in available options +are due to this screenshot being from Windows, and the previous text screen being from +GNU/Linux. +<!--l. 629--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.2 </span> <a + id="x1-210003.2"></a>Running the installer</h4> +<!--l. 632--><p class="noindent" >The installer is intended to be mostly self-explanatory. Still, a few quick notes about the various options +and submenus: +<!--l. 635--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.2.1 </span> <a + id="x1-220003.2.1"></a>Binary systems menu (Unix only)</h5> +<!--l. 638--><p class="noindent" ><hr class="figure"><div class="figure" +><table class="figure"><tr class="figure"><td class="figure" +> + +<a + id="x1-22037r3"></a> + + +<div class="fancyvrb" id="fancyvrb2"> +<a + id="x1-22002r1"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Available</span><span +class="ec-lmtt-8x-x-87"> sets</span><span +class="ec-lmtt-8x-x-87"> of</span><span +class="ec-lmtt-8x-x-87"> binaries:</span> +<br class="fancyvrb" /><a + id="x1-22004r2"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> ===============================================================================</span> +<br class="fancyvrb" /><a + id="x1-22006r3"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-22008r4"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> a</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> alpha-linux</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> DEC</span><span +class="ec-lmtt-8x-x-87"> Alpha</span><span +class="ec-lmtt-8x-x-87"> with</span><span +class="ec-lmtt-8x-x-87"> GNU/Linux</span> +<br class="fancyvrb" /><a + id="x1-22010r5"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> b</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> amd64-freebsd</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> x86_64</span><span +class="ec-lmtt-8x-x-87"> with</span><span +class="ec-lmtt-8x-x-87"> FreeBSD</span> +<br class="fancyvrb" /><a + id="x1-22012r6"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> c</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> hppa-hpux</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> HP-UX</span> +<br class="fancyvrb" /><a + id="x1-22014r7"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> d</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> i386-freebsd</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Intel</span><span +class="ec-lmtt-8x-x-87"> x86</span><span +class="ec-lmtt-8x-x-87"> with</span><span +class="ec-lmtt-8x-x-87"> FreeBSD</span> +<br class="fancyvrb" /><a + id="x1-22016r8"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> e</span><span +class="ec-lmtt-8x-x-87"> [X]</span><span +class="ec-lmtt-8x-x-87"> i386-linux</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Intel</span><span +class="ec-lmtt-8x-x-87"> x86</span><span +class="ec-lmtt-8x-x-87"> with</span><span +class="ec-lmtt-8x-x-87"> GNU/Linux</span> +<br class="fancyvrb" /><a + id="x1-22018r9"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> f</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> i386-openbsd</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Intel</span><span +class="ec-lmtt-8x-x-87"> x86</span><span +class="ec-lmtt-8x-x-87"> with</span><span +class="ec-lmtt-8x-x-87"> OpenBSD</span> +<br class="fancyvrb" /><a + id="x1-22020r10"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> g</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> i386-solaris</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Intel</span><span +class="ec-lmtt-8x-x-87"> x86</span><span +class="ec-lmtt-8x-x-87"> with</span><span +class="ec-lmtt-8x-x-87"> Sun</span><span +class="ec-lmtt-8x-x-87"> Solaris</span> +<br class="fancyvrb" /><a + id="x1-22022r11"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> h</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> mips-irix</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> SGI</span><span +class="ec-lmtt-8x-x-87"> IRIX</span> +<br class="fancyvrb" /><a + id="x1-22024r12"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> i</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> powerpc-aix</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> PowerPC</span><span +class="ec-lmtt-8x-x-87"> with</span><span +class="ec-lmtt-8x-x-87"> AIX</span> +<br class="fancyvrb" /><a + id="x1-22026r13"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> j</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> powerpc-linux</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> PowerPC</span><span +class="ec-lmtt-8x-x-87"> with</span><span +class="ec-lmtt-8x-x-87"> GNU/Linux</span> +<br class="fancyvrb" /><a + id="x1-22028r14"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> k</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> sparc-linux</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Sparc</span><span +class="ec-lmtt-8x-x-87"> with</span><span +class="ec-lmtt-8x-x-87"> GNU/Linux</span> +<br class="fancyvrb" /><a + id="x1-22030r15"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> l</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> sparc-solaris</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Sparc</span><span +class="ec-lmtt-8x-x-87"> with</span><span +class="ec-lmtt-8x-x-87"> Solaris</span> +<br class="fancyvrb" /><a + id="x1-22032r16"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> m</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> universal-darwin</span><span +class="ec-lmtt-8x-x-87"> universal</span><span +class="ec-lmtt-8x-x-87"> binaries</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> MacOSX/Darwin</span> +<br class="fancyvrb" /><a + id="x1-22034r17"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> o</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> win32</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Windows</span> +<br class="fancyvrb" /><a + id="x1-22036r18"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> p</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> x86_64-linux</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> x86_64</span><span +class="ec-lmtt-8x-x-87"> with</span><span +class="ec-lmtt-8x-x-87"> GNU/Linux</span> +</div> +<br /> <table class="caption" +><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 3: </td><td +class="content">Binaries menu</td></tr></table><!--tex4ht:label?: x1-22037r3 --> + + +<!--l. 660--><p class="noindent" ></td></tr></table></div><hr class="endfigure"> +<!--l. 662--><p class="indent" > Figure <a +href="#x1-22037r3">3<!--tex4ht:ref: fig:bin-text --></a> displays the text mode binaries menu. By default, only the binaries for your current +platform will be installed. From this menu, you can select installation of binaries for other architectures +as well. This can be useful if you are sharing a <span class="TEX">T<span +class="E">E</span>X</span> tree across a network of heterogenous machines, or +for a dual-boot system. + <h5 class="subsubsectionHead"><span class="titlemark">3.2.2 </span> <a + id="x1-230003.2.2"></a>Selecting what is going to be installed</h5> +<!--l. 672--><p class="noindent" ><hr class="figure"><div class="figure" +><table class="figure"><tr class="figure"><td class="figure" +> + + +<a + id="x1-23027r4"></a> + + +<div class="fancyvrb" id="fancyvrb3"> +<a + id="x1-23002r1"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Select</span><span +class="ec-lmtt-8x-x-87"> a</span><span +class="ec-lmtt-8x-x-87"> scheme:</span> +<br class="fancyvrb" /><a + id="x1-23004r2"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> ===============================================================================</span> +<br class="fancyvrb" /><a + id="x1-23006r3"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-23008r4"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> a</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> TeX</span><span +class="ec-lmtt-8x-x-87"> Live</span><span +class="ec-lmtt-8x-x-87"> basic</span><span +class="ec-lmtt-8x-x-87"> scheme</span> +<br class="fancyvrb" /><a + id="x1-23010r5"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> b</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> TeX</span><span +class="ec-lmtt-8x-x-87"> Live</span><span +class="ec-lmtt-8x-x-87"> scheme</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> ConTeXt</span> +<br class="fancyvrb" /><a + id="x1-23012r6"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> c</span><span +class="ec-lmtt-8x-x-87"> [X]</span><span +class="ec-lmtt-8x-x-87"> TeX</span><span +class="ec-lmtt-8x-x-87"> Live</span><span +class="ec-lmtt-8x-x-87"> full</span><span +class="ec-lmtt-8x-x-87"> scheme</span> +<br class="fancyvrb" /><a + id="x1-23014r7"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> d</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> GUST</span><span +class="ec-lmtt-8x-x-87"> TeX</span><span +class="ec-lmtt-8x-x-87"> Live</span><span +class="ec-lmtt-8x-x-87"> scheme</span> +<br class="fancyvrb" /><a + id="x1-23016r8"></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</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> GUTenberg</span><span +class="ec-lmtt-8x-x-87"> TeX</span><span +class="ec-lmtt-8x-x-87"> Live</span><span +class="ec-lmtt-8x-x-87"> scheme</span> +<br class="fancyvrb" /><a + id="x1-23018r9"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> f</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> TeX</span><span +class="ec-lmtt-8x-x-87"> Live</span><span +class="ec-lmtt-8x-x-87"> medium</span><span +class="ec-lmtt-8x-x-87"> scheme</span> +<br class="fancyvrb" /><a + id="x1-23020r10"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> g</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> TeX</span><span +class="ec-lmtt-8x-x-87"> Live</span><span +class="ec-lmtt-8x-x-87"> minimal</span><span +class="ec-lmtt-8x-x-87"> scheme</span> +<br class="fancyvrb" /><a + id="x1-23022r11"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> h</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> TeX</span><span +class="ec-lmtt-8x-x-87"> Live</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> Omega</span><span +class="ec-lmtt-8x-x-87"> users</span> +<br class="fancyvrb" /><a + id="x1-23024r12"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> i</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> teTeX</span><span +class="ec-lmtt-8x-x-87"> scheme</span> +<br class="fancyvrb" /><a + id="x1-23026r13"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> j</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> XML</span><span +class="ec-lmtt-8x-x-87"> typesetting</span><span +class="ec-lmtt-8x-x-87"> scheme</span> +</div> +<br /> <table class="caption" +><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 4: </td><td +class="content">Scheme menu</td></tr></table><!--tex4ht:label?: x1-23027r4 --> + + +<!--l. 689--><p class="noindent" ></td></tr></table></div><hr class="endfigure"> +<!--l. 691--><p class="indent" > Figure <a +href="#x1-23027r4">4<!--tex4ht:ref: fig:scheme-text --></a> displays the <span class="TEX">T<span +class="E">E</span>X</span> Live scheme menu; from here, you choose a “scheme”, which is an overall +set of package collections. The default <span +class="ec-lmtt-10">full </span>scheme installs everything available, but you can also +choose the <span +class="ec-lmtt-10">basic </span>scheme for a small system, <span +class="ec-lmtt-10">minimal </span>for testing purposes, and <span +class="ec-lmtt-10">medium </span>or +<span +class="ec-lmtt-10">teTeX </span>to get something in between. There are also various specialized and country-specific +schemes. +<!--l. 699--><p class="indent" > <hr class="figure"><div class="figure" +><table class="figure"><tr class="figure"><td class="figure" +> + + +<a + id="x1-23028r5"></a> + + + +<!--l. 700--><p class="noindent" ><img +src="stdcoll.png" alt="pict" +> +<br /> <table class="caption" +><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 5: </td><td +class="content">Collections menu (Linux)</td></tr></table><!--tex4ht:label?: x1-23028r5 --> + + +<!--l. 702--><p class="indent" > </td></tr></table></div><hr class="endfigure"> +<!--l. 704--><p class="indent" > You can refine your scheme selection with the ‘standard collections’ and ‘language collections’ menus +(figure <a +href="#x1-23028r5">5<!--tex4ht:ref: fig:collections-gui --></a>, shown in GUI mode for a change). +<!--l. 708--><p class="indent" > Collections are one level more detailed than schemes — in essence, a scheme consists of several +collections, a collection consists of one or more packages, and a package (the lowest level grouping in +<span class="TEX">T<span +class="E">E</span>X</span> Live) contains the actual <span class="TEX">T<span +class="E">E</span>X</span> macro files, font files, and so on. +<!--l. 713--><p class="indent" > If you want more control than the collection menus provide, you can use the <span +class="ec-lmss-10">tlmgr </span>program +after installation (see section <a +href="#x1-410006">6<!--tex4ht:ref: sec:tlmgr --></a>); using that, you can control the installation at the package +level. + <h5 class="subsubsectionHead"><span class="titlemark">3.2.3 </span> <a + id="x1-240003.2.3"></a>Directories</h5> +<!--l. 721--><p class="noindent" >The default layout is described 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>. The default location of <span +class="ec-lmtt-10">TEXDIR </span>is different between +Windows (<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">%PROGRAMFILES%\texlive\2008</span></span></span>) and Unix (<span +class="ec-lmtt-10">/usr/local/texlive/2008</span>). +<!--l. 727--><p class="indent" > The main reason to change this default is if you lack write permission for the default location. You +don’t have to be root or adminstrator to install <span class="TEX">T<span +class="E">E</span>X</span> Live, but you do need write access to the target +directory. +<!--l. 731--><p class="indent" > A logical alternate choice is a directory under your home directory, especially if you will be the sole +user. Use ‘<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">~</span></span></span>’ to indicate this, as in ‘<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">~/texlive/2008</span></span></span>’. +<!--l. 735--><p class="indent" > We recommend including the year in the name, to enable keeping different releases of <span class="TEX">T<span +class="E">E</span>X</span> Live side +by side. (You may wish to make a version-independent name such as <span +class="ec-lmtt-10">/usr/local/texlive-cur </span>via a +symbolic link, which you can then update after testing the new release.) +<!--l. 740--><p class="indent" > Changing <span +class="ec-lmtt-10">TEXDIR </span>in the installer will also change <span +class="ec-lmtt-10">TEXMFLOCAL</span>, <span +class="ec-lmtt-10">TEXMFSYSVAR </span>and <span +class="ec-lmtt-10">TEXMFSYSCONFIG</span>. +<!--l. 744--><p class="indent" > <span +class="ec-lmtt-10">TEXMFHOME </span>is the recommended location for personal macro files or packages. The default value is +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">~/texmf</span></span></span>. In contrast to <span +class="ec-lmtt-10">TEXDIR</span>, here a <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">~</span></span></span> is preserved in the newly-written configuration files, since it +usefully refers to the home directory of each individual running <span class="TEX">T<span +class="E">E</span>X</span>. It expands to <span +class="ec-lmtt-10">$HOME </span>on Unix and +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">%USERPROFILE%</span></span></span> on Windows. +<!--l. 751--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.2.4 </span> <a + id="x1-250003.2.4"></a>Options</h5> +<!--l. 754--><p class="noindent" ><hr class="figure"><div class="figure" +><table class="figure"><tr class="figure"><td class="figure" +> + + +<a + id="x1-25017r6"></a> + + +<div class="fancyvrb" id="fancyvrb4"> +<a + id="x1-25002r1"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <P></span><span +class="ec-lmtt-8x-x-87"> use</span><span +class="ec-lmtt-8x-x-87"> letter</span><span +class="ec-lmtt-8x-x-87"> size</span><span +class="ec-lmtt-8x-x-87"> instead</span><span +class="ec-lmtt-8x-x-87"> of</span><span +class="ec-lmtt-8x-x-87"> A4</span><span +class="ec-lmtt-8x-x-87"> by</span><span +class="ec-lmtt-8x-x-87"> default:</span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span> +<br class="fancyvrb" /><a + id="x1-25004r2"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <F></span><span +class="ec-lmtt-8x-x-87"> create</span><span +class="ec-lmtt-8x-x-87"> all</span><span +class="ec-lmtt-8x-x-87"> format</span><span +class="ec-lmtt-8x-x-87"> files:</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> [X]</span> +<br class="fancyvrb" /><a + id="x1-25006r3"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <D></span><span +class="ec-lmtt-8x-x-87"> install</span><span +class="ec-lmtt-8x-x-87"> font/macro</span><span +class="ec-lmtt-8x-x-87"> doc</span><span +class="ec-lmtt-8x-x-87"> tree:</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> [X]</span> +<br class="fancyvrb" /><a + id="x1-25008r4"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <S></span><span +class="ec-lmtt-8x-x-87"> install</span><span +class="ec-lmtt-8x-x-87"> font/macro</span><span +class="ec-lmtt-8x-x-87"> source</span><span +class="ec-lmtt-8x-x-87"> tree:</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> [X]</span> +<br class="fancyvrb" /><a + id="x1-25010r5"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <L></span><span +class="ec-lmtt-8x-x-87"> create</span><span +class="ec-lmtt-8x-x-87"> symlinks</span><span +class="ec-lmtt-8x-x-87"> in</span><span +class="ec-lmtt-8x-x-87"> standard</span><span +class="ec-lmtt-8x-x-87"> directories:</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span> +<br class="fancyvrb" /><a + id="x1-25012r6"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> binaries</span><span +class="ec-lmtt-8x-x-87"> to:</span> +<br class="fancyvrb" /><a + id="x1-25014r7"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> manpages</span><span +class="ec-lmtt-8x-x-87"> to:</span> +<br class="fancyvrb" /><a + id="x1-25016r8"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> info</span><span +class="ec-lmtt-8x-x-87"> to:</span> +</div> +<br /> <table class="caption" +><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 6: </td><td +class="content">Options menu (Unix)</td></tr></table><!--tex4ht:label?: x1-25017r6 --> + + +<!--l. 766--><p class="noindent" ></td></tr></table></div><hr class="endfigure"> +<!--l. 768--><p class="indent" > Figure <a +href="#x1-25017r6">6<!--tex4ht:ref: fig:options-text --></a> displays the text mode options menu. Three of the options here need mentioning: + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">use letter size instead of A4 by default:</span> </dt><dd +class="description">The usual default paper size selection. Of course, + individual documents can specify a specific paper size, if desired. + </dd><dt class="description"> +<span +class="ec-lmbx-10">create all format files:</span> </dt><dd +class="description">Although unnecessary format files take time to generate and disk space + to store, it is still recommended to leave this option checked: if you don’t, then format files + will be generated in people’s private <span +class="ec-lmtt-10">TEXMFVAR </span>tree as they are needed. In that location, they + will not be updated automatically if (say) binaries or hyphenation patterns are updated in + the installation, and thus could end up with incompatible format files. + </dd><dt class="description"> +<span +class="ec-lmbx-10">create symlinks in standard directories</span> </dt><dd +class="description">(Unix only): This option bypasses the need to + change environment variables. Without this option, <span class="TEX">T<span +class="E">E</span>X</span> Live directories have to be added + to <span +class="ec-lmtt-10">PATH</span>, <span +class="ec-lmtt-10">MANPATH </span>and <span +class="ec-lmtt-10">INFOPATH</span>. You will need write permissions to the target directories. It + is not advisable to overwrite a <span class="TEX">T<span +class="E">E</span>X</span> system that came with your system with this option. It + is intended primarily for creating the links in standard directories that are known to users, + such as <span +class="ec-lmtt-10">/usr/local/bin</span>, which don’t already contain any <span class="TEX">T<span +class="E">E</span>X</span> files.</dd></dl> +<!--l. 796--><p class="indent" > Now when all these settings are to your liking, you can type ‘I’ to start the installation process. When +it is done, skip to section <a +href="#x1-290003.4">3.4<!--tex4ht:ref: sec:postinstall --></a> to read what else needs to be done, if anything. + <h5 class="subsubsectionHead"><span class="titlemark">3.2.5 </span> <a + id="x1-260003.2.5"></a>Set up for running from DVD (text mode only)</h5> +<!--l. 804--><p class="noindent" >Type ‘<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">V</span></span></span>’ to select this option. This changes the main menu into something like figure <a +href="#x1-26057r7">7<!--tex4ht:ref: fig:main-fromdvd --></a>. +<hr class="figure"><div class="figure" +><table class="figure"><tr class="figure"><td class="figure" +> + + +<a + id="x1-26057r7"></a> + + +<div class="fancyvrb" id="fancyvrb5"> +<a + id="x1-26002r1"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> ======================></span><span +class="ec-lmtt-8x-x-87"> TeX</span><span +class="ec-lmtt-8x-x-87"> Live</span><span +class="ec-lmtt-8x-x-87"> installation</span><span +class="ec-lmtt-8x-x-87"> procedure</span><span +class="ec-lmtt-8x-x-87"> <=====================</span> +<br class="fancyvrb" /><a + id="x1-26004r2"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-26006r3"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> =======></span><span +class="ec-lmtt-8x-x-87"> Note:</span><span +class="ec-lmtt-8x-x-87"> Letters/digits</span><span +class="ec-lmtt-8x-x-87"> in</span><span +class="ec-lmtt-8x-x-87"> <angle</span><span +class="ec-lmtt-8x-x-87"> brackets></span><span +class="ec-lmtt-8x-x-87"> indicate</span><span +class="ec-lmtt-8x-x-87"> menu</span><span +class="ec-lmtt-8x-x-87"> items</span><span +class="ec-lmtt-8x-x-87"> <=======</span> +<br class="fancyvrb" /><a + id="x1-26008r4"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> =======></span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> commands</span><span +class="ec-lmtt-8x-x-87"> or</span><span +class="ec-lmtt-8x-x-87"> configurable</span><span +class="ec-lmtt-8x-x-87"> options</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <=======</span> +<br class="fancyvrb" /><a + id="x1-26010r5"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-26012r6"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <D></span><span +class="ec-lmtt-8x-x-87"> directories:</span> +<br class="fancyvrb" /><a + id="x1-26014r7"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXDIRW</span><span +class="ec-lmtt-8x-x-87"> (Writable</span><span +class="ec-lmtt-8x-x-87"> root):</span> +<br class="fancyvrb" /><a + id="x1-26016r8"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> !!</span><span +class="ec-lmtt-8x-x-87"> default</span><span +class="ec-lmtt-8x-x-87"> location:</span><span +class="ec-lmtt-8x-x-87"> /usr/local/texlive/2008</span> +<br class="fancyvrb" /><a + id="x1-26018r9"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> !!</span><span +class="ec-lmtt-8x-x-87"> is</span><span +class="ec-lmtt-8x-x-87"> not</span><span +class="ec-lmtt-8x-x-87"> writable,</span><span +class="ec-lmtt-8x-x-87"> please</span><span +class="ec-lmtt-8x-x-87"> select</span><span +class="ec-lmtt-8x-x-87"> a</span><span +class="ec-lmtt-8x-x-87"> different</span><span +class="ec-lmtt-8x-x-87"> one!</span> +<br class="fancyvrb" /><a + id="x1-26020r10"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXMFLOCAL</span><span +class="ec-lmtt-8x-x-87"> (directory</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> site-wide</span><span +class="ec-lmtt-8x-x-87"> local</span><span +class="ec-lmtt-8x-x-87"> files):</span> +<br class="fancyvrb" /><a + id="x1-26022r11"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> /usr/local/texlive/texmf-local</span> +<br class="fancyvrb" /><a + id="x1-26024r12"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXMFSYSVAR</span><span +class="ec-lmtt-8x-x-87"> (directory</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> variable</span><span +class="ec-lmtt-8x-x-87"> and</span><span +class="ec-lmtt-8x-x-87"> automatically</span><span +class="ec-lmtt-8x-x-87"> generated</span><span +class="ec-lmtt-8x-x-87"> data):</span> +<br class="fancyvrb" /><a + id="x1-26026r13"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> /usr/local/texlive/2008/texmf-var</span> +<br class="fancyvrb" /><a + id="x1-26028r14"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXMFSYSCONFIG</span><span +class="ec-lmtt-8x-x-87"> (directory</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> local</span><span +class="ec-lmtt-8x-x-87"> config):</span> +<br class="fancyvrb" /><a + id="x1-26030r15"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> /usr/local/texlive/2008/texmf-config</span> +<br class="fancyvrb" /><a + id="x1-26032r16"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXMFHOME</span><span +class="ec-lmtt-8x-x-87"> (directory</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> user-specific</span><span +class="ec-lmtt-8x-x-87"> files):</span> +<br class="fancyvrb" /><a + id="x1-26034r17"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> ~/texmf</span> +<br class="fancyvrb" /><a + id="x1-26036r18"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-26038r19"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <O></span><span +class="ec-lmtt-8x-x-87"> options:</span> +<br class="fancyvrb" /><a + id="x1-26040r20"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> [</span><span +class="ec-lmtt-8x-x-87"> ]</span><span +class="ec-lmtt-8x-x-87"> use</span><span +class="ec-lmtt-8x-x-87"> letter</span><span +class="ec-lmtt-8x-x-87"> size</span><span +class="ec-lmtt-8x-x-87"> instead</span><span +class="ec-lmtt-8x-x-87"> of</span><span +class="ec-lmtt-8x-x-87"> A4</span><span +class="ec-lmtt-8x-x-87"> by</span><span +class="ec-lmtt-8x-x-87"> default</span> +<br class="fancyvrb" /><a + id="x1-26042r21"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> [X]</span><span +class="ec-lmtt-8x-x-87"> create</span><span +class="ec-lmtt-8x-x-87"> all</span><span +class="ec-lmtt-8x-x-87"> format</span><span +class="ec-lmtt-8x-x-87"> files</span> +<br class="fancyvrb" /><a + id="x1-26044r22"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-26046r23"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <V></span><span +class="ec-lmtt-8x-x-87"> set</span><span +class="ec-lmtt-8x-x-87"> up</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> installing</span><span +class="ec-lmtt-8x-x-87"> to</span><span +class="ec-lmtt-8x-x-87"> hard</span><span +class="ec-lmtt-8x-x-87"> disk</span> +<br class="fancyvrb" /><a + id="x1-26048r24"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span> +<br class="fancyvrb" /><a + id="x1-26050r25"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> Other</span><span +class="ec-lmtt-8x-x-87"> actions:</span> +<br class="fancyvrb" /><a + id="x1-26052r26"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <I></span><span +class="ec-lmtt-8x-x-87"> start</span><span +class="ec-lmtt-8x-x-87"> installation</span><span +class="ec-lmtt-8x-x-87"> for</span><span +class="ec-lmtt-8x-x-87"> running</span><span +class="ec-lmtt-8x-x-87"> from</span><span +class="ec-lmtt-8x-x-87"> DVD</span> +<br class="fancyvrb" /><a + id="x1-26054r27"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <H></span><span +class="ec-lmtt-8x-x-87"> help</span> +<br class="fancyvrb" /><a + id="x1-26056r28"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> <Q></span><span +class="ec-lmtt-8x-x-87"> quit</span> +</div> +<br /> <table class="caption" +><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 7: </td><td +class="content">The main menu with <span +class="ec-lmtt-10">from DVD </span>set</td></tr></table><!--tex4ht:label?: x1-26057r7 --> + + +<!--l. 839--><p class="indent" > </td></tr></table></div><hr class="endfigure"> +<!--l. 841--><p class="indent" > Note the changes: all options about what to install have disappeared, and the directories section now +talks about <span +class="ec-lmtt-10">TEXDIRW </span>or writable root. The symlinks option has also disappeared. +<!--l. 846--><p class="indent" > The installer will still create various directories and configuration files, but won’t copy <span +class="ec-lmtt-10">texmf</span>, +<span +class="ec-lmtt-10">texmf-dist </span>or <span +class="ec-lmtt-10">texmf-doc </span>to hard disk. +<!--l. 850--><p class="indent" > Post-install configuration for Unix will be slightly more complicated, because now the directory +layout deviates from the default; see section <a +href="#x1-290003.4">3.4<!--tex4ht:ref: sec:postinstall --></a>. +<!--l. 854--><p class="indent" > Due to time constraints, this option didn’t make it into the GUI installer, but it is available both for +Unix and for Windows. Windows users have to start the installer from a command prompt, see +section <a +href="#x1-270003.3">3.3<!--tex4ht:ref: sec:cmdline --></a>. +<!--l. 859--><p class="indent" > Section <a +href="#x1-400005">5<!--tex4ht:ref: sec:portable-unix --></a> describes a more strictly portable way to run <span class="TEX">T<span +class="E">E</span>X</span> Live, which doesn’t make or require +changes in the system’s configuration, but doesn’t allow any configuration either. + <h4 class="subsectionHead"><span class="titlemark">3.3 </span> <a + id="x1-270003.3"></a>Command-line install options</h4> +<!--l. 866--><p class="noindent" >Type <div class="alltt"> +<!--l. 867--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">install-tl</span><span +class="ec-lmtk-10"> -help</span> +</div> +</div> for a listing of command-line options. Either <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">-</span></span></span> or <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">--</span></span></span> can be used to introduce option names. These are +the more interesting ones: +<!--l. 874--><p class="noindent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmtt-10">-gui</span> </dt><dd +class="list"> + <!--l. 875--><p class="noindent" >If possible, use the GUI installer. This requires the Perl/Tk module + (<a +href="http://tug.org/texlive/distro.html#perltk" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/distro.html#perltk</span></a>); if Perl/Tk is not available, installation + continues in text mode. + </dd><dt class="list"> + <span +class="ec-lmtt-10">-no-gui</span> </dt><dd +class="list"> + <!--l. 878--><p class="noindent" >Force using the text mode installer, even under Windows; you’ll need this if you want a ‘from + DVD’ installation, since that is not available in GUI mode. + </dd><dt class="list"> + <span +class="ec-lmtt-10">-lang </span><span +class="ec-lmro-10">LL</span> </dt><dd +class="list"> + <!--l. 881--><p class="noindent" >Specify the installer interface language as its standard two-letter code <span +class="ec-lmro-10">LL</span>. Currently + supported languages: English (<span +class="ec-lmtt-10">en</span>, default), German (<span +class="ec-lmtt-10">de</span>), French (<span +class="ec-lmtt-10">fr</span>), Dutch (<span +class="ec-lmtt-10">nl</span>), Polish + (<span +class="ec-lmtt-10">pl</span>), Slovenian (<span +class="ec-lmtt-10">sl</span>) and Vietnamese (<span +class="ec-lmtt-10">vi</span>). The installer tries to determine the right language + itself but if it fails, or if the right language is not available, then it uses English as a fallback. + </dd><dt class="list"> + <span +class="ec-lmtt-10">-profile </span><span +class="ec-lmro-10">profile</span> </dt><dd +class="list"> + <!--l. 889--><p class="noindent" >The installer always writes a file <span +class="ec-lmtt-10">texlive.profile </span>to the <span +class="ec-lmtt-10">2008/tlpkg</span>- or <span +class="ec-lmtt-10">tlpkg </span>subdirectory of + your installation. This option tells the installer to re-use such a profile file. Here’s an + excerpt: + <div class="fancyvrb" id="fancyvrb6"> + + +<a + id="x1-27002r1"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> #</span><span +class="ec-lmtt-8"> texlive.profile</span><span +class="ec-lmtt-8"> written</span><span +class="ec-lmtt-8"> on</span><span +class="ec-lmtt-8"> Wed</span><span +class="ec-lmtt-8"> Jul</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> 9</span><span +class="ec-lmtt-8"> 16:13:44</span><span +class="ec-lmtt-8"> 2008</span><span +class="ec-lmtt-8"> UTC</span> +<br class="fancyvrb" /><a + id="x1-27004r2"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> #</span><span +class="ec-lmtt-8"> It</span><span +class="ec-lmtt-8"> will</span><span +class="ec-lmtt-8"> NOT</span><span +class="ec-lmtt-8"> be</span><span +class="ec-lmtt-8"> updated</span><span +class="ec-lmtt-8"> and</span><span +class="ec-lmtt-8"> reflects</span><span +class="ec-lmtt-8"> only</span><span +class="ec-lmtt-8"> the</span> +<br class="fancyvrb" /><a + id="x1-27006r3"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> #</span><span +class="ec-lmtt-8"> installation</span><span +class="ec-lmtt-8"> profile</span><span +class="ec-lmtt-8"> at</span><span +class="ec-lmtt-8"> installation</span><span +class="ec-lmtt-8"> time.</span> +<br class="fancyvrb" /><a + id="x1-27008r4"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> selected_scheme</span><span +class="ec-lmtt-8"> scheme-basic</span> +<br class="fancyvrb" /><a + id="x1-27010r5"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> TEXDIR</span><span +class="ec-lmtt-8"> /usr/local/texlive/2008</span> +<br class="fancyvrb" /><a + id="x1-27012r6"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> TEXDIRW</span><span +class="ec-lmtt-8"> /usr/local/texlive/2008</span> +<br class="fancyvrb" /><a + id="x1-27014r7"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ...</span> +<br class="fancyvrb" /><a + id="x1-27016r8"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> TEXMFSYSVAR</span><span +class="ec-lmtt-8"> /usr/local/texlive/2008/texmf-var</span> +<br class="fancyvrb" /><a + id="x1-27018r9"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> collection-basic</span><span +class="ec-lmtt-8"> 1</span> +<br class="fancyvrb" /><a + id="x1-27020r10"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ...</span> +<br class="fancyvrb" /><a + id="x1-27022r11"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> option_symlinks</span><span +class="ec-lmtt-8"> 0</span> +</div> + <!--l. 906--><p class="noindent" >Thus, using this option you can install in batch mode on subsequent systems, reproducing the + choices you made for the original installation. + </dd><dt class="list"> + <span +class="ec-lmtt-10">-location </span><span +class="ec-lmro-10">url/path</span> </dt><dd +class="list"> + <!--l. 909--><p class="noindent" >Specify a non-default source for packages; see below.</dd></dl> +<!--l. 913--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.3.1 </span> <a + id="x1-280003.3.1"></a>The <span +class="ec-lmtt-10">location </span>parameter</h5> +<!--l. 916--><p class="noindent" >The location value can be a url starting with <span +class="ec-lmtt-10">ftp:</span>, <span +class="ec-lmtt-10">http:</span>, or <span +class="ec-lmtt-10">file:/ </span>url, or a plain path. If the given +argument is on a local drive (either a path or a <span +class="ec-lmtt-10">file:/ </span>url), the installation type (compressed or live) is +automatically determined: if an <span +class="ec-lmtt-10">archive </span>subdirectory with <span +class="ec-lmtt-10">.tar.lzma </span>files is found then it will be used, +even if uncompressed files are available as well. +<!--l. 924--><p class="indent" > When giving an <span +class="ec-lmtt-10">http: </span>or <span +class="ec-lmtt-10">ftp: </span>location, trailing ‘<span +class="ec-lmtt-10">/</span>’ characters and/or a trailing ‘<span +class="ec-lmtt-10">/tlpkg</span>’ component +are ignored. For example, you could choose a particular CTAN mirror with something like: +<a +href="http://ctan.example.org/tex-archive/texlive/tlnet/2008" class="url" ><span +class="ec-lmtt-10">http://ctan.example.org/tex-archive/texlive/tlnet/2008</span></a>, substituting of course a proper +hostname and its particular top-level CTAN path (the list of CTAN mirrors is maintained at +<a +href="http://ctan.org/mirrors" class="url" ><span +class="ec-lmtt-10">http://ctan.org/mirrors</span></a>) for <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">ctan.example.org/tex-archive</span></span></span>. The default is to pick a mirror +automatically, using <a +href="http://mirror.ctan.org" class="url" ><span +class="ec-lmtt-10">http://mirror.ctan.org</span></a>; in any case, the chosen host is used for the entire +download. +<!--l. 937--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.4 </span> <a + id="x1-290003.4"></a>Post-install actions</h4> +<!--l. 940--><p class="noindent" >Some post-install may be required. +<!--l. 942--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.1 </span> <a + id="x1-300003.4.1"></a>Windows</h5> +<!--l. 944--><p class="noindent" >But on Windows, the installer takes care of everything. +<!--l. 946--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.2 </span> <a + id="x1-310003.4.2"></a>If symlinks were created</h5> +<!--l. 948--><p class="noindent" >If you elected to create symlinks in standard directories (mentioned in section <a +href="#x1-250003.2.4">3.2.4<!--tex4ht:ref: sec:options --></a>), then there is no +need to edit environment variables. + + +<!--l. 952--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.3 </span> <a + id="x1-320003.4.3"></a>Environment variables for Unix</h5> +<!--l. 955--><p class="noindent" >The directory of the binaries for your platform must be added to the search path. Each supported +platform has its own subdirectory under <span +class="ec-lmtt-10">TEXDIR/bin</span>. See figure <a +href="#x1-22037r3">3<!--tex4ht:ref: fig:bin-text --></a> for the list of subdirectories and +corresponding platforms. +<!--l. 960--><p class="indent" > You can also add the documentation man and Info directories to their respective search paths, if you +want the system tools to find them. +<!--l. 963--><p class="indent" > For Bourne-compatible shells such as <span +class="ec-lmss-10">bash</span>, and using Intel x86 GNU/Linux and a default directory +setup as an example, the file to edit might be <span +class="ec-lmtt-10">$HOME/.profile </span>(or another file sourced by <span +class="ec-lmtt-10">.profile</span>, and +the lines to add would look like this: +<!--l. 968--><p class="indent" > + <div class="fancyvrb" id="fancyvrb7"> +<a + id="x1-32002r1"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> PATH=/usr/local/texlive/2008/bin/i386-linux:$PATH;</span><span +class="ec-lmtt-9"> export</span><span +class="ec-lmtt-9"> PATH</span> +<br class="fancyvrb" /><a + id="x1-32004r2"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> MANPATH=/usr/local/texlive/2008/texmf/doc/man:$MANPATH;</span><span +class="ec-lmtt-9"> export</span><span +class="ec-lmtt-9"> MANPATH</span> +<br class="fancyvrb" /><a + id="x1-32006r3"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> INFOPATH=/usr/local/texlive/2008/texmf/doc/info:$INFOPATH;</span><span +class="ec-lmtt-9"> export</span><span +class="ec-lmtt-9"> INFOPATH</span> + </div> +<!--l. 974--><p class="indent" > For csh or tcsh, the file to edit is typically <span +class="ec-lmtt-10">$HOME/.cshrc</span>, and the lines to add might look +like: +<!--l. 977--><p class="indent" > + <div class="fancyvrb" id="fancyvrb8"> +<a + id="x1-32008r1"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> setenv</span><span +class="ec-lmtt-9"> PATH</span><span +class="ec-lmtt-9"> /usr/local/texlive/2008/bin/i386-linux:$PATH</span> +<br class="fancyvrb" /><a + id="x1-32010r2"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> setenv</span><span +class="ec-lmtt-9"> MANPATH</span><span +class="ec-lmtt-9"> /usr/local/texlive/2008/texmf/doc/man:$MANPATH</span> +<br class="fancyvrb" /><a + id="x1-32012r3"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> setenv</span><span +class="ec-lmtt-9"> INFOPATH</span><span +class="ec-lmtt-9"> /usr/local/texlive/2008/texmf/doc/info:$INFOPATH</span> + </div> +<!--l. 983--><p class="indent" > Of course, you may well already have settings somewhere in your “dot” files, and so then the <span class="TEX">T<span +class="E">E</span>X</span> +Live directories should simply be merged in as appropriate. +<!--l. 987--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.4 </span> <a + id="x1-330003.4.4"></a>Environment variables: global configuration</h5> +<!--l. 990--><p class="noindent" >If you want to make these changes globally, or for a user newly added to the system, then you are on +your own; there is just too much variation between systems in how and where these things are +configured. +<!--l. 994--><p class="indent" > Our two hints are: 1) you may want to check for a file <span +class="ec-lmtt-10">/etc/manpath.config </span>and, if present, add +lines such as +<!--l. 997--><p class="indent" > + <div class="fancyvrb" id="fancyvrb9"> +<a + id="x1-33002r1"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> MANPATH_MAP</span><span +class="ec-lmtt-9"> /usr/local/texlive/2008/bin/i386-linux</span><span +class="ec-lmtt-9"> \</span> +<br class="fancyvrb" /><a + id="x1-33004r2"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> /usr/local/texlive/2008/texmf/doc/man</span> + </div> +<!--l. 1002--><p class="indent" > And 2) check for a file <span +class="ec-lmtt-10">/etc/environment </span>which may define the search path and other default +environment variables. +<!--l. 1006--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.5 </span> <a + id="x1-340003.4.5"></a>When running from DVD</h5> + + +<!--l. 1008--><p class="noindent" >Normally, a <span class="TEX">T<span +class="E">E</span>X</span> Live program consults a file <span +class="ec-lmtt-10">texmf.cnf </span>for the location of the various +trees. It looks for this file in a series of locations relative to its own location. However, this +scheme breaks down when a program is run from DVD: the DVD is read-only. Some of the +paths to be recorded in <span +class="ec-lmtt-10">texmf.cnf </span>are only known at installation time, so this file cannot +be on the DVD and must be placed somewhere else. This makes it necessary to define an +environment <span +class="ec-lmtt-10">TEXMFCNF </span>variable which tells <span class="TEX">T<span +class="E">E</span>X</span> Live programs in what directory to find this +<span +class="ec-lmtt-10">texmf.cnf</span>. It is also still necessary to modify the <span +class="ec-lmtt-10">PATH </span>environment variable, as described +before. +<!--l. 1019--><p class="indent" > At the end of the installation, the installer should have printed a message giving the value to which +<span +class="ec-lmtt-10">TEXMFCNF </span>should be set. In case you missed it: this value is <span +class="ec-lmtt-10">$TEXMFSYSVAR/web2c</span>. For the default, +<span +class="ec-lmtt-10">/usr/local/texlive/2008/texmf-var/web2c</span>, you need the lines + <div class="fancyvrb" id="fancyvrb10"> +<a + id="x1-34002r1"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> TEXMFCNF=/usr/local/texlive/2008/texmf-var/web2c;</span><span +class="ec-lmtt-9"> export</span><span +class="ec-lmtt-9"> TEXMFCNF</span> + </div> +<!--l. 1027--><p class="noindent" >or, for [t]csh: + <div class="fancyvrb" id="fancyvrb11"> +<a + id="x1-34004r1"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> setenv</span><span +class="ec-lmtt-9"> TEXMFCNF</span><span +class="ec-lmtt-9"> /usr/local/texlive/2008/texmf-var/web2c</span> + </div> +<!--l. 1033--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.6 </span> <a + id="x1-350003.4.6"></a>Con<span class="TEX">T<span +class="E">E</span>X</span>t Mark IV</h5> +<!--l. 1035--><p class="noindent" >The ‘old’ Con<span class="TEX">T<span +class="E">E</span>X</span>t should run out of the box. The new ‘Mark IV’ Con<span class="TEX">T<span +class="E">E</span>X</span>t will require manual setup; +see <a +href="http://wiki.contextgarden.net/Running_Mark_IV" class="url" ><span +class="ec-lmtt-10">http://wiki.contextgarden.net/Running_Mark_IV</span></a>. +<!--l. 1040--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.7 </span> <a + id="x1-360003.4.7"></a>Integrating local and personal macros</h5> +<!--l. 1043--><p class="noindent" >This is already mentioned implicitly in section <a +href="#x1-100002.3">2.3<!--tex4ht:ref: sec:texmftrees --></a>: <span +class="ec-lmtt-10">TEXMFLOCAL </span>(by default, <span +class="ec-lmtt-10">/usr/local/texlive/texmf-local</span> +or <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">C:\Program</span><span +class="ec-lmtt-10"> Files\texlive\texmf-local</span></span></span>) +<!--l. 1048--><p class="indent" > is intended for system-wide local fonts and macros; and <span +class="ec-lmtt-10">TEXMFHOME </span>(by default, <span +class="ec-lmtt-10">$HOME/texmf </span>or +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">%USERPROFILE%\texmf</span></span></span>), is for personal fonts and macros. These directories are intended to stick +around from release to release, and have their content seen automatically by a new <span class="TEX">T<span +class="E">E</span>X</span> Live +release. Therefore, it is best to refrain from changing the definition of <span +class="ec-lmtt-10">TEXMFLOCAL </span>to be too +far away from the main <span class="TEX">T<span +class="E">E</span>X</span> Live directory, or you will need to manually change future +releases. +<!--l. 1057--><p class="indent" > For both trees, files should be placed in their proper subdirectories; see <a +href="http://tug.org/tds" class="url" ><span +class="ec-lmtt-10">http://tug.org/tds</span></a> or +consult <span +class="ec-lmtt-10">texmf/web2c/texmf.cnf</span>. For instance, a <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> class file or package should be placed in +<span +class="ec-lmtt-10">TEXMFLOCAL/tex/latex </span>or <span +class="ec-lmtt-10">TEXMFHOME/tex/latex</span>, or a subdirectory thereof. +<!--l. 1063--><p class="indent" > <span +class="ec-lmtt-10">TEXMFLOCAL </span>requires an up-to-date filename database, or files will not be found. You can update it +with the command <span +class="ec-lmss-10">mktexlsr </span>or use the ‘Reinit file database’ button on the configuration tab of <span +class="ec-lmss-10">tlmgr </span>in +GUI mode. +<!--l. 1068--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.8 </span> <a + id="x1-370003.4.8"></a>Integrating third-party fonts</h5> +<!--l. 1070--><p class="noindent" >This is unfortunately a very complicated and messy topic. Forget about it unless you really know your +way around blindfolded in a <span class="TEX">T<span +class="E">E</span>X</span> installation. Don’t forget to check first what you get for free: see +section <a +href="#x1-130002.6">2.6<!--tex4ht:ref: sec:tl-fonts --></a>. + + +<!--l. 1075--><p class="indent" > A possible alternative is to use Xe<span class="TEX">T<span +class="E">E</span>X</span> (see section <a +href="#x1-110002.4">2.4<!--tex4ht:ref: sec:tex-extensions --></a>), which lets you use operating system fonts +without any installation in <span class="TEX">T<span +class="E">E</span>X</span>. +<!--l. 1080--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.5 </span> <a + id="x1-380003.5"></a>Testing the installation</h4> +<!--l. 1083--><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. 1086--><p class="indent" > This section gives some basic procedures for testing that the new system is functional. We give Unix +commands here; 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. 1091--><p class="indent" > + <ol class="enumerate1" > + <li + class="enumerate" id="x1-38002x1">Make sure that you can run the <span +class="ec-lmss-10">tex </span>program in the first place: + <div class="alltt"> + <!--l. 1096--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tex</span><span +class="ec-lmtk-10"> --version</span> + <br /><span +class="ec-lmtt-10">TeX</span><span +class="ec-lmtt-10"> 3.1415926</span><span +class="ec-lmtt-10"> (Web2C</span><span +class="ec-lmtt-10"> 7.5.7)</span> + <br /><span +class="ec-lmtt-10">kpathsea</span><span +class="ec-lmtt-10"> version</span><span +class="ec-lmtt-10"> 3.5.7</span> + <br /><span +class="ec-lmtt-10">...</span> +</div> + </div> If this comes back with ‘command not found’ instead of version and copyright information, or with + an older version, most likely you don’t have the correct <span +class="ec-lmtt-10">bin </span>subdirectory in your <span +class="ec-lmtt-10">PATH</span>. See the + environment-setting information on p. <a +href="#x1-320003.4.3">37<!--tex4ht:ref: sec:env --></a>. + </li> + <li + class="enumerate" id="x1-38004x2">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. 1108--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">latex</span><span +class="ec-lmtk-10"> sample2e.tex</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.1415926...</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"> 7484</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, most likely you have interference from old + environment variables or configuration files; we recommend unsetting all <span class="TEX">T<span +class="E">E</span>X</span>-related environment + variables for a start. (For a deep analysis, you can 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-650008.2.4">67<!--tex4ht:ref: sec:debugging --></a>.) + </li> + <li + class="enumerate" id="x1-38006x3">Preview the result online: <div class="alltt"> + <!--l. 1123--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">xdvi</span><span +class="ec-lmtk-10"> sample2e.dvi</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-38008x4">Create a PostScript file for printing or display: <div class="alltt"> + <!--l. 1134--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">dvips</span><span +class="ec-lmtk-10"> sample2e.dvi</span><span +class="ec-lmtk-10"> -o</span><span +class="ec-lmtk-10"> sample2e.ps</span> +</div> + </div> + </li> + <li + class="enumerate" id="x1-38010x5">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. 1140--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">pdflatex</span><span +class="ec-lmtk-10"> sample2e.tex</span> +</div> + </div> + </li> + <li + class="enumerate" id="x1-38012x6">Preview the PDF file: <div class="alltt"> + <!--l. 1145--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">gv</span><span +class="ec-lmtk-10"> sample2e.pdf</span> + <br />or: + <br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">xpdf</span><span +class="ec-lmtk-10"> sample2e.pdf</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. (There are plenty of other PDF viewers, too.) + </li> + <li + class="enumerate" id="x1-38014x7">Standard test files you may find useful in addition to <span +class="ec-lmtt-10">sample2e.tex</span>: + <!--l. 1159--><p class="noindent" > + <dl class="list2"><dt class="list"> + <span +class="ec-lmtt-10">small2e.tex</span> </dt><dd +class="list"> + <!--l. 1160--><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. 1162--><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. 1163--><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. 1164--><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. 1165--><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> + </li></ol> +<!--l. 1172--><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 writing <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. 1177--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">4 </span> <a + id="x1-390004"></a>Network installations</h3> +<!--l. 1180--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> Live has been designed to be shared between different users, and even different systems on a +network. With a standard directory layout, no hard paths are configured: the locations for files needed by +<span class="TEX">T<span +class="E">E</span>X</span> Live programs are defined relative to the places of those programs. You can see this +at work in the configuration file <span +class="ec-lmtt-10">$TEXMFMAIN/web2c/texmf.cnf</span>, which contains lines such +as + <div class="fancyvrb" id="fancyvrb12"> +<a + id="x1-39002r1"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> TEXMFMAIN</span><span +class="ec-lmtt-9"> =</span><span +class="ec-lmtt-9"> $SELFAUTOPARENT/texmf</span> +<br class="fancyvrb" /><a + id="x1-39004r2"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ...</span> +<br class="fancyvrb" /><a + id="x1-39006r3"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> TEXMFLOCAL</span><span +class="ec-lmtt-9"> =</span><span +class="ec-lmtt-9"> $SELFAUTOPARENT/../texmf-local</span> + </div> +<!--l. 1191--><p class="noindent" >This means that other systems or other users merely need to add the directory for <span class="TEX">T<span +class="E">E</span>X</span> Live binaries for +their platform to their search path. +<!--l. 1194--><p class="indent" > By the same token, you can also install <span class="TEX">T<span +class="E">E</span>X</span> Live locally and then move the entire hierarchy +afterwards to a network location. +<!--l. 1197--><p class="indent" > Of course, Windows users have different expectations. The directory +<span +class="ec-lmtt-10">texmf-doc/source/texlive/texlive-common/w32client </span>contains a sample script <span +class="ec-lmtt-10">install-w32client</span> +which creates settings and menu shortcuts for using an existing <span class="TEX">T<span +class="E">E</span>X</span> Live installation on a LAN. It is to +be invoked through a batch file <span +class="ec-lmtt-10">install-w32client.bat </span>in the same directory. +<!--l. 1204--><p class="indent" > You can read more about <span class="TEX">T<span +class="E">E</span>X</span> Live configuration and path searching in section <a +href="#x1-530008.1">8.1<!--tex4ht:ref: sec:kpathsea --></a>. +<!--l. 1207--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">5 </span> <a + id="x1-400005"></a>Maximally portable <span class="TEX">T<span +class="E">E</span>X</span> Live on DVD and USB</h3> +<!--l. 1210--><p class="noindent" >The ‘running from DVD’ option described in section <a +href="#x1-260003.2.5">3.2.5<!--tex4ht:ref: sec:fromdvd --></a> is fine for your own system, but if you are a +guest on somebody else’s system then you would probably like something with minimal side +effects. +<!--l. 1215--><p class="indent" > In the root of the <span class="TEX">T<span +class="E">E</span>X</span> Live DVD, or the <span +class="ec-lmtt-10">texlive </span>subdirectory of the <span class="TEX">T<span +class="E">E</span>X</span> Collection DVD, are a +<span +class="ec-lmtt-10">tl-portable </span>script (Unix) and a <span +class="ec-lmtt-10">tl-portable.bat </span>batchfile (Windows) which start up a secondary +shell/command prompt with environment settings suitable for directly accessing the <span class="TEX">T<span +class="E">E</span>X</span> Live on the +DVD. + + +<!--l. 1221--><p class="indent" > When it runs for the first time, some files will be generated in a directory <span +class="ec-lmtt-10"> /.tlportable2008</span>, which +will take a little time. On subsequent runs, though, it will start almost instantaneously. +<!--l. 1225--><p class="indent" > The rest of the system will be unaware of <span class="TEX">T<span +class="E">E</span>X</span> Live. If you want your editor to be aware of this <span class="TEX">T<span +class="E">E</span>X</span> +Live, then you can start it from a second, parallel, such <span +class="ec-lmtt-10">tl-portable </span>session. +<!--l. 1229--><p class="indent" > You can also use <span +class="ec-lmtt-10">tl-portable </span>to run <span class="TEX">T<span +class="E">E</span>X</span> Live on a USB stick. In this case, copy all the top-level +files and the contents of the <span +class="ec-lmtt-10">bin</span>, <span +class="ec-lmtt-10">texmf</span>, <span +class="ec-lmtt-10">texmf-dist</span>, and <span +class="ec-lmtt-10">tlpkg </span>directories (at least) to the stick. This +may take quite a while! If you are copying to a FAT32-formatted USB stick, make sure to +dereference symbolic links (<span +class="ec-lmtt-10">cp -L</span>). A <span +class="ec-lmtt-10">texmf-local </span>directory on the stick will also be found and +used. +<!--l. 1238--><p class="indent" > Then run <span +class="ec-lmtt-10">tl-portable </span>from the root of the stick, as above. In this case, the script will notice that +the stick is writable and use it for generated files. You could burn the resulting contents of the stick back +to DVD if that is more convenient to (for example) give to others. +<!--l. 1245--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">6 </span> <a + id="x1-410006"></a><span +class="ec-lmss-10">tlmgr</span>: Managing your installation</h3> +<!--l. 1248--><p class="noindent" ><hr class="figure"><div class="figure" +><table class="figure"><tr class="figure"><td class="figure" +> + + +<a + id="x1-41001r8"></a> + + + +<!--l. 1249--><p class="noindent" ><img +src="tlmgr-gui.png" alt="pict" +> +<br /> <table class="caption" +><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 8: </td><td +class="content"><span +class="ec-lmss-10">tlmgr </span>in GUI mode. The list of packages/collections/schemes only shows up after +clicking the ‘Load’ button.</td></tr></table><!--tex4ht:label?: x1-41001r8 --> + + +<!--l. 1253--><p class="noindent" ></td></tr></table></div><hr class="endfigure"> +<!--l. 1255--><p class="indent" > <hr class="figure"><div class="figure" +><table class="figure"><tr class="figure"><td class="figure" +> + + +<a + id="x1-41002r9"></a> + + + +<!--l. 1256--><p class="noindent" ><img +src="tlmgr-config.png" alt="pict" +> +<br /> <table class="caption" +><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 9: </td><td +class="content"><span +class="ec-lmtt-10">tlmgr </span>in GUI mode: Configuration tab</td></tr></table><!--tex4ht:label?: x1-41002r9 --> + + +<!--l. 1258--><p class="indent" > </td></tr></table></div><hr class="endfigure"> +<!--l. 1260--><p class="indent" > The installer installs a program named <span +class="ec-lmss-10">tlmgr </span>for managing <span class="TEX">T<span +class="E">E</span>X</span> Live after the initial installation. +The programs <span +class="ec-lmss-10">updmap</span>, <span +class="ec-lmss-10">fmtutil </span>and <span +class="ec-lmss-10">texconfig </span>are still included and will be retained in the future, but +<span +class="ec-lmss-10">tlmgr </span>is now the preferred interface. Its capabilities include: + <ul class="itemize1"> + <li class="itemize">listing schemes, collections and packages; + </li> + <li class="itemize">installing, updating, backing up, restoring and uninstalling individual packages, optionally + taking dependencies into account; + </li> + <li class="itemize">searching for packages; + </li> + <li class="itemize">listing and adding architectures; + </li> + <li class="itemize">changing installation options such as paper size and source location (see section <a +href="#x1-280003.3.1">3.3.1<!--tex4ht:ref: sec:location --></a>).</li></ul> +<!--l. 1275--><p class="noindent" ><span +class="ec-lmri-10">Warning: </span><span +class="ec-lmss-10">tlmgr </span>has not been designed for or tested with installations which run from DVD. + <h4 class="subsectionHead"><span class="titlemark">6.1 </span> <a + id="x1-420006.1"></a><span +class="ec-lmss-10">tlmgr </span>GUI mode</h4> +<!--l. 1279--><p class="noindent" ><span +class="ec-lmss-10">tlmgr </span>can be started in GUI mode with <div class="alltt"> +<!--l. 1280--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> -gui</span> +</div> +</div> or in Windows via the Start menu: <span +class="ec-lmtt-10">Start</span>, <span +class="ec-lmtt-10">Programs</span>, <span +class="ec-lmtt-10">TeX Live 2008</span>, <span +class="ec-lmtt-10">TeX Live Manager</span>. After clicking +‘Load’ it displays a list of available and installed packages — the latter prepended with ‘(i)’. This assumes +of course that the installation source is valid and reachable. +<!--l. 1289--><p class="indent" > Figure <a +href="#x1-41002r9">9<!--tex4ht:ref: fig:tlmgr-config --></a> shows the configuration tab. +<!--l. 1291--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">6.2 </span> <a + id="x1-430006.2"></a>Sample <span +class="ec-lmss-10">tlmgr </span>command-line invocations</h4> +<!--l. 1293--><p class="noindent" >This example adds several packages, including a new ‘engine’, from a non-default location: + <div class="alltt"> +<!--l. 1296--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> -location</span><span +class="ec-lmtk-10"> http://172.16.18.1/tldev</span><span +class="ec-lmtk-10"> install</span><span +class="ec-lmtk-10"> collection-xetex</span><span +class="ec-lmtk-10"> xkeyval</span> +</div> +</div> It generates the following output: + <div class="fancyvrb" id="fancyvrb13"> +<a + id="x1-43002r1"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> collection-xetex</span> +<br class="fancyvrb" /><a + id="x1-43004r2"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> arabxetex</span> +<br class="fancyvrb" /><a + id="x1-43006r3"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> euenc</span> +<br class="fancyvrb" /><a + id="x1-43008r4"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> bidi</span> +<br class="fancyvrb" /><a + id="x1-43010r5"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> fontspec</span> +<br class="fancyvrb" /><a + id="x1-43012r6"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> fontwrap</span> +<br class="fancyvrb" /><a + id="x1-43014r7"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> ifxetex</span> +<br class="fancyvrb" /><a + id="x1-43016r8"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> philokalia</span> + + +<br class="fancyvrb" /><a + id="x1-43018r9"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> polyglossia</span> +<br class="fancyvrb" /><a + id="x1-43020r10"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xecyr</span> +<br class="fancyvrb" /><a + id="x1-43022r11"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xecyr.i386-linux</span> +<br class="fancyvrb" /><a + id="x1-43024r12"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xepersian</span> +<br class="fancyvrb" /><a + id="x1-43026r13"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xetex</span> +<br class="fancyvrb" /><a + id="x1-43028r14"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xetexconfig</span> +<br class="fancyvrb" /><a + id="x1-43030r15"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xetex.i386-linux</span> +<br class="fancyvrb" /><a + id="x1-43032r16"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> running</span><span +class="ec-lmtt-8"> post</span><span +class="ec-lmtt-8"> install</span><span +class="ec-lmtt-8"> action</span><span +class="ec-lmtt-8"> for</span><span +class="ec-lmtt-8"> xetex</span> +<br class="fancyvrb" /><a + id="x1-43034r17"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xetex-def</span> +<br class="fancyvrb" /><a + id="x1-43036r18"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xetex-pstricks</span> +<br class="fancyvrb" /><a + id="x1-43038r19"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xetexfontinfo</span> +<br class="fancyvrb" /><a + id="x1-43040r20"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xltxtra</span> +<br class="fancyvrb" /><a + id="x1-43042r21"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xunicode</span> +<br class="fancyvrb" /><a + id="x1-43044r22"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xkeyval</span> +<br class="fancyvrb" /><a + id="x1-43046r23"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> running</span><span +class="ec-lmtt-8"> mktexlsr</span> +<br class="fancyvrb" /><a + id="x1-43048r24"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> mktexlsr:</span><span +class="ec-lmtt-8"> Updating</span><span +class="ec-lmtt-8"> /usr/local/texlive/2008/texmf/ls-R...</span> +<br class="fancyvrb" /><a + id="x1-43050r25"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> mktexlsr:</span><span +class="ec-lmtt-8"> Updating</span><span +class="ec-lmtt-8"> /usr/local/texlive/2008/texmf-config/ls-R...</span> +<br class="fancyvrb" /><a + id="x1-43052r26"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> mktexlsr:</span><span +class="ec-lmtt-8"> Updating</span><span +class="ec-lmtt-8"> /usr/local/texlive/2008/texmf-dist/ls-R...</span> +<br class="fancyvrb" /><a + id="x1-43054r27"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> mktexlsr:</span><span +class="ec-lmtt-8"> Updating</span><span +class="ec-lmtt-8"> /usr/local/texlive/2008/texmf-doc/ls-R...</span> +<br class="fancyvrb" /><a + id="x1-43056r28"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> mktexlsr:</span><span +class="ec-lmtt-8"> Updating</span><span +class="ec-lmtt-8"> /usr/local/texlive/2008/../texmf-local/ls-R...</span> +<br class="fancyvrb" /><a + id="x1-43058r29"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> mktexlsr:</span><span +class="ec-lmtt-8"> Updating</span><span +class="ec-lmtt-8"> /usr/local/texlive/2008/texmf-var/ls-R...</span> +<br class="fancyvrb" /><a + id="x1-43060r30"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> mktexlsr:</span><span +class="ec-lmtt-8"> Done.</span> +<br class="fancyvrb" /><a + id="x1-43062r31"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> regenerating</span><span +class="ec-lmtt-8"> fmtutil.cnf</span> +<br class="fancyvrb" /><a + id="x1-43064r32"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> running</span><span +class="ec-lmtt-8"> fmtutil-sys</span><span +class="ec-lmtt-8"> --missing</span> +<br class="fancyvrb" /><a + id="x1-43066r33"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ...</span> +<br class="fancyvrb" /><a + id="x1-43068r34"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Transcript</span><span +class="ec-lmtt-8"> written</span><span +class="ec-lmtt-8"> on</span><span +class="ec-lmtt-8"> xelatex.log.</span> +<br class="fancyvrb" /><a + id="x1-43070r35"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> fmtutil:</span><span +class="ec-lmtt-8"> /usr/local/texlive/2008/texmf-var/web2c/xetex/xelatex.fmt</span><span +class="ec-lmtt-8"> installed.</span> + </div> +<!--l. 1337--><p class="noindent" >As you see, <span +class="ec-lmss-10">tlmgr </span>installs dependencies, and takes care of any necessary post-install actions, including +updating the filename database and (re)generating formats. (Here we generated new formats for +Xe<span class="TEX">T<span +class="E">E</span>X</span>.) +<!--l. 1341--><p class="indent" > This example installs a new language. This also triggers format regeneration: <div class="alltt"> +<!--l. 1343--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> install</span><span +class="ec-lmtk-10"> collection-langdutch</span> +</div> +</div> To describe a package: <div class="alltt"> +<!--l. 1347--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> show</span><span +class="ec-lmtk-10"> collection-wintools</span> +</div> +</div> which produces + <div class="fancyvrb" id="fancyvrb14"> +<a + id="x1-43072r1"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Package:</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> collection-wintools</span> +<br class="fancyvrb" /><a + id="x1-43074r2"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Category:</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Collection</span> +<br class="fancyvrb" /><a + id="x1-43076r3"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ShortDesc:</span><span +class="ec-lmtt-8"> Windows</span><span +class="ec-lmtt-8"> support</span><span +class="ec-lmtt-8"> programs</span> +<br class="fancyvrb" /><a + id="x1-43078r4"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> LongDesc:</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Utilities</span><span +class="ec-lmtt-8"> for</span><span +class="ec-lmtt-8"> Windows,</span><span +class="ec-lmtt-8"> since</span><span +class="ec-lmtt-8"> they</span><span +class="ec-lmtt-8"> are</span><span +class="ec-lmtt-8"> not</span><span +class="ec-lmtt-8"> readily</span><span +class="ec-lmtt-8"> available</span><span +class="ec-lmtt-8"> there:</span> +<br class="fancyvrb" /><a + id="x1-43080r5"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> gzip,</span><span +class="ec-lmtt-8"> chktex,</span><span +class="ec-lmtt-8"> jpeg2ps,</span><span +class="ec-lmtt-8"> unzip,</span><span +class="ec-lmtt-8"> wget,</span><span +class="ec-lmtt-8"> xpdf.</span> +<br class="fancyvrb" /><a + id="x1-43082r6"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Installed:</span><span +class="ec-lmtt-8"> Yes</span> + </div> +<!--l. 1359--><p class="noindent" >Updating your entire installation to the latest versions available: <div class="alltt"> +<!--l. 1360--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> update</span><span +class="ec-lmtk-10"> -all</span> + +</div> +</div> If this makes you nervous, first try <div class="alltt"> +<!--l. 1364--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> update</span><span +class="ec-lmtk-10"> -all</span><span +class="ec-lmtk-10"> -dry-run</span> +</div> +</div> or <div class="alltt"> +<!--l. 1368--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> update</span><span +class="ec-lmtk-10"> -list</span> +</div> +</div> For full documentation: <div class="alltt"> +<!--l. 1372--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> -help</span> +</div> +</div> +<!--l. 1377--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">7 </span> <a + id="x1-440007"></a>Notes on Windows</h3> +<!--l. 1380--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> Live has a single installer which runs on both Windows and Unix. This was only possible by +dropping support for older Windows versions, so <span class="TEX">T<span +class="E">E</span>X</span> Live can now be installed only on Windows 2000 +and later. +<!--l. 1385--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.1 </span> <a + id="x1-450007.1"></a>Windows-specific features</h4> +<!--l. 1388--><p class="noindent" >Under Windows, the installer does some extra things: + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">Menus and shortcuts.</span> </dt><dd +class="description">A new ‘<span class="TEX">T<span +class="E">E</span>X</span> Live’ submenu of the Start menu is installed, which + contains entries for some GUI programs (<span +class="ec-lmss-10">tlmgr</span>, <span +class="ec-lmss-10">texdoctk</span>, the PS_View PostScript previewer) + and some documentation. PS_View also gets a shortcut on the desktop as a drag-and-drop + target for PostScript files. + </dd><dt class="description"> +<span +class="ec-lmbx-10">Automatic setting of environment variables.</span> </dt><dd +class="description">No manual configuration steps are required. + </dd><dt class="description"> +<span +class="ec-lmbx-10">Uninstaller.</span> </dt><dd +class="description">The installer creates an entry under ‘Add/Remove Programs’ for <span class="TEX">T<span +class="E">E</span>X</span> Live. The + uninstall tab of<span +class="ec-lmss-10">tlmgr </span>refers to this.</dd></dl> +<!--l. 1402--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.2 </span> <a + id="x1-460007.2"></a>Additional included software</h4> +<!--l. 1404--><p class="noindent" ><hr class="figure"><div class="figure" +><table class="figure"><tr class="figure"><td class="figure" +> + + +<a + id="x1-46001r10"></a> + + + +<!--l. 1405--><p class="noindent" ><img +src="psview.png" alt="pict" +> +<br /> <table class="caption" +><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 10: </td><td +class="content">PS_View: very high magnifications available!</td></tr></table><!--tex4ht:label?: x1-46001r10 --> + + +<!--l. 1407--><p class="noindent" ></td></tr></table></div><hr class="endfigure"> +<!--l. 1409--><p class="indent" > 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. <span class="TEX">T<span +class="E">E</span>X</span> Live provides the missing pieces: + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">Perl and Ghostscript.</span> </dt><dd +class="description">Because of the importance of Perl and Ghostscript, <span class="TEX">T<span +class="E">E</span>X</span> Live includes + ‘hidden’ copies of these programs. <span class="TEX">T<span +class="E">E</span>X</span> Live programs that need them know where to find + them, but they don’t betray their presence through environment variables or registry settings. + They aren’t full-scale distributions, and shouldn’t interfere with any system installations of + Perl or Ghostscript. + </dd><dt class="description"> +<span +class="ec-lmbx-10">Command-line tools.</span> </dt><dd +class="description">A number of Windows ports of common Unix command-line programs + are installed along with the usual <span class="TEX">T<span +class="E">E</span>X</span> Live binaries. These include <span +class="ec-lmss-10">gzip</span>, <span +class="ec-lmss-10">chktex</span>, + <span +class="ec-lmss-10">jpeg2ps</span>, <span +class="ec-lmss-10">unzip</span>, <span +class="ec-lmss-10">wget </span>and the command-line utilities from the <span +class="ec-lmss-10">xpdf </span>suite. (The <span +class="ec-lmss-10">xpdf</span> + viewer itself is not available for Windows, but the Sumatra PDF viewer is based on it: + <a +href="http://blog.kowalczyk.info/software/sumatrapdf" class="url" ><span +class="ec-lmtt-10">http://blog.kowalczyk.info/software/sumatrapdf</span></a>.) + </dd><dt class="description"> +<span +class="ec-lmtk-10">fc-cache</span> </dt><dd +class="description">helps Xe<span class="TEX">T<span +class="E">E</span>X</span> to handle fonts more efficiently. + </dd><dt class="description"> +<span +class="ec-lmbx-10">PS_View.</span> </dt><dd +class="description">Also installed is PS_View, a new PostScript viewer with a free license; see figure <a +href="#x1-46001r10">10<!--tex4ht:ref: fig:psview --></a>.</dd></dl> + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">The </span><span +class="ec-lmtk-10">support </span><span +class="ec-lmbx-10">directory,</span> </dt><dd +class="description">already mentioned in section <a +href="#x1-90002.2">2.2<!--tex4ht:ref: sec:tld --></a>. This directory contains various + programs which can be useful in connection with <span class="TEX">T<span +class="E">E</span>X</span>, in particular a number of <span class="TEX">T<span +class="E">E</span>X</span>-aware + editors and <span class="TEX">T<span +class="E">E</span>X</span> frontends. The software in this directory isn’t covered by the installer. This + directory also contains the <span +class="ec-lmss-10">dviout </span>DVI previewer; see the next section.</dd></dl> + <h4 class="subsectionHead"><span class="titlemark">7.3 </span> <a + id="x1-470007.3"></a>The Dviout previewer</h4> +<!--l. 1444--><p class="noindent" >This <span class="TEX">T<span +class="E">E</span>X</span> Live release unfortunately doesn’t offer a preinstalled DVI previewer for Windows. However, +you can install <span +class="ec-lmss-10">dviout </span>by Toshio Oshima from the <span +class="ec-lmtt-10">support/dviout/ </span>directory, which contains also a +short <span +class="ec-lmtt-10">README </span>describing how to install and configure <span +class="ec-lmss-10">dviout </span>for <span class="TEX">T<span +class="E">E</span>X</span> Live. Please read this carefully +before installation. +<!--l. 1451--><p class="indent" > At first, when you preview files with <span +class="ec-lmss-10">dviout</span>, it will create fonts, because screen fonts were +not installed. After a while, you will have created most of the fonts you use, and you will +rarely see the font-creation window. More information can be found in the (very good) on-line +help. +<!--l. 1456--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.4 </span> <a + id="x1-480007.4"></a>Links for additional downloadable software</h4> +<!--l. 1458--><p class="noindent" >Urls for some other tools you may consider installing: + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">Ghostscript</span> </dt><dd +class="description"><a +href="http://www.cs.wisc.edu/~ghost/" class="url" ><span +class="ec-lmtt-10">http://www.cs.wisc.edu/~ghost/</span></a> + </dd><dt class="description"> +<span +class="ec-lmbx-10">Perl</span> </dt><dd +class="description"><a +href="http://www.perl.org/" class="url" ><span +class="ec-lmtt-10">http://www.perl.org/</span></a> with supplementary packages from CPAN, <a +href="http://www.cpan.org/" class="url" ><span +class="ec-lmtt-10">http://www.cpan.org/</span></a> + </dd><dt class="description"> +<span +class="ec-lmbx-10">ImageMagick</span> </dt><dd +class="description"><a +href="http://www.imagemagick.com" class="url" ><span +class="ec-lmtt-10">http://www.imagemagick.com</span></a>, for graphics processing and conversion + + </dd><dt class="description"> +<span +class="ec-lmbx-10">NetPBM</span> </dt><dd +class="description"><a +href="http://netpbm.sourceforge.net/" class="url" ><span +class="ec-lmtt-10">http://netpbm.sourceforge.net/</span></a>, also for graphics. + </dd><dt class="description"> +<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><span +class="ec-lmbx-10">-oriented editors</span> </dt><dd +class="description">There is a wide choice, and it is a matter of the user’s taste. Here is a selection, + in no particular order: + <ul class="itemize1"> + <li class="itemize"><span +class="ec-lmss-10">GNU Emacs </span>is available natively under Windows, see + <a +href="http://www.gnu.org/software/emacs/windows/ntemacs.html" class="url" ><span +class="ec-lmtt-10">http://www.gnu.org/software/emacs/windows/ntemacs.html</span></a>. + </li> + <li class="itemize"><span +class="ec-lmss-10">Emacs </span>with Auc<span class="TEX">T<span +class="E">E</span>X</span> for Windows is available in <span class="TEX">T<span +class="E">E</span>X</span> Live’s <span +class="ec-lmtt-10">support </span>directory; its + home page is <a +href="http://www.gnu.org/software/auctex" class="url" ><span +class="ec-lmtt-10">http://www.gnu.org/software/auctex</span></a>. + </li> + <li class="itemize"><span +class="ec-lmss-10">WinShell </span>is available in <span class="TEX">T<span +class="E">E</span>X</span> Live’s <span +class="ec-lmtt-10">support </span>directory; its home page is + <a +href="http://www.winshell.de" class="url" ><span +class="ec-lmtt-10">http://www.winshell.de</span></a>. + </li> + <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>. + </li> + <li class="itemize"><span +class="ec-lmss-10">Vim </span>is free software, available from <a +href="http://www.vim.org" class="url" ><span +class="ec-lmtt-10">http://www.vim.org</span></a>. + </li> + <li class="itemize">TeXnicCenter is free software, available from <a +href="http://www.toolscenter.org" class="url" ><span +class="ec-lmtt-10">http://www.toolscenter.org</span></a> and in the + pro<span class="TEX">T<span +class="E">E</span>X</span>t distribution. + </li> + <li class="itemize"><span +class="ec-lmss-10">LEd </span>is available from <a +href="http://www.ctan.org/support/LEd" class="url" ><span +class="ec-lmtt-10">http://www.ctan.org/support/LEd</span></a>. + </li> + <li class="itemize"><span +class="ec-lmss-10">SciTE </span>is available from <a +href="http://www.scintilla.org/SciTE.html" class="url" ><span +class="ec-lmtt-10">http://www.scintilla.org/SciTE.html</span></a>.</li></ul> + </dd></dl> +<!--l. 1490--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.5 </span> <a + id="x1-490007.5"></a>User Profile is Home</h4> +<!--l. 1493--><p class="noindent" >The Windows counterpart of a Unix home directory is the <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">%USERPROFILE%</span></span></span> directory. Under Windows XP +and Windows 2000, this is usually <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">C:\Documents</span><span +class="ec-lmtt-10"> and</span><span +class="ec-lmtt-10"> Settings\<username></span></span></span>, and under Windows Vista +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">C:\Users\<username></span></span></span>. In the <span +class="ec-lmtt-10">texmf.cnf </span>file, and Kpathsea in general, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">~</span></span></span> will expand appropriately on +both Windows and Unix. +<!--l. 1501--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.6 </span> <a + id="x1-500007.6"></a>The Windows registry</h4> +<!--l. 1504--><p class="noindent" >Windows stores nearly all configuration data in its registry. The registry contains a set of hierarchically +organized keys, with several root keys. The most important ones for installation programs are +<span +class="ec-lmtt-10">HKEY_CURRENT_USER </span>and <span +class="ec-lmtt-10">HKEY_LOCAL_MACHINE</span>, <span +class="ec-lmtt-10">HKCU </span>and <span +class="ec-lmtt-10">HKLM </span>in short. The <span +class="ec-lmtt-10">HKCU </span>part of the registry is +in the user’s home directory (see section <a +href="#x1-490007.5">7.5<!--tex4ht:ref: sec:winhome --></a>). <span +class="ec-lmtt-10">HKLM </span>is normally in a subdirectory of the Windows +directory. +<!--l. 1512--><p class="indent" > In some cases, system information could be obtained from environment variables but for other +information, for example the location of shortcuts, it is necessary to consult the registry. Setting +environment variables permanently also requires registry access. + + +<!--l. 1518--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.7 </span> <a + id="x1-510007.7"></a>Windows permissions</h4> +<!--l. 1521--><p class="noindent" >In later versions of Windows, a distinction is made between regular users and administrators, where only +the latter have free access to the entire operating system. In practice, though, you could better describe +these classes of users as unprivileged users and normal users: being an administrator is the rule, not the +exception. Nevertheless, we have made an effort to make <span class="TEX">T<span +class="E">E</span>X</span> Live installable without administrative +privileges. +<!--l. 1528--><p class="indent" > If the user is an administrator, shortcuts are created for all users, and the system environment is +modified. Otherwise, shortcuts and menu entries are created for the current user, and the user +environment is modified. Use the <span +class="ec-lmtt-10">non-admin </span>option to <span +class="ec-lmss-10">install-tl </span>if you prefer per-user settings even as an +administrator. +<!--l. 1534--><p class="indent" > Regardless of administrator status, the default root of <span class="TEX">T<span +class="E">E</span>X</span> Live proposed by the installer is always +under <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">%PROGRAMFILES%</span></span></span>. The installer always tests whether the root is writable for the current +user. +<!--l. 1538--><p class="indent" > A problem may arise if the user is not an administrator and <span class="TEX">T<span +class="E">E</span>X</span> already exists in the search path. +Since the effective path consists of the system path followed by the user path, the new <span class="TEX">T<span +class="E">E</span>X</span> Live will +never get precedence. As a workaround, in this case the installer creates shortcuts to the +command-prompt in which the new <span class="TEX">T<span +class="E">E</span>X</span> Live binary directory is prepended to the local searchpath. +The new <span class="TEX">T<span +class="E">E</span>X</span> Live will be usable when run in a command-line session started from such a +shortcut. +<!--l. 1547--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">8 </span> <a + id="x1-520008"></a>A user’s guide to Web2C</h3> +<!--l. 1549--><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, +etc. It is the heart of <span class="TEX">T<span +class="E">E</span>X</span> Live. The home page for Web2C, with the current manual and more, is +<a +href="http://tug.org/web2c" class="url" ><span +class="ec-lmtt-10">http://tug.org/web2c</span></a>. +<!--l. 1554--><p class="indent" > A bit of history: The original implementation was by Tomas Rokicki who, in 1987, developed a first +<span class="TEX">T<span +class="E">E</span>X</span>-to-C system based on change files under Unix, which were primarily the original work of Howard +Trickey and Pavel Curtis. Tim Morgan became the maintainer of the system, and during this period the +name changed to Web-to-C. In 1990, Karl Berry took over the work, assisted by dozens of additional +contributors, and in 1997 he handed the baton to Olaf Weber, who returned it to Karl in +2006. +<!--l. 1563--><p class="indent" > The Web2C system runs on Unix, 32-bit Windows systems, Mac OS X, and other operating systems. +It uses Knuth’s original sources for <span class="TEX">T<span +class="E">E</span>X</span> and other basic programs written in the <span +class="ec-lmtt-10">WEB </span>literate +programming system and translates them into C source code. The core <span class="TEX">T<span +class="E">E</span>X</span> programs handled in this +way are: +<!--l. 1569--><p class="indent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmss-10">bibtex</span> </dt><dd +class="list"> + <!--l. 1570--><p class="noindent" >Maintaining bibliographies. + </dd><dt class="list"> + <span +class="ec-lmss-10">dmp</span> </dt><dd +class="list"> + <!--l. 1571--><p class="noindent" ><span +class="ec-lmss-10">troff </span>to MPX (MetaPost pictures). + </dd><dt class="list"> + <span +class="ec-lmss-10">dvicopy</span> </dt><dd +class="list"> + <!--l. 1572--><p class="noindent" >Expands virtual font references in DVI files. + + + </dd><dt class="list"> + <span +class="ec-lmss-10">dvitomp</span> </dt><dd +class="list"> + <!--l. 1573--><p class="noindent" >DVI to MPX (MetaPost pictures). + </dd><dt class="list"> + <span +class="ec-lmss-10">dvitype</span> </dt><dd +class="list"> + <!--l. 1574--><p class="noindent" >DVI to human-readable text. + </dd><dt class="list"> + <span +class="ec-lmss-10">gftodvi</span> </dt><dd +class="list"> + <!--l. 1575--><p class="noindent" >Generic font proofsheets. + </dd><dt class="list"> + <span +class="ec-lmss-10">gftopk</span> </dt><dd +class="list"> + <!--l. 1576--><p class="noindent" >Generic to packed fonts. + </dd><dt class="list"> + <span +class="ec-lmss-10">gftype</span> </dt><dd +class="list"> + <!--l. 1577--><p class="noindent" >GF to human-readable text. + </dd><dt class="list"> + <span +class="ec-lmss-10">makempx</span> </dt><dd +class="list"> + <!--l. 1578--><p class="noindent" >MetaPost label typesetting. + </dd><dt class="list"> + <span +class="ec-lmss-10">mf</span> </dt><dd +class="list"> + <!--l. 1579--><p class="noindent" >Creating typeface families. + </dd><dt class="list"> + <span +class="ec-lmss-10">mft</span> </dt><dd +class="list"> + <!--l. 1580--><p class="noindent" >Prettyprinting Metafont source. + </dd><dt class="list"> + <span +class="ec-lmss-10">mpost</span> </dt><dd +class="list"> + <!--l. 1581--><p class="noindent" >Creating technical diagrams. + </dd><dt class="list"> + <span +class="ec-lmss-10">mpto</span> </dt><dd +class="list"> + <!--l. 1582--><p class="noindent" >MetaPost label extraction. + </dd><dt class="list"> + <span +class="ec-lmss-10">newer</span> </dt><dd +class="list"> + <!--l. 1583--><p class="noindent" >Compare modification times. + </dd><dt class="list"> + <span +class="ec-lmss-10">patgen</span> </dt><dd +class="list"> + <!--l. 1584--><p class="noindent" >Creating hyphenation patterns. + </dd><dt class="list"> + <span +class="ec-lmss-10">pktogf</span> </dt><dd +class="list"> + <!--l. 1585--><p class="noindent" >Packed to generic fonts. + </dd><dt class="list"> + <span +class="ec-lmss-10">pktype</span> </dt><dd +class="list"> + <!--l. 1586--><p class="noindent" >PK to human-readable text. + + + </dd><dt class="list"> + <span +class="ec-lmss-10">pltotf</span> </dt><dd +class="list"> + <!--l. 1587--><p class="noindent" >Plain text property list to TFM. + </dd><dt class="list"> + <span +class="ec-lmss-10">pooltype</span> </dt><dd +class="list"> + <!--l. 1588--><p class="noindent" >Display <span +class="ec-lmtt-10">WEB </span>pool files. + </dd><dt class="list"> + <span +class="ec-lmss-10">tangle</span> </dt><dd +class="list"> + <!--l. 1589--><p class="noindent" ><span +class="ec-lmtt-10">WEB </span>to Pascal. + </dd><dt class="list"> + <span +class="ec-lmss-10">tex</span> </dt><dd +class="list"> + <!--l. 1590--><p class="noindent" >Typesetting. + </dd><dt class="list"> + <span +class="ec-lmss-10">tftopl</span> </dt><dd +class="list"> + <!--l. 1591--><p class="noindent" >TFM to plain text property list. + </dd><dt class="list"> + <span +class="ec-lmss-10">vftovp</span> </dt><dd +class="list"> + <!--l. 1592--><p class="noindent" >Virtual font to virtual property list. + </dd><dt class="list"> + <span +class="ec-lmss-10">vptovf</span> </dt><dd +class="list"> + <!--l. 1593--><p class="noindent" >Virtual property list to virtual font. + </dd><dt class="list"> + <span +class="ec-lmss-10">weave</span> </dt><dd +class="list"> + <!--l. 1594--><p class="noindent" ><span +class="ec-lmtt-10">WEB </span>to <span class="TEX">T<span +class="E">E</span>X</span>.</dd></dl> +<!--l. 1597--><p class="noindent" >The precise functions and syntax of these programs are described in the documentation of the individual +packages and of Web2C itself. However, knowing a few principles governing the whole family of programs +will help you take advantage of your Web2C installation. +<!--l. 1602--><p class="indent" > All programs honor these standard GNU options: + <dl class="list1"><dt class="list"> + <span +class="ec-lmtt-10">--help</span> </dt><dd +class="list"> + <!--l. 1604--><p class="noindent" >print basic usage summary. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--verbose</span> </dt><dd +class="list"> + <!--l. 1605--><p class="noindent" >print detailed progress report. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--version</span> </dt><dd +class="list"> + <!--l. 1606--><p class="noindent" >print version information, then exit.</dd></dl> +<!--l. 1609--><p class="indent" > For locating files the Web2C programs use the path searching library Kpathsea +(<a +href="http://tug.org/kpathsea" class="url" ><span +class="ec-lmtt-10">http://tug.org/kpathsea</span></a>). This library uses a combination of environment variables and a +configuration files to optimize searching the (huge) collection of <span class="TEX">T<span +class="E">E</span>X</span> files. Web2C can look at many +directory trees simultaneously, which is useful in maintaining <span class="TEX">T<span +class="E">E</span>X</span>’s standard distribution and local and +personal extensions in distinct trees. To speed up file searches, the root of each tree has a file +<span +class="ec-lmtt-10">ls-R</span>, containing an entry showing the name and relative pathname for all files under that +root. + + +<!--l. 1620--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">8.1 </span> <a + id="x1-530008.1"></a>Kpathsea path searching</h4> +<!--l. 1623--><p class="noindent" >Let us first describe the generic path searching mechanism of the Kpathsea library. +<!--l. 1626--><p class="indent" > We call a <span +class="ec-lmri-10">search path </span>a colon- or semicolon-separated list of <span +class="ec-lmri-10">path elements</span>, which are basically +directory names. A search path can come from (a combination of) many sources. To look up a file +‘<span +class="ec-lmtt-10">my-file</span>’ along a path ‘<span +class="ec-lmtt-10">.:/dir</span>’, Kpathsea checks each element of the path in turn: first <span +class="ec-lmtt-10">./my-file</span>, +then <span +class="ec-lmtt-10">/dir/my-file</span>, returning the first match (or possibly all matches). +<!--l. 1634--><p class="indent" > In order to adapt optimally to all operating systems’ conventions, on non-Unix systems Kpathsea can +use filename separators different from colon (‘<span +class="ec-lmtt-10">:</span>’) and slash (‘<span +class="ec-lmtt-10">/</span>’). +<!--l. 1638--><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-610008.2">63<!--tex4ht:ref: sec: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. +<!--l. 1644--><p class="indent" > If the database does not exist, or does not apply to this path element, or contains no matches, the +filesystem is searched (if this was not forbidden by a specification starting with ‘<span +class="ec-lmtt-10">!!</span>’ and if the file being +searched for must exist). Kpathsea constructs the list of directories that correspond to this path element, +and then checks in each for the file being sought. +<!--l. 1651--><p class="indent" > The “file must exist” condition comes into play with ‘<span +class="ec-lmtt-10">.vf</span>’ files and input files read by <span class="TEX">T<span +class="E">E</span>X</span>’s <span +class="ec-lmtt-10">\openin</span> +command. Such files may not exist (e.g., <span +class="ec-lmtt-10">cmr10.vf</span>), and so it would be wrong to search the disk for +them. Therefore, if you fail to update <span +class="ec-lmtt-10">ls-R </span>when you install a new ‘<span +class="ec-lmtt-10">.vf</span>’ file, it will never be found. Each +path element is checked in turn: first the database, then the disk. If a match is found, the search stops +and the result is returned. +<!--l. 1660--><p class="indent" > Although the simplest and most common path element is a directory name, Kpathsea supports +additional features in search paths: layered default values, environment variable names, config +file values, users’ home directories, and recursive subdirectory searching. Thus, we say that +Kpathsea <span +class="ec-lmri-10">expands </span>a path element, meaning it transforms all the specifications into basic +directory name or names. This is described in the following sections in the same order as it takes +place. +<!--l. 1669--><p class="indent" > Note that if the filename being searched for is absolute or explicitly relative, i.e., starts with ‘<span +class="ec-lmtt-10">/</span>’ or +‘<span +class="ec-lmtt-10">./</span>’ or ‘<span +class="ec-lmtt-10">../</span>’, Kpathsea simply checks if that file exists. +<!--l. 1683--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.1.1 </span> <a + id="x1-540008.1.1"></a>Path sources</h5> +<!--l. 1686--><p class="noindent" >A search path can come from many sources. In the order in which Kpathsea uses them: +<!--l. 1689--><p class="indent" > + <ol class="enumerate1" > + <li + class="enumerate" id="x1-54002x1">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 + being run, then <span +class="ec-lmtt-10">TEXINPUTS.latex </span>will override <span +class="ec-lmtt-10">TEXINPUTS</span>. + </li> + <li + class="enumerate" id="x1-54004x2">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-54006x3">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-54008x4">The compile-time default.</li></ol> +<!--l. 1702--><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-650008.2.4">67<!--tex4ht:ref: sec:debugging --></a>). + + +<!--l. 1706--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.1.2 </span> <a + id="x1-550008.1.2"></a>Config files</h5> +<!--l. 1709--><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 +search path used to look for these files is named <span +class="ec-lmtt-10">TEXMFCNF </span>(by default such a file lives in the +<span +class="ec-lmtt-10">texmf/web2c </span>subdirectory). <span +class="ec-lmri-10">All </span><span +class="ec-lmtt-10">texmf.cnf </span>files in the search path will be read and definitions in earlier +files override those in later files. Thus, with a search path of <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">.:$TEXMF</span></span></span>, values from <span +class="ec-lmtt-10">./texmf.cnf </span>override +those from <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">$TEXMF/texmf.cnf</span></span></span>. + <ul class="itemize1"> + <li class="itemize">Comments start with <span +class="ec-lmtt-10">% </span>and continue to the end of the line. + </li> + <li class="itemize">Blank lines are ignored. + </li> + <li class="itemize">A <span +class="ec-lmtt-10">\ </span>at the end of a line acts as a continuation character, i.e., the next line is appended. + Whitespace at the beginning of continuation lines is not ignored. + </li> + <li class="itemize">Each remaining line has the form: <div class="alltt"> + <!--l. 1730--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmro-10">variable</span><span +class="ec-lmtt-10">[.</span><span +class="ec-lmro-10">progname</span><span +class="ec-lmtt-10">]</span><span +class="ec-lmtt-10"> [=]</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmro-10">value</span> +</div> + </div>where the ‘<span +class="ec-lmtt-10">=</span>’ and surrounding whitespace are optional. + </li> + <li class="itemize">The <span +class="ec-lmro-10">variable </span>name may contain any character other than whitespace, ‘<span +class="ec-lmtt-10">=</span>’, or ‘<span +class="ec-lmtt-10">.</span>’, but sticking to + ‘<span +class="ec-lmtt-10">A-Za-z_</span>’ is safest. + </li> + <li class="itemize">If ‘<span +class="ec-lmtt-10">.</span><span +class="ec-lmro-10">progname</span>’ is present, the definition only applies if the program that is running is named + <span +class="ec-lmro-10">progname </span>or <span +class="ec-lmro-10">progname</span><span +class="ec-lmtt-10">.exe</span>. This allows different flavors of <span class="TEX">T<span +class="E">E</span>X</span> to have different search paths, for + example. + </li> + <li class="itemize"><span +class="ec-lmro-10">value </span>may contain any characters except <span +class="ec-lmtt-10">% </span>and ‘<span +class="ec-lmtt-10">@</span>’. The <span +class="ec-lmtt-10">$</span><span +class="ec-lmro-10">var</span><span +class="ec-lmtt-10">.</span><span +class="ec-lmro-10">prog </span>feature is not available on the + right-hand side; instead, you must use an additional variable. A ‘<span +class="ec-lmtt-10">;</span>’ in <span +class="ec-lmro-10">value </span>is translated to ‘<span +class="ec-lmtt-10">:</span>’ if + running under Unix; this is useful to be able to have a single <span +class="ec-lmtt-10">texmf.cnf </span>for Unix, MS-DOS and + Windows systems. + </li> + <li class="itemize">All definitions are read before anything is expanded, so variables can be referenced before they are + defined.</li></ul> +<!--l. 1755--><p class="noindent" >A configuration file fragment illustrating most of these points is shown below: +<!--l. 1759--><p class="indent" > + <div class="fancyvrb" id="fancyvrb15"> +<a + id="x1-55002r1"></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 +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +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-55004r2"></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 +class="ec-lmtt-8x-x-87"> </span><span +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-55006r3"></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-55008r4"></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-55010r5"></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 +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-55012r6"></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 +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +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}/{eplain,plain,generic;}//</span> + </div> + + +<!--l. 1764--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.1.3 </span> <a + id="x1-560008.1.3"></a>Path expansion</h5> +<!--l. 1768--><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 +all subdirectories under directories <span +class="ec-lmtt-10">foo </span>and <span +class="ec-lmtt-10">bar </span>in <span +class="ec-lmtt-10">$USER</span>’s home directory that contain a directory or file +<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-570008.1.4"></a>Default expansion</h5> +<!--l. 1780--><p class="noindent" >If the highest-priority search path (see “Path sources” on page <a +href="#x1-540008.1.1">58<!--tex4ht:ref: sec: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 +environment variable setting + <div class="alltt"> +<!--l. 1789--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">setenv</span><span +class="ec-lmtk-10"> TEXINPUTS</span><span +class="ec-lmtk-10"> /home/karl:</span> +</div> +</div> and a <span +class="ec-lmtt-10">TEXINPUTS </span>value from <span +class="ec-lmtt-10">texmf.cnf </span>of + <div class="alltt"> +<!--l. 1794--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> .:$TEXMF//tex</span> +</div> +</div> then the final value used for searching will be: + <div class="alltt"> +<!--l. 1799--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /home/karl:.:$TEXMF//tex</span> +</div> +</div> +<!--l. 1803--><p class="indent" > Since it would be useless to insert the default value in more than one place, Kpathsea changes only +one extra ‘<span +class="ec-lmtt-10">:</span>’ and leaves any others in place. It checks first for a leading ‘<span +class="ec-lmtt-10">:</span>’, then a trailing ‘<span +class="ec-lmtt-10">:</span>’, then a +doubled ‘<span +class="ec-lmtt-10">:</span>’. +<!--l. 1808--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.1.5 </span> <a + id="x1-580008.1.5"></a>Brace expansion</h5> +<!--l. 1810--><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>. +Nesting is allowed. This is used to implement multiple <span class="TEX">T<span +class="E">E</span>X</span> hierarchies, by assigning a brace list to +<span +class="ec-lmtt-10">$TEXMF</span>. For example, in <span +class="ec-lmtt-10">texmf.cnf</span>, the following definition (appproximately; there are actually even +more trees) is made: + + + <div class="verbatim"> + <div class="fancyvrb" id="fancyvrb16"> +<a + id="x1-58002r1"></a>    TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN} + </div> +</div> +<!--l. 1818--><p class="nopar" >Using this you can then write something like + + + <div class="verbatim"> + <div class="fancyvrb" id="fancyvrb17"> +<a + id="x1-58004r1"></a>    TEXINPUTS = .;$TEXMF/tex// + </div> +</div> +<!--l. 1822--><p class="nopar" >which means that, after looking in the current directory, the <span +class="ec-lmtt-10">$TEXMFHOME/tex</span>, <span +class="ec-lmtt-10">$TEXMFLOCAL/tex</span>, +<span +class="ec-lmtt-10">$TEXMFVAR/tex </span>and <span +class="ec-lmtt-10">$TEXMFMAIN/tex </span>trees <span +class="ec-lmri-10">only</span>) will be searched (the last two use using <span +class="ec-lmtt-10">ls-R </span>data base +files). It is a convenient way for running two parallel <span class="TEX">T<span +class="E">E</span>X</span> structures, one “frozen” (on a CD, for +instance) and the other being continuously updated with new versions as they become available. By +using the <span +class="ec-lmtt-10">$TEXMF </span>variable in all definitions, one is sure to always search the up-to-date tree +first. +<!--l. 1834--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.1.6 </span> <a + id="x1-590008.1.6"></a>Subdirectory expansion</h5> +<!--l. 1837--><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 +class="ec-lmro-10">d</span>: first those subdirectories directly under <span +class="ec-lmro-10">d</span>, then the subsubdirectories under those, +and so on. At each level, the order in which the directories are searched is <span +class="ec-lmri-10">unspecified</span>. +<!--l. 1843--><p class="indent" > If you specify any filename components after the ‘<span +class="ec-lmtt-10">//</span>’, only subdirectories with matching components +are included. For example, ‘<span +class="ec-lmtt-10">/a//b</span>’ expands into directories <span +class="ec-lmtt-10">/a/1/b</span>, <span +class="ec-lmtt-10">/a/2/b</span>, <span +class="ec-lmtt-10">/a/1/1/b</span>, and so on, but +not <span +class="ec-lmtt-10">/a/b/c </span>or <span +class="ec-lmtt-10">/a/1</span>. +<!--l. 1848--><p class="indent" > Multiple ‘<span +class="ec-lmtt-10">//</span>’ constructs in a path are possible, but ‘<span +class="ec-lmtt-10">//</span>’ at the beginning of a path is +ignored. +<!--l. 1851--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.1.7 </span> <a + id="x1-600008.1.7"></a>List of special characters and their meaning: a summary</h5> +<!--l. 1853--><p class="noindent" >The following list summarizes the special characters in Kpathsea configuration files. +<!--l. 1858--><p class="noindent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmtt-10">:</span> </dt><dd +class="list"> + <!--l. 1859--><p class="noindent" >Separator in path specification; at the beginning or the end of a path it substitutes the + default path expansion. + </dd><dt class="list"> + <span +class="ec-lmtt-10">;</span> </dt><dd +class="list"> + <!--l. 1861--><p class="noindent" >Separator on non-Unix systems (acts like <span +class="ec-lmtt-10">:</span>). + </dd><dt class="list"> + <span +class="ec-lmtt-10">$</span> </dt><dd +class="list"> + <!--l. 1862--><p class="noindent" >Variable expansion. + </dd><dt class="list"> + <span +class="ec-lmtt-10">~</span> </dt><dd +class="list"> + <!--l. 1863--><p class="noindent" >Represents the user’s home directory. + </dd><dt class="list"> + <span +class="ec-lmtt-10">{...}</span> </dt><dd +class="list"> + <!--l. 1864--><p class="noindent" >Brace expansion. + </dd><dt class="list"> + <span +class="ec-lmtt-10">//</span> </dt><dd +class="list"> + <!--l. 1865--><p class="noindent" >Subdirectory expansion (can occur anywhere in a path, except at its beginning). + + </dd><dt class="list"> + <span +class="ec-lmtt-10">%</span> </dt><dd +class="list"> + <!--l. 1867--><p class="noindent" >Start of comment. + </dd><dt class="list"> + <span +class="ec-lmtt-10">\</span> </dt><dd +class="list"> + <!--l. 1868--><p class="noindent" >Continuation character (allows multi-line entries). + </dd><dt class="list"> + <span +class="ec-lmtt-10">!!</span> </dt><dd +class="list"> + <!--l. 1869--><p class="noindent" >Search <span +class="ec-lmri-10">only </span>database to locate file, <span +class="ec-lmri-10">do not </span>search the disk.</dd></dl> +<!--l. 1874--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">8.2 </span> <a + id="x1-610008.2"></a>Filename databases</h4> +<!--l. 1877--><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 +can use an externally-built plain text “database” file named <span +class="ec-lmtt-10">ls-R </span>that maps files to directories, thus +avoiding the need to exhaustively search the disk. +<!--l. 1885--><p class="indent" > A second database file <span +class="ec-lmtt-10">aliases </span>allows you to give additional names to the files listed in <span +class="ec-lmtt-10">ls-R</span>. This +can be helpful to confirm to DOS 8.3 filename conventions in source files. +<!--l. 1889--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.2.1 </span> <a + id="x1-620008.2.1"></a>The filename database</h5> +<!--l. 1892--><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 +class="E">E</span>X</span> hierarchy in your installation that you wish to be searched (<span +class="ec-lmtt-10">$TEXMF </span>by +default); most sites have only one hierarchy. Kpathsea looks for <span +class="ec-lmtt-10">ls-R </span>files along the <span +class="ec-lmtt-10">TEXMFDBS</span> +path. +<!--l. 1898--><p class="indent" > The recommended way to create and maintain ‘<span +class="ec-lmtt-10">ls-R</span>’ is to run the <span +class="ec-lmtt-10">mktexlsr </span>script included with the +distribution. It is invoked by the various ‘<span +class="ec-lmtt-10">mktex</span>’… scripts. In principle, this script just runs the command +<div class="alltt"> +<!--l. 1902--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">cd</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmro-10">/your/texmf/root</span><span +class="ec-lmtt-10"> &&</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10">\ls</span><span +class="ec-lmtt-10"> -1LAR</span><span +class="ec-lmtt-10"> ./</span><span +class="ec-lmtt-10"> >ls-R</span> +</div> +</div> presuming your system’s <span +class="ec-lmtt-10">ls </span>produces the right output format (GNU <span +class="ec-lmtt-10">ls </span>is all right). To ensure that +the database is always up-to-date, it is easiest to rebuild it regularly via <span +class="ec-lmtt-10">cron</span>, so that it is +automatically updated when the installed files change, such as after installing or updating a <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> +package. +<!--l. 1911--><p class="indent" > If a file is not found in the database, by default Kpathsea goes ahead and searches the disk. If a +particular path element begins with ‘<span +class="ec-lmtt-10">!!</span>’, however, <span +class="ec-lmri-10">only </span>the database will be searched for that element, +never the disk. + + +<!--l. 1917--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.2.2 </span> <a + id="x1-630008.2.2"></a>kpsewhich: Standalone path searching</h5> +<!--l. 1920--><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 +class="ec-lmtt-10">find </span>program to locate files in <span class="TEX">T<span +class="E">E</span>X</span> hierarchies (this is used heavily in the distributed +‘<span +class="ec-lmtt-10">mktex</span>’… scripts). + <div class="alltt"> +<!--l. 1925--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> </span><span +class="ec-lmro-10">option</span><span +class="ec-lmtk-10">…</span><span +class="ec-lmtk-10"> </span><span +class="ec-lmro-10">filename</span><span +class="ec-lmtk-10">…</span> +</div> +</div> The options specified in <span +class="ec-lmro-10">option </span>start with either ‘<span +class="ec-lmtt-10">-</span>’ or ‘<span +class="ec-lmtt-10">--</span>’, and any unambiguous abbreviation is +accepted. +<!--l. 1931--><p class="indent" > Kpathsea looks up each non-option argument on the command line as a filename, and returns the +first file found. There is no option to return all the files with a particular name (you can run the Unix +‘<span +class="ec-lmtt-10">find</span>’ utility for that). +<!--l. 1936--><p class="indent" > The most common options are described next. +<!--l. 1938--><p class="noindent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmtt-10">--dpi=</span><span +class="ec-lmro-10">num</span> </dt><dd +class="list"> + <!--l. 1939--><p class="noindent" > Set the resolution to <span +class="ec-lmro-10">num</span>; this only affects ‘<span +class="ec-lmtt-10">gf</span>’ and ‘<span +class="ec-lmtt-10">pk</span>’ lookups. ‘<span +class="ec-lmtt-10">-D</span>’ is a synonym, for + compatibility with <span +class="ec-lmss-10">dvips</span>. Default is 600. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--format=</span><span +class="ec-lmro-10">name</span> </dt><dd +class="list"> + <!--l. 1944--><p class="noindent" ><br +class="newline" />Set the format for lookup to <span +class="ec-lmro-10">name</span>. By default, the format is guessed from the filename. For + formats which do not have an associated unambiguous suffix, such as MetaPost support files + and <span +class="ec-lmss-10">dvips </span>configuration files, you have to specify the name as known to Kpathsea, such as + <span +class="ec-lmtt-10">tex </span>or <span +class="ec-lmtt-10">enc files</span>. Run <span +class="ec-lmtt-10">kpsewhich --help </span>for a list. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--mode=</span><span +class="ec-lmro-10">string</span> </dt><dd +class="list"> + <!--l. 1952--><p class="noindent" ><br +class="newline" />Set the mode name to <span +class="ec-lmro-10">string</span>; this only affects ‘<span +class="ec-lmtt-10">gf</span>’ and ‘<span +class="ec-lmtt-10">pk</span>’ lookups. No default: any mode + will be found. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--must-exist</span> </dt><dd +class="list"> + <!--l. 1955--><p class="noindent" ><br +class="newline" />Do everything possible to find the files, notably including searching the disk. By default, + only the <span +class="ec-lmtt-10">ls-R </span>database is checked, in the interest of efficiency. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--path=</span><span +class="ec-lmro-10">string</span> </dt><dd +class="list"> + <!--l. 1959--><p class="noindent" ><br +class="newline" />Search along the path <span +class="ec-lmro-10">string </span>(colon-separated as usual), instead of guessing the search path + from the filename. ‘<span +class="ec-lmtt-10">//</span>’ and all the usual expansions are supported. The options ‘<span +class="ec-lmtt-10">--path</span>’ + and ‘<span +class="ec-lmtt-10">--format</span>’ are mutually exclusive. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--progname=</span><span +class="ec-lmro-10">name</span> </dt><dd +class="list"> + + + <!--l. 1964--><p class="noindent" ><br +class="newline" />Set the program name to <span +class="ec-lmro-10">name</span>. This can affect the search paths via the <span +class="ec-lmtt-10">.</span><span +class="ec-lmro-10">progname </span>feature. + The default is <span +class="ec-lmss-10">kpsewhich</span>. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--show-path=</span><span +class="ec-lmro-10">name</span> </dt><dd +class="list"> + <!--l. 1969--><p class="noindent" ><br +class="newline" />shows the path used for file lookups of file type <span +class="ec-lmro-10">name</span>. Either a filename extension (<span +class="ec-lmtt-10">.pk</span>, <span +class="ec-lmtt-10">.vf</span>, + etc.) or a name can be used, just as with ‘<span +class="ec-lmtt-10">--format</span>’ option. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--debug=</span><span +class="ec-lmro-10">num</span> </dt><dd +class="list"> + <!--l. 1973--><p class="noindent" ><br +class="newline" />sets the debugging options to <span +class="ec-lmro-10">num</span>.</dd></dl> +<!--l. 1978--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.2.3 </span> <a + id="x1-640008.2.3"></a>Examples of use</h5> +<!--l. 1981--><p class="noindent" >Let us now have a look at Kpathsea in action. Here’s a straightforward search: + <div class="alltt"> +<!--l. 1983--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> article.cls</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-dist/tex/latex/base/article.cls</span> +</div> +</div> We are looking for the file <span +class="ec-lmtt-10">article.cls</span>. Since the ‘<span +class="ec-lmtt-10">.cls</span>’ suffix is unambiguous we do not +need to specify that we want to look for a file of type <span +class="ec-lmtt-10">tex </span>(<span class="TEX">T<span +class="E">E</span>X</span> source file directories). We +find it in the subdirectory <span +class="ec-lmtt-10">tex/latex/base </span>below the ‘<span +class="ec-lmtt-10">texmf-dist</span>’ <span class="TEX">T<span +class="E">E</span>X</span> Live directory. +Similarly, all of the following are found without problems thanks to their unambiguous suffix. +<div class="alltt"> +<!--l. 1993--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> array.sty</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-dist/tex/latex/tools/array.sty</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> latin1.def</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-dist/tex/latex/base/latin1.def</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> size10.clo</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-dist/tex/latex/base/size10.clo</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> small2e.tex</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-dist/tex/latex/base/small2e.tex</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> tugboat.bib</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib</span> +</div> +</div> +<!--l. 2006--><p class="indent" > By the way, that last is a BibTeX bibliography database for <span +class="ec-lmro-10">TUGBoat </span>articles. + <div class="alltt"> +<!--l. 2008--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> cmr10.pk</span> + +</div> +</div> Font bitmap glyph files of type <span +class="ec-lmtt-10">.pk </span>are used by display programs like <span +class="ec-lmss-10">dvips </span>and <span +class="ec-lmss-10">xdvi</span>. Nothing is returned +in this case since there are no pre-generated Computer Modern ‘<span +class="ec-lmtt-10">.pk</span>’ files in <span class="TEX">T<span +class="E">E</span>X</span> Live — the Type 1 +variants are used by default. <div class="alltt"> +<!--l. 2015--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> wsuipa10.pk</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk</span> +</div> +</div> For these fonts (a phonetic alphabet from the University of Washington) we had to generate ‘<span +class="ec-lmtt-10">.pk</span>’ files, +and since the default Metafont mode on our installation is <span +class="ec-lmtt-10">ljfour </span>with a base resolution of 600dpi (dots +per inch), this instantiation is returned. <div class="alltt"> +<!--l. 2025--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> -dpi=300</span><span +class="ec-lmtk-10"> wsuipa10.pk</span> +</div> +</div> In this case, when specifying that we are interested in a resolution of 300dpi (<span +class="ec-lmtt-10">-dpi=300</span>) we see that no +such font is available on the system. A program like <span +class="ec-lmss-10">dvips </span>or <span +class="ec-lmss-10">xdvi </span>would go off and actually build the +required <span +class="ec-lmtt-10">.pk </span>files using the script <span +class="ec-lmss-10">mktexpk</span>. +<!--l. 2034--><p class="indent" > Next we turn our attention to <span +class="ec-lmss-10">dvips</span>’s header and configuration files. We first look at one of the +commonly used files, the general prologue <span +class="ec-lmtt-10">tex.pro </span>for <span class="TEX">T<span +class="E">E</span>X</span> support, before turning our attention to the +generic configuration file (<span +class="ec-lmtt-10">config.ps</span>) and the PostScript font map <span +class="ec-lmtt-10">psfonts.map </span>— as of 2004, map and +encoding files have their own search paths and new location in <span +class="ec-lmtt-10">texmf </span>trees. As the ‘<span +class="ec-lmtt-10">.ps</span>’ suffix is +ambiguous we have to specify explicitly which type we are considering (<span +class="ec-lmtt-10">dvips config</span>) for the file +<span +class="ec-lmtt-10">config.ps</span>. <div class="alltt"> +<!--l. 2043--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> tex.pro</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf/dvips/base/tex.pro</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> --format="dvips</span><span +class="ec-lmtk-10"> config"</span><span +class="ec-lmtk-10"> config.ps</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf/dvips/config/config.ps</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> psfonts.map</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map</span> +</div> +</div> +<!--l. 2052--><p class="indent" > We now take a closer look at the URW Times PostScript support files. The prefix for these in the +standard font naming scheme is ‘<span +class="ec-lmtt-10">utm</span>’. The first file we look at is the configuration file, which contains the +name of the map file: <div class="alltt"> +<!--l. 2056--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> --format="dvips</span><span +class="ec-lmtk-10"> config"</span><span +class="ec-lmtk-10"> config.utm</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-dist/dvips/psnfss/config.utm</span> +</div> +</div> The contents of that file is <div class="alltt"> +<!--l. 2061--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> p</span><span +class="ec-lmtt-10"> +utm.map</span> + +</div> +</div> which points to the file <span +class="ec-lmtt-10">utm.map</span>, which we want to locate next. <div class="alltt"> +<!--l. 2066--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> utm.map</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-dist/fonts/map/dvips/times/utm.map</span> +</div> +</div> This map file defines the file names of the Type 1 PostScript fonts in the URW collection. Its contents +look like (we only show part of the lines): <div class="alltt"> +<!--l. 2073--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">utmb8r</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> NimbusRomNo9L-Medi</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> ...</span><span +class="ec-lmtt-10"> <utmb8a.pfb</span> +<br /><span +class="ec-lmtt-10">utmbi8r</span><span +class="ec-lmtt-10"> NimbusRomNo9L-MediItal...</span><span +class="ec-lmtt-10"> <utmbi8a.pfb</span> +<br /><span +class="ec-lmtt-10">utmr8r</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> NimbusRomNo9L-Regu</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> ...</span><span +class="ec-lmtt-10"> <utmr8a.pfb</span> +<br /><span +class="ec-lmtt-10">utmri8r</span><span +class="ec-lmtt-10"> NimbusRomNo9L-ReguItal...</span><span +class="ec-lmtt-10"> <utmri8a.pfb</span> +<br /><span +class="ec-lmtt-10">utmbo8r</span><span +class="ec-lmtt-10"> NimbusRomNo9L-Medi</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> ...</span><span +class="ec-lmtt-10"> <utmb8a.pfb</span> +<br /><span +class="ec-lmtt-10">utmro8r</span><span +class="ec-lmtt-10"> NimbusRomNo9L-Regu</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> ...</span><span +class="ec-lmtt-10"> <utmr8a.pfb</span> +</div> +</div> Let us, for instance, take the Times Roman instance <span +class="ec-lmtt-10">utmr8a.pfb </span>and find its position in the <span +class="ec-lmtt-10">texmf</span> +directory tree with a search for Type 1 font files: <div class="alltt"> +<!--l. 2084--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> utmr8a.pfb</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb</span> +</div> +</div> +<!--l. 2091--><p class="indent" > It should be evident from these examples how you can easily locate the whereabouts of a given file. +This is especially important if you suspect that the wrong version of a file is picked up somehow, since +<span +class="ec-lmss-10">kpsewhich </span>will show you the first file encountered. +<!--l. 2096--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.2.4 </span> <a + id="x1-650008.2.4"></a>Debugging actions</h5> +<!--l. 2099--><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. 2103--><p class="noindent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmtt-10"> 1</span> </dt><dd +class="list"> + <!--l. 2104--><p class="noindent" ><span +class="ec-lmtt-10">stat </span>calls (disk lookups). When running with an up-to-date <span +class="ec-lmtt-10">ls-R </span>database this should almost + give no output. + </dd><dt class="list"> + <span +class="ec-lmtt-10"> 2</span> </dt><dd +class="list"> + <!--l. 2107--><p class="noindent" >References to hash tables (such as <span +class="ec-lmtt-10">ls-R </span>databases, map files, configuration files). + </dd><dt class="list"> + <span +class="ec-lmtt-10"> 4</span> </dt><dd +class="list"> + <!--l. 2109--><p class="noindent" >File open and close operations. + + + </dd><dt class="list"> + <span +class="ec-lmtt-10"> 8</span> </dt><dd +class="list"> + <!--l. 2110--><p class="noindent" >General path information for file types searched by Kpathsea. This is useful to find out where + a particular path for the file was defined. + </dd><dt class="list"> + <span +class="ec-lmtt-10">16</span> </dt><dd +class="list"> + <!--l. 2113--><p class="noindent" >Directory list for each path element (only relevant for searches on disk). + </dd><dt class="list"> + <span +class="ec-lmtt-10">32</span> </dt><dd +class="list"> + <!--l. 2115--><p class="noindent" >File searches. + </dd><dt class="list"> + <span +class="ec-lmtt-10">64</span> </dt><dd +class="list"> + <!--l. 2116--><p class="noindent" >Variable values.</dd></dl> +<!--l. 2118--><p class="noindent" >A value of <span +class="ec-lmtt-10">-1 </span>will set all the above options; in practice, this is usually the most convenient. +<!--l. 2121--><p class="indent" > Similarly, with the <span +class="ec-lmss-10">dvips </span>program, by setting a combination of debug switches, one can follow in detail +where files are being picked up from. Alternatively, when a file is not found, the debug trace shows in +which directories the program looks for the given file, so that one can get an indication what the +problem is. +<!--l. 2127--><p class="indent" > Generally speaking, as most programs call the Kpathsea library internally, one can select a debug +option by using the <span +class="ec-lmtt-10">KPATHSEA_DEBUG </span>environment variable, and setting it to (a combination of) values as +described in the above list. +<!--l. 2132--><p class="indent" > (Note for Windows users: it is not easy to redirect all messages to a file in this system. For diagnostic +purposes you can temporarily <span +class="ec-lmtt-10">SET KPATHSEA_DEBUG_OUTPUT=err.log</span>). +<!--l. 2136--><p class="indent" > Let us consider, as an example, a small <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> source file, <span +class="ec-lmtt-10">hello-world.tex</span>, which contains the +following input. + + + <div class="verbatim"> + <div class="fancyvrb" id="fancyvrb18"> +<a + id="x1-65002r1"></a>    \documentclass{article} +<br class="fancyvrb" /><a + id="x1-65004r2"></a>    \begin{document} +<br class="fancyvrb" /><a + id="x1-65006r3"></a>    Hello World! +<br class="fancyvrb" /><a + id="x1-65008r4"></a>    \end{document} + </div> +</div> +<!--l. 2143--><p class="nopar" >This little file only uses the font <span +class="ec-lmtt-10">cmr10</span>, so let us look at how <span +class="ec-lmss-10">dvips </span>prepares the PostScript file (we +want to use the Type 1 version of the Computer Modern fonts, hence the option <span +class="ec-lmtt-10">-Pcms</span>). +<div class="alltt"> +<!--l. 2147--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">dvips</span><span +class="ec-lmtk-10"> -d4100</span><span +class="ec-lmtk-10"> hello-world</span><span +class="ec-lmtk-10"> -Pcms</span><span +class="ec-lmtk-10"> -o</span> +</div> +</div> In this case we have combined <span +class="ec-lmss-10">dvips</span>’s debug class 4 (font paths) with Kpathsea’s path element +expansion (see <span +class="ec-lmss-10">dvips </span>Reference Manual, <a +href="../../../../texmf/doc/dvips/dvips.pdf" >texmf/doc/dvips/dvips.pdf</a>). The output (slightly rearranged) +appears in Figure <a +href="#x1-65031r11">11<!--tex4ht:ref: fig:dvipsdbga --></a>. +<!--l. 2155--><p class="indent" > <a + id="x1-65031r11"></a><a + id="x1-65036r12"></a><a + id="x1-65049r13"></a><hr class="float"><div class="float" +><table class="float"><tr class="float"><td class="float" +> + + +<div class="BVerbatimInput"> +<span +class="ec-lmtt-9">debug:start</span><span +class="ec-lmtt-9"> search(file=texmf.cnf,</span><span +class="ec-lmtt-9"> must_exist=1,</span><span +class="ec-lmtt-9"> find_all=1,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:/usr/local/bin/texlive:/usr/local/bin:</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> /usr/local/bin/texmf/web2c:/usr/local:</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> /usr/local/texmf/web2c:/.:/./teTeX/TeX/texmf/web2c:).</span> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=ls-R,</span><span +class="ec-lmtt-9"> must_exist=1,</span><span +class="ec-lmtt-9"> find_all=1,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=~/tex:/usr/local/texmf).</span> +<br /><span +class="ec-lmtt-9">kdebug:search(ls-R)</span><span +class="ec-lmtt-9"> =>/usr/local/texmf/ls-R</span> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=aliases,</span><span +class="ec-lmtt-9"> must_exist=1,</span><span +class="ec-lmtt-9"> find_all=1,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=~/tex:/usr/local/texmf).</span> +<br /><span +class="ec-lmtt-9">kdebug:search(aliases)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/aliases</span> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=config.ps,</span><span +class="ec-lmtt-9"> must_exist=0,</span><span +class="ec-lmtt-9"> find_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex:!!/usr/local/texmf/dvips//).</span> +<br /><span +class="ec-lmtt-9">kdebug:search(config.ps)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/dvips/config/config.ps</span> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=/root/.dvipsrc,</span><span +class="ec-lmtt-9"> must_exist=0,</span><span +class="ec-lmtt-9"> find_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex:!!/usr/local/texmf/dvips//).</span> +<br /><span +class="ec-lmtt-9">search(file=/home/goossens/.dvipsrc,</span><span +class="ec-lmtt-9"> must_exist=1,</span><span +class="ec-lmtt-9"> find_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).</span> +<br /><span +class="ec-lmtt-9">kdebug:search($HOME/.dvipsrc)</span><span +class="ec-lmtt-9"> =></span> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=config.cms,</span><span +class="ec-lmtt-9"> must_exist=0,</span><span +class="ec-lmtt-9"> find_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).</span> +<br /><span +class="ec-lmtt-9">kdebug:search(config.cms)</span> +<br /><span +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 11: </td><td +class="content">Finding configuration files</td></tr></table><!--tex4ht:label?: x1-65031r11 --> +<div class="BVerbatimInput"> +<span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=texc.pro,</span><span +class="ec-lmtt-9"> must\_exist=0,</span><span +class="ec-lmtt-9"> find\_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).</span> +<br /><span +class="ec-lmtt-9">kdebug:search(texc.pro)</span><span +class="ec-lmtt-9"> =></span><span +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 12: </td><td +class="content">Finding the prolog file</td></tr></table><!--tex4ht:label?: x1-65036r12 --> +<div class="BVerbatimInput"> +<span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=cmr10.tfm,</span><span +class="ec-lmtt-9"> must\_exist=1,</span><span +class="ec-lmtt-9"> find\_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> /var/tex/fonts/tfm//).</span> +<br /><span +class="ec-lmtt-9">kdebug:search(cmr10.tfm)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm</span> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=texps.pro,</span><span +class="ec-lmtt-9"> must\_exist=0,</span><span +class="ec-lmtt-9"> find\_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ...</span> +<br /><span +class="ec-lmtt-9"><texps.pro></span> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=cmr10.pfb,</span><span +class="ec-lmtt-9"> must\_exist=0,</span><span +class="ec-lmtt-9"> find\_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).</span> +<br /><span +class="ec-lmtt-9">kdebug:search(cmr10.pfb)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb</span> +<br /><span +class="ec-lmtt-9"><cmr10.pfb>[1]</span> +</div> + <table class="caption" +><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 13: </td><td +class="content">Finding the font file</td></tr></table><!--tex4ht:label?: x1-65049r13 --> + + + </td></tr></table></div><hr class="endfloat" /> +<!--l. 2171--><p class="indent" > <span +class="ec-lmss-10">dvips </span>starts by locating its working files. First, <span +class="ec-lmtt-10">texmf.cnf </span>is found, which gives the definitions of the +search paths for the other files, then the file database <span +class="ec-lmtt-10">ls-R </span>(to optimize file searching) and the file +<span +class="ec-lmtt-10">aliases</span>, which makes it possible to declare several names (e.g., a short DOS-like 8.3 and a more natural +longer version) for the same file. Then <span +class="ec-lmss-10">dvips </span>goes on to find the generic configuration file <span +class="ec-lmtt-10">config.ps</span> +before looking for the customization file <span +class="ec-lmtt-10">.dvipsrc </span>(which, in this case is <span +class="ec-lmri-10">not found</span>). Finally, <span +class="ec-lmss-10">dvips </span>locates +the config file for the Computer Modern PostScript fonts <span +class="ec-lmtt-10">config.cms </span>(this was initiated +with the <span +class="ec-lmtt-10">-Pcms </span>option on the <span +class="ec-lmss-10">dvips </span>command). This file contains the list of the map files +which define the relation between the <span class="TEX">T<span +class="E">E</span>X</span>, PostScript and file system names of the fonts. +<div class="alltt"> +<!--l. 2185--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">more</span><span +class="ec-lmtk-10"> /usr/local/texmf/dvips/cms/config.cms</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> p</span><span +class="ec-lmtt-10"> +ams.map</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> p</span><span +class="ec-lmtt-10"> +cms.map</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> p</span><span +class="ec-lmtt-10"> +cmbkm.map</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> p</span><span +class="ec-lmtt-10"> +amsbkm.map</span> +</div> +</div> <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-640008.2.3">8.2.3<!--tex4ht:ref: sec:examples-of-use --></a> for more +details about PostScript map file handling). +<!--l. 2198--><p class="indent" > At this point <span +class="ec-lmss-10">dvips </span>identifies itself to the user: <div class="alltt"> +<!--l. 2199--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">This</span><span +class="ec-lmtt-10"> is</span><span +class="ec-lmtt-10"> dvips(k)</span><span +class="ec-lmtt-10"> 5.92b</span><span +class="ec-lmtt-10"> Copyright</span><span +class="ec-lmtt-10"> 2002</span><span +class="ec-lmtt-10"> Radical</span><span +class="ec-lmtt-10"> Eye</span><span +class="ec-lmtt-10"> Software</span><span +class="ec-lmtt-10"> (www.radicaleye.com)</span> +</div> +</div> Then it goes on to look for the prolog file <span +class="ec-lmtt-10">texc.pro</span>: <div class="alltt"> +<!--l. 2204--><p class="noindent" ><div class="obeylines-v"> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=texc.pro,</span><span +class="ec-lmtt-9"> must_exist=0,</span><span +class="ec-lmtt-9"> find_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).</span> +<br /><span +class="ec-lmtt-9">kdebug:search(texc.pro)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/dvips/base/texc.pro</span> +</div> +</div> +<!--l. 2215--><p class="indent" > After having found the file in question, <span +class="ec-lmss-10">dvips </span>outputs the date and time, and informs us that it will +generate the file <span +class="ec-lmtt-10">hello-world.ps</span>, then that it needs the font file <span +class="ec-lmtt-10">cmr10</span>, and that the latter is declared +as “resident” (no bitmaps needed): <div class="alltt"> +<!--l. 2220--><p class="noindent" ><div class="obeylines-v"> +<br /><span +class="ec-lmtt-9">TeX</span><span +class="ec-lmtt-9"> output</span><span +class="ec-lmtt-9"> 1998.02.26:1204’</span><span +class="ec-lmtt-9"> -></span><span +class="ec-lmtt-9"> hello-world.ps</span> +<br /><span +class="ec-lmtt-9">Defining</span><span +class="ec-lmtt-9"> font</span><span +class="ec-lmtt-9"> ()</span><span +class="ec-lmtt-9"> cmr10</span><span +class="ec-lmtt-9"> at</span><span +class="ec-lmtt-9"> 10.0pt</span> +<br /><span +class="ec-lmtt-9">Font</span><span +class="ec-lmtt-9"> cmr10</span><span +class="ec-lmtt-9"> <CMR10></span><span +class="ec-lmtt-9"> is</span><span +class="ec-lmtt-9"> resident.</span> +</div> +</div> Now the search is on for the file <span +class="ec-lmtt-10">cmr10.tfm</span>, which is found, then a few more prolog files (not shown) are +referenced, and finally the Type 1 instance <span +class="ec-lmtt-10">cmr10.pfb </span>of the font is located and included in the output +file (see last line). <div class="alltt"> + + +<!--l. 2229--><p class="noindent" ><div class="obeylines-v"> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=cmr10.tfm,</span><span +class="ec-lmtt-9"> must_exist=1,</span><span +class="ec-lmtt-9"> find_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> /var/tex/fonts/tfm//).</span> +<br /><span +class="ec-lmtt-9">kdebug:search(cmr10.tfm)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm</span> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=texps.pro,</span><span +class="ec-lmtt-9"> must_exist=0,</span><span +class="ec-lmtt-9"> find_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ...</span> +<br /><span +class="ec-lmtt-9"><texps.pro></span> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=cmr10.pfb,</span><span +class="ec-lmtt-9"> must_exist=0,</span><span +class="ec-lmtt-9"> find_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).</span> +<br /><span +class="ec-lmtt-9">kdebug:search(cmr10.pfb)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb</span> +<br /><span +class="ec-lmtt-9"><cmr10.pfb>[1]</span> +</div> +</div> + <h4 class="subsectionHead"><span class="titlemark">8.3 </span> <a + id="x1-660008.3"></a>Runtime options</h4> +<!--l. 2246--><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 +settings can be found in Part 3 of that file in the <span class="TEX">T<span +class="E">E</span>X</span> Live distribution. The more important +are: +<!--l. 2252--><p class="noindent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmtt-10">main_memory</span> </dt><dd +class="list"> + <!--l. 2253--><p class="noindent" >Total words of memory available, for <span class="TEX">T<span +class="E">E</span>X</span>, Metafont and MetaPost. You must make a new + format file for each different setting. For instance, you could generate a “huge” version of + <span class="TEX">T<span +class="E">E</span>X</span>, and call the format file <span +class="ec-lmtt-10">hugetex.fmt</span>. Using the standard way of specifying the program + name used by Kpathsea, the particular value of the <span +class="ec-lmtt-10">main_memory </span>variable will then be read + from <span +class="ec-lmtt-10">texmf.cnf</span>. + </dd><dt class="list"> + <span +class="ec-lmtt-10">extra_mem_bot</span> </dt><dd +class="list"> + <!--l. 2261--><p class="noindent" >Extra space for “large” <span class="TEX">T<span +class="E">E</span>X</span> data structures: boxes, glue, breakpoints, etc. Especially useful + if you use PI C<span class="TEX">T<span +class="E">E</span>X</span>. + </dd><dt class="list"> + <span +class="ec-lmtt-10">font_mem_size</span> </dt><dd +class="list"> + <!--l. 2265--><p class="noindent" >Number of words for font information available for <span class="TEX">T<span +class="E">E</span>X</span>. This is more or less the total size + of all TFM files read. + </dd><dt class="list"> + <span +class="ec-lmtt-10">hash_extra</span> </dt><dd +class="list"> + <!--l. 2268--><p class="noindent" >Additional space for the hash table of control sequence names. Only <span +class="lmsy-10">≈</span>10,000 control + sequences can be stored in the main hash table; if you have a large book with numerous + cross-references, this might not be enough. The default value of <span +class="ec-lmtt-10">hash_extra </span>is <span +class="ec-lmtt-10">50000</span>.</dd></dl> +<!--l. 2276--><p class="noindent" >Of course, this facility is no substitute for truly dynamic arrays and memory allocation, but since these +are extremely difficult to implement in the present <span class="TEX">T<span +class="E">E</span>X</span> source, these runtime parameters provide a +practical compromise allowing some flexibility. +<!--l. 2384--><p class="indent" > <a id="ack"></a> + + + <h3 class="sectionHead"><span class="titlemark">9 </span> <a + id="x1-670009"></a>Acknowledgements</h3> +<!--l. 2387--><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 +class="E">E</span>X</span> Live +was overseen by Karl Berry. The other principal contributors, past and present, are listed +below. + <ul class="itemize1"> + <li class="itemize">The English, German, Dutch, and Polish <span class="TEX">T<span +class="E">E</span>X</span> user groups (TUG, DANTE e.V., NTG, and + GUST, respectively), which provide the necessary + technical and administrative infrastructure. Please join the <span class="TEX">T<span +class="E">E</span>X</span> user group near you! (See + <a +href="http://tug.org/usergroups.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/usergroups.html</span></a>.) + </li> + <li class="itemize">The CTAN team, most notably Robin Fairbairns, Jim Hefferon, and Rainer Schöpf, which + distributes the <span class="TEX">T<span +class="E">E</span>X</span> Live images and provides the common infrastructure for package + updates, upon which <span class="TEX">T<span +class="E">E</span>X</span> Live depends. + </li> + <li class="itemize">Peter Breitenlohner (and the e-<span class="TEX">T<span +class="E">E</span>X</span> team) for the stable foundation of future <span class="TEX">T<span +class="E">E</span>X</span>’s, and + Peter specifically for stellar help with the GNU autotools usage throughout <span class="TEX">T<span +class="E">E</span>X</span> Live. + </li> + <li class="itemize">Thomas Esser, without whose marvelous te<span class="TEX">T<span +class="E">E</span>X</span> package <span class="TEX">T<span +class="E">E</span>X</span> Live would have never existed. + </li> + <li class="itemize">Michel Goossens, who co-authored the original documentation. + </li> + <li class="itemize">Eitan Gurari, whose <span class="TEX">T<span +class="E">E</span>X</span>4ht was used to create the HTML version of this documentation, + and who worked tirelessly to improve it at short notice. + </li> + <li class="itemize">Hàn Thế Thành, Martin Schröder, and the pdf<span class="TEX">T<span +class="E">E</span>X</span> team (<a +href="http://pdftex.org" class="url" ><span +class="ec-lmtt-10">http://pdftex.org</span></a>) for + continuing enhancements of <span class="TEX">T<span +class="E">E</span>X</span>’s abilities. + </li> + <li class="itemize">Hans Hagen, for much testing and making his Con<span class="TEX">T<span +class="E">E</span>X</span>t format (<a +href="http://pragma-ade.com" class="url" ><span +class="ec-lmtt-10">http://pragma-ade.com</span></a>) + work within <span class="TEX">T<span +class="E">E</span>X</span> Live’s framework. + </li> + <li class="itemize">Hartmut Henkel, for significant development contributions to pdf<span class="TEX">T<span +class="E">E</span>X</span> Lua<span class="TEX">T<span +class="E">E</span>X</span>, and more. + </li> + <li class="itemize">Taco Hoekwater, for + renewed development efforts on MetaPost and (Lua)<span class="TEX">T<span +class="E">E</span>X</span> (<a +href="http://luatex.org" class="url" ><span +class="ec-lmtt-10">http://luatex.org</span></a>) itself, and + for incorporating Con<span class="TEX">T<span +class="E">E</span>X</span>t into <span class="TEX">T<span +class="E">E</span>X</span> Live. + </li> + <li class="itemize">Paweł Jackowski, for the Windows installer <span +class="ec-lmss-10">tlpm</span>, and Tomasz Łuczak, for <span +class="ec-lmss-10">tlpmgui</span>, used in + past releases. + </li> + <li class="itemize">Akira Kakuto, for providing the Windows binaries from his W32TEX distribution for + Japanese <span class="TEX">T<span +class="E">E</span>X</span> (<a +href="http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/" class="url" ><span +class="ec-lmtt-10">http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/</span></a>), and many + other contributions. + </li> + <li class="itemize">Jonathan Kew and SIL, for the major new development of Xe<span class="TEX">T<span +class="E">E</span>X</span> and taking the time and + trouble to integrate it in <span class="TEX">T<span +class="E">E</span>X</span> Live, as well as the initial version of the Mac<span class="TEX">T<span +class="E">E</span>X</span> installer. + </li> + <li class="itemize">Dick Koch, for maintaining Mac<span class="TEX">T<span +class="E">E</span>X</span> (<a +href="http://tug.org/mactex" class="url" ><span +class="ec-lmtt-10">http://tug.org/mactex</span></a>) in very close tandem with + <span class="TEX">T<span +class="E">E</span>X</span> Live, and for his great good cheer in doing so. + </li> + + + <li class="itemize">Reinhard Kotucha, for major contributions to the <span class="TEX">T<span +class="E">E</span>X</span> Live 2008 infrastructure and installer, + as well as Windows research efforts, the <span +class="ec-lmtt-10">getnonfreefonts </span>script, and more. + </li> + <li class="itemize">Siep Kroonenberg, also for major contributions to the <span class="TEX">T<span +class="E">E</span>X</span> Live 2008 infrastructure and + installer, especially on Windows, and for the bulk of work updating this manual describing + the new features. + </li> + <li class="itemize">Petr Olšak, who coordinated and checked all the Czech and Slovak material very carefully. + </li> + <li class="itemize">Toshio Oshima, for his <span +class="ec-lmss-10">dviout </span>previewer for Windows. + </li> + <li class="itemize">Manuel Pégourié-Gonnard, for helping with package updates, documentation improvements, + and <span +class="ec-lmss-10">tldoc </span>development. + </li> + <li class="itemize">Fabrice Popineau, for the original Windows support in <span class="TEX">T<span +class="E">E</span>X</span> Live and work on the French + documentation. + </li> + <li class="itemize">Norbert Preining, the principal architect of the <span class="TEX">T<span +class="E">E</span>X</span> Live 2008 infrastructure and installer, + and also for coordinating the Debian version of <span class="TEX">T<span +class="E">E</span>X</span> Live (together with Frank Küster), + making many suggestions along the way. + </li> + <li class="itemize">Sebastian Rahtz, for originally creating <span class="TEX">T<span +class="E">E</span>X</span> Live and maintaining it for many years. + </li> + <li class="itemize">Vladimir Volovich, for substantial help with porting and other maintenance issues, and + especially for making it feasible to include <span +class="ec-lmss-10">xindy</span>. + </li> + <li class="itemize">Staszek Wawrykiewicz, the principal tester for all of <span class="TEX">T<span +class="E">E</span>X</span> Live, and coordinator of the many + major Polish contributions: fonts, Windows installation, and more. + </li> + <li class="itemize">Olaf Weber, for his patient maintenance of Web2C. + </li> + <li class="itemize">Gerben Wierda, for creating and maintaining the Mac OS X support, and much integration + and testing. + </li> + <li class="itemize">Graham Williams, on whose work the <span class="TEX">T<span +class="E">E</span>X</span> Catalogue of packages depends. + </li></ul> +<!--l. 2490--><p class="indent" > Builders of the binaries: Reinhard Kotucha (<span +class="ec-lmss-10">x86_64-linux</span>), Tim Arnold (<span +class="ec-lmss-10">hppa-hpux</span>), Randy Au +(<span +class="ec-lmss-10">amd64-freebsd</span>), Edd Barrett (<span +class="ec-lmss-10">i386-openbsd</span>), Karl Berry (<span +class="ec-lmss-10">i386-linux</span>), Akira Kakuto (<span +class="ec-lmss-10">win32</span>), Dick Koch +(<span +class="ec-lmss-10">universal-darwin</span>), Manfred Lotz (<span +class="ec-lmss-10">i386-freebsd</span>), Norbert Preining (<span +class="ec-lmss-10">alpha-linux</span>), Arthur Reutenauer +(<span +class="ec-lmss-10">sparc-linux</span>), Thomas Schmitz (<span +class="ec-lmss-10">powerpc-linux</span>), Apostolos Syropoulos (<span +class="ec-lmss-10">i386-solaris</span>), Vladimir Volovich +(<span +class="ec-lmss-10">powerpc-aix</span>, <span +class="ec-lmss-10">sparc-solaris</span>), Olaf Weber (<span +class="ec-lmss-10">mips-irix</span>). For information on the <span class="TEX">T<span +class="E">E</span>X</span> Live build process, see +<a +href="http://tug.org/texlive/build.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/build.html</span></a>. +<!--l. 2508--><p class="indent" > Documentation and translation updates: Karl Berry (English), Daniel Flipo (French), Klaus Höppner +(German), Petr Sojka & Jan Busa (Czech/Slovak), Boris Veytsman (Russian), Staszek Wawrykiewicz +(Polish). The <span class="TEX">T<span +class="E">E</span>X</span> Live documentation web page is <a +href="http://tug.org/texlive/doc.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/doc.html</span></a>. +<!--l. 2517--><p class="indent" > Of course the most important acknowledgement must go to Donald Knuth, first for inventing <span class="TEX">T<span +class="E">E</span>X</span>, +and then for giving it to the world. +<!--l. 2522--><p class="noindent" > + + + <h3 class="sectionHead"><span class="titlemark">10 </span> <a + id="x1-6800010"></a>Release history</h3> +<!--l. 2525--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.1 </span> <a + id="x1-6900010.1"></a>Past</h4> +<!--l. 2527--><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 +for MS-DOS users, and it was hoped at that time to issue a single, rational, CD for all systems. +This was too ambitious a target for the time, but it did spawn not only the very successful +4All<span class="TEX">T<span +class="E">E</span>X</span> CD, but also the TUG Technical Council working group on a <span class="TEX"><span +class="ec-lmri-10">T</span><span +class="E"><span +class="ec-lmri-10">E</span></span><span +class="ec-lmri-10">X</span></span> <span +class="ec-lmri-10">Directory Structure</span> +(<a +href="http://tug.org/tds" class="url" ><span +class="ec-lmtt-10">http://tug.org/tds</span></a>), which specified how to create consistent and manageable collections of +<span class="TEX">T<span +class="E">E</span>X</span> support files. A complete draft of the TDS was published in the December 1995 issue +of <span +class="ec-lmro-10">TUGboat</span>, and it was clear from an early stage that one desirable product would be a +model structure on CD. The distribution you now have is a very direct result of the working +group’s deliberations. It was also clear that the success of the 4All<span class="TEX">T<span +class="E">E</span>X</span> CD showed that Unix +users would benefit from a similarly easy system, and this is the other main strand of <span class="TEX">T<span +class="E">E</span>X</span> +Live. +<!--l. 2543--><p class="indent" > We first undertook to make a new Unix-based TDS CD in the autumn of 1995, and quickly identified +Thomas Esser’s te<span class="TEX">T<span +class="E">E</span>X</span> as the ideal setup, as it already had multi-platform support and was built with +portability across file systems in mind. Thomas agreed to help, and work began seriously at the start of +1996. The first edition was released in May 1996. At the start of 1997, Karl Berry completed a major new +release of Web2c, which included nearly all the features which Thomas Esser had added in te<span class="TEX">T<span +class="E">E</span>X</span>, and +we decided to base the 2nd edition of the CD on the standard Web2C, with the addition of te<span class="TEX">T<span +class="E">E</span>X</span>’s +<span +class="ec-lmtt-10">texconfig </span>script. The 3rd edition of the CD was based on a major revision of Web2C, 7.2, by Olaf +Weber; at the same time, a new revision of te<span class="TEX">T<span +class="E">E</span>X</span> was being made, and <span class="TEX">T<span +class="E">E</span>X</span> Live included +almost all of its features. The 4th edition followed the same pattern, using a new version of +te<span class="TEX">T<span +class="E">E</span>X</span>, and a new release of Web2C (7.3). The system now included a complete Windows +setup. +<!--l. 2559--><p class="indent" > For the 5th edition (March 2000) many parts of the CD were revised and checked, updating hundreds +of packages. Package details were stored in XML files. But the major change for <span class="TEX">T<span +class="E">E</span>X</span> Live 5 was that all +non-free software was removed. Everything in <span class="TEX">T<span +class="E">E</span>X</span> Live is now intended to be compatible with the +Debian Free Software Guidelines (<a +href="http://www.debian.org/intro/free" class="url" ><span +class="ec-lmtt-10">http://www.debian.org/intro/free</span></a>); we have done our best to +check the license conditions of all packages, but we would very much appreciate hearing of any +mistakes. +<!--l. 2568--><p class="indent" > The 6th edition (July 2001) had much more material updated. The major change was a new install +concept: the user could select a more exact set of needed collections. Language-related collections were +completely reorganized, so selecting any of them installs not only macros, fonts, etc., but also prepares an +appropriate <span +class="ec-lmtt-10">language.dat</span>. +<!--l. 2574--><p class="indent" > The 7th edition of 2002 had the notable addition of Mac OS X support, and the usual myriad of +updates to all sorts of packages and programs. An important goal was integration of the source back with +te<span class="TEX">T<span +class="E">E</span>X</span>, to correct the drift apart in versions 5 and 6. +<!--l. 2579--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">10.1.1 </span> <a + id="x1-7000010.1.1"></a>2003</h5> +<!--l. 2581--><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:tl-coll-dists --></a>, p. <a +href="#x1-80002.1">7<!--tex4ht:ref: sec:tl-coll-dists --></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 +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">11<!--tex4ht:ref: text:etex --></a>). + + </li> + <li class="itemize">The new Latin Modern fonts were included (and are recommended). + </li> + <li class="itemize">Support for Alpha OSF was removed (HPUX support was removed previously), since no one + had (or volunteered) hardware available on which to compile new binaries. + </li> + <li class="itemize">Windows setup was substantially changed; for the first time an integrated environment based + on XEmacs was introduced. + </li> + <li class="itemize">Important supplementary programs for Windows (Perl, Ghostscript, ImageMagick, Ispell) + are now installed in the <span class="TEX">T<span +class="E">E</span>X</span> Live installation directory. + </li> + <li class="itemize">Font map files used by <span +class="ec-lmss-10">dvips</span>, <span +class="ec-lmss-10">dvipdfm </span>and <span +class="ec-lmss-10">pdftex </span>are now generated by the new program + <span +class="ec-lmss-10">updmap </span>and installed into <span +class="ec-lmtt-10">texmf/fonts/map</span>. + </li> + <li class="itemize"><span class="TEX">T<span +class="E">E</span>X</span>, Metafont, and MetaPost now, by default, output most input characters (32 and above) + as themselves in output (e.g., <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\write</span></span></span>) files, log files, and the terminal, i.e., <span +class="ec-lmri-10">not </span>translated + using the <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">^^</span></span></span> notation. In <span class="TEX">T<span +class="E">E</span>X</span> Live 7, this translation was dependent on the system locale + settings; now, locale settings do not influence the <span class="TEX">T<span +class="E">E</span>X</span> programs’ behavior. If for some reason + you need the <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">^^</span></span></span> output, rename the file <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">texmf/web2c/cp8bit.tcx</span></span></span>. (Future releases will + have cleaner ways to control this.) + </li> + <li class="itemize">This documentation was substantially revised. + </li> + <li class="itemize">Finally, since the edition numbers had grown unwieldy, the version is now simply identified + by the year: <span class="TEX">T<span +class="E">E</span>X</span> Live 2003.</li></ul> +<!--l. 2619--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">10.1.2 </span> <a + id="x1-7100010.1.2"></a>2004</h5> +<!--l. 2621--><p class="noindent" >2004 saw many changes: + <ul class="itemize1"> + <li class="itemize">If you have locally-installed fonts which use their own <span +class="ec-lmtt-10">.map </span>or (much less likely) <span +class="ec-lmtt-10">.enc </span>support + files, you may need to move those support files. + <!--l. 2629--><p class="noindent" ><span +class="ec-lmtt-10">.map </span>files are now searched for in subdirectories of <span +class="ec-lmtt-10">fonts/map </span>only (in each <span +class="ec-lmtt-10">texmf </span>tree), + along the <span +class="ec-lmtt-10">TEXFONTMAPS </span>path. Similarly, <span +class="ec-lmtt-10">.enc </span>files are now searched for in subdirectories of + <span +class="ec-lmtt-10">fonts/enc </span>only, along the <span +class="ec-lmtt-10">ENCFONTS </span>path. <span +class="ec-lmss-10">updmap </span>will attempt to warn about problematic + files. + <!--l. 2636--><p class="noindent" >For methods of handling this and other information, please see + <a +href="http://tug.org/texlive/mapenc.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/mapenc.html</span></a>. + </li> + <li class="itemize">The <span class="TEX">T<span +class="E">E</span>X</span> Collection 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:overview-tl --></a> (p. <a +href="#x1-70002">7<!--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 +class="ec-lmtt-10">texmf </span>tree of previous releases has been replaced by three: + <span +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 +class="ec-lmtt-10">README </span>files for each. + + + </li> + <li class="itemize">All <span class="TEX">T<span +class="E">E</span>X</span>-related input files are now collected in the <span +class="ec-lmtt-10">tex </span>subdirectory of <span +class="ec-lmtt-10">texmf* </span>trees, + rather than having separate sibling directories <span +class="ec-lmtt-10">tex</span>, <span +class="ec-lmtt-10">etex</span>, <span +class="ec-lmtt-10">pdftex</span>, <span +class="ec-lmtt-10">pdfetex</span>, etc. See + <a +href="../../../../texmf-doc/doc/english/tds/tds.html#Extensions" ><span +class="ec-lmtt-10">texmf-doc/doc/english/tds/tds.html#Extensions</span></a>. + </li> + <li class="itemize">Helper scripts (not meant to be invoked by users) are now located in a new <span +class="ec-lmtt-10">scripts</span> + directory of <span +class="ec-lmtt-10">texmf* </span>trees, and searched for via <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">kpsewhich</span><span +class="ec-lmtt-10"> -format=texmfscripts</span></span></span>. + So if you have programs which call such scripts, they’ll need to be adjusted. See + <a +href="../../../../texmf-doc/doc/english/tds/tds.html#Scripts" ><span +class="ec-lmtt-10">texmf-doc/doc/english/tds/tds.html#Scripts</span></a>. + </li> + <li class="itemize">Almost all formats leave most characters printable as themselves via the “translation + file” <span +class="ec-lmtt-10">cp227.tcx</span>, instead of translating them with the <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">^^</span></span></span> notation. Specifically, characters + at positions 32–256, plus tab, vertical tab, and form feed are considered printable and + not translated. The exceptions are plain <span class="TEX">T<span +class="E">E</span>X</span> (only 32–126 printable), Con<span class="TEX">T<span +class="E">E</span>X</span>t (0–255 + printable), and the Omega-related formats. This default behavior is almost the same as in + <span class="TEX">T<span +class="E">E</span>X</span> Live 2003, but it’s implemented more cleanly, with more possibilities for customization. + See <a +href="../../../../texmf/doc/web2c/web2c.html#TCX-files" ><span +class="ec-lmtt-10">texmf/doc/web2c/web2c.html#TCX-files</span></a>. (By the way, with Unicode input, <span class="TEX">T<span +class="E">E</span>X</span> may + output partial character sequences when showing error contexts, since it is byte-oriented.) + </li> + <li class="itemize"><span +class="ec-lmss-10">pdfetex </span>is now the default engine for all formats except (plain) <span +class="ec-lmss-10">tex </span>itself. (Of course + it generates DVI when run as <span +class="ec-lmss-10">latex</span>, etc.) This means, among other things, that the + microtypographic features of <span +class="ec-lmss-10">pdftex </span>are available in <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>, Con<span class="TEX">T<span +class="E">E</span>X</span>t, etc., as well as the + e-<span class="TEX">T<span +class="E">E</span>X</span> features (<a +href="../../../../texmf-dist/doc/etex/base/" >texmf-dist/doc/etex/base/</a>). + <!--l. 2683--><p class="noindent" >It also means it’s <span +class="ec-lmri-10">more important than ever </span>to use the <span +class="ec-lmss-10">ifpdf </span>package (works with both plain + and <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>) or equivalent code, because simply testing whether <span +class="ec-lmtt-10">\pdfoutput </span>or some other + primitive is defined is not a reliable way to determine if PDF output is being generated. We + made this backward compatible as best we could this year, but next year, <span +class="ec-lmtt-10">\pdfoutput </span>may + be defined even when DVI is being written. + </li> + <li class="itemize">pdf<span class="TEX">T<span +class="E">E</span>X</span> (<a +href="http://pdftex.org" class="url" ><span +class="ec-lmtt-10">http://pdftex.org</span></a>) has many new features: + <ul class="itemize2"> + <li class="itemize"><span +class="ec-lmtt-10">\pdfmapfile </span>and <span +class="ec-lmtt-10">\pdfmapline </span>provide font map support from within a document. + </li> + <li class="itemize">Microtypographic font expansion can be used more easily.<br +class="newline" /><a +href="http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html" class="url" ><span +class="ec-lmtt-10">http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html</span></a> + </li> + <li class="itemize">All parameters previously set through the special configuration file <span +class="ec-lmtt-10">pdftex.cfg </span>must + now be set through primitives, typically in <span +class="ec-lmtt-10">pdftexconfig.tex</span>; <span +class="ec-lmtt-10">pdftex.cfg </span>is no + longer supported. Any extant <span +class="ec-lmtt-10">.fmt </span>files must be redumped when <span +class="ec-lmtt-10">pdftexconfig.tex</span> + is changed. + </li> + <li class="itemize">See the pdf<span class="TEX">T<span +class="E">E</span>X</span> manual for more: <a +href="../../../../texmf-dist/doc/pdftex/manual/pdftex-a.pdf" >texmf-dist/doc/pdftex/manual/pdftex-a.pdf</a>. + </li></ul> + </li> + <li class="itemize">The <span +class="ec-lmtt-10">\input </span>primitive in <span +class="ec-lmss-10">tex </span>(and <span +class="ec-lmss-10">mf </span>and <span +class="ec-lmss-10">mpost</span>) now accepts double quotes containing spaces and + other special characters. Typical examples: + + + <div class="verbatim"> + <div class="fancyvrb" id="fancyvrb19"> +<a + id="x1-71002r1"></a>  \input "filename with spaces"   % plain +<br class="fancyvrb" /><a + id="x1-71004r2"></a>  \input{"filename with spaces"}  % latex +</div> +</div> + <!--l. 2717--><p class="nopar" >See the Web2C manual for more: <a +href="../../../../texmf/doc/web2c" >texmf/doc/web2c</a>. + </li> + <li class="itemize">enc<span class="TEX">T<span +class="E">E</span>X</span> support is now included within Web2C and consequently all <span class="TEX">T<span +class="E">E</span>X</span> programs, via the <span +class="ec-lmtt-10">-enc</span> + option — <span +class="ec-lmri-10">only when formats are built</span>. enc<span class="TEX">T<span +class="E">E</span>X</span> supports general re-encoding of input and output, + enabling full support of Unicode (in UTF-8). See <a +href="../../../../texmf-dist/doc/generic/enctex/" >texmf-dist/doc/generic/enctex/</a> and + <a +href="http://www.olsak.net/enctex.html" class="url" ><span +class="ec-lmtt-10">http://www.olsak.net/enctex.html</span></a>. + </li> + <li class="itemize">Aleph, a new engine combining e-<span class="TEX">T<span +class="E">E</span>X</span> and Omega, is available. A little information is available in + <a +href="../../../../texmf-dist/doc/aleph/base" >texmf-dist/doc/aleph/base</a> and <a +href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph" class="url" ><span +class="ec-lmtt-10">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph</span></a>. + The <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-based format for Aleph is named <span +class="ec-lmss-10">lamed</span>. + </li> + <li class="itemize">The latest <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> release has a new version of the LPPL — now officially a Debian-approved + license. Assorted other updates, see the <span +class="ec-lmtt-10">ltnews </span>files in <a +href="../../../../texmf-dist/doc/latex/base" >texmf-dist/doc/latex/base</a>. + </li> + <li class="itemize"><span +class="ec-lmss-10">dvipng</span>, a new program for converting DVI to PNG image files, is included. See + <a +href="../../../../texmf/doc/man/man1/dvipng.1" >texmf/doc/man/man1/dvipng.1</a>. + </li> + <li class="itemize">We reduced the <span +class="ec-lmss-10">cbgreek </span>package to a “medium” sized set of fonts, with the assent and advice of the + author (Claudio Beccari). The excised fonts are the invisible, outline, and transparency ones, which + are relatively rarely used, and we needed the space. The full set is of course available from CTAN + (<a +href="http://www.ctan.org/tex-archive/fonts/greek/cb" class="url" ><span +class="ec-lmtt-10">http://www.ctan.org/tex-archive/fonts/greek/cb</span></a>). + </li> + <li class="itemize"><span +class="ec-lmss-10">oxdvi </span>has been removed; just use <span +class="ec-lmss-10">xdvi</span>. + </li> + <li class="itemize">The <span +class="ec-lmss-10">ini </span>and <span +class="ec-lmss-10">vir </span>commands (links) for <span +class="ec-lmss-10">tex</span>, <span +class="ec-lmss-10">mf</span>, and <span +class="ec-lmss-10">mpost </span>are no longer created, such as <span +class="ec-lmss-10">initex</span>. The + <span +class="ec-lmss-10">ini </span>functionality has been available through the command-line option <span +class="ec-lmtt-10">-ini </span>for years + now. + </li> + <li class="itemize"><span +class="ec-lmss-10">i386-openbsd </span>platform support was removed. Since the <span +class="ec-lmss-10">tetex </span>package in the BSD Ports system is + available, and GNU/Linux and FreeBSD binaries were available, it seemed volunteer time could be + better spent elsewhere. + </li> + <li class="itemize">On <span +class="ec-lmss-10">sparc-solaris </span>(at least), you may have to set the <span +class="ec-lmtt-10">LD_LIBRARY_PATH </span>environment + variable to run the <span +class="ec-lmss-10">t1utils </span>programs. This is because they are compiled with C++, and + there is no standard location for the runtime libraries. (This is not new in 2004, but + wasn’t previously documented.) Similarly, on <span +class="ec-lmss-10">mips-irix</span>, the MIPSpro 7.4 runtimes are + required. + </li></ul> + + +<!--l. 2768--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">10.1.3 </span> <a + id="x1-7200010.1.3"></a>2005</h5> +<!--l. 2770--><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"> + <li class="itemize">New scripts <span +class="ec-lmss-10">texconfig-sys</span>, <span +class="ec-lmss-10">updmap-sys</span>, and <span +class="ec-lmss-10">fmtutil-sys </span>were introduced, which modify the + configuration in the system trees. The <span +class="ec-lmss-10">texconfig</span>, <span +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>. + </li> + <li class="itemize">Corresponding new variables <span +class="ec-lmtt-10">TEXMFCONFIG </span>and <span +class="ec-lmtt-10">TEXMFSYSCONFIG </span>to specify the trees where + configuration files (user or system, respectively) are found. Thus, you may need to move + personal versions of <span +class="ec-lmtt-10">fmtutil.cnf </span>and <span +class="ec-lmtt-10">updmap.cfg </span>to these places; another option is to + redefine <span +class="ec-lmtt-10">TEXMFCONFIG </span>or <span +class="ec-lmtt-10">TEXMFSYSCONFIG </span>in <span +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>, + p. <a +href="#x1-100002.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 + the <span +class="ec-lmss-10">pdfetex </span>program was being used. This year, as promised, we undid that compatibility + measure. So if your document uses <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\ifx\pdfoutput\undefined</span></span></span> to test if PDF is being + output, it will need to be changed. You can use the package <span +class="ec-lmss-10">ifpdf.sty </span>(which works under + both plain <span class="TEX">T<span +class="E">E</span>X</span> and <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>) to do this, or steal its logic. + </li> + <li class="itemize">Last year, we changed most formats to output (8-bit) characters as themselves (see previous + section). The new TCX file <span +class="ec-lmtt-10">empty.tcx </span>now provides an easier way to get the original <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">^^</span></span></span> notation if + you so desire, as in: + + + <div class="verbatim"> + <div class="fancyvrb" id="fancyvrb20"> +<a + id="x1-72002r1"></a>  latex --translate-file=empty.tcx yourfile.tex +</div> +</div> + <!--l. 2807--><p class="nopar" > + </li> + <li class="itemize">The new program <span +class="ec-lmss-10">dvipdfmx </span>is included for translation of DVI to PDF; this is an actively + maintained update of <span +class="ec-lmss-10">dvipdfm </span>(which is also still available for now, though no longer + recommended). + </li> + <li class="itemize">The new programs <span +class="ec-lmss-10">pdfopen </span>and <span +class="ec-lmss-10">pdfclose </span>are included to allow reloading of pdf files in the Adobe + Acrobat Reader without restarting the program. (Other pdf readers, notably <span +class="ec-lmss-10">xpdf</span>, <span +class="ec-lmss-10">gv</span>, and <span +class="ec-lmss-10">gsview</span>, + have never suffered from this problem.) + </li> + <li class="itemize">For consistency, the variables <span +class="ec-lmtt-10">HOMETEXMF </span>and <span +class="ec-lmtt-10">VARTEXMF </span>have been renamed to <span +class="ec-lmtt-10">TEXMFHOME </span>and + <span +class="ec-lmtt-10">TEXMFSYSVAR</span>, respectively. There is also <span +class="ec-lmtt-10">TEXMFVAR</span>, which is by default user-specific. See the first + point above. + </li></ul> +<!--l. 2829--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">10.1.4 </span> <a + id="x1-7300010.1.4"></a>2006–2007</h5> +<!--l. 2831--><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 +class="ec-lmtt-10">xetex </span>and +<span +class="ec-lmtt-10">xelatex </span>programs; see <a +href="http://scripts.sil.org/xetex" class="url" ><span +class="ec-lmtt-10">http://scripts.sil.org/xetex</span></a>. +<!--l. 2835--><p class="indent" > MetaPost also received a notable update, with more planned for the future +(<a +href="http://tug.org/metapost/articles" class="url" ><span +class="ec-lmtt-10">http://tug.org/metapost/articles</span></a>), likewise pdf<span class="TEX">T<span +class="E">E</span>X</span> (<a +href="http://tug.org/applications/pdftex" class="url" ><span +class="ec-lmtt-10">http://tug.org/applications/pdftex</span></a>). +<!--l. 2839--><p class="indent" > The <span class="TEX">T<span +class="E">E</span>X</span> <span +class="ec-lmtt-10">.fmt </span>(high-speed format) and the similar files for MetaPost and Metafont are +now stored in subdirectories of <span +class="ec-lmtt-10">texmf/web2c</span>, instead of in the directory itself (although the +directory is still searched, for the sake of existing <span +class="ec-lmtt-10">.fmt</span>’s). The subdirectories are named for the +‘engine’ in use, such as <span +class="ec-lmtt-10">tex </span>or <span +class="ec-lmtt-10">pdftex </span>or <span +class="ec-lmtt-10">xetex</span>. This change should be invisible in normal +use. +<!--l. 2847--><p class="indent" > The (plain) <span +class="ec-lmtt-10">tex </span>program no longer reads <span +class="ec-lmtt-10">%& </span>first lines to determine what format to run; it is the pure +Knuthian <span class="TEX">T<span +class="E">E</span>X</span>. (<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> and everything else do still read <span +class="ec-lmtt-10">%& </span>lines). +<!--l. 2851--><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 +class="ec-lmtt-10">http://www.ctan.org</span></a>) for updates. +<!--l. 2855--><p class="indent" > Internally, the source tree is now stored in Subversion, with a standard web interface for viewing the +tree, as linked from our home page. Although not visible in the final distribution, we expect this will +provide a stable development foundation for future years. +<!--l. 2860--><p class="indent" > Finally, in May 2006 Thomas Esser announced that he would no longer be updating te<span class="TEX">T<span +class="E">E</span>X</span> +(<a +href="http://tug.org/tetex" class="url" ><span +class="ec-lmtt-10">http://tug.org/tetex</span></a>). As a result, there was been a surge of interest in <span class="TEX">T<span +class="E">E</span>X</span> Live, especially among +GNU/Linux distributors. (There is a new <span +class="ec-lmtt-10">tetex </span>installation scheme in <span class="TEX">T<span +class="E">E</span>X</span> Live, which provides +an approximate equivalent.) We hope this will eventually translate to improvements in the +<span class="TEX">T<span +class="E">E</span>X</span> environment for everyone. +<!--l. 2868--><p class="noindent" >Final note on the past: all releases of <span class="TEX">T<span +class="E">E</span>X</span> Live, along with ancillary material such as CD labels, are +available at <a +href="ftp://tug.org/historic/systems/texlive" class="url" ><span +class="ec-lmtt-10">ftp://tug.org/historic/systems/texlive</span></a>. +<!--l. 2873--><p class="indent" > <a id="news"></a> + + + <h4 class="subsectionHead"><span class="titlemark">10.2 </span> <a + id="x1-7400010.2"></a>Present</h4> +<!--l. 2877--><p class="noindent" >In 2008, the entire <span class="TEX">T<span +class="E">E</span>X</span> Live infrastructure was redesigned and reimplemented. Complete information +about an installation is now stored in a plain text file <span +class="ec-lmtt-10">tlpkg/texlive.tlpdb</span>. +<!--l. 2881--><p class="indent" > Among other things, this finally makes possible upgrading a <span class="TEX">T<span +class="E">E</span>X</span> Live installation over the Internet +after the initial installation, a feature MiK<span class="TEX">T<span +class="E">E</span>X</span> has provided for many years. We expect to regularly +update new packages as they are released to CTAN. +<!--l. 2886--><p class="indent" > The major new engine Lua<span class="TEX">T<span +class="E">E</span>X</span> (<a +href="http://luatex.org" class="url" ><span +class="ec-lmtt-10">http://luatex.org</span></a>) is included; besides a new level of flexibility in +typesetting, this provides an excellent scripting language for use both inside and outside of +<span class="TEX">T<span +class="E">E</span>X</span> documents. +<!--l. 2891--><p class="indent" > Support among Windows and the Unix-based platforms is now much more uniform. In particular, +most Perl and Lua scripts are now available on Windows, using the Perl internally distributed with <span class="TEX">T<span +class="E">E</span>X</span> +Live. +<!--l. 2895--><p class="indent" > The new <span +class="ec-lmss-10">tlmgr </span>script (section <a +href="#x1-410006">6<!--tex4ht:ref: sec:tlmgr --></a>) is the general interface for managing <span class="TEX">T<span +class="E">E</span>X</span> Live after the initial +installation. It handles package updates and consequent regeneration of formats, map files, and language +files, optionally including local additions. +<!--l. 2900--><p class="indent" > With the advent of <span +class="ec-lmss-10">tlmgr</span>, the <span +class="ec-lmss-10">texconfig </span>actions to edit the format and hyphenation configuration files +are now disabled. +<!--l. 2903--><p class="indent" > The <span +class="ec-lmss-10">xindy </span>indexing program (<a +href="http://xindy.sourceforge.net/" class="url" ><span +class="ec-lmtt-10">http://xindy.sourceforge.net/</span></a>) is now included on most +platforms. +<!--l. 2906--><p class="indent" > The <span +class="ec-lmss-10">kpsewhich </span>tool can now report all matches for a given file (option <span +class="ec-lmtt-10">–all</span>) and limit matches to a +given subdirectory (option <span +class="ec-lmtt-10">–subdir</span>). +<!--l. 2910--><p class="indent" > The <span +class="ec-lmss-10">dvipdfmx </span>program now includes functionality to extract bounding box information, via +the command name <span +class="ec-lmss-10">extractbb</span>; this was one of the last features provided by <span +class="ec-lmss-10">dvipdfm </span>not in +<span +class="ec-lmss-10">dvipdfmx</span>. +<!--l. 2915--><p class="indent" > The font aliases <span +class="ec-lmtt-10">Times-Roman</span>, <span +class="ec-lmtt-10">Helvetica</span>, and so on have been removed. Different packages expected +them to behave differently (in particular, to have different encodings), and there was no good way to +resolve this. +<!--l. 2920--><p class="indent" > The <span +class="ec-lmss-10">platex </span>format has been removed, to resolve a name conflict with a completely different Japanese +<span +class="ec-lmss-10">platex</span>; the <span +class="ec-lmss-10">polski </span>package is now the main Polish support. +<!--l. 2924--><p class="indent" > Internally, the <span +class="ec-lmtt-10">WEB</span> string pool files are now compiled into the binaries, to ease upgrades. +<!--l. 2927--><p class="indent" > Finally, the changes made by Donald Knuth in his ‘<span class="TEX">T<span +class="E">E</span>X</span> tuneup of 2008’ are included in this release. +See <a +href="http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf" class="url" ><span +class="ec-lmtt-10">http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf</span></a>. +<!--l. 2932--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.3 </span> <a + id="x1-7500010.3"></a>Future</h4> +<!--l. 2934--><p class="noindent" ><span class="TEX"><span +class="ec-lmri-10">T</span><span +class="E"><span +class="ec-lmri-10">E</span></span><span +class="ec-lmri-10">X</span></span> <span +class="ec-lmri-10">Live is not perfect! </span>(And never will be.) We intend to continue to release new versions, and +would like to provide more help material, more utilities, more installation programs, and (of +course) an ever-improved and better-checked tree of macros and fonts. This work is all done by +hard-pressed volunteers in their limited spare time, and a great deal remains to be done. Please see +<a +href="http://tug.org/texlive/contribute.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/contribute.html</span></a>. +<!--l. 2942--><p class="indent" > Please send corrections, suggestions, and offers of help to: + <div class="quote"> + <!--l. 2944--><p class="noindent" ><a +href="mailto:tex-live@tug.org" ><span +class="ec-lmtt-10">tex-live@tug.org</span></a> <br +class="newline" /><a +href="http://tug.org/texlive" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive</span></a></div> +<!--l. 2949--><p class="noindent" ><span +class="ec-lmro-10">Happy </span><span class="TEX"><span +class="ec-lmro-10">T</span><span +class="E"><span +class="ec-lmro-10">E</span></span><span +class="ec-lmro-10">X</span></span><span +class="ec-lmro-10">ing!</span> + +</body></html> + + + + diff --git a/Master/texmf/doc/texlive/texlive-en/texlive-en.pdf b/Master/texmf/doc/texlive/texlive-en/texlive-en.pdf Binary files differnew file mode 100644 index 00000000000..e4b11666146 --- /dev/null +++ b/Master/texmf/doc/texlive/texlive-en/texlive-en.pdf diff --git a/Master/texmf/doc/texlive/texlive-en/tlmgr-config.png b/Master/texmf/doc/texlive/texlive-en/tlmgr-config.png Binary files differnew file mode 100644 index 00000000000..7f2d3123689 --- /dev/null +++ b/Master/texmf/doc/texlive/texlive-en/tlmgr-config.png diff --git a/Master/texmf/doc/texlive/texlive-en/tlmgr-gui.png b/Master/texmf/doc/texlive/texlive-en/tlmgr-gui.png Binary files differnew file mode 100644 index 00000000000..9c45772503d --- /dev/null +++ b/Master/texmf/doc/texlive/texlive-en/tlmgr-gui.png |
