summaryrefslogtreecommitdiffstats
path: root/txr.1
diff options
context:
space:
mode:
Diffstat (limited to 'txr.1')
-rw-r--r--txr.110
1 files changed, 10 insertions, 0 deletions
diff --git a/txr.1 b/txr.1
index 71c8f5e8..cb239c93 100644
--- a/txr.1
+++ b/txr.1
@@ -27669,6 +27669,16 @@ if it is an ordinary value, it is returned; otherwise, if it is
a yield object, its stored value is returned and the state is updated
with the new yield object's continuation.
+The
+.code obtain
+macro registers a finalizer against the returned function.
+The finalizer invokes the function, passing it the symbol
+.codn sys:cont-poison ,
+thereby triggering unwinding in the most recently captured
+continuation. Thus, abandoned
+.code obtain
+blocks are subject to unwinding when they become garbage.
+
.TP* Notes:
These macros provide a simple abstraction for the use of continuations.