Make pub publish more user friendly:

utils/pub/path.dart

Index: utils/pub/path.dart
diff --git a/utils/pub/path.dart b/utils/pub/path.dart
index bcfbf7ce1b93b719db785343c4d675c869cda022..593396d0b83490de1be419a829c36ac0b09b715a 100644
--- a/utils/pub/path.dart
+++ b/utils/pub/path.dart
@@ -102,10 +102,13 @@ String join(String part1, [String part2, String part3, String part4,
 
 // TODO(nweiz): add a UNC example for Windows once issue 7323 is fixed.
 /// Splits [path] into its components using the current platform's [separator].
-/// Example:
 ///
 ///     path.split('path/to/foo'); // -> ['path', 'to', 'foo']
 ///
+/// The path will *not* be normalized before splitting.
+///
+///     path.split('path/../foo'); // -> ['path', '..', 'foo']
+///
 /// If [path] is absolute, the root directory will be the first element in the
 /// array. Example:
 ///
@@ -315,6 +318,10 @@ class Builder {
   ///
   ///     builder.split('path/to/foo'); // -> ['path', 'to', 'foo']
   ///
+  /// The path will *not* be normalized before splitting.
+  ///
+  ///     builder.split('path/../foo'); // -> ['path', '..', 'foo']
+  ///
   /// If [path] is absolute, the root directory will be the first element in the
   /// array. Example:
   ///