    8               LaTeX installation instructions for PasTeX   +                            28 February 1995        SUMMARY  =======    < This file contains instructions on how to install LaTeX for ? PasTeX on the Amiga.  Before reading this file, you should read A install.txt, which will explain how the LaTeX installation works.     This file describes:   (  * How to save any old version of LaTeX.     * How to configure LaTeX.2    (You can skip this part if you`re new to this.)   (  * How to unpack the LaTeX distribution.   "  * How to create the LaTeX format.   "  * How to install the LaTeX files.   '  * What to do if you have any problems.         
 PRELIMINARIES 
 =============   B Most of the installation procedure is concerned with creating a soA called format file. This file contains essentially all the macros C that make up the LaTeX package in a format that can be read in very  quickly by virtex.  E This guide assumes that you have an unmodified installation of PasTeX F release 1.3 or higher. If you have made any changes you should be able? to figure out yourself where to deviate from this introduction.   @ If you are using PasTeX 1.3 you should install the binaries fromB TeX:Bigbin to TeX:bin now. The normal binaries cannot be used with? LaTeX2e. Alternatively you might want to install the files from = the beta version of release 1.4. It is available on aminet as  text/tex/pt14b6.lha.  D First of all move all of the files that accompanied this document toB a directory that should be outside the TeX: hierarchy. DO NOT copyF them directly to TeX:macros! Most of the installation will take place E in this directory. If the installation was successful you can delete   this directory afterwards.     SAVING ANY OLD VERSION OF LaTeX  ===============================    D If you are currently using the old LaTeX version, 2.09, you may wish6 to save it before installing the new version of LaTeX.   D The format file is located in the directory TeX:formats and is namedD something like lplain.fmt or latex.fmt. If the name is latex.fmt youB should rename it to latex209.fmt. This installation procedure willD create a new file called latex.fmt that would overwrite the old one.  F Now you should save your old style files. Make a subdirectory latex209F in the directory TeX:macros and copy all files #?.sty from TeX:macros  into this directory.   E If you want use LaTeX 2.09 again for some reason, set the environment & variable TEXINPUTS with something like  1 setenv TEXINPUTS .,TeX:macros/latex209,TeX:macros   B Make sure that TeX:macros/latex209 comes before TeX:macros so thatG the old style files are used. (The "." refers to the current directory. B If you omit it, files in the current directory will not be found!)E Then call LaTeX with "virtex &latex209" (or "virtex &lplain", if that % was the name of the old format file).      CONFIGURING LATEX  =================    = If you have PasTeX release 1.3, you may wish to edit the file ? texsys.cfg to have LaTeX work around some quirks in the version ? of virtex that comes with it. First find out the actual version 4 of virtex with the command "version TeX:bin/virtex".@ Then edit the file texsys.cfg and insert a line right at the top
 containing   \def\@TeXversion{3.14}  @ and, of course, insert your actual version number if it differs.= This change is however purely cosmetical and only affects the  format of warning messages.     K If at some point TeX runs out of memory it will stop with an error message. E You can try and make more memory available to TeX by editing the file G TeX:config/tex.cnf. Try to figure out which parameter might have caused 7 TeX to run out of memory. If the error message said e.g D "Font <foobar> not loaded: Not enough room left", you should look atB the parameter fontmax and/or fontmemsize. A good place to start isH always the pair memmax and memtop. Read the comment in the file for more information.  D >From TeX version 3.0 you have the possibility to have more than oneD set of hyphenation atterns available in a format file.  See the file9 texpert.txt for more details of how this can be achieved.       UNPACKING THE DISTRIBUTION ==========================   C Cd to the directory that contains the distribution files. Check if  B there is a file called "latex.ltx". If there is you probably have D got a distribution that already has been unpacked and can skip this D part. If there is a problem with a missing file at some point during0 the installation, try unpacking it again anyway.  A If latex.ltx does not exist, the command "initex unpack.ins" will B unpack the distribution. If you have an 68000 based Amiga, now is $ the time to go and make some coffee.       CREATING THE LaTeX FORMAT  =========================    A When the unpacking procedure is complete type "initex latex.ltx". C This will create the format file. When this is finished, copy it to = TeX:formats. Make sure you do not overwrite an old latex.fmt, + especially if there have been any problems.       + PUTTING THE FILES WHERE LaTeX CAN READ THEM + ===========================================    E Now you need to install the new style files and everything else LaTeX . needs. Copy the following files to TeX:macros:  8       latexbug.tex testpage.tex docstrip.tex lablst.tex 3       idx.tex nfssfont.tex small2e.tex sample2e.tex .       #?.cls #?.clo #?.sty #?.fd #?.def #?.cfg       E If you have MakeIndex installed, copy #?.ist to the MakeIndex inputs  
 directory.      % CHECKING THAT THE INSTALLATION WORKED % =====================================    A Now you can check if the installation worked. First cd to another > directory that does not contain any of the distribution files.A Copy the file ltxcheck.tex here and type "virtex &latex ltxcheck" B to the shell prompt. TeX will report that it cannot find a syntax C for the current directory, but that is OK. (If you figure out a way A to refer to the current directory, like UNIX ./, please tell us.)   E It will then check if it can find the file article.cls in the current = directory and issue an error because it will find the file in D TeX:macros. This is actually a good sign. Simply press return to the question mark.    B It will then check for the version of TeX currently installed. If B you have PasTeX release 1.3, which contained virtex version 3.14, : there will probably be some ^^Js cluttering up the output.  C You can edit texsys.cfg (in the distribution directory) and rebuild D the format file as suggested by the warning text (see the section onC configuring LaTeX). Or you can simply ignore this and tolerate the  E strange warning messages until you can get PasTeX release 1.4, which  C is currently in the late beta testing stage and should be publicly  > released soon. If you feel up to it, get the beta release now.B It is available as pt14b6.lha in the directory text/tex on aminet.      PROBLEMS ========   @ If there is any problem during installation, read the section onA configuring LaTeX in this document. Some of the problems that may C occur are covered there. Carefully reread the rest of the document, F then read the document install.txt, especially the `PROBLEMS' section.  D If none of these can solve your problem, try to get some human help.   C --- Copyright 1994 Christian Bauernfeind and the LaTeX3 project --- C ---                     All rights reserved.                    ---     