[html5] r3640 - [e] (0) Fix minor stylistic issues; add a summary for text-level elements.

whatwg at whatwg.org whatwg at whatwg.org
Sun Aug 16 19:14:56 PDT 2009


Author: ianh
Date: 2009-08-16 19:14:55 -0700 (Sun, 16 Aug 2009)
New Revision: 3640

Modified:
   index
   source
Log:
[e] (0) Fix minor stylistic issues; add a summary for text-level elements.

Modified: index
===================================================================
--- index	2009-08-16 11:42:06 UTC (rev 3639)
+++ index	2009-08-17 02:14:55 UTC (rev 3640)
@@ -71,7 +71,7 @@
   <div class=head>
    <p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
    <h1>HTML 5</h1>
-   <h2 class="no-num no-toc" id=draft-standard-—-date:-01-jan-1901>Draft Standard — 16 August 2009</h2>
+   <h2 class="no-num no-toc" id=draft-standard-—-date:-01-jan-1901>Draft Standard — 17 August 2009</h2>
    <p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
    <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
    <!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -242,52 +242,51 @@
      <li><a href=#garbage-collection><span class=secno>2.8.9 </span>Garbage collection</a></ol></ol></li>
  <li><a href=#dom><span class=secno>3 </span>Semantics, structure, and APIs of HTML documents</a>
   <ol>
-   <li><a href=#semantics-intro><span class=secno>3.1 </span>Introduction</a></li>
-   <li><a href=#documents><span class=secno>3.2 </span>Documents</a>
+   <li><a href=#documents><span class=secno>3.1 </span>Documents</a>
     <ol>
-     <li><a href=#documents-in-the-dom><span class=secno>3.2.1 </span>Documents in the DOM</a></li>
-     <li><a href=#security><span class=secno>3.2.2 </span>Security</a></li>
-     <li><a href=#resource-metadata-management><span class=secno>3.2.3 </span>Resource metadata management</a></li>
-     <li><a href=#dom-tree-accessors><span class=secno>3.2.4 </span>DOM tree accessors</a></ol></li>
-   <li><a href=#elements><span class=secno>3.3 </span>Elements</a>
+     <li><a href=#documents-in-the-dom><span class=secno>3.1.1 </span>Documents in the DOM</a></li>
+     <li><a href=#security><span class=secno>3.1.2 </span>Security</a></li>
+     <li><a href=#resource-metadata-management><span class=secno>3.1.3 </span>Resource metadata management</a></li>
+     <li><a href=#dom-tree-accessors><span class=secno>3.1.4 </span>DOM tree accessors</a></ol></li>
+   <li><a href=#elements><span class=secno>3.2 </span>Elements</a>
     <ol>
-     <li><a href=#semantics-0><span class=secno>3.3.1 </span>Semantics</a></li>
-     <li><a href=#elements-in-the-dom><span class=secno>3.3.2 </span>Elements in the DOM</a></li>
-     <li><a href=#global-attributes><span class=secno>3.3.3 </span>Global attributes</a>
+     <li><a href=#semantics-0><span class=secno>3.2.1 </span>Semantics</a></li>
+     <li><a href=#elements-in-the-dom><span class=secno>3.2.2 </span>Elements in the DOM</a></li>
+     <li><a href=#global-attributes><span class=secno>3.2.3 </span>Global attributes</a>
       <ol>
-       <li><a href=#the-id-attribute><span class=secno>3.3.3.1 </span>The <code>id</code> attribute</a></li>
-       <li><a href=#the-title-attribute><span class=secno>3.3.3.2 </span>The <code>title</code> attribute</a></li>
-       <li><a href=#the-lang-and-xml:lang-attributes><span class=secno>3.3.3.3 </span>The <code title=attr-lang>lang</code> and <code title=attr-xml-lang>xml:lang</code> attributes</a></li>
-       <li><a href=#the-xml:base-attribute-(xml-only)><span class=secno>3.3.3.4 </span>The <code>xml:base</code>
+       <li><a href=#the-id-attribute><span class=secno>3.2.3.1 </span>The <code>id</code> attribute</a></li>
+       <li><a href=#the-title-attribute><span class=secno>3.2.3.2 </span>The <code>title</code> attribute</a></li>
+       <li><a href=#the-lang-and-xml:lang-attributes><span class=secno>3.2.3.3 </span>The <code title=attr-lang>lang</code> and <code title=attr-xml-lang>xml:lang</code> attributes</a></li>
+       <li><a href=#the-xml:base-attribute-(xml-only)><span class=secno>3.2.3.4 </span>The <code>xml:base</code>
   attribute (XML only)</a></li>
-       <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></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>
+       <li><a href=#the-dir-attribute><span class=secno>3.2.3.5 </span>The <code>dir</code> attribute</a></li>
+       <li><a href=#classes><span class=secno>3.2.3.6 </span>The <code>class</code> attribute</a></li>
+       <li><a href=#the-style-attribute><span class=secno>3.2.3.7 </span>The <code>style</code> attribute</a></li>
+       <li><a href=#embedding-custom-non-visible-data><span class=secno>3.2.3.8 </span>Embedding custom non-visible data</a></ol></li>
+     <li><a href=#element-definitions><span class=secno>3.2.4 </span>Element definitions</a></li>
+     <li><a href=#content-models><span class=secno>3.2.5 </span>Content models</a>
       <ol>
-       <li><a href=#kinds-of-content><span class=secno>3.3.5.1 </span>Kinds of content</a>
+       <li><a href=#kinds-of-content><span class=secno>3.2.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>
+         <li><a href=#metadata-content><span class=secno>3.2.5.1.1 </span>Metadata content</a></li>
+         <li><a href=#flow-content><span class=secno>3.2.5.1.2 </span>Flow content</a></li>
+         <li><a href=#sectioning-content><span class=secno>3.2.5.1.3 </span>Sectioning content</a></li>
+         <li><a href=#heading-content><span class=secno>3.2.5.1.4 </span>Heading content</a></li>
+         <li><a href=#phrasing-content><span class=secno>3.2.5.1.5 </span>Phrasing content</a></li>
+         <li><a href=#embedded-content><span class=secno>3.2.5.1.6 </span>Embedded content</a></li>
+         <li><a href=#interactive-content><span class=secno>3.2.5.1.7 </span>Interactive content</a></ol></li>
+       <li><a href=#transparent-content-models><span class=secno>3.2.5.2 </span>Transparent content models</a></li>
+       <li><a href=#paragraphs><span class=secno>3.2.5.3 </span>Paragraphs</a></ol></ol></li>
+   <li><a href=#apis-in-html-documents><span class=secno>3.3 </span>APIs in HTML documents</a></li>
+   <li><a href=#interactions-with-xpath-and-xslt><span class=secno>3.4 </span>Interactions with XPath and XSLT</a></li>
+   <li><a href=#dynamic-markup-insertion><span class=secno>3.5 </span>Dynamic markup insertion</a>
     <ol>
-     <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=#controlling-the-input-stream><span class=secno>3.5.1 </span>Controlling the input stream</a></li>
+     <li><a href=#document.write()><span class=secno>3.5.2 </span><code title=dom-document-write>document.write()</code></a></li>
+     <li><a href=#document.writeln()><span class=secno>3.5.3 </span><code title=dom-document-writeln>document.writeln()</code></a></li>
+     <li><a href=#innerhtml><span class=secno>3.5.4 </span><code title=dom-innerHTML>innerHTML</code></a></li>
+     <li><a href=#outerhtml><span class=secno>3.5.5 </span><code title=dom-outerHTML>outerHTML</code></a></li>
+     <li><a href=#insertadjacenthtml()><span class=secno>3.5.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>
@@ -6485,15 +6484,8 @@
 
   <h2 id=dom><span class=secno>3 </span>Semantics, structure, and APIs of HTML documents</h2>
 
-  <h3 id=semantics-intro><span class=secno>3.1 </span>Introduction</h3>
+  <h3 id=documents><span class=secno>3.1 </span>Documents</h3>
 
-  <p><i>This section is non-normative.</i></p>
-
-  <p class=XXX>An introduction to marking up a document.</p>
-
-
-  <h3 id=documents><span class=secno>3.2 </span>Documents</h3>
-
   <p>Every XML and HTML document in an HTML UA is represented by a
   <code>Document</code> object. <a href=#refsDOMCORE>[DOMCORE]</a></p>
 
@@ -6527,7 +6519,7 @@
 
 
 
-  <h4 id=documents-in-the-dom><span class=secno>3.2.1 </span>Documents in the DOM</h4>
+  <h4 id=documents-in-the-dom><span class=secno>3.1.1 </span>Documents in the DOM</h4>
 
   <p>All <code>Document</code> objects (in user agents implementing
   this specification) <span class=impl>must</span> also implement
@@ -6665,7 +6657,7 @@
   this interface are described in various different sections.</p>
 
 
-  <h4 id=security><span class=secno>3.2.2 </span>Security</h4>
+  <h4 id=security><span class=secno>3.1.2 </span>Security</h4>
 
   <p>User agents <span class=impl>must</span> raise a
   <code><a href=#security_err>SECURITY_ERR</a></code> exception whenever any of the members of
@@ -6676,7 +6668,7 @@
 
 
 
-  <h4 id=resource-metadata-management><span class=secno>3.2.3 </span><dfn>Resource metadata management</dfn></h4>
+  <h4 id=resource-metadata-management><span class=secno>3.1.3 </span><dfn>Resource metadata management</dfn></h4>
 
   <dl class=domintro><dt><var title="">document</var> . <code title=dom-document-URL><a href=#dom-document-url>URL</a></code></dt>
    <dd>
@@ -6939,7 +6931,7 @@
 
 
 
-  <h4 id=dom-tree-accessors><span class=secno>3.2.4 </span><dfn>DOM tree accessors</dfn></h4>
+  <h4 id=dom-tree-accessors><span class=secno>3.1.4 </span><dfn>DOM tree accessors</dfn></h4>
 
   <p><dfn id=the-html-element-0>The <code>html</code> element</dfn> of a document is the
   document's root element, if there is one and it's an
@@ -7317,9 +7309,9 @@
 
 
 
-  <h3 id=elements><span class=secno>3.3 </span>Elements</h3>
+  <h3 id=elements><span class=secno>3.2 </span>Elements</h3>
 
-  <h4 id=semantics-0><span class=secno>3.3.1 </span>Semantics</h4>
+  <h4 id=semantics-0><span class=secno>3.2.1 </span>Semantics</h4>
 
   <p>Elements, attributes, and attribute values in HTML are defined
   (by this specification) to have certain meanings (semantics). For
@@ -7420,7 +7412,7 @@
 
 
 
-  <h4 id=elements-in-the-dom><span class=secno>3.3.2 </span>Elements in the DOM</h4>
+  <h4 id=elements-in-the-dom><span class=secno>3.2.2 </span>Elements in the DOM</h4>
 
   <p>The nodes representing <a href=#html-elements>HTML elements</a> in the DOM
   <span class=impl>must</span> implement, and expose to scripts, the
@@ -7567,7 +7559,7 @@
 
 
 
-  <h4 id=global-attributes><span class=secno>3.3.3 </span><dfn>Global attributes</dfn></h4>
+  <h4 id=global-attributes><span class=secno>3.2.3 </span><dfn>Global attributes</dfn></h4>
 
   <p>The following attributes are common to and may be specified on
   all <a href=#html-elements>HTML elements</a><span class=impl> (even those not
@@ -7676,7 +7668,7 @@
   namespace specified.</p>
 
 
-  <h5 id=the-id-attribute><span class=secno>3.3.3.1 </span>The <dfn title=attr-id><code>id</code></dfn> attribute</h5>
+  <h5 id=the-id-attribute><span class=secno>3.2.3.1 </span>The <dfn title=attr-id><code>id</code></dfn> attribute</h5>
 
   <p>The <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute
   <a href=#represents>represents</a> its element's unique identifier. The value
@@ -7715,7 +7707,7 @@
   </div>
 
 
-  <h5 id=the-title-attribute><span class=secno>3.3.3.2 </span>The <dfn title=attr-title><code>title</code></dfn> attribute</h5>
+  <h5 id=the-title-attribute><span class=secno>3.2.3.2 </span>The <dfn title=attr-title><code>title</code></dfn> attribute</h5>
 
   <p>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute
   <a href=#represents>represents</a> advisory information for the element, such
@@ -7766,7 +7758,7 @@
 
 
 
-  <h5 id=the-lang-and-xml:lang-attributes><span class=secno>3.3.3.3 </span>The <code title=attr-lang><a href=#attr-lang>lang</a></code> and <code title=attr-xml-lang><a href=#attr-xml-lang>xml:lang</a></code> attributes</h5>
+  <h5 id=the-lang-and-xml:lang-attributes><span class=secno>3.2.3.3 </span>The <code title=attr-lang><a href=#attr-lang>lang</a></code> and <code title=attr-xml-lang><a href=#attr-xml-lang>xml:lang</a></code> attributes</h5>
 
   <p>The <dfn id=attr-lang title=attr-lang><code>lang</code></dfn> attribute (in
   no namespace) specifies the primary <dfn id=language>language</dfn> for the
@@ -7854,7 +7846,7 @@
   </div>
 
 
-  <h5 id=the-xml:base-attribute-(xml-only)><span class=secno>3.3.3.4 </span>The <dfn title=attr-xml-base><code>xml:base</code></dfn>
+  <h5 id=the-xml:base-attribute-(xml-only)><span class=secno>3.2.3.4 </span>The <dfn title=attr-xml-base><code>xml:base</code></dfn>
   attribute (XML only)</h5>
 
   <p>The <code title=attr-xml-base><a href=#the-xml:base-attribute-(xml-only)>xml:base</a></code> attribute is
@@ -7866,7 +7858,7 @@
   <a href=#html-documents>HTML documents</a>.</p>
 
 
-  <h5 id=the-dir-attribute><span class=secno>3.3.3.5 </span>The <dfn title=attr-dir><code>dir</code></dfn> attribute</h5>
+  <h5 id=the-dir-attribute><span class=secno>3.2.3.5 </span>The <dfn title=attr-dir><code>dir</code></dfn> attribute</h5>
 
   <p>The <code title=attr-dir><a href=#the-dir-attribute>dir</a></code> attribute specifies the
   element's text directionality. The attribute is an <a href=#enumerated-attribute>enumerated
@@ -7930,7 +7922,7 @@
   by search engines).</p>
 
 
-  <h5 id=classes><span class=secno>3.3.3.6 </span>The <dfn title=attr-class><code>class</code></dfn> attribute</h5>
+  <h5 id=classes><span class=secno>3.2.3.6 </span>The <dfn title=attr-class><code>class</code></dfn> attribute</h5>
 
   <p>Every <a href=#html-elements title="HTML elements">HTML element</a> may have a
   <code title=attr-class><a href=#classes>class</a></code> attribute specified.</p>
@@ -7968,7 +7960,7 @@
 
 
 
-  <h5 id=the-style-attribute><span class=secno>3.3.3.7 </span>The <dfn title=attr-style><code>style</code></dfn> attribute</h5>
+  <h5 id=the-style-attribute><span class=secno>3.2.3.7 </span>The <dfn title=attr-style><code>style</code></dfn> attribute</h5>
 
   <p>All <a href=#html-elements>HTML elements</a> may have the <code title=attr-style><a href=#the-style-attribute>style</a></code> content attribute set. If specified,
   the attribute must contain only a list of zero or more
@@ -8028,7 +8020,7 @@
 
 
 
-  <h5 id=embedding-custom-non-visible-data><span class=secno>3.3.3.8 </span><dfn>Embedding custom non-visible data</dfn></h5>
+  <h5 id=embedding-custom-non-visible-data><span class=secno>3.2.3.8 </span><dfn>Embedding custom non-visible data</dfn></h5>
 
   <p>A <dfn id=custom-data-attribute>custom data attribute</dfn> is an attribute in no
   namespace whose name starts with the string "<dfn id=attr-data-* title=attr-data-*><code>data-</code></dfn>", has at least one
@@ -8169,7 +8161,7 @@
 
 
 
-  <h4 id=element-definitions><span class=secno>3.3.4 </span>Element definitions</h4>
+  <h4 id=element-definitions><span class=secno>3.2.4 </span>Element definitions</h4>
 
   <p>Each element in this specification has a definition that includes
   the following information:</p>
@@ -8213,7 +8205,7 @@
 
 
 
-  <h4 id=content-models><span class=secno>3.3.5 </span><dfn>Content models</dfn></h4>
+  <h4 id=content-models><span class=secno>3.2.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,
@@ -8278,7 +8270,7 @@
   </div>
 
 
-  <h5 id=kinds-of-content><span class=secno>3.3.5.1 </span>Kinds of content</h5>
+  <h5 id=kinds-of-content><span class=secno>3.2.5.1 </span>Kinds of content</h5>
 
   <p>Each element in HTML falls into zero or more <dfn id=content-categories title="content
   categories">categories</dfn> that group elements with similar
@@ -8305,14 +8297,11 @@
   further subcategorized to define their role in various form-related
   processing models.</p>
 
-  <!-- XXX list all the elements for each kind of element in the
-  sections below and in a summary table at the end of the document -->
-
   <p>Some elements have unique requirements and do not fit into any
   particular category.</p>
 
 
-  <h6 id=metadata-content><span class=secno>3.3.5.1.1 </span>Metadata content</h6>
+  <h6 id=metadata-content><span class=secno>3.2.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
@@ -8360,7 +8349,7 @@
   </div>
 
 
-  <h6 id=flow-content><span class=secno>3.3.5.1.2 </span>Flow content</h6>
+  <h6 id=flow-content><span class=secno>3.2.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>
@@ -8463,7 +8452,7 @@
   pages be filled in but on some pages is not relevant.</p>
 
 
-  <h6 id=sectioning-content><span class=secno>3.3.5.1.3 </span>Sectioning content</h6>
+  <h6 id=sectioning-content><span class=secno>3.2.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>
@@ -8481,7 +8470,7 @@
   <a href=#outline>outline</a>.</p>
 
 
-  <h6 id=heading-content><span class=secno>3.3.5.1.4 </span>Heading content</h6>
+  <h6 id=heading-content><span class=secno>3.2.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>
@@ -8494,7 +8483,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><h6 id=phrasing-content><span class=secno>3.3.5.1.5 </span>Phrasing content</h6>
+  </ul><h6 id=phrasing-content><span class=secno>3.2.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
@@ -8572,7 +8561,7 @@
   character">space characters</a>).</p>
 
 
-  <h6 id=embedded-content><span class=secno>3.3.5.1.6 </span>Embedded content</h6>
+  <h6 id=embedded-content><span class=secno>3.2.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
@@ -8598,7 +8587,7 @@
   element definitions state what the fallback is, if any.</p>
 
 
-  <h6 id=interactive-content><span class=secno>3.3.5.1.7 </span>Interactive content</h6>
+  <h6 id=interactive-content><span class=secno>3.2.5.1.7 </span>Interactive content</h6>
 
 <!--
 TESTS:
@@ -8719,7 +8708,7 @@
   </div>
 
 
-  <h5 id=transparent-content-models><span class=secno>3.3.5.2 </span>Transparent content models</h5>
+  <h5 id=transparent-content-models><span class=secno>3.2.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>
@@ -8735,7 +8724,7 @@
   accepting any <a href=#flow-content-0>flow content</a>.</p>
 
 
-  <h5 id=paragraphs><span class=secno>3.3.5.3 </span>Paragraphs</h5>
+  <h5 id=paragraphs><span class=secno>3.2.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>
@@ -8914,7 +8903,7 @@
 
 
 
-  <h3 id=apis-in-html-documents><span class=secno>3.4 </span>APIs in HTML documents</h3>
+  <h3 id=apis-in-html-documents><span class=secno>3.3 </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
@@ -9028,7 +9017,7 @@
 
   </dl><div class=impl>
 
-  <h3 id=interactions-with-xpath-and-xslt><span class=secno>3.5 </span>Interactions with XPath and XSLT</h3>
+  <h3 id=interactions-with-xpath-and-xslt><span class=secno>3.4 </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
@@ -9076,7 +9065,7 @@
 
 
 
-  <h3 id=dynamic-markup-insertion><span class=secno>3.6 </span><dfn>Dynamic markup insertion</dfn></h3>
+  <h3 id=dynamic-markup-insertion><span class=secno>3.5 </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
@@ -9086,7 +9075,7 @@
 
 
 
-  <h4 id=controlling-the-input-stream><span class=secno>3.6.1 </span>Controlling the input stream</h4>
+  <h4 id=controlling-the-input-stream><span class=secno>3.5.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
@@ -9294,7 +9283,7 @@
 
 
 
-  <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>
+  <h4 id=document.write()><span class=secno>3.5.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>
 
@@ -9380,7 +9369,7 @@
   </ol></div>
 
 
-  <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>
+  <h4 id=document.writeln()><span class=secno>3.5.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>
 
@@ -9407,7 +9396,7 @@
 
 
 
-  <h4 id=innerhtml><span class=secno>3.6.4 </span><code title=dom-innerHTML><a href=#dom-innerhtml>innerHTML</a></code></h4>
+  <h4 id=innerhtml><span class=secno>3.5.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>
@@ -9525,7 +9514,7 @@
 
 
 
-  <h4 id=outerhtml><span class=secno>3.6.5 </span><code title=dom-outerHTML><a href=#dom-outerhtml>outerHTML</a></code></h4>
+  <h4 id=outerhtml><span class=secno>3.5.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>
@@ -9634,7 +9623,7 @@
 
 
 
-  <h4 id=insertadjacenthtml()><span class=secno>3.6.6 </span><code title=dom-insertAdjacentHTML><a href=#dom-insertadjacenthtml>insertAdjacentHTML()</a></code></h4>
+  <h4 id=insertadjacenthtml()><span class=secno>3.5.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>
 
@@ -16513,10 +16502,8 @@
 
   </div>
 
-  <!-- XXX need examples -->
 
 
-
   <h4 id=the-ruby-element><span class=secno>4.6.22 </span>The <dfn><code>ruby</code></dfn> element</h4>
 
   <dl class=element><dt>Categories</dt>
@@ -16548,8 +16535,8 @@
    <!-- this is the kanji for the word "kanji" ("chinese character") in japanese -->
    <!-- in japanese, ruby-like typography is called "furigana" -->
 
-   <p>In this example, each ideograph in the Japanese text <span lang=ja>漢字</span> is annotated with its kanji
-   reading.</p>
+   <p>In this example, each ideograph in the Japanese text <span lang=ja title="">漢字</span> is annotated with its
+   kanji reading.</p>
 
    <pre lang=ja>...
 <ruby>
@@ -16569,8 +16556,8 @@
    <!-- this is the bopomofo for the word "hanzi" ("chinese character") in traditional chinese, as used in taiwan -->
 
    <p>In this example, each ideograph in the traditional Chinese text
-   <span lang=zh-TW>漢字</span> is annotated with its
-   bopomofo reading.</p>
+   <span lang=zh-TW title="">漢字</span> is annotated
+   with its bopomofo reading.</p>
 
    <pre lang=zh-TW><ruby>
  漢 <rt> ㄏㄢˋ </rt>
@@ -16588,8 +16575,8 @@
    <!-- this is the pinyin for the word "hanzi" ("chinese character") in simplified chinese, as used in mainland china -->
 
    <p>In this example, each ideograph in the simplified Chinese text
-   <span lang=zh-CN>汉字</span> is annotated with its
-   pinyin reading.</p>
+   <span lang=zh-CN title="">汉字</span> is annotated
+   with its pinyin reading.</p>
 
    <pre lang=zh-CN>...
 <ruby>
@@ -16666,9 +16653,9 @@
 
   <div class=example>
 
-   <p>The example above, in which each ideograph in the text <span lang=ja>漢字</span> is annotated with its kanji
-   reading, could be expanded to use <code><a href=#the-rp-element>rp</a></code> so that in legacy
-   user agents the readings are in parentheses:</p>
+   <p>The example above, in which each ideograph in the text <span lang=ja title="">漢字</span> is annotated with its
+   kanji reading, could be expanded to use <code><a href=#the-rp-element>rp</a></code> so that in
+   legacy user agents the readings are in parentheses:</p>
 
    <pre lang=ja>...
 <ruby>
@@ -16688,15 +16675,105 @@
 
   <h4 id=usage-summary><span class=secno>4.6.25 </span>Usage summary</h4>
 
-  <p class=XXX>We need to summarize the various elements, in
-  particular to distinguish b/i/em/strong/var/q/mark/cite.</p>
+  <p><i>This section is non-normative.</i></p>
 
-  <!-- XXX when you do this, also reorder the elements in this section
-  to bring the related ones closer together. -->
+  <table><thead><tr><th>Element
+     <th>Purpose
+     <th>Example
+   <tbody><tr><td><code><a href=#the-a-element>a</a></code>
+     <td>Hyperlinks
+     <td><pre class=example>Visit my <strong><a href="drinks.html">drinks</a></strong> page.</pre>
 
+    <tr><td><code><a href=#the-em-element>em</a></code>
+     <td>Stress emphasis
+     <td><pre class=example>I must say I <strong><em>adore</em></strong> lemonade.</pre>
 
-  <h4 id=footnotes><span class=secno>4.6.26 </span>Footnotes</h4>
+    <tr><td><code><a href=#the-strong-element>strong</a></code>
+     <td>Importance
+     <td><pre class=example>This tea is <strong><strong>very hot</strong></strong>.</pre>
 
+    <tr><td><code><a href=#the-small-element>small</a></code>
+     <td>Side comments
+     <td><pre class=example>These grapes are made into wine. <strong><small>Alcohol is addictive.</small></strong></pre>
+
+    <tr><td><code><a href=#the-cite-element>cite</a></code>
+     <td>Titles of works
+     <td><pre class=example>The case <strong><cite>Hugo v. Danielle</cite></strong> is relevant here.</pre>
+
+    <tr><td><code><a href=#the-q-element>q</a></code>
+     <td>Quotations
+     <td><pre class=example>The judge said <strong><q>You can drink water from the fish tank</q></strong> but advised against it.</pre>
+
+    <tr><td><code><a href=#the-dfn-element>dfn</a></code>
+     <td>Defining instance
+     <td><pre class=example>The term <strong><dfn>organic food</dfn></strong> refers to food produced without synthetic chemicals.</pre>
+
+    <tr><td><code><a href=#the-code-element>code</a></code>
+     <td>Computer code
+     <td><pre class=example>The <strong><code>fruitdb</code></strong> program can be used for tracking fruit production.</pre>
+
+    <tr><td><code><a href=#the-var-element>var</a></code>
+     <td>Variables
+     <td><pre class=example>If there are <strong><var>n</var></strong> fruit in the bowl, at least <strong><var>n</var></strong>÷2 will be ripe.</pre>
+
+    <tr><td><code><a href=#the-samp-element>samp</a></code>
+     <td>Computer output
+     <td><pre class=example>The computer said <strong><samp>Unknown error -3</samp></strong>.</pre>
+
+    <tr><td><code><a href=#the-kbd-element>kbd</a></code>
+     <td>Computer input
+     <td><pre class=example>Hit <strong><kbd>F1</kbd></strong> to continue.</pre>
+
+    <tr><td><code><a href=#the-abbr-element>abbr</a></code>
+     <td>Abbreviations
+     <td><pre class=example>Organic food in Ireland is certified by the <strong><abbr title="Irish Organic Farmers and Growers Association">IOFGA</abbr></strong>.</pre>
+
+    <tr><td><code><a href=#the-sub-and-sup-elements>sub</a></code>
+     <td>Subscripts
+     <td><pre class=example>Water is H<strong><sub>2</sub></strong>O.</pre>
+
+    <tr><td><code><a href=#the-sub-and-sup-elements>sup</a></code>
+     <td>Superscripts
+     <td><pre class=example>The Hydrogen in heavy water is usually <strong><sup>2</sup></strong>H.</pre>
+
+    <tr><td><code><a href=#the-i-element>i</a></code>
+     <td>Alternative voice
+     <td><pre class=example>Lemonade consists primarily of <strong><i>Citrus limon</i></strong>.</pre>
+
+    <tr><td><code><a href=#the-b-element>b</a></code>
+     <td>Keywords
+     <td><pre class=example>Take a <strong><b>lemon</b></strong> and squeeze it with a <strong><b>juicer</b></strong>.</pre>
+
+    <tr><td><code><a href=#the-mark-element>mark</a></code>
+     <td>Highlight
+     <td><pre class=example>Elderflower cordial, with one <strong><mark>part</mark></strong> cordial to ten <strong><mark>part</mark></strong>s water, stands a<strong><mark>part</mark></strong> from the rest.</pre>
+
+    <tr><td><code><a href=#the-progress-element>progress</a></code>
+     <td>Progress bar
+     <td><pre class=example>Copying: <strong><progress>75%</progress></strong></pre>
+
+    <tr><td><code><a href=#the-meter-element>meter</a></code>
+     <td>Gauge
+     <td><pre class=example>Disk space remaining: <meter>75%<meter></pre>
+
+    <tr><td><code><a href=#the-time-element>time</a></code>
+     <td>Date and/or time
+     <td><pre class=example>Published <strong><time>2009-10-21</time></strong>.</pre>
+
+    <tr><td><code><a href=#the-ruby-element>ruby</a></code>, <code><a href=#the-rt-element>rt</a></code>, <code><a href=#the-rp-element>rp</a></code>
+     <td>Ruby annotations
+     <td><pre class=example><strong><ruby> OJ <rp>(<rt>Orange Juice<rp>)</ruby></strong></pre>
+
+    <tr><td><code><a href=#the-bdo-element>bdo</a></code>
+     <td>Text directionality formatting
+     <td><pre class=example>The proposal is to write English, but in reverse order. "Juice" would become "<strong><bdo dir=rtl>Juice</bdo></strong>"</pre>
+
+    <tr><td><code><a href=#the-span-element>span</a></code>
+     <td>Other
+     <td><pre class=example>In French we call it <strong><span lang="fr">sirop de sureau</span></strong>.</pre>
+
+  </table><h4 id=footnotes><span class=secno>4.6.26 </span>Footnotes</h4>
+
   <p>HTML does not have a dedicated mechanism for marking up
   footnotes. Here are the recommended alternatives.</p>
 

Modified: source
===================================================================
--- source	2009-08-16 11:42:06 UTC (rev 3639)
+++ source	2009-08-17 02:14:55 UTC (rev 3640)
@@ -6440,13 +6440,6 @@
 
   <h2 id="dom">Semantics, structure, and APIs of HTML documents</h2>
 
-  <h3 id="semantics-intro">Introduction</h3>
-
-  <p><i>This section is non-normative.</i></p>
-
-  <p class="XXX">An introduction to marking up a document.</p>
-
-
   <h3>Documents</h3>
 
   <p>Every XML and HTML document in an HTML UA is represented by a
@@ -8510,9 +8503,6 @@
   further subcategorized to define their role in various form-related
   processing models.</p>
 
-  <!-- XXX list all the elements for each kind of element in the
-  sections below and in a summary table at the end of the document -->
-
   <p>Some elements have unique requirements and do not fit into any
   particular category.</p>
 
@@ -17647,10 +17637,8 @@
 
   </div>
 
-  <!-- XXX need examples -->
 
 
-
   <h4>The <dfn><code>ruby</code></dfn> element</h4>
 
   <dl class="element">
@@ -17686,8 +17674,8 @@
    <!-- in japanese, ruby-like typography is called "furigana" -->
 
    <p>In this example, each ideograph in the Japanese text <span
-   lang="ja">漢字</span> is annotated with its kanji
-   reading.</p>
+   title="" lang="ja">漢字</span> is annotated with its
+   kanji reading.</p>
 
    <pre lang="ja">...
 <ruby>
@@ -17708,8 +17696,8 @@
    <!-- this is the bopomofo for the word "hanzi" ("chinese character") in traditional chinese, as used in taiwan -->
 
    <p>In this example, each ideograph in the traditional Chinese text
-   <span lang="zh-TW">漢字</span> is annotated with its
-   bopomofo reading.</p>
+   <span title="" lang="zh-TW">漢字</span> is annotated
+   with its bopomofo reading.</p>
 
    <pre lang="zh-TW"><ruby>
  漢 <rt> ㄏㄢˋ </rt>
@@ -17728,8 +17716,8 @@
    <!-- this is the pinyin for the word "hanzi" ("chinese character") in simplified chinese, as used in mainland china -->
 
    <p>In this example, each ideograph in the simplified Chinese text
-   <span lang="zh-CN">汉字</span> is annotated with its
-   pinyin reading.</p>
+   <span title="" lang="zh-CN">汉字</span> is annotated
+   with its pinyin reading.</p>
 
    <pre lang="zh-CN">...
 <ruby>
@@ -17814,9 +17802,9 @@
   <div class="example">
 
    <p>The example above, in which each ideograph in the text <span
-   lang="ja">漢字</span> is annotated with its kanji
-   reading, could be expanded to use <code>rp</code> so that in legacy
-   user agents the readings are in parentheses:</p>
+   title="" lang="ja">漢字</span> is annotated with its
+   kanji reading, could be expanded to use <code>rp</code> so that in
+   legacy user agents the readings are in parentheses:</p>
 
    <pre lang="ja">...
 <ruby>
@@ -17836,13 +17824,133 @@
 
   <h4>Usage summary</h4>
 
-  <p class="XXX">We need to summarize the various elements, in
-  particular to distinguish b/i/em/strong/var/q/mark/cite.</p>
+  <p><i>This section is non-normative.</i></p>
 
-  <!-- XXX when you do this, also reorder the elements in this section
-  to bring the related ones closer together. -->
+  <table>
+   <thead>
+    <tr>
+     <th>Element
+     <th>Purpose
+     <th>Example
+   <tbody>
+    <tr>
+     <td><code>a</code>
+     <td>Hyperlinks
+     <td><pre class="example">Visit my <strong><a href="drinks.html">drinks</a></strong> page.</pre>
 
+    <tr>
+     <td><code>em</code>
+     <td>Stress emphasis
+     <td><pre class="example">I must say I <strong><em>adore</em></strong> lemonade.</pre>
 
+    <tr>
+     <td><code>strong</code>
+     <td>Importance
+     <td><pre class="example">This tea is <strong><strong>very hot</strong></strong>.</pre>
+
+    <tr>
+     <td><code>small</code>
+     <td>Side comments
+     <td><pre class="example">These grapes are made into wine. <strong><small>Alcohol is addictive.</small></strong></pre>
+
+    <tr>
+     <td><code>cite</code>
+     <td>Titles of works
+     <td><pre class="example">The case <strong><cite>Hugo v. Danielle</cite></strong> is relevant here.</pre>
+
+    <tr>
+     <td><code>q</code>
+     <td>Quotations
+     <td><pre class="example">The judge said <strong><q>You can drink water from the fish tank</q></strong> but advised against it.</pre>
+
+    <tr>
+     <td><code>dfn</code>
+     <td>Defining instance
+     <td><pre class="example">The term <strong><dfn>organic food</dfn></strong> refers to food produced without synthetic chemicals.</pre>
+
+    <tr>
+     <td><code>code</code>
+     <td>Computer code
+     <td><pre class="example">The <strong><code>fruitdb</code></strong> program can be used for tracking fruit production.</pre>
+
+    <tr>
+     <td><code>var</code>
+     <td>Variables
+     <td><pre class="example">If there are <strong><var>n</var></strong> fruit in the bowl, at least <strong><var>n</var></strong>&#xf7;2 will be ripe.</pre>
+
+    <tr>
+     <td><code>samp</code>
+     <td>Computer output
+     <td><pre class="example">The computer said <strong><samp>Unknown error -3</samp></strong>.</pre>
+
+    <tr>
+     <td><code>kbd</code>
+     <td>Computer input
+     <td><pre class="example">Hit <strong><kbd>F1</kbd></strong> to continue.</pre>
+
+    <tr>
+     <td><code>abbr</code>
+     <td>Abbreviations
+     <td><pre class="example">Organic food in Ireland is certified by the <strong><abbr title="Irish Organic Farmers and Growers Association">IOFGA</abbr></strong>.</pre>
+
+    <tr>
+     <td><code>sub</code>
+     <td>Subscripts
+     <td><pre class="example">Water is H<strong><sub>2</sub></strong>O.</pre>
+
+    <tr>
+     <td><code>sup</code>
+     <td>Superscripts
+     <td><pre class="example">The Hydrogen in heavy water is usually <strong><sup>2</sup></strong>H.</pre>
+
+    <tr>
+     <td><code>i</code>
+     <td>Alternative voice
+     <td><pre class="example">Lemonade consists primarily of <strong><i>Citrus limon</i></strong>.</pre>
+
+    <tr>
+     <td><code>b</code>
+     <td>Keywords
+     <td><pre class="example">Take a <strong><b>lemon</b></strong> and squeeze it with a <strong><b>juicer</b></strong>.</pre>
+
+    <tr>
+     <td><code>mark</code>
+     <td>Highlight
+     <td><pre class="example">Elderflower cordial, with one <strong><mark>part</mark></strong> cordial to ten <strong><mark>part</mark></strong>s water, stands a<strong><mark>part</mark></strong> from the rest.</pre>
+
+    <tr>
+     <td><code>progress</code>
+     <td>Progress bar
+     <td><pre class="example">Copying: <strong><progress>75%</progress></strong></pre>
+
+    <tr>
+     <td><code>meter</code>
+     <td>Gauge
+     <td><pre class="example">Disk space remaining: <meter>75%<meter></pre>
+
+    <tr>
+     <td><code>time</code>
+     <td>Date and/or time
+     <td><pre class="example">Published <strong><time>2009-10-21</time></strong>.</pre>
+
+    <tr>
+     <td><code>ruby</code>, <code>rt</code>, <code>rp</code>
+     <td>Ruby annotations
+     <td><pre class="example"><strong><ruby> OJ <rp>(<rt>Orange Juice<rp>)</ruby></strong></pre>
+
+    <tr>
+     <td><code>bdo</code>
+     <td>Text directionality formatting
+     <td><pre class="example">The proposal is to write English, but in reverse order. "Juice" would become "<strong><bdo dir=rtl>Juice</bdo></strong>"</pre>
+
+    <tr>
+     <td><code>span</code>
+     <td>Other
+     <td><pre class="example">In French we call it <strong><span lang="fr">sirop de sureau</span></strong>.</pre>
+
+  </table>
+
+
   <h4 id="footnotes">Footnotes</h4>
 
   <p>HTML does not have a dedicated mechanism for marking up




More information about the Commit-Watchers mailing list