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

client/html/src/ElementWrappingImplementation.dart

Index: client/html/src/ElementWrappingImplementation.dart
diff --git a/client/html/src/ElementWrappingImplementation.dart b/client/html/src/ElementWrappingImplementation.dart
index b5e3a752cc0b4876a31cf8f186656c85c7cd598f..4987ba5d6a8297b7e428945c1c92839a1db5f1f7 100644
--- a/client/html/src/ElementWrappingImplementation.dart
+++ b/client/html/src/ElementWrappingImplementation.dart
@@ -292,17 +292,14 @@ class ElementAttributeMap implements Map<String, String> {
     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);
   }
@@ -313,7 +310,6 @@ class ElementAttributeMap implements Map<String, String> {
     }
   }
 
-  /** @domName Element.removeAttribute */
   String remove(String key) {
     _element.removeAttribute(key);
   }
@@ -484,6 +480,7 @@ class ElementRectWrappingImplementation implements ElementRect {
   }
 }
 
+/** @domName Element, HTMLElement */
 class ElementWrappingImplementation extends NodeWrappingImplementation implements Element {
   
     static final _START_TAG_REGEXP = const RegExp('<(\\w+)');
@@ -502,7 +499,8 @@ class ElementWrappingImplementation extends NodeWrappingImplementation implement
       '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.
@@ -533,6 +531,7 @@ class ElementWrappingImplementation extends NodeWrappingImplementation implement
     }
   }
 
+  /** @domName Document.createElement */
   factory ElementWrappingImplementation.tag(String tag) {
     return LevelDom.wrapElement(dom.document.createElement(tag));
   }
@@ -544,6 +543,10 @@ class ElementWrappingImplementation extends NodeWrappingImplementation implement
   _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);
@@ -567,6 +570,10 @@ class ElementWrappingImplementation extends NodeWrappingImplementation implement
     elements.addAll(copy);
   }
 
+  /**
+   * @domName childElementCount, firstElementChild, lastElementChild,
+   *   children

[Jacob, 2011/12/06 22:38:14]

and 
appendChild

[nweiz, 2011/12/07 19:26:56]

Done.

+   */
   ElementList get elements() {
     if (_elements == null) {
       _elements = new _ChildrenElementList._wrap(_ptr);
@@ -574,6 +581,7 @@ class ElementWrappingImplementation extends NodeWrappingImplementation implement
     return _elements;
   }
 
+  /** @domName className, classList */
   Set<String> get classes() {
     if (_cssClassSet === null) {
       _cssClassSet = new _CssClassSet(_ptr);
@@ -676,17 +684,14 @@ class ElementWrappingImplementation extends NodeWrappingImplementation implement
     _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);
   }
@@ -696,6 +701,10 @@ class ElementWrappingImplementation extends NodeWrappingImplementation implement
     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));
@@ -709,6 +718,7 @@ class ElementWrappingImplementation extends NodeWrappingImplementation implement
     _ptr.scrollByPages(pages);
   }
 
+  /** @domName scrollIntoView, scrollIntoViewIfNeeded */
   void scrollIntoView([bool centerIfNeeded = null]) {
     _ptr.scrollIntoViewIfNeeded(centerIfNeeded);
   }
@@ -721,13 +731,18 @@ class ElementWrappingImplementation extends NodeWrappingImplementation implement
  
   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('');