---

yaml
---
r: 225233
b: refs/heads/stable
c: e9005fb
h: refs/heads/master
i:
  225231: d0c072b
v: v3

Author: bors

[refs]

@@ -29,6 +29,6 @@ refs/heads/tmp: e5d90d98402475b6e154ce216f9efcb80da1a747
 refs/tags/1.0.0-alpha.2: 4c705f6bc559886632d3871b04f58aab093bfa2f
 refs/tags/homu-tmp: 1fe32ca12c51afcd761d9962f51a74ff0d07a591
 refs/tags/1.0.0-beta: 8cbb92b53468ee2b0c2d3eeb8567005953d40828
-refs/heads/stable: c7f92018accf8fd27fdac5acbe7fe3506c338ed1
+refs/heads/stable: e9005fb43e57cdd619dc8b0030a81e3a3d76262b
 refs/tags/1.0.0: 55bd4f8ff2b323f317ae89e254ce87162d52a375
 refs/tags/1.1.0: bc3c16f09287e5545c1d3f76b7abd54f2eca868b

branches/stable/src/libcore/iter.rs

@@ -1009,8 +1009,19 @@ pub trait Iterator {
         (ts, us)
     }
 
-    /// Creates an iterator that clones the elements it yields. Useful for
-    /// converting an Iterator<&T> to an Iterator<T>.
+    /// Creates an iterator that clones the elements it yields.
+    ///
+    /// This is useful for converting an Iterator<&T> to an Iterator<T>,
+    /// so it's a more convenient form of `map(|&x| x)`.
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// let a = [0, 1, 2];
+    /// let v_cloned: Vec<_> = a.iter().cloned().collect();
+    /// let v_map: Vec<_> = a.iter().map(|&x| x).collect();
+    /// assert_eq!(v_cloned, v_map);
+    /// ```
     #[stable(feature = "rust1", since = "1.0.0")]
     fn cloned<'a, T: 'a>(self) -> Cloned<Self>
         where Self: Sized + Iterator<Item=&'a T>, T: Clone
@@ -1057,7 +1068,7 @@ pub trait Iterator {
     /// # #![feature(core)]
     ///
     /// let a = [1, 2, 3, 4, 5];
-    /// let mut it = a.iter().cloned();
+    /// let it = a.iter();
     /// assert_eq!(it.sum::<i32>(), 15);
     /// ```
     #[unstable(feature="core")]

branches/stable/src/libstd/path.rs

@@ -258,7 +258,7 @@ mod platform {
 /// Path prefixes (Windows only).
 ///
 /// Windows uses a variety of path styles, including references to drive
-/// volumes (like `C:`), network shared (like `\\server\share`) and
+/// volumes (like `C:`), network shared folders (like `\\server\share`) and
 /// others. In addition, some path prefixes are "verbatim", in which case
 /// `/` is *not* treated as a separator and essentially no normalization is
 /// performed.
@@ -312,14 +312,14 @@ impl<'a> Prefix<'a> {
 
     }
 
-    /// Determines if the prefix is verbatim, i.e. begins `\\?\`.
+    /// Determines if the prefix is verbatim, i.e. begins with `\\?\`.
     #[inline]
     #[stable(feature = "rust1", since = "1.0.0")]
     pub fn is_verbatim(&self) -> bool {
         use self::Prefix::*;
         match *self {
             Verbatim(_) | VerbatimDisk(_) | VerbatimUNC(_, _) => true,
-            _ => false
+            _ => false,
         }
     }