[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