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