Add a script to generate HTML and DOM docs with cross-links to one another.

client/html/release/htmlimpl.dart

 #library('htmlimpl');
 
 #import('dart:dom', prefix:'dom');
 #import('dart:html');
 // 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.
 
 // DO NOT EDIT
 // Auto-generated Dart HTML library.
@@ skipping 14147 matching lines @@
 
   DocumentEventsImplementation._wrap(_ptr) : super._wrap(_ptr);
 
   EventListenerList get readyStateChange() => _get('readystatechange');
 
   EventListenerList get selectionChange() => _get('selectionchange');
 
   EventListenerList get contentLoaded() => _get('DOMContentLoaded');
 }
 
+/** @domName Document, HTMLDocument */
 class DocumentWrappingImplementation extends ElementWrappingImplementation implements Document {
 
   final _documentPtr;
 
   DocumentWrappingImplementation._wrap(this._documentPtr, ptr) : super._wrap(ptr) {
     // We have to set the back ptr on the document as well as the documentElement
     // so that it is always simple to detect when an existing wrapper exists.
     _documentPtr.dartObjectLocalStorage = this;
   }
 
-  /** @domName HTMLDocument.activeElement */
+  /** @domName activeElement */
   Element get activeElement() => LevelDom.wrapElement(_documentPtr.activeElement);
 
   Node get parent() => null;
 
-  /** @domName Document.body */
+  /** @domName body */
   Element get body() => LevelDom.wrapElement(_documentPtr.body);
 
-  /** @domName Document.body */
+  /** @domName body */
   void set body(Element value) { _documentPtr.body = LevelDom.unwrap(value); }
 
-  /** @domName Document.charset */
+  /** @domName charset */
   String get charset() => _documentPtr.charset;
 
-  /** @domName Document.charset */
+  /** @domName charset */
   void set charset(String value) { _documentPtr.charset = value; }
 
-  /** @domName Document.cookie */
+  /** @domName cookie */
   String get cookie() => _documentPtr.cookie;
 
-  /** @domName Document.cookie */
+  /** @domName cookie */
   void set cookie(String value) { _documentPtr.cookie = value; }
 
-  /** @domName Document.defaultView */
+  /** @domName defaultView */
   Window get window() => LevelDom.wrapWindow(_documentPtr.defaultView);
 
-  /** @domName HTMLDocument.designMode */
+  /** @domName designMode */
   void set designMode(String value) { _documentPtr.designMode = value; }
 
-  /** @domName Document.domain */
+  /** @domName domain */
   String get domain() => _documentPtr.domain;
 
-  /** @domName Document.head */
+  /** @domName head */
   HeadElement get head() => LevelDom.wrapHeadElement(_documentPtr.head);
 
-  /** @domName Document.lastModified */
+  /** @domName lastModified */
   String get lastModified() => _documentPtr.lastModified;
 
-  /** @domName Document.readyState */
+  /** @domName readyState */
   String get readyState() => _documentPtr.readyState;
 
-  /** @domName Document.referrer */
+  /** @domName referrer */
   String get referrer() => _documentPtr.referrer;
 
-  /** @domName Document.styleSheets */
+  /** @domName styleSheets */
   StyleSheetList get styleSheets() => LevelDom.wrapStyleSheetList(_documentPtr.styleSheets);
 
-  /** @domName Document.title */
+  /** @domName title */
   String get title() => _documentPtr.title;
 
-  /** @domName Document.title */
+  /** @domName title */
   void set title(String value) { _documentPtr.title = value; }
 
-  /** @domName Document.webkitHidden */
+  /** @domName webkitHidden */
   bool get webkitHidden() => _documentPtr.webkitHidden;
 
-  /** @domName Document.webkitVisibilityState */
+  /** @domName webkitVisibilityState */
   String get webkitVisibilityState() => _documentPtr.webkitVisibilityState;
 
-  /** @domName Document.caretRangeFromPoint */
+  /** @domName caretRangeFromPoint */
   Future<Range> caretRangeFromPoint([int x = null, int y = null]) {
     return _createMeasurementFuture(
         () => LevelDom.wrapRange(_documentPtr.caretRangeFromPoint(x, y)),
         new Completer<Range>());
   }
 
-  /** @domName Document.createElement */
+  /** @domName createElement */
   Element createElement([String tagName = null]) {
     return LevelDom.wrapElement(_documentPtr.createElement(tagName));
   }
 
-  /** @domName Document.createEvent */
+  /** @domName createEvent */
   Event createEvent([String eventType = null]) {
     return LevelDom.wrapEvent(_documentPtr.createEvent(eventType));
   }
 
-  /** @domName Document.elementFromPoint */
+  /** @domName elementFromPoint */
   Future<Element> elementFromPoint([int x = null, int y = null]) {
     return _createMeasurementFuture(
         () => LevelDom.wrapElement(_documentPtr.elementFromPoint(x, y)),
         new Completer<Element>());
   }
 
-  /** @domName Document.execCommand */
+  /** @domName execCommand */
   bool execCommand([String command = null, bool userInterface = null, String value = null]) {
     return _documentPtr.execCommand(command, userInterface, value);
   }
 
-  /** @domName Document.getCSSCanvasContext */
+  /** @domName getCSSCanvasContext */
   CanvasRenderingContext getCSSCanvasContext(String contextId, String name,
                                              int width, int height) {
     return LevelDom.wrapCanvasRenderingContext(_documentPtr.getCSSCanvasContext(contextId, name, width, height));
   }
 
-  /** @domName Document.queryCommandEnabled */
+  /** @domName queryCommandEnabled */
   bool queryCommandEnabled([String command = null]) {
     return _documentPtr.queryCommandEnabled(command);
   }
 
-  /** @domName Document.queryCommandIndeterm */
+  /** @domName queryCommandIndeterm */
   bool queryCommandIndeterm([String command = null]) {
     return _documentPtr.queryCommandIndeterm(command);
   }
 
-  /** @domName Document.queryCommandState */
+  /** @domName queryCommandState */
   bool queryCommandState([String command = null]) {
     return _documentPtr.queryCommandState(command);
   }
 
-  /** @domName Document.queryCommandSupported */
+  /** @domName queryCommandSupported */
   bool queryCommandSupported([String command = null]) {
     return _documentPtr.queryCommandSupported(command);
   }
 
-  /** @domName Document.queryCommandValue */
+  /** @domName queryCommandValue */
   String queryCommandValue([String command = null]) {
     return _documentPtr.queryCommandValue(command);
   }
 
+  /** @domName HTMLHtmlElement.manifest */
   String get manifest() => _ptr.manifest;
 
+  /** @domName HTMLHtmlElement.manifest */
   void set manifest(String value) { _ptr.manifest = value; }
 
   DocumentEvents get on() {
     if (_on === null) {
       _on = new DocumentEventsImplementation._wrap(_ptr);
     }
     return _on;
   }
 }
 // Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
@@ skipping 338 matching lines @@
   bool containsValue(String value) {
     final attributes = _element.attributes;
     for (int i = 0, len = attributes.length; i < len; i++) {
       if(value == attributes.item(i).value) {
         return true;
       }
     }
     return false;
   }
 
-  /** @domName Element.hasAttribute */
   bool containsKey(String key) {
     return _element.hasAttribute(key);
   }
 
-  /** @domName Element.getAttribute */
   String operator [](String key) {
     return _element.getAttribute(key);
   }
 
-  /** @domName Element.setAttribute */
   void operator []=(String key, String value) {
     _element.setAttribute(key, value);
   }
 
   String putIfAbsent(String key, String ifAbsent()) {
     if (!containsKey(key)) {
       this[key] = ifAbsent();
     }
   }
 
-  /** @domName Element.removeAttribute */
   String remove(String key) {
     _element.removeAttribute(key);
   }
 
   void clear() {
     final attributes = _element.attributes;
     for (int i = attributes.length - 1; i >= 0; i--) {
       _element.removeAttribute(attributes.item(i).name);
     }
   }
@@ skipping 150 matching lines @@
 
   List<ClientRect> get clientRects() {
     final out = new List(_clientRects.length);
     for (num i = 0; i < _clientRects.length; i++) {
       out[i] = LevelDom.wrapClientRect(_clientRects.item(i));
     }
     return out;
   }
 }
 
+/** @domName Element, HTMLElement */
 class ElementWrappingImplementation extends NodeWrappingImplementation implements Element {
   
     static final _START_TAG_REGEXP = const RegExp('<(\\w+)');
     static final _CUSTOM_PARENT_TAG_MAP = const {
       'body' : 'html',
       'head' : 'html',
       'caption' : 'table',
       'td': 'tr',
       'tbody': 'table',
       'colgroup': 'table',
       'col' : 'colgroup',
       'tr' : 'tbody',
       'tbody' : 'table',
       'tfoot' : 'table',
       'thead' : 'table',
       'track' : 'audio',
     };
 
-   factory ElementWrappingImplementation.html(String html) {
+  /** @domName Document.createElement */
+  factory ElementWrappingImplementation.html(String html) {
     // TODO(jacobr): this method can be made more robust and performant.
     // 1) Cache the dummy parent elements required to use innerHTML rather than
     //    creating them every call.
     // 2) Verify that the html does not contain leading or trailing text nodes.
     // 3) Verify that the html does not contain both <head> and <body> tags.
     // 4) Detatch the created element from its dummy parent.
     String parentTag = 'div';
     String tag;
     final match = _START_TAG_REGEXP.firstMatch(html);
     if (match !== null) {
@@ skipping 10 matching lines @@
     } else if (parentTag == 'html' && temp.childElementCount == 2) {
       // Work around for edge case in WebKit and possibly other browsers where
       // both body and head elements are created even though the inner html
       // only contains a head or body element.
       return LevelDom.wrapElement(temp.children.item(tag == 'head' ? 0 : 1));
     } else {
       throw 'HTML had ${temp.childElementCount} top level elements but 1 expected';
     }
   }
 
+  /** @domName Document.createElement */
   factory ElementWrappingImplementation.tag(String tag) {
     return LevelDom.wrapElement(dom.document.createElement(tag));
   }
 
   ElementWrappingImplementation._wrap(ptr) : super._wrap(ptr);
 
   ElementAttributeMap _elementAttributeMap;
   ElementList _elements;
   _CssClassSet _cssClassSet;
   _DataAttributeMap _dataAttributes;
 
+  /**
+   * @domName Element.hasAttribute, Element.getAttribute, Element.setAttribute,
+   *   Element.removeAttribute
+   */
   Map<String, String> get attributes() {
     if (_elementAttributeMap === null) {
       _elementAttributeMap = new ElementAttributeMap._wrap(_ptr);
     }
     return _elementAttributeMap;
   }
 
   void set attributes(Map<String, String> value) {
     Map<String, String> attributes = this.attributes;
     attributes.clear();
     for (String key in value.getKeys()) {
       attributes[key] = value[key];
     }
   }
 
   void set elements(Collection<Element> value) {
     // Copy list first since we don't want liveness during iteration.
     List copy = new List.from(value);
     final elements = this.elements;
     elements.clear();
     elements.addAll(copy);
   }
 
+  /**
+   * @domName childElementCount, firstElementChild, lastElementChild,
+   *   children
+   */
   ElementList get elements() {
     if (_elements == null) {
       _elements = new _ChildrenElementList._wrap(_ptr);
     }
     return _elements;
   }
 
+  /** @domName className, classList */
   Set<String> get classes() {
     if (_cssClassSet === null) {
       _cssClassSet = new _CssClassSet(_ptr);
     }
     return _cssClassSet;
   }
 
   void set classes(Collection<String> value) {
     _CssClassSet classSet = classes;
     classSet.clear();
@@ skipping 82 matching lines @@
   }
 
   bool contains(Node element) {
     return _ptr.contains(LevelDom.unwrap(element));
   }
 
   void focus() {
     _ptr.focus();
   }
 
-  /** @domName HTMLElement.insertAdjacentElement */
   Element insertAdjacentElement([String where = null, Element element = null]) {
     return LevelDom.wrapElement(_ptr.insertAdjacentElement(where, LevelDom.unwrap(element)));
   }
 
-  /** @domName HTMLElement.insertAdjacentHTML */
   void insertAdjacentHTML([String position_OR_where = null, String text = null]) {
     _ptr.insertAdjacentHTML(position_OR_where, text);
   }
 
-  /** @domName HTMLElement.insertAdjacentText */
   void insertAdjacentText([String where = null, String text = null]) {
     _ptr.insertAdjacentText(where, text);
   }
 
   Element query(String selectors) {
     // TODO(jacobr): scope fix.
     return LevelDom.wrapElement(_ptr.querySelector(selectors));
   }
 
+  /**
+   * @domName querySelectorAll, getElementsByClassName, getElementsByTagName,
+   *   getElementsByTagNameNS
+   */
   ElementList queryAll(String selectors) {
     // TODO(jacobr): scope fix.
     return new FrozenElementList._wrap(_ptr.querySelectorAll(selectors));
   }
 
   void scrollByLines([int lines = null]) {
     _ptr.scrollByLines(lines);
   }
 
   void scrollByPages([int pages = null]) {
     _ptr.scrollByPages(pages);
   }
 
+  /** @domName scrollIntoView, scrollIntoViewIfNeeded */
   void scrollIntoView([bool centerIfNeeded = null]) {
     _ptr.scrollIntoViewIfNeeded(centerIfNeeded);
   }
 
   bool matchesSelector([String selectors = null]) {
     return _ptr.webkitMatchesSelector(selectors);
   }
 
   void set scrollLeft(int value) { _ptr.scrollLeft = value; }
  
   void set scrollTop(int value) { _ptr.scrollTop = value; }
 
-  /** @domName getClientRects */
+  /**
+   * @domName getClientRects, getBoundingClientRect, clientHeight, clientWidth,
+   * clientTop, clientLeft, offsetHeight, offsetWidth, offsetTop, offsetLeft,
+   * scrollHeight, scrollWidth, scrollTop, scrollLeft
+   */
   Future<ElementRect> get rect() {
     return _createMeasurementFuture(
         () => new ElementRectWrappingImplementation(_ptr),
         new Completer<ElementRect>());
   }
 
+  /** @domName Window.getComputedStyle */
   Future<CSSStyleDeclaration> get computedStyle() {
      // TODO(jacobr): last param should be null, see b/5045788
      return getComputedStyle('');
   }
 
   /** @domName Window.getComputedStyle */
   Future<CSSStyleDeclaration> getComputedStyle(String pseudoElement) {
     return _createMeasurementFuture(() =>
         LevelDom.wrapCSSStyleDeclaration(
             dom.window.getComputedStyle(_ptr, pseudoElement)),
@@ skipping 419 matching lines @@
 
   String get data() => _ptr.data;
 
   String get lastEventId() => _ptr.lastEventId;
 
   MessagePort get messagePort() => LevelDom.wrapMessagePort(_ptr.messagePort);
 
   String get origin() => _ptr.origin;
 
   Window get source() => LevelDom.wrapWindow(_ptr.source);
-
-  void initMessageEvent(String typeArg, bool canBubbleArg, bool cancelableArg, String dataArg, String originArg, String lastEventIdArg, Window sourceArg, MessagePort messagePort) {
-    _ptr.initMessageEvent(typeArg, canBubbleArg, cancelableArg, dataArg, originArg, lastEventIdArg, LevelDom.unwrap(sourceArg), LevelDom.unwrap(messagePort));
-    return;
-  }
 }
 // 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.
 
 class MessagePortWrappingImplementation extends EventTargetWrappingImplementation implements MessagePort {
   MessagePortWrappingImplementation._wrap(ptr) : super._wrap(ptr) {}
 }
 // 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
@@ skipping 1747 matching lines @@
     _ptr.setRequestHeader(header, value);
   }
 
   XMLHttpRequestEvents get on() {
     if (_on === null) {
       _on = new XMLHttpRequestEventsImplementation._wrap(_ptr);
     }
     return _on;
   }
 }