Guile 1.3 released

[Jim Blandy <jimb red-bean com>]

[This was posted to gnu-announce too; it won't appear there until the
tar file actually appears on prep.  But it's been sent off to the FSF.]

Version 1.3 of Guile is now available via anonymous FTP from
prep.ai.mit.edu, in pub/gnu.

Guile is a portable, embeddable Scheme implementation written in C.
Guile provides a machine independent execution platform that can be
linked in as a library when building extensible programs.

The mailing list `guile@cygnus.com' carries discussions, questions,
and often answers, about Guile.  To subscribe, send mail to
guile-request@cygnus.com.  Of course, please send bug reports (and
fixes!) to bug-guile@gnu.org.  Note that one address is @cygnus.com,
and the other is at @gnu.org.

This release contains many bug fixes and incremental improvements.
In particular:
- The C API has been revised in many places, based on input from users.
- The `guile-config' script makes it easier to compile and link C code
  that uses Guile.
- The blocking behavior of the cooperative threading system is
  improved.
- Guile can now use the readline library when run interactively, 
  providing full command editing, history, and completion.

For further details, see NEWS, in the distribution.

Thanks ===============================================================

The Guile developers would like to thank the following people for
their contributions to this release of Guile:
- Marcus Daniels contributed changes to make Guile work under Windows NT
  (using the cygwin32 DLL).
- Bernard Urban, for his work on the Hobbit Scheme->C compiler
- Tim Pierce, for faster line-oriented I/O (%read-line and friends)

Bug reports and fixes from:

    Lauri Alanko, Andrew Archibald, Greg Badros, Aleksandar Bakic, Per
    Bothner, Jost Boekemeier, Ben Caradoc-Davies, Marcus Daniels, Doug
    Evans, Fred Fish, Jesse N. Glick, Eric Hanchrow, Greg Harvey, Karl
    M. Hegbloom, Dirk Herrmann, Gary Houston, Charbel Jacquin, Bill
    Janssen, Steven G. Johnson, Roland Kaufmann, Shiro Kawai, Christopher
    Lee, Michael N. Livshin, Christian Lynbech, Roland McGrath, Clark
    McGrew, Russ McManus, Harald Meland, Perry Metzger, Thomas Morgan,
    Shuji Narazaki, Nicolas Neuss, Thien-Thi Nguyen, Robert Pluim, Richard
    Polton, Chet Ramey, Jim Ravan, John Redford, Daniel Risacher, Ole
    Myren Röhne, Julian Satchell, Jorgen "forcer" Schaefer, Larry
    Schwimmer, Radey Shouman, Miroslav Silovic, Maciej Stachowiak, Harvey
    J. Stein, Eiichi Takamori, David Tillman, John Tobey, Greg Troxel,
    Bernard Urban.

Also, thanks to:
- Pat Eyler, for his continuing work on the Guile web pages
- Oliver Frommel, for setting up the European mirror of the
  Guile development FTP server
- MORIOKA Tomohiko, for setting up the Japan mirror site

Apologies to any we've forgotten.


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

Building and installing this distribution gives you:
guile --- a stand-alone interpreter for Guile, usually installed in
	/usr/local/bin.  With no arguments, this is a simple
	interactive Scheme interpreter.  It can also be used as an
	interpreter for script files; see the NEWS file for details.
guile-config --- a Guile script which provides the information necessary
	to link your programs against the Guile library.
guile-snarf --- a script to parse declarations in your C code for 
	Scheme-visible C functions, Scheme objects to be used by C code, etc.
libguile.a --- an object library containing the Guile interpreter,
	usually installed in /usr/local/lib.  You can use Guile in
	your own programs by linking against this.
libqthreads.a --- an object library containing the QuickThreads
	primitives.  If you enabled thread support when you configured
	Guile, you will need to link your code against this too.
<libguile.h>, <guile/gh.h>, <libguile/*.h> --- header files for
	libguile.a, usually installed in /usr/local/include.
ice-9, ice-9/*.scm --- run-time support for Guile: the module
	system, read-eval-print loop, some R4RS code and other
	infrastructure.  Usually installed in
	/usr/local/share/guile/<version>.
data-rep.info --- An essay on how to write C code that works with
	Guile Scheme values.

Interesting files include:
- INSTALL, which contains instructions on building and installing Guile.
- NEWS, which describes user-visible changes since the last release of Guile.
- COPYING, which describes the terms under which you may redistribute
  Guile, and explains that there is no warranty.

The Guile source tree is laid out as follows:

libguile:
	The Guile Scheme interpreter --- both the object library
	for you to link with your programs, and the executable you can run.
ice-9:  Guile's module system, initialization code, and other infrastructure.
guile-config:
	Source for the guile-config script.
qt: 	A cooperative threads package from the University of Washington,
	which Guile can use.  If you configure Guile with the
        --with-threads flag, you will need to link against the -lqt
        library, found in this directory.  Qt is under a separate
        copyright; see `qt/README' for more details.
doc:	Some preliminary documentation for Guile.  The real Guile
	manual is incomplete, and is currently being revised.
doc/example-smob: Sample code, discussed in the preliminary
	documentation above, for a program that extends Guile with a
	new data type, and functions that operate on it.


Anonymous CVS Access and FTP snapshots ===============================

We make the developers' working Guile sources available via anonymous
CVS, and by nightly snapshots, accessible via FTP.  See the files
`ANON-CVS' and `SNAPSHOTS' for details.


Hacking It Yourself ==================================================

As distributed, Guile needs only an ANSI C compiler and a Unix system
to compile.  However, Guile's makefiles, configuration scripts, and a
few other files are automatically generated, not written by hand.  If
you want to make changes to the system (which we encourage!) you will
find it helpful to have the tools we use to develop Guile.  They
are the following:

Autoconf 2.12 --- a system for automatically generating `configure'
	scripts from templates which list the non-portable features a
	program would like to use.  Available in
	"ftp://prep.ai.mit.edu/pub/gnu".

Automake 1.3 --- a system for automatically generating Makefiles that
	conform to the (rather Byzantine) GNU coding standards.  The
	nice thing is that it takes care of hairy targets like 'make
	dist' and 'make distclean', and automatically generates
	Makefile dependencies.  Automake is available in
	"ftp://prep.ai.mit.edu/pub/gnu".

	Before using automake, you may need to copy `threads.m4' and
	`guile.m4' from the top directory of the Guile core disty to
	`/usr/local/share/aclocal.

libtool 1.2 --- a system for managing the zillion hairy options needed
	on various systems to produce shared libraries.  Available in
	"ftp://prep.ai.mit.edu/pub/gnu".

You are lost in a little maze of automatically generated files, all
different.
> 


Authors And Contributors =============================================

Many people have generously contributed to Guile.  However, any errors
are the responsibility of the primary Guile maintainer, Jim Blandy.

Mikael Djurfeldt designed and implemented:
* the source-level debugging support (although the debugger's user
  interface is not yet complete)
* stack overflow detection,
* the GDB patches to support debugging mixed Scheme/C code,
* the original implementation of weak hash tables,
* enhancements to the `threads' interface (based on Anthony Green's
  work), and
* detection of circular references during printing.

Mark Galassi contributed the Guile high-level functions (gh_*), and
wrote the guile-programmer and guile-user manuals.  (These are in the
process of revision.)

Anthony Green wrote the original version of `threads', the interface
between Guile and qt.

Gary Houston wrote much of the Unix system call support, including the
socket support, and did a lot of work on the error handling code.

Tom Lord librarified SCM, yielding Guile.  He wrote Guile's operating
system, Ice-9, and connected Guile to Tcl/Tk and the `rx' regular
expression matcher.

Aubrey Jaffer is the author of SCM upon which Guile is based.  Guile
started from SCM version 4e1 in November -94 and is still largely
composed of the original SCM code.

George Carrette wrote SIOD, a stand-alone scheme interpreter.
Although most of this code as been rewritten or replaced over time,
the garbage collector from SIOD is still an important part of Guile.