Dream 45/Amiga_Dream_45.iso/Amiga/Magazine/Dossier-LaTeX/AmiWeb2C.lha/source/web2c-6.1/README.AMIGA

Text File | 1995-04-20 | 15KB | 339 lines

         Welcome to the "developer's kit" for 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.63
                  and more than a dozen utility programs

                 on the Commodore Amiga with SAS/C++ 6.55


The Amiga port of these programs was done by Andreas Scherer on the basis
of Karls Berry's complete Web2C installation for UNIX.  Modifications and
enhancements were introduced to make the implementation work conveniently
on the Commodore Amiga and with the SAS/C developement system.  Please
send suggestions, complaints, bug reports, adulations, etc., to me, by
snail mail to my postal address Roland-Stra▀e 16, 52070 Aachen, Germany,
or by email to <[e-mail]>.  The only
documentation concerning the Amiga port and the installation process is
contained in the present file and in the master SMakefile, so read on.


CAVEAT UTILITOR: This stuff is for TeXnicians only!  If you want to work
with TeX, MetaFont, and their friends on a user level, try to get a user's
kit, readily available via the Internet or other PD distributions.  In
addition to the programs contained in this collection you'll also need some
`device drivers', like Tomas Rokicki's DVIPS and Georg He▀mann's PasTeX
drivers.  And you'll need lots of other stuff, like TeX macro programs,
e.g., the `plain' macros and LaTeX, and MetaFont font programs, e.g., the
`Computer Modern' font family.  A collection of useful things can be found
in Karl Berry's `source' distribution (approximately 15 MB).


CAVEAT IMPLEMENTOR: All programs in this distribution assume that you `TeX'
system is set up according to the new `TeX Directory Structure' as proposed
by the `TeX Users Group' in 1995.  This directory scheme is currently still
under development, a draft of the concept can be found at

   ftp.th-darmstadt.de:/pub/tex/TDS/draft/tds.dvi

Do not use these programs in `old' installations.  The </texmf> part of the
directory scheme is replaced by `TeXMF:' for this Amiga port.  This may
either be the `assign'ed name of a common root directory or rather the name
of a partition of your harddisk.


You will need several additional programs and packages to make use of this
Amiga port:

First of all you need the unmodified Web2C installation by Karl Berry in
the form of version 6.1 at

   CTAN:/tex-archive/systems/web2c/web2c-6.1.tar.gz

[CTAN stands for `Comprehensive TeX Archive Network' and currently consists
of the three major hosts ftp.shsu.edu (USA), ftp.dante.de (Germany), and
ftp.tex.ac.uk (UK) or any mirror thereof.]  This contains the standard
C stuff necessary for the compilation of TeX and its friends with any
decent C compiler.  Also included are the Web2C library and the KPathSea
library, used in this Amiga implementation.  The Web2C archive itself
assumes that you go and get all the necessary WEB sources for the
individual programs from somewhere else, like

   CTAN:/tex-archive/systems/knuth/[...]

The latest versions and future updates can be found at

   labrea.stanford.edu:/pub/[...]

Professor Knuth's `home server'.  The directory structure is slightly
different in all three collections (and is most certainly different from
the installation structure).

Then you'll want to aquire Oren Patashnik's soon-to-be-updated BibTeX
program for the creation of bibliographies in TeXnical documents.  You can
find version 0.99c at

   CTAN:/tex-archive/biblio/bibtex/[...]

together with the necessary style files and examples.

And finally you'll need John Douglas Hobby's MetaPost system.  Publicly
available is version 0.63 at

   CTAN:/tex-archive/graphics/metapost/[...]

This system is only available since January 1995, so not much information
can yet be given about its application.


My current system configuration consists of

   Amiga 2000 with GVP G-Force 030/50/50/8+4+2
   Two Quantum harddisk drives with 170 and 105 MB respectively
   Kickstart 37.175 and Workbench 38.36 (AmigaOS 2.1)
   ARexx (included with the OS)
   SAS/C++ 6.55 with SMake 6.55
   Cygnus Ed Professional 3.5

Although SAS/C is a very fine compiler, a lot of work had to be done to
make it work with the UNIX distribution.  Especially all the Makefiles had
to be rewritten for SMake.  Users of the GNU development software should be
able to work directly with the unmodified (well, almost) Web2C stuff.
I don't think there's a chance that any parts of this distribution could
possibly work on version 1.2 or 1.3 of the operating system.

Here is a list of programs I used while working on the Amiga port.  These
are vital for successfully following the installation steps described below

   UnixDirsII:    AmiNet:/util/shell (for `.' and `..' directory notation)
   Bison 1.22:    AmiNet:/util/gnu (or another decent YACC)
   BYacc 1.9:     AmiNet:/dev/c (this is another decent YACC :-)
   FLex 2.5.1:    AmiNet:/util/gnu (or another decent LEX)
   Sed 2.05:      AmiNet:/util/gnu (or another decent SED)
   GAWK 2.15.5:   AmiNet:/util/gnu (or another decent AWK)
   MakeInfo 1.55: AmiNet:/text/hyper (for kpathsea.guide)
   WebMerge:      AmiNet:/dev/c/cwebbin.lha (for literate programming)
   Tie 2.4:       AmiNet:/dev/misc (ditto)

[AmiNet is the `Amiga Network' (of course) consisting of several dozen
hosts worldwide, of which I want to mention ftp.uni-erlangen.de, because
it keeps submissions for a very long time and thus is rather complete.]
Except for Martin Scott's `UnixDirsII' package, all these programs were
implemented from the original sources prior to the work on this port.


This is what you already have in your hands:
[See the `SMakefile' in the current directory: PATCH]

This is what you additionally need:
[See the `SMakefile' in the current directory: ORIGINAL]


As mentioned above, this Amiga port of TeX, MetaFont, and all the utility
programs was done with the help of the Web2C system.  Furthermore, not a
single file of Karl Berry's distribution was modified manually.  All
modifications necessary to make it work on the Amiga were introduced by
means of `change files' applied either to the respective original file or
even on a `second level' to the respective change file or the intermediate
sources.  Care has been taken that the installation process works smoothly
`out of the box.'


OK, let's go to work.  Given that you aquired all the necessary bits and
pieces listed above, follow this recipe to make a full-grown Amiga
installation all from scratch.

Installing the original Web2C distribution and the WEB sources:

   a) Extract `web2c-6.1.tar.gz' and add the original WEB sources
   associated with the `change files' in the various `web2c'
   subdirectories.  Then extract the files from the archive
   of the Amiga installation.  The directory structure of Web2C 6.1
   is assumed.  You should rename the `info' files provided with
   Karl Berry's distribution to avoid desaster.

   b) Assign the name `X:' to the root directory `web2c-6.1'.  This
   isn't really necessary, it's just a convenience in what follows.

Creating the KPathSea library:

   Go to `X:kpathsea' and say `make'.  This creates the KPathSea library
   necessary for almost all the programs to be made.  There will be two
   versions: `kpathsea.lib' and `kpathsea_20.lib'.

Creating the Web2C common library:

   Go to `X:web2c/lib' and say `make'.  This creates the Web2C library and
   some header files necessary for almost all the programs to be made.
   There will be two versions: `lib.lib' and `lib_20.lib'.

Creating the Web2C system for converting Pascal source to C source:

   Go to `X:web2c/web2c' and say `make'.  This creates the Web2C system
   itself, consisting of WEB2C, FIXWRITES, REGFIX, and SPLITUP.  It is
   assumed that these four binaries reside in this directory for the
   following steps.

Creating the WEB system for Literate Programming in Pascal:

   a) Go to `X:web2c/web' and say `make'.  Firstly, this will create a
   preliminary version of the TANGLE processor needed for bootstrapping.
   This version is NOT suitable for general purpose Amiga application!
   Ignore all the warning messages from the SAS/C compiler.  (This is the
   way `standard' UNIX programs start out on my machine, but I try to
   make them work smoothly with SAS/C, e.g., TANGLE in the next step.)
   Secondly, the `real' Amiga versions of TANGLE and WEAVE, together
   with the POOLTYPE utility program, are created.  At least the TANGLE
   binary should stay in this directory for what follows.

   b) Say `make install', if you want to use the WEB system for
   Literate Programming in Pascal.  TANGLE and WEAVE will be moved
   to the standard directory for TeXnical binaries.

Creating the BibTeX system:

   a) Go to `X:web2c/bibtex' and edit the first few lines of `SMakefile'
   as it instructs you.  Then say `make'.  This creates the BibTeX
   program V0.99c.

   b) Say `make install', to move BIBTEX to the standard directory for
   TeXnical binaries.  Get the necessary BST files and install them, too.

Creating some utilities for manipulating DVI files:

   a) Go to `X:web2c/dviutil' and say `make'.  This creates the two
   DVI handling programs DVIcopy and DVItype.

   b) Say `make install', if you want to use these utilities generally.
   They will be moved to the standard directory for TeXnical binaries.

Creating several utilities for manipulating (TeX-) font files:

   a) Go to `X:web2c/fontutil' and say `make'.  This creates the font
   file handling programs GFtoDVI, GFtoPK, GFtype, MFT, PKtoGF, PLtoTF,
   TFtoPL, VFtoVP, and VPtoVF.  (At least GFtoPK is mandatory.)

   b) Say `make install', if you want to use these utilities generally.
   They will be moved to the standard directory for TeXnical binaries.

Creating the MetaFont system:

   a) Go to `X:web2c/mf' and edit the first few lines of `SMakefile'
   as it instructs you.  Then say `make'.  This creates the MetaFont
   system consisting of IniMF and VirMF V2.718.

   b) Say `make run-trap' and run the TRAP test for validation of the
   correctness of the MetaFont system just created.  Several of the
   tools described above are assumed to be present.

   c) Say `make install'.  This moves VIRMF and INIMF to the standard
   directory for TeXnical binaries.  Get PLAIN.MF and fonts and create
   the necessary PK and TFM files for your system.

Creating the TeX system:

   a) Go to `X:web2c/tex' and edit the first few lines of `SMakefile'
   as it instructs you.  Then say `make'.  This creates the TeX system
   consisting of IniTeX and VirTeX V3.14159 together with the PATEGEN
   utility.

   b) Say `make run-trip' and run the TRIP test for validation of the
   correctness of the TeX system just created.  Several of the tools
   described above are assumed to be present.

   c) Say `make install'.  This moves VIRTEX and INITEX and PATGEN to the
   standard directory for TeXnical binaries.  Get PLAIN.TEX and the LaTeX
   system and other macros and install them in your system.

Creating the MetaPost system:  Here some introductory words are necessary.
MetaPost comes in the following form, suitable for standalone installation
with self-contained code based on Web2C 5.581.  Given a common root
directory, there are several top-level files, like a README file and a
DISCLAIMER.  The main part is contained in the subdirectories

   doc, mp, mplib, and mpware

To make the installation of MetaPost convenient for this distribution,
based on Web2C 6.1, you should move some of these files and/or directories:

   - extract the MetaPost archive OUTSIDE the general Web2C tree.
   - move the complete standard MetaPost distribution to `X:web2c/mpdist',
     i.e., the MetaPost top level files will reside in this directory, and
     the four subdirectories lie beneath:

        X:web2c/mpdist/<top-level files of the MetaPost system>
        X:web2c/mpdist/doc
        X:web2c/mpdist/mp
        X:web2c/mpdist/mplib
        X:web2c/mpdist/mpware

   - move the directories `mp' and `mpware' one level up, i.e.,

        X:web2c/mpdist/<top-level files of the MetaPost system>
        X:web2c/mpdist/doc
        X:web2c/mp
        X:web2c/mpdist/mplib
        X:web2c/mpware

   - rename the subsubdirectory `X:web2c/mp/trapdir' to `X:web2c/mp/MPtrap'

Now you're ready to make the MetaPost system with full support of the
KPathSea and Web2C libraries:

   a) Go to `X:web2c/mpware' and say `make'.  This creates several
   utility programs to go with MetaPost.

   b) Say `make run-triptrap' for some elementary tests of the
   utility programs.

   c) Say `make install'.  This moves these utilities to the standard
   directory for TeXnical binaries.

   d) Go to `X:web2c/mp' and edit the first few lines of `SMakefile'
   as it instructs you.  Then say `make'.  This creates the MetaPost
   system consisting of IniMP V0.63.  (There is no VirMP, because `IniMP'
   behaves like `VirMP', except when called with the `-I' option.)

   d) Say `make run-trap' and run the TRAP test for validation of the
   correctness of the MetaPost system just created.  The `mpware' tools
   and several others described above are assumed to be present.

   e) Say `make install'.  This moves INIMP to the standard directory
   for TeXnical binaries.  Also, the PLAIN.MEM and MFPLAIN.MEM formats
   are created and installed, as well as some additional sources.


Congratulations!  You've just finished the successful installation of the
complete TeX and MetaFont system on your machine.  All you'll need now are
some good books about TeXing and MetaFonting, and most of all many many
macro packages and font packages available from the CTAN and other sites
worldwide.  There is an endless stream of new things to discover.  Maybe
you also want to join a local, national, or even international TeX Users
Group.  This surely can add some more fun to this exciting hobby.


New features in the Amiga installation:

   - TeX, MetaFont, MetaPost, and BibTeX can be set up to use a runtime
     memory configuration, so you don't have to fear the `! TeX capacity
     exceeded.  Ask a wizard to enlarge me.' message.  See the files
     in `X:web2c/config' for further details.
   - There are four new environment variables for this purpose:
     TEXCONFIG, MFCONFIG, MPCONFIG and BIBTEXCONFIG, containing search
     paths leading to the memory configuration files.
   - MetaFont has an additional parameter called `scalefactor' for
     reduction of the `Online Display'.


Happy TeXing and MetaFonting!


April 20, 1995

Andreas