Add back @domName annotations to dart:html

lib/html/frog/html_frog.dart

 #library('html');
 
 // 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.
 
 // DO NOT EDIT
 // Auto-generated dart:html library.
 
 
@@ skipping 16796 matching lines @@
 // 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.
 
 // WARNING: Do not edit - generated code.
 
 interface AbstractWorker extends EventTarget {
 
   AbstractWorkerEvents get on();
 
+  /** @domName addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]);
 
+  /** @domName dispatchEvent */
   bool $dom_dispatchEvent(Event evt);
 
+  /** @domName removeEventListener */
   void $dom_removeEventListener(String type, EventListener listener, [bool useCapture]);
 }
 
 interface AbstractWorkerEvents extends Events {
 
   EventListenerList get error();
 }
 // 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.
@@ skipping 3491 matching lines @@
   static final int OBSOLETE = 5;
 
   static final int UNCACHED = 0;
 
   static final int UPDATEREADY = 4;
 
   final int status;
 
   void abort();
 
+  /** @domName addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]);
 
+  /** @domName dispatchEvent */
   bool $dom_dispatchEvent(Event evt);
 
+  /** @domName removeEventListener */
   void $dom_removeEventListener(String type, EventListener listener, [bool useCapture]);
 
   void swapCache();
 
   void update();
 }
 
 interface DOMApplicationCacheEvents extends Events {
 
   EventListenerList get cached();
@@ skipping 623 matching lines @@
   DocumentEvents get on();
 
   final Element activeElement;
 
   Element body;
 
   String charset;
 
   String cookie;
 
+  /** @domName defaultView */
   final Window window;
 
   final Element documentElement;
 
   final String domain;
 
   final HeadElement head;
 
   final String lastModified;
 
@@ skipping 22 matching lines @@
   final bool webkitIsFullScreen;
 
   final String webkitVisibilityState;
 
   Range caretRangeFromPoint(int x, int y);
 
   CDATASection createCDATASection(String data);
 
   DocumentFragment createDocumentFragment();
 
+  /** @domName createElement */
   Element $dom_createElement(String tagName);
 
+  /** @domName createElementNS */
   Element $dom_createElementNS(String namespaceURI, String qualifiedName);
 
+  /** @domName createEvent */
   Event $dom_createEvent(String eventType);
 
   Range createRange();
 
+  /** @domName createTextNode */
   Text $dom_createTextNode(String data);
 
   Touch createTouch(Window window, EventTarget target, int identifier, int pageX, int pageY, int screenX, int screenY, int webkitRadiusX, int webkitRadiusY, num webkitRotationAngle, num webkitForce);
 
+  /** @domName createTouchList */
   TouchList $dom_createTouchList();
 
   Element elementFromPoint(int x, int y);
 
   bool execCommand(String command, bool userInterface, String value);
 
   CanvasRenderingContext getCSSCanvasContext(String contextId, String name, int width, int height);
 
+  /** @domName getElementById */
   Element $dom_getElementById(String elementId);
 
+  /** @domName getElementsByClassName */
   NodeList $dom_getElementsByClassName(String tagname);
 
+  /** @domName getElementsByName */
   NodeList $dom_getElementsByName(String elementName);
 
+  /** @domName getElementsByTagName */
   NodeList $dom_getElementsByTagName(String tagname);
 
   bool queryCommandEnabled(String command);
 
   bool queryCommandIndeterm(String command);
 
   bool queryCommandState(String command);
 
   bool queryCommandSupported(String command);
 
   String queryCommandValue(String command);
 
+  /** @domName querySelector */
   Element query(String selectors);
 
+  /** @domName querySelectorAll */
   NodeList $dom_querySelectorAll(String selectors);
 
   void webkitCancelFullScreen();
 
   void webkitExitFullscreen();
 
   WebKitNamedFlow webkitGetFlowByName(String name);
 
 }
 
@@ skipping 107 matching lines @@
   // /** WARNING: Currently this doesn't work on Dartium (issue 649). */
   // DocumentFragment.xml(String xml);
 
   DocumentFragment.svg(String svg);
 
   DocumentFragment clone(bool deep);
 
 
   ElementEvents get on();
 
+  /** @domName querySelector */
   Element query(String selectors);
 
+  /** @domName querySelectorAll */
   NodeList $dom_querySelectorAll(String selectors);
 
 }
 // 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.
 
 // WARNING: Do not edit - generated code.
 
 interface DocumentType extends Node {
@@ skipping 123 matching lines @@
 
   Element clone(bool deep);
 
   Element get parent();
 
 
   ElementEvents get on();
 
   static final int ALLOW_KEYBOARD_INPUT = 1;
 
+  /** @domName childElementCount */
   final int $dom_childElementCount;
 
+  /** @domName children */
   final HTMLCollection $dom_children;
 
+  /** @domName className */
   String $dom_className;
 
+  /** @domName clientHeight */
   final int $dom_clientHeight;
 
+  /** @domName clientLeft */
   final int $dom_clientLeft;
 
+  /** @domName clientTop */
   final int $dom_clientTop;
 
+  /** @domName clientWidth */
   final int $dom_clientWidth;
 
   String contentEditable;
 
   String dir;
 
   bool draggable;
 
+  /** @domName firstElementChild */
   final Element $dom_firstElementChild;
 
   bool hidden;
 
   String id;
 
   String innerHTML;
 
   final bool isContentEditable;
 
   String lang;
 
+  /** @domName lastElementChild */
   final Element $dom_lastElementChild;
 
   final Element nextElementSibling;
 
+  /** @domName offsetHeight */
   final int $dom_offsetHeight;
 
+  /** @domName offsetLeft */
   final int $dom_offsetLeft;
 
   final Element offsetParent;
 
+  /** @domName offsetTop */
   final int $dom_offsetTop;
 
+  /** @domName offsetWidth */
   final int $dom_offsetWidth;
 
   final String outerHTML;
 
   final Element previousElementSibling;
 
+  /** @domName scrollHeight */
   final int $dom_scrollHeight;
 
+  /** @domName scrollLeft */
   int $dom_scrollLeft;
 
+  /** @domName scrollTop */
   int $dom_scrollTop;
 
+  /** @domName scrollWidth */
   final int $dom_scrollWidth;
 
   bool spellcheck;
 
   final CSSStyleDeclaration style;
 
   int tabIndex;
 
   final String tagName;
 
   String title;
 
   bool translate;
 
   final String webkitRegionOverflow;
 
   String webkitdropzone;
 
   void blur();
 
   void click();
 
   void focus();
 
+  /** @domName getAttribute */
   String $dom_getAttribute(String name);
 
+  /** @domName getBoundingClientRect */
   ClientRect $dom_getBoundingClientRect();
 
+  /** @domName getClientRects */
   ClientRectList $dom_getClientRects();
 
+  /** @domName getElementsByClassName */
   NodeList $dom_getElementsByClassName(String name);
 
+  /** @domName getElementsByTagName */
   NodeList $dom_getElementsByTagName(String name);
 
+  /** @domName hasAttribute */
   bool $dom_hasAttribute(String name);
 
   Element insertAdjacentElement(String where, Element element);
 
   void insertAdjacentHTML(String where, String html);
 
   void insertAdjacentText(String where, String text);
 
+  /** @domName querySelector */
   Element query(String selectors);
 
+  /** @domName querySelectorAll */
   NodeList $dom_querySelectorAll(String selectors);
 
+  /** @domName removeAttribute */
   void $dom_removeAttribute(String name);
 
   void scrollByLines(int lines);
 
   void scrollByPages(int pages);
 
+  /** @domName scrollIntoViewIfNeeded */
   void scrollIntoView([bool centerIfNeeded]);
 
+  /** @domName setAttribute */
   void $dom_setAttribute(String name, String value);
 
+  /** @domName webkitMatchesSelector */
   bool matchesSelector(String selectors);
 
   void webkitRequestFullScreen(int flags);
 
   void webkitRequestFullscreen();
 
 }
 
 interface ElementEvents extends Events {
 
@@ skipping 357 matching lines @@
   bool returnValue;
 
   final EventTarget srcElement;
 
   final EventTarget target;
 
   final int timeStamp;
 
   final String type;
 
+  /** @domName initEvent */
   void $dom_initEvent(String eventTypeArg, bool canBubbleArg, bool cancelableArg);
 
   void preventDefault();
 
   void stopImmediatePropagation();
 
   void stopPropagation();
 }
 // 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
@@ skipping 32 matching lines @@
   static final int CONNECTING = 0;
 
   static final int OPEN = 1;
 
   final String URL;
 
   final int readyState;
 
   final String url;
 
+  /** @domName addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]);
 
   void close();
 
+  /** @domName dispatchEvent */
   bool $dom_dispatchEvent(Event evt);
 
+  /** @domName removeEventListener */
   void $dom_removeEventListener(String type, EventListener listener, [bool useCapture]);
 }
 
 interface EventSourceEvents extends Events {
 
   EventListenerList get error();
 
   EventListenerList get message();
 
   EventListenerList get open();
@@ skipping 13 matching lines @@
 }
 
 interface Events {
   EventListenerList operator [](String type);
 }
 
 interface EventTarget {
 
   final Events on;
 
+  /** @domName addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]);
 
+  /** @domName dispatchEvent */
   bool $dom_dispatchEvent(Event event);
 
+  /** @domName removeEventListener */
   void $dom_removeEventListener(String type, EventListener listener, [bool useCapture]);
 
 }
 // 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.
 
 // WARNING: Do not edit - generated code.
 
 interface FieldSetElement extends Element {
@@ skipping 1909 matching lines @@
 // 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.
 
 // WARNING: Do not edit - generated code.
 
 interface MessagePort extends EventTarget {
 
   MessagePortEvents get on();
 
+  /** @domName addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]);
 
   void close();
 
+  /** @domName dispatchEvent */
   bool $dom_dispatchEvent(Event evt);
 
   void postMessage(String message, [List messagePorts]);
 
+  /** @domName removeEventListener */
   void $dom_removeEventListener(String type, EventListener listener, [bool useCapture]);
 
   void start();
 
   void webkitPostMessage(String message, [List transfer]);
 }
 
 interface MessagePortEvents extends Events {
 
   EventListenerList get message();
@@ skipping 108 matching lines @@
   final int screenY;
 
   final bool shiftKey;
 
   final Node toElement;
 
   final int x;
 
   final int y;
 
+  /** @domName initMouseEvent */
   void $dom_initMouseEvent(String type, bool canBubble, bool cancelable, Window view, int detail, int screenX, int screenY, int clientX, int clientY, bool ctrlKey, bool altKey, bool shiftKey, bool metaKey, int button, EventTarget relatedTarget);
 }
 // 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.
 
 // WARNING: Do not edit - generated code.
 
 interface MutationEvent extends Event {
 
@@ skipping 156 matching lines @@
   static final int ENTITY_NODE = 6;
 
   static final int ENTITY_REFERENCE_NODE = 5;
 
   static final int NOTATION_NODE = 12;
 
   static final int PROCESSING_INSTRUCTION_NODE = 7;
 
   static final int TEXT_NODE = 3;
 
+  /** @domName attributes */
   final NamedNodeMap $dom_attributes;
 
+  /** @domName childNodes */
   final NodeList $dom_childNodes;
 
+  /** @domName firstChild */
   final Node $dom_firstChild;
 
+  /** @domName lastChild */
   final Node $dom_lastChild;
 
+  /** @domName nextSibling */
   final Node nextNode;
 
+  /** @domName nodeType */
   final int $dom_nodeType;
 
+  /** @domName ownerDocument */
   final Document document;
 
+  /** @domName parentNode */
   final Node parent;
 
+  /** @domName previousSibling */
   final Node previousNode;
 
+  /** @domName textContent */
   String text;
 
+  /** @domName appendChild */
   Node $dom_appendChild(Node newChild);
 
+  /** @domName cloneNode */
   Node clone(bool deep);
 
   bool contains(Node other);
 
   bool hasChildNodes();
 
   Node insertBefore(Node newChild, Node refChild);
 
+  /** @domName removeChild */
   Node $dom_removeChild(Node oldChild);
 
+  /** @domName replaceChild */
   Node $dom_replaceChild(Node newChild, Node oldChild);
 
 }
 // 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.
 
 // WARNING: Do not edit - generated code.
 
 interface NodeFilter {
@@ skipping 81 matching lines @@
 // BSD-style license that can be found in the LICENSE file.
 
 // WARNING: Do not edit - generated code.
 
 interface NodeSelector {
 
   // TODO(nweiz): add this back once DocumentFragment is ported.
   // ElementList queryAll(String selectors);
 
 
+  /** @domName querySelector */
   Element query(String selectors);
 
+  /** @domName querySelectorAll */
   NodeList $dom_querySelectorAll(String selectors);
 
 }
 // 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.
 
 // WARNING: Do not edit - generated code.
 
 interface Notation extends Node {
@@ skipping 1270 matching lines @@
 // 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.
 
 // WARNING: Do not edit - generated code.
 
 interface SVGDocument extends Document {
 
   final SVGSVGElement rootElement;
 
+  /** @domName createEvent */
   Event $dom_createEvent(String eventType);
 }
 // 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.
 
 interface SVGElement extends Element default _SVGElementFactoryProvider {
 
   SVGElement.tag(String tag);
   SVGElement.svg(String svg);
@@ skipping 29 matching lines @@
   final SVGElementInstance firstChild;
 
   final SVGElementInstance lastChild;
 
   final SVGElementInstance nextSibling;
 
   final SVGElementInstance parentNode;
 
   final SVGElementInstance previousSibling;
 
+  /** @domName addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]);
 
+  /** @domName dispatchEvent */
   bool $dom_dispatchEvent(Event event);
 
+  /** @domName removeEventListener */
   void $dom_removeEventListener(String type, EventListener listener, [bool useCapture]);
 }
 
 interface SVGElementInstanceEvents extends Events {
 
   EventListenerList get abort();
 
   EventListenerList get beforeCopy();
 
   EventListenerList get beforeCut();
@@ skipping 1833 matching lines @@
   String replaceItem(String item, int index);
 }
 // 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.
 
 // WARNING: Do not edit - generated code.
 
 interface SVGStylable {
 
+  /** @domName className */
   final SVGAnimatedString $dom_svgClassName;
 
   final CSSStyleDeclaration style;
 
   CSSValue getPresentationAttribute(String name);
 }
 // 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.
 
@@ skipping 781 matching lines @@
   final int length;
 
   SpeechRecognitionResult item(int index);
 }
 // 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.
 
 interface Storage extends Map<String, String> {
 
+  /** @domName length */
   final int $dom_length;
 
+  /** @domName clear */
   void $dom_clear();
 
+  /** @domName getItem */
   String $dom_getItem(String key);
 
+  /** @domName key */
   String $dom_key(int index);
 
+  /** @domName removeItem */
   void $dom_removeItem(String key);
 
+  /** @domName setItem */
   void $dom_setItem(String key, String data);
 
 }
 // 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.
 
 // WARNING: Do not edit - generated code.
 
 interface StorageEvent extends Event {
@@ skipping 1968 matching lines @@
   final int bufferedAmount;
 
   final String extensions;
 
   final String protocol;
 
   final int readyState;
 
   final String url;
 
+  /** @domName addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]);
 
   void close([int code, String reason]);
 
+  /** @domName dispatchEvent */
   bool $dom_dispatchEvent(Event evt);
 
+  /** @domName removeEventListener */
   void $dom_removeEventListener(String type, EventListener listener, [bool useCapture]);
 
   bool send(String data);
 }
 
 interface WebSocketEvents extends Events {
 
   EventListenerList get close();
 
   EventListenerList get error();
@@ skipping 159 matching lines @@
   final Window top;
 
   final IDBFactory webkitIndexedDB;
 
   final NotificationCenter webkitNotifications;
 
   final StorageInfo webkitStorageInfo;
 
   final Window window;
 
+  /** @domName addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]);
 
   void alert(String message);
 
   String atob(String string);
 
   void blur();
 
   String btoa(String string);
 
   void captureEvents();
 
   void clearInterval(int handle);
 
   void clearTimeout(int handle);
 
   void close();
 
   bool confirm(String message);
 
+  /** @domName dispatchEvent */
   bool $dom_dispatchEvent(Event evt);
 
   bool find(String string, bool caseSensitive, bool backwards, bool wrap, bool wholeWord, bool searchInFrames, bool showDialog);
 
   void focus();
 
+  /** @domName getComputedStyle */
   CSSStyleDeclaration $dom_getComputedStyle(Element element, String pseudoElement);
 
   CSSRuleList getMatchedCSSRules(Element element, String pseudoElement);
 
   DOMSelection getSelection();
 
   MediaQueryList matchMedia(String query);
 
   void moveBy(num x, num y);
 
   void moveTo(num x, num y);
 
   Window open(String url, String name, [String options]);
 
   Database openDatabase(String name, String version, String displayName, int estimatedSize, [DatabaseCallback creationCallback]);
 
   void postMessage(Dynamic message, String targetOrigin, [List messagePorts]);
 
   void print();
 
   String prompt(String message, String defaultValue);
 
   void releaseEvents();
 
+  /** @domName removeEventListener */
   void $dom_removeEventListener(String type, EventListener listener, [bool useCapture]);
 
   void resizeBy(num x, num y);
 
   void resizeTo(num width, num height);
 
   void scroll(int x, int y);
 
   void scrollBy(int x, int y);
 
@@ skipping 338 matching lines @@
   final int status;
 
   final String statusText;
 
   final XMLHttpRequestUpload upload;
 
   bool withCredentials;
 
   void abort();
 
+  /** @domName addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]);
 
+  /** @domName dispatchEvent */
   bool $dom_dispatchEvent(Event evt);
 
   String getAllResponseHeaders();
 
   String getResponseHeader(String header);
 
   void open(String method, String url, [bool async, String user, String password]);
 
   void overrideMimeType(String override);
 
+  /** @domName removeEventListener */
   void $dom_removeEventListener(String type, EventListener listener, [bool useCapture]);
 
   void send([var data]);
 
   void setRequestHeader(String header, String value);
 }
 
 interface XMLHttpRequestEvents extends Events {
 
   EventListenerList get abort();
@@ skipping 45 matching lines @@
 // 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.
 
 // WARNING: Do not edit - generated code.
 
 interface XMLHttpRequestUpload extends EventTarget {
 
   XMLHttpRequestUploadEvents get on();
 
+  /** @domName addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]);
 
+  /** @domName dispatchEvent */
   bool $dom_dispatchEvent(Event evt);
 
+  /** @domName removeEventListener */
   void $dom_removeEventListener(String type, EventListener listener, [bool useCapture]);
 }
 
 interface XMLHttpRequestUploadEvents extends Events {
 
   EventListenerList get abort();
 
   EventListenerList get error();
 
   EventListenerList get load();
@@ skipping 1294 matching lines @@
     if (length < 0) throw new IllegalArgumentException('length');
     if (start < 0) throw new IndexOutOfRangeException(start);
     int end = start + length;
     if (end > a.length) throw new IndexOutOfRangeException(end);
     for (int i = start; i < end; i++) {
       accumulator.add(a[i]);
     }
     return accumulator;
   }
 }