X-Git-Url: https://git.lizzy.rs/?a=blobdiff_plain;f=src%2Fliballoc%2Fvec.rs;h=2f56898f4e9b66e43823aa765140932a0e082028;hb=654c180d05fedc8a9a3c793cfc747ad542d3a4f2;hp=5db96a504a6a69a1a72c1181464d92a5b7f40e12;hpb=33f8ce287a62d8c76c7cea11c5cf67f53d5b8f40;p=rust.git

diff --git a/src/liballoc/vec.rs b/src/liballoc/vec.rs
index 5db96a504a6..2f56898f4e9 100644
--- a/src/liballoc/vec.rs
+++ b/src/liballoc/vec.rs
@@ -1274,11 +1274,10 @@ unsafe fn append_elements(&mut self, other: *const [T]) {
     /// Creates a draining iterator that removes the specified range in the vector
     /// and yields the removed items.
     ///
-    /// Note 1: The element range is removed even if the iterator is only
-    /// partially consumed or not consumed at all.
-    ///
-    /// Note 2: It is unspecified how many elements are removed from the vector
-    /// if the `Drain` value is leaked.
+    /// When the iterator **is** dropped, all elements in the range are removed
+    /// from the vector, even if the iterator was not fully consumed. If the
+    /// iterator **is not** dropped (with [`mem::forget`] for example), it is
+    /// unspecified how many elements are removed.
     ///
     /// # Panics
     ///