AsyncContext::wait() is not actually waiting

[gdesmott]

AsyncContext::wait() is documented as :

Spawns a future into the context, waiting for it to resolve.

But according to my tests wait() is actually not blocking and return right away, instead of waiting for the future to be done.

This is pretty confusing, it would be good to clarify its exact behavior in the documentation.

[Sytten]

AFAIK it means that the actor will wait on that future before making anymore progress (like reading new messages or polling children futures).

[gdesmott]

Indeed, that seems to match was I observed and my understanding of the code.

I think it's worth to make the documentation clearer about the exact semantic of this API as I spent quite some time figuring it out.