docs: improve doc of some methods w/ ranges

Author: tkr-sh

library/alloc/src/collections/vec_deque/mod.rs

@@ -1486,8 +1486,8 @@ impl<T, A: Allocator> VecDeque<T, A> {
  ///
  /// # Panics
  ///
- /// Panics if the starting point is greater than the end point or if
- /// the end point is greater than the length of the deque.
+ /// Panics if the range has `start_bound > end_bound`, or, if the range is
+ /// bounded on either end and past the length of the deque.
  ///
  /// # Examples
  ///
@@ -1522,8 +1522,8 @@ impl<T, A: Allocator> VecDeque<T, A> {
  ///
  /// # Panics
  ///
- /// Panics if the starting point is greater than the end point or if
- /// the end point is greater than the length of the deque.
+ /// Panics if the range has `start_bound > end_bound`, or, if the range is
+ /// bounded on either end and past the length of the deque.
  ///
  /// # Examples
  ///
@@ -1568,8 +1568,8 @@ impl<T, A: Allocator> VecDeque<T, A> {
  ///
  /// # Panics
  ///
- /// Panics if the starting point is greater than the end point or if
- /// the end point is greater than the length of the deque.
+ /// Panics if the range has `start_bound > end_bound`, or, if the range is
+ /// bounded on either end and past the length of the deque.
  ///
  /// # Leaking
  ///

library/alloc/src/string.rs

@@ -1117,8 +1117,8 @@ impl String {
  ///
  /// # Panics
  ///
- /// Panics if the starting point or end point do not lie on a [`char`]
- /// boundary, or if they're out of bounds.
+ /// Panics if the range has `start_bound > end_bound`, or, if the range is
+ /// bounded on either end and does not lie on a [`char`] boundary.
  ///
  /// # Examples
  ///
@@ -1939,8 +1939,8 @@ impl String {
  ///
  /// # Panics
  ///
- /// Panics if the starting point or end point do not lie on a [`char`]
- /// boundary, or if they're out of bounds.
+ /// Panics if the range has `start_bound > end_bound`, or, if the range is
+ /// bounded on either end and does not lie on a [`char`] boundary.
  ///
  /// # Leaking
  ///
@@ -2050,8 +2050,8 @@ impl String {
  ///
  /// # Panics
  ///
- /// Panics if the starting point or end point do not lie on a [`char`]
- /// boundary, or if they're out of bounds.
+ /// Panics if the range has `start_bound > end_bound`, or, if the range is
+ /// bounded on either end and does not lie on a [`char`] boundary.
  ///
  /// # Examples
  ///

library/alloc/src/vec/mod.rs

@@ -2746,8 +2746,8 @@ impl<T, A: Allocator> Vec<T, A> {
  ///
  /// # Panics
  ///
- /// Panics if the starting point is greater than the end point or if
- /// the end point is greater than the length of the vector.
+ /// Panics if the range has `start_bound > end_bound`, or, if the range is
+ /// bounded on either end and past the length of the vector.
  ///
  /// # Leaking
  ///
@@ -3810,8 +3810,8 @@ impl<T, A: Allocator> Vec<T, A> {
  ///
  /// # Panics
  ///
- /// Panics if the starting point is greater than the end point or if
- /// the end point is greater than the length of the vector.
+ /// Panics if the range has `start_bound > end_bound`, or, if the range is
+ /// bounded on either end and past the length of the vector.
  ///
  /// # Examples
  ///