Fix HTTP links in URI docs.

lib/uri/uri.dart

Index: lib/uri/uri.dart
diff --git a/lib/uri/uri.dart b/lib/uri/uri.dart
index 38001228e1b80305c242beae40520bfcd0691023..a1856f7cfbf7f5c01e54d11ff810789ab05b0588 100644
--- a/lib/uri/uri.dart
+++ b/lib/uri/uri.dart
@@ -5,8 +5,9 @@
 #library('uri');
 
 /**
- * A parsed URI, inspired by:
- * http://closure-library.googlecode.com/svn/docs/class_goog_Uri.html
+ * A parsed URI, inspired by Closure's [URI][] class. Implements [RFC-3986][].
+ * [uri]: http://closure-library.googlecode.com/svn/docs/class_goog_Uri.html

[ahe, 2012/04/12 18:24:22]

I don't think this follows the conventions we follow in the rest of the
libraries:

http://chromegw.corp.google.com/viewvc/dash/attic/guide/dartguide.xml#Comment...
(sorry, this is an internal Google link, we should get this published).

[Bob Nystrom, 2012/04/16 22:04:23]

I didn't even remember that the old guide specified a way to include hyperlinks.
:(

Dartdoc doesn't support that (because I forgot about it). It does support the
three flavors of hyperlinks markdown supports of which this is one. I only found
a few places in our codebase where we have the old style comments (assuming my
grep-foo is strong enough). If you'd like, I can update those to use regular
markdown links too.

+ * [RFC-3986]: http://tools.ietf.org/html/rfc3986#section-4.3)
  */
 class Uri {
   final String scheme;
@@ -72,9 +73,7 @@ class Uri {
   static final _COMPONENT_FRAGMENT = 7;
 
   /**
-   * Determines whether a URI is absolute.
-   *
-   * See: http://tools.ietf.org/html/rfc3986#section-4.3
+   * Returns `true` if the URI is absolute.

[ahe, 2012/04/12 18:24:22]

[true] instead of `true`.

[Bob Nystrom, 2012/04/16 22:04:23]

[true] is for links to identifiers, but "true" is just a reserved word.
Backticks will be parsed as inline <code>, which is I think what we want here.
If I remember, I believe that's the convention the MSDN docs use, for example.

    */
   bool isAbsolute() {
     if ("" == scheme) return false;