Contents of the `gawk' Distribution
-----------------------------------

   `gawk' has a number of C source files, documentation files,
subdirectories and files related to the configuration process (
see Compiling and Installing `gawk' on Unix: Unix Installation.), and
several subdirectories related to different, non-Unix, operating
systems.

various `.c', `.y', and `.h' files
     The C and YACC source files are the actual `gawk' source code.

`README'
`README.VMS'
`README.dos'
`README.rs6000'
`README.ultrix'
     Descriptive files: `README' for `gawk' under Unix, and the rest
     for the various hardware and software combinations.

`PORTS'
     A list of systems to which `gawk' has been ported, and which have
     successfully run the test suite.

`ACKNOWLEDGMENT'
     A list of the people who contributed major parts of the code or
     documentation.

`NEWS'
     A list of changes to `gawk' since the last release or patch.

`COPYING'
     The GNU General Public License.

`FUTURES'
     A brief list of features and/or changes being contemplated for
     future releases, with some indication of the time frame for the
     feature, based on its difficulty.

`LIMITATIONS'
     A list of those factors that limit `gawk''s performance.  Most of
     these depend on the hardware or operating system software, and are
     not limits in `gawk' itself.

`PROBLEMS'
     A file describing known problems with the current release.

`gawk.1'
     The `troff' source for a manual page describing `gawk'.

`gawk.texinfo'
     The `texinfo' source file for this Info file.  It should be
     processed with TeX to produce a printed manual, and with
     `makeinfo' to produce the Info file.

`Makefile.in'
`config'
`config.in'
`configure'
`missing'
`mungeconf'
     These files and subdirectories are used when configuring `gawk'
     for various Unix systems.  They are explained in detail in 
See Compiling and Installing `gawk' on Unix: Unix Installation.

`atari'
     Files needed for building `gawk' on an Atari ST.  *Note Installing
     `gawk' on the Atari ST: Atari Installation, for details.

`pc'
     Files needed for building `gawk' under MS-DOS.  *Note Installing
     `gawk' on MS-DOS: MS-DOS Installation, for details.

`vms'
     Files needed for building `gawk' under VMS.  *Note Compiling
     Installing and Running `gawk' on VMS: VMS Installation, for
     details.

`test'
     Many interesting `awk' programs, provided as a test suite for
     `gawk'.  You can use `make test' from the top level `gawk'
     directory to run your version of `gawk' against the test suite.
     If `gawk' successfully passes `make test' then you can be
     confident of a successful port.