summaryrefslogtreecommitdiff
path: root/doc/ref/api-options.texi
diff options
context:
space:
mode:
authorNeil Jerram <neil@ossau.uklinux.net>2005-12-14 00:51:58 +0000
committerNeil Jerram <neil@ossau.uklinux.net>2005-12-14 00:51:58 +0000
commit31e2cc5088c656d27332796e629e576c8fd92f91 (patch)
tree59a372b93489b3b955423ad70ba6a5bf39120a44 /doc/ref/api-options.texi
parentec3a8ace63d1d42524c5a93c59cf7fe5ff1f0548 (diff)
downloadguile-31e2cc5088c656d27332796e629e576c8fd92f91.tar.gz
(Evaluator trap options): Trap calls now always
use a debug object rather than a continuation. (Debugger options, Examples of option use): Update help text for 'cheap option (which is now obsolete).
Diffstat (limited to 'doc/ref/api-options.texi')
-rw-r--r--doc/ref/api-options.texi17
1 files changed, 11 insertions, 6 deletions
diff --git a/doc/ref/api-options.texi b/doc/ref/api-options.texi
index 7caba0c78..7fd85ff90 100644
--- a/doc/ref/api-options.texi
+++ b/doc/ref/api-options.texi
@@ -574,8 +574,10 @@ called has the trace property enabled.
@end itemize
@end itemize
-If cheap traps are enabled [debug-options interface], @var{cont} is a
-debug object, otherwise it is a restartable continuation.
+@var{cont} is a ``debug object'', which means that it can be passed to
+@code{make-stack} to discover the stack at the point of the trap. The
+apply frame handler's code can capture a restartable continuation if it
+wants to by using @code{call-with-current-continuation} in the usual way.
@var{tailp} is true if this is a tail call
@end deffn
@@ -599,8 +601,11 @@ called has the trace property enabled.
@end itemize
@end itemize
-If cheap traps are enabled [debug-options interface], @var{cont} is a
-debug object, otherwise it is a restartable continuation.
+@var{cont} is a ``debug object'', which means that it can be passed to
+@code{make-stack} to discover the stack at the point of the trap. The
+exit frame handler's code can capture a restartable continuation if it
+wants to by using @code{call-with-current-continuation} in the usual
+way.
@var{retval} is the return value.
@end deffn
@@ -624,7 +629,7 @@ backwards no Display backtrace in anti-chronological order.
procnames yes Record procedure names at definition.
trace no *Trace mode.
breakpoints no *Check for breakpoints.
-cheap yes *Flyweight representation of the stack at traps.
+cheap yes *This option is now obsolete. Setting it has no effect.
@end smallexample
@subsubheading Stack overflow
@@ -714,7 +719,7 @@ backwards no Display backtrace in anti-chronological order.
procnames yes Record procedure names at definition.
trace no *Trace mode.
breakpoints no *Check for breakpoints.
-cheap yes *Flyweight representation of the stack at traps.
+cheap yes *This option is now obsolete. Setting it has no effect.
guile> (read-enable 'case-insensitive)
(keywords #f case-insensitive positions)
guile> aBc