This directory holds the source code and documentation for the latest
release of Elk, the Extension Language Kit.  The following serves as
a roadmap summarizing the contents of the files and subdirectories of
the distribution.

RELEASE       Explains the purpose and release status of Elk.

CHANGES       This file lists the changes between this and earlier
              releases of Elk.

MIGRATE       Explains how extensions written for older versions of Elk
              have to be modified (if necessary) so that they can be used
              with the most recent version.

INSTALL       Instructions how to compile and install Elk on your system,
	      and a brief description of the files that get installed in
	      the process.

              This file also explains the structure of the Makefiles and
	      the purpose of the Makefile.local and `build' files in
	      each source directory.

MACHINES      Provides additional, machine-specific information (such as
              compiler bugs, unsupported features, problems with older OS
              versions and other pitfalls) about installing and using Elk
              on the platforms where it has been tested.

BUGS	      Provides information about known problems of this release.

TODO	      Ideas for further releases and potential projects.

COPYRIGHT     The copyright status of the distribution.

CONTRIBUTORS  Acknowledgments of the people who have contributed to this
              release of Elk.

config/       This directory holds the configuration files containing
              machine- and site-specific information required for building
              Elk.  See INSTALL for details.

include/      The include files to be included by applications that use
              Elk as their extension language, and by extensions to Elk.
              Including "scheme.h" from this directory causes all the
              other .h files to be included in the right order.  The
              include files may or may not use ANSI/ISO-C function
              prototypes, depending on the config file you have chosen.

scripts/      A few shell scripts that can be used to link the interpreter
              with a number of extensions (on platforms that do not support
              dynamic loading of object files) and to create dynamically
	      loadable extensions.  See scripts/README and INSTALL for
	      details.

src/          This directory contains holds the source files of the
              interpreter proper.

scm/          The Scheme files that are loaded into the interpreter during
              runtime.  These files are copied to a destination directory
              (specified in config/site) when Elk is installed.

lib/          In this directory tree you find the source code of the Elk
              extensions that are part of the distribution (such as the
              X11 extensions).

lib/xlib/     The C language source files of the Xlib extension.

lib/xt/       The C language source files of the Xt (X11 Toolkit Intrinsics)
              extension.  See doc/README, doc/xlib/, and doc/xt/ for
              documentation for the X11 extensions to Elk.

lib/xaw/      The interfaces to the Athena widgets.  This directory and
              lib/xm/ contain one file with the extension .d for each
              Athena (Motif) widget class.  These .d files are first
              compiled into C source files by running `make' and then
              compiled into dynamically loadable object files.

lib/xm/       The interfaces to the Motif widgets.  See examples/xaw/ and
              examples/xm/ for demo programs that make use of the Athena
              and Motif extensions to Elk.

lib/unix/     The UNIX extension.  See doc/unix/ for documentation.

lib/misc/     This directory contains the record extension, a GNU dbm
              extension, and a couple of other small Elk extensions that
              mainly serve as demonstrations.

doc/          This directory tree holds the documentation for Elk as
              troff input files and pre-generated PostScript files.
              See doc/README for a roadmap.

examples/     In this directory tree you find a number of simple
              demonstration programs written in Scheme.  The programs in
              examples/scheme/ have been collected from various sources
              (among them USENET and the Scheme mailing list).
	      There are other subdirectories with demonstration programs
	      for the UNIX and X11 extensions (Athena and Motif widgets).

util/         A few test programs that may help in preparing a config
              file for an as yet unsupported platform; and other programs
              that are only required on certain exotic systems.  See README
              in this directory for details.

contrib/      This directory tree holds a collection of Elk extensions that
              have been contributed by users of Elk.  I haven't tested most
              of the packages in this directory; I don't even know if all
              of them are usable with the current release of Elk.
