Gawk/Distribution-contents
Previous: Extracting, Up: Gawk Distribution [Contents][Index]
B.1.3 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
(see section Compiling and Installing gawk
on Unix-Like Systems),
as well as several subdirectories related to different non-Unix
operating systems:
- Various ‘
.c
’, ‘.y
’, and ‘.h
’ files - These files contain the actual
gawk
source code.
support/*
C header and source files for routines that
gawk
uses, but that are not part of its core functionality. For example, argument parsing, regular expression matching, and random number generating routines are all kept here.ABOUT-NLS
A file containing information about GNU
gettext
and translations.AUTHORS
A file with some information about the authorship of
gawk
. It exists only to satisfy the pedants at the Free Software Foundation.README
README_d/README.*
Descriptive files:
README
forgawk
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.
ChangeLog.0
An older list of source code changes.
NEWS
A list of changes to
gawk
since the last release or patch.NEWS.0
An older list of changes to
gawk
.COPYING
The GNU General Public License.
POSIX.STD
A description of behaviors in the POSIX standard for
awk
that are left undefined, or wheregawk
may not comply fully, as well as a list of things that the POSIX standard should describe but does not.doc/awkforai.txt
Pointers to the original draft of a short article describing why
gawk
is a good language for artificial intelligence (AI) programming.doc/bc_notes
A brief description of
gawk
’s “byte code” internals.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-colorawk
reference card. A modern version oftroff
such as GNUtroff
(groff
) is needed to produce the color version. See the fileREADME.card
for instructions if you have an oldertroff
.doc/gawk.1
The
troff
source for a manual page describinggawk
. This is distributed for the convenience of Unix users.doc/gawktexi.in
doc/sidebar.awk
The Texinfo source file for this Web page. It should be processed by
doc/sidebar.awk
before processing withtexi2dvi
ortexi2pdf
to produce a printed document, and withmakeinfo
to produce an Info or HTML file. TheMakefile
takes care of this processing and produces printable output viatexi2dvi
ortexi2pdf
.doc/gawk.texi
The file produced after processing
gawktexi.in
withsidebar.awk
.doc/gawk.info
The generated Info file for this Web page.
doc/gawkinet.texi
The Texinfo source file for TCP/IP Internetworking with
gawk
. It should be processed with TeX (viatexi2dvi
ortexi2pdf
) to produce a printed document and withmakeinfo
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 theigawk
program presented in An Easy Way to Use Library Functions. (Sincegawk
can do its own@include
processing, neitherigawk
norigawk.1
are installed.)doc/it/*
Files for the Italian translation of this Web page, produced and contributed by Antonio Colombo and Marco Curreli.
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 andconfigure
.Makefile.in
aclocal.m4
bisonfix.awk
config.guess
configh.in
configure.ac
configure
custom.h
depcomp
install-sh
missing_d/*
mkinstalldirs
m4/*
These files and subdirectories are used when configuring and compiling
gawk
for various Unix systems. Most of them are explained in Compiling and Installinggawk
on Unix-Like Systems. The rest are there to support the main infrastructure.po/*
The
po
library contains message translations.awklib/extract.awk
awklib/Makefile.am
awklib/Makefile.in
awklib/eg/*
The
awklib
directory contains a copy ofextract.awk
(see section Extracting Programs from Texinfo Source Files), which can be used to extract the sample programs from the Texinfo source file for this Web page. It also contains aMakefile.in
file, whichconfigure
uses to generate aMakefile
.Makefile.am
is used by GNU Automake to createMakefile.in
. The library functions from A Library ofawk
Functions, are included as ready-to-use files in thegawk
distribution. They are installed as part of the installation process. The rest of the programs in this Web page are available in appropriate subdirectories ofawklib/eg
.extension/*
The source code, manual pages, and infrastructure files for the sample extensions included with
gawk
. See section Writing Extensions forgawk
, for more information.extras/*
Additional non-essential files. Currently, this directory contains some shell startup files to be installed in
/etc/profile.d
to aid in manipulating theAWKPATH
andAWKLIBPATH
environment variables. See section Shell Startup Files, for more information.posix/*
Files needed for building
gawk
on POSIX-compliant systems.pc/*
Files needed for building
gawk
under MS-Windows (see section Installation on MS-Windows for details).vms/*
Files needed for building
gawk
under Vax/VMS and OpenVMS (see section Compiling and Installinggawk
on Vax/VMS and OpenVMS for details).test/*
A test suite for
gawk
. You can use ‘make check
’ from the top-levelgawk
directory to run your version ofgawk
against the test suite. Ifgawk
successfully passes ‘make check
’, then you can be confident of a successful port.
Previous: Extracting, Up: Gawk Distribution [Contents][Index]