---

yaml
---
r: 153964
b: refs/heads/try2
c: a0238d5
h: refs/heads/master
v: v3

Author: nham

[refs]

@@ -5,7 +5,7 @@ refs/heads/snap-stage3: 78a7676898d9f80ab540c6df5d4c9ce35bb50463
 refs/heads/try: 519addf6277dbafccbb4159db4b710c37eaa2ec5
 refs/tags/release-0.1: 1f5c5126e96c79d22cb7862f75304136e204f105
 refs/heads/ndm: f3868061cd7988080c30d6d5bf352a5a5fe2460b
-refs/heads/try2: 9956aff18a1220bc4293bc2958cd2fa9b7bb04fd
+refs/heads/try2: a0238d54aac73491a7b691cc8c797b23de09439c
 refs/heads/dist-snap: ba4081a5a8573875fed17545846f6f6902c8ba8d
 refs/tags/release-0.2: c870d2dffb391e14efb05aa27898f1f6333a9596
 refs/tags/release-0.3: b5f0d0f648d9a6153664837026ba1be43d3e2503

branches/try2/src/libstd/path/mod.rs

@@ -165,7 +165,7 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
     /// # Example
     ///
     /// ```
-    /// let x: &[u8] = ['f' as u8, 'o' as u8, 'o' as u8, 0];
+    /// let x: &[u8] = b"foo\0";
     /// assert!(Path::new_opt(x).is_none());
     /// ```
     #[inline]
@@ -197,7 +197,7 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
     ///
     /// ```
     /// let p = Path::new("abc/def");
-    /// assert_eq!(p.as_vec(), &[97, 98, 99, 47, 100, 101, 102]);
+    /// assert_eq!(p.as_vec(), b"abc/def");
     /// ```
     fn as_vec<'a>(&'a self) -> &'a [u8];
 
@@ -207,7 +207,7 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
     ///
     /// ```
     /// let p = Path::new("abc/def");
-    /// assert_eq!(p.into_vec(), vec!(97, 98, 99, 47, 100, 101, 102));
+    /// assert_eq!(p.into_vec(), b"abc/def".to_vec());
     /// // attempting to use p now results in "error: use of moved value"
     /// ```
     fn into_vec(self) -> Vec<u8>;
@@ -245,7 +245,7 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
     ///
     /// ```
     /// let p = Path::new("abc/def/ghi");
-    /// assert_eq!(p.dirname(), &[97, 98, 99, 47, 100, 101, 102]);
+    /// assert_eq!(p.dirname(), b"abc/def");
     /// ```
     fn dirname<'a>(&'a self) -> &'a [u8];
 
@@ -271,7 +271,7 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
     ///
     /// ```
     /// let p = Path::new("abc/def/ghi");
-    /// assert_eq!(p.filename(), Some(&[103, 104, 105]));
+    /// assert_eq!(p.filename(), Some(b"ghi"));
     /// ```
     fn filename<'a>(&'a self) -> Option<&'a [u8]>;
 
@@ -297,7 +297,7 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
     ///
     /// ```
     /// let p = Path::new("/abc/def.txt");
-    /// assert_eq!(p.filestem(), Some(&[100, 101, 102]));
+    /// assert_eq!(p.filestem(), Some(b"def"));
     /// ```
     fn filestem<'a>(&'a self) -> Option<&'a [u8]> {
         match self.filename() {
@@ -336,7 +336,7 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
     ///
     /// ```
     /// let p = Path::new("abc/def.txt");
-    /// assert_eq!(p.extension(), Some(&[116, 120, 116]));
+    /// assert_eq!(p.extension(), Some(b"txt"));
     /// ```
     fn extension<'a>(&'a self) -> Option<&'a [u8]> {
         match self.filename() {
@@ -458,6 +458,13 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
     /// byte vector or string.
     /// See `set_extension` for details.
     ///
+    /// # Example
+    ///
+    /// ```
+    /// let mut p = Path::new("abc/def.txt");
+    /// assert!(p.with_extension("csv") == Path::new("abc/def.csv"));
+    /// ```
+    ///
     /// # Failure
     ///
     /// Fails the task if the extension contains a NUL.