[html5] r1789 - /
whatwg at whatwg.org
whatwg at whatwg.org
Wed Jun 18 16:31:18 PDT 2008
Author: ianh
Date: 2008-06-18 16:31:17 -0700 (Wed, 18 Jun 2008)
New Revision: 1789
Modified:
index
source
Log:
[e] (0) final bunch of annotations for url preparation
Modified: index
===================================================================
--- index 2008-06-18 21:20:11 UTC (rev 1788)
+++ index 2008-06-18 23:31:17 UTC (rev 1789)
@@ -30015,7 +30015,6 @@
<code>preventDefault()</code> method must be called when the function
returns true instead.</p>
<!-- IE actually uncancels the event if the function returns true -->
- <!-- XXX update the following to match DOM3 Events -->
<p>All event handler attributes on an element, whether set to null or to a
function, must be registered as event listeners on the element, as if the
@@ -32890,7 +32889,7 @@
<!-- XXX what about if
the base URI is data: or javascript: or about: or something else
without a way to resolve base URIs? -->
- <!-- XXXURLXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
+ <!-- XXXURL change to URL -->
<p>The <code><a href="#location2">Location</a></code> interface also has
the complement of <a href="#uri-decomposition">URI decomposition
@@ -33060,7 +33059,7 @@
affect the browsing context, then abort these steps and proceed with
that mechanism instead.
- <li>
+ <li> <!-- XXXURL change to URL -->
<p>If the new resource is to be fetched using HTTP GET or equivalent, and
if the browsing context being navigated is a <a
href="#top-level">top-level browsing context</a>, then check if there
@@ -33075,7 +33074,7 @@
must then fetch the resource from the <a href="#select0"
title=concept-appcache-selection>most appropriate application cache</a>
of those that match.</p>
-
+ <!-- XXXURL JSURI issue -->
<p>Otherwise, start fetching the specified resource in the appropriate
manner (e.g. performing an HTTP GET or POST operation, or reading the
file from disk, or executing script in the case of a <a
@@ -33100,7 +33099,7 @@
user agent may allow the user to cancel this navigation attempt or start
other navigation attempts.
- <li>
+ <li> <!-- XXXURL change to URL, "fetch"? -->
<p>If the resource was not fetched from an <a
href="#application0">application cache</a>, and was to be fetched using
HTTP GET or equivalent, and its URI <a href="#matches"
@@ -33126,7 +33125,7 @@
title=concept-appcache-foreign>foreign</a>, then the user agent must
discard the failed load and instead continue along these steps using
<var title="">candidate</var> as the resource.</p>
-
+ <!-- XXXURL change to URL -->
<p>For the purposes of session history (and features that depend on
session history, e.g. bookmarking) the user agent must use the URI of
the resource that was requested (the one that matched the
@@ -33350,7 +33349,8 @@
that must be used when determining the character encoding according to the
rules given in the above specifications. Once the character encoding is
established, the <a href="#character1">document's character encoding</a>
- must be set to that character encoding.
+ must be set to that character encoding.</p>
+ <!-- XXXURL change to URL, (algorithms?) -->
<p>If the root element, as parsed according to the XML specifications cited
above, is found to be an <code><a href="#html">html</a></code> element
@@ -33363,7 +33363,8 @@
Otherwise, as soon as the root element is inserted into the DOM, the user
agent must run the <a href="#application3"
title=concept-appcache-init-no-attribute>application cache selection
- algorithm</a> with no manifest.
+ algorithm</a> with no manifest.</p>
+ <!-- XXXURL change to URL -->
<p class=note>Because the processing of the <code
title=attr-html-manifest><a href="#manifest">manifest</a></code> attribute
@@ -33544,6 +33545,7 @@
<h4 id=scroll-to-fragid><span class=secno>4.9.8 </span><dfn id=navigating0
title=navigate-fragid>Navigating to a fragment identifier</dfn></h4>
+ <!-- XXXURL change to URL; XXXDOCURL? -->
<p>When a user agent is supposed to navigate to a fragment identifier, then
the user agent must <a href="#update2">update the session history with the
@@ -33571,7 +33573,8 @@
following processing model must be followed to determine what <a
href="#the-indicated">the indicated part of the document</a> is.
- <ol>
+ <ol><!-- XXXURL algorithms -->
+
<li>
<p>Let <i>fragid</i> be the <fragment> part of the URI. <a
href="#refsRFC3987">[RFC3987]</a>
@@ -33713,6 +33716,8 @@
<p>If the <i>specified entry</i> is a state object or the first entry for
a <code>Document</code>, the user agent must <a href="#activating0"
title="activate the state object">activate that entry</a>.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If the <i>specified entry</i> has a URI that differs from the <a
@@ -35629,7 +35634,8 @@
this information to the third party along with any identifying information
(names, credit card numbers, addresses) obtained by the site. If a third
party cooperates with multiple sites to obtain such information, a profile
- can still be created.
+ can still be created.</p>
+ <!-- XXXURL change to URL -->
<p>However, user tracking is to some extent possible even with no
cooperation from the user agent whatsoever, for instance by using session
@@ -35725,7 +35731,8 @@
<p>The <code><a href="#a">a</a></code>, <code><a
href="#area">area</a></code>, and <code><a href="#link">link</a></code>
elements can, in certain situations described in the definitions of those
- elements, represent <dfn id=hyperlinks title=hyperlink>hyperlinks</dfn>.
+ elements, represent <dfn id=hyperlinks title=hyperlink>hyperlinks</dfn>.</p>
+ <!-- XXXURL change to URL -->
<p>The <dfn id=href6 title=attr-hyperlink-href><code>href</code></dfn>
attribute on a hyperlink element must have a value that is a valid URI (or
@@ -35751,7 +35758,8 @@
title=attr-hyperlink-target><code>target</code></dfn> attribute, if
present, must be a <a href="#valid9">valid browsing context name or
keyword</a>. User agents use this name when <a
- href="#following0">following hyperlinks</a>.
+ href="#following0">following hyperlinks</a>.</p>
+ <!-- XXXURL change to URL -->
<p>The <dfn id=ping title=attr-hyperlink-ping><code>ping</code></dfn>
attribute, if present, gives the URIs of the resources that are interested
@@ -35800,10 +35808,12 @@
<h4 id=following><span class=secno>4.12.2 </span><dfn
id=following0>Following hyperlinks</dfn></h4>
+ <!-- XXXURL change to URL -->
<p>When a user <em>follows a hyperlink</em>, the user agent must <a
href="#navigate">navigate</a> a <a href="#browsing1">browsing context</a>
- to the URI of the hyperlink.
+ to the URI of the hyperlink.</p>
+ <!-- XXXURL change to URL -->
<p>The URI of the hyperlink is URI given by resolving the <code
title=attr-hyperlink-href><a href="#href6">href</a></code> attribute of
@@ -35859,6 +35869,7 @@
href="#source0">source browsing context</a>.
<h5 id=hyperlink0><span class=secno>4.12.2.1. </span>Hyperlink auditing</h5>
+ <!-- XXXURL change to URL, algorithms -->
<p>If an <code><a href="#a">a</a></code> or <code><a
href="#area">area</a></code> hyperlink element has a <code
@@ -35871,7 +35882,8 @@
XXXURL -->)
and then should send a request (as described below) to each of the
resulting URIs. This may be done in parallel with the primary request, and
- is independent of the result of that request.
+ is independent of the result of that request.</p>
+ <!-- XXXURL change to URL -->
<p>User agents should allow the user to adjust this behavior, for example
in conjunction with a setting that disables the sending of HTTP <code
@@ -35879,18 +35891,20 @@
either <a href="#ignored">ignore</a> the <code
title=attr-hyperlink-ping><a href="#ping">ping</a></code> attribute
altogether, or selectively ignore URIs in the list (e.g. ignoring any
- third-party URIs).
+ third-party URIs).</p>
+ <!-- XXXURL change to URL, algorithms? -->
<p>For URIs that are HTTP URIs, the requests must be performed using the
POST method (with an empty entity body in the request). All relevant
cookie and HTTP authentication headers must be included in the request.
Which other headers are required depends on the URIs involved.
- <dl class=switch>
- <dt>If both the URI of the <code>Document</code> object containing the
- hyperlink being audited and the ping URI have the <a
- href="#same-origin">same origin</a>
+ <dl class=switch><!-- XXXURL change to URL; XXXDOCURL -->
+ <dt>If both the <span title="the document's address">address</span> of the
+ <code>Document</code> object containing the hyperlink being audited and
+ the ping URI have the <a href="#same-origin">same origin</a>
+
<dd>The request must include a <code title="">Ping-From</code> HTTP header
with, as its value, the location of the document containing the
hyperlink, and a <code title="">Ping-To</code> HTTP header with, as its
@@ -35922,7 +35936,8 @@
<p>User agents must ignore any entity bodies returned in the responses, but
must, unless otherwise specified by the user, honor the HTTP headers
(including, in particular, redirects and HTTP cookie headers). <a
- href="#refsRFC2965">[RFC2965]</a>
+ href="#refsRFC2965">[RFC2965]</a></p>
+ <!-- XXXURL change to URL -->
<p>When the <code title=attr-hyperlink-ping><a href="#ping">ping</a></code>
attribute is present, user agents should clearly indicate to the user that
@@ -35939,7 +35954,8 @@
href="#ping">ping</a></code> attribute provides these advantages to the
user over those alternatives:</p>
- <ul>
+ <ul><!-- XXXURL change to URL -->
+
<li>It allows the user to see the final target URI unobscured.
<li>It allows the UA to inform the user about the out-of-band
@@ -36399,7 +36415,8 @@
<p>For <code><a href="#link">link</a></code> elements, the <code
title=rel-author><a href="#author">author</a></code> keyword indicates
that the referenced document provides further information about the author
- for the page as a whole.
+ for the page as a whole.</p>
+ <!-- XXXURL change to URL -->
<p class=note>The "referenced document" can be, and often is, a <code
title="">mailto:</code> URI giving the e-mail address of the author. <a
@@ -37138,10 +37155,12 @@
described above, with the "proposal" status.
<p>This specification does not define how new values will get approved. It
- is expected that the Wiki will have a community that addresses this.
+ is expected that the Wiki will have a community that addresses this.</p>
+ <!-- XXXURL change to URL -->
<h3 id=interfaces><span class=secno>4.13 </span>Interfaces for URI
manipulation</h3>
+ <!-- XXXURL change to URL -->
<p>An interface that has a complement of <dfn id=uri-decomposition>URI
decomposition attributes</dfn> will have seven attributes with the
@@ -37156,19 +37175,23 @@
attribute DOMString <a href="#search1" title=dom-uda-search>search</a>;
attribute DOMString <a href="#hash0" title=dom-uda-hash>hash</a>;
</pre>
+ <!-- XXXURL change to URL -->
<p>The attributes defined to be URI decomposition attributes must act as
described for the attributes with the same corresponding names in this
- section.
+ section.</p>
+ <!-- XXXURL change to URL -->
<p>In addition, an interface with a complement of URI decomposition
attributes will define an <dfn id=input
title=concept-uda-input>input</dfn>, which is a URI that the attributes
act on, and a <dfn id=common3 title=concept-uda-setter>common setter
action</dfn>, which is a set of steps invoked when any of the attributes'
- setters are invoked.
+ setters are invoked.</p>
+ <!-- XXXURL change to URL -->
- <p>The seven URI decomposition attributes have similar requirements.
+ <p>The seven URI decomposition attributes have similar requirements.</p>
+ <!-- XXXURL change to URL -->
<p>On getting, if the <a href="#input" title=concept-uda-input>input</a>
fulfills the condition given in the "getter condition" column
@@ -37177,7 +37200,8 @@
URI given in the "component" column, with any prefixes specified in the
"prefix" column appropriately added to the start of the string and any
suffixes specified in the "suffix" column appropriately added to the end
- of the string. Otherwise, the attribute must return the empty string.
+ of the string. Otherwise, the attribute must return the empty string.</p>
+ <!-- XXXURL change to URL; algorithms or something? -->
<p>On setting, the new value must first be mutated as described by the
"setter preprocessor" column, then mutated by %-escaping any characters in
@@ -37190,7 +37214,8 @@
user agent must let <var title="">output</var> be equal to the <a
href="#input" title=concept-uda-input>input</a>. Finally, the user agent
must invoke the <a href="#common3" title=concept-uda-setter>common setter
- action</a> with the value of <var title="">output</var>.
+ action</a> with the value of <var title="">output</var>.</p>
+ <!-- XXXURL change to URL -->
<p>When replacing a component in the URI, if the component is part of an
optional group in the URI syntax consisting of a character followed by the
@@ -37200,7 +37225,8 @@
<p class=note>The previous paragraph applies in particular to the "<code
title="">:</code>" before a <port> component, the "<code
title="">?</code>" before a <query> component, and the "<code
- title="">#</code>" before a <fragment> component.
+ title="">#</code>" before a <fragment> component.</p>
+ <!-- XXXURL change to URL; algorithms -->
<p>The rules for parsing and constructing URIs are described in RFC 3986
and RFC 3987. <a href="#refsRFC3986">[RFC3986]</a> <a
@@ -38580,7 +38606,8 @@
value "<code title="">Text</code>", then it must be treated as "<code
title="">text/plain</code>". If the <var title="">format</var> is "<code
title="">URL</code>", then it must be treated as "<code
- title="">text/uri-list</code>".
+ title="">text/uri-list</code>".</p>
+ <!-- XXXURL change URI to URL -->
<p>The <dfn id=getdata title=dom-DataTransfer-getData><code>getData(<var
title="">format</var>)</code></dfn> method must return the data that is
@@ -39880,7 +39907,8 @@
<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.
+ title="">false</code>" otherwise.</dd>
+ <!-- XXXURL change to URL -->
<dt><dfn id=createlink
title=command-createLink><code>createLink</code></dfn>
@@ -39986,7 +40014,8 @@
<dd><strong>State:</strong> Always false.
<dd><strong>Value:</strong> Always the string "<code
- title="">false</code>".
+ title="">false</code>".</dd>
+ <!-- XXXURL change to URL -->
<dt><dfn id=insertimage
title=command-insertImage><code>insertImage</code></dfn>
@@ -40397,13 +40426,15 @@
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
href="#list-of3" title=concept-event-source-list>list of event sources</a>
- for that object. The same URI can be registered multiple times.
+ for that object. The same URI can be registered multiple times.</p>
+ <!-- XXXURL change to URL -->
<p>When the <dfn id=removeeventsource
title=dom-RemoteEventTarget-removeEventSource><code>removeEventSource(<var
@@ -40412,7 +40443,8 @@
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.
+ of the <code title=removeEventSource>removeEventSource()</code> method.</p>
+ <!-- XXXURL algorithms -->
<p>Relative URIs must be resolved relative to <span
class=big-issue>...</span>.
@@ -40423,7 +40455,8 @@
<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.
+ sources</dfn> that are registered for that object.</p>
+ <!-- XXXURL change to URL; algorithms for 'fetch'? -->
<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
@@ -40453,6 +40486,7 @@
<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.
@@ -40521,14 +40555,16 @@
<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.
+ HTTP 404 responses.</p>
+ <!-- XXXURL change to URL -->
<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
receive 301 responses, and it doesn't affect future sessions, e.g. if the
- page is reloaded.)
+ page is reloaded.)</p>
+ <!-- XXXURL change to URL -->
<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
@@ -40710,6 +40746,8 @@
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
@@ -40833,7 +40871,8 @@
<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.
+ every 15 seconds or so.</p>
+ <!-- XXXURL change to URL -->
<p>Authors wishing to relate event source connections to each other or to
specific documents previously served might find that relying on IP
@@ -46462,7 +46501,7 @@
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"
title=concept-appcache-init-with-attribute>application cache selection
@@ -46473,7 +46512,7 @@
Otherwise, run the <a href="#application3"
title=concept-appcache-init-no-attribute>application cache selection
algorithm</a> with no manifest. <a href="#refsRFC3986">[RFC3986]</a></p>
- <!-- XXX when dealing with
+ <!-- XXXURL when dealing with
microsyntaxes-urls, hoist all this into that section so we can get
rid of "URI" here -->
Modified: source
===================================================================
--- source 2008-06-18 21:20:11 UTC (rev 1788)
+++ source 2008-06-18 23:31:17 UTC (rev 1789)
@@ -27645,7 +27645,6 @@
<!-- IE actually uncancels the event if the function returns true -->
- <!-- XXX update the following to match DOM3 Events -->
<p>All event handler attributes on an element, whether set to null
or to a function, must be registered as event listeners on the
element, as if the <code
@@ -30668,8 +30667,7 @@
the base URI is data: or javascript: or about: or something else
without a way to resolve base URIs? -->
-<!-- XXXURLXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
-
+ <!-- XXXURL change to URL -->
<p>The <code>Location</code> interface also has the complement of
<span>URI decomposition attributes</span>, <dfn
title="dom-location-protocol"><code>protocol</code></dfn>, <dfn
@@ -30833,6 +30831,7 @@
<li>
+ <!-- XXXURL change to URL -->
<p>If the new resource is to be fetched using HTTP GET or
equivalent, and if the browsing context being navigated is a
<span>top-level browsing context</span>, then check if there are
@@ -30847,6 +30846,7 @@
title="concept-appcache-selection">most appropriate application
cache</span> of those that match.</p>
+ <!-- XXXURL JSURI issue -->
<p>Otherwise, start fetching the specified resource in the
appropriate manner (e.g. performing an HTTP GET or POST operation,
or reading the file from disk, or executing script in the case of
@@ -30875,6 +30875,7 @@
<li>
+ <!-- XXXURL change to URL, "fetch"? -->
<p>If the resource was not fetched from an <span>application
cache</span>, and was to be fetched using HTTP GET or equivalent,
and its URI <span
@@ -30906,6 +30907,7 @@
these steps using <var title="">candidate</var> as the
resource.</p>
+ <!-- XXXURL change to URL -->
<p>For the purposes of session history (and features that depend
on session history, e.g. bookmarking) the user agent must use
the URI of the resource that was requested (the one that matched
@@ -31147,6 +31149,7 @@
<span>document's character encoding</span> must be set to that
character encoding.</p>
+ <!-- XXXURL change to URL, (algorithms?) -->
<p>If the root element, as parsed according to the XML
specifications cited above, is found to be an <code>html</code>
element with an attribute <code
@@ -31160,6 +31163,7 @@
title="concept-appcache-init-no-attribute">application cache
selection algorithm</span> with no manifest.</p>
+ <!-- XXXURL change to URL -->
<p class="note">Because the processing of the <code
title="attr-html-manifest">manifest</code> attribute happens
only once the root element is parsed, any URIs referenced by
@@ -31336,6 +31340,7 @@
<h4 id="scroll-to-fragid"><dfn title="navigate-fragid">Navigating to a fragment identifier</dfn></h4>
+ <!-- XXXURL change to URL; XXXDOCURL? -->
<p>When a user agent is supposed to navigate to a fragment
identifier, then the user agent must <span>update the session
history with the new page</span>, where "the new page" has the same
@@ -31366,6 +31371,7 @@
<ol>
+ <!-- XXXURL algorithms -->
<li><p>Let <i>fragid</i> be the <fragment> part of the
URI. <a href="#refsRFC3987">[RFC3987]</a></p></li> <!-- IRI,
ifragment? XXXURL (refer to parsing defined in this spec) -->
@@ -31516,6 +31522,7 @@
title="activate the state object">activate that
entry</span>.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If the <i>specified entry</i> has a URI that differs
from the <span>current entry</span>'s only by its fragment
identifier, and the two share the same <code>Document</code>
@@ -33364,6 +33371,7 @@
sites to obtain such information, a profile can still be
created.</p>
+ <!-- XXXURL change to URL -->
<p>However, user tracking is to some extent possible even with no
cooperation from the user agent whatsoever, for instance by using
session identifiers in URIs, a technique already commonly used for
@@ -33471,6 +33479,7 @@
those elements, represent <dfn
title="hyperlink">hyperlinks</dfn>.</p>
+ <!-- XXXURL change to URL -->
<p>The <dfn title="attr-hyperlink-href"><code>href</code></dfn>
attribute on a hyperlink element must have a value that is a valid
URI (or IRI). This URI is the <em>destination resource</em> of the
@@ -33497,6 +33506,7 @@
or keyword</span>. User agents use this name when <span>following
hyperlinks</span>.</p>
+ <!-- XXXURL change to URL -->
<p>The <dfn id="ping"
title="attr-hyperlink-ping"><code>ping</code></dfn> attribute, if
present, gives the URIs of the resources that are interested in
@@ -33548,10 +33558,12 @@
<h4><dfn>Following hyperlinks</dfn></h4>
+ <!-- XXXURL change to URL -->
<p>When a user <em>follows a hyperlink</em>, the user agent must
<span>navigate</span> a <span>browsing context</span> to the URI of
the hyperlink.</p>
+ <!-- XXXURL change to URL -->
<p>The URI of the hyperlink is URI given by resolving the <code
title="attr-hyperlink-href">href</code> attribute of that hyperlink
relative to the hyperlink's element. In the case of server-side
@@ -33606,6 +33618,7 @@
<h5>Hyperlink auditing</h5>
+ <!-- XXXURL change to URL, algorithms -->
<p>If an <code>a</code> or <code>area</code> hyperlink element has a
<code title="attr-hyperlink-ping">ping</code> attribute and the user
follows the hyperlink, the user agent must take the <code
@@ -33618,6 +33631,7 @@
primary request, and is independent of the result of that
request.</p>
+ <!-- XXXURL change to URL -->
<p>User agents should allow the user to adjust this behavior, for
example in conjunction with a setting that disables the sending of
HTTP <code title="">Referer</code> headers. Based on the user's
@@ -33626,6 +33640,7 @@
selectively ignore URIs in the list (e.g. ignoring any third-party
URIs).</p>
+ <!-- XXXURL change to URL, algorithms? -->
<p>For URIs that are HTTP URIs, the requests must be performed using
the POST method (with an empty entity body in the request). All
relevant cookie and HTTP authentication headers must be included in
@@ -33634,9 +33649,10 @@
<dl class="switch">
- <dt>If both the URI of the <code>Document</code> object containing
- the hyperlink being audited and the ping URI have the <span>same
- origin</span></dt>
+ <!-- XXXURL change to URL; XXXDOCURL -->
+ <dt>If both the <span title="the document's address">address</span>
+ of the <code>Document</code> object containing the hyperlink being
+ audited and the ping URI have the <span>same origin</span></dt>
<dd>The request must include a <code title="">Ping-From</code> HTTP
header with, as its value, the location of the document containing
@@ -33677,6 +33693,7 @@
the HTTP headers (including, in particular, redirects and HTTP
cookie headers). <a href="#refsRFC2965">[RFC2965]</a></p>
+ <!-- XXXURL change to URL -->
<p>When the <code title="attr-hyperlink-ping">ping</code> attribute is
present, user agents should clearly indicate to the user that
following the hyperlink will also cause secondary requests to be
@@ -33695,6 +33712,7 @@
<ul>
+ <!-- XXXURL change to URL -->
<li>It allows the user to see the final target URI
unobscured.</li>
@@ -34073,6 +34091,7 @@
referenced document provides further information about the author
for the page as a whole.</p>
+ <!-- XXXURL change to URL -->
<p class="note">The "referenced document" can be, and often is, a
<code title="">mailto:</code> URI giving the e-mail address of the
author. <a href="#refsMAILTO">[MAILTO]</a></p>
@@ -34809,9 +34828,11 @@
addresses this.</p>
+ <!-- XXXURL change to URL -->
<h3>Interfaces for URI manipulation</h3>
- <p>An interface that has a complement of <dfn>URI decomposition
+ <!-- XXXURL change to URL -->
+ <p>An interface that has a complement of <dfn>URI decomposition
attributes</dfn> will have seven attributes with the following
definitions:</p>
@@ -34825,10 +34846,12 @@
attribute DOMString <span title="dom-uda-hash">hash</span>;
</pre>
+ <!-- XXXURL change to URL -->
<p>The attributes defined to be URI decomposition attributes must
act as described for the attributes with the same corresponding
names in this section.</p>
+ <!-- XXXURL change to URL -->
<p>In addition, an interface with a complement of URI decomposition
attributes will define an <dfn
title="concept-uda-input">input</dfn>, which is a URI that the
@@ -34836,9 +34859,11 @@
setter action</dfn>, which is a set of steps invoked when any of the
attributes' setters are invoked.</p>
+ <!-- XXXURL change to URL -->
<p>The seven URI decomposition attributes have similar
requirements.</p>
+ <!-- XXXURL change to URL -->
<p>On getting, if the <span title="concept-uda-input">input</span>
fulfills the condition given in the "getter condition" column
corresponding to the attribute in the table below, the user agent
@@ -34850,6 +34875,7 @@
the string. Otherwise, the attribute must return the empty
string.</p>
+ <!-- XXXURL change to URL; algorithms or something? -->
<p>On setting, the new value must first be mutated as described by
the "setter preprocessor" column, then mutated by %-escaping any
characters in the new value that are not valid in the relevant
@@ -34865,6 +34891,7 @@
title="concept-uda-setter">common setter action</span> with the
value of <var title="">output</var>.</p>
+ <!-- XXXURL change to URL -->
<p>When replacing a component in the URI, if the component is part
of an optional group in the URI syntax consisting of a character
followed by the component, the component (including its prefix
@@ -34876,6 +34903,7 @@
title="">?</code>" before a <query> component, and the "<code
title="">#</code>" before a <fragment> component.</p>
+ <!-- XXXURL change to URL; algorithms -->
<p>The rules for parsing and constructing URIs are described in RFC
3986 and RFC 3987. <a href="#refsRFC3986">[RFC3986]</a> <a
href="#refsRFC3987">[RFC3987]</a></p>
@@ -36247,6 +36275,7 @@
"<code title="">URL</code>", then it must be treated as "<code
title="">text/uri-list</code>".</p>
+ <!-- XXXURL change URI to URL -->
<p>The <dfn title="dom-DataTransfer-getData"><code>getData(<var
title="">format</var>)</code></dfn> method must return the data that
is associated with the type <var title="">format</var>, if any, and
@@ -37517,6 +37546,7 @@
if the expression given for the "State" above is true, the string
"<code title="">false</code>" otherwise.</dd>
+ <!-- XXXURL change to URL -->
<dt><dfn title="command-createLink"><code>createLink</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must act as if the user
had requested that the selection <a
@@ -37594,6 +37624,7 @@
<dd><strong>State:</strong> Always false.</dd>
<dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
+ <!-- XXXURL change to URL -->
<dt><dfn title="command-insertImage"><code>insertImage</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must act as if the user
had requested that the selection <a
@@ -37904,6 +37935,7 @@
void <span title="dom-RemoteEventTarget-removeEventSource">removeEventSource</span>(in DOMString src);
};</pre>
+ <!-- XXXURL change to URL; algorithms? -->
<p>When the <dfn
title="dom-RemoteEventTarget-addEventSource"><code>addEventSource(<var
title="">src</var>)</code></dfn> method is invoked, the user agent
@@ -37911,6 +37943,7 @@
title="concept-event-source-list">list of event sources</span> for
that object. The same URI can be registered multiple times.</p>
+ <!-- XXXURL change to URL -->
<p>When the <dfn
title="dom-RemoteEventTarget-removeEventSource"><code>removeEventSource(<var
title="">src</var>)</code></dfn> method is invoked, the user agent
@@ -37921,6 +37954,7 @@
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>.</p>
@@ -37932,6 +37966,7 @@
title="concept-event-source-list">list of event sources</dfn> that
are registered for that object.</p>
+ <!-- XXXURL change to URL; algorithms for 'fetch'? -->
<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
@@ -37964,6 +37999,7 @@
</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.</p>
@@ -38035,6 +38071,7 @@
302 Found responses pointing to the appropriate resource), and
otherwise must be treated as HTTP 404 responses.</p>
+ <!-- XXXURL change to URL -->
<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
@@ -38042,6 +38079,7 @@
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 -->
<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 the user agent needs to again request
@@ -38242,7 +38280,8 @@
set the <var title="">data</var> buffer and the <var title="">event
name</var> buffer to the empty string and abort these
steps.</p></li>
-
+
+ <!-- XXXURL change to URL -->
<li><p>Otherwise, create an event that uses the
<code>MessageEvent</code> interface, with the event name <code
title="event-message">message</code>, which does not bubble, is
@@ -38368,6 +38407,7 @@
servers, authors can include a comment line (one starting with a ':'
character) every 15 seconds or so.</p>
+ <!-- XXXURL change to URL -->
<p>Authors wishing to relate event source connections to each other
or to specific documents previously served might find that relying
on IP addresses doesn't work, as individual clients can have
@@ -43528,6 +43568,7 @@
object. Put this element in the <span>stack of open
elements</span>.</p>
+ <!-- XXXURL change to URL; algorithms (with care) -->
<p id="parser-appcache">If the token has an attribute "manifest",
then run the <span
title="concept-appcache-init-with-attribute">application cache
@@ -43538,7 +43579,7 @@
the URI used to retrieve the entity). Otherwise, run the <span
title="concept-appcache-init-no-attribute">application cache
selection algorithm</span> with no manifest. <a
- href="#refsRFC3986">[RFC3986]</a></p><!-- XXX when dealing with
+ href="#refsRFC3986">[RFC3986]</a></p><!-- XXXURL when dealing with
microsyntaxes-urls, hoist all this into that section so we can get
rid of "URI" here -->
More information about the Commit-Watchers
mailing list