hixie: Update 'structure of this specification' section. (whatwg r3447)

hixie: Update 'structure of this specification' section. (whatwg r3447)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2571&r2=1.2572&f=h
http://html5.org/tools/web-apps-tracker?from=3446&to=3447

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2571
retrieving revision 1.2572
diff -u -d -r1.2571 -r1.2572
--- Overview.html 19 Jul 2009 10:54:02 -0000 1.2571
+++ Overview.html 19 Jul 2009 11:04:18 -0000 1.2572
@@ -739,7 +739,7 @@
      <li><a href="#the-legend-element"><span class="secno">4.12.1 </span>The <code>legend</code> element</a></li>
      <li><a href="#the-div-element"><span class="secno">4.12.2 </span>The <code>div</code> element</a></ol></li>
    <li><a href="#matching-html-elements-using-selectors"><span class="secno">4.13 </span>Matching HTML elements using selectors</a></ol></li>
- <li><a href="#microdata"><span class="secno">5 </span>Microdata</a>
+ <li><a href="#microdata-0"><span class="secno">5 </span>Microdata</a>
   <ol>
    <li><a href="#introduction-2"><span class="secno">5.1 </span>Introduction</a>
     <ol>
@@ -1158,7 +1158,7 @@
    <li><a href="#interaction-with-css"><span class="secno">11.8 </span>Interaction with CSS</a>
     <ol>
      <li><a href="#selectors"><span class="secno">11.8.1 </span>Selectors</a></ol></ol></li>
- <li><a href="#obsolete-features"><span class="secno">12 </span>Obsolete features</a>
+ <li><a href="#obsolete"><span class="secno">12 </span>Obsolete features</a>
   <ol>
    <li><a href="#conforming-but-obsolete-features"><span class="secno">12.1 </span>Conforming but obsolete features</a>
     <ol>
@@ -1316,7 +1316,7 @@
    common underpinnings of the rest of the specification.</dd>
 
 
-   <dt><a href="#dom">The DOM</a></dt>
+   <dt><a href="#dom">Semantics, structure, and APIs of HTML documents</a></dt>
 
    <dd>Documents are built from elements. These elements form a tree
    using the DOM. This section defines the features of this DOM, as
@@ -1331,6 +1331,16 @@
    each element,</span> are also given.</dd>
 
 
+   <dt><a href="#microdata">Microdata</a></dt>
+
+   <dd>This specification introduces a mechanism for adding
+   machine-readable annotations to documents, so that tools can
+   extract trees of name/value pairs from the document. This section
+   describes this mechanism<span class="impl"> and some algorithms
+   that can be used to convert HTML documents into other
+   formats</span>.</dd>
+
+
    <dt><a href="#browsers">Web Browsers</a></dt>
 
    <dd>HTML documents do not exist in a vacuum &mdash; this section
@@ -1347,23 +1357,23 @@
 
    <dt><a href="#comms">The Communication APIs</a></dt>
 
-   <dd>Applications written in HTML often require mechanisms to
-   communicate with remote servers, as well as communicating with
-   other applications from different domains running on the same
-   client.</dd>
+   <dd>This section describes some mechanisms that applications
+   written in HTML can use to communicate with other applications from
+   different domains running on the same client.</dd>
 
 
-   <dt><a href="#syntax">The Language Syntax</a></dt>
+   <dt><a href="#syntax">The HTML Syntax</a></dt>
+   <dt><a href="#xhtml">The XHTML Syntax</a></dt>
 
    <dd>All of these features would be for naught if they couldn't be
    represented in a serialized form and sent to other people, and so
-   this section defines the syntax of HTML, along with rules for how
-   to parse HTML.</dd>
+   these sections define the syntaxes of HTML, along with rules for
+   how to parse content using those syntaxes.</dd>
 
 
   </dl><p>There are also a couple of appendices, defining <a href="#rendering">rendering rules</a> for Web browsers and listing
-  <a href="#no">areas that are out of scope</a> for this
-  specification.<h4 id="how-to-read-this-specification"><span class="secno">1.8.1 </span>How to read this specification</h4><p>This specification should be read like all other specifications.
+  <a href="#obsolete">obsolete features</a> and <a href="#no">areas
+  that are out of scope</a> for this specification.<h4 id="how-to-read-this-specification"><span class="secno">1.8.1 </span>How to read this specification</h4><p>This specification should be read like all other specifications.
   First, it should be read cover-to-cover, multiple times. Then, it
   should be read backwards at least once. Then it should be read by
   picking random sections from the contents list and following all the
@@ -5296,7 +5306,7 @@
 
   </ol><!-- see also http://ln.hixie.ch/?start=1161042744&count=1 --></div><h5 id="htmlpropertycollection"><span class="secno">2.8.2.5 </span>HTMLPropertyCollection</h5><p>The <code><a href="#htmlpropertycollection-0">HTMLPropertyCollection</a></code> interface represents a
   <a href="#collections-0" title="collections">collection</a> of elements that add
-  name-value pairs to a particular <a href="#concept-item" title="concept-item">item</a> in the <a href="#microdata">microdata</a>
+  name-value pairs to a particular <a href="#concept-item" title="concept-item">item</a> in the <a href="#microdata-0">microdata</a>
   model.<pre class="idl">[Callable=<a href="#dom-htmlpropertycollection-nameditem" title="dom-HTMLPropertyCollection-namedItem">namedItem</a>]
 interface <dfn id="htmlpropertycollection-0">HTMLPropertyCollection</dfn> {
   readonly attribute unsigned long <a href="#dom-htmlpropertycollection-length" title="dom-HTMLPropertyCollection-length">length</a>;
@@ -6660,7 +6670,7 @@
   readonly attribute <a href="#domtokenlist-0">DOMTokenList</a> <a href="#dom-classlist" title="dom-classList">classList</a>;
   readonly attribute <a href="#domstringmap-0">DOMStringMap</a> <a href="#dom-dataset" title="dom-dataset">dataset</a>;
 
-  // <a href="#microdata">microdata</a>
+  // <a href="#microdata-0">microdata</a>
   [PutForwards=<a href="#dom-domsettabletokenlist-value" title="dom-DOMSettableTokenList-value">value</a>] readonly attribute <a href="#domsettabletokenlist-0">DOMSettableTokenList</a> <a href="#dom-item" title="dom-item">item</a>;
   [PutForwards=<a href="#dom-domsettabletokenlist-value" title="dom-DOMSettableTokenList-value">value</a>] readonly attribute <a href="#domsettabletokenlist-0">DOMSettableTokenList</a> <a href="#dom-itemprop" title="dom-itemprop">itemprop</a>;
   readonly attribute <a href="#htmlpropertycollection-0">HTMLPropertyCollection</a> <a href="#dom-properties" title="dom-properties">properties</a>;
@@ -36600,7 +36610,7 @@
   those are all defined in sufficient detail in a language-agnostic
   fashion in the Selectors specification. <a href="#references">[SELECTORS]</a></p>
 
-  </div><h2 id="microdata"><span class="secno">5 </span><dfn>Microdata</dfn></h2><!-- v2
+  </div><h2 id="microdata-0"><span class="secno">5 </span><dfn id="microdata">Microdata</dfn></h2><!-- v2
 
   * <ref property="foo" content="id"> to import the item with id="id"
     into the current microdata block
@@ -61592,7 +61602,7 @@
    > (character U+2082) and &sub3; (character U+2083). They
    > would are the equivalent to &sup1;, &sup2;, and &sup3;.
    See also: http://www.w3.org/2003/entities/
-  --></div><h2 id="the-xhtml-syntax"><span class="secno">10 </span><dfn>The XHTML syntax</dfn></h2><p class="note">This section only describes the rules for XML
+  --></div><h2 id="the-xhtml-syntax"><span class="secno">10 </span><dfn id="xhtml">The XHTML syntax</dfn></h2><p class="note">This section only describes the rules for XML
   resources. Rules for <code title="">text/html</code> resources are
   discussed in the section above entitled "<a href="#syntax">The HTML
   syntax</a>".<div class="impl">
@@ -64045,7 +64055,7 @@
    <li><code title="">vlink</code>
   </ul><p>All other <a href="#html-elements">HTML elements</a> and all attribute names and
   values on <a href="#html-elements">HTML elements</a> must be treated as
-  <a href="#case-sensitive">case-sensitive</a>.<h2 id="obsolete-features"><span class="secno">12 </span>Obsolete features</h2><h3 id="conforming-but-obsolete-features"><span class="secno">12.1 </span>Conforming but obsolete features</h3><p>Features listed in this section will trigger warnings in
+  <a href="#case-sensitive">case-sensitive</a>.<h2 id="obsolete"><span class="secno">12 </span>Obsolete features</h2><h3 id="conforming-but-obsolete-features"><span class="secno">12.1 </span>Conforming but obsolete features</h3><p>Features listed in this section will trigger warnings in
   conformance checkers.<p>In <a href="#syntax">the HTML syntax</a>, authors should not specify <a href="#syntax-doctype" title="syntax-DOCTYPE">DOCTYPE</a>s that get parsed as <a href="#obsolete-permitted-doctype" title="obsolete permitted DOCTYPE">obsolete permitted
   DOCTYPEs</a>.</p><!-- this is poor form; we really should define
   this in the syntax section somehow --><p>Authors should not specify an <code title="attr-meta-http-equiv"><a href="#attr-meta-http-equiv">http-equiv</a></code> attribute in the
@@ -65453,6 +65463,7 @@
   Brendan Eich,
   Brenton Simpson,
   Brett Wilson,
+  Brett Zamir,
   Brian Campbell,
   Brian Korver,
   Brian Ryner,

Received on Sunday, 19 July 2009 11:06:16 UTC