[html5] r3290 - [] (0) Cleanup terminology related to 'in the document'; 'removed from the docum [...]

whatwg at whatwg.org whatwg at whatwg.org
Tue Jun 16 17:11:40 PDT 2009


Author: ianh
Date: 2009-06-16 17:11:38 -0700 (Tue, 16 Jun 2009)
New Revision: 3290

Modified:
   index
   source
Log:
[] (0) Cleanup terminology related to 'in the document'; 'removed from the document', etc.

Modified: index
===================================================================
--- index	2009-06-16 23:41:36 UTC (rev 3289)
+++ index	2009-06-17 00:11:38 UTC (rev 3290)
@@ -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-—-date:-01-jan-1901>Draft Standard — 16 June 2009</h2>
+   <h2 class="no-num no-toc" id=draft-standard-—-date:-01-jan-1901>Draft Standard — 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>
@@ -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>
@@ -21339,15 +21346,15 @@
   <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
@@ -21426,10 +21433,11 @@
    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
@@ -22325,9 +22333,11 @@
   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>
 
@@ -23850,9 +23860,10 @@
   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

Modified: source
===================================================================
--- source	2009-06-16 23:41:36 UTC (rev 3289)
+++ source	2009-06-17 00:11:38 UTC (rev 3290)
@@ -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
@@ -23057,15 +23065,15 @@
 
   <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>
 
@@ -23156,11 +23164,11 @@
 
   </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>
@@ -24186,11 +24194,11 @@
   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>
 
@@ -26000,9 +26008,10 @@
   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




More information about the Commit-Watchers mailing list