diff options
author | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
commit | 007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch) | |
tree | 90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/base/amiweb2c.txt | |
parent | 950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff) |
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/base/amiweb2c.txt')
-rw-r--r-- | Master/texmf-dist/doc/latex/base/amiweb2c.txt | 306 |
1 files changed, 306 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/base/amiweb2c.txt b/Master/texmf-dist/doc/latex/base/amiweb2c.txt new file mode 100644 index 00000000000..3b11952efee --- /dev/null +++ b/Master/texmf-dist/doc/latex/base/amiweb2c.txt @@ -0,0 +1,306 @@ + + + LaTeX installation instructions for AmiWeb2c TeX + + 15 March 1998 + + +SUMMARY +======= + +This file contains instructions on how to install LaTeX for Web2c TeX +on the Amiga (aka 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 TeX 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 `/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. Feel free to modify `hyphen.cfg' as you need (or replace it + with your own version). + + +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 a special +treatment of such an old version of LaTeX. + +Updating installations of LaTeX2e is completely similar to a generic +LaTeX installation. This simply amounts to replacing all files with +their new versions and recreating the LaTeX format file `latex.fmt'. + + +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: HD:AmiWeb2c-<version>/texmf/tex/latex/base + +The LATEXFORMAT: directory is where the LaTeX format is stored: + + assign LATEXFORMAT: HD:AmiWeb2c-<version>/texmf/web2c + +The LATEXDIST: directory is where the LaTeX distribution is stored: + + assign LATEXDIST: HD:AmiWeb2c-<version>/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 started with the ready-to-use binaries, I suggest that you get +Norbert Püschel's `DOSPrefs' commodity from the Aminet at + + Aminet:/util/misc/DOSPrefs31.lha + +This program patches the AmigaOS to enable the Unix notations `.' and +`..' for the `current' and the `parent' directory respectively. There +are similar tools for this purpose, but AmiWeb2c was only tested with +`DOSPrefs'. For your convenience, "DOSPrefs 3.1" is included with the +AmiWeb2c distribution. + + +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 tea? [Personal note: on a P5/133 running +the Linux operating system the very same task takes about half a minute, +so I have my tea ready before I install a new version of LaTeX.] + + +PUTTING THE FILES WHERE LATEX CAN READ THEM +=========================================== + +How was your tea? 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:'. And make sure +that all these files are copied "as is", the file lookup mechanism of +AmiWeb2c won't find files with incorrect uppercase/lowercase spelling, +e.g., OT1enc.def (old) versus ot1enc.def (new). + +If you have MakeIndex installed or intend to do so, copy #?.ist to the +MakeIndex inputs directory, which should be in TDS notation: + + /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 --progname=latex 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. A useful +shortcut to invoke LaTeX is `alias latex="tex --progname=latex"'. + +If you intend to use any of the advanced features provided by `e-TeX' +(`enhanced TeX'), like left-to-right typesetting, you should instead +use the commands + + cd LATEXFORMAT: + etex --ini --efmt=elatex *latex.ltx + etex --ini --progname=elatex latex.ltx + +to create the format file and set `alias elatex="etex --progname=elatex"' +and `alias latex="etex --progname=latex"'. (Note the asterisk in front of +`latex.ltx'; this invokes a special feature of the etex binary, i.e., the +`extended mode of e-TeX'.) + +If you intend to produce output in Portable Document Format (PDF) from +your LaTeX sources, you may additionally use the command + + cd LATEXFORMAT: + pdftex --ini --progname=pdflatex latex.ltx + +together with `alias pdflatex="pdftex --progname=pdflatex"'. + +If you intend to use the 16-bit UniCode version of TeX, aka Omega, you +may additionally use the command + + cd LATEXFORMAT: + omega --ini --progname=lambda lambda.tex + +together with `alias lambda="omega --progname=lambda"'. + + +GETTING A WORKING LaTeX +======================= + +As soon as the format file `latex.fmt' is created in the proper place, you +are set for using LaTeX. Either use `alias latex "tex --progname=latex"' +or `makelink from latex to tex' to conveniently set up a `latex' call. + +Oh, and don't forget to remake the ls-R database! + + +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', +except for the "\@currdir" part (and, depending on your installation, +the "DC/EC" font stuff). According to the LaTeX check routine, all +files come from the current working directory, contrary to the common +installation. Due to the limitations of the Amiga implementation of +file lookup, which is inherently very Unix-prone, there seems to be +no remedy to this situation. Press "return" to skip the warnings. + + +PROBLEMS +======== + +`texsys.cfg': Due to technical limitations of the Amiga port of the + Kpathsea library it is necessary to "\let\@currdir=\@empty" in this + file. The LaTeX test suite "latex ltxcheck" will issue a warning + message when checking the current directory syntax. Proceed. + +`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 + `texmf/fonts/tfm//' directory structure. You may choose to ignore + the warning about the missing `EC' fonts issued by the LaTeX + check suite. + +`Out of memory': The memory configuration file `texmf.cnf' coming with + the source distribution of AmiWeb2c in `texmf/web2c/' 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 + `texmf/tex/generic/local/hyphen.cfg' and comment the value for `triesize' + in `texmf/web2c/texmf.cnf' in order to start IniTeX. Please do not + request a SmallTeX version of AmiWeb2c, it just can't be done. + +If you have any other problems with the LaTeX installation, see the +`PROBLEMS' section in install.txt. + + +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 file ltx3info.tex contains information about the LaTeX3 project + and how you can support it. + + * 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 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: + + 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 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 + <andreas.scherer@pobox.com> + + + --- Copyright 1995, 1998 Andreas Scherer and the LaTeX3 project. --- + --- All rights reserved. --- |