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

html5/spec Overview.html,1.1004,1.1005

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 27 Jun 2008 08:04:13 +0000
To: public-html-commits@w3.org
Message-Id: <E1KC8wH-0003Tv-Rx@lionel-hutz.w3.org>

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

Modified Files:
	Overview.html 
Log Message:
remaining URLification (whatwg r1816)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1004
retrieving revision 1.1005
diff -u -d -r1.1004 -r1.1005
--- Overview.html	27 Jun 2008 06:24:58 -0000	1.1004
+++ Overview.html	27 Jun 2008 08:04:11 -0000	1.1005
@@ -40100,8 +40100,7 @@
    providing a tree-based approach to document state). Such UI models should
    be based upon the single <a href="#undo-transaction">undo transaction
    history</a> described in this section, however, such that to a script
-   there is no detectable difference.</p>
-  <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXURL \(url\|uri\|iri\) -->
+   there is no detectable difference.
 
   <h3 id=command><span class=secno>6.10 </span>Command APIs</h3>
 
@@ -40193,8 +40192,7 @@
 
    <dd><strong>Value:</strong> The string "<code title="">true</code>" if the
     expression given for the "State" above is true, the string "<code
-    title="">false</code>" otherwise.</dd>
-   <!-- XXXURL change to URL -->
+    title="">false</code>" otherwise.
 
    <dt><dfn id=createlink
     title=command-createLink><code>createLink</code></dfn>
@@ -40208,8 +40206,8 @@
     existing <code><a href="#a">a</a></code> element, then if the <var
     title="">showUI</var> argument is present and has the value false, then
     the value of the <var title="">value</var> argument must be used as the
-    URI of the link. Otherwise, the user should be prompted for the URI of
-    the link.
+    <a href="#url">URL</a> of the link. Otherwise, the user should be
+    prompted for the URL of the link.
 
    <dd><strong>Enabled When:</strong> The document is <a href="#ready">ready
     for editing host commands</a>.
@@ -40300,8 +40298,7 @@
    <dd><strong>State:</strong> Always false.
 
    <dd><strong>Value:</strong> Always the string "<code
-    title="">false</code>".</dd>
-   <!-- XXXURL change to URL -->
+    title="">false</code>".
 
    <dt><dfn id=insertimage
     title=command-insertImage><code>insertImage</code></dfn>
@@ -40315,8 +40312,8 @@
     an existing <code><a href="#img">img</a></code> element, then if the <var
     title="">showUI</var> argument is present and has the value false, then
     the value of the <var title="">value</var> argument must be used as the
-    URI of the image. Otherwise, the user should be prompted for the URI of
-    the image.
+    <a href="#url">URL</a> of the image. Otherwise, the user should be
+    prompted for the URL of the image.
 
    <dd><strong>Enabled When:</strong> The document is <a href="#ready">ready
     for editing host commands</a>.
@@ -40712,28 +40709,29 @@
   void <a href="#addeventsource" title=dom-RemoteEventTarget-addEventSource>addEventSource</a>(in DOMString src);
   void <a href="#removeeventsource" title=dom-RemoteEventTarget-removeEventSource>removeEventSource</a>(in DOMString src);
 };</pre>
-  <!-- XXXURL change to URL; algorithms? -->
 
   <p>When the <dfn id=addeventsource
    title=dom-RemoteEventTarget-addEventSource><code>addEventSource(<var
-   title="">src</var>)</code></dfn> method is invoked, the user agent must
-   add the URI specified in <var title="">src</var> to the <a
+   title="">src</var>)</code></dfn> method is invoked, the user agent must <a
+   href="#resolve" title="resolve a url">resolve</a> the <a
+   href="#url">URL</a> specified in <var title="">src</var>, and if that
+   succeeds, add the resulting <a href="#absolute">absolute URL</a> to the <a
    href="#list-of3" title=concept-event-source-list>list of event sources</a>
-   for that object. The same URI can be registered multiple times.</p>
-  <!-- XXXURL change to URL -->
+   for that object. The same URL can be registered multiple times. If the URL
+   fails to resolve, then the user agent must raise a <code>SYNTAX_ERR</code>
+   exception.
 
   <p>When the <dfn id=removeeventsource
    title=dom-RemoteEventTarget-removeEventSource><code>removeEventSource(<var
-   title="">src</var>)</code></dfn> method is invoked, the user agent must
-   remove the URI specified in <var title="">src</var> from the <a
-   href="#list-of3" title=concept-event-source-list>list of event sources</a>
-   for that object. If the same URI has been registered multiple times,
-   removing it must remove only one instance of that URI for each invocation
-   of the <code title=removeEventSource>removeEventSource()</code> method.</p>
-  <!-- XXXURL algorithms -->
-
-  <p>Relative URIs must be resolved relative to <span
-   class=big-issue>...</span>.
+   title="">src</var>)</code></dfn> method is invoked, the user agent must <a
+   href="#resolve" title="resolve a url">resolve</a> the <a
+   href="#url">URL</a> specified in <var title="">src</var>, and if that
+   succeeds, remove the resulting <a href="#absolute">absolute URL</a> from
+   the <a href="#list-of3" title=concept-event-source-list>list of event
+   sources</a> for that object. If the same URI has been registered multiple
+   times, removing it must remove only one instance of that URI for each
+   invocation of the <code title=removeEventSource>removeEventSource()</code>
+   method. If the URL fails to resolve, the user agent does nothing.
 
   <h4 id=connecting><span class=secno>7.2.2 </span>Connecting to an event
    stream</h4>
@@ -40741,13 +40739,12 @@
   <p>Each object implementing the <code>EventTarget</code> and <code><a
    href="#remoteeventtarget0">RemoteEventTarget</a></code> interfaces has a
    <dfn id=list-of3 title=concept-event-source-list>list of event
-   sources</dfn> that are registered for that object.</p>
-  <!-- XXXURL change to URL; algorithms for 'fetch'? -->
+   sources</dfn> that are registered for that object.
 
   <p>When a new URI is added to this list, the user agent should, as soon as
-   all currently executing scripts (if any) have finished executing, and if
-   the specified URI isn't removed from the list before they do so, fetch the
-   resource identified by that URI.
+   all currently executing scripts (if any) have finished
+   executing<!-- XXX queue -->, and if the specified URL isn't removed from
+   the list before they do so, fetch the resource identified by that URL.
 
   <p>When an event source is removed from the list of event sources for an
    object, if that resource is still being fetched, then the relevant
@@ -40772,10 +40769,9 @@
    <li>The <dfn id=last-event title=concept-event-stream-last-event-id>last
     event ID string</dfn>. This must initially be the empty string.
   </ul>
-  <!-- XXXURL change to URL -->
 
   <p>In general, the semantics of the transport protocol specified by the
-   URIs for the event sources must be followed, including HTTP caching rules.
+   URLs for the event sources must be followed, including HTTP caching rules.
 
   <p>For HTTP connections, the <code title="">Accept</code> header may be
    included; if included, it must contain only formats of event framing that
@@ -40841,21 +40837,19 @@
   <p>HTTP 300 Multiple Choices responses should be handled automatically if
    possible (treating the responses as if they were 302 Found responses
    pointing to the appropriate resource), and otherwise must be treated as
-   HTTP 404 responses.</p>
-  <!-- XXXURL change to URL -->
+   HTTP 404 responses.
 
   <p>HTTP 301 Moved Permanently responses must cause the user agent to
-   reconnect using the new server specified URI instead of the previously
-   specified URI for all subsequent requests for this event source. (It
-   doesn't affect other event sources with the same URI unless they also
+   reconnect using the new server specified URL instead of the previously
+   specified URL for all subsequent requests for this event source. (It
+   doesn't affect other event sources with the same URL unless they also
    receive 301 responses, and it doesn't affect future sessions, e.g. if the
-   page is reloaded.)</p>
-  <!-- XXXURL change to URL -->
+   page is reloaded.)
 
   <p>HTTP 302 Found, 303 See Other, and 307 Temporary Redirect responses must
-   cause the user agent to connect to the new server-specified URI, but if
+   cause the user agent to connect to the new server-specified URL, but if
    the user agent needs to again request the resource at a later point, it
-   must return to the previously specified URI for this event source.
+   must return to the previously specified URL for this event source.
 
   <p>HTTP 304 Not Modified responses should be handled like HTTP 200 OK
    responses, with the content coming from the user agent cache. A new
@@ -41032,8 +41026,6 @@
      href="http://www.w3.org/TR/REC-xml-names/#NT-NCName">NCName</a>, set the
      <var title="">data</var> buffer and the <var title="">event name</var>
      buffer to the empty string and abort these steps.
-   </li>
-   <!-- XXXURL change to URL -->
 
    <li>
     <p>Otherwise, create an event that uses the <code><a
@@ -41044,7 +41036,7 @@
      attribute must be set to the value of the <var title="">data</var>
      buffer, the <code title=dom-MessageEvent-origin><a
      href="#origin1">origin</a></code> attribute must be set to the <a
-     href="#origin0">origin</a> of the event stream's URI, the <code
+     href="#origin0">origin</a> of the event stream's URL, the <code
      title=dom-MessageEvent-lastEventId><a
      href="#lasteventid">lastEventId</a></code> attribute must be set to the
      <span>last event ID string</span> of the event source, and the <code
@@ -41157,8 +41149,7 @@
   <p>Legacy proxy servers are known to, in certain cases, drop HTTP
    connections after a short timeout. To protect against such proxy servers,
    authors can include a comment line (one starting with a ':' character)
-   every 15 seconds or so.</p>
-  <!-- XXXURL change to URL -->
+   every 15 seconds or so.
 
   <p>Authors wishing to relate event source connections to each other or to
    specific documents previously served might find that relying on IP
@@ -41166,7 +41157,7 @@
    addresses (due to having multiple proxy servers) and individual IP
    addresses can have multiple clients (due to sharing a proxy server). It is
    better to include a unique identifier in the document when it is served
-   and then pass that identifier as part of the URI in the <code
+   and then pass that identifier as part of the URL in the <code
    title=attr-event-source-src><a href="#src11">src</a></code> attribute of
    the <code><a href="#event-source">event-source</a></code> element.
 
@@ -42042,8 +42033,9 @@
 
   <ol>
    <li>
-    <p>If the value of the <var title="">targetOrigin</var> argument is
-     neither a single U+002A ASTERISK character ("*") nor a valid URI or IRI,
+    <p>If the value of the <var title="">targetOrigin</var> argument is not a
+     single U+002A ASTERISK character ("*"), and <a href="#parse0"
+     title="parse a url">parsing</a> it as a <a href="#url">URL</a> fails,
      then throw a <code>SYNTAX_ERR</code> exception and abort the overall set
      of steps. <a href="#references">[RFC3986]</a> <a
      href="#references">[RFC3987]</a></p>
@@ -46786,21 +46778,18 @@
      href="#html-namespace0">HTML namespace</a>. Append it to the
      <code>Document</code> object. Put this element in the <a
      href="#stack">stack of open elements</a>.</p>
-    <!-- XXXURL change to URL; algorithms (with care) -->
-    <p id=parser-appcache>If the token has an attribute "manifest", then run
-     the <a href="#application2"
+
+    <p id=parser-appcache>If the token has an attribute "manifest", then <a
+     href="#resolve" title="resolve a url">resolve</a> the value of that
+     attribute to an <a href="#absolute">absolute URL</a>, and if that is
+     successful, run the <a href="#application2"
      title=concept-appcache-init-with-attribute>application cache selection
-     algorithm</a> with the value of that attribute as the manifest URI,
-     resolving relative URIs according to section 5.1 of RFC3986 as if there
-     was no base URI embedded in content (i.e. relative to the base URI from
-     the encapsulating entity or the URI used to retrieve the entity).
-     Otherwise, run the <a href="#application3"
+     algorithm</a> with the resulting <a href="#absolute">absolute URL</a>.
+     Otherwise, if there is no such attribute or resolving it fails, run the
+     <a href="#application3"
      title=concept-appcache-init-no-attribute>application cache selection
      algorithm</a> with no manifest. <a href="#references">[RFC3986]</a></p>
-    <!-- XXXURL when dealing with
-    microsyntaxes-urls, hoist all this into that section so we can get
-    rid of "URI" here -->
-    
+
     <p>Switch the <span>insertion mode</span> to "<a href="#before5"
      title="insertion mode: before head">before head</a>".</p>
 
@@ -52872,7 +52861,6 @@
 
 some sort of markup to tell google _not_ to index a particular part of the site
 
-drop down menu with URIs to replace the silly <select> hacks.
 
 http://www.cs.tut.fi/~jkorpela/html/em.html
 
@@ -53086,7 +53074,7 @@
 
 
   <h2>Tree and List Widgets</h2>
-   click item to go uri
+   click item to go url
    doube click to submit form with value
    sort list by any column
    specify column headers, column sort types
@@ -53309,7 +53297,7 @@
    file.read();
    var file = window.saveAsFile(); // throws up UI
    file.write();
-...or something? Or use data: URIs and right-click-to-save?
+...or something? Or use data: URLs and right-click-to-save?
 
 http://lxr.mozilla.org/mozilla/source/dom/public/idl/html/nsIDOMNSHTMLDocument.idl
 
@@ -53508,7 +53496,7 @@
 
 how to handle 205 reset content responses and other HTTP codes in
 response to link clicks, link clicks with target="" attributes,
-window.open(), the user typing a URI in the URL bar, etc.
+window.open(), the user typing a URL in the URL bar, etc.
 
 XXX Native code for fast sorting of many data?
 
@@ -54029,7 +54017,7 @@
 
    <dt><dfn title="attr-command-icon"><code>icon</code></dfn></dt>
 
-   <dd>A URI to the command's Icon. If the attribute is not specified,
+   <dd>A URL to the command's Icon. If the attribute is not specified,
    then the command has no Icon.</dd>
 
    <dt><dfn title="attr-command-onclick"><code>onclick</code></dfn></dt>
Received on Friday, 27 June 2008 08:04:49 GMT

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