1The contents of this file contributed by Peter J. Farley III <pjfarley@banet.net> 2 3Versions Tested: 4================ 5 6- GNU bash 7 (version 2.03.0(1)-release (i386-pc-msdosdjgpp) r0.4) 8 9- GNU autoconf 10 (version 2.13) 11 12- GNU gawk 13 (version 3.0.3) 14 15- GNU sed 16 (version 3.02) 17 18- GNU m4 19 (version 1.4) 20 21- GNU gcc 22 (version 2.81) 23 24- DJGPP DJTAR 25 (DJGPP version 2.02) 26 27 28 29Building and installing: 30======================== 31 32To build Awka under DJGPP bash, you must have your DJGPP environment 33set up and operating correctly (environment variables set, PATH set, 34etc.). If you have DJGPP already running, then these instructions 35will allow you to build Awka. 36 37Awka requires Win95/98 LFN support. You must have LFN=y in your DJGPP.ENV 38file. Plain DOS building has not been tested. 39 40If you did not use DJTAR to extract Awka, you should delete Awka and 41re-extract it using DJTAR. Recent versions of WinZip (including the 42most recent as of this writing, 7.0 SR-1) do not extract zero-length 43files, and there are several zero-length files in the directories test 44and test/reg that WinZip will fail to extract. 45 46You can use this command to extract the Awka gzipped tarball: 47 48 djtar -x -d -v -!. ?:/awka-<version>.tar.gz 49 50where "?:/" is the drive and path where the Awka file is located, and 51"awka-<version>.tar.gz" is the filename of the Awka distribution that 52you downloaded. 53 54If you have not already done so, copy bash.exe to /bin/sh.exe, or make 55a symbolic link file as described in the bash installation documentation. 56Most of the Awka installation will not work properly unless you do this. 57 58Ensure FILES=50 (or larger) exists in your CONFIG.SYS file. If it 59does not, make the change and REBOOT YOUR SYSTEM. If you are not 60booted with FILES=50 or better, the "manyfiles" test will fail in 61strange and unpredictable ways. 62 63In the Awka directory, you will need to rebuild the configure script 64so that DJGPP-specific changes are included. To do this, type: 65 66 bash autoconf 67 68To build Awka under DJGPP bash, type: 69 70 bash ./configdj 71 72(bash is required as both autoconf and configdj are shell scripts) 73 74To make and install Awka: 75 76 make install 77 78To run the test suite (be patient, this can take a while) 79 80 make test 81 82All the tests should run successfully. If you see any tests fail, 83be sure to report them to Andrew Sumner, andrew_sumner@bigfoot.com. 84 85