Add a mode to dartdoc to generate the navigation on the client.

utils/apidoc/html_diff.dart

 // Copyright (c) 2011, 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.
 
 /**
  * A script to assist in documenting the difference between the dart:html API
  * and the old DOM API.
  */
 #library('html_diff');
 
+#import('dart:coreimpl');
 #import('../../frog/lang.dart');
 #import('../../frog/file_system_node.dart');
 #import('../../frog/file_system.dart');
 #import('../dartdoc/dartdoc.dart');
 
-void main() {
-  var files = new NodeFileSystem();
-  parseOptions('../../frog', [] /* args */, files);
-  initializeWorld(files);
-  initializeDartDoc();
-  HtmlDiff.initialize();
-
-  var diff = new HtmlDiff();
-  diff.run();
-
-  diff.domToHtml.forEach((domMember, htmlMembers) {
-    for (var htmlMember in htmlMembers) {
-      if (diff.sameName(domMember, htmlMember)) continue;
-      var htmlTypeName = htmlMember.declaringType.name;
-      var htmlName = '$htmlTypeName.${htmlMember.name}';
-      if (htmlMember.isConstructor || htmlMember.isFactory) {
-        final separator = htmlMember.constructorName == '' ? '' : '.';
-        htmlName = 'new $htmlTypeName$separator${htmlMember.constructorName}';
-      }
-      print('${domMember.declaringType.name}.${domMember.name} -> ${htmlName}');
-    }
-  });
-
-  for (var type in diff.dom.types.getValues()) {
-    if (type.name == null) continue;
-    if (type.definition is FunctionTypeDefinition) continue;
-    for (var member in type.members.getValues()) {
-      if (!member.isPrivate && member.name != 'typeName' &&
-          !diff.domToHtml.containsKey(member) &&
-          (member is MethodMember || member is PropertyMember)) {
-        print('No dart:html wrapper for ${type.name}.${member.name}');
-      }
-    }
-  }
-}
-
 /**
  * A class for computing a many-to-many mapping between the types and members in
  * `dart:dom` and `dart:html`. This mapping is based on two indicators:
  *
  *   1. Auto-detected wrappers. Most `dart:html` types correspond
  *      straightforwardly to a single `dart:dom` type, and have the same name.
  *      In addition, most `dart:htmlimpl` methods just call a single `dart:dom`
  *      method. This class detects these simple correspondences automatically.
  *
  *   2. Manual annotations. When it's not clear which `dart:dom` items a given
@@ skipping 366 matching lines @@
   Map<String, String> _getTags(String comment) {
     if (comment == null) return const <String>{};
     final re = new RegExp("@([a-zA-Z]+) ([^;]+)(?:;|\$)");
     final tags = <String>{};
     for (var m in re.allMatches(comment.trim())) {
       tags[m[1]] = m[2];
     }
     return tags;
   }
 }