TUGb oat, Volume 18 1997, No. 2 81 T X Live CD-ROM E The T X Live Guide, version 2 1. "-T X, which adds a small but powerful set of E E new primitives, and the T X--X T extensions E E Sebastian Rahtz and Michel Go ossens for left to right typ esetting; in default mo de, Contents "-T X is 100 compatible with ordinary T X. E E See share/texmf/doc/html/e-tex/etex.htm 1 Intro duction 81 on the CD-ROM for details. 1.1 History and acknowledgements . 81 2. p dfT X, which can optionally write Acrobat 1.2 Future versions . 82 E PDF format instead of dvi; there is no formal 2 Structure and contents of the CD-ROM 82 do cumentation for this yet, but the le share/ 2.1 The TDS tree . 82 texmf/tex/pdftex/example.tex shows howit A is used. The L T X hyperref package has an 3 Installation and use under Unix 83 E 3.1 Running T X Live from the CD-ROM . 83 option `p dftex' which turns on all the program E 3.2 Installing T X Live to a hard disk . 84 E features. 3.3 Installing individual packages from T X Live E While "-T X is stable, p dfT X is under continual to a hard disk . 84 E E 3.4 texconfig . 86 development; the version on the CD-ROM may not 3.5 Building on a new platform . 86 b e stable. Most platforms haveversion 0.11 of May 7th, but some have a slightly earlier one of May 5th, 4 A user's guide to the Web2c system 86 whichmayhave problems including PNG les. 4.1 Kpathsea path searching . 87 The entire GUTenb erg distribution for Win- 4.2 Filename databases . 89 4.3 Runtime options . 93 dows is included on the CD-ROM, ready to install, as are the following complete packages: 5 Other packages on the CD-ROM 93 OzT X 3.0 for Macintosh 5.1 OzT X . 93 E E 5.2 CMacTeX . 94 CMacTeX 2.6 for Macintosh 5.3 MiKTeX . 94 Macintosh utilities Alpha, Excalibur, etc. 5.4 emTeX . 94 MikTeX for Windows 95 A The texmf.cnf le 95 emTeX for MSDOS and OS/2 B Catalogue of Packages 101 T X shells for Windows and DOS Winedt, e4t, E TeXtelmExtel, emTeXgi These are provided unchanged from CTAN, and have not b een integrated in anyway with the rest of the 1 Intro duction CD-ROM. This do cumentation describ es the main features of 1.1 History and acknowledgements A the T X Live CD-ROM,aT X/L T X distribution E E E This CD-ROM distribution is a joint eort by the for Unix, Windows32, Amiga and NeXT systems, A T X Users Group, the UK T X Users Group, and that includes T X, L T X2 , METAFONT , Meta- " E E E E the FrenchT X Users GUTenb erg, with the sup- Post, many other programs such as Makeindex, E p ort of the Dutch, German and Czech/Slovak user dvips, xdvi and BibT X; and a very complete set E groups. Discussion b egan in late 1993 when the of macros, fonts and do cumentation conforming to Dutch T X Users Group was starting work on its the T X Directory Standard which can b e used with E E 4AllT X CD-ROM for MSDOS users, and it was nearly every T X setup. E E hop ed at that time to issue a single, rational, CD- This T X package uses the Web2c implementa- E ROM for all systems. This was far to o ambitious tion of the programs, which tries to make T Xing E a target, but it did spawn not only the very suc- as easy as p ossible, and takes full advantage of the cessful 4AllT X CD-ROM, but also the TUG Tech- ecient and highly customizable Kpathsea library E nical Council working group on a T X Directory from Karl Berry. It can b e run either directly from E Structure, which sp ecied how to create consistent the CD-ROM, or installed on a hard disk. and manageable collections of T X supp ort les. The T X Live runnable systems contain two E E The nal draft of the TDS was published in the exp erimental extensions to normal T X: E 82 TUGb oat, Volume 18 1997, No. 2 Decemb er 1995 issue of TUGb oat , and it was clear more help material, more utilities, more installation from an early stage that one desirable pro duct would programs, and of course an ever-improved and be a mo del structure on CD-ROM. The CD-ROM checked tree of macros and fonts. This work is you nowhaveisavery direct result of the working all done by hard-pressed volunteers in their limited group's delib erations. It was also clear that the spare time, and a great deal remains to be done. success of the 4AllT X CD-ROM meant that Unix If you can help, don't hesitate to put your name E users would b enet from a similarly easy system, forward! and this is the other main strand of T X Live. Corrections, suggestions and additions for fu- E We underto ok to make a new Unix-based TDS ture revisions should b e sent to: CD-ROM in the autumn of 1995, and quickly iden- Sebastian Rahtz tied Thomas Esser's teT X as the ideal setup, as E 7 Strateld Road it already had multi-platform supp ort and was built Oxford OX2 7BG with p ortability across le systems in mind. Thomas United Kingdom agreed to help, and work b egan seriously at the mailto:[email protected] start of 1996. The rst edition was released in May Up dates, notes, and suggestions will be made 1996. At the start of 1997, Karl Berry completed available on CTAN in info/texlive. A WWW a ma jor new release of his Web2c package, which page for information and ordering details is at http: included nearly all the features which Thomas Esser //www.tug.org/tex-live.html. had added in teT X, and we decided to base the 2nd E edition of the CD-ROM on the standard Web2c, with 2 Structure and contents of the CD-ROM the addition of teT X's texconfig script. E The CD-ROM top level directories are: We are particularly grateful to: Karl Berry for bin The T X family programs, arranged in separate E extra advice, encouragement, and of course for platform directories; providing the Web2c distribution; Thomas Esser, info Do cumentation in GNU `info' format for the without whose marvellous teT X package this CD- E T X system; E ROM would certainly not exist, and whose continual macintosh The OzT X and CMacTeX packages E help makes it a b etter pro duct; and Ulrik Vieth, ready to install, plus some other utilities; for checking many assumptions at the start, and man Do cumentation in Unix man pages for the providing a great deal of extra material for the T X system; E do cumentation tree. msdos DOS T X packages emTeX, and three E Fabrice Popineau did the excellent p ort of T X shells; E Web2c 7.0 to Windows 95/NT and provided much supp ort The source of all programs, including the help; Andreas Scherer contributed the Amiga com- main Web2c T X and METAFONT distribution; pilation; Gregor Hoeit contributed the TeXview E this directory also includes various bits of T X- material for NextStep users, and the NextStep bi- E related software which are not installed by naries. At Florida State University Sup ercomputer default, such as MusixT X supp ort programs, Research Institute, Mimi Burbank arranged access E and a complete set of Ghostscript; to a slew of dierent computers to compile T X on, E share The main supp ort tree of macros, fonts and and acted as an essential guinea-pig whenever asked. do cumentation; Michel Go ossens provided access to computers at wingut The GUTenb erg distribution for Windows; CERN, and Robin Fairbairns stepp ed in to provide this consists of compressed archives whichmust an Alpha running Linux at Cambridge. be unpacked and installed on a hard disk. Some of this do cumentation is drawn from the Please see the detailed instructions in French; teT X guide by Thomas Esser and Dirk Hillbrecht; E win32 T X packages for Windows 95 and NT users the catalogue of packages dep ends very much on E MikTeX, and the original package of the Win32 the ongoing work of Graham Williams mailto: p ort of Web2c. [email protected], who kindly agreed to allowus to use it here. Mimi Burbank, There are also two installation scripts for Unix Robin Fairbairns and Ulrik Vieth worked hard to systems, install-cd.sh and install-pkg.sh;we improve this text. discuss them on p. 83. 1.2 Future versions 2.1 The TDS tree This CD-ROM is not a perfect product! We plan to The T X Live share/texmf tree consists of various E re-issue it once a year, and would like to provide `collections', each of which has a set of `packages', of TUGb oat, Volume 18 1997, No. 2 83 which there are over 400 on the CD-ROM. Normal 3.