diff --git a/src/libcollections/vec.rs b/src/libcollections/vec.rs
index e9f3651d63b8..8b2057161522 100644
--- a/src/libcollections/vec.rs
+++ b/src/libcollections/vec.rs
@@ -112,6 +112,13 @@ use super::range::RangeArgument;
 /// assert_eq!(vec, [1, 2, 3, 4]);
 /// ```
 ///
+/// It can also initialize each element of a `Vec<T>` with a given value:
+///
+/// ```
+/// let vec = vec![0; 5];
+/// assert_eq!(vec, [0, 0, 0, 0, 0]);
+/// ```
+///
 /// Use a `Vec<T>` as an efficient stack:
 ///
 /// ```