  =              LaTeX installation instructions for AmiWeb2C TeX   ,                                27 March 1995     SUMMARY  =======   E This file contains instructions on how to install LaTeX for Web2C TeX C on the Amiga (AmiWeb2C).  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.  (  * 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.      REQUIREMENTS ============  C In addition to the LaTeX distribution files, you will also need the 
 following:  D  * the file `hyphen.tex' with the single line `\input hyphen.multi'.  A  * the file `hyphen.multi' coming with the source distribution of F    AmiWeb2C, loading hyphenation patterns for US English (ushyph1.tex)B    and UK English (ukhyphen.tex), German (ghyph31.tex), and FrenchE    (fhyphen.tex).  In the commentary section of `hyphen.multi' a list @    of many other languages is given together with pattern files.D    You may freely modify `hyphen.multi' to suit your personal needs.  A This `hyphen.tex/hyphen.multi' mechanism works for plainTeX also.      SAVING ANY OLD VERSION OF LATEX  ===============================   G The Amiga port of the Web2C TeX system is so brand new that there is no F danger that anybody had LaTeX 2.09 installed (and probably nobody everJ will).  Since the `TeX Directory Structure' assumed by AmiWeb2C is totallyK different to any other TeX installation on the Amiga, there is also no risk ) that existing files could be overwritten.      CONFIGURING LATEX  =================   J During the installation procedure, it may be easiest to set some temporary
 device names.   G The LATEXINPUTS: directory is where the LaTeX base packages and classes G will finally be installed.  In the `TeX Directory Structure' assumed by  AmiWeb2C this defaults to:  +    assign LATEXINPUTS: TeXMF:tex/latex/base   H The LATEXFORMATS: directory is where the LaTeX format is kept.  This is:  3    assign LATEXFORMATS: TeXMF:web2c61/formats/latex   K The LATEXDIST: directory is where the LaTeX distribution is kept.  This is:   ,    assign LATEXDIST: TeXMF:source/latex/base  J You should put all files coming with the base distribution of LaTeX in theK LATEXDIST: directory.  After the successful installation procedure, you can 0 safely remove the complete LATEXDIST: directory.  H If you have installed the Amiga port of Web2C from scratch, you will notH have to edit the file texsys.cfg at all (when the installation procedureI prompts you that it can't find texsys.cfg, simply type <return>).  If you E started with the ready-to-use binaries, I suggest that you get Martin - Scott's `UnixDirsII' package from the AmiNet:   $    AmiNet:/util/shell/UnixDirsII.lha  G (This archive is also available on Fred Fish's AmigaLibDisk 837.)  This G program patches the AmigaOS so that the UNIX notations `.' and `..' are B enabled for the `current' and the `parent' directory respectively.  I If you do not use the memory configuration file `tex.mcf' coming with the H source distribution of AmiWeb2C, you should make sure that `poolsize' isI set to at least 75000 and `fontmemsize' is set to at least 36000.  If you J want to use multiple hyphenation patterns, set `triesize' and `trieopsize'J and `maxtrieop' conveniently higher than the defaults (40000/1000/500 is a3 suitable choice in connection with `hyphen.multi').      UNPACKING THE DISTRIBUTION ==========================  - To unpack the LaTeX distribution, you should:       cd LATEXDIST:    initex unpack.ins  I This may take 15 to 20 minutes on a 50 MHz 68030, but considerably longer I on a standard 7.19 MHz 68000 (approximately 4 hours).  Why don't you just ! go and make a good cup of coffee?      CREATING THE LATEX FORMAT  =========================   K How was your coffee?  When the unpacking procedure is complete, you should:       cd LATEXDIST:    initex latex.ltx   J This will create the format file latex.fmt.  You should install this with:  !    rename latex.fmt LATEXFORMATS:     + PUTTING THE FILES WHERE LATEX CAN READ THEM + ===========================================   D To install the LaTeX files created in the previous step, you should:      cd LATEXDIST:8    rename latexbug.tex testpage.tex lablst.tex idx.tex +:       nfssfont.tex small2e.tex sample2e.tex docstrip.tex +0       #?.cls #?.clo #?.sty #?.fd #?.def #?.cfg +    LATEXINPUTS:   F If you have MakeIndex installed or intend to do so, copy #?.ist to the, MakeIndex inputs directory, which should be:  +    setenv INDEXSTYLE TeXMF:makeindex/styles    You have now installed LaTeX!      GETTING A WORKING LATEX  =======================   F Add the following lines to your User-StartUp file in the S: directory:  <    alias LaTeX  "virtex &latex \language=\german    \input "<    alias ELaTeX "virtex &latex \language=\USenglish \input "  E For the time being until you next reboot your system, you should type > these (and possibly other) commands on the command line input.    % CHECKING THAT THE INSTALLATION WORKED % =====================================   2 To check that the installation worked, you should:      cd LATEXDIST:    latex ltxcheck   B This will perform a number of tests, which should all report `OK'.     PROBLEMS ========  E `texsys.cfg':  While running iniTeX on latex.ltx you will be prompted D    that this file can't be found on your system.  This is a feature!E    Given that you have `UnixDirsII' installed you may safely continue D    by typing <return>.  The standard notation `./' for the `current'    directory will be assumed.   D `File missing':  As long as the default search paths of AmiWeb2C are6    correctly set up, you won't encounter this message.  F `Font missing':  Some of the fonts, i.e., tfm files, required by LaTeXF    are missing.  In addition to the 75 standard fonts of the `ComputerE    Modern' family, several additional fonts are needed.  Run MetaFont B    on the respective font drivers and install the tfm files in the)    TeXMF:fonts/tfm// directory structure.   I `Out of memory':  The memory configuration file `tex.mcf' coming with the I    source distribution of AmiWeb2C was used for the installation of LaTeX G    on my system, so it should be appropriate for your machine also.  In G    case of exhausted memory, there must be reductions in `tex.mcf' that     should be undone.     CLEARING UP  ===========   I You may now be wondering what to do with all the remaining files that are H not needed to run LaTeX.  This is, of course, a matter of personal taste9 and availability of disk space but here is some guidance.   I  * The files with extension .dtx, together with source2e.tex, can be used E    to typeset the documented source code (see texpert.txt for further     information).  G  * The files with extension .fdd contain the documented sources for the     font definition files.   F  * The files ltnews<xx>.tex and ltnews<xx>.ps both contain the lastest    LaTeX newsletter.  I  * The files with extension .txt contain information about (amongst other F    things) copyright, installation, patches and bug-reports; and thoseE    with extension .err contain errata lists for various publications: (    see 00readme.txt for further details.  D  * The files with names of the form <xxx>guide.tex contain referenceJ    information convering only those features new to this version of LaTeX:K    they are not intended to be either a user guide or a complete reference.   H  * The files with extension .ltx, together with latexcheck.tex, are usedJ    to create and test the format; therefore you should keep these togetherG    with the installed LaTeX system in the LATEXINPUTS: directory if you I    expect to remake the format before getting the next full distribution.   E  * The files with extension .ins are used to unpack the code from the     .dtx and .fdd files.   B  * We recommend that you keep, in the LATEXFORMATS: directory, theJ    transcript file latex.log that was produced whilst creating the format.  F If you don't need the documentation are if you are lacking enough diskK space to permanently keep the LaTeX distribution files, you can now safely:       delete LATEXDIST: all     SYSTEM-SPECIFIC SECTIONS ========================  H As the maintainer and distributor of AmiWeb2C I'm very interested in anyJ feedback about problems with the application of the new TeX for the Amiga.G Please report difficulties in installation and/or use of LaTeX that are 2 clearly related to any (mis)feature of AmiWeb2C to      Andreas Scherer    Roland-Stra{\ss}e 16     52070 Aachen, Germany.    <scherer@genesis.informatik.rwth-aachen.de>    > --- Copyright 1995 Andreas Scherer and the LaTeX3 project. ---> ---                 All rights reserved.                   ---