---

yaml
---
r: 12751
b: refs/heads/master
c: 1db88e7
h: refs/heads/master
i:
  12749: ca69084
  12747: c0a24c0
  12743: ef2fab9
  12735: e7a2b7f
v: v3

Author: brson

[refs]

@@ -1,5 +1,5 @@
 ---
-refs/heads/master: 8a9df5aa38f63c9864dc560baadec95575188997
+refs/heads/master: 1db88e793756f691dd5b186b470117104a659883
 refs/heads/snap-stage1: e33de59e47c5076a89eadeb38f4934f58a3618a6
 refs/heads/snap-stage3: 4a81779abd786ff22d71434c6d9a5917ea4cdfff
 refs/heads/try: 2898dcc5d97da9427ac367542382b6239d9c0bbf

trunk/src/libcore/path.rs

@@ -200,9 +200,17 @@ fn splitext(p: path) -> (str, str) {
 }
 
 #[doc = "
-Removes extra '.' and '..' entries from paths
+Collapses redundant path separators.
 
 Does not follow symbolic links.
+
+# Examples
+
+* '/a/../b' becomes '/b'
+* 'a/./b/' becomes 'a/b/'
+* 'a/b/../../../' becomes '..'
+* '/a/b/c/../d/./../../e/' becomes '/a/e/'
+
 "]
 fn normalize(p: path) -> path {
     let s = split(p);