GNU Info

(gawk.info)Distribution contents

---

Prev: Extracting Up: Gawk Distribution

---

Enter node , (file) or (file)node

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

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

Various `.c', `.y', and `.h' files:
     These files are the actual `gawk' source code.

`README'
`README_d/README.*'
     Descriptive files: `README' for `gawk' under Unix and the rest for
     the various hardware and software combinations.

`INSTALL'
     A file providing an overview of the configuration and installation
     process.

`ChangeLog'
     A detailed list of source code changes as bugs are fixed or
     improvements made.

`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 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.

`POSIX.STD'
     A description of one area where the POSIX standard for `awk' is
     incorrect as well as how `gawk' handles the problem.

`doc/awkforai.txt'
     A short article describing why `gawk' is a good language for AI
     (Artificial Intelligence) programming.

`doc/README.card'
`doc/ad.block'
`doc/awkcard.in'
`doc/cardfonts'
`doc/colors'
`doc/macros'
`doc/no.colors'
`doc/setter.outline'
     The `troff' source for a five-color `awk' reference card.  A
     modern version of `troff' such as GNU `troff' (`groff') is needed
     to produce the color version. See the file `README.card' for
     instructions if you have an older `troff'.

`doc/gawk.1'
     The `troff' source for a manual page describing `gawk'.  This is
     distributed for the convenience of Unix users.

`doc/gawk.texi'
     The Texinfo source file for this Info file.  It should be
     processed with TeX to produce a printed document, and with
     `makeinfo' to produce an Info or HTML file.

`doc/gawk.info'
     The generated Info file for this Info file.

`doc/gawkinet.texi'
     The Texinfo source file for Note: Top.  It should be processed
     with TeX to produce a printed document and with `makeinfo' to
     produce an Info or HTML file.

`doc/gawkinet.info'
     The generated Info file for `TCP/IP Internetworking with `gawk''.

`doc/igawk.1'
     The `troff' source for a manual page describing the `igawk'
     program presented in *Note An Easy Way to Use Library Functions:
     Igawk Program.

`doc/Makefile.in'
     The input file used during the configuration process to generate
     the actual `Makefile' for creating the documentation.

`Makefile.am'
`*/Makefile.am'
     Files used by the GNU `automake' software for generating the
     `Makefile.in' files used by `autoconf' and `configure'.

`Makefile.in'
`acconfig.h'
`acinclude.m4'
`aclocal.m4'
`configh.in'
`configure.in'
`configure'
`custom.h'
`missing_d/*'
`m4/*'
     These files and subdirectories are used when configuring `gawk'
     for various Unix systems.  They are explained in Note: Compiling
     and Installing `gawk' on Unix.

`intl/*'
`po/*'
     The `intl' directory provides the GNU `gettext' library, which
     implements `gawk''s internationalization features, while the `po'
     library contains message translations.

`awklib/extract.awk'
`awklib/Makefile.am'
`awklib/Makefile.in'
`awklib/eg/*'
     The `awklib' directory contains a copy of `extract.awk' (Note:
     Extracting Programs from Texinfo Source Files.),
     which can be used to extract the sample programs from the Texinfo
     source file for this Info file. It also contains a `Makefile.in'
     file, which `configure' uses to generate a `Makefile'.
     `Makefile.am' is used by GNU Automake to create `Makefile.in'.
     The library functions from *Note A Library of `awk' Functions:
     Library Functions, and the `igawk' program from Note: An Easy Way
     to Use Library Functions, are included as
     ready-to-use files in the `gawk' distribution.  They are installed
     as part of the installation process.  The rest of the programs in
     this Info file are available in appropriate subdirectories of
     `awklib/eg'.

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

`unsupported/tandem/*'
     Files needed for building `gawk' on a Tandem (Note: Installing
     `gawk' on a Tandem., for details).

`posix/*'
     Files needed for building `gawk' on POSIX-compliant systems.

`pc/*'
     Files needed for building `gawk' under MS-DOS, MS Windows and OS/2
     (Note: Installation on PC Operating Systems., for
     details).

`vms/*'
     Files needed for building `gawk' under VMS (Note: How to Compile
     and Install `gawk' on VMS., for details).

`test/*'
     A test suite for `gawk'.  You can use `make check' from the
     top-level `gawk' directory to run your version of `gawk' against
     the test suite.  If `gawk' successfully passes `make check', then
     you can be confident of a successful port.