Add [CEReactions] annotations

domenic · domenic · commit cf9b0ada338a · 2016-04-20T14:32:37.000-04:00
This is part of the effort in WICG/webcomponents#186 to annotate all parts of the platform that cause DOM mutations and thus need to set up state for custom element reactions. [CEReactions] is defined in https://html.spec.whatwg.org/multipage/scripting.html#cereactions. Also normalizes whitespace to spaces instead of a mix of spaces and tabs.
diff --git a/index.html b/index.html
@@ -3,76 +3,76 @@
 <head>
     <meta charset=UTF-8>
     <title>DOM Parsing and Serialization</title>
-    <style>
-        /* Make these stand-out more... */
-        .externalDFN {
-            font-style: italic;
-            background-color: #fff9d6;
-        }
-        /* Switch statement */
-        dl.switch dt::before {
-            content: "↪ ";
-            margin-left: 1em;
-        }
-        /* Better spacing around various lists (implied paragraph children) */
-        ol > li, section:not(#toc) ul > li, section dl > dt {
-            margin: 1em 0;
+    <style>
+        /* Make these stand-out more... */
+        .externalDFN {
+            font-style: italic;
+            background-color: #fff9d6;
+        }
+        /* Switch statement */
+        dl.switch dt::before {
+            content: "↪ ";
+            margin-left: 1em;
+        }
+        /* Better spacing around various lists (implied paragraph children) */
+        ol > li, section:not(#toc) ul > li, section dl > dt {
+            margin: 1em 0;
+        }
+        var { color: maroon; }
+        /* domintro styling */
+        dl.domintro {
+            background-color: rgb(221, 255, 221);
+            padding: 1em 0.5em 1em 2em;
+            clear: both;
+        }
+        dl.domintro dt {
+            color: black;
+        }
+        dl.domintro > dd {
+            color: green;
+        }
+        dl.domintro::before {
+            float: right;
+            background-color: white;
+            display: block;
+            border: 2px solid black;
+            color: green;
+            margin-top: -20px;
+            padding: 2px;
+            content: "This box is non-normative. Implementation requirements are given below this box.";
+        }
+        /* Fancy table stuff */
+        table {
+            border-collapse: collapse;
+        }
+        thead tr {
+            border-bottom: 2px solid black;
+        }
+        tbody tr:not(:last-child) {
+            border-bottom: 1px solid black;
+        }
+        td {
+            border-left: 1px solid black;
+            padding: 4px;
+        }
+        /* Extra IDL :-) */
+        .extraidl {
+            line-height: 120%;
+            padding: 1em;
+            border-top: 1px solid #90b8de;
+            border-bottom: 1px solid #90b8de;
+        }
+        .extraidl:before {
+            width: 150px;
+            color: #fff;
+            padding: 3px;
+            font-weight: bold;
+            font-family: initial;
+            margin: -1em 0 1em -1em;
+            display: block;
+            content: "WebIDL";
+            background-color: rgb(144, 184, 222);
         }
-        var { color: maroon; }
-        /* domintro styling */
-        dl.domintro {
-            background-color: rgb(221, 255, 221);
-            padding: 1em 0.5em 1em 2em;
-            clear: both;
-        }
-        dl.domintro dt {
-            color: black;
-        }
-        dl.domintro > dd {
-            color: green;
-        }
-        dl.domintro::before {
-            float: right;
-            background-color: white;
-            display: block;
-            border: 2px solid black;
-            color: green;
-            margin-top: -20px;
-            padding: 2px;
-            content: "This box is non-normative. Implementation requirements are given below this box.";
-        }
-        /* Fancy table stuff */
-        table {
-            border-collapse: collapse;
-        }
-        thead tr {
-            border-bottom: 2px solid black;
-        }
-        tbody tr:not(:last-child) {
-            border-bottom: 1px solid black;
-        }
-        td {
-            border-left: 1px solid black;
-            padding: 4px;
-        }
-        /* Extra IDL :-) */
-        .extraidl {
-            line-height: 120%;
-            padding: 1em;
-            border-top: 1px solid #90b8de;
-            border-bottom: 1px solid #90b8de;
-        }
-        .extraidl:before {
-            width: 150px;
-            color: #fff;
-            padding: 3px;
-            font-weight: bold;
-            font-family: initial;
-            margin: -1em 0 1em -1em;
-            display: block;
-            content: "WebIDL";
-            background-color: rgb(144, 184, 222);
-        }
     </style>
     <script type="text/javascript" src='https://www.w3.org/Tools/respec/respec-w3c-common' class='remove' async></script>
     <script type="text/javascript" src="respecConfig.js" class='remove'></script>
@@ -94,14 +94,14 @@
 
     <section id="crec" class="introductory">
         <h2>Candidate Recommendation Exit Criteria</h2>
-        <p>This specification will not advance to Proposed Recommendation before the spec's 
-            <a href="http://w3c-test.org/domparsing/">test suite</a> is completed and two or 
-            more independent implementations pass each test, although no single implementation 
+        <p>This specification will not advance to Proposed Recommendation before the spec's
+            <a href="http://w3c-test.org/domparsing/">test suite</a> is completed and two or
+            more independent implementations pass each test, although no single implementation
             must pass each test. We expect to meet this criteria no sooner than 24 October 2014.
-            The group will also create an 
+            The group will also create an
             <a href="https://dvcs.w3.org/hg/innerhtml/raw-file/tip/implementationReport.html">Implementation Report</a>.
     </section>
-    
+
     <!-- <section id="issues" class="introductory">
         <h1>Issues</h1>
 
@@ -1023,9 +1023,9 @@ <h1>The <code>DOMParser</code> interface</h1>
     <p>The <dfn title="dom-domparser"><code>DOMParser()</code></dfn> constructor
     must return a new <code>DOMParser</code> object.
 
-    <dl class="idl" title="[Constructor] interface DOMParser">
-        <dt>[NewObject] Document parseFromString(DOMString str, SupportedType type)</dt>
-        <dd>
+    <dl class="idl" title="[Constructor] interface DOMParser">
+        <dt>[CEReactions, NewObject] Document parseFromString(DOMString str, SupportedType type)</dt>
+        <dd>
             <p>The
             <dfn title="dom-domparser-parsefromstring"><code>parseFromString(<var>str</var>, <var>type</var>)</code></dfn>
             method must run these steps, depending on <var>type</var>:
@@ -1111,8 +1111,8 @@ <h1>The <code>DOMParser</code> interface</h1>
             <p class=note>The returned
             <a title="concept-document" data-spec="DOM4" class="externalDFN">document</a>'s
             <a title="concept-document-encoding" data-spec="DOM4" class="externalDFN">encoding</a> is
-            the default, UTF-8.
-        </dd>
+            the default, UTF-8.
+        </dd>
     </dl>
 </section>
 
@@ -1122,21 +1122,21 @@ <h1>The <code>XMLSerializer</code> interface</h1>
     <p>The <dfn title="dom-xmlserializer"><code>XMLSerializer()</code></dfn>
     constructor must return a new <code>XMLSerializer</code> object.
 
-    <dl class="idl" title="[Constructor] interface XMLSerializer">
-        <dt>DOMString serializeToString(Node root)</dt>
-
+    <dl class="idl" title="[Constructor] interface XMLSerializer">
+        <dt>DOMString serializeToString(Node root)</dt>
+
         <dd>The <dfn title="dom-xmlserializer-serializetostring"><code>serializeToString(<var>root</var>)</code></dfn>
         method must <a title="concept-serialize-xml">produce an XML serialization</a> of <var>root</var> passing
-        a value of <code>false</code> for the <a title="concept-well-formed">require well-formed</a> parameter, and return the result.</dd>
+        a value of <code>false</code> for the <a title="concept-well-formed">require well-formed</a> parameter, and return the result.</dd>
     </dl>
 </section>
 
 <section>
     <h1>Extensions to the <code><a title="element" data-spec="DOM4" class="externalDFN">Element</a></code> interface</h1>
 
-    <dl class="idl" title="partial interface Element">
-        <dt>[TreatNullAs=EmptyString] attribute DOMString innerHTML</dt>
-        <dd>
+    <dl class="idl" title="partial interface Element">
+        <dt>[CEReactions, TreatNullAs=EmptyString] attribute DOMString innerHTML</dt>
+        <dd>
             <p>The <dfn title="dom-element-innerhtml"><code>innerHTML</code></dfn> IDL
             attribute represents the markup of the
             <code><a title="element" data-spec="DOM4" class="externalDFN">Element</a></code>'s contents.
@@ -1195,12 +1195,12 @@ <h1>Extensions to the <code><a title="element" data-spec="DOM4" class="externalD
 
                 <li><a data-spec="DOM4" title="concept-node-replace-all" class="externalDFN">Replace all</a>
                 with <var>fragment</var> within the <a title="context object">context object</a>.
-            </ol>
-        </dd>
-
-        <!-- outerHTML -->
-        <dt>[TreatNullAs=EmptyString] attribute DOMString outerHTML</dt>
-        <dd>
+            </ol>
+        </dd>
+
+        <!-- outerHTML -->
+        <dt>[CEReactions, TreatNullAs=EmptyString] attribute DOMString outerHTML</dt>
+        <dd>
             <p>The <dfn title="dom-element-outerhtml"><code>outerHTML</code></dfn> IDL
             attribute represents the markup of the
             <code><a title="element" data-spec="DOM4" class="externalDFN">Element</a></code> and its contents.
@@ -1278,12 +1278,12 @@ <h1>Extensions to the <code><a title="element" data-spec="DOM4" class="externalD
                 the <a title="context object">context object</a> with <var>fragment</var> within
                 the <a title="context object">context object</a>'s
                 <a data-spec="DOM4" title="concept-tree-parent" class="externalDFN">parent</a>.
-            </ol>
-        </dd>
-
-        <!-- insertAdjacentHTML -->
-        <dt>void insertAdjacentHTML(DOMString position, DOMString text)</dt>
-        <dd>
+            </ol>
+        </dd>
+
+        <!-- insertAdjacentHTML -->
+        <dt>[CEReactions] void insertAdjacentHTML(DOMString position, DOMString text)</dt>
+        <dd>
              <dl class=domintro>
                   <dt><var>element</var> . <code title="dom-element-insertadjacenthtml">insertAdjacentHTML</code>(<var>position</var>, <var>text</var>)
 
@@ -1436,9 +1436,9 @@ <h1>Extensions to the <code><a title="element" data-spec="DOM4" class="externalD
                     before the <a title="context object">context object</a>'s
                     <a data-spec="DOM4" title="concept-tree-next-sibling" class="externalDFN">next sibling</a>.
                 </dl>
-            </ol>
-        </dd>
-
+            </ol>
+        </dd>
+
     </dl>
 </section>
 
@@ -1448,9 +1448,9 @@ <h1>Extensions to the <code><a title="element" data-spec="DOM4" class="externalD
 <section>
     <h1>Extensions to the <code><a title="text" data-spec="DOM4" class="externalDFN">Text</a></code> interface</h1>
 
-    <dl class="idl" title="partial interface Text">
-        <dt>attribute boolean serializeAsCDATA</dt>
-        <dd>
+    <dl class="idl" title="partial interface Text">
+        <dt>attribute boolean serializeAsCDATA</dt>
+        <dd>
             <dl class=domintro>
               <dt><var>text</var> .
                   <code title="dom-text-serializeascdata">serializeAsCDATA</code> [ = <var>value</var> ]
@@ -1468,18 +1468,18 @@ <h1>Extensions to the <code><a title="text" data-spec="DOM4" class="externalDFN"
             <p>Setting the <code title="dom-text-serializeascdata">serializeAsCDATA</code>
             attribute must, if the new value is true, set the
             <a title="context object">context object</a>'s <a>serialize as CDATA flag</a>, or unset
-            it otherwise.
-        </dd>
+            it otherwise.
+        </dd>
     </dl>
 </section>
 -->
 
 <section>
     <h1>Extensions to the <code><a data-spec="DOM4" title="range" class="externalDFN">Range</a></code> interface</h1>
 
-    <dl class="idl" title="partial interface Range">
-        <dt>[NewObject] DocumentFragment createContextualFragment(DOMString fragment)</dt>
-        <dd>
+    <dl class="idl" title="partial interface Range">
+        <dt>[CEReactions, NewObject] DocumentFragment createContextualFragment(DOMString fragment)</dt>
+        <dd>
             <dl class=domintro>
               <dt><var>docFragment</var> = <var>range</var> . <code title="dom-range-createcontextualfragment">createContextualFragment</code>(<var>markupString</var>)
               <dd>Returns a <code><a title="documentfragment" data-spec="DOM4" class="externalDFN">DocumentFragment</a></code>, created
@@ -1554,18 +1554,18 @@ <h1>Extensions to the <code><a data-spec="DOM4" title="range" class="externalDFN
 
                 <li>Return the value of <var>fragment node</var>.
             </ol>
-        </dd>
+        </dd>
     </dl>
 </section>
 
 <section class="appendix">
     <h1>Revision History</h1>
-    <p>The following is an informative summary of the changes since the last publication of this 
-        specification. A complete revision history of the Editor's Drafts of this specification 
+    <p>The following is an informative summary of the changes since the last publication of this
+        specification. A complete revision history of the Editor's Drafts of this specification
         can be found <a href="https://dvcs.w3.org/hg/innerhtml/summary/">here</a>.</p>
-    
+
     <ul>
-       <li><a href="https://dvcs.w3.org/hg/innerhtml/raw-file/tip/LC2_comments.html">Incorporated 
+       <li><a href="https://dvcs.w3.org/hg/innerhtml/raw-file/tip/LC2_comments.html">Incorporated
         non-normative changes from previous Last Call document.</a>
     </ul>
 </section>
@@ -1613,4 +1613,4 @@ <h1>Acknowledgements</h1>
       } catch (ex) { alert(ex); }
    </script>
 </body>
-</html>
+</html>
