Fix documentation of path.toUri().

R=nweiz@google.com

Review URL: https://codereview.chromium.org//20043004

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart/pkg/path@25366 260f80e4-7a28-3924-810f-c04153c831b5
diff --git a/lib/path.dart b/lib/path.dart
index 1845e09..cc0493c 100644
--- a/lib/path.dart
+++ b/lib/path.dart
@@ -289,9 +289,6 @@
 /// For POSIX and Windows styles, this will return a `file:` URI. For the URL
 /// style, this will just convert [path] to a [Uri].
 ///
-/// This will always convert relative paths to absolute ones before converting
-/// to a URI.
-///
 ///     // POSIX
 ///     path.toUri('/path/to/foo')
 ///       // -> Uri.parse('file:///path/to/foo')
@@ -303,6 +300,11 @@
 ///     // URL
 ///     path.toUri('http://dartlang.org/path/to/foo')
 ///       // -> Uri.parse('http://dartlang.org/path/to/foo')
+///
+/// If [path] is relative, a relative URI will be returned.
+///
+///     path.toUri('path/to/foo')
+///       // -> Uri.parse('path/to/foo')
 Uri toUri(String path) => _builder.toUri(path);
 
 /// Validates that there are no non-null arguments following a null one and