Add documentation for HttpRequest.

sdk/lib/html/dartium/html_dartium.dart

 library html;
 
 import 'dart:collection';
 import 'dart:html_common';
 import 'dart:indexed_db';
 import 'dart:isolate';
 import 'dart:json';
 import 'dart:nativewrappers';
 import 'dart:svg' as svg;
 import 'dart:web_audio' as web_audio;
@@ skipping 90 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.
 
 
 /// @domName HTMLAnchorElement
 class AnchorElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory AnchorElement({String href}) {
     var e = document.$dom_createElement("a");
     if (href != null) e.href = href;
     return e;
   }
   AnchorElement.internal(): super.internal();
 
 
   /** @domName HTMLAnchorElement.charset */
   String get charset native "HTMLAnchorElement_charset_Getter";
@@ skipping 426 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.
 
 
 /// @domName HTMLAreaElement
 class AreaElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory AreaElement() => document.$dom_createElement("area");
   AreaElement.internal(): super.internal();
 
 
   /** @domName HTMLAreaElement.alt */
   String get alt native "HTMLAreaElement_alt_Getter";
 
 
   /** @domName HTMLAreaElement.alt */
   void set alt(String value) native "HTMLAreaElement_alt_Setter";
@@ skipping 78 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.
 
 
 /// @domName ArrayBuffer
 class ArrayBuffer extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory ArrayBuffer(int length) => _ArrayBufferFactoryProvider.createArrayBuffer(length);
   ArrayBuffer.internal();
 
 
   /** @domName ArrayBuffer.byteLength */
   int get byteLength native "ArrayBuffer_byteLength_Getter";
 
   ArrayBuffer slice(/*long*/ begin, [/*long*/ end]) {
     if (?end) {
       return _slice_1(begin, end);
@@ skipping 73 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.
 
 
 /// @domName HTMLAudioElement
 class AudioElement extends MediaElement {
 
+  ///@docsEditable true
   factory AudioElement([String src]) {
     if (!?src) {
       return _AudioElementFactoryProvider.createAudioElement();
     }
     return _AudioElementFactoryProvider.createAudioElement(src);
   }
   AudioElement.internal(): super.internal();
 
 }
 // 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.
 
 
 /// @domName HTMLBRElement
 class BRElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory BRElement() => document.$dom_createElement("br");
   BRElement.internal(): super.internal();
 
 
   /** @domName HTMLBRElement.clear */
   String get clear native "HTMLBRElement_clear_Getter";
 
 
   /** @domName HTMLBRElement.clear */
   void set clear(String value) native "HTMLBRElement_clear_Setter";
@@ skipping 18 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.
 
 
 /// @domName HTMLBaseElement
 class BaseElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory BaseElement() => document.$dom_createElement("base");
   BaseElement.internal(): super.internal();
 
 
   /** @domName HTMLBaseElement.href */
   String get href native "HTMLBaseElement_href_Getter";
 
 
   /** @domName HTMLBaseElement.href */
   void set href(String value) native "HTMLBaseElement_href_Setter";
@@ skipping 118 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.
 
 
 /// @domName Blob
 class Blob extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory Blob(List blobParts, [String type, String endings]) {
     if (!?type) {
       return _BlobFactoryProvider.createBlob(blobParts);
     }
     if (!?endings) {
       return _BlobFactoryProvider.createBlob(blobParts, type);
     }
     return _BlobFactoryProvider.createBlob(blobParts, type, endings);
   }
   Blob.internal();
@@ skipping 39 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.
 
 
 /// @domName HTMLBodyElement
 class BodyElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory BodyElement() => document.$dom_createElement("body");
   BodyElement.internal(): super.internal();
 
   /// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true
   BodyElementEvents get on =>
     new BodyElementEvents(this);
 
 
   /** @domName HTMLBodyElement.aLink */
   String get aLink native "HTMLBodyElement_aLink_Getter";
@@ skipping 68 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.
 
 
 /// @domName HTMLButtonElement
 class ButtonElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory ButtonElement() => document.$dom_createElement("button");
   ButtonElement.internal(): super.internal();
 
 
   /** @domName HTMLButtonElement.autofocus */
   bool get autofocus native "HTMLButtonElement_autofocus_Getter";
 
 
   /** @domName HTMLButtonElement.autofocus */
   void set autofocus(bool value) native "HTMLButtonElement_autofocus_Setter";
@@ skipping 112 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.
 
 
 /// @domName HTMLCanvasElement
 class CanvasElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory CanvasElement({int width, int height}) {
     var e = document.$dom_createElement("canvas");
     if (width != null) e.width = width;
     if (height != null) e.height = height;
     return e;
   }
   CanvasElement.internal(): super.internal();
 
 
   /** @domName HTMLCanvasElement.height */
@@ skipping 1047 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.
 
 
 /// @domName HTMLContentElement
 class ContentElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory ContentElement() => document.$dom_createElement("content");
   ContentElement.internal(): super.internal();
 
 
   /** @domName HTMLContentElement.resetStyleInheritance */
   bool get resetStyleInheritance native "HTMLContentElement_resetStyleInheritance_Getter";
 
 
   /** @domName HTMLContentElement.resetStyleInheritance */
   void set resetStyleInheritance(bool value) native "HTMLContentElement_resetStyleInheritance_Setter";
@@ skipping 214 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.
 
 
 /// @domName WebKitCSSMatrix
 class CssMatrix extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory CssMatrix([String cssValue]) {
     if (!?cssValue) {
       return _CssMatrixFactoryProvider.createCssMatrix();
     }
     return _CssMatrixFactoryProvider.createCssMatrix(cssValue);
   }
   CssMatrix.internal();
 
 
   /** @domName WebKitCSSMatrix.a */
@@ skipping 3855 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.
 
 
 /// @domName HTMLDListElement
 class DListElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory DListElement() => document.$dom_createElement("dl");
   DListElement.internal(): super.internal();
 
 
   /** @domName HTMLDListElement.compact */
   bool get compact native "HTMLDListElement_compact_Getter";
 
 
   /** @domName HTMLDListElement.compact */
   void set compact(bool value) native "HTMLDListElement_compact_Setter";
 
 }
 // 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.
 
 
 /// @domName HTMLDataListElement
 class DataListElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory DataListElement() => document.$dom_createElement("datalist");
   DataListElement.internal(): super.internal();
 
 
   /** @domName HTMLDataListElement.options */
   HtmlCollection get options native "HTMLDataListElement_options_Getter";
 
 }
 // 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 74 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.
 
 
 /// @domName DataView
 class DataView extends ArrayBufferView {
 
+  ///@docsEditable true
   factory DataView(ArrayBuffer buffer, [int byteOffset, int byteLength]) {
     if (!?byteOffset) {
       return _DataViewFactoryProvider.createDataView(buffer);
     }
     if (!?byteLength) {
       return _DataViewFactoryProvider.createDataView(buffer, byteOffset);
     }
     return _DataViewFactoryProvider.createDataView(buffer, byteOffset, byteLength);
   }
   DataView.internal(): super.internal();
@@ skipping 298 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.
 
 
 /// @domName HTMLDetailsElement
 class DetailsElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory DetailsElement() => document.$dom_createElement("details");
   DetailsElement.internal(): super.internal();
 
 
   /** @domName HTMLDetailsElement.open */
   bool get open native "HTMLDetailsElement_open_Getter";
 
 
   /** @domName HTMLDetailsElement.open */
   void set open(bool value) native "HTMLDetailsElement_open_Setter";
@@ skipping 158 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.
 
 
 /// @domName HTMLDivElement
 class DivElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory DivElement() => document.$dom_createElement("div");
   DivElement.internal(): super.internal();
 
 }
 // 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.
 
 
 /// @domName Document
@@ skipping 900 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.
 
 
 /// @domName DOMParser
 class DomParser extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory DomParser() => _DomParserFactoryProvider.createDomParser();
   DomParser.internal();
 
 
   /** @domName DOMParser.parseFromString */
   Document parseFromString(String str, String contentType) native "DOMParser_parseFromString_Callback";
 
 }
 // 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 1442 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.
 
 
 /// @domName HTMLEmbedElement
 class EmbedElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory EmbedElement() => document.$dom_createElement("embed");
   EmbedElement.internal(): super.internal();
 
 
   /** @domName HTMLEmbedElement.align */
   String get align native "HTMLEmbedElement_align_Getter";
 
 
   /** @domName HTMLEmbedElement.align */
   void set align(String value) native "HTMLEmbedElement_align_Setter";
@@ skipping 398 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.
 
 
 /// @domName EventSource
 class EventSource extends EventTarget {
 
+  ///@docsEditable true
   factory EventSource(String scriptUrl) => _EventSourceFactoryProvider.createEventSource(scriptUrl);
   EventSource.internal(): super.internal();
 
   /// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true
   EventSourceEvents get on =>
     new EventSourceEvents(this);
 
   static const int CLOSED = 2;
 
   static const int CONNECTING = 0;
@@ skipping 148 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.
 
 
 /// @domName HTMLFieldSetElement
 class FieldSetElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory FieldSetElement() => document.$dom_createElement("fieldset");
   FieldSetElement.internal(): super.internal();
 
 
   /** @domName HTMLFieldSetElement.disabled */
   bool get disabled native "HTMLFieldSetElement_disabled_Getter";
 
 
   /** @domName HTMLFieldSetElement.disabled */
   void set disabled(bool value) native "HTMLFieldSetElement_disabled_Setter";
@@ skipping 326 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.
 
 
 /// @domName FileReader
 class FileReader extends EventTarget {
 
+  ///@docsEditable true
   factory FileReader() => _FileReaderFactoryProvider.createFileReader();
   FileReader.internal(): super.internal();
 
   /// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true
   FileReaderEvents get on =>
     new FileReaderEvents(this);
 
   static const int DONE = 2;
 
   static const int EMPTY = 0;
@@ skipping 76 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.
 
 
 /// @domName FileReaderSync
 class FileReaderSync extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory FileReaderSync() => _FileReaderSyncFactoryProvider.createFileReaderSync();
   FileReaderSync.internal();
 
 
   /** @domName FileReaderSync.readAsArrayBuffer */
   ArrayBuffer readAsArrayBuffer(Blob blob) native "FileReaderSync_readAsArrayBuffer_Callback";
 
 
   /** @domName FileReaderSync.readAsBinaryString */
   String readAsBinaryString(Blob blob) native "FileReaderSync_readAsBinaryString_Callback";
@@ skipping 523 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.
 
 
 /// @domName FormData
 class FormData extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory FormData([FormElement form]) {
     if (!?form) {
       return _FormDataFactoryProvider.createFormData();
     }
     return _FormDataFactoryProvider.createFormData(form);
   }
   FormData.internal();
 
 
   /** @domName DOMFormData.append */
   void append(String name, String value, String filename) native "DOMFormData_append_Callback";
 
 }
 // 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.
 
 
 /// @domName HTMLFormElement
 class FormElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory FormElement() => document.$dom_createElement("form");
   FormElement.internal(): super.internal();
 
 
   /** @domName HTMLFormElement.acceptCharset */
   String get acceptCharset native "HTMLFormElement_acceptCharset_Getter";
 
 
   /** @domName HTMLFormElement.acceptCharset */
   void set acceptCharset(String value) native "HTMLFormElement_acceptCharset_Setter";
@@ skipping 316 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.
 
 
 /// @domName HTMLHRElement
 class HRElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory HRElement() => document.$dom_createElement("hr");
   HRElement.internal(): super.internal();
 
 
   /** @domName HTMLHRElement.align */
   String get align native "HTMLHRElement_align_Getter";
 
 
   /** @domName HTMLHRElement.align */
   void set align(String value) native "HTMLHRElement_align_Setter";
@@ skipping 50 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.
 
 
 /// @domName HTMLHeadElement
 class HeadElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory HeadElement() => document.$dom_createElement("head");
   HeadElement.internal(): super.internal();
 
 
   /** @domName HTMLHeadElement.profile */
   String get profile native "HTMLHeadElement_profile_Getter";
 
 
   /** @domName HTMLHeadElement.profile */
   void set profile(String value) native "HTMLHeadElement_profile_Setter";
 
 }
 // 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.
 
 
 /// @domName HTMLHeadingElement
 class HeadingElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory HeadingElement.h1() => document.$dom_createElement("h1");
 
+  ///@docsEditable true
   factory HeadingElement.h2() => document.$dom_createElement("h2");
 
+  ///@docsEditable true
   factory HeadingElement.h3() => document.$dom_createElement("h3");
 
+  ///@docsEditable true
   factory HeadingElement.h4() => document.$dom_createElement("h4");
 
+  ///@docsEditable true
   factory HeadingElement.h5() => document.$dom_createElement("h5");
 
+  ///@docsEditable true
   factory HeadingElement.h6() => document.$dom_createElement("h6");
   HeadingElement.internal(): super.internal();
 
 
   /** @domName HTMLHeadingElement.align */
   String get align native "HTMLHeadingElement_align_Getter";
 
 
   /** @domName HTMLHeadingElement.align */
   void set align(String value) native "HTMLHeadingElement_align_Setter";
@@ skipping 341 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.
 
 
 /// @domName HTMLHtmlElement
 class HtmlElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory HtmlElement() => document.$dom_createElement("html");
   HtmlElement.internal(): super.internal();
 
 }
 // 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.
 
@@ skipping 25 matching lines @@
 
   /** @domName HTMLOptionsCollection.remove */
   void remove(int index) native "HTMLOptionsCollection_remove_Callback";
 
 }
 // 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.
 
 
+/**
+ * A utility for retrieving data from a URL.
+ * 
+ * HttpRequest can be used to obtain data from http, ftp, and file
+ * protocols. 
+ * 
+ * For example, suppose we're developing these API docs, and we
+ * wish to retrieve the HTML of the top-level page and print it out.
+ * The easiest way to do that would be:
+ * 
+ *     var httpRequest = HttpRequest.get('http://api.dartlang.org',
+ *         (request) => print(request.responseText));
+ * 
+ * **Important**: With the default behavior of this class, your
+ * code making the request should be served from the same origin (domain name,
+ * port, and application layer protocol) as the URL you are trying to access
+ * with HttpRequest. However, there are ways to 
+ * [get around this restriction](http://www.dartlang.org/articles/json-web-service/#note-on-jsonp).
+ * 
+ * See also:
+ *
+ * * [Dart article on using HttpRequests](http://www.dartlang.org/articles/json-web-service/#getting-data)
+ * * [JS XMLHttpRequest](https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest)
+ * * [Using XMLHttpRequest](https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest)
+ */
 /// @domName XMLHttpRequest
 class HttpRequest extends EventTarget {
+  /**
+   * Creates a URL get request for the specified `url`.
+   * 
+   * After completing the request, the object will call the user-provided
+   * [onComplete] callback.
+   */
   factory HttpRequest.get(String url, onComplete(HttpRequest request)) =>
       _HttpRequestFactoryProvider.createHttpRequest_get(url, onComplete);
 
+  /**
+   * Creates a URL GET request for the specified `url` with
+   * credentials such a cookie (already) set in the header or
+   * (authorization headers)[http://tools.ietf.org/html/rfc1945#section-10.2].
+   * 
+   * After completing the request, the object will call the user-provided 
+   * [onComplete] callback.
+   * 
+   * See also: (authorization headers)[http://en.wikipedia.org/wiki/Basic_access_authentication].
+   */
   factory HttpRequest.getWithCredentials(String url,
       onComplete(HttpRequest request)) =>
       _HttpRequestFactoryProvider.createHttpRequest_getWithCredentials(url,
       onComplete);
 
 
+  ///@docsEditable true
   factory HttpRequest() => _HttpRequestFactoryProvider.createHttpRequest();
   HttpRequest.internal(): super.internal();
 
   /// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true
   HttpRequestEvents get on =>
     new HttpRequestEvents(this);
 
   static const int DONE = 4;
 
   static const int HEADERS_RECEIVED = 2;
@@ skipping 206 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.
 
 
 /// @domName HTMLIFrameElement
 class IFrameElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory IFrameElement() => document.$dom_createElement("iframe");
   IFrameElement.internal(): super.internal();
 
 
   /** @domName HTMLIFrameElement.align */
   String get align native "HTMLIFrameElement_align_Getter";
 
 
   /** @domName HTMLIFrameElement.align */
   void set align(String value) native "HTMLIFrameElement_align_Setter";
@@ skipping 102 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.
 
 
 /// @domName IceCandidate
 class IceCandidate extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory IceCandidate(String label, String candidateLine) => _IceCandidateFactoryProvider.createIceCandidate(label, candidateLine);
   IceCandidate.internal();
 
 
   /** @domName IceCandidate.label */
   String get label native "IceCandidate_label_Getter";
 
 
   /** @domName IceCandidate.toSdp */
   String toSdp() native "IceCandidate_toSdp_Callback";
@@ skipping 26 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.
 
 
 /// @domName HTMLImageElement
 class ImageElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory ImageElement({String src, int width, int height}) {
     var e = document.$dom_createElement("img");
     if (src != null) e.src = src;
     if (width != null) e.width = width;
     if (height != null) e.height = height;
     return e;
   }
   ImageElement.internal(): super.internal();
 
 
@@ skipping 132 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.
 
 
 /// @domName HTMLInputElement
 class InputElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory InputElement({String type}) {
     var e = document.$dom_createElement("input");
     if (type != null) e.type = type;
     return e;
   }
   InputElement.internal(): super.internal();
 
   /// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true
   InputElementEvents get on =>
     new InputElementEvents(this);
@@ skipping 1019 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.
 
 
 /// @domName HTMLKeygenElement
 class KeygenElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory KeygenElement() => document.$dom_createElement("keygen");
   KeygenElement.internal(): super.internal();
 
 
   /** @domName HTMLKeygenElement.autofocus */
   bool get autofocus native "HTMLKeygenElement_autofocus_Getter";
 
 
   /** @domName HTMLKeygenElement.autofocus */
   void set autofocus(bool value) native "HTMLKeygenElement_autofocus_Setter";
@@ skipping 66 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.
 
 
 /// @domName HTMLLIElement
 class LIElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory LIElement() => document.$dom_createElement("li");
   LIElement.internal(): super.internal();
 
 
   /** @domName HTMLLIElement.type */
   String get type native "HTMLLIElement_type_Getter";
 
 
   /** @domName HTMLLIElement.type */
   void set type(String value) native "HTMLLIElement_type_Setter";
@@ skipping 10 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.
 
 
 /// @domName HTMLLabelElement
 class LabelElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory LabelElement() => document.$dom_createElement("label");
   LabelElement.internal(): super.internal();
 
 
   /** @domName HTMLLabelElement.control */
   Element get control native "HTMLLabelElement_control_Getter";
 
 
   /** @domName HTMLLabelElement.form */
   FormElement get form native "HTMLLabelElement_form_Getter";
@@ skipping 10 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.
 
 
 /// @domName HTMLLegendElement
 class LegendElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory LegendElement() => document.$dom_createElement("legend");
   LegendElement.internal(): super.internal();
 
 
   /** @domName HTMLLegendElement.align */
   String get align native "HTMLLegendElement_align_Getter";
 
 
   /** @domName HTMLLegendElement.align */
   void set align(String value) native "HTMLLegendElement_align_Setter";
 
 
   /** @domName HTMLLegendElement.form */
   FormElement get form native "HTMLLegendElement_form_Getter";
 
 }
 // 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.
 
 
 /// @domName HTMLLinkElement
 class LinkElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory LinkElement() => document.$dom_createElement("link");
   LinkElement.internal(): super.internal();
 
 
   /** @domName HTMLLinkElement.charset */
   String get charset native "HTMLLinkElement_charset_Getter";
 
 
   /** @domName HTMLLinkElement.charset */
   void set charset(String value) native "HTMLLinkElement_charset_Setter";
@@ skipping 799 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.
 
 
 /// @domName HTMLMapElement
 class MapElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory MapElement() => document.$dom_createElement("map");
   MapElement.internal(): super.internal();
 
 
   /** @domName HTMLMapElement.areas */
   HtmlCollection get areas native "HTMLMapElement_areas_Getter";
 
 
   /** @domName HTMLMapElement.name */
   String get name native "HTMLMapElement_name_Getter";
@@ skipping 114 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.
 
 
 /// @domName MediaController
 class MediaController extends EventTarget {
 
+  ///@docsEditable true
   factory MediaController() => _MediaControllerFactoryProvider.createMediaController();
   MediaController.internal(): super.internal();
 
 
   /** @domName MediaController.buffered */
   TimeRanges get buffered native "MediaController_buffered_Getter";
 
 
   /** @domName MediaController.currentTime */
   num get currentTime native "MediaController_currentTime_Getter";
@@ skipping 598 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.
 
 
 /// @domName MediaSource
 class MediaSource extends EventTarget {
 
+  ///@docsEditable true
   factory MediaSource() => _MediaSourceFactoryProvider.createMediaSource();
   MediaSource.internal(): super.internal();
 
 
   /** @domName MediaSource.activeSourceBuffers */
   SourceBufferList get activeSourceBuffers native "MediaSource_activeSourceBuffers_Getter";
 
 
   /** @domName MediaSource.duration */
   num get duration native "MediaSource_duration_Getter";
@@ skipping 38 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.
 
 
 /// @domName MediaStream
 class MediaStream extends EventTarget {
 
+  ///@docsEditable true
   factory MediaStream(MediaStreamTrackList audioTracks, MediaStreamTrackList videoTracks) => _MediaStreamFactoryProvider.createMediaStream(audioTracks, videoTracks);
   MediaStream.internal(): super.internal();
 
   /// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true
   MediaStreamEvents get on =>
     new MediaStreamEvents(this);
 
   static const int ENDED = 2;
 
   static const int LIVE = 1;
@@ skipping 208 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.
 
 
 /// @domName HTMLMenuElement
 class MenuElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory MenuElement() => document.$dom_createElement("menu");
   MenuElement.internal(): super.internal();
 
 }
 // 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.
 
 
 /// @domName MessageChannel
 class MessageChannel extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory MessageChannel() => _MessageChannelFactoryProvider.createMessageChannel();
   MessageChannel.internal();
 
 
   /** @domName MessageChannel.port1 */
   MessagePort get port1 native "MessageChannel_port1_Getter";
 
 
   /** @domName MessageChannel.port2 */
   MessagePort get port2 native "MessageChannel_port2_Getter";
@@ skipping 160 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.
 
 
 /// @domName HTMLMeterElement
 class MeterElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory MeterElement() => document.$dom_createElement("meter");
   MeterElement.internal(): super.internal();
 
 
   /** @domName HTMLMeterElement.high */
   num get high native "HTMLMeterElement_high_Getter";
 
 
   /** @domName HTMLMeterElement.high */
   void set high(num value) native "HTMLMeterElement_high_Setter";
@@ skipping 224 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.
 
 
 /// @domName MutationObserver
 class MutationObserver extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory MutationObserver(MutationCallback callback) => _MutationObserverFactoryProvider.createMutationObserver(callback);
   MutationObserver.internal();
 
 
   /** @domName MutationObserver.disconnect */
   void disconnect() native "MutationObserver_disconnect_Callback";
 
 
   /** @domName MutationObserver._observe */
   void _observe(Node target, Map options) native "MutationObserver__observe_Callback";
@@ skipping 921 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.
 
 
 /// @domName Notification
 class Notification extends EventTarget {
 
+  ///@docsEditable true
   factory Notification(String title, [Map options]) {
     if (!?options) {
       return _NotificationFactoryProvider.createNotification(title);
     }
     return _NotificationFactoryProvider.createNotification(title, options);
   }
   Notification.internal(): super.internal();
 
   /// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true
   NotificationEvents get on =>
@@ skipping 109 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.
 
 
 /// @domName HTMLOListElement
 class OListElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory OListElement() => document.$dom_createElement("ol");
   OListElement.internal(): super.internal();
 
 
   /** @domName HTMLOListElement.compact */
   bool get compact native "HTMLOListElement_compact_Getter";
 
 
   /** @domName HTMLOListElement.compact */
   void set compact(bool value) native "HTMLOListElement_compact_Setter";
@@ skipping 26 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.
 
 
 /// @domName HTMLObjectElement
 class ObjectElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory ObjectElement() => document.$dom_createElement("object");
   ObjectElement.internal(): super.internal();
 
 
   /** @domName HTMLObjectElement.align */
   String get align native "HTMLObjectElement_align_Getter";
 
 
   /** @domName HTMLObjectElement.align */
   void set align(String value) native "HTMLObjectElement_align_Setter";
@@ skipping 214 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.
 
 
 /// @domName HTMLOptGroupElement
 class OptGroupElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory OptGroupElement() => document.$dom_createElement("optgroup");
   OptGroupElement.internal(): super.internal();
 
 
   /** @domName HTMLOptGroupElement.disabled */
   bool get disabled native "HTMLOptGroupElement_disabled_Getter";
 
 
   /** @domName HTMLOptGroupElement.disabled */
   void set disabled(bool value) native "HTMLOptGroupElement_disabled_Setter";
@@ skipping 10 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.
 
 
 /// @domName HTMLOptionElement
 class OptionElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory OptionElement([String data, String value, bool defaultSelected, bool selected]) {
     if (!?data) {
       return _OptionElementFactoryProvider.createOptionElement();
     }
     if (!?value) {
       return _OptionElementFactoryProvider.createOptionElement(data);
     }
     if (!?defaultSelected) {
       return _OptionElementFactoryProvider.createOptionElement(data, value);
     }
@@ skipping 56 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.
 
 
 /// @domName HTMLOutputElement
 class OutputElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory OutputElement() => document.$dom_createElement("output");
   OutputElement.internal(): super.internal();
 
 
   /** @domName HTMLOutputElement.defaultValue */
   String get defaultValue native "HTMLOutputElement_defaultValue_Getter";
 
 
   /** @domName HTMLOutputElement.defaultValue */
   void set defaultValue(String value) native "HTMLOutputElement_defaultValue_Setter";
@@ skipping 124 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.
 
 
 /// @domName HTMLParagraphElement
 class ParagraphElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory ParagraphElement() => document.$dom_createElement("p");
   ParagraphElement.internal(): super.internal();
 
 
   /** @domName HTMLParagraphElement.align */
   String get align native "HTMLParagraphElement_align_Getter";
 
 
   /** @domName HTMLParagraphElement.align */
   void set align(String value) native "HTMLParagraphElement_align_Setter";
 
 }
 // 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.
 
 
 /// @domName HTMLParamElement
 class ParamElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory ParamElement() => document.$dom_createElement("param");
   ParamElement.internal(): super.internal();
 
 
   /** @domName HTMLParamElement.name */
   String get name native "HTMLParamElement_name_Getter";
 
 
   /** @domName HTMLParamElement.name */
   void set name(String value) native "HTMLParamElement_name_Setter";
@@ skipping 26 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.
 
 
 /// @domName PeerConnection00
 class PeerConnection00 extends EventTarget {
 
+  ///@docsEditable true
   factory PeerConnection00(String serverConfiguration, IceCallback iceCallback) => _PeerConnection00FactoryProvider.createPeerConnection00(serverConfiguration, iceCallback);
   PeerConnection00.internal(): super.internal();
 
   /// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true
   PeerConnection00Events get on =>
     new PeerConnection00Events(this);
 
   static const int ACTIVE = 2;
 
   static const int CLOSED = 3;
@@ skipping 351 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.
 
 
 /// @domName HTMLPreElement
 class PreElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory PreElement() => document.$dom_createElement("pre");
   PreElement.internal(): super.internal();
 
 
   /** @domName HTMLPreElement.width */
   int get width native "HTMLPreElement_width_Getter";
 
 
   /** @domName HTMLPreElement.width */
   void set width(int value) native "HTMLPreElement_width_Setter";
@@ skipping 38 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.
 
 
 /// @domName HTMLProgressElement
 class ProgressElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory ProgressElement() => document.$dom_createElement("progress");
   ProgressElement.internal(): super.internal();
 
 
   /** @domName HTMLProgressElement.labels */
   List<Node> get labels native "HTMLProgressElement_labels_Getter";
 
 
   /** @domName HTMLProgressElement.max */
   num get max native "HTMLProgressElement_max_Getter";
@@ skipping 470 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.
 
 
 /// @domName RTCIceCandidate
 class RtcIceCandidate extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory RtcIceCandidate(Map dictionary) => _RtcIceCandidateFactoryProvider.createRtcIceCandidate(dictionary);
   RtcIceCandidate.internal();
 
 
   /** @domName RTCIceCandidate.candidate */
   String get candidate native "RTCIceCandidate_candidate_Getter";
 
 
   /** @domName RTCIceCandidate.sdpMLineIndex */
   int get sdpMLineIndex native "RTCIceCandidate_sdpMLineIndex_Getter";
@@ skipping 22 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.
 
 
 /// @domName RTCPeerConnection
 class RtcPeerConnection extends EventTarget {
 
+  ///@docsEditable true
   factory RtcPeerConnection(Map rtcIceServers, [Map mediaConstraints]) {
     if (!?mediaConstraints) {
       return _RtcPeerConnectionFactoryProvider.createRtcPeerConnection(rtcIceServers);
     }
     return _RtcPeerConnectionFactoryProvider.createRtcPeerConnection(rtcIceServers, mediaConstraints);
   }
   RtcPeerConnection.internal(): super.internal();
 
   /// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true
   RtcPeerConnectionEvents get on =>
@@ skipping 101 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.
 
 
 /// @domName RTCSessionDescription
 class RtcSessionDescription extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory RtcSessionDescription(Map dictionary) => _RtcSessionDescriptionFactoryProvider.createRtcSessionDescription(dictionary);
   RtcSessionDescription.internal();
 
 
   /** @domName RTCSessionDescription.sdp */
   String get sdp native "RTCSessionDescription_sdp_Getter";
 
 
   /** @domName RTCSessionDescription.sdp */
   void set sdp(String value) native "RTCSessionDescription_sdp_Setter";
@@ skipping 150 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.
 
 
 /// @domName HTMLScriptElement
 class ScriptElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory ScriptElement() => document.$dom_createElement("script");
   ScriptElement.internal(): super.internal();
 
 
   /** @domName HTMLScriptElement.async */
   bool get async native "HTMLScriptElement_async_Getter";
 
 
   /** @domName HTMLScriptElement.async */
   void set async(bool value) native "HTMLScriptElement_async_Setter";
@@ skipping 130 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.
 
 
 /// @domName HTMLSelectElement
 class SelectElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory SelectElement() => document.$dom_createElement("select");
   SelectElement.internal(): super.internal();
 
 
   /** @domName HTMLSelectElement.autofocus */
   bool get autofocus native "HTMLSelectElement_autofocus_Getter";
 
 
   /** @domName HTMLSelectElement.autofocus */
   void set autofocus(bool value) native "HTMLSelectElement_autofocus_Setter";
@@ skipping 114 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.
 
 
 /// @domName SessionDescription
 class SessionDescription extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory SessionDescription(String sdp) => _SessionDescriptionFactoryProvider.createSessionDescription(sdp);
   SessionDescription.internal();
 
 
   /** @domName SessionDescription.addCandidate */
   void addCandidate(IceCandidate candidate) native "SessionDescription_addCandidate_Callback";
 
 
   /** @domName SessionDescription.toSdp */
   String toSdp() native "SessionDescription_toSdp_Callback";
@@ skipping 22 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.
 
 
 /// @domName ShadowRoot
 class ShadowRoot extends DocumentFragment {
 
+  ///@docsEditable true
   factory ShadowRoot(Element host) => _ShadowRootFactoryProvider.createShadowRoot(host);
   ShadowRoot.internal(): super.internal();
 
 
   /** @domName ShadowRoot.activeElement */
   Element get activeElement native "ShadowRoot_activeElement_Getter";
 
 
   /** @domName ShadowRoot.applyAuthorStyles */
   bool get applyAuthorStyles native "ShadowRoot_applyAuthorStyles_Getter";
@@ skipping 43 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.
 
 
 /// @domName SharedWorker
 class SharedWorker extends AbstractWorker {
 
+  ///@docsEditable true
   factory SharedWorker(String scriptURL, [String name]) {
     if (!?name) {
       return _SharedWorkerFactoryProvider.createSharedWorker(scriptURL);
     }
     return _SharedWorkerFactoryProvider.createSharedWorker(scriptURL, name);
   }
   SharedWorker.internal(): super.internal();
 
 
   /** @domName SharedWorker.port */
@@ skipping 193 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.
 
 
 /// @domName HTMLSourceElement
 class SourceElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory SourceElement() => document.$dom_createElement("source");
   SourceElement.internal(): super.internal();
 
 
   /** @domName HTMLSourceElement.media */
   String get media native "HTMLSourceElement_media_Getter";
 
 
   /** @domName HTMLSourceElement.media */
   void set media(String value) native "HTMLSourceElement_media_Setter";
@@ skipping 18 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.
 
 
 /// @domName HTMLSpanElement
 class SpanElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory SpanElement() => document.$dom_createElement("span");
   SpanElement.internal(): super.internal();
 
 }
 // 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.
 
 
 /// @domName SpeechGrammar
 class SpeechGrammar extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory SpeechGrammar() => _SpeechGrammarFactoryProvider.createSpeechGrammar();
   SpeechGrammar.internal();
 
 
   /** @domName SpeechGrammar.src */
   String get src native "SpeechGrammar_src_Getter";
 
 
   /** @domName SpeechGrammar.src */
   void set src(String value) native "SpeechGrammar_src_Setter";
@@ skipping 10 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.
 
 
 /// @domName SpeechGrammarList
 class SpeechGrammarList extends NativeFieldWrapperClass1 implements List<SpeechGrammar> {
 
+  ///@docsEditable true
   factory SpeechGrammarList() => _SpeechGrammarListFactoryProvider.createSpeechGrammarList();
   SpeechGrammarList.internal();
 
 
   /** @domName SpeechGrammarList.length */
   int get length native "SpeechGrammarList_length_Getter";
 
   SpeechGrammar operator[](int index) native "SpeechGrammarList_item_Callback";
 
   void operator[]=(int index, SpeechGrammar value) {
@@ skipping 170 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.
 
 
 /// @domName SpeechRecognition
 class SpeechRecognition extends EventTarget {
 
+  ///@docsEditable true
   factory SpeechRecognition() => _SpeechRecognitionFactoryProvider.createSpeechRecognition();
   SpeechRecognition.internal(): super.internal();
 
   /// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true
   SpeechRecognitionEvents get on =>
     new SpeechRecognitionEvents(this);
 
 
   /** @domName SpeechRecognition.continuous */
   bool get continuous native "SpeechRecognition_continuous_Getter";
@@ skipping 619 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.
 
 
 /// @domName HTMLStyleElement
 class StyleElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory StyleElement() => document.$dom_createElement("style");
   StyleElement.internal(): super.internal();
 
 
   /** @domName HTMLStyleElement.disabled */
   bool get disabled native "HTMLStyleElement_disabled_Getter";
 
 
   /** @domName HTMLStyleElement.disabled */
   void set disabled(bool value) native "HTMLStyleElement_disabled_Setter";
@@ skipping 94 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.
 
 
 /// @domName HTMLTableCaptionElement
 class TableCaptionElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory TableCaptionElement() => document.$dom_createElement("caption");
   TableCaptionElement.internal(): super.internal();
 
 
   /** @domName HTMLTableCaptionElement.align */
   String get align native "HTMLTableCaptionElement_align_Getter";
 
 
   /** @domName HTMLTableCaptionElement.align */
   void set align(String value) native "HTMLTableCaptionElement_align_Setter";
 
 }
 // 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.
 
 
 /// @domName HTMLTableCellElement
 class TableCellElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory TableCellElement() => document.$dom_createElement("td");
   TableCellElement.internal(): super.internal();
 
 
   /** @domName HTMLTableCellElement.abbr */
   String get abbr native "HTMLTableCellElement_abbr_Getter";
 
 
   /** @domName HTMLTableCellElement.abbr */
   void set abbr(String value) native "HTMLTableCellElement_abbr_Setter";
@@ skipping 110 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.
 
 
 /// @domName HTMLTableColElement
 class TableColElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory TableColElement() => document.$dom_createElement("col");
   TableColElement.internal(): super.internal();
 
 
   /** @domName HTMLTableColElement.align */
   String get align native "HTMLTableColElement_align_Getter";
 
 
   /** @domName HTMLTableColElement.align */
   void set align(String value) native "HTMLTableColElement_align_Setter";
@@ skipping 42 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.
 
 
 /// @domName HTMLTableElement
 class TableElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory TableElement() => document.$dom_createElement("table");
   TableElement.internal(): super.internal();
 
 
   /** @domName HTMLTableElement.align */
   String get align native "HTMLTableElement_align_Getter";
 
 
   /** @domName HTMLTableElement.align */
   void set align(String value) native "HTMLTableElement_align_Setter";
@@ skipping 134 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.
 
 
 /// @domName HTMLTableRowElement
 class TableRowElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory TableRowElement() => document.$dom_createElement("tr");
   TableRowElement.internal(): super.internal();
 
 
   /** @domName HTMLTableRowElement.align */
   String get align native "HTMLTableRowElement_align_Getter";
 
 
   /** @domName HTMLTableRowElement.align */
   void set align(String value) native "HTMLTableRowElement_align_Setter";
@@ skipping 135 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.
 
 
 /// @domName HTMLTextAreaElement
 class TextAreaElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory TextAreaElement() => document.$dom_createElement("textarea");
   TextAreaElement.internal(): super.internal();
 
 
   /** @domName HTMLTextAreaElement.autofocus */
   bool get autofocus native "HTMLTextAreaElement_autofocus_Getter";
 
 
   /** @domName HTMLTextAreaElement.autofocus */
   void set autofocus(bool value) native "HTMLTextAreaElement_autofocus_Setter";
@@ skipping 304 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.
 
 
 /// @domName TextTrackCue
 class TextTrackCue extends EventTarget {
 
+  ///@docsEditable true
   factory TextTrackCue(num startTime, num endTime, String text) => _TextTrackCueFactoryProvider.createTextTrackCue(startTime, endTime, text);
   TextTrackCue.internal(): super.internal();
 
   /// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true
   TextTrackCueEvents get on =>
     new TextTrackCueEvents(this);
 
 
   /** @domName TextTrackCue.align */
   String get align native "TextTrackCue_align_Getter";
@@ skipping 412 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.
 
 
 /// @domName HTMLTitleElement
 class TitleElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory TitleElement() => document.$dom_createElement("title");
   TitleElement.internal(): super.internal();
 
 }
 // 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.
 
@@ skipping 218 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.
 
 
 /// @domName HTMLTrackElement
 class TrackElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory TrackElement() => document.$dom_createElement("track");
   TrackElement.internal(): super.internal();
 
   static const int ERROR = 3;
 
   static const int LOADED = 2;
 
   static const int LOADING = 1;
 
   static const int NONE = 0;
@@ skipping 214 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.
 
 
 /// @domName HTMLUListElement
 class UListElement extends _Element_Merged {
 
+  ///@docsEditable true
   factory UListElement() => document.$dom_createElement("ul");
   UListElement.internal(): super.internal();
 
 
   /** @domName HTMLUListElement.compact */
   bool get compact native "HTMLUListElement_compact_Getter";
 
 
   /** @domName HTMLUListElement.compact */
   void set compact(bool value) native "HTMLUListElement_compact_Setter";
@@ skipping 607 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.
 
 
 /// @domName HTMLVideoElement
 class VideoElement extends MediaElement {
 
+  ///@docsEditable true
   factory VideoElement() => document.$dom_createElement("video");
   VideoElement.internal(): super.internal();
 
 
   /** @domName HTMLVideoElement.height */
   int get height native "HTMLVideoElement_height_Getter";
 
 
   /** @domName HTMLVideoElement.height */
   void set height(int value) native "HTMLVideoElement_height_Setter";
@@ skipping 1881 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.
 
 
 /// @domName Worker
 class Worker extends AbstractWorker {
 
+  ///@docsEditable true
   factory Worker(String scriptUrl) => _WorkerFactoryProvider.createWorker(scriptUrl);
   Worker.internal(): super.internal();
 
   /// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true
   WorkerEvents get on =>
     new WorkerEvents(this);
 
 
   /** @domName Worker.postMessage */
   void postMessage(/*SerializedScriptValue*/ message, [List messagePorts]) native "Worker_postMessage_Callback";
@@ skipping 198 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.
 
 
 /// @domName XPathEvaluator
 class XPathEvaluator extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory XPathEvaluator() => _XPathEvaluatorFactoryProvider.createXPathEvaluator();
   XPathEvaluator.internal();
 
 
   /** @domName XPathEvaluator.createExpression */
   XPathExpression createExpression(String expression, XPathNSResolver resolver) native "XPathEvaluator_createExpression_Callback";
 
 
   /** @domName XPathEvaluator.createNSResolver */
   XPathNSResolver createNSResolver(Node nodeResolver) native "XPathEvaluator_createNSResolver_Callback";
@@ skipping 138 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.
 
 
 /// @domName XMLSerializer
 class XmlSerializer extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory XmlSerializer() => _XmlSerializerFactoryProvider.createXmlSerializer();
   XmlSerializer.internal();
 
 
   /** @domName XMLSerializer.serializeToString */
   String serializeToString(Node node) native "XMLSerializer_serializeToString_Callback";
 
 }
 // 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.
 
 
 /// @domName XSLTProcessor
 class XsltProcessor extends NativeFieldWrapperClass1 {
 
+  ///@docsEditable true
   factory XsltProcessor() => _XsltProcessorFactoryProvider.createXsltProcessor();
   XsltProcessor.internal();
 
 
   /** @domName XSLTProcessor.clearParameters */
   void clearParameters() native "XSLTProcessor_clearParameters_Callback";
 
 
   /** @domName XSLTProcessor.getParameter */
   String getParameter(String namespaceURI, String localName) native "XSLTProcessor_getParameter_Callback";
@@ skipping 4611 matching lines @@
   bool get isEmpty => Maps.isEmpty(this);
 }
 
 get _printClosure => (s) {
   try {
     window.console.log(s);
   } catch (_) {
     _Utils.print(s);
   }
 };