[e] (0) clarify 'root element'

git-svn-id: http://svn.whatwg.org/webapps@5786 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Jan 14, 2011 · 6d7213a · 6d7213a
1 parent d725e42
commit 6d7213a
Show file tree

Hide file tree

Showing 3 changed files with 32 additions and 18 deletions.
diff --git a/complete.html b/complete.html
@@ -221,7 +221,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1>Web Applications 1.0</h1>
-    <h2 class="no-num no-toc">Living Standard &mdash; 12 January 2011</h2>
+    <h2 class="no-num no-toc">Living Standard &mdash; 14 January 2011</h2>
    </hgroup><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>
    <!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -2731,17 +2731,22 @@ <h4 id=xml><span class=secno>2.1.2 </span>XML</h4>
 
   <h4 id=dom-trees><span class=secno>2.1.3 </span>DOM trees</h4>
 
-  <p>The term <dfn id=root-element>root element</dfn>, when not explicitly qualified
-  as referring to the document's root element, means the furthest
+  <p>The <dfn id=root-element-of-a-document-object>root element of a <code>Document</code> object</dfn> is
+  that <code><a href=#document>Document</a></code>'s first element child, if any. If it does
+  not have one then the <code><a href=#document>Document</a></code> has no root element.</p>
+
+  <p>The term <dfn id=root-element>root element</dfn>, when not referring to a
+  <code><a href=#document>Document</a></code> object's root element, means the furthest
   ancestor element node of whatever node is being discussed, or the
   node itself if it has no ancestors. When the node is a part of the
   document, then the node's <a href=#root-element>root element</a> is indeed the
   document's root element; however, if the node is not currently part
   of the document tree, the root element will be an orphaned node.</p>
 
-  <p>When an element's <a href=#root-element>root element</a> is the root element
-  of a <code><a href=#document>Document</a></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
+  <p>When an element's <a href=#root-element>root element</a> is the <a href=#root-element-of-a-document-object>root
+  element of a <code>Document</code> object</a>, 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

diff --git a/index b/index
@@ -225,7 +225,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1>HTML5 (including next generation additions still in development)</h1>
-    <h2 class="no-num no-toc">Living Standard &mdash; 12 January 2011</h2>
+    <h2 class="no-num no-toc">Living Standard &mdash; 14 January 2011</h2>
    </hgroup><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>
    <!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -2710,17 +2710,22 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
 
   <h4 id=dom-trees><span class=secno>2.1.3 </span>DOM trees</h4>
 
-  <p>The term <dfn id=root-element>root element</dfn>, when not explicitly qualified
-  as referring to the document's root element, means the furthest
+  <p>The <dfn id=root-element-of-a-document-object>root element of a <code>Document</code> object</dfn> is
+  that <code><a href=#document>Document</a></code>'s first element child, if any. If it does
+  not have one then the <code><a href=#document>Document</a></code> has no root element.</p>
+
+  <p>The term <dfn id=root-element>root element</dfn>, when not referring to a
+  <code><a href=#document>Document</a></code> object's root element, means the furthest
   ancestor element node of whatever node is being discussed, or the
   node itself if it has no ancestors. When the node is a part of the
   document, then the node's <a href=#root-element>root element</a> is indeed the
   document's root element; however, if the node is not currently part
   of the document tree, the root element will be an orphaned node.</p>
 
-  <p>When an element's <a href=#root-element>root element</a> is the root element
-  of a <code><a href=#document>Document</a></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
+  <p>When an element's <a href=#root-element>root element</a> is the <a href=#root-element-of-a-document-object>root
+  element of a <code>Document</code> object</a>, 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

diff --git a/source b/source
@@ -1620,18 +1620,22 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
 
   <h4>DOM trees</h4>
 
-  <p>The term <dfn>root element</dfn>, when not explicitly qualified
-  as referring to the document's root element, means the furthest
+  <p>The <dfn>root element of a <code>Document</code> object</dfn> is
+  that <code>Document</code>'s first element child, if any. If it does
+  not have one then the <code>Document</code> has no root element.</p>
+
+  <p>The term <dfn>root element</dfn>, when not referring to a
+  <code>Document</code> object's root element, means the furthest
   ancestor element node of whatever node is being discussed, or the
   node itself if it has no ancestors. When the node is a part of the
   document, then the node's <span>root element</span> is indeed the
   document's root element; however, if the node is not currently part
   of the document tree, the root element will be an orphaned node.</p>
 
-  <p>When an element's <span>root element</span> is the root element
-  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
+  <p>When an element's <span>root element</span> is the <span>root
+  element of a <code>Document</code> object</span>, 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