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