summaryrefslogtreecommitdiff
path: root/doc/ref/scheme-using.texi
diff options
context:
space:
mode:
authorNeil Jerram <neil@ossau.uklinux.net>2008-07-11 17:53:43 +0100
committerNeil Jerram <neil@ossau.uklinux.net>2008-07-17 23:05:57 +0100
commit091baf9edfb8330226524b99c3bf623499516bf7 (patch)
treec10c5cc50e2397626401f6d930d945e9cea563d4 /doc/ref/scheme-using.texi
parent0d751d472091421d91c097342c849cd52386f6ca (diff)
downloadguile-091baf9edfb8330226524b99c3bf623499516bf7.tar.gz
Single stepping through code from Emacs
When you use GDS to evaluate Scheme code from Emacs, you can now use `C-u' to indicate that you want to single step through that code. See `Evaluating Scheme Code' in the manual for more details. * scheme-using.texi (Evaluating Scheme Code): Document use of `C-u' prefix with evaluation commands. * gds-scheme.el (gds-eval-region, gds-eval-expression) (gds-eval-defun, gds-eval-last-sexp): Support `C-u' prefix, meaning that user wants to single step through the code. * gds-client.scm (handle-nondebug-protocol): Add support for setting a trap on code that is about to be evaluated.
Diffstat (limited to 'doc/ref/scheme-using.texi')
-rw-r--r--doc/ref/scheme-using.texi8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/ref/scheme-using.texi b/doc/ref/scheme-using.texi
index 092fb4e39..96273b7d0 100644
--- a/doc/ref/scheme-using.texi
+++ b/doc/ref/scheme-using.texi
@@ -988,6 +988,14 @@ region contains a balanced expression, or try to expand the region so
that it does; it uses the region exactly as it is.
@end table
+If you type @kbd{C-u} before one of these commands, GDS will
+immediately pop up a Scheme stack buffer, showing the requested
+evaluation, so that you can single step through it. (This is achieved
+by setting a @code{<source-trap>} trap at the start of the requested
+evaluation; see @ref{Source Traps} for more on how those work.) The
+Scheme stack display, and the options for continuing through the code,
+are described in the next two sections.
+
@node Displaying the Scheme Stack
@subsection Displaying the Scheme Stack