diff options
author | Neil Jerram <neil@ossau.uklinux.net> | 2005-12-14 00:51:58 +0000 |
---|---|---|
committer | Neil Jerram <neil@ossau.uklinux.net> | 2005-12-14 00:51:58 +0000 |
commit | 31e2cc5088c656d27332796e629e576c8fd92f91 (patch) | |
tree | 59a372b93489b3b955423ad70ba6a5bf39120a44 /doc/ref/api-options.texi | |
parent | ec3a8ace63d1d42524c5a93c59cf7fe5ff1f0548 (diff) | |
download | guile-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.texi | 17 |
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 |