This is release 0.3 of guile-gui.              -*- text -*-

guile-gui is a Guile Scheme code that implements a simple graphical
user interface for Guile.

Please send suggestions, contributions and bug reports to
neil@ossau.uklinux.net.


Getting Started ======================================================

1. Make sure that you have a version of Guile that includes the
   `(ice-9 buffered-input)' module.  Right now (March 2001), this
   means a copy of CVS Guile later than March 7th 2001.

   (You can type

     guile -c '(use-modules (ice-9 buffered-input))'

   in your terminal window to check.  If your Guile doesn't have this
   module, you'll get a "no such module" error.)

   If not, see under "Obtaining guile-gui and Guile" how to get it.

2. Make sure that you stand in the `guile-gui' directory and type

     ./configure

   This will configure guile-gui for your system.

3. Type

     make install

   to build and install guile-gui.

   If everything went well we're ready to try out the GUI...

4. Type

     guile-gui &

   A GTK window should appear that contains a text area at the top and
   a text entry widget at the bottom.  You should be able to type
   Guile expressions into the entry widget in exactly the same way
   that you would type on the command line.  In particular,
   parenthesis matching and history should both work as normal.  Your
   input is echoed in a distinctive colour and font in the text area,
   and the text area also displays any output that results from the
   evaluation of your input.


Next Steps ===========================================================

There are lots of things that it would be nice to add, such as

- a menu bar for common operations, e.g. asking for help

- a widget or status bar displaying the current module, and perhaps
  all modules used by the current module

- a browser for all currently visible bindings.

I'd like to do these quite soon, but I think it only makes sense to
use Glade and something like Thien Thi Nguyen's glade2scm for the
window layout (rather than doing it all by hand), so I need to check
out the status on those tools first.


About This Distribution ==============================================

Building and installing this distribution gives you:

- a set of Scheme files, gui.scm, which are installed at
  <prefix>/share/guile/gui/gui.scm

- an executable Guile script, guile-gui, which is installed at
  <prefix>/bin/guile-gui.

Other interesting files include:

- INSTALL, which contains (generic) instructions on building and
  installing guile-gui.

- NEWS, which describes user-visible changes since the last release of
  guile-gui. 

- COPYING, which describes the terms under which you may redistribute
  guile-gui, and explains that there is no warranty.


Obtaining guile-gui and Guile ======================================================

The latest guile-gui release is always available from my Guile page
at http://www.ossau.uklinux.net/guile.  This release is at
http://www.ossau.uklinux.net/guile/guile-gui-0.2.tar.gz.

If you don't already have a recent (March 2001 or later) CVS Guile
installed on your system, you also need to download and install this
by following the instructions at http://www.gnu.org/software/guile.

The mailing list `guile-user@gnu.org' carries discussions, questions,
and often answers, about Guile.  To subscribe, send mail to
guile-user-request@gnu.org.
