[html5] r6343 - [e] (0) Now both pedancy and simplicity are losing in the race for clarity. Fixi [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2011-08-01 23:56:23 -0700 (Mon, 01 Aug 2011)
New Revision: 6343

Modified:
   complete.html
   index
   source
Log:
[e] (0) Now both pedancy and simplicity are losing in the race for clarity.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=13370

Modified: complete.html
===================================================================
--- complete.html	2011-08-02 06:37:34 UTC (rev 6342)
+++ complete.html	2011-08-02 06:56:23 UTC (rev 6343)
@@ -56835,18 +56835,34 @@
   <code><a href=#the-object-element>object</a></code>, <code><a href=#the-source-element>source</a></code>, <code><a href=#the-track-element>track</a></code>, and
   <code><a href=#the-video-element>video</a></code> elements.</p>
 
-  <p>If a property's <a href=#concept-property-value title=concept-property-value>value</a>
-  is an <a href=#absolute-url>absolute URL</a>, the property must be specified
-  using a <a href=#url-property-elements title="URL property elements">URL property
-  element</a>.</p>
+  <p>If a property's <a href=#concept-property-value title=concept-property-value>value</a>, as defined by the
+  property's definition, is an <a href=#absolute-url>absolute URL</a>, the property
+  must be specified using a <a href=#url-property-elements title="URL property elements">URL
+  property element</a>.</p>
 
   <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><a href=#attr-time-datetime>datetime</a></code> attribute of 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>, as defined by
+  the property's definition, the property must be specified using the
+  <code title=attr-time-datetime><a href=#attr-time-datetime>datetime</a></code> attribute of a
   <code><a href=#the-time-element>time</a></code> element.</p>
 
+  <p class=note>These requirements do not apply just because a
+  property value happens to match the syntax for a URL or date/time
+  construct. They only apply if the property is explicitly defined as
+  taking such a value.</p>
 
+  <p class=example>For example, a book about the first moon landing
+  could be called "1969-07-20". A "title" property from a vocabulary
+  that defines a title as being a string would not expect the title to
+  be given in a <code><a href=#the-time-element>time</a></code> element, even though it looks like a
+  date. On the other hand, if there was a (rather narrowly scoped!)
+  vocaburaly for "books whose titles imply dates" which had a "title"
+  property defined to take a date, then the property <em>would</em>
+  except the title to be given in a <code><a href=#the-time-element>time</a></code> element, because
+  of the requirement above.</p>
 
+
+
   <div class=impl> <!-- this is unfortunate, as it is hiding authoring conformance criteria (so we leave it in for the w3c copy) -->
 
 

Modified: index
===================================================================
--- index	2011-08-02 06:37:34 UTC (rev 6342)
+++ index	2011-08-02 06:56:23 UTC (rev 6343)
@@ -56707,18 +56707,34 @@
   <code><a href=#the-object-element>object</a></code>, <code><a href=#the-source-element>source</a></code>, <code><a href=#the-track-element>track</a></code>, and
   <code><a href=#the-video-element>video</a></code> elements.</p>
 
-  <p>If a property's <a href=#concept-property-value title=concept-property-value>value</a>
-  is an <a href=#absolute-url>absolute URL</a>, the property must be specified
-  using a <a href=#url-property-elements title="URL property elements">URL property
-  element</a>.</p>
+  <p>If a property's <a href=#concept-property-value title=concept-property-value>value</a>, as defined by the
+  property's definition, is an <a href=#absolute-url>absolute URL</a>, the property
+  must be specified using a <a href=#url-property-elements title="URL property elements">URL
+  property element</a>.</p>
 
   <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><a href=#attr-time-datetime>datetime</a></code> attribute of 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>, as defined by
+  the property's definition, the property must be specified using the
+  <code title=attr-time-datetime><a href=#attr-time-datetime>datetime</a></code> attribute of a
   <code><a href=#the-time-element>time</a></code> element.</p>
 
+  <p class=note>These requirements do not apply just because a
+  property value happens to match the syntax for a URL or date/time
+  construct. They only apply if the property is explicitly defined as
+  taking such a value.</p>
 
+  <p class=example>For example, a book about the first moon landing
+  could be called "1969-07-20". A "title" property from a vocabulary
+  that defines a title as being a string would not expect the title to
+  be given in a <code><a href=#the-time-element>time</a></code> element, even though it looks like a
+  date. On the other hand, if there was a (rather narrowly scoped!)
+  vocaburaly for "books whose titles imply dates" which had a "title"
+  property defined to take a date, then the property <em>would</em>
+  except the title to be given in a <code><a href=#the-time-element>time</a></code> element, because
+  of the requirement above.</p>
 
+
+
   <div class=impl> <!-- this is unfortunate, as it is hiding authoring conformance criteria (so we leave it in for the w3c copy) -->
 
 

Modified: source
===================================================================
--- source	2011-08-02 06:37:34 UTC (rev 6342)
+++ source	2011-08-02 06:56:23 UTC (rev 6343)
@@ -64083,20 +64083,36 @@
   <code>object</code>, <code>source</code>, <code>track</code>, and
   <code>video</code> elements.</p>
 
-  <p>If a property's <span title="concept-property-value">value</span>
-  is an <span>absolute URL</span>, the property must be specified
-  using a <span title="URL property elements">URL property
-  element</span>.</p>
+  <p>If a property's <span
+  title="concept-property-value">value</span>, as defined by the
+  property's definition, is an <span>absolute URL</span>, the property
+  must be specified using a <span title="URL property elements">URL
+  property element</span>.</p>
 
   <p>If a property's <span title="concept-property-value">value</span>
   represents a <span title="concept-date">date</span>, <span
   title="concept-time">time</span>, or <span
-  title="concept-datetime">global date and time</span>, the property
-  must be specified using the <code
-  title="attr-time-datetime">datetime</code> attribute of a
+  title="concept-datetime">global date and time</span>, as defined by
+  the property's definition, the property must be specified using the
+  <code title="attr-time-datetime">datetime</code> attribute of a
   <code>time</code> element.</p>
 
+  <p class="note">These requirements do not apply just because a
+  property value happens to match the syntax for a URL or date/time
+  construct. They only apply if the property is explicitly defined as
+  taking such a value.</p>
 
+  <p class="example">For example, a book about the first moon landing
+  could be called "1969-07-20". A "title" property from a vocabulary
+  that defines a title as being a string would not expect the title to
+  be given in a <code>time</code> element, even though it looks like a
+  date. On the other hand, if there was a (rather narrowly scoped!)
+  vocaburaly for "books whose titles imply dates" which had a "title"
+  property defined to take a date, then the property <em>would</em>
+  except the title to be given in a <code>time</code> element, because
+  of the requirement above.</p>
+
+
 <!--END w3c-html-->
   <div class="impl"> <!-- this is unfortunate, as it is hiding authoring conformance criteria (so we leave it in for the w3c copy) -->
 <!--START w3c-html-->