Fix Path.relativeTo in special case where base is a substring of this.

sdk/lib/_internal/dartdoc/lib/dartdoc.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.
 
 /**
  * To generate docs for a library, run this script with the path to an
  * entrypoint .dart file, like:
  *
  *     $ dart dartdoc.dart foo.dart
  *
@@ skipping 1818 matching lines @@
     write("CACHE MANIFEST\n\n");
     write("# VERSION: ${new Date.now()}\n\n");
     write("NETWORK:\n*\n\n");
     write("CACHE:\n");
     var toCache = new Directory.fromPath(outputDir);
     var toCacheLister = toCache.list(recursive: true);
     toCacheLister.onFile = (filename) {
       if (filename.endsWith('appcache.manifest')) {
         return;
       }
-      // TODO(johnniwinther): If [outputDir] has trailing slashes, [filename]
-      // contains double (back)slashes for files in the immediate [toCache]
-      // directory. These are not handled by [relativeTo] thus
-      // wrongfully producing the path `/foo.html` for a file `foo.html` in
-      // [toCache].
-      //
-      // This can be handled in two ways. 1) By ensuring that
-      // [Directory.fromPath] does not receive a path with a trailing slash, or
-      // better, by making [Directory.fromPath] handle such trailing slashes.
-      // 2) By ensuring that [filePath] does not have double slashes before
-      // calling [relativeTo], or better, by making [relativeTo] handle double
-      // slashes correctly.
-      Path filePath = new Path(filename).canonicalize();
-      Path relativeFilePath = filePath.relativeTo(outputDir);
+      Path relativeFilePath = new Path(filename).relativeTo(outputDir);

[Bill Hesse, 2013/01/16 15:30:25]

Both the issues identified here have been fixed, so .canonicalize is no longer
needed as a workaround.

       write("$relativeFilePath\n");
     };
     toCacheLister.onDone = (done) => endFile();
   }
 
   /**
    * Returns [:true:] if [type] should be regarded as an exception.
    */
   bool isException(TypeMirror type) {
     return type.simpleName.endsWith('Exception') ||
@@ skipping 42 matching lines @@
   final ClassMirror inheritedFrom;
 
   DocComment(this.text, [this.inheritedFrom = null]) {
     assert(text != null && !text.trim().isEmpty);
   }
 
   String get html => md.markdownToHtml(text);
 
   String toString() => text;
 }