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 (Internet)