DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

(gawk) PC Installation

Info Catalog (gawk) VMS Installation (gawk) Installation (gawk) Atari Installation
 
 MS-DOS and OS/2 Installation and Compilation
 ============================================
 
    If you have received a binary distribution prepared by the DOS
 maintainers, then `gawk' and the necessary support files will appear
 under the `gnu' directory, with executables in `gnu/bin', libraries in
 `gnu/lib/awk', and manual pages under `gnu/man'.  This is designed for
 easy installation to a `/gnu' directory on your drive, but the files
 can be installed anywhere provided `AWKPATH' is set properly.
 Regardless of the installation directory, the first line of `igawk.cmd'
 and `igawk.bat' (in `gnu/bin') may need to be edited.
 
    The binary distribution will contain a separate file describing the
 contents. In particular, it may include more than one version of the
 `gawk' executable. OS/2 binary distributions may have a different
 arrangement, but installation is similar.
 
    The OS/2 and MS-DOS versions of `gawk' search for program files as
 described in  The `AWKPATH' Environment Variable AWKPATH Variable.
 However, semicolons (rather than colons) separate elements in the
 `AWKPATH' variable. If `AWKPATH' is not set or is empty, then the
 default search path is `".;c:/lib/awk;c:/gnu/lib/awk"'.
 
    An `sh'-like shell (as opposed to `command.com' under MS-DOS or
 `cmd.exe' under OS/2) may be useful for `awk' programming.  Ian
 Stewartson has written an excellent shell for MS-DOS and OS/2, and a
 `ksh' clone and GNU Bash are available for OS/2. The file
 `README_d/README.pc' in the `gawk' distribution contains information on
 these shells. Users of Stewartson's shell on DOS should examine its
 documentation on handling of command-lines. In particular, the setting
 for `gawk' in the shell configuration may need to be changed, and the
 `ignoretype' option may also be of interest.
 
    `gawk' can be compiled for MS-DOS and OS/2 using the GNU development
 tools from DJ Delorie (DJGPP, MS-DOS-only) or Eberhard Mattes (EMX,
 MS-DOS and OS/2).  Microsoft C can be used to build 16-bit versions for
 MS-DOS and OS/2.  The file `README_d/README.pc' in the `gawk'
 distribution contains additional notes, and `pc/Makefile' contains
 important notes on compilation options.
 
    To build `gawk', copy the files in the `pc' directory (_except_ for
 `ChangeLog') to the directory with the rest of the `gawk' sources. The
 `Makefile' contains a configuration section with comments, and may need
 to be edited in order to work with your `make' utility.
 
    The `Makefile' contains a number of targets for building various
 MS-DOS and OS/2 versions. A list of targets will be printed if the
 `make' command is given without a target. As an example, to build `gawk'
 using the DJGPP tools, enter `make djgpp'.
 
    Using `make' to run the standard tests and to install `gawk'
 requires additional Unix-like tools, including `sh', `sed', and `cp'.
 In order to run the tests, the `test/*.ok' files may need to be
 converted so that they have the usual DOS-style end-of-line markers.
 Most of the tests will work properly with Stewartson's shell along with
 the companion utilities or appropriate GNU utilities.  However, some
 editing of `test/Makefile' is required. It is recommended that the file
 `pc/Makefile.tst' be copied to `test/Makefile' as a replacement.
 Details can be found in `README_d/README.pc'.
 
Info Catalog (gawk) VMS Installation (gawk) Installation (gawk) Atari Installation
automatically generated byinfo2html