Added some more documentation to top level Window.

tools/dom/templates/html/dart2js/html_dart2js.darttemplate

Index: tools/dom/templates/html/dart2js/html_dart2js.darttemplate
diff --git a/tools/dom/templates/html/dart2js/html_dart2js.darttemplate b/tools/dom/templates/html/dart2js/html_dart2js.darttemplate
index 89cc40e59937a17ea35fe312e16d268c56e4c874..89c40124a8be4db5fd01411b40f0bc2bdf59a9c7 100644
--- a/tools/dom/templates/html/dart2js/html_dart2js.darttemplate
+++ b/tools/dom/templates/html/dart2js/html_dart2js.darttemplate
@@ -63,7 +63,20 @@ part '$AUXILIARY_DIR/_ListIterators.dart';
 
 
 /**
- * The top-level Window object.
+ * The current window.

[Kathy Walrath, 2013/07/11 17:15:35]

You don't want to confuse an on-screen window with the window object. So maybe
instead:

The top-level window object, which represents this web page's container (a tab
or the tab's window, usually).

[Andrei Mouravski, 2013/07/11 18:20:46]

Done.

+ *
+ * Each web page loaded in the browser has its own [Window], which is a
+ * container for the web page.
+ *
+ * Each page's [Window] has an associated [HtmlDocument] that represents the

[Kathy Walrath, 2013/07/11 17:15:35]

Why is this paragraph here? Either delete it or make the relationship clearer.

It seems like maybe this should be removed and the document description should
be:

The top-level document, representing the content of this page.

[Andrei Mouravski, 2013/07/11 18:20:46]

Done.

+ * content of the page.
+ *
+ * This getter usually retuns the only [Window] on the page, but any `<iframe>`

[Kathy Walrath, 2013/07/11 17:15:35]

retuns -> returns

Maybe combine this into the previous paragraph?

+ * elements have their own [Window].
+ *
+ * See also:
+ *
+ *   * [Window](https://developer.mozilla.org/en-US/docs/Web/API/window) from MDN.
  */
 Window get window => JS('Window', 'window');

[blois, 2013/07/11 17:03:57]

Can you duplicate this into the Dartium version as well?