summaryrefslogtreecommitdiff
path: root/doc/ref/api-options.texi
diff options
context:
space:
mode:
authorHan-Wen Nienhuys <hanwen@lilypond.org>2007-01-19 20:05:18 +0000
committerHan-Wen Nienhuys <hanwen@lilypond.org>2007-01-19 20:05:18 +0000
commit19ab431ea1900cc66120637c0f4abec0636555b7 (patch)
treebe74d57d101ec8bff8a63fa2bf6d330db9ff0293 /doc/ref/api-options.texi
parent72f19c26469dc95fbb6bf42e9443ac4d3379fd69 (diff)
downloadguile-19ab431ea1900cc66120637c0f4abec0636555b7.tar.gz
* api-options.texi (Evaluator trap options): document
memoize-symbol-handler * api-evaluation.texi (Evaluator Behaviour): link to the Evaluator trap options node in trap-enable/trap-set! doco.
Diffstat (limited to 'doc/ref/api-options.texi')
-rw-r--r--doc/ref/api-options.texi15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/ref/api-options.texi b/doc/ref/api-options.texi
index 6dbc37062..493e2385d 100644
--- a/doc/ref/api-options.texi
+++ b/doc/ref/api-options.texi
@@ -554,6 +554,7 @@ Here is the list of evaluator trap options generated by typing
exit-frame no Trap when exiting eval or apply.
apply-frame no Trap when entering apply.
enter-frame no Trap when eval enters new frame.
+memoize-symbol no Trap when eval memoizes a symbol's value
traps yes Enable evaluator traps.
@end smallexample
@@ -612,6 +613,20 @@ way.
@var{retval} is the return value.
@end deffn
+
+@deffn memoize-symbol-handler key cont expression env
+Called when the evaluator memoizes the value of a procedure symbol
+
+@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
+
+
@node Debugger options
@subsubsection Debugger options