Fix HTTP links in URI docs.

lib/uri/uri.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 #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;
   final String userInfo;
   final String domain;
   final int port;
   final String path;
   final String query;
   final String fragment;
 
@@ skipping 45 matching lines @@
 
   static final _COMPONENT_SCHEME = 1;
   static final _COMPONENT_USER_INFO = 2;
   static final _COMPONENT_DOMAIN = 3;
   static final _COMPONENT_PORT = 4;
   static final _COMPONENT_PATH = 5;
   static final _COMPONENT_QUERY_DATA = 6;
   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;
     if ("" != fragment) return false;
     return true;
 
     /* absolute-URI  = scheme ":" hier-part [ "?" query ]
      * hier-part   = "//" authority path-abempty
      *             / path-absolute
      *             / path-rootless
@@ skipping 118 matching lines @@
       appendSlash = true;
     } else if ("." == segment) {
       appendSlash = true;
     } else {
       output.add(segment);
     }
   }
   if (appendSlash) output.add("");
   return Strings.join(output, "/");
 }