Skip to content

Commit

Permalink
Meta: stop using Ignored Vars
Browse files Browse the repository at this point in the history
  • Loading branch information
annevk committed Mar 18, 2017
1 parent 334428f commit c91a0d3
Showing 1 changed file with 21 additions and 21 deletions.
42 changes: 21 additions & 21 deletions dom.bs
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,6 @@ No Editor: true
Logo: https://resources.whatwg.org/logo-dom.svg
Abstract: DOM defines a platform-neutral model for events and node trees.
Ignored Terms: EmptyString, Array, Document
Ignored Vars: p, documentFragment, ev, oldParent, em, processingInstruction, obj, tree, insertedNode, removedNode, C, *, intersects, collapsed
Boilerplate: omit feedback-header, omit conformance
</pre>

Expand Down Expand Up @@ -161,7 +160,7 @@ An object <var>A</var> is called a
<var>B</var>, if either <var>A</var> is a
<a for=tree>child</a> of <var>B</var> or
<var>A</var> is a <a for=tree>child</a> of an
object <var>C</var> that is a
object <var ignore>C</var> that is a
<a>descendant</a> of <var>B</var>.

An
Expand Down Expand Up @@ -389,7 +388,7 @@ method, passing the same arguments.

<a>Events</a> are objects too and implement the
{{Event}} interface (or a derived interface). In the example above
<var>ev</var> is the <a>event</a>. It is
<var ignore>ev</var> is the <a>event</a>. It is
passed as argument to
<a>event listener</a>'s <b>callback</b>
(typically a JavaScript Function as shown above).
Expand All @@ -401,7 +400,7 @@ passed as argument to
{{Event/target}} attribute value returns the
object to which the <a>event</a> was
<a>dispatched</a>
(<var>obj</var> above).
(<var ignore>obj</var> above).

<p id="synthetic-events">Now while typically <a>events</a> are <a>dispatched</a> by the user agent
as the result of user interaction or the completion of some task, applications can <a>dispatch</a>
Expand Down Expand Up @@ -925,7 +924,7 @@ feedback from the <a href=https://whatwg.org/>WHATWG</a> or the
<a href=https://www.w3.org/2008/webapps/>W3C WebApps WG</a> community.

The {{CustomEvent}} interface can be used as starting point.
However, do not introduce any <code>init<var>*</var>Event()</code>
However, do not introduce any <code>init<var ignore>*</var>Event()</code>
methods as they are redundant with constructors. Interfaces that inherit
from the {{Event}} interface that have such a method only have it
for historical reasons.
Expand Down Expand Up @@ -1953,8 +1952,9 @@ of a <var>node</var> into a <var>parent</var> before a <var>child</var>, run the
</ol>

<p><a lt="Other applicable specifications">Specifications</a> may define
<dfn export id=concept-node-insert-ext>insertion steps</dfn> for all or some <a>nodes</a>.
The algorithm is passed <var>insertedNode</var>, as indicated in the <a>insert</a> algorithm below.
<dfn export id=concept-node-insert-ext>insertion steps</dfn> for all or some <a>nodes</a>. The
algorithm is passed <var ignore>insertedNode</var>, as indicated in the <a>insert</a> algorithm
below.
<!-- See https://github.com/whatwg/dom/issues/34#issuecomment-125571750 for why we might need to
adjust this further based on the requirements of the script element. There might be other ways
to define that though as Olli suggests, so leaving that out for now. -->
Expand Down Expand Up @@ -2237,8 +2237,8 @@ To <dfn export id=concept-node-pre-remove>pre-remove</dfn> a <var>child</var> fr

<p><a lt="Other applicable specifications">Specifications</a> may define
<dfn export id=concept-node-remove-ext>removing steps</dfn> for all or some <a>nodes</a>. The
algorithm is passed <var>removedNode</var>, and optionally <var>oldParent</var>, as indicated in the
<a>remove</a> algorithm below.
algorithm is passed <var ignore>removedNode</var>, and optionally <var ignore>oldParent</var>, as
indicated in the <a>remove</a> algorithm below.

<p>To <dfn export id=concept-node-remove>remove</dfn> a <var>node</var> from a <var>parent</var>,
with an optional <i>suppress observers flag</i>, run these steps:
Expand Down Expand Up @@ -4815,22 +4815,22 @@ for the <a>context object</a>.
When supplied, <var>options</var>' <code>is</code> member can be used to create a
<a>customized built-in element</a>.

<dt><code><var>documentFragment</var> = <var>document</var> . {{createDocumentFragment()}}</code>
<dt><code><var ignore>documentFragment</var> = <var>document</var> . {{createDocumentFragment()}}</code>
<dd>Returns a {{DocumentFragment}}
<a>node</a>.

<dt><code><var>text</var> = <var>document</var> . {{createTextNode(data)}}</code>
<dt><code><var ignore>text</var> = <var>document</var> . {{createTextNode(data)}}</code>
<dd>Returns a {{Text}} <a>node</a>
whose <a for=CharacterData>data</a> is <var>data</var>.

<dt><code><var>text</var> = <var>document</var> . {{createCDATASection(data)}}</code>
<dt><code><var ignore>text</var> = <var>document</var> . {{createCDATASection(data)}}</code>
<dd>Returns a {{CDATASection}} <a>node</a> whose <a for=CharacterData>data</a> is <var>data</var>.

<dt><code><var>comment</var> = <var>document</var> . {{createComment(data)}}</code>
<dt><code><var ignore>comment</var> = <var>document</var> . {{createComment(data)}}</code>
<dd>Returns a {{Comment}} <a>node</a>
whose <a for=CharacterData>data</a> is <var>data</var>.

<dt><code><var>processingInstruction</var> = <var>document</var> . {{createProcessingInstruction(target, data)}}</code>
<dt><code><var ignore>processingInstruction</var> = <var>document</var> . {{createProcessingInstruction(target, data)}}</code>
<dd>
Returns a {{ProcessingInstruction}}
<a>node</a> whose
Expand Down Expand Up @@ -5421,7 +5421,7 @@ concept is useful for HTML's <{template}> element and for <a for=/>shadow roots<
<a>pre-insert</a> and <a>replace</a> algorithms.

<dl class=domintro>
<dt><code><var>tree</var> = new {{DocumentFragment()}}</code>
<dt><code><var ignore>tree</var> = new {{DocumentFragment()}}</code>
<dd>Returns a new {{DocumentFragment}} <a>node</a>.
</dl>

Expand Down Expand Up @@ -7101,7 +7101,7 @@ interface Comment : CharacterData {
</pre>

<dl class=domintro>
<dt><code><var>comment</var> = new <a constructor lt="Comment()">Comment([<var>data</var> = ""])</a></code>
<dt><code><var ignore>comment</var> = new <a constructor lt="Comment()">Comment([<var>data</var> = ""])</a></code>
<dd>Returns a new {{Comment}} <a>node</a> whose
<a for=CharacterData>data</a> is <var>data</var>.
</dl>
Expand Down Expand Up @@ -7151,9 +7151,9 @@ for selecting and copying content.

In the <a>node tree</a> above, a
<a>range</a> can be used to represent the sequence
“syndata is awes”. Assuming <var>p</var> is assigned to the
“syndata is awes”. Assuming <var ignore>p</var> is assigned to the
<code>p</code> <a for="/">element</a>, and
<var>em</var> to the <code>em</code>
<var ignore>em</var> to the <code>em</code>
<a for="/">element</a>, this would be done as follows:

<pre class='lang-javascript'><code>
Expand Down Expand Up @@ -7449,7 +7449,7 @@ as its <a for=Range>start</a> and <a for=Range>end</a>.
<dd>Returns <var>range</var>'s
<a>end offset</a>.

<dt><var>collapsed</var> = <var>range</var> . {{Range/collapsed}}
<dt><var ignore>collapsed</var> = <var>range</var> . {{Range/collapsed}}
<dd>Returns true if <var>range</var>'s
<a for=Range>start</a> and
<a for=Range>end</a> are the same, and false otherwise.
Expand Down Expand Up @@ -8533,11 +8533,11 @@ is preserved for compatibility.</span>
<hr>

<dl class=domintro>
<dt><var>position</var> = <var>range</var> . {{Range/comparePoint(node, offset)}}
<dt><var ignore>position</var> = <var>range</var> . {{Range/comparePoint(node, offset)}}
<dd>Returns &minus;1 if the point is before the range, 0 if the point is
in the range, and 1 if the point is after the range.

<dt><var>intersects</var> = <var>range</var> . {{Range/intersectsNode(node)}}
<dt><var ignore>intersects</var> = <var>range</var> . {{Range/intersectsNode(node)}}
<dd>Returns whether <var>range</var> intersects
<var>node</var>.
</dl>
Expand Down

0 comments on commit c91a0d3

Please sign in to comment.