Skip to content

Commit

Permalink
avoid acronyms when we don't really need them
Browse files Browse the repository at this point in the history
  • Loading branch information
RalfJung committed Nov 3, 2023
1 parent 57f570b commit 3dc7805
Showing 1 changed file with 8 additions and 9 deletions.
17 changes: 8 additions & 9 deletions library/core/src/primitive_docs.rs
Original file line number Diff line number Diff line change
Expand Up @@ -308,10 +308,10 @@ mod prim_never {}
/// let _ = unsafe { char::from_u32_unchecked(0x110000) };
/// ```
///
/// USVs are also the exact set of values that may be encoded in UTF-8. Because `char` values are
/// USVs and functions may assume [incoming `str` values are valid
/// UTF-8](primitive.str.html#invariant), it is safe to store any `char` in a `str` or read any
/// character from a `str` as a `char`.
/// Unicode scalar values are also the exact set of values that may be encoded in UTF-8. Because
/// `char` values are Unicode scalar values and functions may assume [incoming `str` values are
/// valid UTF-8](primitive.str.html#invariant), it is safe to store any `char` in a `str` or read
/// any character from a `str` as a `char`.
///
/// The gap in valid `char` values is understood by the compiler, so in the
/// below example the two ranges are understood to cover the whole range of
Expand All @@ -325,11 +325,10 @@ mod prim_never {}
/// };
/// ```
///
/// All USVs are valid `char` values, but not all of them represent a real
/// character. Many USVs are not currently assigned to a character, but may be
/// in the future ("reserved"); some will never be a character
/// ("noncharacters"); and some may be given different meanings by different
/// users ("private use").
/// All Unicode scalar values are valid `char` values, but not all of them represent a real
/// character. Many Unicode scalar values are not currently assigned to a character, but may be in
/// the future ("reserved"); some will never be a character ("noncharacters"); and some may be given
/// different meanings by different users ("private use").
///
/// [Unicode code point]: https://www.unicode.org/glossary/#code_point
/// [Unicode scalar value]: https://www.unicode.org/glossary/#unicode_scalar_value
Expand Down

0 comments on commit 3dc7805

Please sign in to comment.