anchor.diff:    ///
     /// Note that decoding a full URI might change its meaning as some of
     /// the decoded characters could be reserved characters. In most
  -  /// cases an encoded URI should be parsed into components using
  +  /// cases, an encoded URI should be parsed into components using
     /// [Uri.parse] before decoding the separate components.
  +  ///
  +  /// Example:
  +  /// ```dart
  +  /// final decoded =
  +  ///     Uri.decodeFull('https://example.com/api/query?search=%20dart%20is');
  +  /// print(decoded); // https://example.com/api/query?search= dart is
  +  /// ```
     static String decodeFull(String uri) {
       return _Uri._uriDecode(uri, 0, uri.length, utf8, false);
     }
   
     /// Splits the [query] into a map according to the rules
     /// specified for FORM post in the [HTML 4.01 specification section
  -  /// 17.13.4](http://www.w3.org/TR/REC-html40/interact/forms.html#h-17.13.4 "HTML 4.01 section 17.13.4").
  +  /// 17.13.4](https://www.w3.org/TR/REC-html40/interact/forms.html#h-17.13.4
  +  /// "HTML 4.01 section 17.13.4").
     ///
     /// Each key and value in the returned map has been decoded. If the [query]
  -  /// is the empty string an empty map is returned.
  +  /// is the empty string, an empty map is returned.
     ///
     /// Keys in the query string that have no value are mapped to the
     /// empty string.
     ///
  -  /// Each query component will be decoded using [encoding]. The default encoding
  -  /// is UTF-8.
  +  /// Each query component will be decoded using [encoding]. The default
  +  /// encoding is UTF-8.
  +  ///
  +  /// Example:
  +  /// ```dart import:convert
  +  /// final queryStringMap =
  +  ///     Uri.splitQueryString('limit=10&max=100&search=Dart%20is%20fun');
  +  /// print(jsonEncode(queryStringMap));
  +  /// // {"limit":"10","max":"100","search":"Dart is fun"}
  +  ///
  +  /// ```
     static Map<String, String> splitQueryString(String query,
         {Encoding encoding = utf8}) {
       return query.split("&").fold({}, (map, element) {
  
positive.code:   ///                               // cannot contain colon on Windows.
    /// Uri.parse("file://server/share/file");  // \\server\share\file
    /// ```
    /// If the URI is not a file URI calling this throws
    /// [UnsupportedError].
    ///
    /// If the URI cannot be converted to a file path calling this throws
    /// [UnsupportedError].
    // TODO(lrn): Deprecate and move functionality to File class or similar.
    // The core libraries should not worry about the platform.
  
negative.code:   ///
    /// The path is the actual substring of the URI representing the path,
    /// and it is encoded where necessary. To get direct access to the decoded
    /// path, use [pathSegments].
    ///
    /// The path value is the empty string if there is no path component.
    String get path;
  