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 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. run_outside_async returns a deferred that is filled with the result of f. Use run_outside_async to wrap blocking Elisp functions, e.g. read-from-minibuffer. For such functions, Emacs, while waiting, will run timers and network handlers, and hence will run Async cycles. Because run_outside_async runs f outside of a Async, Emacs will be able to run cycles as needed. Also, because run_outside_async releases the Async lock, the Async scheduler thread will be able to run and request cycles.