Rollup merge of #32002 - srinivasreddy:vector_doc, r=Manishearth

Issue here : https://github.com/rust-lang/rust/issues/31991

1 files changed, 30 insertions, 0 deletions

diff --git a/src/doc/book/vectors.md b/src/doc/book/vectors.md
index f5a543d75b1..ceb6b3c003e 100644
--- a/src/doc/book/vectors.md
+++ b/src/doc/book/vectors.md
@@ -115,6 +115,36 @@ for i in v {
 }
 ```
 
+Note: You cannot use the vector again once you have iterated by taking ownership of the vector.
+You can iterate the vector multiple times by taking a reference to the vector whilst iterating. 
+For example, the following code does not compile.
+
+```rust,ignore
+let mut v = vec![1, 2, 3, 4, 5];
+
+for i in v {
+    println!("Take ownership of the vector and its element {}", i);
+}
+
+for i in v {
+    println!("Take ownership of the vector and its element {}", i);
+}
+```
+
+Whereas the following works perfectly,
+
+```rust
+let mut v = vec![1, 2, 3, 4, 5];
+
+for i in &v {
+    println!("This is a reference to {}", i);
+}
+
+for i in &v {
+    println!("This is a reference to {}", i);
+}
+```
+
 Vectors have many more useful methods, which you can read about in [their
 API documentation][vec].