Fix doc nits

Many tiny changes to stdlib doc comments to make them consistent (for example
"Returns foo", rather than "Return foo", per RFC1574), adding missing periods, paragraph
breaks, backticks for monospace style, and other minor nits.

https://github.com/rust-lang/rfcs/blob/master/text/1574-more-api-documentation-conventions.md#appendix-a-full-conventions-text
This commit is contained in:
John Arundel 2024-07-15 12:26:30 +01:00
parent 83d67685ac
commit a19472a93e
146 changed files with 808 additions and 738 deletions

View file

@ -849,7 +849,7 @@ pub fn panicking() -> bool {
panicking::panicking()
}
/// Use [`sleep`].
/// Uses [`sleep`].
///
/// Puts the current thread to sleep for at least the specified amount of time.
///
@ -1120,7 +1120,7 @@ pub fn park() {
forget(guard);
}
/// Use [`park_timeout`].
/// Uses [`park_timeout`].
///
/// Blocks unless or until the current thread's token is made available or
/// the specified duration has been reached (may wake spuriously).