summaryrefslogtreecommitdiff
path: root/doc/ref/scheme-debug.texi
diff options
context:
space:
mode:
authorNeil Jerram <neil@ossau.uklinux.net>2002-04-20 19:26:40 +0000
committerNeil Jerram <neil@ossau.uklinux.net>2002-04-20 19:26:40 +0000
commitce9d056227b0548cf5c1ca11dab10dfe0b8e491c (patch)
tree4cd7f991a278378e14861c71236a7cd6ee79a1be /doc/ref/scheme-debug.texi
parentf2ba76aea59136a8d1ca15456c8c96545ae468da (diff)
downloadguile-ce9d056227b0548cf5c1ca11dab10dfe0b8e491c.tar.gz
Manual debugging and refactoring work.
Diffstat (limited to 'doc/ref/scheme-debug.texi')
-rw-r--r--doc/ref/scheme-debug.texi18
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/ref/scheme-debug.texi b/doc/ref/scheme-debug.texi
index ce0be8907..670bd0884 100644
--- a/doc/ref/scheme-debug.texi
+++ b/doc/ref/scheme-debug.texi
@@ -25,6 +25,13 @@ Return @code{#t} if @var{obj} is a debug object.
@section Capturing the Stack or Innermost Stack Frame
+When an error occurs in a running program, or the program hits a
+breakpoint, its state at that point can be represented by a @dfn{stack}
+of all the evaluations and procedure applications that are logically in
+progress at that time, each of which is known as a @dfn{frame}. The
+programmer can learn more about the program's state at the point of
+interruption or error by inspecting the stack and its frames.
+
@deffn {Scheme Procedure} make-stack obj . args
@deffnx {C Function} scm_make_stack (obj, args)
Create a new stack. If @var{obj} is @code{#t}, the current
@@ -183,6 +190,17 @@ Return the environment of the memoized expression @var{m}.
@end deffn
+@section Starting a New Stack
+
+@deffn {Scheme Syntax} start-stack id exp
+Evaluate @var{exp} on a new calling stack with identity @var{id}. If
+@var{exp} is interrupted during evaluation, backtraces will not display
+frames farther back than @var{exp}'s top-level form. This macro is a
+way of artificially limiting backtraces and stack procedures, largely as
+a convenience to the user.
+@end deffn
+
+
@c Local Variables:
@c TeX-master: "guile.texi"
@c End: