rust/library/core
bors b3d11f95cc Auto merge of #86598 - yoshuawuyts:poll-method-docs, r=JohnTitor
Add examples to the various methods of `core::task::Poll`

This improves the documentation of the various methods of [`core::task::Poll`](https://doc.rust-lang.org/std/task/enum.Poll.html). These currently have fairly simple docs with no examples. This PR changes these methods to be closer to `core::option::Option` and adds usage examples (and importantly: tests!) to `Poll`'s methods.

cc/ `@rust-lang/wg-async-foundations`

## Screenshots

<details>
<summary>View generated rustdoc page</summary>
<image src="https://user-images.githubusercontent.com/2467194/123286616-59ee9b00-d50e-11eb-9e02-40269070f904.png" alt="Poll in core::task"></details>
2021-07-04 20:00:57 +00:00
..
benches Use HTTPS links where possible 2021-06-23 16:26:46 -04:00
src Auto merge of #86598 - yoshuawuyts:poll-method-docs, r=JohnTitor 2021-07-04 20:00:57 +00:00
tests Auto merge of #86048 - nbdd0121:no_floating_point, r=Amanieu 2021-07-04 14:18:57 +00:00
Cargo.toml Auto merge of #82271 - Aaron1011:debug-refcell, r=m-ou-se 2021-03-23 04:49:47 +00:00