W3C home > Mailing lists > Public > public-html-commits@w3.org > January 2009

html5/spec Overview.html,1.1813,1.1814

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 13 Jan 2009 00:32:49 +0000
To: public-html-commits@w3.org
Message-Id: <E1LMXD8-0006gV-1x@lionel-hutz.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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 13 January 2009 00:32:59 GMT