mirror/guile
mirror/guile
1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-06-09 13:30:26 +02:00
Code Activity

(Access to Guile Help and Completion): Mention where keys are

Browse source 
defined.
(Setting and Managing Breakpoints): Update text on how to set
breakpoints.
This commit is contained in:
Neil Jerram 2006-10-06 00:10:36 +00:00
parent 7e5a256c84
commit 72ea645a88
2 changed files with 38 additions and 16 deletions
Download patch file Download diff file Expand all files Collapse all files

4
doc/ref/ChangeLog
View file

@ -6,6 +6,10 @@
to Guile Help and Completion) to (Access to Guile Help and to Guile Help and Completion) to (Access to Guile Help and
Completion, Setting and Managing Breakpoints, Evaluating Scheme Completion, Setting and Managing Breakpoints, Evaluating Scheme
Code, Displaying the Scheme Stack, Continuing Execution). Code, Displaying the Scheme Stack, Continuing Execution).
(Access to Guile Help and Completion): Mention where keys are
defined.
(Setting and Managing Breakpoints): Update text on how to set
breakpoints.
2006-10-03 Neil Jerram <neil@ossau.uklinux.net> 2006-10-03 Neil Jerram <neil@ossau.uklinux.net>

50
doc/ref/scheme-using.texi
View file

@ -824,7 +824,7 @@ stack, so the end result is very similar to what
The following keystrokes provide fast and convenient access to Guile's The following keystrokes provide fast and convenient access to Guile's
built in help, and to completion with respect to the set of defined and built in help, and to completion with respect to the set of defined and
accessible symbols. accessible symbols. They are defined in all @code{scheme-mode} buffers.
@table @kbd @table @kbd
@item C-h g @item C-h g
@ -861,15 +861,34 @@ selected using either @kbd{@key{RET}} or the mouse.
@subsection Setting and Managing Breakpoints @subsection Setting and Managing Breakpoints
You can create a breakpoint in GDS by typing @kbd{C-x @key{SPC}} in a You can create a breakpoint in GDS by typing @kbd{C-x @key{SPC}} in a
Scheme mode buffer. To create a breakpoint on calls to a procedure Scheme mode buffer. To create a breakpoint on calls to a procedure ---
--- i.e. the equivalent of calling @code{break-in} --- place the i.e. the equivalent of calling @code{break-in} --- place the cursor
cursor on the procedure's name and type @kbd{C-x @key{SPC}}. To anywhere within the procedure's definition, make sure that the region is
create breakpoints on a particular expression, or on the series of unset, and type @kbd{C-x @key{SPC}}. To create breakpoints on a
expressions in a particular region --- i.e. as with @code{break-at} particular expression, or on the series of expressions in a particular
--- select the expression or region in the usual way and type @kbd{C-x region --- i.e. as with @code{break-at} --- select a region containing
@key{SPC}}. In general, GDS assumes that you want a @code{break-at} the open parentheses of the expressions where you want breakpoints, and
breakpoint if there is an active region, and a @code{break-in} type @kbd{C-x @key{SPC}}. In other words, GDS assumes that you want a
breakpoint otherwise. @code{break-at} breakpoint if there is an active region, and a
@code{break-in} breakpoint otherwise.
There are three supported breakpoint behaviours, known as @code{debug},
@code{trace} and @code{trace-subtree}. @code{debug} means that GDS will
display the stack and wait for instruction when the breakpoint is hit.
@code{trace} means that a line will be written to the trace output
buffer (@code{*GDS Trace*}) when the breakpoint is hit, and when the
relevant expression or procedure call returns. @code{trace-subtree}
means that a line is written to the trace output buffer for every
evaluation step between when the breakpoint is hit and when the
expression or procedure returns.
@kbd{C-x @key{SPC}} creates a breakpoint with behaviour according to the
@code{gds-default-breakpoint-type} variable, which by default is
@code{debug}; you can customize this if you prefer a different default.
You can also create a breakpoint with behaviour other than the current
default by using the alternative key sequences @kbd{C-c C-b d} (for
@code{debug}), @kbd{C-c C-b t} (@code{trace}) and @kbd{C-c C-b T}
(@code{trace-subtree}).
When you create a breakpoint like this, two things happen. Firstly, When you create a breakpoint like this, two things happen. Firstly,
if the current buffer is associated with a Guile client program, the if the current buffer is associated with a Guile client program, the
@ -883,12 +902,11 @@ Secondly, it is added to GDS's @emph{global} list of all breakpoints.
This list holds the breakpoint information that will be given to any This list holds the breakpoint information that will be given to any
client program that asks for it by calling @code{set-gds-breakpoints}. client program that asks for it by calling @code{set-gds-breakpoints}.
The fact that this list is global, rather than client-specific, means The fact that this list is global, rather than client-specific, means
that the breakpoints you have set will automatically be recreated if that the breakpoints you have set will automatically be recreated if the
the program you are debugging has to be stopped and restarted --- program you are debugging has to be stopped and restarted.@footnote{An
which in my experience happens often.@footnote{An important point here important point here is that there is nothing that unambiguously relates
is that there is nothing that unambiguously relates two subsequent two subsequent runs of the same client program, which might allow GDS to
runs of the same client program, which might allow GDS to pass on pass on breakpoint settings more precisely.}
breakpoint settings more precisely.}
(The only possible downside of this last point is that if you are (The only possible downside of this last point is that if you are
debugging two programs in parallel, which have some code in common, debugging two programs in parallel, which have some code in common,