Release notes for Cygnus-CSK Guile release 1.

Overview
--------

Guile is an embeddable Scheme environment and application extension
language.

Among other things Cygnus-CSK Guile release 1 includes:

    - core Guile components from the guile-iv preview
    - the SurfIt! web browser
    - SurfIt! support for Guile applets
    - Guile and SurfIt! support for handling Japanese text
    - the Apache web server
    - documentation
    - the Guile test framework

Pre-built distributions
-----------------------

This distribution includes pre-built executables for Linux, Solaris,
and Irix platforms.

The pre-built executables contain a hard coded path.  To use them the
Guile distribution must be installed as /usr/cygnus/guile-r1

Running Guile
-------------

Easy.  Just execute:

    /usr/cygnus/guile-r1/arch/bin/guile

Running SurfIt!
---------------

The SurfIt! html docs and test applets are not currently installed.
To be able to run SurfIt! and see the Japanese text support and Guile
applet demo:

    unset WWW_HOME
    cd /usr/cygnus/guile-r1/arch/src/guile/surfit
    ./surfit

SurfIt! has been known to crash if the mouse button is pressed to
quickly while SurfIt! is still starting up.

Guile Applets
-------------

A spec for creating Guile applets is contained in

    /usr/cygnus/guile-r1/arch/html/guile/applet.html

The applet-loaddata command is currently not implemented.

Guile Documentation
-------------------

Info files for the Guile user and programmer manuals can be found
in

    /usr/cygnus/guile-r1/arch/info

The source for this documentation is found in 

    /usr/cygnus/guile-r1/src/guile/guile-docs

Source distribution
-------------------

The src directory contains the complete sources used in building this
release.

Briefly, the components of the source distribution include:

    guile/guile		- Guile standalone interpreter
    guile/libguile	- Guile embeddable interpreter
    guile/gls		- Guile bootstrapping startup code
    guile/slib		- Guile standard Scheme libraries

    guile/gtcltk	- Guile interface to Tcl/Tk
    guile/goonix	- Guile interface to Posix
    guile/ggl		- Guile interface to OpenGL

    guile/tcl		- Tool Command Language
    guile/tk		- Windowing Tool Kit
    guile/mesa		- OpenGL work alike
    guile/glut		- GL User Toolkit
    guile/ctax		- C-like syntax module for Guile
    guile/rx		- Regular expression library
    guile/surfit	- Web browser
    apache		- Web server
    guile/testsuite	- The Guile testsuite

    guile/guile-docs	- Guile documentation

Building Guile
--------------

To build and install the Guile system from source:

    cd src/guile
    configure --prefix=/usr/cygnus/guile-r1 --enable-i18n --with-threads
    make
    make install

Enable-i18n only needs to be specified if you wish to use Guile's
Internationalization features.

With-threads only needs to be specified if you wish to build with the
new multithreading features.

Building Guile on Linux
-----------------------

There is a bug in some versions of Linux that manifests itself by
SurfIt! going wild and continuing to madly read past the end of the
page when it first starts up.

This bug can be worked around by building the Linux distribution using
CFLAGS=-g.

