- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 13 Jan 2009 00:32:49 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv25681
Modified Files:
Overview.html
Log Message:
Clean up some sections and cross-refs. (whatwg r2644)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1813
retrieving revision 1.1814
diff -u -d -r1.1813 -r1.1814
--- Overview.html 13 Jan 2009 00:27:41 -0000 1.1813
+++ Overview.html 13 Jan 2009 00:32:47 -0000 1.1814
@@ -5068,7 +5068,7 @@
<code><a href=#the-html-element>html</a></code> element, or null otherwise.<p><dfn id=the-head-element-0>The <code>head</code> element</dfn> of a document is the
first <code><a href=#the-head-element>head</a></code> element that is a child of <a href=#the-html-element-0>the
<code>html</code> element</a>, if there is one, or null
- otherwise.<p><dfn id=the-title-element-0>The <code>title</code> element</dfn> of a document is the
+ otherwise.</p><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>The <dfn id=document.title title=dom-document-title><code>title</code></dfn> attribute must,
on getting, run the following algorithm:<ol><li><p>If the <a href=#root-element>root element</a> is an <code>svg</code>
@@ -5112,7 +5112,7 @@
</ol><p>The <code title=dom-document-title><a href=#document.title>title</a></code> attribute on
the <code><a href=#htmldocument>HTMLDocument</a></code> interface should shadow the attribute
of the same name on the <code>SVGDocument</code> interface when the
- user agent supports both HTML and SVG.<p><dfn id=the-body-element-1>The body element</dfn> of a document is the first child of
+ user agent supports both HTML and SVG.</p><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,
@@ -5147,7 +5147,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>The <dfn id=dom-document-embeds title=dom-document-embeds><code>embeds</code></dfn>
@@ -5164,11 +5165,12 @@
<code><a href=#the-form-element>form</a></code> elements.<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 --><p>The <dfn id=dom-document-scripts title=dom-document-scripts><code>scripts</code></dfn>
+ 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>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>
+ <code><a href=#script>script</a></code> elements.</p><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>,
@@ -5228,7 +5230,7 @@
> * xGetParentElementByClassName(rootElement, className, tagName) -
> Navigates upwards until we hit a parent element with the given class name and
> 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
@@ -5265,7 +5267,7 @@
</ul><p>An <code><a href=#the-object-element>object</a></code> element is said to be
<dfn id=fallback-free>fallback-free</dfn> if it has no element descendants and no
<a href=#text-node>text node</a> descendants that are not <a href=#inter-element-whitespace>inter-element
- whitespace</a>.<p class=note>The <code title=dom-document-dir><a href=#dom-document-dir>dir</a></code>
+ whitespace</a>.</p><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.<h3 id=elements><span class=secno>3.3 </span>Elements</h3><h4 id=semantics-0><span class=secno>3.3.1 </span>Semantics</h4><p>Elements, attributes, and attribute values in HTML are defined
@@ -5828,12 +5830,12 @@
</div><h5 id=flow-content><span class=secno>3.4.1.2 </span>Flow content</h5><p>Most elements that are used in the body of documents and
applications are categorized as <dfn id=flow-content-0>flow content</dfn>.<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>This requirement is not a hard requirement, however, as there are
many cases where an element can be empty legitimately, for example
when it is used as a placeholder which will later be filled in by a
@@ -5850,15 +5852,16 @@
as elements that mark up that text at the intra-paragraph
level. Runs of <a href=#phrasing-content-0>phrasing content</a> form <a href=#paragraph title=paragraph>paragraphs</a>.<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
counted as contributing to the ancestors of the <code><a href=#the-del-element>del</a></code>
element.<p class=note>Most elements that are categorized as phrasing
content can only contain elements that are themselves categorized as
- phrasing content, not any flow content.<p>Text nodes that are not <a href=#inter-element-whitespace>inter-element whitespace</a> are
- <a href=#phrasing-content-0>phrasing content</a>.<h5 id=embedded-content><span class=secno>3.4.1.6 </span>Embedded content</h5><p><dfn id=embedded-content-1>Embedded content</dfn> is content that imports another
+ phrasing content, not any flow content.<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>.<h5 id=embedded-content><span class=secno>3.4.1.6 </span>Embedded content</h5><p><dfn id=embedded-content-1>Embedded content</dfn> is content that imports another
resource into the document, or content from another vocabulary that
is inserted into the document.<p>Elements that are from namespaces other than the <a href=#html-namespace-0>HTML
namespace</a> and that convey content but not metadata, are
@@ -23128,11 +23131,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
@@ -26081,10 +26087,10 @@
when they are enabled. When a user invokes a <code><a href=#the-bb-element>bb</a></code>
element, its <code title=attr-bb-type><a href=#attr-bb-type>type</a></code> attribute's
state's <i>action</i> must be invoked.<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>The <dfn id=dom-bb-type title=dom-bb-type><code>type</code></dfn> DOM
attribute must <a href=#reflect>reflect</a> the content attribute of the
same name.<p>The <dfn id=dom-bb-supported title=dom-bb-supported><code>supported</code></dfn>
Received on Tuesday, 13 January 2009 00:32:59 UTC