[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>÷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