Added top level definition to Window.

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 7c3a5c51199ffc0f257dbec90b4c3469fc114031..f5b0e6a6342e60e8f09d3b1ea4eb6a1a0ebba6f3 100644
--- a/sdk/lib/html/dart2js/html_dart2js.dart
+++ b/sdk/lib/html/dart2js/html_dart2js.dart
@@ -22007,6 +22007,22 @@ class _XSLTProcessorFactoryProvider {
 // BSD-style license that can be found in the LICENSE file.
 
 
+/**
+ * Represents the top level context object for web scripting.

[Kathy Walrath, 2012/11/16 16:47:06]

I've been saying that classes should be noun phrases (not verb phrases). Only
methods and functions should be verbs.

So "Represents the" -> "The".

Or, if that's not correct, something like:

An object representing the top-level context for web scripting.

(top-level should be hyphenated since it comes before the noun)

[Andrei Mouravski, 2012/11/16 18:02:16]

Done.

+ *
+ * In a web browser, a [Window] object represents the actual browser window.
+ * In a multi-tabbed browser, each tab has its own [Window] object. A [Window]
+ * is the container that displays a [Document]'s content. All web scripting
+ * happens within the context of a [Window] object.
+ *
+ * **Note:** that this class represents any window, whereas [LocalWindow] is

[Kathy Walrath, 2012/11/16 16:47:06]

that this
-> This

[Andrei Mouravski, 2012/11/16 18:02:16]

Done.

+ * used to access the properties and content of the current window.
+ *
+ * See also:
+ *
+ * * [DOM Window](https://developer.mozilla.org/en-US/docs/DOM/window) from MDN.
+ * * [Window](http://www.w3.org/TR/Window/) from the W3C.
+ */
 abstract class Window {
   // Fields.
   Location get location;