1
2This file, ./MISC/Amiga/README.amiga, describes the necessary steps to get
3the FLEX 2.5.1 program up and running on the Commodore AMIGA with the
4help of SAS/C++ 6.51 and SMake 6.50.  Also it describes the contents of the
5subdirectory ./MISC/Amiga, where `.' denotes the root directory of the
6standard installation of FLEX 2.5.1.
7
8
9FILES ADDED FOR INSTALLING FLEX 2.5.1 ON THE AMIGA
10
11The standard distribution of FLEX 2.5.1 is assumed to be installed on
12your AMIGA computer.  `Installed' means that all source files from the
13original archive are present in a root directory (denoted by `.' in what
14follows) and, if appropriate, one or more subdirectories, on your machine.
15
16The original source files are totally left untouched, the necessary changes
17are applied in the form of `change files'.  For installing FLEX 2.5.1 on
18the AMIGA, several additional files come with this patch.
19
20     -----rw-d       2      738 Apr  3 11:49 config.h
21     -----rw-d       1      169 Apr  3 11:33 libmain.ch
22     -----rw-d       1      159 Apr  3 11:33 libyywrap.ch
23     -----rw-d       1      167 Apr  3 11:33 parse.ych
24     -----rw-d       6     2840 Apr  3 11:34 README.amiga
25     -----rw-d      11     5503 Apr  3 11:45 smakefile
26     Dirs:0    Files:6    Blocks:22    Bytes:9576
27
28
29HOW TO INSTALL FLEX 2.5.1 ON THE AMIGA
30
31Copy all files from ./MISC/Amiga to the root directory of the FLEX 2.5.1
32distribution and edit `SMakefile' as it instructs you.  There shouldn't be
33too many changes necessary.  Then say "make bootflex".  This creates a
34preliminary version of FLEX 2.5.1 without using itself.
35
36WARNING: Don't say "make flex" yet.  Any pre-2.5 version of FLEX will fail
37on the file `scan.l' due to some new features only present in FLEX 2.5.
38
39Then say "make flex".  At least once the FLEX program created in the first
40step will be used.  To make sure that everything is alright, finally say
41"make check".  If you change the code, you should also say "make bigcheck"
42for some more thorough testing.
43
44When you are satisfied with the results, say "make install".  This will
45copy the `flex' binary, the `libfl.lib' file, and the `FlexLexer.h' header
46to the paths specified in the `SMakefile'.
47
48Finally, you should say "make clean" to remove all intermediate files from
49the root directory.  "make veryclean" also removes `flex' and `scan.c'.
50
51
52TROUBLE SHOOTING
53
54FLEX 2.5.1 was ported to the AMIGA and tested with the following setup:
55
56	AMIGA 2000
57	GVP G-Force 030/50/50/8
58	SAS/C++ 6.51
59	SED 2.05
60	BISON 1.22
61	WMERGE from the CWEB distribution
62
63Should you encounter problems with this AMIGA patch for FLEX 2.5.1 or
64should you have ideas for further improvements, like using GnuMake instead
65of SMake, contact the author of this contribution
66
67Andreas Scherer
68Roland-Stra{\ss}e 16
6952070 Aachen
70Germany
71
72<scherer@genesis.informatik.rwth-aachen.de> (Internet)
73