Fix ApiDoc to work with new dart:html code. Tweak dart:html generator to generate clearer @domName …

utils/apidoc/apidoc.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.
 
 /**
  * This generates the reference documentation for the core libraries that come
  * with dart. It is built on top of dartdoc, which is a general-purpose library
  * for generating docs from any Dart code. This library extends that to include
  * additional information and styling specific to our standard library.
  *
  * Usage:
  *
  *     $ dart apidoc.dart [--out=<output directory>]
  */
+
 #library('apidoc');
 
 #import('dart:io');
 #import('dart:json');
 #import('html_diff.dart');
+
 #import('../../frog/lang.dart');
 #import('../../frog/file_system_vm.dart');
 #import('../../frog/file_system.dart');
 #import('../../lib/dartdoc/dartdoc.dart', prefix: 'doc');
 
 HtmlDiff _diff;
 
 final GET_PREFIX = 'get:';
 
 void main() {
@@ skipping 191 matching lines @@
     super.docLibraryNavigationJson(library, libraries);
   }
 
   void docLibrary(Library library) {
     // TODO(rnystrom): Hackish. The IO libraries reference this but we don't
     // want it in the docs.
     if (library.name == 'dart:nativewrappers') return;
     super.docLibrary(library);
   }
 
+  /** Override definition from parent class to strip out annotation tags. */
+  String commentToHtml(String comment) {
+    return super.commentToHtml(
+        comment.replaceAll(const RegExp("@([a-zA-Z]+) ([^;]+)(?:;|\$)"), ''));
+  }
+
   String getTypeComment(Type type) {
     return _mergeDocs(
         includeMdnTypeComment(type),
         super.getTypeComment(type),
         getTypeDoc(type));
   }
 
   String getMethodComment(MethodMember method) {
     // TODO(rnystrom): Disabling cross-linking between individual members.
     // Now that we include MDN content for most members, it doesn't add much
@@ skipping 240 matching lines @@
       return
           '''
           <p class="correspond">This corresponds to $domTypesText in the
           ${a("dom.html", "dart:dom")} library.</p>
           ''';
     }
 
     return '';
   }
 }