This file should help you choose which archive(s) to get if you want to use TeX 3.141 based on this port. Please send complaints, bug reports, etc. to dcc@dcs.ed.ac.uk or by post to David Crooke, 2 Main St., Carnock, Dunfermline, Fife, SCOTLAND KY12 9JQ. ******************************************************************* * STOP PRESS * * * * This should now work under AmigaOS 3.0 with the appropriate * * version of ixemul.library. * * * * Dave * ******************************************************************* ******************************************************************* * The infamous "etc" message * * * * One thing that isn't mentioned in the documentation is that you * * need a large stack size in your AmigaShell in order to build * * and use LaTeX. You can obtain this by using the STACK command * * before commencing work with initex: * * * * 6.Workbench3.0> stack 100000 * * * * (I think 100,000 bytes is enough). If the stack is too small, * * you may get the following, confusing requestor from the ixemul * * library: * * * * --System Request-------------- * * | | * * | Please insert volume | * * | etc | * * | in any drive | * * | | * * | Retry Cancel | * * ------------------------------ * * * * To alleviate this problem, just increase the stack size and try * * again. * * * * 17-Nov-93 * * Dave * ******************************************************************* --------------------------------------------------------------------- Description ----------- TeX 3141 is a port of the latest (as far as I know) version of Knuth's generic TeX engine for AmigaDOS, with a little hack of my own so that the memory size can be controlled by the user and altered without recompilation. Credits ------- Literally 99.9% of the work put in this software was done by other people, not me. In particular, Markus Wild, who ported the GCC compilers to the Amiga, the many people who did the Unix port of TeX on which this is based, Leslie Lamport, author of LaTeX, and most of all Donald Knuth, the originator of TeX and author of the vast majority of this code. Disclaimer ---------- This port has not been thoroughly tested, but I can't forsee many problems. If there are any I will endeavour to resolve them but this software is for use entirely at your own risk, no warranty expressed or implied, etc., etc. Machine Requirements -------------------- To run this code, you will need: - An Amiga (really ?) with at least 2Mb of RAM - AmigaDOS 1.3 or higher - Version 39 or higher of Markus Wild's ixemulib.library, available from all good Amiga ftp sites. If you have GCC 2.3.3 you have this already. Hard disks, lots of memory, better versions of AmigaDOS etc. are all highly desirable. Packages -------- TeX3141UserKit.lha - for first-timers This contains all you need for a bare-bones installation of TeX and LaTeX, including font metrics, style files, and the .tex sources for TeX and LaTeX. It does not include the software to view, process or print the DVI files that TeX produces, nor any information on using TeX, but it does have advice on what else to get and where to get it. If you have a 32-bit processor and FPU and want to take advantage of them, get TeX3141bin881.lha as well and use the executables contained therein. TeX3141bin.lha - for existing users This contains just the executables for initex and virtex and the tex.pool file. Documentation for my memory hack is provided. *WARNING* - you will need to redump your format files (e.g. "lplain.fmt" for LaTeX), so make sure you have .tex files for them before you install this! If you don't, but it is just TeX and/or LaTeX you need, get the user kit (above), it includes them. TeX3141bin881.lha - for well-endowed users This is the same as the TeX3141bin.lha version, but the executables have been compiled for 68020/68881 or higher processors. They should work with any high-end Amiga (all existing models of A3000 and A4000/040), and any accelerator which has an FPU (68881, 68882 or full 68040). If you have an accelerator with no FPU, or a bare A1200 or A4000/030, use the above versions - don't feel cheated, the extra speedup comes mainly from the FPU, not the 68020 instructions; of course you will still benefit from having the faster integer processor. The speedup of this against the above 68000 version, LaTeXing my flatmate's latest lab. report on my A3000/25, is about 30%. Your mileage may vary ;-) See the description of TeX3141bin.lha as well. TeX3141source.lha - for expert masochists only This is the source from which the initex/virtex executables were built, including web2c, etc. and the source for my hack. Only get this if you want to tinker with the works. No user serviceable parts inside. The makefiles, etc., (what little there is in the way of such luxuries) assume Markus' port of GCC. Happy TeXing Dave 1-Mar-93, updated 17-Nov-93