home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / texmf / inputs / latex / unpacked / pastex.txt < prev    next >
Text File  |  1995-06-21  |  7KB  |  194 lines
  1.  
  2.  
  3.               LaTeX installation instructions for PasTeX
  4.  
  5.                            28 February 1995
  6.  
  7.  
  8. SUMMARY
  9. =======
  10.  
  11. This file contains instructions on how to install LaTeX for 
  12. PasTeX on the Amiga.  Before reading this file, you should read
  13. install.txt, which will explain how the LaTeX installation works.
  14.  
  15. This file describes:
  16.  
  17.  * How to save any old version of LaTeX.
  18.  
  19.  * How to configure LaTeX.
  20.    (You can skip this part if you`re new to this.)
  21.  
  22.  * How to unpack the LaTeX distribution.
  23.  
  24.  * How to create the LaTeX format.
  25.  
  26.  * How to install the LaTeX files.
  27.  
  28.  * What to do if you have any problems.
  29.  
  30.  
  31.  
  32. PRELIMINARIES
  33. =============
  34.  
  35. Most of the installation procedure is concerned with creating a so
  36. called format file. This file contains essentially all the macros
  37. that make up the LaTeX package in a format that can be read in very
  38. quickly by virtex.
  39.  
  40. This guide assumes that you have an unmodified installation of PasTeX
  41. release 1.3 or higher. If you have made any changes you should be able
  42. to figure out yourself where to deviate from this introduction.
  43.  
  44. If you are using PasTeX 1.3 you should install the binaries from
  45. TeX:Bigbin to TeX:bin now. The normal binaries cannot be used with
  46. LaTeX2e. Alternatively you might want to install the files from
  47. the beta version of release 1.4. It is available on aminet as
  48. text/tex/pt14b6.lha.
  49.  
  50. First of all move all of the files that accompanied this document to
  51. a directory that should be outside the TeX: hierarchy. DO NOT copy
  52. them directly to TeX:macros! Most of the installation will take place 
  53. in this directory. If the installation was successful you can delete 
  54. this directory afterwards.
  55.  
  56.  
  57. SAVING ANY OLD VERSION OF LaTeX
  58. ===============================
  59.  
  60. If you are currently using the old LaTeX version, 2.09, you may wish
  61. to save it before installing the new version of LaTeX.
  62.  
  63. The format file is located in the directory TeX:formats and is named
  64. something like lplain.fmt or latex.fmt. If the name is latex.fmt you
  65. should rename it to latex209.fmt. This installation procedure will
  66. create a new file called latex.fmt that would overwrite the old one.
  67.  
  68. Now you should save your old style files. Make a subdirectory latex209
  69. in the directory TeX:macros and copy all files #?.sty from TeX:macros 
  70. into this directory.
  71.  
  72. If you want use LaTeX 2.09 again for some reason, set the environment
  73. variable TEXINPUTS with something like
  74.  
  75. setenv TEXINPUTS .,TeX:macros/latex209,TeX:macros
  76.  
  77. Make sure that TeX:macros/latex209 comes before TeX:macros so that
  78. the old style files are used. (The "." refers to the current directory.
  79. If you omit it, files in the current directory will not be found!)
  80. Then call LaTeX with "virtex &latex209" (or "virtex &lplain", if that
  81. was the name of the old format file).
  82.  
  83.  
  84. CONFIGURING LATEX
  85. =================
  86.  
  87. If you have PasTeX release 1.3, you may wish to edit the file
  88. texsys.cfg to have LaTeX work around some quirks in the version
  89. of virtex that comes with it. First find out the actual version
  90. of virtex with the command "version TeX:bin/virtex".
  91. Then edit the file texsys.cfg and insert a line right at the top
  92. containing
  93.  
  94. \def\@TeXversion{3.14}
  95.  
  96. and, of course, insert your actual version number if it differs.
  97. This change is however purely cosmetical and only affects the
  98. format of warning messages.
  99.  
  100.  
  101. If at some point TeX runs out of memory it will stop with an error message.
  102. You can try and make more memory available to TeX by editing the file
  103. TeX:config/tex.cnf. Try to figure out which parameter might have caused
  104. TeX to run out of memory. If the error message said e.g
  105. "Font <foobar> not loaded: Not enough room left", you should look at
  106. the parameter fontmax and/or fontmemsize. A good place to start is
  107. always the pair memmax and memtop. Read the comment in the file for more
  108. information.
  109.  
  110. >From TeX version 3.0 you have the possibility to have more than one
  111. set of hyphenation atterns available in a format file.  See the file
  112. texpert.txt for more details of how this can be achieved.
  113.  
  114.  
  115. UNPACKING THE DISTRIBUTION
  116. ==========================
  117.  
  118. Cd to the directory that contains the distribution files. Check if 
  119. there is a file called "latex.ltx". If there is you probably have 
  120. got a distribution that already has been unpacked and can skip this 
  121. part. If there is a problem with a missing file at some point during
  122. the installation, try unpacking it again anyway.
  123.  
  124. If latex.ltx does not exist, the command "initex unpack.ins" will
  125. unpack the distribution. If you have an 68000 based Amiga, now is 
  126. the time to go and make some coffee.
  127.  
  128.  
  129. CREATING THE LaTeX FORMAT
  130. =========================
  131.  
  132. When the unpacking procedure is complete type "initex latex.ltx".
  133. This will create the format file. When this is finished, copy it to
  134. TeX:formats. Make sure you do not overwrite an old latex.fmt,
  135. especially if there have been any problems.
  136.  
  137.  
  138. PUTTING THE FILES WHERE LaTeX CAN READ THEM
  139. ===========================================
  140.  
  141. Now you need to install the new style files and everything else LaTeX
  142. needs. Copy the following files to TeX:macros:
  143.  
  144.       latexbug.tex testpage.tex docstrip.tex lablst.tex 
  145.       idx.tex nfssfont.tex small2e.tex sample2e.tex
  146.       #?.cls #?.clo #?.sty #?.fd #?.def #?.cfg
  147.       
  148. If you have MakeIndex installed, copy #?.ist to the MakeIndex inputs 
  149. directory.
  150.  
  151.  
  152. CHECKING THAT THE INSTALLATION WORKED
  153. =====================================
  154.  
  155. Now you can check if the installation worked. First cd to another
  156. directory that does not contain any of the distribution files.
  157. Copy the file ltxcheck.tex here and type "virtex &latex ltxcheck"
  158. to the shell prompt. TeX will report that it cannot find a syntax 
  159. for the current directory, but that is OK. (If you figure out a way
  160. to refer to the current directory, like UNIX ./, please tell us.)
  161.  
  162. It will then check if it can find the file article.cls in the current
  163. directory and issue an error because it will find the file in
  164. TeX:macros. This is actually a good sign. Simply press return to the
  165. question mark. 
  166.  
  167. It will then check for the version of TeX currently installed. If 
  168. you have PasTeX release 1.3, which contained virtex version 3.14, 
  169. there will probably be some ^^Js cluttering up the output.
  170.  
  171. You can edit texsys.cfg (in the distribution directory) and rebuild
  172. the format file as suggested by the warning text (see the section on
  173. configuring LaTeX). Or you can simply ignore this and tolerate the 
  174. strange warning messages until you can get PasTeX release 1.4, which 
  175. is currently in the late beta testing stage and should be publicly 
  176. released soon. If you feel up to it, get the beta release now.
  177. It is available as pt14b6.lha in the directory text/tex on aminet.
  178.  
  179.  
  180. PROBLEMS
  181. ========
  182.  
  183. If there is any problem during installation, read the section on
  184. configuring LaTeX in this document. Some of the problems that may
  185. occur are covered there. Carefully reread the rest of the document,
  186. then read the document install.txt, especially the `PROBLEMS' section.
  187.  
  188. If none of these can solve your problem, try to get some human help.
  189.  
  190. --- Copyright 1994 Christian Bauernfeind and the LaTeX3 project ---
  191. ---                     All rights reserved.                    ---
  192.  
  193.  
  194.