rust-lang / reference

The Rust Reference
https://doc.rust-lang.org/nightly/reference/
Apache License 2.0
1.23k stars 479 forks source link

Document async block types #1555

Open kpreid opened 2 months ago

kpreid commented 2 months ago

The section Types lists most kinds of types that can exist in a Rust program, but it does not list the types introduced by async {} and async fn. These types should be documented, since like closure types, they have nontrivial properties such as which traits they implement.

It's also unclear (at least to me) what they should be called, formally and generally — async block types? generated Future types? coroutine types? — and having that terminology nailed down would help teach Rust by avoiding inconsistent or ambiguous terminology.

@rustbot label A-async "New Content"

rustbot commented 2 months ago

Error: Parsing relabel command in comment failed: ...'el A-async' | error: a label delta at >| ' "New Cont'...

Please file an issue on GitHub at triagebot if there's a problem with this bot, or reach out on #t-infra on Zulip.