Refactored swap_remove doc comment upon discussing with BurntSushi and steveklabnik

diff --git a/src/libcollections/vec.rs b/src/libcollections/vec.rs
index 44ac4f1cff5889569d741ff6e7dbdbaecae8e04d..8a3fa94d4c1ea06c790476654e2a41d46672bd24 100644 (file)
--- a/src/libcollections/vec.rs
+++ b/src/libcollections/vec.rs
@@ -678,8 +678,9 @@ pub unsafe fn set_len(&mut self, len: usize) {
         self.len = len;
     }
 
-    /// Removes an element from anywhere in the vector and returns it, replacing
-    /// it with the last element.
+    /// Removes an element from the vector and returns it.
+    /// 
+    /// The removed element is replaced by the last element of the vector.
     ///
     /// This does not preserve ordering, but is O(1).
     ///