The support for asynchronous results was broken in several ways.

Also added some initial documentation.