[html5] r1783 - /

whatwg at whatwg.org whatwg at whatwg.org
Tue Jun 17 20:37:27 PDT 2008


Author: ianh
Date: 2008-06-17 20:37:26 -0700 (Tue, 17 Jun 2008)
New Revision: 1783

Modified:
   index
   source
Log:
[e] (0) more notes for the upcoming url rework

Modified: index
===================================================================
--- index	2008-06-17 23:06:58 UTC (rev 1782)
+++ index	2008-06-18 03:37:26 UTC (rev 1783)
@@ -25,7 +25,7 @@
 
    <h1 id=html-5>HTML 5</h1>
 
-   <h2 class="no-num no-toc" id=draft>Draft Recommendation — 17 June
+   <h2 class="no-num no-toc" id=draft>Draft Recommendation — 18 June
     2008</h2>
 
    <p>You can take part in this work. <a
@@ -24110,7 +24110,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
@@ -24119,7 +24119,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
@@ -24133,7 +24134,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
@@ -24551,7 +24553,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.
@@ -25026,7 +25029,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
@@ -25279,7 +25283,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
@@ -25287,7 +25291,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>
@@ -25797,8 +25801,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
@@ -26929,7 +26935,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>
 
@@ -26950,7 +26957,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
@@ -27031,7 +27039,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"
@@ -27125,7 +27134,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
@@ -27344,7 +27354,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
@@ -27377,6 +27388,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>
 

Modified: source
===================================================================
--- source	2008-06-17 23:06:58 UTC (rev 1782)
+++ source	2008-06-18 03:37:26 UTC (rev 1783)
@@ -21907,8 +21907,7 @@
   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">src</code> attribute specified,
   the user agent must act as if the <code
@@ -21918,6 +21917,7 @@
   title="attr-event-source-src">src</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">src</code> attribute is mutated, the
   user agent must act as if first the <code
@@ -21931,6 +21931,7 @@
   title="attr-event-source-src">src</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">src</code> attribute specified,
   or, when the <code title="attr-event-source-src">src</code>
@@ -22298,6 +22299,7 @@
 
    <dt><dfn title="dom-provider-getRowImage"><code>getRowImage(<var 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. May be omitted if no rows have associated images. If the
@@ -22701,6 +22703,7 @@
     attributes are <span title="ignore">ignored</span> by this
     algorithm.</p>
 
+    <!-- XXXURL take the string from the <img> and absolutify it and return that. -->
     <p><strong><code title="dom-provider-getRowImage">getRowImage(<var
     title="">i</var>)</code></strong>: If the row's first cell's
     element has an <code>img</code> element child, then the URI of the
@@ -22957,6 +22960,7 @@
     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">getRowImage(<var
     title="">i</var>)</code> must return the URI of the image given by
     the first <code>img</code> element descendant (in the real DOM) of
@@ -22966,6 +22970,7 @@
 
     <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>
@@ -23495,8 +23500,11 @@
    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 -->
    <dd>Invoke the <code
    title="dom-provider-getRowImage">getRowImage()</code> method with a
    <code>RowSpecification</code> object representing the row in
@@ -24577,7 +24585,7 @@
 
    <dt><dfn title="command-facet-Icon">Icon</dfn></dt>
 
-   <dd>A graphical image that represents the action.</dd>
+   <dd>A graphical image that represents the action.</dd> <!-- XXXURL define it to be an asbolute URL? -->
 
    <dt><dfn title="command-facet-HiddenState">Hidden State</dfn></dt>
 
@@ -24600,6 +24608,7 @@
 
    <dt><dfn 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 submission.</dd>
@@ -24682,6 +24691,7 @@
   shadowed by the <code title="dom-title">title</code> DOM attribute
   on the <code>HTMLElement</code> interface.</p>
 
+  <!-- XXXURL "must return the absolute URL of the command's icon"? -->
   <p>The <dfn title="dom-command-ro-icon"><code>icon</code></dfn>
   attribute must return an absolute URI to the command's <span
   title="command-facet-Icon">Icon</span>. If the element does not
@@ -24777,6 +24787,7 @@
   <span title="command-facet-Hint">Hint</span> is the empty
   string.</p>
 
+  <!-- XXXURL refer to the URL algorithms -->
   <p>The <span title="command-facet-Icon">Icon</span> of the command
   is the absolute URI of the first image in the element. Specifically,
   in a depth-first search of the children of the element, the first
@@ -24995,6 +25006,7 @@
   title="attr-command-title">title</code> attribute, if any, and the
   empty string if the attribute is absent.</p>
 
+  <!-- XXXURL refer to the URL algorithms -->
   <p>The <span title="command-facet-Icon">Icon</span> for the command
   is the absolute URI resulting from resolving the value of the
   element's <code title="attr-command-icon">icon</code> attribute as a
@@ -25025,7 +25037,9 @@
   point to dom-click when we remove dom-command-click -->
 
 
+<!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
 
+
   <h3 id="datatemplate">Data Templates</h3>
 
   <h4>Introduction</h4>




More information about the Commit-Watchers mailing list