[unixtex.ftp: 12 August 1994] The master version of this file is on ftp.cs.umb.edu [158.121.104.33] in pub/tex/unixtex.ftp. Mail kb@cs.umb.edu with comments or questions. ========================================================================= Consider joining the TeX Users Group (TUG): support the maintenance and development of the programs you retrieve. Send membership request to: tug@tug.org. ========================================================================= FTP INSTRUCTIONS ... for Unix sites wanting to install (plain) TeX, LaTeX, BibTeX, plain Metafont, an X window system previewer, a PostScript device driver, and an HP LaserJet device driver. Use the host nearest you: Host Internet address TeX root dir ---- ---------------- ------------ ftp.shsu.edu 192.92.115.10 tex-archive ftp.tex.ac.uk 134.151.44.19 tex-archive ftp.dante.de 128.69.1.12 tex-archive For additional hosts, see /README.mirrors on these sites or finger ctan_us@ftp.shsu.edu. ftp.shsu.edu has these two additional files: README.archive-features README.site-commands Our instructions assume you have read these documents. If you do not have GNU's gunzip utility, first retrieve and install the gzip package. Set "binary" mode by typing "bi" at your ftp prompt; retrieve /tex-archive/tools/info-zip/gzip-.tar gzip does a better job of compression than standard Unix compress, and it is (as far as is known) patent-free. It is illegal to use Unix compress (at least in the USA), because it infringes a software patent. Write to lpf@uunet.uu.net, the League for Programming Freedom, for information about fighting the new software monopolies in the US. For a basic set of input files and fonts: ---------------------------------------- ftp> cd tex-archive/systems/web2c ftp> bi ftp> get lib.tar.gz This file contains a minimal collection of fonts (TFM files only), (La)TeX macros, MF macros, and BibTeX files -- enough to get started. The AMS fonts and macros are included. lib.tar.gz unpacks into a directory named `texmf', which you will want in your equivalent of /usr/local/lib -- whatever you will define as your $(datadir) in the Makefiles. The organization of the archive was debated at great length. We hope it will be useful. If you don't like our organization, feel free to move the files around as you see fit, not forgetting to redefine the search paths and installation directories. The Makefiles, kpathsea/HIER, kpathsea/paths.h.in, and web2c/README (``Directory hierarchies'') have more information. You must decide on your directory structure *before* doing the compilations, since you must specify default search paths, and since the web2c Makefile tries to create the basic .fmt and .base files, which require the .{tex,mf,tfm} input files to be in place. For web2c (that is, TeX, Metafont, and friends): ------------------------------------------------ Still in tex-archive/systems/web2c: ftp> get web.tar.gz [Knuth's WEB sources for TeX, MF, & family: unpacks into ./web2c-] ftp> get web2c.tar.gz [WEB-to-C source: also unpacks into ./web2c-] You *must* retrieve and unpack *both* web.tar.gz and web2c.tar.gz. Device driver support: ---------------------- For an X window system previewer (xdvik): ftp> cd /tex-archive/dviware/xdvik ftp> get xdvik.tar.gz [unpacks into ./xdvik-] For a DVI-to-PostScript translator (dvipsk): ftp> cd /tex-archive/dviware/dvipsk ftp> get dvipsk.tar.gz [unpacks into dvipsk-] For a DVI-to-PCL translator (dviljk): ftp> cd /tex-archive/dviware/dviljk ftp> get dviljk.tar.gz [unpacks into dviljk-] [optional] For prebuilt bitmaps: ftp> cd /tex-archive/fonts/cm/pk ftp> get pk300.zip These bitmapped fonts were generated by Metafont using the CanonCX mode_def for write-black 300dpi devices. If using the default search paths, place this set of Computer Modern fonts in $(fontdir)/public/cm/pk/cx. This is optional because the drivers can run a script called MakeTeXPK (sample supplied with dvipsk) to generate fonts as needed. The zip/unzip package is in /tex-archive/tools/info-zip. ftp> quit [end ftp session] Compilation and installation: ---------------------------- Each of these packages -- web2c, xdvik, dvipsk, dviljk -- contains its own installation instructions. It is possible to build all the programs in a single make, but it is simpler to make them separately. Compile web2c first (i.e.,, the material in both web.tar.gz and web2c.tar.gz, unpacked). Begin by reading ./web2c-/README ./web2c-/web2c/README ./web2c-/web2c/INSTALL ./web2c-/kpathsea/README ./web2c-/kpathsea/INSTALL The INSTALL files are your guides to installation. Remember to set up your texmf directory hierarchy before embarking on your compilation (see "For a basic set of input files and fonts" above). All installation processes require careful attention to detail, and knowledge of your system. Festa lente -- make haste slowly -- and you improve your chances of success. BUG: wchar_t is impossible to get right. If you get error messages involving foil_x_wchar_t, try make CFLAGS="-g -DNO_FOIL_X_WCHAR_T" BUG: I messed up and declared alloca in web2c/web2c/web2c.h. Just delete the declaration. ftp.cs.umb.edu:pub/tex/web2c.alloca.help does this. BUG: Contrary to what the installation instructions imply, you must use configure --prefix=/your/tex/root instead of editing the prefix in the Makefile(s). (Editing does work in some cases, but not all.) BUG: make clean removes *.pool in web2c/tex and web2c/mf. Use make distclean or make mostlyclean instead. Or edit tex/Makefile and mf/Makefile to remove *.pool at distclean instead of clean. ftp.cs.umb.edu:pub/tex/web2c.pool.help does this. BUG: The kpathsea that comes with web2c is an older version of what is in the other distributions. To use the latest kpathsea, retrieve web2c.kpathsea.help and follow the instructions therein. Further help: ------------ The tex-archive/help and tex-archive/info directories on the CTAN sites have much additional documentation. Distribution on tape and CD/ROM: ------------------------------- For TeX on a single tape (4mm DAT or QIC-24), ordering information is available from unixtex@u.washington.edu. A distribution fee in the area of US$210.00 covers administrative costs. Tapes will be available at least through summer of 1994. The Free Software Foundation distributes the minimal TeX system described here on CD/ROM. Write gnu@prep.ai.mit.edu for ordering info. Other organizations also have TeX on a CD/ROM, but I do not know the details to include them here. Tell me if you have more info. Retrieving TeX executables: -------------------------- (Original from George D. Greenwade , but slightly edited.) The files in /tex-archive/systems/unix/unixkit/ are minimal sets of precompiled executables (thanks to Sebastian Rahtz for making these sets available) for the various platforms using the latest web2c (version 6.1) package and techniques outlined in unixtex.ftp. The one exception to this is the file share.tar.gz, which includes man pages and pool files for the distribution which may be used across all architectures. Specifically excluded from this distribution in unixkit are the many additional macros and styles, fonts, and utilities which are available elsewhere in the CTAN archives -- the idea is to have the ability to get the latest files, but still have them in workable chunks for retrieval purposes. [Retrieve lib.tar.gz as discussed above for the minimal font/macro files.] You *must* use the default location, /usr/local/lib/texmf, for your TeX macros, fonts, etc. if you use these binaries. If you cannot use that directory, then retrieve the sources and recompile. If you get these binaries, you do not need to get web.tar.gz and web2c.tar.gz. Acknowledgements: ----------------- The three main sites listed above are part of the Comprehensive TeX Archive Network (CTAN) -- the result of cooperative work among members of TUG, DANTE [German-speaking TeX Users Group], and UKTUG [U.K. TeX Users Group], under the leadership of George Greenwade, Chair for TUG's Technical Working Group on TeX Archive Guidelines. Special thanks to George Greenwade for establishing the CTAN site at Sam Houston State University (US); to Rainer Schoepf, Barbara Burr, and members of DANTE for the CTAN site at Heidelberg (FRG); and to Sebastian Rahtz for the CTAN site at Aston University (UK). This file was conceived and created by Elizabeth Tachikawa.