Welcome to "AmiWeb2c 2.0" the complete installation of Donald Ervin Knuth's TeX Engine, Release 3.14159 MetaFont Engine, Release 2.718 together with Oren Patashnik's `BibTeX', Release 0.99c and John Douglas Hobby's `MetaPost', Release 0.632 and Tomas Gerhard Rokicki's `DVIPS', Release 5.66a and more than a dozen utility programs on the Amiga INTRODUCTION: This native Amiga port of all these programs was done by Andreas Scherer on the basis of Karl Berry's complete "Web2c 7.0" installation of UNIX-TeX. Modifications and enhancements were introduced to make the implementation work conveniently on the Amiga with the SAS/C++ 6.57 developement system. Please send bug reports, suggestions, complaints, adulations, etc., to me, by snail mail to my postal address, Rochusstraße 22-24, 52062 Aachen, Germany, or preferably by email to . The only documentation concerning the Amiga port and the installation process is contained in the present file, so read on. CAVEAT UTILITOR: All programs in this distribution assume that your `TeX' system is set up according to the "TeX Directory Structure" as proposed by the "TeX Users Group". Do not try to use these programs in `old' installations. Thanks to the `selfdir' mechanism no specific environment variable needs to be set, all programs search the TDS tree (or multiple TDS trees) relative to their own position. The only point about TDS that may be of interest to you some time is the location where font files are searched for and, if necessary, are automatically created and stored in. Following the guidelines proposed for the standard TDS, "AmiWeb2c 2.0" stores its PK files as follows: /texmf/fonts/pk////dpi/ One of the standard fonts could be /texmf/fonts/pk/deskjet/public/cm/dpi300/cmr10.pk The DVI drivers and the CallMF system for automatic font creation are synchronized in applying this scheme. If you want to use a different scheme, for example, "long" filenames in exchange to omitting one level of subdirectories as in /texmf/fonts/pk/deskjet/public/cm/cmr10.300pk you will have to change the CallMF script MakeTeXFont.rexx and the PasTeX configuration files ShowDVI.fnt and DVIPrint.fnt. USERS SECTION: After several years of activities promoted by the international "TeX Users Group" (TUG), several national TeX Users Groups (DANTE, GUTenberg, NTUG, UKTUG, ...) and a large group of individuals, `TeX' has become a highly standardized and portable system for high-quality typesetting on all kinds of computer systems. "AmiWeb2c 2.0" is only a small piece in the "big picture" resulting from these activities. Other systems directly related to it are Thomas Esser's "teTeX" (UNIX) and Fabrice Popineau's "texk-win32" (Win95/WinNT) and, of course, the system all the others are based on, Karl Berry's marvellous "texk 7.0". Thanks to the 100% portability between the various installations, usage of any of these systems is very similar. Except for the binaries of the executables themselves virtually everything else can be shared among the different systems. For this reason I do not include macros or fonts, since the necessary stuff is readily available from common sources. As a starter I suggest that you get Karl Berry's Web2c library for his original UNIX-TeX system. You can find it at ftp://ftp.dante.de/tex-archive/systems/web2c/texmflib-7.0.tar.gz Alternatively you can choose Thomas Esser's "teTeX" distribution coming with even more pre-installed macros and fonts, even large collections of pre-calculated TFM and PK files necessary for TeX and DVI drivers. As always, "CTAN" is the source you'll want to check out. For detailed information see the TeX repository at "http://www.tug.org". The `e-tex' binary coming with "AmiWeb2c 2.0" incorporates the first fruits of the `NTS' project as distributed in the `e-TeX' system by Peter Breitenlohner and Philip Taylor. Since it is not (yet) part of any of the source collections mentioned above, you should get it separately from ftp://ftp.dante.de/tex-archive/system/etex and install at least "etex.src" in "/texmf/tex/etex". INSTALLATION: If you are starting from a CD distribution like the "TeX Live CD" from TUG (see http://www.tug.org/texlive.html for more information) you may skip this part and jump directly to section "CD VERSION OF AMIWEB2C" below. * Extract the contents of "AmiWeb2c 2.0" and add "texmflib-7.0.tar.gz" or "teTeX-lib". Make sure that the "share/texmf/" directory parts in these distributions match each other. This should not be the first directory directly following the colon of the respective device name, so you better leave the "AmiWeb2c/" part above "bin/", "share/", and "texmf/" as is. * Install "AmiWeb2c/bin/amiweb2c/local/DOSPrefs22" in "Sys:WBStartUp". (You may skip this step if you already have `DOSPrefs22' or `UnixDirsII' installed.) * Include "execute AmiWeb2c/share/amiweb2c/source/s/User-StartUp.entry" in your own "S:User-StartUp" file and adapt the "path", "TeXMF:", and "TeX:" entries according to your local settings. * Copy the scripts from "AmiWeb2c/share/amiweb2c/source/s/" to the "S:" directory (with "clone" to preserve the "script" flags). * Reboot your system. * Go to the root directories "AmiWeb2c/share/texmf" and "AmiWeb2c/share/amiweb2c/texmf" and start the script `MakeTeXls-R' twice. This will result in the database files `ls-R' used by all programs in the system for file lookup. * Go to the "AmiWeb2c/share/texmf/web2c" directory and say $ e-tex -ini *etex.src *\input hyphen.cfg *\dump $ makelink from e-tex.fmt to etex.src.fmt $ e-tex -ini *latex.ltx $ makelink from e-latex.fmt to latex.fmt In case you don't have the `e-TeX' distribution, replace these commands by the following $ tex -ini plain *\input hyphen.cfg *\dump $ makelink form tex.ftm to plain.fmt $ tex -ini latex.ltx * Go to the "AmiWeb2c/share/texmf/web2c" directory and say $ mf -ini plain *input modes; *dump. $ makelink from mf.base to plain.base * Go to the "AmiWeb2c/share/texmf/web2c" directory and say $ mp -ini plain *dump. $ makelink from mp.mem to plain.mem * Go to the root directory "AmiWeb2c/share/texmf" and recreate the database file `ls-R' by starting `MakeTeXls-R' again. You should do this step from time to time after new macros or fonts get installed. The `ls-R' file is not actually necessary for the `TeX' system to work properly, but it helps speed things up considerably. Congratulations! You've just finished the successful installation of the complete "TeX system" on your machine. Happy TeXing! PASTEX: Coming with "AmiWeb2c 2.0" are Georg Heßmann's DVI drivers `ShowDVI' for previewing and `DVIPrint' for printing DVI files (used by kind permission) together with the `SpecialHost' program for displaying graphics included in DVI files (originally developed by Georg Heßmann and Olaf Barthel, but included here in version 1.29 by Giuseppe Ghibò with support for METAPOST graphics). Also added is the program `DVIPrintSetUp' by Stefan Scherer for easy access to the various command line options of `DVIPrint' directly from the `ShowDVI' previewer. Just start the "PasTeX" environment with the `AmiWeb2c/share/amiweb2c/source/s/InitTeX' script and press the various function keys. (For example, F4 activates the `DVIPrintSetUp' tool and F5 switches to Cygnus Ed 3.5) CALLMF: PasTeX's `ShowDVI' and `DVIPrint' as well as AmiWeb2c's `dvips' will use "CallMF 2.1" for creating missing fonts. The programs are set up to invoke METAFONT "on the fly". If you change `User-StartUp.entry' appropriately, "CallMF 2.1" will write a batch fille `MakeTeXFont.sh' which you can `execute' from time to time. If you invoke `dvips' with the `-M' option it will write a file `missfont.log' instead of starting METAFONT directly. This file, too, can be `execute'd later. See the notes about changing the font lookup scheme described above. LIMITATIONS: Although "AmiWeb2c 2.0" was developed parallel to "Web2c 7.0" (so it should more properly be called "texk-ami") it does not have all the features of "UNIX-TeX", sorry folks! Here is a list of points you should keep in mind. * XDVI does not exist on the Amiga. * SpecialHost can only display labelled METAPOST graphics included in TeX files if the "BaKoMa" distribution of the "Computer Modern" fonts is installed for rendering. * The "MakeTeX*" scripts are not available in "AmiWeb2c 2.0". Although "CallMF 2.1" as described above can conveniently create missing fonts for the "PasTeX" drivers, it is by no means a full-featured replacement for the tools in the UNIX distribution. I don't have the resources to rewrite the sh-scripts in ARexx. Volunteers, step forward! DOCUMENTATION: Karl Berry's Web2c system comes with its own documentation in Texinfo format. You can format it with TeX or you can (try to) convert it into AmigaGuide format with `AmigaMakeInfo' (there will be lots of warnings due to missing features in version 1.64). CD VERSION OF AMIWEB2C: Limitations of the ISO 9660 format for CD distributions make a special procedure necessary before you can successfully use "AmiWeb2c 2.0" from a mounted CD. * Install "CD:bin/amiweb2c/local/DOSPrefs22" in "Sys:WBStartUp". (You may skip this step if you already have `DOSPrefs22' or `UnixDirsII' installed.) * Include "execute CD:share/amiweb2c/source/s/User-StartUp.entry" in your own "S:User-StartUp" file. It may well be necessary that you make a copy of "User-StartUp.entry" and adapt the "path", "TeXMF:", and "TeX:" entries according to your local settings. * Add an extra line for the environment variable TEXMF in your "User-Startup" file with at least the following entries {$SELFAUTODIR/../share/texmf,$SELFAUTODIR/../share/amiweb2c/texmf} In case you want to add even more TeXnical stuff than coming with the CD distribution you can have a third TDS tree (or even more) by entering it anywhere in this brace-delimited and comma-separated group, e.g., "LOCAL:myTeX/texmf" may point to your "local" TDS tree. In order to make things work smoothly you should create a "ls-R" database file for this directory tree with the "MakeTeXls-R" script. * Copy the scripts from "CD:share/amiweb2c/source/s/" to the "S:" directory (with "clone" to preserve the "script" flags). * Reboot your system. Congratulations! You've just finished the successful installation of the complete "TeX system" on your machine. Happy TeXing! IMPLEMENTOR'S SECTION: In the archive file `AmiWeb2c/share/amiweb2c/source/texk-ami.tar.gz' you find the set of twentyeight source files I've written for the Amiga port of `UNIX-TeX'. Thanks to the activities of a multi-national group of TeX implementors this large system was made highly portable for various UNIX systems, Win32, and AmigaOS (and possibly other operating systems). The brave and the bold among you may dare to take a look at this code written over the past two years. You may even try to redo what I did by fetching the original source distribution from ftp://ftp.dante.de/tex-archive/systems/web2c/texk-7.0.tar.gz and adding the contents of `texk-ami.tar.gz' right on top. Then you should run `rx configure' and `rx install' in the root directory of the `texk-7.0' tree. After a (very) long time (about 75 minutes on my A2000 with the GVP G-Force 030/50 accelerator board) you'll find the full set of binaries (except xdvi) as shipped with AmiWeb2c 2.0. HOW IT WAS DONE: The system configuration of the machine this port was done on: Amiga 2000 with GVP G-Force 030/50/50/8+4+2 Two Quantum harddisk drives with 170 and 105 MB respectively A Mitsubishi 14" monitor and lately an Elsa 17" monitor Kickstart 37.175 and Workbench 38.36 (AmigaOS 2.1) ARexx (included with the OS) SAS/C++ 6.57 with SMake 6.57 Cygnus Ed Professional 3.5 Additional tools like awk/bison/flex/sed/tie/wmerge As you can see from the original sources of the Web2c distribution, quite a lot of support for the Amiga is readily available in the UNIX sources. However, Karl Berry lacks an Amiga to do tests himself, so there is no `official' support for the Amiga from his side. Instead, the archive `AmiWeb2c/share/amiweb2c/source/texk-ami.tar.gz' comes with a set of 28 files to help set things up on the Amiga with the SAS/C++ compiler. Most of all this is concerned with the special versions of the Makefiles. Here is a list of programs I used while working on the Amiga port. DOSPrefs22: AmiNet:/util/misc/DOSPrefs22.lha (mandatory) UnixDirsII: AmiNet:/util/shell (alternatively) Bison 1.25: AmiNet:/util/gnu (or another decent YACC) BYacc 1.9: AmiNet:/dev/c (this is another decent YACC :-) FLex 2.5.3: AmiNet:/util/gnu (or another decent LEX) Sed 2.05: AmiNet:/util/gnu (or another decent SED) GAWK 2.15.6: AmiNet:/util/gnu (or another decent AWK) MakeInfo 1.64: AmiNet:/text/hyper (for kpathsea.guide) WebMerge: AmiNet:/dev/c/cwebbin.lha (for literate programming) Tie 2.4: AmiNet:/dev/misc (ditto) THANKS: Donald Knuth for `TeX'. The adventure started on February 1, 1977. Karl Berry and all contributors to "tex-pretest" and "tex-implementors" for their continued effort in developing a truely portable installation of "TeX and friends" and for coping with all the Amiga stuff cluttering up the beautiful UNIX source code. FUTURE: "AmiWeb2c 2.0" marks the end of my life as Amiga developer. I've moved to a Linux system in summer 1996 and it's so much better than the Amiga (or anything else, by the way) that I definitely won't go back to "old times". However, I will of course continue to provide a mild form of `support' for "AmiWeb2c 2.0", but don't expect too much. Enjoy! February 1997 Andreas Scherer Rochusstraße 22-24 52062 Aachen, Germany