Fix documentation for `slice()`

Fixes https://github.com/mozilla/rust/issues/14577

diff --git a/src/libcollections/vec.rs b/src/libcollections/vec.rs
index 1f2d176ab9b22098a74eefb6d74a1cbdc286bd05..aa80a131811c2277e217611f33ef6d049bfc1024 100644 (file)
--- a/src/libcollections/vec.rs
+++ b/src/libcollections/vec.rs
@@ -782,11 +782,11 @@ pub fn sort_by(&mut self, compare: |&T, &T| -> Ordering) {
         self.as_mut_slice().sort_by(compare)
     }
 
-    /// Returns a slice of `self` between `start` and `end`.
+    /// Returns a slice of self spanning the interval [`start`, `end`).
     ///
     /// # Failure
     ///
-    /// Fails when `start` or `end` point outside the bounds of `self`, or when
+    /// Fails when the slice (or part of it) is outside the bounds of self, or when
     /// `start` > `end`.
     ///
     /// # Example

diff --git a/src/libcore/slice.rs b/src/libcore/slice.rs
index 6312d9115effbc85a9863da63039ad77bb9c05b3..0257911e8c0860b68b5a3db284991f731e109201 100644 (file)
--- a/src/libcore/slice.rs
+++ b/src/libcore/slice.rs
@@ -366,9 +366,9 @@ fn len(&self) -> uint {
 /// Extension methods for vectors
 pub trait ImmutableVector<'a, T> {
     /**
-     * Returns a slice of self between `start` and `end`.
+     * Returns a slice of self spanning the interval [`start`, `end`).
      *
-     * Fails when `start` or `end` point outside the bounds of self,
+     * Fails when the slice (or part of it) is outside the bounds of self,
      * or when `start` > `end`.
      */
     fn slice(&self, start: uint, end: uint) -> &'a [T];