Minor tweaks

Author: domenic

source

@@ -66791,6 +66791,11 @@ dictionary <dfn>ElementDefinitionOptions</dfn> {
    <li><p>Set this <code>CustomElementRegistry</code>'s <span>element definition is running</span>
    flag.</p></li>
 
+   <li><p>Let <var>disableInternals</var> be false.
+
+   <li><p>Let <var>observedAttributes</var> be an empty <code
+   data-x="">sequence&lt;DOMString></code>.</p></li>
+
    <li>
     <p>Run the following substeps while catching any exceptions:</p>
 
@@ -66822,9 +66827,6 @@ dictionary <dfn>ElementDefinitionOptions</dfn> {
       </ol>
      </li>
 
-     <li><p>Let <var>observedAttributes</var> be an empty <code
-     data-x="">sequence&lt;DOMString></code>.</p></li>
-
      <li>
       <p>If the value of the entry in <var>lifecycleCallbacks</var> with key "<code
       data-x="">attributeChangedCallback</code>" is not null, then:</p>
@@ -66841,20 +66843,20 @@ dictionary <dfn>ElementDefinitionOptions</dfn> {
        conversion.</p></li>
       </ol>
 
-     <li><p>Let <var>disabledFeatures</var> be
-     <span data-x="js-Get">Get</span>(<var>constructor</var>, "disabledFeatures"). Rethrow any
-     exceptions.</p></li>
+     <li><p>Let <var>disabledFeatures</var> be an empty <code
+      data-x="">sequence&lt;DOMString></code>.</p></li>
 
-     <li><p>If <var>disabledFeatures</var> is not undefined, then set
-     <var>disabledFeaturesSequence</var> to the result of
-     <span data-x="concept-idl-convert">converting</span> <var>disabledFeatures</var> to a
-     <code data-x="">sequence&lt;DOMString></code>. Rethrow any exceptions from the
-     conversion.</p></li>
+     <li><p>Let <var>disabledFeaturesIterable</var> be <span
+     data-x="js-Get">Get</span>(<var>constructor</var>, "disabledFeatures"). Rethrow any
+     exceptions.</p></li>
 
-     <li><p>Let <var>disableInternals</var> be false.
+     <li><p>If <var>disabledFeaturesIterable</var> is not undefined, then set
+     <var>disabledFeatures</var> to the result of <span
+     data-x="concept-idl-convert">converting</span> <var>disabledFeaturesIterable</var> to a <code
+     data-x="">sequence&lt;DOMString></code>. Rethrow any exceptions from the conversion.</p></li>
 
      <li><p>Set <var>disableInternals</var> to true if <var>disabledFeaturesSequence</var> contains
-     <code data-x="">"internals"</code>.</p></li>
+     "<code data-x="">internals</code>".</p></li>
     </ol>
 
     <p>Then, perform the following substep, regardless of whether the above steps threw an exception
@@ -67456,8 +67458,11 @@ customElements.define("x-foo", class extends HTMLElement {
 
   <dl class="domintro">
    <dt><var>element</var> . <code subdfn data-x="dom-attachInternals">attachInternals()</code></dt>
-   <dd><p>Returns an <code>ElementInternals</code> object targeting the <var>element</var>.
-   This function throws an exception if it is called for the same <var>element</var> again.</p></dd>
+
+   <dd><p>Returns an <code>ElementInternals</code> object targeting the the <span>custom
+   element</span> <var>element</var>. Throws an exception if <var>element</var> is not a
+   <span>custom element</span>, if the "<code data-x="">internals</code>" feature was disabled as
+   part of the element definition, or if it is called twice on the same element.</p></dd>
   </dl>
 
   <pre><code class="idl" data-x="">[Exposed=Window]
@@ -67469,7 +67474,7 @@ interface <dfn>ElementInternals</dfn> {
 
   <p>Each <code>ElementInternals</code> has a <dfn data-x="internals-target">target element</dfn>,
   which is a <span>custom element</span>.  <code>ElementInternals</code> provides various operations
-  and attributes to allow control over internals features which the user agent provides to all
+  and attributes to allow control over internal features which the user agent provides to all
   elements.</p>
 
   <p>Each <code>HTMLElement</code> has an <dfn>attached internals</dfn> boolean, initially
@@ -67479,6 +67484,7 @@ interface <dfn>ElementInternals</dfn> {
   an <code>HTMLElement</code> <var>element</var>, when invoked, must run the following steps:</p>
 
   <ol>
+   <!-- We could lift this restriction in the future. -->
    <li><p>If <var>element</var>'s <span data-x="concept-element-is-value"><code
    data-x="">is</code> value</span> is not null, then throw a
    <span>"<code>NotSupportedError</code>"</span> <code>DOMException</code>.</p></li>