This archive contains a port of gawk (GNU awk) 2.15 to OS/2 1.x--2.x
and DOS. Kai Uwe Rommel's EMX/gcc port was the starting point.

There are four separate archives of interest:

1. Rommel's original OS/2 2.x port
     ftp-os2.cdrom.com:pub/os2/2_x/unix/gnu/gnuawk.zip

2. OS/2 1.x--2.x port (gawk.exe)
     ftp-os2.cdrom.com:pub/os2/all/unix/gnu/gawk215.zip

3. OS/2 2.x and DOS 32-bit port (gawk-dos.exe, gawk-emx.exe)
     oak.oakland.edu:pub/msdos/awk/
   with executables in gawk215a.zip and sources in gawk215s.zip

4. The original GNU sources
     prep.ai.mit.edu:pub/gnu/gawk-2.15.2.tar.gz


The complete manual (200 pages) for GNU awk is available with the
sources. A very nice printed manual is available from the Free
Software Foundation.  You can find information on GNU's manuals,
disks, and the GNU project in the GNU's Bulletin, available on the
newsgroup gnu.announce, or by sending a self-addressed stamped
envelope ($0.52) to 

  Free Software Foundation
  675 Massachusettes Avenue
  Cambridge, MA 02139

``...a small donation to cover copying costs is appreciated, but
is not required''


Files:
 ./
  gawk.exe      OS/2 1.x--2.x executable
  gawk-dos.exe  DOS executable
  gawk-emx.exe  32-bit OS/2 and DOS executable (requires EMX runtime)
  gawk.man      man-page ("groff -man gawk.1 > gawk.man")
  readme.txt    this file
 src/           sources (from Rommel's port) and patches
  COPYING       GNU license information
  COPYING.EMX   EMX license information
  emxrt.doc     documentation on the EMX runtime
  patches.pc    context diff's from GNU awk 2.15.2

Notes:

1. The stdargv and globbing routines from Ian Stewartson's sh have
been used on the MSC OS/2 and DOS versions. This provides enhanced
argument passing. Other compile options, including bound OS/2 and DOS
versions, can be found in Makefile.pc.

2. The man-page gawk.man can be read with the "less" pager, available
from ftp-os2.cdrom.com:pub/os2/all/unix/diskutil/less177.zip (OS/2
and DOS) and oak.oakland.edu:pub/msdos/txtutl/less177e.zip (DOS).

3. The gawk-emx.exe is a 32-bit executable, and will run under
OS/2 2.x and DOS. A [34]86 is required, and gawk-emx.exe will not
run in a dos-box under Microsoft Windows. Eberhard Mattes is
the author of the emx programming tools used for this executable.

DOS users should read the notes in src/emxrt.doc. In the language 
of emxrt.doc, the program gawk-emx.exe has "emx.exe integrated". 
Note especially:

  If you're using a memory manager (such as QEMM or EMM386 or 386max)
  which implements DPMI (DOS Protected Mode Interface), you have to
  change the invokation of that memory manager to enable VCPI as emx
  does not support DPMI.  See the documentation of your memory for
  details.  If your memory manager supports DPMI only (without VCPI),
  you have to remove or disable the memory manager.  emx supports XMS
  and VCPI.

OS/2 users will need the EMX runtime support which is currently 
available in

   ftp-os2.cdrom.com:pub/os2/2_x/unix/gnu/emx08g/emxrt.zip

4. Thanks to Mattes, Rommel, Stewartson, FSF, and GNU.

--Darrel Hankerson hankedr@mail.auburn.edu 
24 July 1993, updated 20 August 1993


Changes (20 August 1993):

1. More compiler options, including an EMX/gcc "bound" OS/2 and DOS 
version. Better integration of the DOS and OS/2 files.

2. Use "real" popen when in OS2_MODE; pc/popen.c when in DOS_MODE. 
Added code to properly handle bound programs with EMX/gcc or MSC.

3. Bugfix: Fix close_io(); causes problems for pc/popen.c when using
pipes. Reported by Dave Crook (dc@hpmtldc.lvld.hp.com).

4. Bugfix: Minor correction to Stewartson's stdargv to fix argv[0] 
problem. Reported by Daniel S. Lewart (d-lewart@uiuc.edu).
