sdk/lib/html/dart2js/html_dart2js.dart

Index: sdk/lib/html/dart2js/html_dart2js.dart
diff --git a/sdk/lib/html/dart2js/html_dart2js.dart b/sdk/lib/html/dart2js/html_dart2js.dart
index d1c969d3da01e4d6c23aea16f69746b645c45948..bdec0790e35f9ae0a27da6385c3f824a5e727ac5 100644
--- a/sdk/lib/html/dart2js/html_dart2js.dart
+++ b/sdk/lib/html/dart2js/html_dart2js.dart
@@ -867,6 +867,11 @@ class Canvas2DContextAttributes extends Interceptor native "Canvas2DContextAttri
 // BSD-style license that can be found in the LICENSE file.
 
 
+/**
+ * A rectangular drawing surface on which scripts can
+ * dynamically render 2-dimensional shapes and bitmap images;
+ * corresponds to the <canvas> tag.
+ */
 @DomName('HTMLCanvasElement')
 class CanvasElement extends HtmlElement implements CanvasImageSource native "HTMLCanvasElement" {
   // To suppress missing implicit constructor warnings.
@@ -6915,10 +6920,11 @@ class DirectoryReader extends Interceptor native "DirectoryReader" {
 
 @DocsEditable()
 /**
- * Represents an HTML <div> element.
+ * A generic container for content on an HTML page;
+ * corresponds to the &lt;div&gt; tag.
  *
- * The [DivElement] is a generic container for content and does not have any
- * special significance. It is functionally similar to [SpanElement].
+ * The [DivElement] is a generic container and does not have any semantic
+ * significance. It is functionally similar to [SpanElement].
  *
  * The [DivElement] is a block-level element, as opposed to [SpanElement],
  * which is an inline-level element.
@@ -10870,6 +10876,11 @@ class ErrorEvent extends Event native "ErrorEvent" {
 // WARNING: Do not edit - generated code.
 
 
+/**
+ * An occurrence, typically asynchronous, within a program;
+ * an event can originate from a variety of sources, such as
+ * a mouse, a completed task, a timer, and so on.
+ */
 @DomName('Event')
 class Event extends Interceptor native "Event" {
   // In JS, canBubble and cancelable are technically required parameters to
@@ -11233,7 +11244,8 @@ class Events {
 }
 
 /**
- * Base class for all browser objects that support events.
+ * A DOM element that initiated an Event; this is the
+ * base class for all browser objects that support events.
  *
  * Use the [on] property to add, and remove events (rather than
  * [$dom_addEventListener] and [$dom_removeEventListener]
@@ -13563,7 +13575,10 @@ class ImageData extends Interceptor native "ImageData" {
 // 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.
 
-
+/**
+ * An HTML element that represents an image;
+ * corresponds to the HTML &lt;img&gt; tag.
+ */
 @DomName('HTMLImageElement')
 class ImageElement extends HtmlElement implements CanvasImageSource native "HTMLImageElement" {
   // To suppress missing implicit constructor warnings.
@@ -13644,7 +13659,10 @@ class ImageElement extends HtmlElement implements CanvasImageSource native "HTML
 // 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 class of HTML widgets that lets the user enter different kinds of data,
+ * including text, dates and times, colors, numbers, and so on.
+ */
 @DomName('HTMLInputElement')
 class InputElement extends HtmlElement implements
     HiddenInputElement,
@@ -16758,6 +16776,10 @@ class ModElement extends HtmlElement native "HTMLModElement" {
 // BSD-style license that can be found in the LICENSE file.
 
 
+/**
+ * A change in the state of a mouse,
+ * such as a button being pressed or the mouse being moved.
+ */
 @DomName('MouseEvent')
 class MouseEvent extends UIEvent native "MouseEvent,DragEvent,PointerEvent,MSPointerEvent" {
   factory MouseEvent(String type,
@@ -17699,7 +17721,11 @@ class TemplateInstance {
   TemplateInstance(this.firstNode, this.lastNode, this.model);
 }
 
-
+/**
+ * An object in the DOM tree (a hierarchical structure that
+ * represents an HTML page); a Node has at most one parent
+ * and can have multiple children.
+ */
 @DomName('Node')
 class Node extends EventTarget native "Node" {
   List<Node> get nodes {