Making Document, Element and Window documentable via @DocsEditable

tools/dom/templates/html/impl/impl_Document.darttemplate

 // 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.
 
 part of $LIBRARYNAME;
 
-/**
- * The base class for all documents.
- *
- * Each web page loaded in the browser has its own [Document] object, which is
- * typically an [HtmlDocument].
- *
- * If you aren't comfortable with DOM concepts, see the Dart tutorial
- * [Target 2: Connect Dart & HTML](http://www.dartlang.org/docs/tutorials/connect-dart-html/).
- */
+@DocsEditable

[Emily Fortuna, 2013/09/14 03:47:43]

is this really an improvement? I think it's nice to see what docs are there
right next to the hand-written custom code

 $(ANNOTATIONS)$(CLASS_MODIFIERS)class $CLASSNAME extends Node $NATIVESPEC
 {
 
 $!MEMBERS
 
   /**
    * Finds all descendant elements of this document that match the specified
    * group of selectors.
    *
    * Unless your webpage contains multiple documents, the top-level queryAll
@@ skipping 12 matching lines @@
 
   /// Checks if [register] is supported on the current platform.
   bool get supportsRegister {
 $if DART2JS
     return JS('bool', '("register" in #)', this);
 $else
     return true;
 $endif
   }
 }