async-book icon indicating copy to clipboard operation
async-book copied to clipboard

Clarify `Future` expectations

Open kellytk opened this issue 4 years ago • 1 comments

From https://internals.rust-lang.org/t/future-and-its-assurance-of-completion/14542/11, originating with https://internals.rust-lang.org/t/future-and-its-assurance-of-completion/14542/10, the suggested change adds helpful information IMHO.

kellytk avatar Apr 27 '21 23:04 kellytk

is typically expected to complete

I feel this explanation is unclear. Future is often defined to complete (=will eventually return Poll::Ready), but it is not uncommon for Future to not be polled until it is complete (=dropped before complete). Seems you are talking about the former, but I feel the explanation that this PR adds could easily be misunderstood as the latter.

taiki-e avatar May 01 '21 11:05 taiki-e