W3C home > Mailing lists > Public > public-html-diffs@w3.org > April 2010

microdata; hixie: spec gen updates (whatwg r4958)

From: poot <cvsmail@w3.org>
Date: Sat, 3 Apr 2010 06:45:09 +0900 (JST)
To: public-html-diffs@w3.org
Message-Id: <20100402214510.0FAAD2BC5D@toro.w3.mag.keio.ac.jp>
microdata; hixie: spec gen updates (whatwg r4958)

http://dev.w3.org/cvsweb/html5/md/Overview.html?r1=1.57&r2=1.58&f=h
http://html5.org/tools/web-apps-tracker?from=4957&to=4958

===================================================================
RCS file: /sources/public/html5/md/Overview.html,v
retrieving revision 1.57
retrieving revision 1.58
diff -u -d -r1.57 -r1.58
--- Overview.html	1 Apr 2010 01:00:50 -0000	1.57
+++ Overview.html	2 Apr 2010 21:44:57 -0000	1.58
@@ -1,4 +1,4 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie"><title>HTML Microdata</title><style type="text/css">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"><!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie"><title>HTML Microdata</title><style type="text/css">
    pre { margin-left: 2em; white-space: pre-wrap; }
    h2 { margin: 3em 0 1em 0; }
    h3 { margin: 2.5em 0 1em 0; }
@@ -436,8 +436,8 @@
    <li><a href="#application-microdata-json"><span class="secno">7.1 </span><code>application/microdata+json</code></a></ol></li>
  <li><a class="no-num" href="#references">References</a></li>
  <li><a class="no-num" href="#acknowledgements">Acknowledgements</a></ol>
-<!--end-toc--><hr><h2 id="common-infrastructure"><span class="secno">1 </span>Common infrastructure</h2><h3 id="dependencies"><span class="secno">1.1 </span>Dependencies</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>This specification depends on the Web IDL and HTML5
-  specifications. <a href="#refsWEBIDL">[WEBIDL]</a> <a href="#refsHTML5">[HTML5]</a><h3 id="terminology"><span class="secno">1.2 </span>Terminology</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>This specification relies heavily on the HTML5 specification to
+<!--end-toc--><hr><h2 id="common-infrastructure"><span class="secno">1 </span>Common infrastructure</h2><h3 id="dependencies"><span class="secno">1.1 </span>Dependencies</h3><p>This specification depends on the Web IDL and HTML5
+  specifications. <a href="#refsWEBIDL">[WEBIDL]</a> <a href="#refsHTML5">[HTML5]</a><h3 id="terminology"><span class="secno">1.2 </span>Terminology</h3><p>This specification relies heavily on the HTML5 specification to
   define underlying terms.<p>HTML5 defines the concept of DOM <dfn id="collections">collections</dfn>, and of
   IDL attributes <dfn id="reflect" title="reflect">reflecting</dfn> content
   attributes. It also defines <dfn id="tree-order">tree order</dfn> and the concept of
@@ -462,7 +462,7 @@
   is.<p>Finally, HTML5 also defines the concepts of <dfn id="drag-and-drop-initialization-steps">drag-and-drop
   initialization steps</dfn> and of the <dfn id="list-of-dragged-nodes">list of dragged
   nodes</dfn>, which come up in the context of drag-and-drop
-  interfaces.</p><!--FIXUP 2dcontext +1--><h3 id="conformance-requirements"><span class="secno">1.3 </span>Conformance requirements</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!--FIXUP 2dcontext -1--><p>All diagrams, examples, and notes in this specification are
+  interfaces.</p><!--FIXUP 2dcontext +1--><h3 id="conformance-requirements"><span class="secno">1.3 </span>Conformance requirements</h3><!--FIXUP 2dcontext -1--><p>All diagrams, examples, and notes in this specification are
   non-normative, as are all sections explicitly marked non-normative.
   Everything else in this specification is normative.<p>The key words "MUST", "MUST NOT", "REQUIRED", <!--"SHALL", "SHALL
   NOT",--> "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
@@ -589,14 +589,14 @@
   values obtained from the <code title="dom-itemValue"><a href="#dom-itemvalue">itemValue</a></code> DOM property of each of the
   elements represented by the object, in <a href="#tree-order">tree order</a>.</p>
 
-  </div><h2 id="introduction"><span class="secno">2 </span>Introduction</h2><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><h3 id="overview"><span class="secno">2.1 </span>Overview</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>Sometimes, it is desirable to annotate content with specific
+  </div><h2 id="introduction"><span class="secno">2 </span>Introduction</h2><h3 id="overview"><span class="secno">2.1 </span>Overview</h3><p><i>This section is non-normative.</i><p>Sometimes, it is desirable to annotate content with specific
   machine-readable labels, e.g. to allow generic scripts to provide
   services that are customised to the page, or to enable content from
   a variety of cooperating authors to be processed by a single script
   in a consistent manner.<p>For this purpose, authors can use the microdata features
   described in this section. Microdata allows nested groups of
   name-value pairs to be added to documents, in parallel with the
-  existing content.<h3 id="the-basic-syntax"><span class="secno">2.2 </span>The basic syntax</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>At a high level, microdata consists of a group of name-value
+  existing content.<h3 id="the-basic-syntax"><span class="secno">2.2 </span>The basic syntax</h3><p><i>This section is non-normative.</i><p>At a high level, microdata consists of a group of name-value
   pairs. The groups are called <a href="#concept-item" title="concept-item">items</a>, and each name-value pair is a
   property. Items and properties are represented by regular
   elements.<p>To create an item, the <code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code> attribute is used.<p>To add a property to an item, the <code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code> attribute is used on one of
@@ -744,7 +744,7 @@
    drag-and-drop data. In neither case is the image in any way
    associated with the item.</p>
 
-  </div><h3 id="typed-items"><span class="secno">2.3 </span>Typed items</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>The examples in the previous section show how information could
+  </div><h3 id="typed-items"><span class="secno">2.3 </span>Typed items</h3><p><i>This section is non-normative.</i><p>The examples in the previous section show how information could
   be marked up on a page that doesn't expect its microdata to be
   re-used. Microdata is most useful, though, when it is used in
   contexts where other authors and readers are able to cooperate to
@@ -772,7 +772,7 @@
   given for an item with the type "http://census.example/person" might
   refer to the economic class of an individual, while a property named
   "class" given for an item with the type "http://example.com/school/teacher"
-  might refer to the classroom a teacher has been assigned.<h3 id="global-identifiers-for-items"><span class="secno">2.4 </span>Global identifiers for items</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>Sometimes, an <a href="#concept-item" title="concept-item">item</a> gives
+  might refer to the classroom a teacher has been assigned.<h3 id="global-identifiers-for-items"><span class="secno">2.4 </span>Global identifiers for items</h3><p><i>This section is non-normative.</i><p>Sometimes, an <a href="#concept-item" title="concept-item">item</a> gives
   information about a topic that has a global identifier. For example,
   books can be identified by their ISBN number.<p>Vocabularies (as identified by the <code title="attr-itemtype"><a href="#attr-itemtype">itemtype</a></code> attribute) can be designed
   such that <a href="#concept-item" title="concept-item">items</a> get associated
@@ -811,7 +811,7 @@
   leads to a situation where it is ambiguous whether the identifier,
   and thus the set of properties specified in the microdata,
   references the page or something else.</p>
-  --><h3 id="selecting-names-when-defining-vocabularies"><span class="secno">2.5 </span>Selecting names when defining vocabularies</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>Using microdata means using a vocabulary. For some purposes, an
+  --><h3 id="selecting-names-when-defining-vocabularies"><span class="secno">2.5 </span>Selecting names when defining vocabularies</h3><p><i>This section is non-normative.</i><p>Using microdata means using a vocabulary. For some purposes, an
   ad-hoc vocabulary is adequate. For others, a vocabulary will need to
   be designed. Where possible, authors are encouraged to re-use
   existing vocabularies, as this makes content re-use easier.<p>When designing new vocabularies, identifiers can be created
@@ -866,7 +866,7 @@
       <td>white
      <tr><td>img
       <td>.../hedral.jpeg
-   </table></div><h3 id="using-the-microdata-dom-api"><span class="secno">2.6 </span>Using the microdata DOM API</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>The microdata becomes even more useful when scripts can use it to
+   </table></div><h3 id="using-the-microdata-dom-api"><span class="secno">2.6 </span>Using the microdata DOM API</h3><p><i>This section is non-normative.</i><p>The microdata becomes even more useful when scripts can use it to
   expose information to the user, for example offering it in a form
   that can be used by other applications.<p>The <code title="dom-document-getItems"><a href="#dom-document-getitems">document.getItems(<var title="">typeNames</var>)</a></code> method provides access to the
   <a href="#top-level-microdata-items">top-level microdata items</a>. It returns a
@@ -971,13 +971,13 @@
    </ul><p>(The duplicate occurrence of "http://example.com/color" is not included
    in the list.)</p>
 
-  </div><h2 id="encoding-microdata"><span class="secno">3 </span>Encoding microdata</h2><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The following attributes are added as <a href="#global-attributes">global
+  </div><h2 id="encoding-microdata"><span class="secno">3 </span>Encoding microdata</h2><p>The following attributes are added as <a href="#global-attributes">global
   attributes</a> to HTML elements:<ul class="brief"><li><code title="attr-itemid"><a href="#attr-itemid">itemid</a></code></li>
    <li><code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code></li>
    <li><code title="attr-itemref"><a href="#attr-itemref">itemref</a></code></li>
    <li><code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code></li>
    <li><code title="attr-itemtype"><a href="#attr-itemtype">itemtype</a></code></li>
-  </ul><h3 id="the-microdata-model"><span class="secno">3.1 </span>The microdata model</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The microdata model consists of groups of name-value pairs known
+  </ul><h3 id="the-microdata-model"><span class="secno">3.1 </span>The microdata model</h3><p>The microdata model consists of groups of name-value pairs known
   as <a href="#concept-item" title="concept-item">items</a>.<p>Each group is known as an <a href="#concept-item" title="concept-item">item</a>. Each <a href="#concept-item" title="concept-item">item</a> can have an <a href="#item-type">item type</a>,
   a <a href="#global-identifier">global identifier</a> (if the <a href="#item-type">item type</a>
   <a href="#support-global-identifiers-for-items" title="support global identifiers for items">supports global
@@ -990,7 +990,7 @@
   item">property</a> of a <a href="#typed-item">typed item</a>. The
   <dfn id="relevant-type">relevant type</dfn> for a <a href="#typed-item">typed item</a> is the <a href="#concept-item" title="concept-item">item</a>'s <a href="#item-type">item type</a>, if it has
   one, or else is the <a href="#relevant-type">relevant type</a> of the <a href="#concept-item" title="concept-item">item</a> for which it is a <a href="#the-properties-of-an-item" title="the
-  properties of an item">property</a>'s <a href="#concept-property-value" title="concept-property-value">value</a>.<h3 id="items"><span class="secno">3.2 </span>Items</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Every <span title="HTML elements">HTML element</span> may have an
+  properties of an item">property</a>'s <a href="#concept-property-value" title="concept-property-value">value</a>.<h3 id="items"><span class="secno">3.2 </span>Items</h3><p>Every <span title="HTML elements">HTML element</span> may have an
   <dfn id="attr-itemscope" title="attr-itemscope"><code>itemscope</code></dfn> attribute
   specified. The <code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code>
   attribute is a <a href="#boolean-attribute">boolean attribute</a>.<p>An element with the <code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code>
@@ -1044,7 +1044,7 @@
   specified, must have a value that is an <a href="#unordered-set-of-unique-space-separated-tokens">unordered set of
   unique space-separated tokens</a> consisting of <a href="#concept-id" title="concept-ID">IDs</a> of elements in the same <a href="#home-subtree">home
   subtree</a>.<p>The <code title="attr-itemref"><a href="#attr-itemref">itemref</a></code> attribute must not
-  be specified on elements that do not have an <code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code> attribute specified.<h3 id="names:-the-itemprop-attribute"><span class="secno">3.3 </span>Names: the <dfn title="attr-itemprop"><code>itemprop</code></dfn> attribute</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Every <span title="HTML elements">HTML element</span> may have an
+  be specified on elements that do not have an <code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code> attribute specified.<h3 id="names:-the-itemprop-attribute"><span class="secno">3.3 </span>Names: the <dfn title="attr-itemprop"><code>itemprop</code></dfn> attribute</h3><p>Every <span title="HTML elements">HTML element</span> may have an
   <code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code> attribute specified, if
   doing so <a href="#the-properties-of-an-item" title="the properties of an item">adds a
   property</a> to one or more <a href="#concept-item" title="concept-item">items</a> (as defined below).<p>The <code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code> attribute, if
@@ -1124,7 +1124,7 @@
 &lt;/div&gt;
 </pre>
 
-  </div><h3 id="values"><span class="secno">3.4 </span>Values</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="concept-property-value" title="concept-property-value">property value</dfn> of a
+  </div><h3 id="values"><span class="secno">3.4 </span>Values</h3><p>The <dfn id="concept-property-value" title="concept-property-value">property value</dfn> of a
   name-value pair added by an element with an <code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code> attribute depends on the
   element, as follows:<dl><dt>If the element also has an <code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code> attribute</dt>
 
@@ -1191,7 +1191,7 @@
   element</a>.<p>If a property's <a href="#concept-property-value" title="concept-property-value">value</a>
   represents a <a href="#concept-date" title="concept-date">date</a>, <a href="#concept-time" title="concept-time">time</a>, or <a href="#concept-datetime" title="concept-datetime">global date and time</a>, the property
   must be specified using the <code title="attr-time-datetime">datetime</code> attribute of a
-  <code>time</code> element.<h3 id="associating-names-with-items"><span class="secno">3.5 </span>Associating names with items</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>To find <dfn id="the-properties-of-an-item">the properties of an item</dfn> defined by the
+  <code>time</code> element.<h3 id="associating-names-with-items"><span class="secno">3.5 </span>Associating names with items</h3><p>To find <dfn id="the-properties-of-an-item">the properties of an item</dfn> defined by the
   element <var title="">root</var>, the user agent must try to
   <a href="#crawl-the-properties">crawl the properties</a> of the element <var title="">root</var>, with an empty list as the value of <var title="">memory</var>: if this fails, then <a href="#the-properties-of-an-item" title="the
   properties of an item">the properties of the item</a> defined by
@@ -1336,7 +1336,7 @@
  properties.)&lt;/span&gt;
 &lt;/p&gt;</pre>
 
-  </div><h2 id="microdata-dom-api"><span class="secno">4 </span>Microdata DOM API</h2><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><pre class="idl">[Supplemental] interface <span>HTMLDocument</span> { <!--WARNING: ALSO DUPLICATED IN HTMLDocument SECTION-->
+  </div><h2 id="microdata-dom-api"><span class="secno">4 </span>Microdata DOM API</h2><pre class="idl">[Supplemental] interface <span>HTMLDocument</span> { <!--WARNING: ALSO DUPLICATED IN HTMLDocument SECTION-->
   NodeList <a href="#dom-document-getitems" title="dom-document-getItems">getItems</a>(in optional DOMString typeNames); // <span>microdata</span>
 };
 
@@ -1499,7 +1499,7 @@
    <pre>for (var index = 0; index &lt; element.itemRef.length; index += 1)
   process(document.getElementById(element.itemRef[index]));</pre>
 
-  </div><h2 id="other-changes-to-html5"><span class="secno">5 </span>Other changes to HTML5</h2><h3 id="content-models"><span class="secno">5.1 </span>Content models</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>If the <code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code> attribute is
+  </div><h2 id="other-changes-to-html5"><span class="secno">5 </span>Other changes to HTML5</h2><h3 id="content-models"><span class="secno">5.1 </span>Content models</h3><p>If the <code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code> attribute is
   present on <code>link</code> or <code>meta</code>, they are
   <a href="#flow-content">flow content</a> and <a href="#phrasing-content">phrasing content</a>. The
   <code>link</code> and <code>meta</code> elements may be used where
@@ -1520,12 +1520,12 @@
    </li>
   </ol></div><div class="impl">
 
-  <h2 id="converting-html-to-other-formats"><span class="secno">6 </span>Converting HTML to other formats</h2><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
+  <h2 id="converting-html-to-other-formats"><span class="secno">6 </span>Converting HTML to other formats</h2>
 
 
 
 
-  <h3 id="json"><span class="secno">6.1 </span>JSON</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
+  <h3 id="json"><span class="secno">6.1 </span>JSON</h3>
 
   <p>Given a list of nodes <var title="">nodes</var> in a
   <code>Document</code>, a user agent must run the following algorithm
@@ -1597,7 +1597,7 @@
 
    <li><p>Return <var title="">result</var>.</li>
 
-  </ol><h3 id="rdf"><span class="secno">6.2 </span>RDF</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
+  </ol><h3 id="rdf"><span class="secno">6.2 </span>RDF</h3>
 
   <p>To <dfn id="extracting-rdf" title="extracting rdf">convert a <code>Document</code> to
   RDF</dfn>, a user agent must run the following algorithm:</p>
@@ -1898,7 +1898,7 @@
 
    <li><p>Return <var title="">subject</var>.</li>
 
-  </ol><h4 id="examples"><span class="secno">6.2.1 </span>Examples</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
+  </ol><h4 id="examples"><span class="secno">6.2.1 </span>Examples</h4>
 
   <p><i>This section is non-normative.</i></p>
 
@@ -2046,7 +2046,7 @@
    <dd>W3C and WHATWG</dd>
   </dl><p>Fragment identifiers used with
   <code><a href="#application-microdata-json">application/microdata+json</a></code> resources have the same
-  semantics as when used with <code>application/json</code>. <a href="#refsJSON">[JSON]</a><h2 class="no-num" id="references">References</h2><p class="XXX annotation"><b>Status: </b><i>Implemented and widely deployed</i></p><!--REFS--><p>All references are normative unless marked "Non-normative".</p><!-- Dates are only included for standards older than the Web,
+  semantics as when used with <code>application/json</code>. <a href="#refsJSON">[JSON]</a><h2 class="no-num" id="references">References</h2><!--REFS--><p>All references are normative unless marked "Non-normative".</p><!-- Dates are only included for standards older than the Web,
   because the newer ones keep changing. --><dl><dt id="refsHTML5">[HTML5]</dt>
    <dd><cite><a href="http://dev.w3.org/html5/spec/">HTML5</a></cite>,
    I. Hickson, D. Hyatt. W3C.</dd>
@@ -2072,5 +2072,5 @@
    <dd><cite><a href="http://dev.w3.org/2006/webapi/WebIDL/">Web
    IDL</a></cite>, C. McCormack. W3C.</dd>
 
-  </dl><h2 class="no-num" id="acknowledgements">Acknowledgements</h2><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>For a full list of acknowledgements, please see the HTML5
+  </dl><h2 class="no-num" id="acknowledgements">Acknowledgements</h2><p>For a full list of acknowledgements, please see the HTML5
   specification. <a href="#refsHTML5">[HTML5]</a>
Received on Friday, 2 April 2010 21:45:40 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 18 December 2010 06:14:18 GMT