Skip to content

Commit

Permalink
[e] (0) Clarify some terms like 'home subtree' by moving some things …
Browse files Browse the repository at this point in the history 
…around and adding some more explanatory text in terms of the other terms defined.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=8930

git-svn-id: http://svn.whatwg.org/webapps@4750 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Feb 16, 2010
1 parent 7d98d2a commit ba3669b
Show file tree
Hide file tree
Showing 3 changed files with 39 additions and 36 deletions.
25 changes: 13 additions & 12 deletions complete.html
View file
Expand Up @@ -2030,25 +2030,26 @@ <h4 id=dom-trees><span class=secno>2.1.3 </span>DOM trees</h4>
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>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>

<p>The <code><a href=#document>Document</a></code> of a <code>Node</code> (such as an
element) is the <code><a href=#document>Document</a></code> that the <code>Node</code>'s
<code title="">ownerDocument</code> IDL attribute returns.</p>

<p>When an element's <a href=#root-element>root element</a> is the <a href=#root-element>root
element</a> 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 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
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><a href=#document>Document</a></code> is always the <code>Node</code>'s
<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>. When a node is <a href=#in-a-document>in a
<code>Document</code></a>, its <a href=#home-subtree>home subtree</a> is that
<code><a href=#document>Document</a></code>'s tree.</p>

<p>The <code><a href=#document>Document</a></code> of a <code>Node</code> (such as an
element) is the <code><a href=#document>Document</a></code> that the <code>Node</code>'s
<code title="">ownerDocument</code> IDL attribute returns. When a
<code>Node</code> is <a href=#in-a-document>in a <code>Document</code></a> then
that <code><a href=#document>Document</a></code> is always the <code>Node</code>'s
<code><a href=#document>Document</a></code>, and the <code>Node</code>'s <code title="">ownerDocument</code> IDL attribute thus always returns that
<code><a href=#document>Document</a></code>.</p>

Expand Down
25 changes: 13 additions & 12 deletions index
View file
Expand Up @@ -1929,25 +1929,26 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
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>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>

<p>The <code><a href=#document>Document</a></code> of a <code>Node</code> (such as an
element) is the <code><a href=#document>Document</a></code> that the <code>Node</code>'s
<code title="">ownerDocument</code> IDL attribute returns.</p>

<p>When an element's <a href=#root-element>root element</a> is the <a href=#root-element>root
element</a> 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 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
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><a href=#document>Document</a></code> is always the <code>Node</code>'s
<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>. When a node is <a href=#in-a-document>in a
<code>Document</code></a>, its <a href=#home-subtree>home subtree</a> is that
<code><a href=#document>Document</a></code>'s tree.</p>

<p>The <code><a href=#document>Document</a></code> of a <code>Node</code> (such as an
element) is the <code><a href=#document>Document</a></code> that the <code>Node</code>'s
<code title="">ownerDocument</code> IDL attribute returns. When a
<code>Node</code> is <a href=#in-a-document>in a <code>Document</code></a> then
that <code><a href=#document>Document</a></code> is always the <code>Node</code>'s
<code><a href=#document>Document</a></code>, and the <code>Node</code>'s <code title="">ownerDocument</code> IDL attribute thus always returns that
<code><a href=#document>Document</a></code>.</p>

Expand Down
25 changes: 13 additions & 12 deletions source
View file
Expand Up @@ -897,16 +897,9 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
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>A node's <dfn>home subtree</dfn> is the subtree rooted at that
node's <span>root element</span>.</p>

<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> IDL attribute returns.</p>

<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
<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
document</dfn> when its <span>root element</span> changes and is now
the document's <span>root element</span>. Analogously, an element is
Expand All @@ -915,8 +908,16 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
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
<p>A node's <dfn>home subtree</dfn> is the subtree rooted at that
node's <span>root element</span>. When a node is <span>in a
<code>Document</code></span>, its <span>home subtree</span> is that
<code>Document</code>'s tree.</p>

<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> IDL attribute returns. When 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> IDL attribute thus always returns that
<code>Document</code>.</p>
Expand Down

0 comments on commit ba3669b

Please sign in to comment.