[html5] r2644 - [e] (0) Clean up some sections and cross-refs.
whatwg at whatwg.org
whatwg at whatwg.org
Mon Jan 12 16:32:42 PST 2009
Author: ianh
Date: 2009-01-12 16:32:41 -0800 (Mon, 12 Jan 2009)
New Revision: 2644
Modified:
index
source
Log:
[e] (0) Clean up some sections and cross-refs.
Modified: index
===================================================================
--- index 2009-01-13 00:27:35 UTC (rev 2643)
+++ index 2009-01-13 00:32:41 UTC (rev 2644)
@@ -6118,8 +6118,7 @@
<code>html</code> element</a>, if there is one, or null
otherwise.</p>
-
- <p><dfn id=the-title-element-0>The <code>title</code> element</dfn> of a document is the
+ <hr><p><dfn id=the-title-element-0>The <code>title</code> element</dfn> of a document is the
first <code><a href=#the-title-element>title</a></code> element in the document (in tree order), if
there is one, or null otherwise.</p>
@@ -6171,8 +6170,7 @@
of the same name on the <code>SVGDocument</code> interface when the
user agent supports both HTML and SVG.</p>
-
- <p><dfn id=the-body-element-1>The body element</dfn> of a document is the first child of
+ <hr><p><dfn id=the-body-element-1>The body element</dfn> of a document is the first child of
<a href=#the-html-element-0>the <code>html</code> element</a> that is either a
<code><a href=#the-body-element>body</a></code> element or a <code>frameset</code> element. If
there is no such element, it is null. If the body element is null,
@@ -6211,7 +6209,8 @@
search for ::setBody
http://trac.webkit.org/projects/webkit/browser/trunk/WebCore/dom/Document.cpp
search for ::body
- --><p>The <dfn id=dom-document-images title=dom-document-images><code>images</code></dfn>
+ --><hr><!-- these all return the same object each time because of a rule in
+ the collection section --><p>The <dfn id=dom-document-images title=dom-document-images><code>images</code></dfn>
attribute must return an <code><a href=#htmlcollection-0>HTMLCollection</a></code> rooted at the
<code>Document</code> node, whose filter matches only
<code><a href=#the-img-element>img</a></code> elements.</p>
@@ -6238,15 +6237,16 @@
<p>The <dfn id=dom-document-anchors title=dom-document-anchors><code>anchors</code></dfn>
attribute must return an <code><a href=#htmlcollection-0>HTMLCollection</a></code> rooted at the
<code>Document</code> node, whose filter matches only <code><a href=#the-a-element>a</a></code>
- elements with <code title=attr-a-name>name</code> attributes.</p><!-- XXX note that such elements are
- non-conforming -->
+ elements with <code title=attr-a-name>name</code>
+ attributes.</p><!-- XXX note that such elements are non-conforming
+ -->
<p>The <dfn id=dom-document-scripts title=dom-document-scripts><code>scripts</code></dfn>
attribute must return an <code><a href=#htmlcollection-0>HTMLCollection</a></code> rooted at the
<code>Document</code> node, whose filter matches only
<code><a href=#script>script</a></code> elements.</p>
- <p>The <dfn id=dom-document-getelementsbyname title=dom-document-getElementsByName><code>getElementsByName(<var title="">name</var>)</code></dfn> method takes a string <var title="">name</var>, and must return a live <code>NodeList</code>
+ <hr><p>The <dfn id=dom-document-getelementsbyname title=dom-document-getElementsByName><code>getElementsByName(<var title="">name</var>)</code></dfn> method takes a string <var title="">name</var>, and must return a live <code>NodeList</code>
containing all the <code><a href=#the-a-element>a</a></code>, <code><a href=#the-applet-element>applet</a></code>,
<code><a href=#the-button-element>button</a></code>, <code><a href=#the-form-element>form</a></code>, <!-- frame? frameset?
XXX--><code><a href=#the-iframe-element>iframe</a></code>, <code><a href=#the-img-element>img</a></code>, <code><a href=#the-input-element>input</a></code>,
@@ -6318,7 +6318,7 @@
> optional tag name.
-->
- <p>The <code><a href=#htmldocument>HTMLDocument</a></code> interface <span title="support
+ <hr><p>The <code><a href=#htmldocument>HTMLDocument</a></code> interface <span title="support
named properties">supports named properties</span>. The <span>names
of the supported named properties</span> at any moment consist of
the values of the <code title=attr-name>name</code> content
@@ -6363,8 +6363,7 @@
<a href=#text-node>text node</a> descendants that are not <a href=#inter-element-whitespace>inter-element
whitespace</a>.</p>
-
- <p class=note>The <code title=dom-document-dir><a href=#dom-document-dir>dir</a></code>
+ <hr><p class=note>The <code title=dom-document-dir><a href=#dom-document-dir>dir</a></code>
attribute on the <code><a href=#htmldocument>HTMLDocument</a></code> interface is defined
along with the <code title=attr-dir><a href=#the-dir-attribute>dir</a></code> content
attribute.</p>
@@ -7152,12 +7151,12 @@
applications are categorized as <dfn id=flow-content-0>flow content</dfn>.</p>
<p>As a general rule, elements whose content model allows any
- <a href=#flow-content-0>flow content</a> should have either at least one
- descendant text node that is not <a href=#inter-element-whitespace>inter-element
+ <a href=#flow-content-0>flow content</a> should have either at least one descendant
+ <a href=#text-node>text node</a> that is not <a href=#inter-element-whitespace>inter-element
whitespace</a>, or at least one descendant element node that is
<a href=#embedded-content-1>embedded content</a>. For the purposes of this requirement,
- <code><a href=#the-del-element>del</a></code> elements and their descendants must not be
- counted as contributing to the ancestors of the <code><a href=#the-del-element>del</a></code>
+ <code><a href=#the-del-element>del</a></code> elements and their descendants must not be counted
+ as contributing to the ancestors of the <code><a href=#the-del-element>del</a></code>
element.</p>
<p>This requirement is not a hard requirement, however, as there are
@@ -7197,7 +7196,7 @@
<p>As a general rule, elements whose content model allows any
<a href=#phrasing-content-0>phrasing content</a> should have either at least one
- descendant text node that is not <a href=#inter-element-whitespace>inter-element
+ descendant <a href=#text-node>text node</a> that is not <a href=#inter-element-whitespace>inter-element
whitespace</a>, or at least one descendant element node that is
<a href=#embedded-content-1>embedded content</a>. For the purposes of this requirement,
nodes that are descendants of <code><a href=#the-del-element>del</a></code> elements must not be
@@ -7208,8 +7207,9 @@
content can only contain elements that are themselves categorized as
phrasing content, not any flow content.</p>
- <p>Text nodes that are not <a href=#inter-element-whitespace>inter-element whitespace</a> are
- <a href=#phrasing-content-0>phrasing content</a>.</p>
+ <p><a href=#text-node title="text node">Text nodes</a> that are not
+ <a href=#inter-element-whitespace>inter-element whitespace</a> are <a href=#phrasing-content-0>phrasing
+ content</a>.</p>
<h5 id=embedded-content><span class=secno>3.4.1.6 </span>Embedded content</h5>
@@ -28477,11 +28477,14 @@
methods from DOM Core such as <code title="">createElement()</code>): <dfn id=dom-option title=dom-option><code>Option()</code></dfn>, <dfn id=dom-option-t title=dom-option-t><code>Option(<var title="">text</var>)</code></dfn>, <dfn id=dom-option-tv title=dom-option-tv><code>Option(<var title="">text</var>, <var title="">value</var>)</code></dfn>, <dfn id=dom-option-tvd title=dom-option-tvd><code>Option(<var title="">text</var>, <var title="">value</var>, <var title="">defaultSelected</var>)</code></dfn>, and <dfn id=dom-option-tvds title=dom-option-tvds><code>Option(<var title="">text</var>, <var title="">value</var>, <var title="">defaultSelected</var>, <var title="">selected</var>)</code></dfn>. When invoked as constructors,
these must return a new <code><a href=#htmloptionelement>HTMLOptionElement</a></code> object (a new
<code><a href=#the-option-element>option</a></code> element). If the <var title="">text</var>
- argument is present, the new object must have a text node with the
- value of that argument as its data as its only child. If the <var title="">value</var> argument is present, the new object must have a
- <code title=attr-option-value><a href=#attr-option-value>value</a></code> attribute set with the
- value of the argument as its value. If the <var title="">defaultSelected</var> argument is present and true, the new
- object must have a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute set with no
+ argument is present, the new object must have a text node<!-- XXX
+ clarify that we don't mean a CDATASection? (see dfn of 'text node')
+ --> with the value of that argument as its data as its only
+ child. If the <var title="">value</var> argument is present, the new
+ object must have a <code title=attr-option-value><a href=#attr-option-value>value</a></code>
+ attribute set with the value of the argument as its value. If the
+ <var title="">defaultSelected</var> argument is present and true,
+ the new object must have a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute set with no
value. If the <var title="">selected</var> argument is present and
true, the new object must have its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true;
otherwise the fouth argument is absent or false, and the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> must be set
@@ -32014,10 +32017,10 @@
state's <i>action</i> must be invoked.</p>
<p>When the element has no descendant element children and has no
- descendant text node children of non-zero length, the element
- represents a browser button with a user-agent-defined icon or text
- representing the <code title=attr-bb-type><a href=#attr-bb-type>type</a></code> attribute's
- state's <i>action</i> and <i>relevance</i> (enabled vs
+ descendant <a href=#text-node>text node</a> children of non-zero length, the
+ element represents a browser button with a user-agent-defined icon
+ or text representing the <code title=attr-bb-type><a href=#attr-bb-type>type</a></code>
+ attribute's state's <i>action</i> and <i>relevance</i> (enabled vs
disabled). Otherwise, the element represents its descendants.</p>
<p>The <dfn id=dom-bb-type title=dom-bb-type><code>type</code></dfn> DOM
Modified: source
===================================================================
--- source 2009-01-13 00:27:35 UTC (rev 2643)
+++ source 2009-01-13 00:32:41 UTC (rev 2644)
@@ -6132,6 +6132,7 @@
<code>html</code> element</span>, if there is one, or null
otherwise.</p>
+ <hr>
<p><dfn>The <code>title</code> element</dfn> of a document is the
first <code>title</code> element in the document (in tree order), if
@@ -6194,6 +6195,7 @@
of the same name on the <code>SVGDocument</code> interface when the
user agent supports both HTML and SVG.</p>
+ <hr>
<p><dfn>The body element</dfn> of a document is the first child of
<span>the <code>html</code> element</span> that is either a
@@ -6240,6 +6242,11 @@
search for ::body
-->
+ <hr>
+
+ <!-- these all return the same object each time because of a rule in
+ the collection section -->
+
<p>The <dfn title="dom-document-images"><code>images</code></dfn>
attribute must return an <code>HTMLCollection</code> rooted at the
<code>Document</code> node, whose filter matches only
@@ -6269,14 +6276,17 @@
<p>The <dfn title="dom-document-anchors"><code>anchors</code></dfn>
attribute must return an <code>HTMLCollection</code> rooted at the
<code>Document</code> node, whose filter matches only <code>a</code>
- elements with <code title="attr-a-name">name</code> attributes.</p><!-- XXX note that such elements are
- non-conforming -->
+ elements with <code title="attr-a-name">name</code>
+ attributes.</p><!-- XXX note that such elements are non-conforming
+ -->
<p>The <dfn title="dom-document-scripts"><code>scripts</code></dfn>
attribute must return an <code>HTMLCollection</code> rooted at the
<code>Document</code> node, whose filter matches only
<code>script</code> elements.</p>
+ <hr>
+
<p>The <dfn
title="dom-document-getElementsByName"><code>getElementsByName(<var
title="">name</var>)</code></dfn> method takes a string <var
@@ -6356,6 +6366,8 @@
> optional tag name.
-->
+ <hr>
+
<p>The <code>HTMLDocument</code> interface <span title="support
named properties">supports named properties</span>. The <span>names
of the supported named properties</span> at any moment consist of
@@ -6409,6 +6421,7 @@
<span>text node</span> descendants that are not <span>inter-element
whitespace</span>.</p>
+ <hr>
<p class="note">The <code title="dom-document-dir">dir</code>
attribute on the <code>HTMLDocument</code> interface is defined
@@ -7265,12 +7278,12 @@
applications are categorized as <dfn>flow content</dfn>.</p>
<p>As a general rule, elements whose content model allows any
- <span>flow content</span> should have either at least one
- descendant text node that is not <span>inter-element
+ <span>flow content</span> should have either at least one descendant
+ <span>text node</span> that is not <span>inter-element
whitespace</span>, or at least one descendant element node that is
<span>embedded content</span>. For the purposes of this requirement,
- <code>del</code> elements and their descendants must not be
- counted as contributing to the ancestors of the <code>del</code>
+ <code>del</code> elements and their descendants must not be counted
+ as contributing to the ancestors of the <code>del</code>
element.</p>
<p>This requirement is not a hard requirement, however, as there are
@@ -7313,7 +7326,7 @@
<p>As a general rule, elements whose content model allows any
<span>phrasing content</span> should have either at least one
- descendant text node that is not <span>inter-element
+ descendant <span>text node</span> that is not <span>inter-element
whitespace</span>, or at least one descendant element node that is
<span>embedded content</span>. For the purposes of this requirement,
nodes that are descendants of <code>del</code> elements must not be
@@ -7324,8 +7337,9 @@
content can only contain elements that are themselves categorized as
phrasing content, not any flow content.</p>
- <p>Text nodes that are not <span>inter-element whitespace</span> are
- <span>phrasing content</span>.</p>
+ <p><span title="text node">Text nodes</span> that are not
+ <span>inter-element whitespace</span> are <span>phrasing
+ content</span>.</p>
<h5>Embedded content</h5>
@@ -31950,13 +31964,14 @@
title="">selected</var>)</code></dfn>. When invoked as constructors,
these must return a new <code>HTMLOptionElement</code> object (a new
<code>option</code> element). If the <var title="">text</var>
- argument is present, the new object must have a text node with the
- value of that argument as its data as its only child. If the <var
- title="">value</var> argument is present, the new object must have a
- <code title="attr-option-value">value</code> attribute set with the
- value of the argument as its value. If the <var
- title="">defaultSelected</var> argument is present and true, the new
- object must have a <code
+ argument is present, the new object must have a text node<!-- XXX
+ clarify that we don't mean a CDATASection? (see dfn of 'text node')
+ --> with the value of that argument as its data as its only
+ child. If the <var title="">value</var> argument is present, the new
+ object must have a <code title="attr-option-value">value</code>
+ attribute set with the value of the argument as its value. If the
+ <var title="">defaultSelected</var> argument is present and true,
+ the new object must have a <code
title="attr-option-selected">selected</code> attribute set with no
value. If the <var title="">selected</var> argument is present and
true, the new object must have its <span
@@ -36320,10 +36335,10 @@
state's <i>action</i> must be invoked.</p>
<p>When the element has no descendant element children and has no
- descendant text node children of non-zero length, the element
- represents a browser button with a user-agent-defined icon or text
- representing the <code title="attr-bb-type">type</code> attribute's
- state's <i>action</i> and <i>relevance</i> (enabled vs
+ descendant <span>text node</span> children of non-zero length, the
+ element represents a browser button with a user-agent-defined icon
+ or text representing the <code title="attr-bb-type">type</code>
+ attribute's state's <i>action</i> and <i>relevance</i> (enabled vs
disabled). Otherwise, the element represents its descendants.</p>
<p>The <dfn title="dom-bb-type"><code>type</code></dfn> DOM
More information about the Commit-Watchers
mailing list