- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 26 Jun 2008 09:33:57 +0000
- To: public-html-commits@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><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 UTC