home *** CD-ROM | disk | FTP | other *** search
/ Internet File Formats / InternetFileFormatsCD.bin / text / latex / unix / web2c / unixtex.ftp < prev    next >
Encoding:
INI File  |  1995-09-22  |  10.5 KB  |  256 lines
  1. [unixtex.ftp: 10 August 1995]
  2.  
  3. The master version of this file is on ftp.cs.umb.edu [158.121.104.33]
  4. in pub/tex/unixtex.ftp. Mail kb@cs.umb.edu with comments or questions.
  5.  
  6. =========================================================================
  7.              Consider joining the TeX Users Group (TUG):
  8.   support the maintenance and development of the programs you retrieve.
  9.               Send membership request to: tug@tug.org.
  10. =========================================================================
  11.  
  12.             GENERAL INSTRUCTIONS
  13.  
  14. ... for Unix sites wanting to install (plain) TeX, LaTeX (2e), BibTeX,
  15. plain Metafont, an X window system previewer, a PostScript device
  16. driver, and/or an HP LaserJet device driver.
  17.  
  18. The files mentioned below are available from any of the following:
  19.  
  20.     Host            Internet address    TeX root dir
  21.     ----            ----------------    ------------
  22.     ftp.shsu.edu        192.92.115.10        /tex-archive
  23.     ftp.tex.ac.uk        134.151.44.19        /tex-archive
  24.     ftp.dante.de        128.69.1.12        /tex-archive
  25.     
  26.     For additional ftp sites, get /README.mirrors from one of the above or
  27.     finger ctan@ftp.shsu.edu.
  28.  
  29.     These instructions use non-generic features of FTP supported by the
  30.     hosts above. For details, get:
  31.       /README.archive-features
  32.       /README.site-commands 
  33.  
  34. The /tex-archive/help and /tex-archive/documentation directories on
  35. these hosts have much additional documentation on all aspects of TeX.
  36.  
  37. If you do not have GNU's gunzip utility, first retrieve and install gzip.
  38. Set binary mode by typing "bi" at your ftp prompt; then
  39.  
  40.     get /tex-archive/tools/info-zip/gzip-<version>.tar
  41.  
  42. gzip does a better job of compression than standard Unix compress, and
  43. it is (as far as is known) patent-free.  It is illegal to use Unix
  44. compress in the USA, because it infringes a software patent.  Write to
  45. the League for Programming Freedom <lpf@uunet.uu.net> for information
  46. about fighting the new software monopolies.
  47.  
  48.  
  49. Retrieving a basic set of input files and fonts:
  50. -----------------------------------------------
  51.  
  52. ftp> cd /tex-archive/systems/web2c
  53. ftp> bi
  54. ftp> get lib.tar.gz
  55.  
  56.      This file contains a minimal collection of fonts (TFM files only,
  57.      and only for Computer Modern, DC, LaTeX, Pandora, and the free
  58.      PostScript fonts), base (La)TeX macros, MF macros, and BibTeX files
  59.      -- enough to get started. The AMS fonts and macros are included.
  60.      The LaTeX release may be out of date; for the latest, and for
  61.      additional LaTeX packages; investigate /tex-archive/macros/latex.
  62.  
  63.      lib.tar.gz unpacks into a directory named `texmf', which you will
  64.      want in your equivalent of /usr/local/lib -- whatever you will
  65.      define as your $(datadir) in the Makefiles.
  66.  
  67.      The organization of the archive was debated at great length. We hope
  68.      it will be useful. If you don't like our organization, feel free to
  69.      move the files around as you see fit, not forgetting to redefine the
  70.      search paths and installation directories. The Makefiles,
  71.      kpathsea/HIER, kpathsea/paths.h.in, and web2c/README (``Directory
  72.      hierarchies'') have more information. The organization will
  73.      change to conform to the standard TeX directory structure
  74.      promulgated by the TUG Working Group when the TDS is released.
  75.  
  76.      You must decide on your directory structure *before* doing the
  77.      compilations, since you must specify default search paths, and
  78.      since by default the web2c Makefile tries to create the basic .fmt
  79.      and .base files, which require the .{tex,mf,tfm} input files.
  80.  
  81.  
  82. Retrieving web2c (that is, TeX, Metafont, and friends):
  83. ------------------------------------------------------
  84.  
  85. Still in /tex-archive/systems/web2c:
  86.  
  87. ftp> get web.tar.gz    [Knuth's WEB sources for TeX, MF, & family:
  88.              unpacks into ./web2c-<version>]
  89. ftp> get web2c.tar.gz    [WEB-to-C source: also unpacks into ./web2c-<version>]
  90.  
  91.      You must retrieve and unpack *both* web.tar.gz and web2c.tar.gz.
  92.      
  93.      The web2c distribution uses an older version of the path-searching
  94.      library than the drivers below. For an interim patch, get the
  95.      latest ftp.cs.umb.edu:pub/tex/web2c.kpathsea-2.*.help file, and
  96.      read it.  (I'm working on the next release of web2c as hard as I
  97.      can, really.)  The two versions can coexist; by using the web2c
  98.      distribution as it stands, you merely lose the features added to
  99.      kpathsea over the last year or so.
  100.  
  101.  
  102. Retrieving device drivers:
  103. -------------------------
  104.  
  105.        For an X window system previewer (xdvik):
  106. ftp> cd /tex-archive/dviware/xdvik
  107. ftp> get xdvik.tar.gz    [unpacks into ./xdvik-<version>]
  108.  
  109.        For a DVI-to-PostScript translator (dvipsk):
  110. ftp> cd /tex-archive/dviware/dvipsk
  111. ftp> get dvipsk.tar.gz    [unpacks into ./dvipsk-<version>]
  112.  
  113.        For a DVI-to-PCL (HP LaserJet) translator (dviljk):
  114. ftp> cd /tex-archive/dviware/dviljk
  115. ftp> get dviljk.tar.gz    [unpacks into ./dviljk-<version>]
  116.  
  117.       [optional] For prebuilt bitmaps:
  118. ftp> cd /tex-archive/fonts/cm/pk
  119. ftp> get pk300.zip
  120.      These bitmapped fonts were generated by Metafont using the cx
  121.      mode_def for write-black 300dpi devices.
  122.  
  123.      If using the default search paths, place this set of 
  124.      Computer Modern fonts in $(fontdir)/public/cm/pk/cx.
  125.      Alternatively, let the MakeTeXPK script that comes with the drivers
  126.      build the fonts as you need them.
  127.  
  128.      The zip/unzip package is in /tex-archive/tools/info-zip.  At least
  129.      version 5.x is necessary.
  130.  
  131. ftp> quit        [end ftp session]
  132.  
  133.  
  134. Compilation and installation:
  135. ----------------------------
  136.  
  137. Each of these packages -- web2c, xdvik, dvipsk, dviljk -- contains its
  138. own installation instructions.  It is possible to build all the programs
  139. in a single make (see the web2c.kpathsea-*.help file), but it is simpler
  140. to make them separately.
  141.  
  142. Compile web2c first (i.e.,, the material in both web.tar.gz and
  143. web2c.tar.gz, unpacked, possibly patched for the most recent kpathsea --
  144. see above, under `retrieving web2c').  For an overview,
  145.  
  146.     ./web2c-<version>/README
  147.     ./web2c-<version>/kpathsea/INSTALL
  148.     ./web2c-<version>/web2c/README
  149.     ./web2c-<version>/web2c/INSTALL
  150.  
  151. The INSTALL files are your guides to installation.
  152. At the simplest, you do configure && make && make install at the top level.
  153.  
  154. Remember to set up your texmf directory hierarchy before embarking on 
  155. your compilation (see `For a basic set of input files and fonts' above).
  156.  
  157. After installation, if basic input files such as plain.tex aren't being
  158. found, or if the file searching is very slow, read kpathsea/INSTALL from
  159. one of the *k driver distributions. (This is much more recent than
  160. kpathsea/INSTALL from web2c.)
  161.  
  162. All installation processes require careful attention to detail, and
  163. knowledge of your system.  Festina lente -- make haste slowly -- and you
  164. improve your chances of success.
  165.  
  166. ftp.cs.umb.edu:pub/tex/*.help describe some common problems with the
  167. current version of web2c. Here's some more:
  168.  
  169. -- Contrary to what the web2c installation instructions imply, you must use
  170.     configure --prefix=/your/tex/root
  171. instead of editing the prefix in the Makefile(s). (Editing does work in
  172. some cases, but not all.)
  173.  
  174. -- configure does not always guess the type of yytext properly; the
  175. symptom will be compiler errors involving yytext. Replace the line
  176. `DECLARE_YYTEXT' in web2c-6.1/web2c/web2c.h with the right thing. See
  177. web2c.yytext.help.
  178.  
  179. -- If the compiler complains about something involving foil_x_wchar_t, try
  180.     make CFLAGS="-g -DNO_FOIL_X_WCHAR_T"  (for web2c); or
  181.     make CFLAGS="-g -DFOIL_X_WCHAR_T" (for everything else).
  182.  
  183. -- I messed up and declared alloca in web2c/web2c/web2c.h. Just delete
  184. the declaration. ftp.cs.umb.edu:pub/tex/web2c.alloca.help does this.
  185.  
  186. -- make clean removes *.pool in web2c/tex and web2c/mf. Use make
  187. distclean or make mostlyclean instead. Or edit tex/Makefile and
  188. mf/Makefile to remove *.pool at distclean instead of clean.
  189. ftp.cs.umb.edu:pub/tex/web2c.pool.help does this.  (You must apply this
  190. patch before web2c.kpathsea-2.6.help.)
  191.  
  192.  
  193. Distribution on tape and CD/ROM:
  194. -------------------------------
  195.  
  196. For TeX on a single tape (4mm DAT or QIC-24), ordering information is
  197. available from unixtex@u.washington.edu.  A distribution fee in the area
  198. of US$210.00 covers administrative costs.
  199.  
  200. The Free Software Foundation distributes the minimal TeX system
  201. described here on CD/ROM. Write gnu@prep.ai.mit.edu for ordering info.
  202.  
  203. Walnut Creek also has a TeX CD. See http://www.cdrom.com:/titles/tex.html.
  204.  
  205. Other organizations may provide TeX on a CD/ROM, but I do not know the
  206. details to include them here. (Please inform me if you do.)
  207.  
  208.  
  209. Precompiled Unix TeX executables:
  210. --------------------------
  211.  
  212. (Edited from an original from George D. Greenwade <bed_gdg@shsu.edu>.)
  213.  
  214. The files in /tex-archive/systems/unix/unixkit/ are minimal sets of
  215. precompiled executables made by Sebastian Rahtz (please send
  216. questions/comments to him, at s.rahtz@elsevier.co.uk) for the various
  217. platforms using the latest web2c (version 6.1) package and techniques
  218. outlined in this file.  The one platform-independent file is
  219. share.tar.gz, which includes man pages and pool files.
  220.  
  221. Specifically excluded from this distribution in unixkit are the many
  222. additional macros and styles, fonts, and utilities which are available
  223. elsewhere in the CTAN archives -- the idea is to have the ability to get
  224. the latest files, but still have them in workable chunks for retrieval
  225. purposes. [Retrieve lib.tar.gz as discussed above for the minimal
  226. font/macro files.]
  227.  
  228. If you get these binaries, you do not need to get web.tar.gz,
  229. web2c.tar.gz, or the other source distributions.
  230.  
  231. After getting the precompiled binaries and share.tar.gz, you must still
  232. do the following:
  233. prompt$ cd <bindir>; ln virtex tex; ln virtex latex; ln virmf mf
  234.  
  235. Some of these binaries are dynamically linked; in particular, Metafont
  236. is dynamically linked against X11R5 libraries.  If you have older X or
  237. other libraries on your system, you'll either have to do the compilation
  238. or upgrade the libraries.
  239.  
  240. Acknowledgements:
  241. ----------------
  242.  
  243. The three main sites listed above are part of the Comprehensive TeX Archive 
  244. Network (CTAN) --  the result of cooperative work among members of TUG, 
  245. DANTE [German-speaking TeX Users Group], and UKTUG [U.K. TeX Users Group], 
  246. under the leadership of George Greenwade, Chair for TUG's Technical 
  247. Working Group on TeX Archive Guidelines <ctan@shsu.edu>.
  248.  
  249. Special thanks to George Greenwade for establishing the CTAN site at 
  250. Sam Houston State University (US); to Rainer Schoepf, Barbara Burr, 
  251. and members of DANTE for the CTAN site in Heidelberg (Germany); and to 
  252. Sebastian Rahtz for the CTAN site in Cambridge (UK).
  253.  
  254. unixtex.ftp was conceived and created by a wonderful person (not the
  255. current maintainer!) who wishes to remain electronically anonymous.
  256.