README.amiga
1
2 This file, ./MISC/Amiga/README.amiga, describes the necessary steps to get
3 the FLEX 2.5.1 program up and running on the Commodore AMIGA with the
4 help of SAS/C++ 6.51 and SMake 6.50. Also it describes the contents of the
5 subdirectory ./MISC/Amiga, where `.' denotes the root directory of the
6 standard installation of FLEX 2.5.1.
7
8
9 FILES ADDED FOR INSTALLING FLEX 2.5.1 ON THE AMIGA
10
11 The standard distribution of FLEX 2.5.1 is assumed to be installed on
12 your AMIGA computer. `Installed' means that all source files from the
13 original archive are present in a root directory (denoted by `.' in what
14 follows) and, if appropriate, one or more subdirectories, on your machine.
15
16 The original source files are totally left untouched, the necessary changes
17 are applied in the form of `change files'. For installing FLEX 2.5.1 on
18 the 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
29 HOW TO INSTALL FLEX 2.5.1 ON THE AMIGA
30
31 Copy all files from ./MISC/Amiga to the root directory of the FLEX 2.5.1
32 distribution and edit `SMakefile' as it instructs you. There shouldn't be
33 too many changes necessary. Then say "make bootflex". This creates a
34 preliminary version of FLEX 2.5.1 without using itself.
35
36 WARNING: Don't say "make flex" yet. Any pre-2.5 version of FLEX will fail
37 on the file `scan.l' due to some new features only present in FLEX 2.5.
38
39 Then say "make flex". At least once the FLEX program created in the first
40 step 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"
42 for some more thorough testing.
43
44 When you are satisfied with the results, say "make install". This will
45 copy the `flex' binary, the `libfl.lib' file, and the `FlexLexer.h' header
46 to the paths specified in the `SMakefile'.
47
48 Finally, you should say "make clean" to remove all intermediate files from
49 the root directory. "make veryclean" also removes `flex' and `scan.c'.
50
51
52 TROUBLE SHOOTING
53
54 FLEX 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
63 Should you encounter problems with this AMIGA patch for FLEX 2.5.1 or
64 should you have ideas for further improvements, like using GnuMake instead
65 of SMake, contact the author of this contribution
66
67 Andreas Scherer
68 Roland-Stra{\ss}e 16
69 52070 Aachen
70 Germany
71
72 <scherer (a] genesis.informatik.rwth-aachen.de> (Internet)
73