home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1B / DATAFILE_PDCD1B.iso / _tex / tex / source / l2esrc1 / !TeX / LaTeX2eSrc / install.txt < prev    next >
Text File  |  1994-07-28  |  13KB  |  394 lines
  1.                            LaTeX Installation Guide
  2.  
  3.                                 20 July 1994
  4.  
  5. SUMMARY
  6. =======
  7.  
  8. This file contains the installation instructions for the latest
  9. version of the LaTeX document preparation system.
  10.  
  11. The rest of this document describes:
  12.  
  13.  * How to find out about installing LaTeX for your version of TeX.
  14.  
  15.  * How the installation works.
  16.  
  17.  * What to do if anything goes wrong.
  18.  
  19. TeX experts who want to know more about how the LaTeX installation 
  20. works and how it can be customized may like to read texpert.txt.
  21.  
  22.  
  23. DOCUMENTATION
  24. =============
  25.  
  26. Brief introductions to various aspects of the new LaTeX release can be
  27. found in the distributed files with names <*>guide.tex.  You will need
  28. to install the new version before you can typeset these files.
  29.  
  30. A full description of the new LaTeX release (and of more than 100
  31. packages that can be used with LaTeX) can be found in:
  32.  
  33.  * The LaTeX Companion, Goossens, Mittelbach and Samarin, Addison-Wesley
  34.    ISBN 0-201-54199-8.
  35.  
  36. The new release is also described in the second edition of:
  37.  
  38.  * LaTeX A Document Preparation System, Leslie Lamport, Addison-Wesley
  39.  
  40.  
  41. REQUIREMENTS
  42. ============
  43.  
  44. In addition to the LaTeX distribution files, you will also need the
  45. following:
  46.  
  47.  * a TeX system, including iniTeX (see `Your Version of TeX', below);
  48.  
  49.  * the file `hyphen.tex', or some other hyphenation files (see `Creating
  50.    the LaTeX Format', below);
  51.  
  52.  * the font files (normally .tfm files) for the Computer Modern fonts,
  53.    including some non-standard ones (see `Fonts needed', below).
  54.  
  55.  
  56. YOUR VERSION OF TEX
  57. ===================
  58.  
  59. LaTeX is based upon Donald Knuth's TeX typesetting system.  This is 
  60. available for almost every make of computer, from microcomputers
  61. through workstations to large main-frames.  
  62.  
  63. Further details about how to install LaTeX for your version of TeX may
  64. be available in a file called <system>.txt.  At present the following
  65. such files exist (at least):
  66.  
  67.  * directex.txt for DirectTeX on the MAC.
  68.  
  69.  * emtex.txt for emTeX on the PC.
  70.  
  71.  * microtex.txt for MicroTeX (uTeX) on the PC. 
  72.  
  73.  * oztex.txt for OzTeX on the Macintosh.
  74.  
  75.  * web2ctex.txt for web2c TeX on Unix platforms.
  76.  
  77.  * yandytex.txt for Y&YTeX on IBM PC compatibles. 
  78.  
  79. You should finish reading this file before reading the <system>.txt
  80. file for your system.  If there is no such file then this file alone is
  81. your installation guide.
  82.  
  83. If you have bought a commercial version of TeX/LaTeX and there is no
  84. file for your system then you could ask the company which sells your
  85. version of TeX to supply one.
  86.  
  87. Note to TeX implementors/suppliers:
  88. ----------------------------------
  89. If you can supply us with a <system>.txt file for your implementation
  90. we shall be very grateful and we shall add it to our distribution.
  91.  
  92.  
  93.  
  94. HOW THE INSTALLATION WORKS
  95. ==========================
  96.  
  97. The LaTeX installation is in four stages:
  98.  
  99.  * Saving any old version of LaTeX.
  100.  
  101.  * Unpacking the distribution (this may not be necessary).
  102.  
  103.  * Creating the LaTeX format.
  104.  
  105.  * Putting the files where LaTeX can read them.
  106.  
  107.  * Checking the installation.
  108.  
  109.  
  110. SAVING ANY OLD VERSION OF LaTeX
  111. ===============================
  112.  
  113. If you are currently using the old LaTeX version, 2.09, you may wish
  114. to save it before installing the new version of LaTeX.
  115.  
  116. If it exists, the <system>.txt file will describe in detail how to do
  117. this; in some of these files, the new version is referred to as
  118. LaTeX2e in order to clearly distinguish it from the old version.
  119.  
  120. The details of how to do everything in this section will depend to a
  121. very large extent on your TeX implementation.
  122.  
  123. First you should find the LaTeX format file on your system
  124. (usually called `latex.fmt' or `lplain.fmt') and rename it to
  125. `latex209.fmt'.
  126.  
  127. You should then save a copy of the LaTeX system files.  These may be
  128. kept in a TeX inputs directory or folder, which is usually called
  129. something like one of these:
  130.  
  131.    tex\texinput  tex/inputs  TeX-inputs
  132.  
  133. or they may be kept in a separate LaTeX inputs location, possibly a
  134. subdirectory or subfolder of the TeX inputs location, called `latex'.
  135.    
  136. There are thus two possibilities, depending on whether the LaTeX
  137. inputs have been kept separate from the other TeX inputs or not.
  138.  
  139.  * If the LaTeX inputs are separated from the other TeX inputs, then
  140.    you should make a new directory that is a copy of the whole of the
  141.    LaTeX inputs directory, and call it `latex209'.
  142.    
  143.  * If the LaTeX inputs are kept with the other TeX inputs, then you 
  144.    should create a new directory called `latex209' and then copy to it
  145.    any file ending with .sty from the LaTeX inputs directory.
  146.    
  147. It may be possible to run both the new LaTeX and LaTeX 2.09 in
  148. parallel.  To do this, you should create a `latex209' command,
  149. or menu entry, that is similar to `latex' except that:
  150.  
  151.  * The `latex209' format is used rather than `latex'.
  152.  
  153.  * The `latex209' directory is searched before the LaTeX inputs
  154.    directory.
  155.  
  156.  
  157. BEFORE UNPACKING THE DISTRIBUTION
  158. =================================
  159.  
  160. Latex needs a number of files to run, for example `article.cls'
  161. contains the `article' document class.  However, these files are NOT
  162. themselves the source files produced by the LaTeX3 Project Team.  We
  163. write documented sources in `docstrip archive files' which can be
  164. unpacked to produce the files that LaTeX needs. For example,
  165. classes.dtx contains the documented sources for all the LaTeX
  166. document classes, including article.cls.
  167.  
  168. The FIRST thing to do is to check whether you need to unpack these
  169. archive files, as follows.
  170.  
  171. Before reading any further, you should check to see whether the LaTeX
  172. distribution you have contains the unpacked files.  You can do this by
  173. looking to see if you have got the file latex.ltx.  If you do, then
  174. you should have all the unpacked files and so you can move on to the
  175. section entitled `Creating the LaTeX format'.
  176.  
  177. The unpacking will create and write files only into the current
  178. directory (or current folder, or default directory).  This helps to
  179. prevent it overwriting existing files or causing problems with your
  180. system files.  It is therefore sensible to carry out the installation
  181. in a directory reserved for this purpose; on a multi-user system you
  182. should ensure that you have read and write permissions for files in
  183. this directory.
  184.  
  185. UNPACKING THE DISTRIBUTION
  186. ==========================
  187.  
  188. The archive files are unpacked by running iniTeX on the file 
  189. unpack.ins.
  190.  
  191. NOTE: On relatively slow computers, this unpacking can take a long
  192. time.  On a Macintosh IIfx it takes about 3 hours.  On a Macintosh
  193. Duo 230 or a 12MHz 80286 PC it takes about 30 minutes.  On a moderately
  194. busy SparcStation 10 or a fast 80486 PC it takes about 5 minutes.
  195.  
  196.  
  197. CREATING THE LATEX FORMAT
  198. =========================
  199.  
  200. To create the LaTeX format, you should run iniTeX on the file
  201. `latex.ltx'.  
  202.  
  203. A hyphenation file such as `hyphen.tex' is read by this run so it
  204. should be accessible by iniTeX.  It also needs to be able to read the
  205. `.tfm' font files for the basic fonts.  These font files and
  206. hyphenation file(s) should be part of your TeX system.
  207.  
  208. You should save the resulting format file `latex.fmt' in the TeX
  209. formats directory.  You may also have to create and/or install a
  210. program called `latex', a `LaTeX' option to your TeX implementation,
  211. or a batch file or shell script.  The details of this stage will
  212. depend on your TeX implementation; note that the name of the format
  213. file differs from that normally used in LaTeX 2.09.
  214.  
  215. Note: TeX experts may wish to customize LaTeX (for example, to allow 
  216. non-American hyphenation).  They should read texpert.txt to find out 
  217. how to do this.
  218.  
  219.  
  220. PUTTING THE FILES WHERE LaTeX CAN READ THEM
  221. ===========================================
  222.  
  223. The next step in the installation of LaTeX is to move the files needed
  224. to run the system into the correct directories (or folders).
  225. These are:
  226.  
  227.  * the directory containing the format files.
  228.  
  229.  * the LaTeX inputs directory, which contains LaTeX system files.
  230.  
  231.  * the MakeIndex inputs directory, which contains MakeIndex files.
  232.  
  233. You should move to the formats directory:
  234.  
  235.  * latex.fmt.
  236.  
  237. You should move to the LaTeX input directory the files:
  238.  
  239.  * latexbug.tex, testpage.tex, l