Updating MutationObserver.observe documentation.

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

Index: tools/dom/templates/html/impl/impl_MutationObserver.darttemplate
diff --git a/tools/dom/templates/html/impl/impl_MutationObserver.darttemplate b/tools/dom/templates/html/impl/impl_MutationObserver.darttemplate
index d4125367935a5476a48538af8071eac60a7eaad4..203068ced3b7382dd4442dd4cea627aa7433f568 100644
--- a/tools/dom/templates/html/impl/impl_MutationObserver.darttemplate
+++ b/tools/dom/templates/html/impl/impl_MutationObserver.darttemplate
@@ -19,6 +19,16 @@ $else
 $endif
   }
 
+  /**
+   * Observes the target for the specified changes.

[Andrei Mouravski, 2013/10/24 17:35:51]

Maybe "Observes the target node for DOM changes." (Or say mutations.)

+   *

[Andrei Mouravski, 2013/10/24 17:35:51]

"[childList], ... , and [attributeFilter] configure which mutations are
observed.
If [childList] is `true`, then mutations to [target]'s children are observed.
..."

+   * Some requirements for the optional parameters:
+   *
+   * * Either childList, attributes or characterData must be true.

[Andrei Mouravski, 2013/10/24 17:35:51]

"At least one of [childList]... must be `true`."

+   * * If attributeOldValue is true then attributes must also be true.
+   * * If attributeFilter is specified then attributes must be true.

[Andrei Mouravski, 2013/10/24 17:35:51]

"...must also be `true`."

+   * * If characterDataOldValue is true then characterData must be true.

[Andrei Mouravski, 2013/10/24 17:35:51]

"...must also be `true`."

+   */
   void observe(Node target,
                {bool childList,
                 bool attributes,