LaTeX installation instructions for Lindner-TeX (Atari)
1995 June 25
SUMMARY
=======
This file contains instructions on how to install LaTeX for
Lindner-TeX. 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', or some other hyphenation files (see `Creating
the LaTeX Format', below); we recommend to use the `babel' system by
Johannes Braams, which can be found probably where you got your copy
of LaTeX, e.g. the CTAN archive ftp-servers;
* the font files (normally .tfm files) for the Computer Modern fonts,
including some non-standard ones (see `Fonts needed', below).
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.
If you want to use the new LaTeX2e, which is also the new standard, instead
of your old version, you can delete all files in your /texinput/stdinput
directory, except for the two plain TeX format files named PLAIN.FMT and
PLAING.FMT, which can usually be found in the directory /texinput/formats.
If you want to keep the old 2.09 version of LaTeX, move all the input files
to a directory named (e.g.) stdinput.209 and create a new directory
stdinput.2e for the new files.
CONFIGURING LATEX
=================
LaTeX2e uses more memory than the former versions. To use it, you need an
ATARI ST/TT/Falcon with at least 2Mb of RAM, so that you can use the BigTeX
version of Lindner-TeX. The files are available on the CTAN archive servers
in the directory tex/systems/atari/lindner-tex-packed-disks.
No specially adapted TEXSYS.CFG file is needed for the Lindner
implementation
of TeX. If you want to configure your system, you should edit the TEXSETUP
file with your favourite ASCII editor. This file contents the main
in-/output
paths for the system. CAUTION: Some paths are saved directly to the code of
the TEXSHELL.PRG. These can be edited from the shell only!
VERY IMPORTANT NOTICE: If you want to use the Lindner-TeX-System in a multi-
tasking environment like MagiC or MTOS, you should rename TEXSHELL.PRG to
TEXSHELL.TOS (unless your Desktop allows to determine the type of executa-
bles to certain types, like e.g. GEMINI). This will cause the TEXSHELL to
re-
direct all output to the VT52-Window, so the .TTP executables will not write
directly to the screen.
UNPACKING THE DISTRIBUTION
==========================
To unpack the distribution, run INITEX on the file unpack.ins. (If you can,
get the already unpacked distribution from CTAN, because the unpacking
might take an awfully long time on an 8Mhz ST).
CREATING THE LaTeX FORMAT
=========================
To create the new LaTeX format, you have to run IniTeX on the file
latex.ltx. Make sure, that this file (and the hyphenation files) are in
a directory searched by TeX. To configure the hyphenation read the file
TEXPERT.TEX. A new LaTeX format named LATEX.BFM will be created and dumped
to the directory where your other formats already are (environment variable
DUMPPATH in the TEXSETUP file). There is no need to rename this file to
LATEX.FMT. To install the new format file in the TEXSHELL.PRG, doubleclick
into the lower field of the formats section in the TeX-window, choose
LATEX.BFM in the file selector, ignore the error message about the file ex-
tensions and save the TEXSHELL options.
PUTTING THE FILES WHERE LaTeX CAN READ THEM
===========================================
We suggest the following configuration for your /stdinput.2e directory:
- create a new folder CLASSES and copy all *.CLS and *.CLO files into it;
- copy all *.STY files to a new folder PACKAGES;
- copy all *.FD and *.ENC files to a new folder FONTDEFS;
- copy all other files to a folder OTHERS.
You might delete all *.DTX, *.INS and *.TXT files (after reading or
processing them to get the documentations) in order to save disk space. Note
that the *.DTX files can be processed by the new LaTeX version only.
CAUTION:
you should, of course, keep a backup copy of all these files somewhere so
you
can can reinstall them if necessary.
GETTING A WORKING LaTeX
=======================
All you have to do now is writing the new paths to the TEXSETUP file so
that TeX can find the files when running.
CHECKING THAT THE INSTALLATION WORKED
=====================================
To check the installation select LTXCHECK.LTX in the TeXShell and run the
new LaTeX on it. Make sure that you copy LTXCHECK.LTX to the document input
directory, usually /texinput/document, before you proceed it. It's going to
produce some `OK' messages, and perhaps some `BAD' warnings.
PROBLEMS
========
If any problems occur, check the LindnerTeX users guide. Note that you need
some special fonts to process the XXXGUIDE.TEX files that come with the
LaTeX distribution. These fonts are available on CTAN also. If you use a
previewer like ASCREEN v3.2 or DVI v2.3x the missing fonts will be substi-
tuted and can be produced with METAFONT later.
If you have any other problems with the LaTeX installation, see the
`PROBLEMS' section in install.txt.
CLEARING UP
===========
See section `PUTTING FILES...' for details.
GETTING IN TOUCH WITH THE AUTHOR
================================
If you have any problems, comments or proposals for changes or extensions to
this text, you can send your questions to the author by email.
The probably best address to use is Thomas_Cloer@s4.maus.de (only mails
<16kb). You can also try tcloer@tyrell.s.bawue.de or tcloer1@gwdg.de.
--- Copyright 1995 Thomas Cloer and the LaTeX3 project ---
--- All rights reserved. ---