[html5] r3527 - [] (0) Text explaining what the element definitions mean and stating that some p [...]

whatwg at whatwg.org whatwg at whatwg.org
Mon Aug 3 00:00:40 PDT 2009


Author: ianh
Date: 2009-08-03 00:00:38 -0700 (Mon, 03 Aug 2009)
New Revision: 3527

Modified:
   index
   source
Log:
[] (0) Text explaining what the element definitions mean and stating that some parts of those definitions are normative.

Modified: index
===================================================================
--- index	2009-08-03 03:24:43 UTC (rev 3526)
+++ index	2009-08-03 07:00:38 UTC (rev 3527)
@@ -263,30 +263,31 @@
        <li><a href=#the-dir-attribute><span class=secno>3.3.3.5 </span>The <code>dir</code> attribute</a></li>
        <li><a href=#classes><span class=secno>3.3.3.6 </span>The <code>class</code> attribute</a></li>
        <li><a href=#the-style-attribute><span class=secno>3.3.3.7 </span>The <code>style</code> attribute</a></li>
-       <li><a href=#embedding-custom-non-visible-data><span class=secno>3.3.3.8 </span>Embedding custom non-visible data</a></ol></ol></li>
-   <li><a href=#content-models><span class=secno>3.4 </span>Content models</a>
-    <ol>
-     <li><a href=#kinds-of-content><span class=secno>3.4.1 </span>Kinds of content</a>
+       <li><a href=#embedding-custom-non-visible-data><span class=secno>3.3.3.8 </span>Embedding custom non-visible data</a></ol></li>
+     <li><a href=#element-definitions><span class=secno>3.3.4 </span>Element definitions</a></li>
+     <li><a href=#content-models><span class=secno>3.3.5 </span>Content models</a>
       <ol>
-       <li><a href=#metadata-content><span class=secno>3.4.1.1 </span>Metadata content</a></li>
-       <li><a href=#flow-content><span class=secno>3.4.1.2 </span>Flow content</a></li>
-       <li><a href=#sectioning-content><span class=secno>3.4.1.3 </span>Sectioning content</a></li>
-       <li><a href=#heading-content><span class=secno>3.4.1.4 </span>Heading content</a></li>
-       <li><a href=#phrasing-content><span class=secno>3.4.1.5 </span>Phrasing content</a></li>
-       <li><a href=#embedded-content><span class=secno>3.4.1.6 </span>Embedded content</a></li>
-       <li><a href=#interactive-content><span class=secno>3.4.1.7 </span>Interactive content</a></ol></li>
-     <li><a href=#transparent-content-models><span class=secno>3.4.2 </span>Transparent content models</a></ol></li>
-   <li><a href=#paragraphs><span class=secno>3.5 </span>Paragraphs</a></li>
-   <li><a href=#apis-in-html-documents><span class=secno>3.6 </span>APIs in HTML documents</a></li>
-   <li><a href=#interactions-with-xpath-and-xslt><span class=secno>3.7 </span>Interactions with XPath and XSLT</a></li>
-   <li><a href=#dynamic-markup-insertion><span class=secno>3.8 </span>Dynamic markup insertion</a>
+       <li><a href=#kinds-of-content><span class=secno>3.3.5.1 </span>Kinds of content</a>
+        <ol>
+         <li><a href=#metadata-content><span class=secno>3.3.5.1.1 </span>Metadata content</a></li>
+         <li><a href=#flow-content><span class=secno>3.3.5.1.2 </span>Flow content</a></li>
+         <li><a href=#sectioning-content><span class=secno>3.3.5.1.3 </span>Sectioning content</a></li>
+         <li><a href=#heading-content><span class=secno>3.3.5.1.4 </span>Heading content</a></li>
+         <li><a href=#phrasing-content><span class=secno>3.3.5.1.5 </span>Phrasing content</a></li>
+         <li><a href=#embedded-content><span class=secno>3.3.5.1.6 </span>Embedded content</a></li>
+         <li><a href=#interactive-content><span class=secno>3.3.5.1.7 </span>Interactive content</a></ol></li>
+       <li><a href=#transparent-content-models><span class=secno>3.3.5.2 </span>Transparent content models</a></li>
+       <li><a href=#paragraphs><span class=secno>3.3.5.3 </span>Paragraphs</a></ol></ol></li>
+   <li><a href=#apis-in-html-documents><span class=secno>3.4 </span>APIs in HTML documents</a></li>
+   <li><a href=#interactions-with-xpath-and-xslt><span class=secno>3.5 </span>Interactions with XPath and XSLT</a></li>
+   <li><a href=#dynamic-markup-insertion><span class=secno>3.6 </span>Dynamic markup insertion</a>
     <ol>
-     <li><a href=#controlling-the-input-stream><span class=secno>3.8.1 </span>Controlling the input stream</a></li>
-     <li><a href=#document.write()><span class=secno>3.8.2 </span><code title=dom-document-write>document.write()</code></a></li>
-     <li><a href=#document.writeln()><span class=secno>3.8.3 </span><code title=dom-document-writeln>document.writeln()</code></a></li>
-     <li><a href=#innerhtml><span class=secno>3.8.4 </span><code title=dom-innerHTML>innerHTML</code></a></li>
-     <li><a href=#outerhtml><span class=secno>3.8.5 </span><code title=dom-outerHTML>outerHTML</code></a></li>
-     <li><a href=#insertadjacenthtml()><span class=secno>3.8.6 </span><code title=dom-insertAdjacentHTML>insertAdjacentHTML()</code></a></ol></ol></li>
+     <li><a href=#controlling-the-input-stream><span class=secno>3.6.1 </span>Controlling the input stream</a></li>
+     <li><a href=#document.write()><span class=secno>3.6.2 </span><code title=dom-document-write>document.write()</code></a></li>
+     <li><a href=#document.writeln()><span class=secno>3.6.3 </span><code title=dom-document-writeln>document.writeln()</code></a></li>
+     <li><a href=#innerhtml><span class=secno>3.6.4 </span><code title=dom-innerHTML>innerHTML</code></a></li>
+     <li><a href=#outerhtml><span class=secno>3.6.5 </span><code title=dom-outerHTML>outerHTML</code></a></li>
+     <li><a href=#insertadjacenthtml()><span class=secno>3.6.6 </span><code title=dom-insertAdjacentHTML>insertAdjacentHTML()</code></a></ol></ol></li>
  <li><a href=#semantics><span class=secno>4 </span>The elements of HTML</a>
   <ol>
    <li><a href=#the-root-element><span class=secno>4.1 </span>The root element</a>
@@ -8152,8 +8153,52 @@
 
 
 
-  <h3 id=content-models><span class=secno>3.4 </span>Content models</h3>
+  <h4 id=element-definitions><span class=secno>3.3.4 </span>Element definitions</h4>
 
+  <p>Each element in this specification has a definition that includes
+  the following information:</p>
+
+  <dl><dt>Categories</dt>
+
+   <dd>A list of <a href=#content-categories title="content categories">categories</a> to
+   which the element belongs. These are used when defining the
+   <a href=#content-models>content models</a> for each element.</dd>
+
+
+   <dt>Contexts in which this element may be used</dt>
+
+   <dd>A <em>non-normative</em> description of where the element can
+   be used. This information is redundant with the content models of
+   elements that allow this one as a child, and is provided only as a
+   convenience.</dd>
+
+
+   <dt>Content model</dt>
+
+   <dd>A normative description of what content must be included as
+   children and descendants of the element.</dd>
+
+
+   <dt>Content attributes</dt>
+
+   <dd>A normative list of attributes that may be specified on the
+   element.</dd>
+
+
+   <dt>DOM interface</dt>
+
+   <dd>A normative definition of a DOM interface that such elements
+   must implement.</dd>
+
+  </dl><p>This is then followed by a description of what the element
+  <a href=#represents>represents</a>, along with any additional normative
+  conformance criteria that may apply to authors<span class=impl title=""> and implementations</span>. Examples are sometimes
+  also included.</p>
+
+
+
+  <h4 id=content-models><span class=secno>3.3.5 </span><dfn>Content models</dfn></h4>
+
   <p>All the elements in this specification have a defined content
   model, which describes what nodes are allowed inside the elements,
   and thus what the structure of an HTML document or fragment must
@@ -8217,11 +8262,12 @@
   </div>
 
 
-  <h4 id=kinds-of-content><span class=secno>3.4.1 </span>Kinds of content</h4>
+  <h5 id=kinds-of-content><span class=secno>3.3.5.1 </span>Kinds of content</h5>
 
-  <p>Each element in HTML falls into zero or more categories that
-  group elements with similar characteristics together. The following
-  broad categories are used in this specification:</p>
+  <p>Each element in HTML falls into zero or more <dfn id=content-categories title="content
+  categories">categories</dfn> that group elements with similar
+  characteristics together. The following broad categories are used in
+  this specification:</p>
 
   <ul class=brief><li><a href=#metadata-content-0>Metadata content</a></li>
    <li><a href=#flow-content-0>Flow content</a></li>
@@ -8230,8 +8276,11 @@
    <li><a href=#phrasing-content-0>Phrasing content</a></li>
    <li><a href=#embedded-content-2>Embedded content</a></li>
    <li><a href=#interactive-content-0>Interactive content</a></li>
-  </ul><p>These categories are related as follows:
+  </ul><p class=note>Some elements also fall into other categories, which
+  are defined in other parts of this specification.</p>
 
+  <p>These categories are related as follows:</p>
+
   <p><object data=images/content-venn.svg height=288 width=512><img alt="Sectioning content, heading content, phrasing content, and
   embedded content are all types of flow content. Embedded content is
   also a type of phrasing content." src=images/content-venn.png></object></p>
@@ -8247,7 +8296,7 @@
   particular category.</p>
 
 
-  <h5 id=metadata-content><span class=secno>3.4.1.1 </span>Metadata content</h5>
+  <h6 id=metadata-content><span class=secno>3.3.5.1.1 </span>Metadata content</h6>
 
   <p><dfn id=metadata-content-0>Metadata content</dfn> is content that sets up the
   presentation or behavior of the rest of the content, or that sets
@@ -8295,7 +8344,7 @@
   </div>
 
 
-  <h5 id=flow-content><span class=secno>3.4.1.2 </span>Flow content</h5>
+  <h6 id=flow-content><span class=secno>3.3.5.1.2 </span>Flow content</h6>
 
   <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>
@@ -8399,7 +8448,7 @@
   pages be filled in but on some pages is not relevant.</p>
 
 
-  <h5 id=sectioning-content><span class=secno>3.4.1.3 </span>Sectioning content</h5>
+  <h6 id=sectioning-content><span class=secno>3.3.5.1.3 </span>Sectioning content</h6>
 
   <p><dfn id=sectioning-content-0>Sectioning content</dfn> is content that defines the scope
   of <a href=#heading-content-0 title="heading content">headings</a> and <a href=#the-footer-element title=footer>footers</a>.</p>
@@ -8417,7 +8466,7 @@
   <a href=#outline>outline</a>.</p>
 
 
-  <h5 id=heading-content><span class=secno>3.4.1.4 </span>Heading content</h5>
+  <h6 id=heading-content><span class=secno>3.3.5.1.4 </span>Heading content</h6>
 
   <p><dfn id=heading-content-0>Heading content</dfn> defines the header of a section
   (whether explicitly marked up using <a href=#sectioning-content-0>sectioning content</a>
@@ -8430,7 +8479,7 @@
    <li><code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h5</a></code></li>
    <li><code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code></li>
    <li><code><a href=#the-hgroup-element>hgroup</a></code></li>
-  </ul><h5 id=phrasing-content><span class=secno>3.4.1.5 </span>Phrasing content</h5>
+  </ul><h6 id=phrasing-content><span class=secno>3.3.5.1.5 </span>Phrasing content</h6>
 
   <p><dfn id=phrasing-content-0>Phrasing content</dfn> is the text of the document, as well
   as elements that mark up that text at the intra-paragraph
@@ -8509,7 +8558,7 @@
   character">space characters</a>).</p>
 
 
-  <h5 id=embedded-content><span class=secno>3.4.1.6 </span>Embedded content</h5>
+  <h6 id=embedded-content><span class=secno>3.3.5.1.6 </span>Embedded content</h6>
 
   <p><dfn id=embedded-content-2>Embedded content</dfn> is content that imports another
   resource into the document, or content from another vocabulary that
@@ -8535,7 +8584,7 @@
   element definitions state what the fallback is, if any.</p>
 
 
-  <h5 id=interactive-content><span class=secno>3.4.1.7 </span>Interactive content</h5>
+  <h6 id=interactive-content><span class=secno>3.3.5.1.7 </span>Interactive content</h6>
 
 <!--
 TESTS:
@@ -8657,7 +8706,7 @@
   </div>
 
 
-  <h4 id=transparent-content-models><span class=secno>3.4.2 </span>Transparent content models</h4>
+  <h5 id=transparent-content-models><span class=secno>3.3.5.2 </span>Transparent content models</h5>
 
   <p>Some elements are described as <dfn id=transparent>transparent</dfn>; they have
   "transparent" in the description of their content model.</p>
@@ -8673,7 +8722,7 @@
   accepting any <a href=#flow-content-0>flow content</a>.</p>
 
 
-  <h3 id=paragraphs><span class=secno>3.5 </span>Paragraphs</h3>
+  <h5 id=paragraphs><span class=secno>3.3.5.3 </span>Paragraphs</h5>
 
   <p class=note>The term <a href=#paragraph>paragraph</a> as defined in this
   section is distinct from (though related to) the <code><a href=#the-p-element>p</a></code>
@@ -8852,7 +8901,7 @@
 
 
 
-  <h3 id=apis-in-html-documents><span class=secno>3.6 </span>APIs in HTML documents</h3>
+  <h3 id=apis-in-html-documents><span class=secno>3.4 </span>APIs in HTML documents</h3>
 
   <p>For <a href=#html-documents>HTML documents</a>, and for <a href=#html-elements>HTML
   elements</a> in <a href=#html-documents>HTML documents</a>, certain APIs defined
@@ -8966,7 +9015,7 @@
 
   </dl><div class=impl>
 
-  <h3 id=interactions-with-xpath-and-xslt><span class=secno>3.7 </span>Interactions with XPath and XSLT</h3>
+  <h3 id=interactions-with-xpath-and-xslt><span class=secno>3.5 </span>Interactions with XPath and XSLT</h3>
 
   <p id=xpath-1.0-processors>Implementations of XPath 1.0 that
   operate on HTML documents parsed or created in the manners described
@@ -9014,7 +9063,7 @@
 
 
 
-  <h3 id=dynamic-markup-insertion><span class=secno>3.8 </span><dfn>Dynamic markup insertion</dfn></h3>
+  <h3 id=dynamic-markup-insertion><span class=secno>3.6 </span><dfn>Dynamic markup insertion</dfn></h3>
 
   <p class=note>APIs for dynamically inserting markup into the
   document interact with the parser, and thus their behavior, varies
@@ -9024,7 +9073,7 @@
 
 
 
-  <h4 id=controlling-the-input-stream><span class=secno>3.8.1 </span>Controlling the input stream</h4>
+  <h4 id=controlling-the-input-stream><span class=secno>3.6.1 </span>Controlling the input stream</h4>
 
   <p>The <dfn id=dom-document-open title=dom-document-open><code>open()</code></dfn>
   method comes in several variants with different numbers of
@@ -9232,7 +9281,7 @@
 
 
 
-  <h4 id=document.write()><span class=secno>3.8.2 </span><code title=dom-document-write><a href=#dom-document-write>document.write()</a></code></h4>
+  <h4 id=document.write()><span class=secno>3.6.2 </span><code title=dom-document-write><a href=#dom-document-write>document.write()</a></code></h4>
 
   <dl class=domintro><dt><var title="">document</var> . <code title=dom-document-write><a href=#dom-document-write>write</a></code>(<var title="">text</var>...)</dt>
 
@@ -9318,7 +9367,7 @@
   </ol></div>
 
 
-  <h4 id=document.writeln()><span class=secno>3.8.3 </span><code title=dom-document-writeln><a href=#dom-document-writeln>document.writeln()</a></code></h4>
+  <h4 id=document.writeln()><span class=secno>3.6.3 </span><code title=dom-document-writeln><a href=#dom-document-writeln>document.writeln()</a></code></h4>
 
   <dl class=domintro><dt><var title="">document</var> . <code title=dom-document-writeln><a href=#dom-document-writeln>writeln</a></code>(<var title="">text</var>...)</dt>
 
@@ -9345,7 +9394,7 @@
 
 
 
-  <h4 id=innerhtml><span class=secno>3.8.4 </span><code title=dom-innerHTML><a href=#dom-innerhtml>innerHTML</a></code></h4>
+  <h4 id=innerhtml><span class=secno>3.6.4 </span><code title=dom-innerHTML><a href=#dom-innerhtml>innerHTML</a></code></h4>
 
   <p>The <dfn id=dom-innerhtml title=dom-innerHTML><code>innerHTML</code></dfn> DOM
   attribute represents the markup of the node's contents.</p>
@@ -9505,7 +9554,7 @@
 
 
 
-  <h4 id=outerhtml><span class=secno>3.8.5 </span><code title=dom-outerHTML><a href=#dom-outerhtml>outerHTML</a></code></h4>
+  <h4 id=outerhtml><span class=secno>3.6.5 </span><code title=dom-outerHTML><a href=#dom-outerhtml>outerHTML</a></code></h4>
 
   <p>The <dfn id=dom-outerhtml title=dom-outerHTML><code>outerHTML</code></dfn> DOM
   attribute represents the markup of the element and its contents.</p>
@@ -9612,7 +9661,7 @@
 
 
 
-  <h4 id=insertadjacenthtml()><span class=secno>3.8.6 </span><code title=dom-insertAdjacentHTML><a href=#dom-insertadjacenthtml>insertAdjacentHTML()</a></code></h4>
+  <h4 id=insertadjacenthtml()><span class=secno>3.6.6 </span><code title=dom-insertAdjacentHTML><a href=#dom-insertadjacenthtml>insertAdjacentHTML()</a></code></h4>
 
   <dl class=domintro><dt><var title="">element</var> . <code title=dom-insertAdjacentHTML><a href=#dom-insertadjacenthtml>insertAdjacentHTML</a></code>(<var title="">position</var>, <var title="">text</var>)</dt>
 
@@ -33831,7 +33880,6 @@
    <li><p>If the method invoked was the <code title=dom-input-stepDown><a href=#dom-input-stepdown>stepDown()</a></code> method, negate <var title="">delta</var>.</li>
 
    <li><p>Let <var title="">value</var> be the result of adding <var title="">delta</var> to <var title="">value</var>.</li>
-
    <li><p>If the element has a <a href=#concept-input-min title=concept-input-min>minimum</a>, and the <var title="">value</var> is less than that <a href=#concept-input-min title=concept-input-min>minimum</a>, then throw a
    <code><a href=#invalid_access_err>INVALID_ACCESS_ERR</a></code> exception.</li>
 

Modified: source
===================================================================
--- source	2009-08-03 03:24:43 UTC (rev 3526)
+++ source	2009-08-03 07:00:38 UTC (rev 3527)
@@ -8322,8 +8322,57 @@
 
 
 
-  <h3>Content models</h3>
+  <h4>Element definitions</h4>
 
+  <p>Each element in this specification has a definition that includes
+  the following information:</p>
+
+  <dl>
+
+   <dt>Categories</dt>
+
+   <dd>A list of <span title="content categories">categories</span> to
+   which the element belongs. These are used when defining the
+   <span>content models</span> for each element.</dd>
+
+
+   <dt>Contexts in which this element may be used</dt>
+
+   <dd>A <em>non-normative</em> description of where the element can
+   be used. This information is redundant with the content models of
+   elements that allow this one as a child, and is provided only as a
+   convenience.</dd>
+
+
+   <dt>Content model</dt>
+
+   <dd>A normative description of what content must be included as
+   children and descendants of the element.</dd>
+
+
+   <dt>Content attributes</dt>
+
+   <dd>A normative list of attributes that may be specified on the
+   element.</dd>
+
+
+   <dt>DOM interface</dt>
+
+   <dd>A normative definition of a DOM interface that such elements
+   must implement.</dd>
+
+  </dl>
+
+  <p>This is then followed by a description of what the element
+  <span>represents</span>, along with any additional normative
+  conformance criteria that may apply to authors<span title=""
+  class="impl"> and implementations</span>. Examples are sometimes
+  also included.</p>
+
+
+
+  <h4><dfn>Content models</dfn></h4>
+
   <p>All the elements in this specification have a defined content
   model, which describes what nodes are allowed inside the elements,
   and thus what the structure of an HTML document or fragment must
@@ -8394,11 +8443,12 @@
   </div>
 
 
-  <h4>Kinds of content</h4>
+  <h5>Kinds of content</h5>
 
-  <p>Each element in HTML falls into zero or more categories that
-  group elements with similar characteristics together. The following
-  broad categories are used in this specification:</p>
+  <p>Each element in HTML falls into zero or more <dfn title="content
+  categories">categories</dfn> that group elements with similar
+  characteristics together. The following broad categories are used in
+  this specification:</p>
 
   <ul class="brief">
    <li><span>Metadata content</span></li>
@@ -8410,8 +8460,11 @@
    <li><span>Interactive content</span></li>
   </ul>
 
-  <p>These categories are related as follows:
+  <p class="note">Some elements also fall into other categories, which
+  are defined in other parts of this specification.</p>
 
+  <p>These categories are related as follows:</p>
+
   <p><object width="512" height="288"
   data="images/content-venn.svg"><img src="images/content-venn.png"
   alt="Sectioning content, heading content, phrasing content, and
@@ -8430,7 +8483,7 @@
   particular category.</p>
 
 
-  <h5>Metadata content</h5>
+  <h6>Metadata content</h6>
 
   <p><dfn>Metadata content</dfn> is content that sets up the
   presentation or behavior of the rest of the content, or that sets
@@ -8481,7 +8534,7 @@
   </div>
 
 
-  <h5>Flow content</h5>
+  <h6>Flow content</h6>
 
   <p>Most elements that are used in the body of documents and
   applications are categorized as <dfn>flow content</dfn>.</p>
@@ -8588,7 +8641,7 @@
   pages be filled in but on some pages is not relevant.</p>
 
 
-  <h5>Sectioning content</h5>
+  <h6>Sectioning content</h6>
 
   <p><dfn>Sectioning content</dfn> is content that defines the scope
   of <span title="heading content">headings</span> and <span
@@ -8611,7 +8664,7 @@
   <span>outline</span>.</p>
 
 
-  <h5>Heading content</h5>
+  <h6>Heading content</h6>
 
   <p><dfn>Heading content</dfn> defines the header of a section
   (whether explicitly marked up using <span>sectioning content</span>
@@ -8628,7 +8681,7 @@
   </ul>
 
 
-  <h5>Phrasing content</h5>
+  <h6>Phrasing content</h6>
 
   <p><dfn>Phrasing content</dfn> is the text of the document, as well
   as elements that mark up that text at the intra-paragraph
@@ -8712,7 +8765,7 @@
   character">space characters</span>).</p>
 
 
-  <h5>Embedded content</h5>
+  <h6>Embedded content</h6>
 
   <p><dfn>Embedded content</dfn> is content that imports another
   resource into the document, or content from another vocabulary that
@@ -8741,7 +8794,7 @@
   element definitions state what the fallback is, if any.</p>
 
 
-  <h5>Interactive content</h5>
+  <h6>Interactive content</h6>
 
 <!--
 TESTS:
@@ -8882,7 +8935,7 @@
   </div>
 
 
-  <h4>Transparent content models</h4>
+  <h5>Transparent content models</h5>
 
   <p>Some elements are described as <dfn>transparent</dfn>; they have
   "transparent" in the description of their content model.</p>
@@ -8898,7 +8951,7 @@
   accepting any <span>flow content</span>.</p>
 
 
-  <h3>Paragraphs</h3>
+  <h5>Paragraphs</h5>
 
   <p class="note">The term <span>paragraph</span> as defined in this
   section is distinct from (though related to) the <code>p</code>
@@ -37690,7 +37743,6 @@
 
    <li><p>Let <var title="">value</var> be the result of adding <var
    title="">delta</var> to <var title="">value</var>.</p></li>
-
    <li><p>If the element has a <span
    title="concept-input-min">minimum</span>, and the <var
    title="">value</var> is less than that <span




More information about the Commit-Watchers mailing list