package ecaml

block_on_async here f calls f (), and runs Async cycles until the result is determined, then returns the result.

This function cannot be called:

• during an Async job
• inside another call to block_on_async

An exception will be raised if these conditions are violated.

enqueue_foreground_block_on_async here f is like block_on_async here f, except that it does not run immediately, and it can be run from inside another block_on_async or an Async job. Async_ecaml will run f at some point, when no other block_on_async is running.

run_outside_async f is the idiomatic way to call functions f where f only wraps a single call into Elisp, and f would otherwise raise

"Called [block_on_async] in the middle of an Async job!"

.

f should do nothing but make the one call into elisp, unless you can show that the work done in OCaml is safe to run with pre-emptive multi-threading semantics.

run_outside_async f schedules f to run at some point in the future, outside of Async, i.e. not during an Async cycle and without holding the Async lock.

This is necessary so that Emacs will run timers and network handlers while waiting for f, and hence will request and run the Async cycles needed by f.