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

lib/dom/templates/html/interface/interface_Element.darttemplate

 // 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.
 
 // WARNING: Do not edit - generated code.
 
 interface ElementList extends List<Element> {
   // TODO(jacobr): add element batch manipulation methods.
   ElementList filter(bool f(Element element));
 
@@ skipping 19 matching lines @@
   // Relative to offsetParent
   ClientRect get client();
   ClientRect get offset();
   ClientRect get scroll();
   // In global coords
   ClientRect get bounding();
   // In global coords
   List<ClientRect> get clientRects();
 }
 
+$!COMMENT
 interface Element extends Node, NodeSelector default _$(ID)FactoryProvider {
 // TODO(jacobr): switch back to:
 // interface $ID$EXTENDS default _ElementImpl {
   Element.html(String html);
   Element.tag(String tag);
 
   AttributeMap get attributes();
   void set attributes(Map<String, String> value);
 
   /**
@@ skipping 30 matching lines @@
 
   /** @domName Window.getComputedStyle */
   Future<CSSStyleDeclaration> getComputedStyle(String pseudoElement);
 
   Element clone(bool deep);
 
   Element get parent();
 
 $!MEMBERS
 }