
             LaTeX installation instructions for AmiWeb2C TeX

                               27 March 1995


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.

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
============

In addition to the LaTeX distribution files, you will also need the
following:

 * the file `hyphen.tex' with the single line `\input hyphen.multi'.

 * the file `hyphen.multi' coming with the source distribution of
   AmiWeb2C, loading hyphenation patterns for US English (ushyph1.tex)
   and UK English (ukhyphen.tex), German (ghyph31.tex), and French
   (fhyphen.tex).  In the commentary section of `hyphen.multi' a list
   of many other languages is given together with pattern files.
   You may freely modify `hyphen.multi' to suit your personal needs.

This `hyphen.tex/hyphen.multi' mechanism works for plainTeX also.


SAVING ANY OLD VERSION OF LATEX
===============================

The Amiga port of the Web2C TeX system is so brand new that there is no
danger that anybody had LaTeX 2.09 installed (and probably nobody ever
will).  Since the `TeX Directory Structure' assumed by AmiWeb2C is totally
different to any other TeX installation on the Amiga, there is also no risk
that existing files could be overwritten.


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: TeXMF:tex/latex/base

The LATEXFORMATS: directory is where the LaTeX format is kept.  This is:

   assign LATEXFORMATS: TeXMF:web2c61/formats/latex

The LATEXDIST: directory is where the LaTeX distribution is kept.  This is:

   assign LATEXDIST: 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 (when the installation procedure
prompts you that it can't find texsys.cfg, simply type <return>).  If you
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

(This archive is also available on Fred Fish's AmigaLibDisk 837.)  This
program patches the AmigaOS so that the UNIX notations `.' and `..' are
enabled for the `current' and the `parent' directory respectively.

If you do not use the memory configuration file `tex.mcf' coming with the
source distribution of AmiWeb2C, you should make sure that `poolsize' is
set to at least 75000 and `fontmemsize' is set to at least 36000.  If you
want to use multiple hyphenation patterns, set `triesize' and `trieopsize'
and `maxtrieop' conveniently higher than the defaults (40000/1000/500 is a
suitable choice in connection with `hyphen.multi').


UNPACKING THE DISTRIBUTION
==========================

To unpack the LaTeX distribution, you should:

   cd LATEXDIST:
   initex unpack.ins

This may take 15 to 20 minutes on a 50 MHz 68030, but considerably longer
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
=========================

How was your coffee?  When the unpacking procedure is complete, you should:

   cd LATEXDIST:
   initex latex.ltx

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
===========================================

To install the LaTeX files created in the previous step, you should:

   cd LATEXDIST:
   rename latexbug.tex testpage.tex lablst.tex idx.tex +
      nfssfont.tex small2e.tex sample2e.tex docstrip.tex +
      #?.cls #?.clo #?.sty #?.fd #?.def #?.cfg +
   LATEXINPUTS:

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
=======================

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 "

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
=====================================

To check that the installation worked, you should:

   cd LATEXDIST:
   latex ltxcheck

This will perform a number of tests, which should all report `OK'.


PROBLEMS
========

`texsys.cfg':  While running iniTeX on latex.ltx you will be prompted
   that this file can't be found on your system.  This is a feature!
   Given that you have `UnixDirsII' installed you may safely continue
   by typing <return>.  The standard notation `./' for the `current'
   directory will be assumed.

`File missing':  As long as the default search paths of AmiWeb2C are
   correctly set up, 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
   TeXMF:fonts/tfm// directory structure.

`Out of memory':  The memory configuration file `tex.mcf' coming with the
   source distribution of AmiWeb2C was used for the installation of LaTeX
   on my system, so it should be appropriate for your machine also.  In
   case of exhausted memory, there must be reductions in `tex.mcf' that
   should be undone.


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<xx>.tex and ltnews<xx>.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 <xxx>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 LATEXFORMATS: directory, the
   transcript file latex.log that was produced whilst creating the format.

If you don't need the documentation are if you are lacking enough disk
space to permanently keep the LaTeX distribution files, you can now safely:

   delete LATEXDIST: all


SYSTEM-SPECIFIC SECTIONS
========================

As the maintainer and distributor of AmiWeb2C I'm very interested in any
feedback about problems with the application of the new TeX for the Amiga.
Please report difficulties in installation and/or use of LaTeX that are
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.                   ---
