- From: poot <cvsmail@w3.org>
- Date: Sun, 19 Jul 2009 20:05:38 +0900 (JST)
- To: public-html-diffs@w3.org
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 — 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 ¹, ², and ³.
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