home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / MAWK113.ZIP / readme.now < prev   
Text File  |  1993-04-24  |  3KB  |  67 lines
  1.  
  2.    ---------------------------------------
  3.    OS/2 port of MAWK-1.1.3 by Mike Brennan
  4.    ---------------------------------------
  5.  
  6.    This is a port of the AWK interpreter by Mike Brennan using the emx/gcc
  7.    package. The source can be obtained via anonymous ftp from oxy.edu .
  8.    MAWK ("Mike's AWK") is, in my opinion, superior to GNU's GAWK and can be
  9.    up to twice as fast. AWK - conoisseurs should definitely give it a try !
  10.  
  11.    Building the OS/2 version
  12.    -------------------------
  13.    After the archive MAWK113 has been unzipped the subdirectory ./mawk113
  14.    contains the original source code as ftp'ed from oxy.edu. MAWK_OS2
  15.    contains some of the source files with OS/2 specific changes (no
  16.    diffs). To build an executable you must:
  17.  
  18.    1. unzip MAWK_OS2 with 'unzip -o mawk_os2'. This will replace some
  19.       of the files in the directory ./mawk113, add more makefiles and
  20.       a new configuration file.
  21.  
  22.    2. Go to the subdirectory ./mawk113/rexp and
  23.           [d]make -f makefile.os2
  24.  
  25.    3. The files parse.c and parse.h in the subdirectory ./mawk113 were
  26.       made with yacc. Decide whether you want to re-bison 'parse.y'. If
  27.       you have bison and wish to recomile 'parse.y' then delete the
  28.       original files parse.h and parse.c (recommended).
  29.  
  30.    4. Go to subdirectory ./mawk113 and either
  31.           [d]make -f makefile.os2
  32.       or
  33.           [d]make -f makefile.omf .
  34.  
  35.       The latter command will create a smaller executable file but the
  36.       system() function of mawk will not work (see also: emxdoc.dev).
  37.  
  38.    Remarks
  39.    -------
  40.    1. I do not claim to have produced a perfect port of mawk as can be
  41.       seen from the very small number of changes I have made to the source
  42.       code. There is probably plenty of room for improvements. This port
  43.       works for me and I did not take it any further. Some things, like
  44.       the BINARY mode are completely untested.
  45.  
  46.    2. mawk passes the tests provided by M. Brennan. If you want to run the
  47.       tests again you have to do so manually. Look at the DOS batch file
  48.       to see how.
  49.  
  50.    3. The OS/2 version of mawk uses the same convention for command line
  51.       programs as the DOS version. Single quotes (') are used to delimit
  52.       strings inside a command line program whereas double quotes (")
  53.       are used to enclose the program on the command line.
  54.  
  55.    4. The executable file that comes with mawk113.zip should run under OS/2
  56.       and DOS as a stand-alone program (no DLLs required). According to
  57.       'emxdev.doc' system calls should not work under DOS.
  58.  
  59.  
  60.    Ulf Griesmann
  61.    Imperial College
  62.    Physics Department
  63.    Prince Consort Rd.
  64.    London SW7 2BZ, U.K.         ugr@lsr.ph.ic.ac.uk
  65.  
  66.  
  67.