Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[] (0) Cleanup terminology related to 'in the document'; 'removed fro…
…m the document', etc.

git-svn-id: http://svn.whatwg.org/webapps@3290 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Jun 17, 2009
1 parent 1fb8fbc commit 5155fc4
Show file tree
Hide file tree
Showing 2 changed files with 69 additions and 49 deletions.
59 changes: 35 additions & 24 deletions index
Expand Up @@ -39,7 +39,7 @@
<div class=head>
<p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
<h1>HTML 5</h1>
<h2 class="no-num no-toc" id=draft-standard-&mdash;-date:-01-jan-1901>Draft Standard &mdash; 16 June 2009</h2>
<h2 class="no-num no-toc" id=draft-standard-&mdash;-date:-01-jan-1901>Draft Standard &mdash; 17 June 2009</h2>
<p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<dl><dt>Multiple-page version:</dt>
Expand Down Expand Up @@ -1559,10 +1559,17 @@
element) is the <code>Document</code> that the <code>Node</code>'s
<code title="">ownerDocument</code> DOM attribute returns.</p>

<p>An element is said to have been <dfn id=insert-an-element-into-a-document title="insert an element
into a document">inserted into a document</dfn> when its <a href=#root-element>root
element</a> changes and is now the document's <a href=#root-element>root
element</a>. If a <code>Node</code> is in a <code>Document</code>
<p>When an element's <a href=#root-element>root element</a> is the <a href=#root-element>root
element</a> of a <code>Document</code>, it is said to be <dfn id=in-a-document>in
a <code>Document</code></dfn>. An element is said to have been <dfn id=insert-an-element-into-a-document title="insert an element into a document">inserted into a
document</dfn> when its <a href=#root-element>root element</a> changes and is now
the document's <a href=#root-element>root element</a>. Analogously, an element is
said to have been <dfn id=remove-an-element-from-a-document title="remove an element from a
document">removed from a document</dfn> when its <a href=#root-element>root
element</a> changes from being the document's <a href=#root-element>root
element</a> to being another element.</p>

<p>If a <code>Node</code> is <a href=#in-a-document>in a <code>Document</code></a>
then that <code>Document</code> is always the <code>Node</code>'s
<code>Document</code>, and the <code>Node</code>'s <code title="">ownerDocument</code> DOM attribute thus always returns that
<code>Document</code>.</p>
Expand Down Expand Up @@ -21339,15 +21346,15 @@ interface <dfn id=cuerangecallback>CueRangeCallback</dfn> {
<code title=event-pause><a href=#event-pause>pause</a></code> event doesn't fire).</p>

<p><a href=#media-element title="media element">Media elements</a> that are
<a href=#potentially-playing>potentially playing</a> while not <span>in a
<code>Document</code></span><!-- XXX xref --> must not play any
video, but should play any audio component. Media elements must not
stop playing just because all references to them have been removed;
only once a media element to which no references exist has reached a
point where no further audio remains to be played for that element
(e.g. because the element is paused, or because the end of the clip
has been reached, or because its <code title=dom-media-playbackRate><a href=#dom-media-playbackrate>playbackRate</a></code> is 0.0) may the
element be <span>garbage collected</span><!-- XXX xref -->.</p>
<a href=#potentially-playing>potentially playing</a> while not <a href=#in-a-document>in a
<code>Document</code></a> must not play any video, but should
play any audio component. Media elements must not stop playing just
because all references to them have been removed; only once a media
element to which no references exist has reached a point where no
further audio remains to be played for that element (e.g. because
the element is paused, or because the end of the clip has been
reached, or because its <code title=dom-media-playbackRate><a href=#dom-media-playbackrate>playbackRate</a></code> is 0.0) may the
element be garbage collected.</p>

<hr><p>When the <a href=#current-playback-position>current playback position</a> of a <a href=#media-element>media
element</a> changes (e.g. due to playback or seeking), the user
Expand Down Expand Up @@ -21426,10 +21433,11 @@ interface <dfn id=cuerangecallback>CueRangeCallback</dfn> {
list to "true" (active), and the "active" boolean of all the <a href=#cue-range title="cue range">cue ranges</a> in the <var title="">other
ranges</var> list to "false" (inactive).</li>

</ol><p>When a <a href=#media-element>media element</a> is <span>removed from a
<code>Document</code><!-- XXX xref removed --></span>, if the
<a href=#media-element>media element</a>'s <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> attribute has a
value other than <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code> then the user
</ol><p>When a <a href=#media-element>media element</a> is <a href=#remove-an-element-from-a-document title="remove an
element from a document">removed from a
<code>Document</code></a>, if the <a href=#media-element>media element</a>'s
<code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> attribute
has a value other than <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code> then the user
agent must act as if the <code title=dom-media-pause><a href=#dom-media-pause>pause()</a></code> method had been invoked.</p>

<p class=note>If the <a href=#media-element>media element</a>'s
Expand Down Expand Up @@ -22325,9 +22333,11 @@ interface <dfn id=canvaspixelarray>CanvasPixelArray</dfn> {
color is specified (e.g. when the appropriate attribute is set, or
when the method is called; not when the color is rendered or
otherwise used). If the computed value of the 'color' property is
undefined for a particular case (e.g. because the element is not in
a document), then the "computed value of the 'color' property" for
the purposes of determining the computed value of the <code title="">currentColor</code> keyword is fully opaque black. <a href=#refsCSS3COLOR>[CSS3COLOR]</a></p>
undefined for a particular case (e.g. because the element is not
<a href=#in-a-document>in a <code>Document</code></a>), then the "computed value
of the 'color' property" for the purposes of determining the
computed value of the <code title="">currentColor</code> keyword is
fully opaque black. <a href=#refsCSS3COLOR>[CSS3COLOR]</a></p>

</div>

Expand Down Expand Up @@ -23850,9 +23860,10 @@ notes on what would need to be defined for dashed lines:
of the 'font-weight' property of the corresponding
<code><a href=#the-canvas-element>canvas</a></code> element at the time that the attribute is
set. If the computed values are undefined for a particular case
(e.g. because the <code><a href=#the-canvas-element>canvas</a></code> element is not in a document),
then the relative keywords must be interpreted relative to the
normal-weight 10px sans-serif default.</p>
(e.g. because the <code><a href=#the-canvas-element>canvas</a></code> element is not <a href=#in-a-document>in a
<code>Document</code></a>), then the relative keywords must be
interpreted relative to the normal-weight 10px sans-serif
default.</p>

<p>The <dfn id=dom-context-2d-textalign title=dom-context-2d-textAlign><code>textAlign</code></dfn> DOM
attribute, on getting, must return the current value. On setting, if
Expand Down
59 changes: 34 additions & 25 deletions source
Expand Up @@ -530,10 +530,18 @@
element) is the <code>Document</code> that the <code>Node</code>'s
<code title="">ownerDocument</code> DOM attribute returns.</p>

<p>An element is said to have been <dfn title="insert an element
into a document">inserted into a document</dfn> when its <span>root
element</span> changes and is now the document's <span>root
element</span>. If a <code>Node</code> is in a <code>Document</code>
<p>When an element's <span>root element</span> is the <span>root
element</span> of a <code>Document</code>, it is said to be <dfn>in
a <code>Document</code></dfn>. An element is said to have been <dfn
title="insert an element into a document">inserted into a
document</dfn> when its <span>root element</span> changes and is now
the document's <span>root element</span>. Analogously, an element is
said to have been <dfn title="remove an element from a
document">removed from a document</dfn> when its <span>root
element</span> changes from being the document's <span>root
element</span> to being another element.</p>

<p>If a <code>Node</code> is <span>in a <code>Document</code></span>
then that <code>Document</code> is always the <code>Node</code>'s
<code>Document</code>, and the <code>Node</code>'s <code
title="">ownerDocument</code> DOM attribute thus always returns that
Expand Down Expand Up @@ -23057,15 +23065,15 @@ interface <dfn>CueRangeCallback</dfn> {

<p><span title="media element">Media elements</span> that are
<span>potentially playing</span> while not <span>in a
<code>Document</code></span><!-- XXX xref --> must not play any
video, but should play any audio component. Media elements must not
stop playing just because all references to them have been removed;
only once a media element to which no references exist has reached a
point where no further audio remains to be played for that element
(e.g. because the element is paused, or because the end of the clip
has been reached, or because its <code
<code>Document</code></span> must not play any video, but should
play any audio component. Media elements must not stop playing just
because all references to them have been removed; only once a media
element to which no references exist has reached a point where no
further audio remains to be played for that element (e.g. because
the element is paused, or because the end of the clip has been
reached, or because its <code
title="dom-media-playbackRate">playbackRate</code> is 0.0) may the
element be <span>garbage collected</span><!-- XXX xref -->.</p>
element be garbage collected.</p>

<hr>

Expand Down Expand Up @@ -23156,11 +23164,11 @@ interface <dfn>CueRangeCallback</dfn> {

</ol>

<p>When a <span>media element</span> is <span>removed from a
<code>Document</code><!-- XXX xref removed --></span>, if the
<span>media element</span>'s <code
title="dom-media-networkState">networkState</code> attribute has a
value other than <code
<p>When a <span>media element</span> is <span title="remove an
element from a document">removed from a
<code>Document</code></span>, if the <span>media element</span>'s
<code title="dom-media-networkState">networkState</code> attribute
has a value other than <code
title="dom-media-NETWORK_EMPTY">NETWORK_EMPTY</code> then the user
agent must act as if the <code
title="dom-media-pause">pause()</code> method had been invoked.</p>
Expand Down Expand Up @@ -24186,11 +24194,11 @@ interface <dfn>CanvasPixelArray</dfn> {
color is specified (e.g. when the appropriate attribute is set, or
when the method is called; not when the color is rendered or
otherwise used). If the computed value of the 'color' property is
undefined for a particular case (e.g. because the element is not in
a document), then the "computed value of the 'color' property" for
the purposes of determining the computed value of the <code
title="">currentColor</code> keyword is fully opaque black. <a
href="#refsCSS3COLOR">[CSS3COLOR]</a></p>
undefined for a particular case (e.g. because the element is not
<span>in a <code>Document</code></span>), then the "computed value
of the 'color' property" for the purposes of determining the
computed value of the <code title="">currentColor</code> keyword is
fully opaque black. <a href="#refsCSS3COLOR">[CSS3COLOR]</a></p>

</div>

Expand Down Expand Up @@ -26000,9 +26008,10 @@ notes on what would need to be defined for dashed lines:
of the 'font-weight' property of the corresponding
<code>canvas</code> element at the time that the attribute is
set. If the computed values are undefined for a particular case
(e.g. because the <code>canvas</code> element is not in a document),
then the relative keywords must be interpreted relative to the
normal-weight 10px sans-serif default.</p>
(e.g. because the <code>canvas</code> element is not <span>in a
<code>Document</code></span>), then the relative keywords must be
interpreted relative to the normal-weight 10px sans-serif
default.</p>

<p>The <dfn
title="dom-context-2d-textAlign"><code>textAlign</code></dfn> DOM
Expand Down

0 comments on commit 5155fc4

Please sign in to comment.