summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/api.texi17
1 files changed, 13 insertions, 4 deletions
diff --git a/doc/api.texi b/doc/api.texi
index 4c34cf4..c79af20 100644
--- a/doc/api.texi
+++ b/doc/api.texi
@@ -1934,10 +1934,6 @@ procedure @var{handler}.
Wait @var{duration} before resuming the current script.
@end deffn
-@deffn {Procedure} channel-get @var{channel}
-Wait for a message from @var{channel}.
-@end deffn
-
@deffn {Syntax} forever @var{body} @dots{}
Evaluate @var{body} in an endless loop.
@end deffn
@@ -2014,3 +2010,16 @@ until a value is available.
Send @var{data} to @var{channel}. The current script suspends until
another script is available to retrieve the value.
@end deffn
+
+A low-level API also exists for using channels outside of a script via
+callback procedures:
+
+@deffn {Procedure} channel-get! @var{channel} @var{proc}
+Asynchronously retrieve a value from @var{channel} and call @var{proc}
+with that value.
+@end deffn
+
+@deffn {Procedure} channel-put! @var{channel} @var{data} [@var{thunk}]
+Asynchronously send @var{data} to @var{channel} and call @var{thunk}
+after it has been received.
+@end deffn