EventListenerOptions: Rename 'normalize' to 'flatten'

Author: RByers

dom.bs

@@ -1049,7 +1049,7 @@ seen from the definition above, an <a>event listener</a> is a more broad concept
  {{Event/preventDefault()}} method was not invoked, and false otherwise.
 </dl>
 
-<p>To <dfn export for=Event id=concept-normalize-options>normalize</dfn> <var>options</var> run these steps:
+<p>To <dfn export for=Event id=concept-flatten-options>flatten</dfn> <var>options</var> run these steps:
 
 <ol>
  <li>Let <var>capture</var> and <var>passive</var> be false.
@@ -1073,7 +1073,7 @@ method, when invoked, must run these steps:
 <ol>
  <li><p>If <var>callback</var> is null, terminate these steps.
 
- <li>Let <var>capture</var> and <var>passive</var> be the result of <a>normalizing</a> <var>options</var>.
+ <li>Let <var>capture</var> and <var>passive</var> be the result of <a>flattening</a> <var>options</var>.
 
  <li><p>Append an <a>event listener</a> to the associated list of <a>event listeners</a> with
  <b>type</b> set to <var>type</var>, <b>callback</b> set to <var>callback</var>, <b>capture</b>
@@ -1087,7 +1087,7 @@ method, when invoked, must run these steps:
 method, when invoked, must, run these steps
 
 <ol>
- <li>Let <var>capture</var> and <var>passive</var> be the result of <a>normalizing</a> <var>options</var>.
+ <li>Let <var>capture</var> and <var>passive</var> be the result of <a>flattening</a> <var>options</var>.
 
  <li>If there is an <a>event listener</a> in the associated list of
  <a>event listeners</a> whose <b>type</b> is <var>type</var>, <b>callback</b> is <var>callback</var>,

dom.html

@@ -537,7 +537,7 @@ <h3 class="heading settled" data-level="3.2" id="interface-event"><span class="s
  signals to the operation that caused <var>event</var> to be <a data-link-type="dfn" href="#concept-event-dispatch">dispatched</a> that it needs to be
  canceled. 
     <dt><code><var>event</var> . <code class="idl"><a data-link-type="idl" href="#dom-event-defaultprevented">defaultPrevented</a></code></code> 
-    <dd>Returns true if <code class="idl"><a data-link-type="idl" href="#dom-event-preventdefault">preventDefault()</a></code> was invoked successfully to indicate cancellation. 
+    <dd>Returns true if <code class="idl"><a data-link-type="idl" href="#dom-event-preventdefault">preventDefault()</a></code> was invoked successfully to indicate cancellation, and false otherwise. 
     <dt><code><var>event</var> . <code class="idl"><a data-link-type="idl" href="#dom-event-istrusted">isTrusted</a></code></code> 
     <dd>Returns true if <var>event</var> was <a data-link-type="dfn" href="#concept-event-dispatch">dispatched</a> by the user agent, and
  false otherwise. 
@@ -584,7 +584,7 @@ <h3 class="heading settled" data-level="3.2" id="interface-event"><span class="s
    <p>The <dfn class="idl-code" data-dfn-for="Event" data-dfn-type="method" data-export="" id="dom-event-preventdefault">preventDefault()<a class="self-link" href="#dom-event-preventdefault"></a></dfn> method must set the <a data-link-type="dfn" href="#canceled-flag">canceled flag</a> if the <code class="idl"><a data-link-type="idl" href="#dom-event-cancelable">cancelable</a></code> attribute value is true and
 the <a data-link-type="dfn" href="#in-passive-listener-flag">in passive listener flag</a> is unset.</p>
    <p class="note no-backref" role="note"> This means there are scenarios where invoking <code class="idl"><a data-link-type="idl" href="#dom-event-preventdefault">preventDefault()</a></code> has no effect.
- User agents are encouraged to log the precise cause in a developer console, 
+ User agents are encouraged to log the precise cause in a developer console,
  to aid debugging </p>
    <p>The <dfn class="idl-code" data-dfn-for="Event" data-dfn-type="attribute" data-export="" id="dom-event-defaultprevented">defaultPrevented<a class="self-link" href="#dom-event-defaultprevented"></a></dfn> attribute must return true if the <a data-link-type="dfn" href="#canceled-flag">canceled flag</a> is set and
 false otherwise.</p>
@@ -719,7 +719,7 @@ <h3 class="heading settled" data-level="3.6" id="interface-eventtarget"><span cl
     <dd><a data-link-type="dfn" href="#concept-event-dispatch">Dispatches</a> a synthetic event <var>event</var> to <var>target</var> and returns
  true if either <var>event</var>’s <code class="idl"><a data-link-type="idl" href="#dom-event-cancelable">cancelable</a></code> attribute value is false or its <code class="idl"><a data-link-type="idl" href="#dom-event-preventdefault">preventDefault()</a></code> method was not invoked, and false otherwise. 
    </dl>
-   <p>To <dfn data-dfn-for="Event" data-dfn-type="dfn" data-export="" id="concept-normalize-options">normalize<a class="self-link" href="#concept-normalize-options"></a></dfn> <var>options</var> run these steps: </p>
+   <p>To <dfn data-dfn-for="Event" data-dfn-type="dfn" data-export="" id="concept-flatten-options">flatten<a class="self-link" href="#concept-flatten-options"></a></dfn> <var>options</var> run these steps: </p>
    <ol>
     <li>Let <var>capture</var> and <var>passive</var> be false. 
     <li>If <var>options</var> is a boolean, set <var>capture</var> to <var>options</var>. 
@@ -733,14 +733,14 @@ <h3 class="heading settled" data-level="3.6" id="interface-eventtarget"><span cl
    <ol>
     <li>
      <p>If <var>callback</var> is null, terminate these steps. </p>
-    <li>Let <var>capture</var> and <var>passive</var> be the result of <a data-link-type="dfn" href="#concept-normalize-options">normalizing</a> <var>options</var>. 
+    <li>Let <var>capture</var> and <var>passive</var> be the result of <a data-link-type="dfn" href="#concept-flatten-options">flattening</a> <var>options</var>. 
     <li>
      <p>Append an <a data-link-type="dfn" href="#concept-event-listener">event listener</a> to the associated list of <a data-link-type="dfn" href="#concept-event-listener">event listeners</a> with <b>type</b> set to <var>type</var>, <b>callback</b> set to <var>callback</var>, <b>capture</b> set to <var>capture</var>, and <b>passive</b> set to <var>passive</var> unless there
  already is an <a data-link-type="dfn" href="#concept-event-listener">event listener</a> in that list with the same <b>type</b>, <b>callback</b>, <b>capture</b>, and <b>passive</b>. </p>
    </ol>
    <p>The <dfn class="idl-code" data-dfn-for="EventTarget" data-dfn-type="method" data-export="" data-lt="removeEventListener(type, callback, options)|removeEventListener(type, callback)" id="dom-eventtarget-removeeventlistener"><code>removeEventListener(<var>type</var>, <var>callback</var>, <var>options</var>)</code><a class="self-link" href="#dom-eventtarget-removeeventlistener"></a></dfn> method, when invoked, must, run these steps </p>
    <ol>
-    <li>Let <var>capture</var> and <var>passive</var> be the result of <a data-link-type="dfn" href="#concept-normalize-options">normalizing</a> <var>options</var>. 
+    <li>Let <var>capture</var> and <var>passive</var> be the result of <a data-link-type="dfn" href="#concept-flatten-options">flattening</a> <var>options</var>. 
     <li>If there is an <a data-link-type="dfn" href="#concept-event-listener">event listener</a> in the associated list of <a data-link-type="dfn" href="#concept-event-listener">event listeners</a> whose <b>type</b> is <var>type</var>, <b>callback</b> is <var>callback</var>, <b>capture</b> is <var>capture</var>, and <b>passive</b> is <var>passive</var> then
  set that <a data-link-type="dfn" href="#concept-event-listener">event listener</a>’s <b>removed flag</b> and remove it from the
  associated list of <a data-link-type="dfn" href="#concept-event-listener">event listeners</a>. 
@@ -4844,6 +4844,7 @@ <h3 class="no-num heading settled" id="index-defined-here"><span class="content"
    <li><a href="#dom-node-firstchild">firstChild</a><span>, in §4.4</span>
    <li><a href="#concept-tree-first-child">first child</a><span>, in §2.1</span>
    <li><a href="#dom-parentnode-firstelementchild">firstElementChild</a><span>, in §4.2.3</span>
+   <li><a href="#concept-flatten-options">flatten</a><span>, in §3.6</span>
    <li><a href="#concept-tree-following">following</a><span>, in §2.1</span>
    <li><a href="#concept-element-attributes-get-by-name">get an attribute by name</a><span>, in §4.8</span>
    <li><a href="#concept-element-attributes-get-by-namespace">get an attribute by namespace and local name</a><span>, in §4.8</span>
@@ -5057,7 +5058,6 @@ <h3 class="no-num heading settled" id="index-defined-here"><span class="content"
    <li><a href="#dom-event-none">NONE</a><span>, in §3.2</span>
    <li><a href="#nonelementparentnode">NonElementParentNode</a><span>, in §4.2.2</span>
    <li><a href="#concept-document-no-quirks">no-quirks mode</a><span>, in §4.5</span>
-   <li><a href="#concept-normalize-options">normalize</a><span>, in §3.6</span>
    <li><a href="#dom-node-normalize">normalize()</a><span>, in §4.4</span>
    <li><a href="#dom-document-normalizedocument">normalizeDocument()</a><span>, in §8.2</span>
    <li><a href="#notation">Notation</a><span>, in §8.2</span>