guile-debugging README (from guile-debugging 0.15)
guile-debugging enhances the debugging features of the core Guile
distribution by adding support for breakpoints and single-stepping,
and an Emacs interface to the debugger.
Please send any suggestions, contributions and bug reports to
neil@ossau.uklinux.net.
Naming and Code Management
guile-debugging is an independent release of my debugging and Emacs
interface work that has now mostly been merged back into Guile CVS
HEAD. The idea of this arrangement is that guile-debugging's features
will automatically be included in the next major Guile release, but
that I can also continue to make independent releases for the benefit
of people using 1.6.x or 1.8.x.
Therefore the master repository for most of guile-debugging's code is
now the core Guile CVS (at gnu.org). guile-debugging's CVS (at
gna.org) continues for now to hold things like the FAQ, NEWS,
Makefiles and autoconfery, and this README. (A guile-debugging release
is prepared by copying files from Guile CVS into the guile-debugging
tree and then generating a distribution from the combined tree.)
Detailed Documentation
Like the code, most of guile-debugging's documentation is now merged
into Guile CVS. A snapshot of the Guile CVS reference manual is
available at http://www.ossau.uklinux.net/guile/cvsdoc;
the sections that document features in guile-debugging are:
There is a file named guile-debugging.texi in the guile-debugging CVS
at gna.org, but it's just a placeholder for the remaining few snippets
that have not yet gone to Guile CVS.
Prerequisites
guile-debugging requires Guile version 1.6.5 or later. (Previous
versions had a bug which caused Guile to enter an infinite loop when a
breakpoint was set.)
Some features of guile-debugging require a more recent Guile version
than that. "Tweaking", for example, requires version 1.8.0 or later.
Obtaining Guile
If you or your distribution don't already have Guile 1.6.5 or later,
you can download and install it 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.
© Neil Jerram
2006, 2008.