HOW TO INSTALL AWKA
-------------------

DJGPP users should consult INSTALL.djg

1. Download awka from the Awka home page - make sure you check
   this site to ensure you have the latest version.  Awka lives at
   http://www.linuxstart.com/~awka.

2. 'cd' to the directory containing the downloaded awka file.

3. type the following:-
   gunzip -c awka-0.3b.tgz | tar -xvf -
   (you will need gzip installed).

4. cd to awka-0.3b

5. type "./configure" (not including the quotes).  You may specify
   options to configure to control where awka is installed.  For
   instance, to put libawka.a in /mydir/lib, and awka in /mydir/bin,
   you would run

     ./configure --prefix mydir

   By default Awka will not seek to identify and 'clean' binary 
   characters in the input data by substituting them for spaces.  To 
   make Awka do this, uncomment:

     /* #define NO_BIN_CHARS */

   in config.h.  

   HPUX users:  If you don't have gcc, change CFLAGS in lib/Makefile and
   awka/Makefile to equal "-O -Aa".  Make the same change in config.h
   as well.
   
   Like most AWK implementations, the associative arrays are supported
   internally by hash indexes.  By default, Awka uses a truncation 
   method of generating index keys from strings.  Generally this is very
   fast, however there is always the risk that incoming data will make
   it fail to generate unique keys.  If this happens, awka-generated
   arrays will run very slowly indeed.

   I have therefore provided you with an alternative.  By uncommenting
   the line:

     /* #define SLOW_HASH */

   in config.h, Awka will generate keys based on every character in
   the strings used as array indexes.  This extra computation will slow
   things down by a factor of 25%, but the 'worst-case' performance will
   not be nearly as bad.

6. type "make" (minus the quotes).  This will compile the library and 
   the awka executable.

   Optionally you may then run "make test" to verify the program is
   working properly (this may take some time).  If you see any errors
   reported in this stage, please take the time to let me know, along
   with the platform and operating system you are using.

7. Type "make install".  This will copy 'awka' to /usr/local/bin,
   'libawka.a' to /usr/local/lib, 'libawka.h' to /usr/local/include and
   'awka.1' to /usr/local/man/man1.  Of course if you have specified
   --prefix or --exec-prefix etc at configure time, the files will be
   installed elsewhere.


