LaTeX installation instructions for AmiWeb2c TeX 10 February 1997 SUMMARY ======= This file contains instructions on how to install LaTeX for Web2c TeX on the Amiga (AmiWeb2c). Before reading this file, you should read install.txt, which will explain how the LaTeX installation works, and web2c.txt, which describes the UNIX version of this system. This file describes: * How to save any old version of LaTeX. * How to configure LaTeX. * How to unpack the LaTeX distribution. * How to install the LaTeX files. * How to create the LaTeX format. * What to do if you have any problems. REQUIREMENTS ============ In addition to the LaTeX distribution files, you will also need the following: * the file `AmiWeb2c/share/amiweb2c/texmf/tex/generic/local/hyphen.cfg' coming with the source distribution of AmiWeb2c, loading hyphenation patterns for US English (hyphen.tex aka ushyph1.tex) and UK English (ukhyphen.tex), and German (ghyph31.tex). In the commentary section of `hyphen.cfg' a list of many other languages is given together with references to pattern files. You may freely modify `hyphen.cfg' to suit your personal needs. SAVING ANY OLD VERSION OF LATEX =============================== Nobody should ever have installed LaTeX 2.09 with AmiWeb2c (which was first released in April/May 1995), so there is no need for special treatment of such an old version of LaTeX. CONFIGURING LATEX ================= During the installation procedure, it may be easiest to set some temporary device names. The LATEXINPUTS: directory is where the LaTeX base packages and classes will finally be installed. In the `TeX Directory Structure' assumed by AmiWeb2c this defaults to: assign LATEXINPUTS: AmiWeb2c/share/texmf/tex/latex/base The LATEXFORMAT: directory is where the LaTeX format is stored: assign LATEXFORMAT: AmiWeb2c/share/texmf/web2c The LATEXDIST: directory is where the LaTeX distribution is stored: assign LATEXDIST: AmiWeb2c/share/texmf/source/latex/base You should put all files coming with the base distribution of LaTeX in the LATEXDIST: directory. After the successful installation procedure, you can safely remove the complete LATEXDIST: directory. If you have installed the Amiga port of Web2c from scratch, you will not have to edit the file texsys.cfg at all. If you started with the ready-to-use binaries, I suggest that you get either Martin Scott's `UnixDirsII' commodity or Norbert Püschel's `DOSPrefs' commodity (my favorite) from the Aminet. The respective locations should be Aminet:/util/shell/UnixDirsII.lha Aminet:/util/misc/DOSPrefs22.lha (The former archive is also available on Fred Fish's AmigaLibDisk 837, the latter is included with "AmiWeb2c 2.0" for your convenience.) Either of these programs patch the AmigaOS so that the UNIX notations `.' and `..' are enabled for the `current' and the `parent' directory respectively. UNPACKING THE DISTRIBUTION ========================== To unpack the LaTeX distribution, you should: cd LATEXDIST: tex -ini unpack.ins This takes about 15 minutes on a 50 MHz 68030, but considerably longer on a standard 7.19 MHz 68000 (most likely several hours). Why don't you just go and make a good cup of coffee? [Personal note: on a P5/133 under the Linux operating system the very same task takes about half a minute.] PUTTING THE FILES WHERE LATEX CAN READ THEM =========================================== How was your coffee? To install the LaTeX files created in the previous step, you should: cd LATEXDIST: copy latexbug.tex testpage.tex lablst.tex idx.tex ltxcheck.tex + nfssfont.tex small2e.tex sample2e.tex docstrip.tex + #?.cls #?.clo #?.sty #?.fd #?.def #?.ltx + LATEXINPUTS: (The `+' character means that you should type this as a single command.) WARNING: This single command line most certainly exceeds the maximum length the AmigaOS is able to cope with! Please, make sure that ALL these files are correctly installed in `LATEXINPUTS:'. If you have MakeIndex installed or intend to do so, copy #?.ist to the MakeIndex inputs directory, which should be in TDS notation: AmiWeb2c/share/texmf/makeindex/ CREATING THE LATEX FORMAT ========================= After the unpacked files of the LaTeX distribution are installed at the appropriate place, you have to create the LaTeX format proper. This will conveniently be done by the following commands: cd LATEXFORMAT: tex -ini latex.ltx Thus the format file latex.fmt will be created at the correct place and also the correctness of the installation will be tested, because the necessary files will be read from the appropriate paths. If you intend to use any of the advanced features provided by `enhanced TeX', like left-to-right typesetting, you should instead use the commands cd LATEXFORMAT: e-tex -ini *latex.ltx to create the format file. (Note the asterisk in front of `latex.ltx'; this invokes a special feature of the tex binary, i.e., the `extended mode of e-TeX 1.1'.) You have now installed LaTeX! GETTING A WORKING LATEX ======================= Add the following lines to your User-StartUp file in the S: directory: alias ELaTeX "tex &latex \language=\USenglish \input " alias GLaTeX "tex &latex \language=\german \input " alias MyLaTeX "tex &latex \language=\ \input " For the time being until you next reboot your system, you should type these (and possibly other) commands on the command line input. A list of aliases that could serve as convenient examples is included in the file `AmiWeb2c/share/amiweb2c/source/s/User-StartUp.entry' (or you can it `execute' the whole script in your own `User-StartUp' file). CHECKING THAT THE INSTALLATION WORKED ===================================== To check that the installation worked, you should: cd LATEXFORMAT: latex ltxcheck This will perform a number of tests, which should all report `OK'. PROBLEMS ======== `texsys.cfg': While running IniTeX on latex.ltx you might encounter the error message `! Bad texsys.cfg file: \@currdir .' AmiWeb2c 2 comes with its own version of the `texsys.cfg' file, setting `\@currdir' to the UNIX-equivalent `./' notation. By its very nature, the Amiga does not understand the `.' and `..' notation for the current and the parent directory. In order to fix this situation you will have to install either (but NOT both!) of the commodities `UnixDirsII' and `DOSPrefs' before installing LaTeX (see the related section above). `File missing': As long as the default search paths of AmiWeb2c are correctly set up and used, you won't encounter this message. `Font missing': Some of the fonts, i.e., tfm files, required by LaTeX are missing. In addition to the 75 standard fonts of the `Computer Modern' family, several additional fonts are needed. Run MetaFont on the respective font drivers and install the tfm files in the AmiWeb2c/share/texmf/fonts/tfm// directory structure. `Out of memory': The memory configuration file `texmf.cnf' coming with the the source distribution of AmiWeb2c in `AmiWeb2c/bin/amiweb2c/' was used for the installation of LaTeX on my system, so it should be appropriate for your machine too. Since AmiWeb2c is directly descended from the UNIX Web2c distribution, its binaries are designed for a BigTeX setup. If you really want to install it on machines with less than 4 MB of RAM, you will most likely have to restrict yourself to a single language in `AmiWeb2c/share/amiweb2c/texmf/tex/generic/local/hyphen.cfg' and comment the value for `triesize' in `AmiWeb2c/bin/amiweb2c/texmf.cnf' in order to start IniTeX (tex -ini). Please do not request a SmallTeX version of AmiWeb2c, it just can't be done. CLEARING UP =========== You may now be wondering what to do with all the remaining files that are not needed to run LaTeX. This is, of course, a matter of personal taste and availability of disk space but here is some guidance. * The files with extension .dtx, together with source2e.tex, can be used to typeset the documented source code (see texpert.txt for further information). * The files with extension .fdd contain the documented sources for the font definition files. * The files ltnews.tex and ltnews.ps both contain the lastest LaTeX newsletter. * The files with extension .txt contain information about (amongst other things) copyright, installation, patches and bug-reports; and those with extension .err contain errata lists for various publications: see 00readme.txt for further details. * The files with names of the form guide.tex contain reference information convering only those features new to this version of LaTeX: they are not intended to be either a user guide or a complete reference. * The files with extension .ltx, together with latexcheck.tex, are used to create and test the format; therefore you should keep these together with the installed LaTeX system in the LATEXINPUTS: directory if you expect to remake the format before getting the next full distribution. * The files with extension .ins are used to unpack the code from the .dtx and .fdd files. * We recommend that you keep, in the LATEXFORMAT: directory, the transcript file latex.log that was produced whilst creating the format. If you don't need the documentation or if you are lacking enough disk space to permanently keep the LaTeX distribution files, you can now safely: delete LATEXDIST:#? SYSTEM-SPECIFIC SECTIONS ======================== As the maintainer and distributor of AmiWeb2c I'm interested in feedback about problems with the application of this TeX system for the Amiga. Please report difficulties in installing and/or using LaTeX that are clearly related to any (mis)feature of AmiWeb2c to Andreas Scherer Rochusstraße 22-24 52062 Aachen, Germany --- Copyright 1995, 1997 Andreas Scherer and the LaTeX3 project. --- --- All rights reserved. ---