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 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. (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 ============= Most of the installation procedure is concerned with creating a so called format file. This file contains essentially all the macros that make up the LaTeX package in a format that can be read in very quickly by virtex. This guide assumes that you have an unmodified installation of PasTeX 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 from 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. First of all move all of the files that accompanied this document to a directory that should be outside the TeX: hierarchy. DO NOT copy them directly to TeX:macros! Most of the installation will take place in this directory. If the installation was successful you can delete this directory afterwards. SAVING ANY OLD VERSION OF LaTeX =============================== If you are currently using the old LaTeX version, 2.09, you may wish to save it before installing the new version of LaTeX. The format file is located in the directory TeX:formats and is named something like lplain.fmt or latex.fmt. If the name is latex.fmt you should rename it to latex209.fmt. This installation procedure will create a new file called latex.fmt that would overwrite the old one. Now you should save your old style files. Make a subdirectory latex209 in the directory TeX:macros and copy all files #?.sty from TeX:macros into this directory. If you want use LaTeX 2.09 again for some reason, set the environment variable TEXINPUTS with something like setenv TEXINPUTS .,TeX:macros/latex209,TeX:macros Make sure that TeX:macros/latex209 comes before TeX:macros so that the old style files are used. (The "." refers to the current directory. If you omit it, files in the current directory will not be found!) 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 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. If at some point TeX runs out of memory it will stop with an error message. You can try and make more memory available to TeX by editing the file TeX:config/tex.cnf. Try to figure out which parameter might have caused TeX to run out of memory. If the error message said e.g "Font not loaded: Not enough room left", you should look at the parameter fontmax and/or fontmemsize. A good place to start is always the pair memmax and memtop. Read the comment in the file for more information. >From TeX version 3.0 you have the possibility to have more than one set of hyphenation atterns available in a format file. See the file texpert.txt for more details of how this can be achieved. UNPACKING THE DISTRIBUTION ========================== Cd to the directory that contains the distribution files. Check if there is a file called "latex.ltx". If there is you probably have got a distribution that already has been unpacked and can skip this part. If there is a problem with a missing file at some point during the installation, try unpacking it again anyway. If latex.ltx does not exist, the command "initex unpack.ins" will unpack the distribution. If you have an 68000 based Amiga, now is the time to go and make some coffee. CREATING THE LaTeX FORMAT ========================= When the unpacking procedure is complete type "initex latex.ltx". 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 =========================================== Now you need to install the new style files and everything else LaTeX needs. Copy the following files to TeX:macros: latexbug.tex testpage.tex docstrip.tex lablst.tex idx.tex nfssfont.tex small2e.tex sample2e.tex #?.cls #?.clo #?.sty #?.fd #?.def #?.cfg If you have MakeIndex installed, copy #?.ist to the MakeIndex inputs directory. CHECKING THAT THE INSTALLATION WORKED ===================================== Now you can check if the installation worked. First cd to another directory that does not contain any of the distribution files. Copy the file ltxcheck.tex here and type "virtex &latex ltxcheck" to the shell prompt. TeX will report that it cannot find a syntax for the current directory, but that is OK. (If you figure out a way to refer to the current directory, like UNIX ./, please tell us.) 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 TeX:macros. This is actually a good sign. Simply press return to the question mark. It will then check for the version of TeX currently installed. If you have PasTeX release 1.3, which contained virtex version 3.14, there will probably be some ^^Js cluttering up the output. You can edit texsys.cfg (in the distribution directory) and rebuild the format file as suggested by the warning text (see the section on configuring LaTeX). Or you can simply ignore this and tolerate the strange warning messages until you can get PasTeX release 1.4, which 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. It is available as pt14b6.lha in the directory text/tex on aminet. PROBLEMS ======== If there is any problem during installation, read the section on configuring LaTeX in this document. Some of the problems that may occur are covered there. Carefully reread the rest of the document, then read the document install.txt, especially the `PROBLEMS' section. If none of these can solve your problem, try to get some human help. --- Copyright 1994 Christian Bauernfeind and the LaTeX3 project --- --- All rights reserved. ---