Cleanup terminology related to 'in the document'; 'removed from the document', etc. (whatwg r3290)

Cleanup terminology related to 'in the document'; 'removed from the
document', etc. (whatwg r3290)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2436&r2=1.2437&f=h
http://html5.org/tools/web-apps-tracker?from=3289&to=3290

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2436
retrieving revision 1.2437
diff -u -d -r1.2436 -r1.2437
--- Overview.html 16 Jun 2009 23:41:42 -0000 1.2436
+++ Overview.html 17 Jun 2009 00:11:44 -0000 1.2437
@@ -152,7 +152,7 @@
    <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
    <!--ZZZ:-->
    <!--<h2 class="no-num no-toc">W3C Working Draft 23 April 2009</h2>-->
-   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 16 June 2009</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 17 June 2009</h2>
    <!--:ZZZ-->
    <dl><!-- ZZZ: update the month/day (twice), (un)comment out
     <dt>This Version:</dt>
@@ -245,7 +245,7 @@
   track.
   <!--ZZZ:-->
   <!--This specification is the 23 April 2009 Working Draft.-->
-  This specification is the 16 June 2009 Editor's Draft.
+  This specification is the 17 June 2009 Editor's Draft.
   <!--:ZZZ-->
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href="http://www.whatwg.org/">WHATWG</a>. The two specifications are
   identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -1407,10 +1407,15 @@
   element will be an orphaned node.<p>A node's <dfn id="home-subtree">home subtree</dfn> is the subtree rooted at that
   node's <a href="#root-element">root element</a>.<p>The <code>Document</code> of a <code>Node</code> (such as an
   element) is the <code>Document</code> that the <code>Node</code>'s
-  <code title="">ownerDocument</code> DOM attribute returns.<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>
+  <code title="">ownerDocument</code> DOM attribute returns.<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>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>The term <dfn id="tree-order">tree order</dfn> means a pre-order, depth-first
@@ -18616,15 +18621,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
@@ -18703,10 +18708,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
@@ -19514,9 +19520,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="#references">[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="#references">[CSS3COLOR]</a></p>
 
   </div><h6 id="the-canvas-state"><span class="secno">4.8.11.1.1 </span>The canvas state</h6><p>Each context maintains a stack of drawing states. <dfn id="drawing-state" title="drawing state">Drawing states</dfn> consist of:<ul class="brief"><li>The current <a href="#transformations" title="dom-context-2d-transformation">transformation matrix</a>.</li>
    <li>The current <a href="#clipping-region">clipping region</a>.</li>
@@ -20960,9 +20968,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

Received on Wednesday, 17 June 2009 00:12:40 UTC