Cleaning up document.query

tools/dom/docs/docs.json

Index: tools/dom/docs/docs.json
diff --git a/tools/dom/docs/docs.json b/tools/dom/docs/docs.json
index 936da3b2685aa5c7eca339bcb0534b7ded8e4ece..084eca428bbd919cd755eb2da93af21bee2bf1ec 100644
--- a/tools/dom/docs/docs.json
+++ b/tools/dom/docs/docs.json
@@ -109,9 +109,6 @@
         "getCSSCanvasContext": [
           "/// Moved to [HtmlDocument]."
         ],
-        "getElementById": [
-          "/// Deprecated: use query(\"#$elementId\") instead."
-        ],
         "head": [
           "/// Moved to [HtmlDocument]."
         ],
@@ -119,7 +116,21 @@
           "/// Moved to [HtmlDocument]."
         ],
         "querySelector": [
-          "/// Deprecated: renamed to the shorter name [query]."
+          "/**",
+          " * Finds the first descendant element of this document that matches the",
+          " * specified group of selectors.",
+          " *",
+          " * Unless your webpage contains multiple documents, the top-level query",
+          " * method behaves the same as this method, so you should use it instead to",
+          " * save typing a few characters.",
+          " *",
+          " * [selectors] should be a string using CSS selector syntax.",
+          " *     var element1 = document.query('.className');",
+          " *     var element2 = document.query('#id');",
+          " *",
+          " * For details about CSS selector syntax, see the",
+          " * [CSS selector specification](http://www.w3.org/TR/css3-selectors/).",
+          " */"
         ],
         "querySelectorAll": [
           "/// Deprecated: use query(\"#$elementId\") instead."
@@ -159,6 +170,29 @@
         ]
       }
     },
+    "Element": {
+      "members": {
+        "querySelector": [
+          "/**",
+          " * Finds the first descendant element of this element that matches the",
+          " * specified group of selectors.",
+          " *",
+          " * [selectors] should be a string using CSS selector syntax.",
+          " *",
+          " *     // Gets the first descendant with the class 'classname'",
+          " *     var element = element.query('.className');",
+          " *     // Gets the element with id 'id'",
+          " *     var element = element.query('#id');",
+          " *     // Gets the first descendant [ImageElement]",
+          " *     var img = element.query('img');",
+          " *",
+          " * See also:",
+          " *",
+          " * * [CSS Selectors](http://docs.webplatform.org/wiki/css/selectors)",
+          " */"
+        ]
+      }
+    },
     "HTMLAreaElement": {
       "comment": [
         "/**",
@@ -549,4 +583,4 @@
       }
     }
   }
-}
+}