Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[e] (0) Clean up some sections and cross-refs.
git-svn-id: http://svn.whatwg.org/webapps@2644 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Jan 13, 2009
1 parent f77021d commit 7b75fd3
Show file tree
Hide file tree
Showing 2 changed files with 65 additions and 47 deletions.
57 changes: 30 additions & 27 deletions index
Expand Up @@ -6118,8 +6118,7 @@ interface <dfn id=htmldocument>HTMLDocument</dfn> {
<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>

Expand Down Expand Up @@ -6171,8 +6170,7 @@ interface <dfn id=htmldocument>HTMLDocument</dfn> {
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,
Expand Down Expand Up @@ -6211,7 +6209,8 @@ interface <dfn id=htmldocument>HTMLDocument</dfn> {
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>
Expand All @@ -6238,15 +6237,16 @@ interface <dfn id=htmldocument>HTMLDocument</dfn> {
<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>,
Expand Down Expand Up @@ -6318,7 +6318,7 @@ interface <dfn id=htmldocument>HTMLDocument</dfn> {
> 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
Expand Down Expand Up @@ -6363,8 +6363,7 @@ interface <dfn id=htmldocument>HTMLDocument</dfn> {
<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>
Expand Down Expand Up @@ -7152,12 +7151,12 @@ background: transparent"&gt;blue&lt;/span&gt;.&lt;/p&gt;</pre>
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
Expand Down Expand Up @@ -7197,7 +7196,7 @@ background: transparent"&gt;blue&lt;/span&gt;.&lt;/p&gt;</pre>

<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
Expand All @@ -7208,8 +7207,9 @@ background: transparent"&gt;blue&lt;/span&gt;.&lt;/p&gt;</pre>
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>
Expand Down Expand Up @@ -28477,11 +28477,14 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme
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
Expand Down Expand Up @@ -32014,10 +32017,10 @@ XXX selection ranges -->
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
Expand Down
55 changes: 35 additions & 20 deletions source
Expand Up @@ -6132,6 +6132,7 @@ interface <dfn>HTMLDocument</dfn> {
<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
Expand Down Expand Up @@ -6194,6 +6195,7 @@ interface <dfn>HTMLDocument</dfn> {
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
Expand Down Expand Up @@ -6240,6 +6242,11 @@ interface <dfn>HTMLDocument</dfn> {
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
Expand Down Expand Up @@ -6269,14 +6276,17 @@ interface <dfn>HTMLDocument</dfn> {
<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
Expand Down Expand Up @@ -6356,6 +6366,8 @@ interface <dfn>HTMLDocument</dfn> {
> 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
Expand Down Expand Up @@ -6409,6 +6421,7 @@ interface <dfn>HTMLDocument</dfn> {
<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
Expand Down Expand Up @@ -7265,12 +7278,12 @@ background: transparent">blue&lt;/span>.&lt;/p></pre>
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
Expand Down Expand Up @@ -7313,7 +7326,7 @@ background: transparent">blue&lt;/span>.&lt;/p></pre>

<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
Expand All @@ -7324,8 +7337,9 @@ background: transparent">blue&lt;/span>.&lt;/p></pre>
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>
Expand Down Expand Up @@ -31950,13 +31964,14 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {
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
Expand Down Expand Up @@ -36320,10 +36335,10 @@ XXX selection ranges -->
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
Expand Down

0 comments on commit 7b75fd3

Please sign in to comment.