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.