1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-05-19 03:00:25 +02:00

Favor "escape continuation" over "one-shot continuation" in manual

* doc/ref/api-control.texi (Prompt Primitives): Remove mention of
  one-shot continuations, as it's possible to invoke them multiple times
  if the continuation is re-entered through other means.
This commit is contained in:
Andy Wingo 2016-06-24 18:18:46 +02:00
parent 96f55b7f36
commit da0f1eadaa

View file

@ -581,10 +581,8 @@ important efficiency consideration to keep in mind.
One example where this optimization matters is @dfn{escape One example where this optimization matters is @dfn{escape
continuations}. Escape continuations are delimited continuations whose continuations}. Escape continuations are delimited continuations whose
only use is to make a non-local exit---i.e., to escape from the current only use is to make a non-local exit---i.e., to escape from the current
continuation. Such continuations are invoked only once, and for this continuation. A common use of escape continuations is when throwing an
reason they are sometimes called @dfn{one-shot continuations}. A common exception (@pxref{Exceptions}).
use of escape continuations is when throwing an exception
(@pxref{Exceptions}).
The constructs below are syntactic sugar atop prompts to simplify the The constructs below are syntactic sugar atop prompts to simplify the
use of escape continuations. use of escape continuations.