This file, ./MISC/Amiga/README.amiga, describes the necessary steps to get
the FLEX 2.5.1 program up and running on the Commodore AMIGA with the
help of SAS/C++ 6.51 and SMake 6.50.  Also it describes the contents of the
subdirectory ./MISC/Amiga, where `.' denotes the root directory of the
standard installation of FLEX 2.5.1.


FILES ADDED FOR INSTALLING FLEX 2.5.1 ON THE AMIGA

The standard distribution of FLEX 2.5.1 is assumed to be installed on
your AMIGA computer.  `Installed' means that all source files from the
original archive are present in a root directory (denoted by `.' in what
follows) and, if appropriate, one or more subdirectories, on your machine.

The original source files are totally left untouched, the necessary changes
are applied in the form of `change files'.  For installing FLEX 2.5.1 on
the AMIGA, several additional files come with this patch.

     -----rw-d       2      738 Apr  3 11:49 config.h
     -----rw-d       1      169 Apr  3 11:33 libmain.ch
     -----rw-d       1      159 Apr  3 11:33 libyywrap.ch
     -----rw-d       1      167 Apr  3 11:33 parse.ych
     -----rw-d       6     2840 Apr  3 11:34 README.amiga
     -----rw-d      11     5503 Apr  3 11:45 smakefile
     Dirs:0    Files:6    Blocks:22    Bytes:9576


HOW TO INSTALL FLEX 2.5.1 ON THE AMIGA

Copy all files from ./MISC/Amiga to the root directory of the FLEX 2.5.1
distribution and edit `SMakefile' as it instructs you.  There shouldn't be
too many changes necessary.  Then say "make bootflex".  This creates a
preliminary version of FLEX 2.5.1 without using itself.

WARNING: Don't say "make flex" yet.  Any pre-2.5 version of FLEX will fail
on the file `scan.l' due to some new features only present in FLEX 2.5.

Then say "make flex".  At least once the FLEX program created in the first
step will be used.  To make sure that everything is alright, finally say
"make check".  If you change the code, you should also say "make bigcheck"
for some more thorough testing.

When you are satisfied with the results, say "make install".  This will
copy the `flex' binary, the `libfl.lib' file, and the `FlexLexer.h' header
to the paths specified in the `SMakefile'.

Finally, you should say "make clean" to remove all intermediate files from
the root directory.  "make veryclean" also removes `flex' and `scan.c'.


TROUBLE SHOOTING

FLEX 2.5.1 was ported to the AMIGA and tested with the following setup:

	AMIGA 2000
	GVP G-Force 030/50/50/8
	SAS/C++ 6.51
	SED 2.05
	BISON 1.22
	WMERGE from the CWEB distribution

Should you encounter problems with this AMIGA patch for FLEX 2.5.1 or
should you have ideas for further improvements, like using GnuMake instead
of SMake, contact the author of this contribution

Andreas Scherer
Roland-Stra{\ss}e 16
52070 Aachen
Germany

<scherer@genesis.informatik.rwth-aachen.de> (Internet)