[e] (0) Update 'structure of this specification' section.

git-svn-id: http://svn.whatwg.org/webapps@3447 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Jul 19, 2009 · 9f9892b · 9f9892b
1 parent 23d70a0
commit 9f9892b
Show file tree

Hide file tree

Showing 2 changed files with 52 additions and 30 deletions.
diff --git a/index b/index
@@ -595,7 +595,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>
@@ -1014,7 +1014,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>
@@ -1304,7 +1304,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
@@ -1319,6 +1319,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
@@ -1335,23 +1345,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.</p>
+  <a href=#obsolete>obsolete features</a> and <a href=#no>areas
+  that are out of scope</a> for this specification.</p>
 
 
   <h4 id=how-to-read-this-specification><span class=secno>1.8.1 </span>How to read this specification</h4>
@@ -5849,7 +5859,7 @@ interface <dfn id=htmloptionscollection-0>HTMLOptionsCollection</dfn> {
 
   <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.</p>
 
   <pre class=idl>[Callable=<a href=#dom-htmlpropertycollection-nameditem title=dom-HTMLPropertyCollection-namedItem>namedItem</a>]
@@ -7385,7 +7395,7 @@ interface <dfn id=htmldocument>HTMLDocument</dfn> {
   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>;
@@ -40999,7 +41009,7 @@ explain that only direct children of the <menu> matter
 
 
 
-  <h2 id=microdata><span class=secno>5 </span><dfn>Microdata</dfn></h2>
+  <h2 id=microdata-0><span class=secno>5 </span><dfn id=microdata>Microdata</dfn></h2>
 
 <!-- v2
 
@@ -67745,7 +67755,7 @@ http://lxr.mozilla.org/seamonkey/search?string=nested
 
 
 
-  <h2 id=the-xhtml-syntax><span class=secno>10 </span><dfn>The XHTML syntax</dfn></h2>
+  <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
@@ -70232,7 +70242,7 @@ time:empty { binding: <i title="">time</i>; }</pre>
   <a href=#case-sensitive>case-sensitive</a>.</p>
 
 
-  <h2 id=obsolete-features><span class=secno>12 </span>Obsolete features</h2>
+  <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>
 
@@ -71742,6 +71752,7 @@ time:empty { binding: <i title="">time</i>; }</pre>
   Brendan Eich,
   Brenton Simpson,
   Brett Wilson,
+  Brett Zamir,
   Brian Campbell,
   Brian Korver,
   Brian Ryner,

diff --git a/source b/source
@@ -290,7 +290,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
@@ -306,6 +306,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
@@ -322,26 +332,26 @@
 
    <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.</p>
+  <a href="#obsolete">obsolete features</a> and <a href="#no">areas
+  that are out of scope</a> for this specification.</p>
 
 
   <h4>How to read this specification</h4>
@@ -46160,7 +46170,7 @@ explain that only direct children of the <menu> matter
 
 
 
-  <h2><dfn>Microdata</dfn></h2>
+  <h2><dfn id="microdata">Microdata</dfn></h2>
 
 <!-- v2
 
@@ -80071,7 +80081,7 @@ http://lxr.mozilla.org/seamonkey/search?string=nested
 
 
 
-  <h2><dfn>The XHTML syntax</dfn></h2>
+  <h2><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
@@ -82917,7 +82927,7 @@ time:empty { binding: <i title="">time</i>; }</pre>
   <span>case-sensitive</span>.</p>
 
 
-  <h2>Obsolete features</h2>
+  <h2 id="obsolete">Obsolete features</h2>
 
   <h3>Conforming but obsolete features</h3>
 
@@ -84730,6 +84740,7 @@ time:empty { binding: <i title="">time</i>; }</pre>
   Brendan Eich,
   Brenton Simpson,
   Brett Wilson,
+  Brett Zamir,
   Brian Campbell,
   Brian Korver,
   Brian Ryner,