html5/spec Overview.html,1.972,1.973

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

Modified Files:
	Overview.html 
Log Message:
more notes for the upcoming url rework (whatwg r1783)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.972
retrieving revision 1.973
diff -u -d -r1.972 -r1.973
--- Overview.html	17 Jun 2008 23:08:02 -0000	1.972
+++ Overview.html	18 Jun 2008 03:37:31 -0000	1.973
@@ -59,7 +59,7 @@
     for HTML and XHTML</h2>
 
    <h2 class="no-num no-toc" id=editors0><!-- "W3C Working Draft" -->
-    Editor's Draft <!--ZZZ-->17 June 2008</h2>
+    Editor's Draft <!--ZZZ-->18 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 17
+   the W3C Recommendation track. <!--ZZZ:--> This specification is the 18
    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) -->
@@ -24214,7 +24214,7 @@
   <p>The <dfn id=src11 title=attr-event-source-src><code>src</code></dfn>
    attribute, if specified, must give a valid URI (or IRI) pointing to a
    resource that uses the <code>text/event-stream</code> format.</p>
-  <!--XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
+  <!-- XXXURL refer to new algorithms -->
 
   <p>When the element is inserted into the document, if it has the <code
    title=attr-event-source-src><a href="#src11">src</a></code> attribute
@@ -24223,7 +24223,8 @@
    href="#addeventsource">addEventSource()</a></code> method on the <code><a
    href="#event-source">event-source</a></code> element had been invoked with
    the URI resulting from resolving the <code title=attr-event-source-src><a
-   href="#src11">src</a></code> attribute's value to an absolute URI.
+   href="#src11">src</a></code> attribute's value to an absolute URI.</p>
+  <!-- XXXURL refer to new algorithms -->
 
   <p>While the element is in a document, if its <code
    title=attr-event-source-src><a href="#src11">src</a></code> attribute is
@@ -24237,7 +24238,8 @@
    href="#addeventsource">addEventSource()</a></code> method on the element
    had been invoked with the URI resulting from resolving the <em>new</em>
    value of the <code title=attr-event-source-src><a
-   href="#src11">src</a></code> attribute to an absolute URI.
+   href="#src11">src</a></code> attribute to an absolute URI.</p>
+  <!-- XXXURL refer to new algorithms -->
 
   <p>When the element is removed from the document, if it has the <code
    title=attr-event-source-src><a href="#src11">src</a></code> attribute
@@ -24655,7 +24657,8 @@
 
    <dt><dfn id=getrowimage
     title=dom-provider-getRowImage><code>getRowImage(<var
-    title="">row</var>)</code></dfn>
+    title="">row</var>)</code></dfn></dt>
+   <!-- XXXURL just say "the URL of" -->
 
    <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.
@@ -25130,7 +25133,8 @@
     <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
@@ -25383,7 +25387,7 @@
      <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
@@ -25391,7 +25395,7 @@
      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>
 
-    <div class=example>
+    <div class=example> <!-- XXXURL change to URL -->
      <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
       the row with path "1") return the empty string:</p>
@@ -25901,8 +25905,10 @@
    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>To obtain a URI to an image representing a row</dt>
+   <!-- XXXURL define how to absolutify -->
 
    <dd>Invoke the <code title=dom-provider-getRowImage><a
     href="#getrowimage">getRowImage()</a></code> method with a <code><a
@@ -27033,7 +27039,8 @@
 
    <dt><dfn id=icon1 title=command-facet-Icon>Icon</dfn>
 
-   <dd>A graphical image that represents the action.
+   <dd>A graphical image that represents the action.</dd>
+   <!-- XXXURL define it to be an asbolute URL? -->
 
    <dt><dfn id=hidden1 title=command-facet-HiddenState>Hidden State</dfn>
 
@@ -27054,7 +27061,8 @@
 
    <dd>Whether the command is checked or not.
 
-   <dt><dfn id=action title=command-facet-Action>Action</dfn>
+   <dt><dfn id=action title=command-facet-Action>Action</dfn></dt>
+   <!-- XXXURL change to URL -->
 
    <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
@@ -27135,7 +27143,8 @@
    a command or does not specify a <a href="#hint"
    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.
+   the <code><a href="#htmlelement">HTMLElement</a></code> interface.</p>
+  <!-- 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>
    attribute must return an absolute URI to the command's <a href="#icon1"
@@ -27229,7 +27238,8 @@
    the value of the <code title=attr-title><a href="#title">title</a></code>
    attribute of the <code><a href="#a">a</a></code> element. If the attribute
    is not present, the <a href="#hint" title=command-facet-Hint>Hint</a> is
-   the empty string.
+   the empty string.</p>
+  <!-- XXXURL refer to the URL algorithms -->
 
   <p>The <a href="#icon1" title=command-facet-Icon>Icon</a> of the command is
    the absolute URI of the first image in the element. Specifically, in a
@@ -27448,7 +27458,8 @@
   <p>The <a href="#hint" title=command-facet-Hint>Hint</a> of the command is
    the string given by the element's <code title=attr-command-title><a
    href="#title6">title</a></code> attribute, if any, and the empty string if
-   the attribute is absent.
+   the attribute is absent.</p>
+  <!-- XXXURL refer to the URL algorithms -->
 
   <p>The <a href="#icon1" title=command-facet-Icon>Icon</a> for the command
    is the absolute URI resulting from resolving the value of the element's
@@ -27481,6 +27492,7 @@
    interface.</p>
   <!-- XXX update to
   point to dom-click when we remove dom-command-click -->
+  <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
 
   <h3 id=datatemplate><span class=secno>3.16 </span>Data Templates</h3>
 

Received on Wednesday, 18 June 2008 03:43:54 UTC