W3C home > Mailing lists > Public > public-html-commits@w3.org > June 2008

html5/spec Overview.html,1.993,1.994

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 26 Jun 2008 09:33:57 +0000
To: public-html-commits@w3.org
Message-Id: <E1KBnrZ-00022v-L0@lionel-hutz.w3.org>

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv7830

Modified Files:
	Overview.html 
Log Message:
URLification: mention that the term 'URL' isn't the same as 3986 would have us believe; URLify <datagrid> and the main 'command' section. (whatwg r1805)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.993
retrieving revision 1.994
diff -u -d -r1.993 -r1.994
--- Overview.html	25 Jun 2008 22:08:11 -0000	1.993
+++ Overview.html	26 Jun 2008 09:33:54 -0000	1.994
@@ -59,7 +59,7 @@
     for HTML and XHTML</h2>
 
    <h2 class="no-num no-toc" id=editors0><!-- "W3C Working Draft" -->
-    Editor's Draft <!--ZZZ-->25 June 2008</h2>
+    Editor's Draft <!--ZZZ-->26 June 2008</h2>
 
    <dl><!-- ZZZ: update the month/day
     <dt>This Version:</dt>
@@ -207,7 +207,7 @@
 
   <p>The W3C <a href="http://www.w3.org/html/wg/">HTML Working Group</a> is
    the W3C working group responsible for this specification's progress along
-   the W3C Recommendation track. <!--ZZZ:--> This specification is the 25
+   the W3C Recommendation track. <!--ZZZ:--> This specification is the 26
    June 2008 <!--ZZZ "Working Draft"-->Editor's Draft. <!--:ZZZ--></p>
   <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
   <!-- relationship to other work (required) -->
@@ -2820,6 +2820,12 @@
      href="#references">[RFC3987]</a>
   </ul>
 
+  <p class=note>The term "URL" in this specification is used in a manner
+   distinct from the precise technical meaning it is given in RFC 3986.
+   Readers familiar with that RFC will find it easier to read <em>this</em>
+   specification if they pretend the term "URL" as used herein is really
+   called something else altogether.
+
   <h4 id=parsing0><span class=secno>2.3.2 </span>Parsing URLs</h4>
 
   <p>To <dfn id=parse0>parse a URL</dfn> <var title="">url</var> into its
@@ -25600,8 +25606,7 @@
 
   <p>The <dfn id=src12 title=dom-event-source-src><code>src</code></dfn> DOM
    attribute must <a href="#reflect">reflect</a> the content attribute of the
-   same name.</p>
-  <!-- XXXURL XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \(URI\|IRI\|URL\) -->
+   same name.
 
   <h3 id=interactive-elements><span class=secno>4.11 </span>Interactive
    elements</h3>
@@ -25995,13 +26000,12 @@
 
    <dt><dfn id=getrowimage
     title=dom-provider-getRowImage><code>getRowImage(<var
-    title="">row</var>)</code></dfn></dt>
-   <!-- XXXURL just say "the URL of" -->
+    title="">row</var>)</code></dfn>
 
-   <dd>Must return a URI to an image that represents row <var
-    title="">row</var>, or the empty string if there is no applicable image.
-    May be omitted if no rows have associated images. If the value that this
-    method would return changes, the <code><a
+   <dd>Must return a <a href="#url">URL</a> giving the address of an image
+    that represents row <var title="">row</var>, or the empty string if there
+    is no applicable image. May be omitted if no rows have associated images.
+    If the value that this method would return changes, the <code><a
     href="#datagrid0">datagrid</a></code>'s update methods must be called to
     update the row in question.
 
@@ -26334,7 +26338,11 @@
   <p>The behavior of the default data provider depends on the nature of the
    first element child of the <code><a href="#datagrid0">datagrid</a></code>.
 
-  <dl class=switch>
+  <dl
+   class=switch><!-- XXX some of these entries say "the method must return" and
+   other say "the characteristic must be"; this should be rationalized
+   -->
+
    <dt>While the first element child is a <code><a
     href="#table">table</a></code> element
 
@@ -26471,18 +26479,18 @@
     <p class=note>The <code>colspan</code> and <code>rowspan</code>
      attributes are <a href="#ignored" title=ignore>ignored</a> by this
      algorithm.</p>
-    <!-- XXXURL take the string from the <img> and absolutify it and return that. -->
-    
+
     <p><strong><code title=dom-provider-getRowImage><a
      href="#getrowimage">getRowImage(<var
-     title="">i</var>)</a></code></strong>: If the row's first cell's element
-     has an <code><a href="#img">img</a></code> element child, then the URI
-     of the row's image is the URI of the first <code><a
-     href="#img">img</a></code> element child of the row's first cell's
-     element. Otherwise, the URI of the row's image is the empty string.</p>
-    <!-- XXX well. that sentence could
-    have gone better, that's for sure. -->
-    
+     title="">i</var>)</a></code></strong>: The <a href="#url">URL</a> of the
+     row's image is the <a href="#absolute">absolute URL</a> obtained by <a
+     href="#resolve" title="resolve a url">resolving</a> the value of the
+     <code title=attr-img-src><a href="#src">src</a></code> attribute of the
+     first <code><a href="#img">img</a></code> element child of the row's
+     first cell's element, if there is one and resolving its attribute is
+     successful. Otherwise, the <a href="#url">URL</a> of the row's image is
+     the empty string.</p>
+
     <p><strong><code title=dom-provider-getRowMenu><a
      href="#getrowmenu">getRowMenu(<var
      title="">i</var>)</a></code></strong>: If the row's first cell's element
@@ -26725,17 +26733,21 @@
      <var title="">position</var>)</a></code> must return <var
      title="">position</var>. (The generic default data provider does not
      support sorting the data grid.)</p>
-    <!-- XXXURL absolutify the URL here -->
+
     <p><code title=dom-provider-getRowImage><a
      href="#getrowimage">getRowImage(<var title="">i</var>)</a></code> must
-     return the URI of the image given by the first <code><a
-     href="#img">img</a></code> element descendant (in the real DOM) of the
-     row's element, that is not also a descendant of another element in the
-     filtered view that is a descendant of the row's element.</p>
+     return the <a href="#absolute">absolute URL</a> obtained from <a
+     href="#resolve" title="resolve a url">resolving</a> the value of the
+     <code title=attr-img-src><a href="#src">src</a></code> attribute of the
+     first <code><a href="#img">img</a></code> element descendant (in the
+     real DOM) of the row's element, that is not also a descendant of another
+     element in the filtered view that is a descendant of the row's element,
+     if such an element exists and resolving its attribute is successful.
+     Otherwise, it must return the empty string.</p>
 
-    <div class=example> <!-- XXXURL change to URL -->
+    <div class=example>
      <p>In the following example, the row with path "1,0" returns
-      "http://example.com/a" as its image URI, and the other rows (including
+      "http://example.com/a" as its image URL, and the other rows (including
       the row with path "1") return the empty string:</p>
 
      <pre>&lt;datagrid>
@@ -27243,20 +27255,20 @@
    provide the user with a method for requesting that the row be
    deleted.</dd>
 -->
-   <!-- XXXURL change to URL? -->
 
-   <dt>To obtain a URI to an image representing a row</dt>
-   <!-- XXXURL define how to absolutify -->
+   <dt>To obtain a <a href="#url">URL</a> identifying an image representing a
+    row
 
    <dd>Invoke the <code title=dom-provider-getRowImage><a
     href="#getrowimage">getRowImage()</a></code> method with a <code><a
     href="#rowspecification">RowSpecification</a></code> object representing
-    the row in question. The return value is a string representing a <a
-    href="#valid">valid URL</a> to an image. Relative URIs must be
-    interpreted relative to the <code><a
-    href="#datagrid0">datagrid</a></code>'s <span title="element's base
-    URI">base URI</span>. If the method returns the empty string, null, or if
-    the method is not defined, then the row has no associated image.
+    the row in question. The return value is a <a href="#url">URL</a>.
+    Immediately <a href="#resolve" title="resolve a url">resolve</a> that URL
+    as if it came from an attribute of the <code><a
+    href="#datagrid0">datagrid</a></code> element to obtain an <a
+    href="#absolute">absolute URL</a> identifying the image that represents
+    the row. If the method returns the empty string, null, or if the method
+    is not defined, then the row has no associated image.
 
    <dt>To obtain a context menu appropriate for a particular row
 
@@ -28378,8 +28390,8 @@
 
    <dt><dfn id=icon1 title=command-facet-Icon>Icon</dfn>
 
-   <dd>A graphical image that represents the action.</dd>
-   <!-- XXXURL define it to be an asbolute URL? -->
+   <dd>An <a href="#absolute">absolute URL</a> identifying a graphical image
+    that represents the action.
 
    <dt><dfn id=hidden1 title=command-facet-HiddenState>Hidden State</dfn>
 
@@ -28400,12 +28412,11 @@
 
    <dd>Whether the command is checked or not.
 
-   <dt><dfn id=action title=command-facet-Action>Action</dfn></dt>
-   <!-- XXXURL change to URL -->
+   <dt><dfn id=action title=command-facet-Action>Action</dfn>
 
    <dd>The actual effect that triggering the command will have. This could be
-    a scripted event handler, a URI to which to navigate, or a form
-    submission.
+    a scripted event handler, a <a href="#url">URL</a> to which to <a
+    href="#navigate">navigate</a>, or a form submission.
 
    <dt><dfn id=triggers title=command-facet-Triggers>Triggers</dfn>
 
@@ -28483,6 +28494,7 @@
    title=command-facet-Hint>Hint</a>. This attribute will be shadowed by the
    <code title=dom-title><a href="#title0">title</a></code> DOM attribute on
    the <code><a href="#htmlelement">HTMLElement</a></code> interface.</p>
+  <!-- XXXURL XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \(URI\|IRI\|URL\) -->
   <!-- XXXURL "must return the absolute URL of the command's icon"? -->
 
   <p>The <dfn id=icon2 title=dom-command-ro-icon><code>icon</code></dfn>
Received on Thursday, 26 June 2008 09:34:32 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 9 October 2008 20:32:57 GMT