[html5] r1788 - /
whatwg at whatwg.org
whatwg at whatwg.org
Wed Jun 18 14:20:12 PDT 2008
Author: ianh
Date: 2008-06-18 14:20:11 -0700 (Wed, 18 Jun 2008)
New Revision: 1788
Modified:
index
source
Log:
[e] (0) yet more mindnumbingly boring preparation work for the upcoming URL reorg
Modified: index
===================================================================
--- index 2008-06-18 08:19:37 UTC (rev 1787)
+++ index 2008-06-18 21:20:11 UTC (rev 1788)
@@ -30940,8 +30940,7 @@
<p>The <code title=dom-navigator-registerContentHandler><a
href="#registercontenthandler">registerContentHandler()</a></code> method
would work equivalently, but for unknown MIME types instead of unknown
- protocols.</p>
- <!-- XXXURL XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
+ protocols.
<h3 id=offline><span class=secno>4.7 </span>Offline Web applications</h3>
@@ -30952,15 +30951,18 @@
<p class=big-issue>...
<h4 id=appcache><span class=secno>4.7.2 </span>Application caches</h4>
+ <!-- XXXURL change to URL -->
<p>An <dfn id=application0>application cache</dfn> is a collection of
resources. An application cache is identified by the URI of a resource
- manifest which is used to populate the cache.
+ manifest which is used to populate the cache.</p>
+ <!-- XXXURL change to URL -->
<p>Application caches are versioned, and there can be different instances
of caches for the same manifest URI, each having a different version. A
cache is newer than another if it was created after the other (in other
- words, caches in a group have a chronological order).
+ words, caches in a group have a chronological order).</p>
+ <!-- XXXURL change to URL -->
<p>Each group of application caches for the same manifest URI have a common
<dfn id=update0 title=concept-appcache-status>update status</dfn>, which
@@ -30985,7 +30987,7 @@
<p>An application cache consists of:
<ul>
- <li>
+ <li> <!-- XXXURL change to URL -->
<p>One of more resources (including their out-of-band metadata, such as
HTTP headers, if any), identified by URIs, each falling into one (or
more) of the following categories:</p>
@@ -31002,7 +31004,7 @@
attribute.
<dt><dfn id=the-manifest title=concept-appcache-manifest>The
- manifest</dfn>
+ manifest</dfn> <!-- XXXURL change to URL -->
<dd>The resource corresponding to the URI that was given in an implicit
entry's <code><a href="#html">html</a></code> element's <code
@@ -31033,6 +31035,7 @@
<dt><dfn id=opportunistically
title=concept-appcache-oppcache>Opportunistically cached entries</dfn>
+ <!-- XXXURL change to URL -->
<dd>Resources whose URIs <a href="#matches"
title=concept-appcache-matches-oppcache>matched</a> an <a
@@ -31046,11 +31049,13 @@
<dd>Resources that were added to the cache by the <code
title=dom-appcache-add><a href="#adduri">add()</a></code> method.
</dl>
-
+ <!-- XXXURL change to URL -->
<p class=note>A URI in the list can be flagged with multiple different
types, and thus an entry can end up being categorized as multiple
entries. For example, an entry can be an explicit entry and a dynamic
entry at the same time.</p>
+ </li>
+ <!-- XXXURL change to URL -->
<li>Zero or more <dfn id=opportunistic
title=concept-appcache-oppcache-ns>opportunistic caching
@@ -31060,7 +31065,8 @@
title=concept-appcache-fallback>fallback entry</a>. Each namespace URI
prefix, when parsed as a URI, has the <a href="#same-origin">same
origin</a> as <a href="#the-manifest" title=concept-appcache-manifest>the
- manifest</a>.
+ manifest</a>.</li>
+ <!-- XXXURL change to URL -->
<li>Zero or more URIs that form the <dfn id=online
title=concept-appcache-onlinewhitelist>online whitelist</dfn>.
@@ -31123,7 +31129,7 @@
CHARACTER TABULATION (tab) characters, followed by a single U+0023
NUMBER SIGN (#) character, followed by zero or more characters other
than U+000A LINE FEED (LF) and U+000D CARRIAGE RETURN (CR) characters.</p>
-
+ <!-- XXXURL change to URL -->
<p class=note>Comments must be on a line on their own. If they were to be
included on a line with a URI, the "#" would be mistaken for part of a
fragment identifier.</p>
@@ -31177,13 +31183,14 @@
zero or more U+0020 SPACE and U+0009 CHARACTER TABULATION (tab)
characters. <a href="#refsRFC3986">[RFC3986]</a> <a
href="#refsRFC3987">[RFC3987]</a></p>
-
+ <!-- XXXURL change to URL -->
<p class=note>The URI or IRI references in data lines can't be empty
strings, since those would be relative URIs to the manifest itself. Such
lines would be confused with blank or invalid lines, anyway.</p>
</dl>
- <p>Manifests may contain sections more than once. Sections may be empty.
+ <p>Manifests may contain sections more than once. Sections may be empty.</p>
+ <!-- XXXURL change to URL -->
<p>URIs that are to be fallback pages associated with <a
href="#opportunistic" title=concept-appcache-oppcache-ns>opportunistic
@@ -31197,19 +31204,23 @@
must have the <a href="#same-origin">same origin</a> as the manifest
itself.
- <p>An opportunistic caching namespace must not be listed more than once.
+ <p>An opportunistic caching namespace must not be listed more than once.</p>
+ <!-- XXXURL change to URL -->
<p>URIs that the user agent is to put into the <a href="#online"
title=concept-appcache-onlinewhitelist>online whitelist</a> must all be
specified in online whitelist sections. (This is needed for any URI that
- the page is intending to use to communicate back to the server.)
+ the page is intending to use to communicate back to the server.)</p>
+ <!-- XXXURL change to URL -->
<p>URIs in the online whitelist section must not also be listed in explicit
section, and must not be listed as fallback entries in the fallback
section. (URIs in the online whitelist section may match opportunistic
- caching namespaces, however.)
+ caching namespaces, however.)</p>
+ <!-- XXXURL change to URL -->
- <p>Relative URIs must be given relative to the manifest's own URI.
+ <p>Relative URIs must be given relative to the manifest's own URI.</p>
+ <!-- XXXURL change to URL; maybe have explicit support for this in the URL section? -->
<p>URIs in manifests must not have fragment identifiers.
@@ -31227,10 +31238,14 @@
be replaced by U+FFFD REPLACEMENT CHARACTERs. (this isn't black-box
testable since neither U+0000 nor U+FFFD are valid anywhere in the
syntax and thus both will be treated the same anyway)-->
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>Let <var title="">explicit URIs</var> be an initially empty list of <a
href="#explicit" title=concept-appcache-explicit>explicit entries</a>.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>Let <var title="">fallback URIs</var> be an initially empty mapping of
@@ -31238,6 +31253,8 @@
title=concept-appcache-oppcache-ns>opportunistic caching namespaces</a>
to <a href="#fallback0" title=concept-appcache-fallback>fallback
entries</a>.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>Let <var title="">online whitelist URIs</var> be an initially empty
@@ -31329,19 +31346,19 @@
<dl class=switch>
<dt>If <var title="">mode</var> is "explicit"
- <dd>
+ <dd> <!-- XXXURL change to URL -->
<p>If <var title="">line</var> is not a syntactically correct URI
reference or IRI reference, then jump back to the step labeled "start
of line".</p>
-
+ <!-- XXXURL change to URL -->
<p>Otherwise, resolve the URI reference or IRI reference to an absolute
URI or IRI, and drop the fragment identifier, if any.</p>
-
+ <!-- XXXURL change to URL -->
<p>Now, if the resource's URI has a different <scheme> component
than the manifest's URI (compared
case-insensitively<!-- XXX ASCII -->), then jump back to the step
labeled "start of line".</p>
-
+ <!-- XXXURL change to URL -->
<p>Otherwise, add this URI to the <var title="">explicit URIs</var>.</p>
<dt>If <var title="">mode</var> is "fallback"
@@ -31359,32 +31376,32 @@
<p>Strip any leading U+0020 SPACE or U+0009 CHARACTER TABULATION (tab)
characters in <var title="">part two</var>.</p>
-
+ <!-- XXXURL change to URL -->
<p>If <var title="">part one</var> and <var title="">part two</var> are
not both syntactically correct URI or IRI references, then jump back
to the step labeled "start of line".</p>
-
+ <!-- XXXURL use algorithms -->
<p>Resolve the URI or IRI references in <var title="">part one</var>
and <var title="">part two</var> to absolute URIs or IRIs, and drop
the fragment identifiers, if any.</p>
-
+ <!-- XXXURL change to URL -->
<p>If the absolute URI or IRI corresponding to <var title="">part
one</var> is already in the <var title="">fallback URIs</var> mapping
as an <a href="#opportunistic"
title=concept-appcache-oppcache-ns>opportunistic caching
namespace</a>, then jump back to the step labeled "start of line".</p>
-
+ <!-- XXXURL change to URL -->
<p>If the absolute URI or IRI corresponding to <var title="">part
one</var> does not have the <a href="#same-origin">same origin</a> as
the manifest's URI, then jump back to the step labeled "start of
line".</p>
- <!-- SECURITY -->
+ <!-- SECURITY --> <!-- XXXURL change to URL -->
<p>If the absolute URI or IRI corresponding to <var title="">part
two</var> has a different <scheme> component than the manifest's
URI (compared case-insensitively<!-- XXX
ASCII -->), then jump
back to the step labeled "start of line".</p>
-
+ <!-- XXXURL change to URL -->
<p>Otherwise, add the absolute URI or IRI corresponding to <var
title="">part one</var> to the <var title="">fallback URIs</var>
mapping as an <a href="#opportunistic"
@@ -31395,18 +31412,18 @@
<dt>If <var title="">mode</var> is "online whitelist"
- <dd>
+ <dd> <!-- XXXURL change to URL -->
<p>If <var title="">line</var> is not a syntactically correct URI
reference or IRI reference, then jump back to the step labeled "start
of line".</p>
-
+ <!-- XXXURL change to URL -->
<p>Otherwise, resolve the URI reference or IRI reference to an absolute
URI or IRI, and drop the fragment identifier, if any.</p>
-
+ <!-- XXXURL change to URL -->
<p>Now, if the resource's URI has a different <scheme> component
than the manifest's URI, then jump back to the step labeled "start of
line".</p>
-
+ <!-- XXXURL change to URL -->
<p>Otherwise, add this URI to the <var title="">online whitelist
URIs</var>.</p>
</dl>
@@ -31414,12 +31431,15 @@
<li>
<p>Jump back to the step labeled "start of line". (That step jumps to the
next, and last, step when the end of the file is reached.)
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>Return the <var title="">explicit URIs</var> list, the <var
title="">fallback URIs</var> mapping, and the <var title="">online
whitelist URIs</var>.
</ol>
+ <!-- XXXURL change to URL -->
<p>Relative URI references and IRI references resolved to absolute URIs or
IRIs in the above algorithm must be resolved according to section 5.1 of
@@ -31448,16 +31468,21 @@
ui the first time they cache themselves (right now the original cache is
done without notifications to the browsing contexts)
- <ol>
+ <ol><!-- XXXURL change to URL -->
+
<li>
<p>Let <var title="">manifest URI</var> be the URI of the <a
href="#the-manifest" title=concept-appcache-manifest>manifest</a> of the
cache to be updated.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>Let <var title="">cache group</var> be the group of <a
href="#application0" title="application cache">application caches</a>
identified by <var title="">manifest URI</var>.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>Let <var title="">cache</var> be the most recently updated <a
@@ -31474,7 +31499,7 @@
<i>checking</i>. This entire step must be performed as one atomic
operation so as to avoid race conditions.
- <li>
+ <li> <!-- XXXURL change to URL -->
<p>If there is already a resource with the URI of <var title="">manifest
URI</var> in <var title="">cache</var>, and that resource is categorized
as a <a href="#the-manifest"
@@ -31501,7 +31526,7 @@
indicating to the user that the user agent is checking for the
availability of updates.</p>
- <li>
+ <li> <!-- XXXURL change to URL -->
<p>Fetch the resource from <var title="">manifest URI</var>, and let <var
title="">manifest</var> be that resource.</p>
@@ -31572,6 +31597,8 @@
with a cache in <var title="">cache group</var>. The default action of
this event should be the display of some sort of user interface
indicating to the user that a new version is being downloaded.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If this is an <a href="#upgrade"
@@ -31581,21 +31608,29 @@
title="">manifest URI</span>, being a new version in <var title="">cache
group</var>. Otherwise, let <var title="">new cache</var> and <var
title="">cache</var> be the same version of the application cache.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>Let <var title="">file list</var> be an empty list of URIs with flags.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>Add all the URIs in the list of <a href="#explicit"
title=concept-appcache-explicit>explicit entries</a> obtained by parsing
<var title="">manifest</var> to <var title="">file list</var>, each
flagged with "explicit entry".
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>Add all the URIs in the list of <a href="#fallback0"
title=concept-appcache-fallback>fallback entries</a> obtained by parsing
<var title="">manifest</var> to <var title="">file list</var>, each
flagged with "fallback entry".
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If this is an <a href="#upgrade"
@@ -31608,6 +31643,8 @@
caching namespaces</a> obtained by parsing <var title="">manifest</var>
to <var title="">file list</var>, each flagged with "opportunistic
entry".
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If this is an <a href="#upgrade"
@@ -31615,6 +31652,8 @@
URIs of <a href="#implicit" title=concept-appcache-implicit>implicit
entries</a> in <var title="">cache</var> to <var title="">file
list</var>, each flagged with "implicit entry".
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If this is an <a href="#upgrade"
@@ -31622,13 +31661,15 @@
URIs of <a href="#dynamic3" title=concept-appcache-dynamic>dynamic
entries</a> in <var title="">cache</var> to <var title="">file
list</var>, each flagged with "dynamic entry".
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If any URI is in <var title="">file list</var> more than once, then
merge the entries into one entry for that URI, that entry having all the
flags that the original entries had.
- <li>
+ <li> <!-- XXXURL change to URL -->
<p>For each URI in <var title="">file list</var>, run the following
steps. These steps may be run in parallel for two or more of the URIs at
a time.</p>
@@ -31674,27 +31715,37 @@
<li>
<p>Otherwise, the fetching succeeded. Store the resource in the <var
title="">new cache</var>.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If the URI being processed was flagged as an "explicit entry" in
<var title="">file list</var>, then categorize the entry as an <a
href="#explicit" title=concept-appcache-explicit>explicit entry</a>.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If the URI being processed was flagged as a "fallback entry" in <var
title="">file list</var>, then categorize the entry as a <a
href="#fallback0" title=concept-appcache-fallback>fallback entry</a>.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If the URI being processed was flagged as a "opportunistic entry" in
<var title="">file list</var>, then categorize the entry as an <a
href="#opportunistically"
title=concept-appcache-oppcache>opportunistically cached entry</a>.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If the URI being processed was flagged as an "implicit entry" in
<var title="">file list</var>, then categorize the entry as a <a
href="#implicit" title=concept-appcache-implicit>implicit entry</a>.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If the URI being processed was flagged as an "dynamic entry" in <var
@@ -31707,6 +31758,8 @@
if it's not there already, and categorize this entry (whether newly
added or not) as <a href="#the-manifest"
title=concept-appcache-manifest>the manifest</a>.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>Store the list of <a href="#opportunistic"
@@ -31714,6 +31767,8 @@
and the URIs of the <a href="#fallback0"
title=concept-appcache-fallback>fallback entries</a> that they map to,
in the new cache.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>Store the URIs that form the new <a href="#online"
@@ -31738,7 +31793,7 @@
<li>
<p>If this is a <a href="#cache" title=concept-appcache-cache>cache
attempt</a>, then:</p>
-
+ <!-- XXXURL change to URL -->
<p id=flagAsCandidateForCache-result>Associate any <code>Document</code>
objects that were <a href="#flagAsCandidateForCache">flagged as
candidates</a> for this manifest URI's caches with <var
@@ -31804,7 +31859,8 @@
<p>The processing model of application caches for offline support in Web
applications is part of the <a href="#navigate"
title=navigate>navigation</a> model, but references the algorithms defined
- in this section.
+ in this section.</p>
+ <!-- XXXURL change to URL -->
<p>A URI <dfn id=matches title=concept-appcache-matches-oppcache>matches an
opportunistic caching namespace</dfn> if there exists an <a
@@ -31820,7 +31876,7 @@
an opportunistic caching namespace can match more than one application
cache at a time, but only matches one namespace in each cache.
- <div class=example>
+ <div class=example> <!-- XXXURL change to URL -->
<p>If a manifest <code title="">http://example.com/app1/manifest</code>
declares that <code title="">http://example.com/resources/images</code>
should be opportunistically cached, and the user navigates to <code
@@ -31829,6 +31885,7 @@
title="">http://example.com/app1/manifest</code> contains a namespace
with a match for that URI.</p>
</div>
+ <!-- XXXURL change to URL -->
<p>When the <dfn id=application2
title=concept-appcache-init-with-attribute>application cache selection
@@ -31839,7 +31896,7 @@
<dt>If the resource is not being loaded as part of navigation of a <a
href="#top-level">top-level browsing context</a>
- <dd>
+ <dd> <!-- XXXURL change to URL -->
<p>As an optimization, if the resource was loaded from an <a
href="#application0">application cache</a>, and the manifest URI of that
cache doesn't match the manifest URI with which the algorithm was
@@ -31851,6 +31908,7 @@
caches.</p>
</dd>
<!-- otherwise, we're talking top-level browsing contexts only: -->
+ <!-- XXXURL change to URL -->
<dt>If the resource being loaded was loaded from an application cache and
the URI of that application cache's manifest is the same as the manifest
@@ -31860,6 +31918,8 @@
<p>Associate the <code>Document</code> with the cache from which it was
loaded. Invoke the <a href="#application1">application cache update
process</a>.</p>
+ </dd>
+ <!-- XXXURL change to URL -->
<dt>If the resource being loaded was loaded from an application cache and
the URI of that application cache's manifest is <em>not</em> the same as
@@ -31888,13 +31948,16 @@
but it was loaded using HTTP GET or equivalent
<dd>
- <ol>
+ <ol><!-- XXXURL change to URL -->
+
<li>
<p>If the manifest URI does not have the <a href="#same-origin">same
origin</a> as the resource's own URI, then invoke the <a
href="#application3"
title=concept-appcache-init-no-attribute>application cache selection
algorithm</a> again, but without a manifest, and abort these steps.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If there is already an <a href="#application0">application cache</a>
@@ -31907,6 +31970,8 @@
associate the <code>Document</code> with that cache, invoke the <a
href="#application1">application cache update process</a>, and abort
these steps.
+ </li>
+ <!-- XXXURL change to URL -->
<li id=flagAsCandidateForCache>
<p>Flag the resource's <code>Document</code> as a candidate for this
@@ -31914,6 +31979,8 @@
href="#flagAsCandidateForCache-result">associated with an application
cache identified by this manifest URI</a> later, when such an <a
href="#application0">application cache</a> is ready.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If there is already an <a href="#application0">application cache</a>
@@ -31928,6 +31995,8 @@
removing any other categories it might have), and abort these steps.
(An <a href="#application1">application cache update process</a> is
already in progress.)
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>Otherwise, there is no matching <a href="#application0">application
@@ -31969,12 +32038,16 @@
<li>
<p>If the resource is not to be fetched using the HTTP GET mechanism or
equivalent, then fetch the resource normally and abort these steps.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If the resource's URI, ignoring its fragment identifier if any, is
listed in the <a href="#application0">application cache</a>'s <a
href="#online" title=concept-appcache-onlinewhitelist>online
whitelist</a>, then fetch the resource normally and abort these steps.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If the resource's URI is <a href="#implicit"
@@ -31988,7 +32061,7 @@
entry</a> in the <a href="#application0">application cache</a>, then
fetch the resource from the cache and abort these steps.
- <li>
+ <li> <!-- XXXURL change to URL -->
<p>If the resource's URI has the <a href="#same-origin">same origin</a>
as the manifest's URI, and the start of the resource's URI's
<path> component is exactly matched by the <path> component
@@ -32145,7 +32218,8 @@
title=dom-appcache-add><a href="#adduri">add()</a></code> method, with the
oldest entry being the zeroth entry, and the most recently added entry
having the index <span><code title=dom-appcache-length><a
- href="#length8">length</a></code>-1</span>.
+ href="#length8">length</a></code>-1</span>.</p>
+ <!-- XXXURL change to URL -->
<p>The <dfn id=itemindex4 title=dom-appcache-item><code>item(<var
title="">index</var>)</code></dfn> method must return the absolute URI of
@@ -32167,15 +32241,21 @@
<p>If the <code><a href="#applicationcache">ApplicationCache</a></code>
object is not associated with any application cache, then raise an
<code>INVALID_STATE_ERR</code> exception and abort these steps.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If <var title="">uri</var> is not a valid URI reference, then raise a
<code>SYNTAX_ERR</code> exception and abort these steps. <a
href="#refsRFC3986">[RFC3986]</a> <a href="#refsRFC3987">[RFC3987]</a>
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p class=big-issue>resolve relative URIs; on failure, raise a
<code>SYNTAX_ERR</code> exception
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If there is already a resource in in the <a
@@ -32185,6 +32265,8 @@
that entry is categorized as a <a href="#dynamic3"
title=concept-appcache-dynamic>dynamic entry</a> and return and abort
these steps.
+ </li>
+ <!-- XXXURL change to URL -->
<li>
<p>If <var title="">uri</var> has a different <scheme> component than
@@ -32193,6 +32275,8 @@
<li>
<p>Return, but do not abort these steps.
+ </li>
+ <!-- XXXURL change to URL, maybe xref "fetch"? -->
<li>
<p>Fetch the resource referenced by <var title="">uri</var>.
@@ -32222,7 +32306,8 @@
target of Progress Events, much like the <a
href="http://dev.w3.org/cvsweb/~checkout~/2006/webapi/XMLHttpRequest-2/Overview.html?content-type=text/html;%20charset=utf-8#xmlhttprequesteventtarget-interface">XMLHttpRequestEventTarget</a>
interface. This would also make this far more complex to spec and
- implement.
+ implement.</p>
+ <!-- XXXURL algorithms -->
<p>The <dfn id=remove1 title=dom-appcache-remove><code>remove(<var
title="">uri</var>)</code></dfn> method must remove the <a
@@ -32411,7 +32496,8 @@
return the object implementing the <code><a
href="#history2">History</a></code> interface for that <code><a
href="#window">Window</a></code> object's <a href="#active">active
- document</a>.
+ document</a>.</p>
+ <!-- XXXURL change to URL -->
<p><code><a href="#history2">History</a></code> objects represent their <a
href="#browsing1">browsing context</a>'s session history as a flat list of
@@ -32422,7 +32508,8 @@
position, and other information associated with it.
<p class=note>This does not imply that the user interface need be linear.
- See the <a href="#history-notes">notes below</a>.
+ See the <a href="#history-notes">notes below</a>.</p>
+ <!-- XXXURL change to URL -->
<p>URIs without associated <a href="#state" title="state object">state
objects</a> are added to the session history as the user (or script)
@@ -32481,11 +32568,13 @@
algorithms given below, act as if they had not. When the user or script
navigates back or forwards to a page which has no in-memory DOM objects,
any other entries that shared the same <code>Document</code> object with
- it must share the new object as well.
+ it must share the new object as well.</p>
+ <!-- XXXURL change to URL -->
<p>When state object entries are added, a URI can be provided. This URI is
used to replace the state object entry if the <code>Document</code> is
- evicted.
+ evicted.</p>
+ <!-- XXXURL change to URL -->
<p>When a user agent discards the DOM from an entry in the session history,
it must also discard all the entries that share that <code>Document</code>
@@ -32583,15 +32672,16 @@
<p>The <dfn id=pushstate title=dom-history-pushState><code>pushState(<var
title="">data</var>, <var title="">title</var>, <var
title="">url</var>)</code></dfn> method adds a state object to the
- history.
+ history.</p>
+ <!-- XXXURL algorithms XXXDOCURL -->
<p>When this method is invoked, the user agent must first check the third
argument. If a third argument is specified, then the user agent must
verify that the third argument is a valid URI or IRI (as defined by RFC
3986 and 3987), and if so, that, after resolving it to an absolute URI, it
- is either identical to the document's URI, or that it differs from the
- document's URI only in the <query>, <abs_path>, and/or
- <fragment> parts, as applicable (the <query> and
+ is either identical to <span>the document's address</span>, or that it
+ differs from that address only in the <query>, <abs_path>,
+ and/or <fragment> parts, as applicable (the <query> and
<abs_path> parts can only be the same if the document's URI uses a
hierarchical <scheme>). If the verification fails (either because
the argument is syntactically incorrect, or differs in a way not described
@@ -32608,7 +32698,8 @@
href="#current1">current entry</a> is the last entry in the session
history, or if there are no entries after the <a href="#current1">current
entry</a> that reference the same <code>Document</code> object, then no
- entries are removed.
+ entries are removed.</p>
+ <!-- XXXURL change to URL -->
<p>Then, the user agent must add a state object entry to the session
history, after the <a href="#current1">current entry</a>, with the
@@ -32677,6 +32768,7 @@
bubbles but is not cancelable and has no default action.
</ol>
<!-- XXX onpopstate should be defined somewhere -->
+ <!-- XXXURL check with DOM3 Events -->
<pre
class=idl>interface <dfn id=popstateevent>PopStateEvent</dfn> : Event {
@@ -32718,10 +32810,10 @@
href="#active">active document</a>.
<p><code><a href="#location2">Location</a></code> objects provide a
- representation of the URI of their document, and allow the <a
- href="#current1">current entry</a> of the <a href="#browsing1">browsing
- context</a>'s session history to be changed, by adding or replacing
- entries in the <code title=dom-history><a
+ representation of <span title="the document's address">their document's
+ address</span>, and allow the <a href="#current1">current entry</a> of the
+ <a href="#browsing1">browsing context</a>'s session history to be changed,
+ by adding or replacing entries in the <code title=dom-history><a
href="#history1">history</a></code> object.
<pre class=idl>interface <dfn id=location2>Location</dfn> {
@@ -32730,7 +32822,8 @@
void <a href="#replace" title=dom-location-replace>replace</a>(in DOMString url);
void <span title=dom-location-reload>reload</span>();
- // <a href="#uri-decomposition">URI decomposition attributes</a> <!-- blame brendan for these "innovative" names -->
+ <!-- XXXURL change to URL
+ --> // <a href="#uri-decomposition">URI decomposition attributes</a> <!-- blame brendan for these "innovative" names -->
attribute DOMString <a href="#protocol" title=dom-location-protocol>protocol</a>;
attribute DOMString <a href="#host" title=dom-location-host>host</a>;
attribute DOMString <a href="#hostname" title=dom-location-hostname>hostname</a>;
@@ -32739,6 +32832,7 @@
attribute DOMString <a href="#search" title=dom-location-search>search</a>;
attribute DOMString <a href="#hash" title=dom-location-hash>hash</a>;
};</pre>
+ <!-- XXXURL change to URL -->
<p>The <dfn id=href5 title=dom-location-href><code>href</code></dfn>
attribute returns the address of the page represented by the associated
@@ -32785,7 +32879,8 @@
<p class=note>If the <a href="#script2">script execution context</a> of a
script isn't a <code><a href="#window">Window</a></code> object, then it
can't ever get to a <code><a href="#location2">Location</a></code> object
- to call these methods.
+ to call these methods.</p>
+ <!-- XXXURL algorithms -->
<p>Relative <var title="">url</var> arguments for <code
title=dom-location-assign><a href="#assign">assign()</a></code> and <code
@@ -32795,6 +32890,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 -->
<p>The <code><a href="#location2">Location</a></code> interface also has
the complement of <a href="#uri-decomposition">URI decomposition
Modified: source
===================================================================
--- source 2008-06-18 08:19:37 UTC (rev 1787)
+++ source 2008-06-18 21:20:11 UTC (rev 1788)
@@ -28692,7 +28692,6 @@
of unknown protocols.</p>
-<!-- XXXURL XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
<h3 id="offline">Offline Web applications</h3>
@@ -28706,16 +28705,19 @@
<h4 id="appcache">Application caches</h4>
+ <!-- XXXURL change to URL -->
<p>An <dfn>application cache</dfn> is a collection of resources. An
application cache is identified by the URI of a resource
manifest which is used to populate the cache.</p>
+ <!-- XXXURL change to URL -->
<p>Application caches are versioned, and there can be different
instances of caches for the same manifest URI, each having a
different version. A cache is newer than another if it was created
after the other (in other words, caches in a group have a
chronological order).</p>
+ <!-- XXXURL change to URL -->
<p>Each group of application caches for the same manifest URI have a
common <dfn title="concept-appcache-status">update status</dfn>,
which is one of the following: <i>idle</i>, <i>checking</i>,
@@ -28743,6 +28745,7 @@
<li>
+ <!-- XXXURL change to URL -->
<p>One of more resources (including their out-of-band metadata,
such as HTTP headers, if any), identified by URIs, each falling
into one (or more) of the following categories:</p>
@@ -28760,6 +28763,7 @@
<dt><dfn title="concept-appcache-manifest">The manifest</dfn>
+ <!-- XXXURL change to URL -->
<dd>The resource corresponding to the URI that was given in an
implicit entry's <code>html</code> element's <code
title="attr-html-manifest">manifest</code> attribute. The
@@ -28789,6 +28793,7 @@
<dt><dfn title="concept-appcache-oppcache">Opportunistically cached entries</dfn>
+ <!-- XXXURL change to URL -->
<dd>Resources whose URIs <span
title="concept-appcache-matches-oppcache">matched</span> an <span
title="concept-appcache-oppcache-ns">opportunistic caching
@@ -28803,6 +28808,7 @@
</dl>
+ <!-- XXXURL change to URL -->
<p class="note">A URI in the list can be flagged with multiple
different types, and thus an entry can end up being categorized as
multiple entries. For example, an entry can be an explicit entry
@@ -28810,6 +28816,7 @@
</li>
+ <!-- XXXURL change to URL -->
<li>Zero or more <dfn
title="concept-appcache-oppcache-ns">opportunistic caching
namespaces</dfn>: URIs, used as <span
@@ -28820,6 +28827,7 @@
origin</span> as <span title="concept-appcache-manifest">the
manifest</span>.</li>
+ <!-- XXXURL change to URL -->
<li>Zero or more URIs that form the <dfn
title="concept-appcache-onlinewhitelist">online whitelist</dfn>.
@@ -28889,6 +28897,7 @@
characters other than U+000A LINE FEED (LF) and U+000D CARRIAGE
RETURN (CR) characters.</p>
+ <!-- XXXURL change to URL -->
<p class="note">Comments must be on a line on their own. If they
were to be included on a line with a URI, the "#" would be
mistaken for part of a fragment identifier.</p>
@@ -28945,6 +28954,7 @@
href="#refsRFC3986">[RFC3986]</a> <a
href="#refsRFC3987">[RFC3987]</a></p>
+ <!-- XXXURL change to URL -->
<p class="note">The URI or IRI references in data lines can't be
empty strings, since those would be relative URIs to the manifest
itself. Such lines would be confused with blank or invalid lines,
@@ -28955,6 +28965,7 @@
<p>Manifests may contain sections more than once. Sections may be
empty.</p>
+ <!-- XXXURL change to URL -->
<p>URIs that are to be fallback pages associated with <span
title="concept-appcache-oppcache-ns">opportunistic caching
namespaces</span>, and those namespaces themselves, must be given in
@@ -28970,20 +28981,24 @@
<p>An opportunistic caching namespace must not be listed more than
once.</p>
+ <!-- XXXURL change to URL -->
<p>URIs that the user agent is to put into the <span
title="concept-appcache-onlinewhitelist">online whitelist</span>
must all be specified in online whitelist sections. (This is needed
for any URI that the page is intending to use to communicate back to
the server.)</p>
+ <!-- XXXURL change to URL -->
<p>URIs in the online whitelist section must not also be listed in
explicit section, and must not be listed as fallback entries in the
fallback section. (URIs in the online whitelist section may match
opportunistic caching namespaces, however.)</p>
+ <!-- XXXURL change to URL -->
<p>Relative URIs must be given relative to the manifest's own
URI.</p>
+ <!-- XXXURL change to URL; maybe have explicit support for this in the URL section? -->
<p>URIs in manifests must not have fragment identifiers.</p>
@@ -29002,15 +29017,18 @@
testable since neither U+0000 nor U+FFFD are valid anywhere in the
syntax and thus both will be treated the same anyway)--></p></li>
+ <!-- XXXURL change to URL -->
<li><p>Let <var title="">explicit URIs</var> be an initially empty
list of <span title="concept-appcache-explicit">explicit
entries</span>.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>Let <var title="">fallback URIs</var> be an initially empty
mapping of <span title="concept-appcache-oppcache-ns">opportunistic
caching namespaces</span> to <span
title="concept-appcache-fallback">fallback entries</span>.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>Let <var title="">online whitelist URIs</var> be an
initially empty list of URIs for a <span
title="concept-appcache-onlinewhitelist">online
@@ -29097,18 +29115,22 @@
<dd>
+ <!-- XXXURL change to URL -->
<p>If <var title="">line</var> is not a syntactically correct
URI reference or IRI reference, then jump back to the step
labeled "start of line".</p>
+ <!-- XXXURL change to URL -->
<p>Otherwise, resolve the URI reference or IRI reference to an
absolute URI or IRI, and drop the fragment identifier, if any.</p>
+ <!-- XXXURL change to URL -->
<p>Now, if the resource's URI has a different <scheme>
component than the manifest's URI (compared
case-insensitively<!-- XXX ASCII -->), then jump back to the
step labeled "start of line".</p>
+ <!-- XXXURL change to URL -->
<p>Otherwise, add this URI to the <var title="">explicit
URIs</var>.</p>
@@ -29132,15 +29154,18 @@
<p>Strip any leading U+0020 SPACE or U+0009 CHARACTER TABULATION
(tab) characters in <var title="">part two</var>.</p>
+ <!-- XXXURL change to URL -->
<p>If <var title="">part one</var> and <var title="">part
two</var> are not both syntactically correct URI or IRI
references, then jump back to the step labeled "start of
line".</p>
+ <!-- XXXURL use algorithms -->
<p>Resolve the URI or IRI references in <var title="">part
one</var> and <var title="">part two</var> to absolute URIs or
IRIs, and drop the fragment identifiers, if any.</p>
+ <!-- XXXURL change to URL -->
<p>If the absolute URI or IRI corresponding to <var
title="">part one</var> is already in the <var title="">fallback
URIs</var> mapping as an <span
@@ -29148,17 +29173,20 @@
namespace</span>, then jump back to the step labeled "start of
line".</p>
+ <!-- XXXURL change to URL -->
<p>If the absolute URI or IRI corresponding to <var
title="">part one</var> does not have the <span>same
origin</span> as the manifest's URI, then jump back to the step
labeled "start of line".</p> <!-- SECURITY -->
+ <!-- XXXURL change to URL -->
<p>If the absolute URI or IRI corresponding to <var
title="">part two</var> has a different <scheme> component
than the manifest's URI (compared case-insensitively<!-- XXX
ASCII -->), then jump back to the step labeled "start of
line".</p>
+ <!-- XXXURL change to URL -->
<p>Otherwise, add the absolute URI or IRI corresponding to <var
title="">part one</var> to the <var title="">fallback URIs</var>
mapping as an <span
@@ -29173,17 +29201,21 @@
<dd>
+ <!-- XXXURL change to URL -->
<p>If <var title="">line</var> is not a syntactically correct URI
reference or IRI reference, then jump back to the step labeled
"start of line".</p>
+ <!-- XXXURL change to URL -->
<p>Otherwise, resolve the URI reference or IRI reference to an
absolute URI or IRI, and drop the fragment identifier, if any.</p>
+ <!-- XXXURL change to URL -->
<p>Now, if the resource's URI has a different <scheme>
component than the manifest's URI, then jump back to the step
labeled "start of line".</p>
+ <!-- XXXURL change to URL -->
<p>Otherwise, add this URI to the <var title="">online whitelist
URIs</var>.</p>
@@ -29197,12 +29229,14 @@
jumps to the next, and last, step when the end of the file is
reached.)</p></li>
+ <!-- XXXURL change to URL -->
<li><p>Return the <var title="">explicit URIs</var> list, the <var
title="">fallback URIs</var> mapping, and the <var title="">online
whitelist URIs</var>.</p></li>
</ol>
+ <!-- XXXURL change to URL -->
<p>Relative URI references and IRI references resolved to absolute
URIs or IRIs in the above algorithm must be resolved according to
section 5.1 of RFC3986 (i.e. relative to the base URI from the
@@ -29234,14 +29268,17 @@
<ol>
+ <!-- XXXURL change to URL -->
<li><p>Let <var title="">manifest URI</var> be the URI of the <span
title="concept-appcache-manifest">manifest</span> of the cache to
be updated.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>Let <var title="">cache group</var> be the group of <span
title="application cache">application caches</span> identified by
<var title="">manifest URI</var>.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>Let <var title="">cache</var> be the most recently updated
<span>application cache</span> identified by <var title="">manifest
URI</var> (that is, the newest version found in <var title="">cache
@@ -29257,6 +29294,7 @@
<li>
+ <!-- XXXURL change to URL -->
<p>If there is already a resource with the URI of <var
title="">manifest URI</var> in <var title="">cache</var>, and
that resource is categorized as a <span
@@ -29290,6 +29328,7 @@
<li>
+ <!-- XXXURL change to URL -->
<p>Fetch the resource from <var title="">manifest URI</var>, and
let <var title="">manifest</var> be that resource.</p>
@@ -29368,6 +29407,7 @@
be the display of some sort of user interface indicating to the
user that a new version is being downloaded.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If this is an <span title="concept-appcache-upgrade">upgrade
attempt</span>, then let <var title="">new cache</var> be a newly
created <span>application cache</span> identified by <span
@@ -29376,19 +29416,23 @@
cache</var> and <var title="">cache</var> be the same version of
the application cache.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>Let <var title="">file list</var> be an empty list of
URIs with flags.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>Add all the URIs in the list of <span
title="concept-appcache-explicit">explicit entries</span> obtained
by parsing <var title="">manifest</var> to <var title="">file
list</var>, each flagged with "explicit entry".</p></li>
+ <!-- XXXURL change to URL -->
<li><p>Add all the URIs in the list of <span
title="concept-appcache-fallback">fallback entries</span> obtained
by parsing <var title="">manifest</var> to <var title="">file
list</var>, each flagged with "fallback entry".</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If this is an <span title="concept-appcache-upgrade">upgrade
attempt</span>, then add all the URIs of <span
title="concept-appcache-oppcache">opportunistically cached
@@ -29399,24 +29443,28 @@
to <var title="">file list</var>, each flagged with "opportunistic
entry".</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If this is an <span title="concept-appcache-upgrade">upgrade
attempt</span>, then add all the URIs of <span
title="concept-appcache-implicit">implicit entries</span> in <var
title="">cache</var> to <var title="">file list</var>, each flagged
with "implicit entry".</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If this is an <span title="concept-appcache-upgrade">upgrade
attempt</span>, then add all the URIs of <span
title="concept-appcache-dynamic">dynamic entries</span> in <var
title="">cache</var> to <var title="">file list</var>, each flagged
with "dynamic entry".</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If any URI is in <var title="">file list</var> more than
once, then merge the entries into one entry for that URI, that
entry having all the flags that the original entries had.</p></li>
<li>
+ <!-- XXXURL change to URL -->
<p>For each URI in <var title="">file list</var>, run the
following steps. These steps may be run in parallel for two or
more of the URIs at a time.</p>
@@ -29462,27 +29510,32 @@
<li><p>Otherwise, the fetching succeeded. Store the resource in
the <var title="">new cache</var>.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If the URI being processed was flagged as an "explicit
entry" in <var title="">file list</var>, then categorize the
entry as an <span title="concept-appcache-explicit">explicit
entry</span>.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If the URI being processed was flagged as a "fallback
entry" in <var title="">file list</var>, then categorize the
entry as a <span title="concept-appcache-fallback">fallback
entry</span>.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If the URI being processed was flagged as a "opportunistic
entry" in <var title="">file list</var>, then categorize the
entry as an <span
title="concept-appcache-oppcache">opportunistically cached
entry</span>.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If the URI being processed was flagged as an "implicit
entry" in <var title="">file list</var>, then categorize the
entry as a <span title="concept-appcache-implicit">implicit
entry</span>.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If the URI being processed was flagged as an "dynamic
entry" in <var title="">file list</var>, then categorize the
entry as a <span title="concept-appcache-dynamic">dynamic
@@ -29497,12 +29550,14 @@
(whether newly added or not) as <span
title="concept-appcache-manifest">the manifest</span>.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>Store the list of <span
title="concept-appcache-oppcache-ns">opportunistic caching
namespaces</span>, and the URIs of the <span
title="concept-appcache-fallback">fallback entries</span> that they
map to, in the new cache.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>Store the URIs that form the new <span
title="concept-appcache-onlinewhitelist">online whitelist</span> in
the new cache.</p></li>
@@ -29530,6 +29585,7 @@
<p>If this is a <span title="concept-appcache-cache">cache
attempt</span>, then:</p>
+ <!-- XXXURL change to URL -->
<p id="flagAsCandidateForCache-result">Associate any
<code>Document</code> objects that were <a
href="#flagAsCandidateForCache">flagged as candidates</a> for this
@@ -29605,6 +29661,7 @@
title="navigate">navigation</span> model, but references the
algorithms defined in this section.</p>
+ <!-- XXXURL change to URL -->
<p>A URI <dfn title="concept-appcache-matches-oppcache">matches an
opportunistic caching namespace</dfn> if there exists an
<span>application cache</span> whose <span
@@ -29622,6 +29679,7 @@
<div class="example">
+ <!-- XXXURL change to URL -->
<p>If a manifest <code
title="">http://example.com/app1/manifest</code> declares that
<code title="">http://example.com/resources/images</code> should be
@@ -29633,6 +29691,7 @@
</div>
+ <!-- XXXURL change to URL -->
<p>When the <dfn
title="concept-appcache-init-with-attribute">application cache
selection algorithm</dfn> algorithm is invoked with a manifest URI,
@@ -29646,6 +29705,7 @@
<dd>
+ <!-- XXXURL change to URL -->
<p>As an optimization, if the resource was loaded from an
<span>application cache</span>, and the manifest URI of that cache
doesn't match the manifest URI with which the algorithm was
@@ -29661,6 +29721,7 @@
<!-- otherwise, we're talking top-level browsing contexts only: -->
+ <!-- XXXURL change to URL -->
<dt>If the resource being loaded was loaded from an application
cache and the URI of that application cache's manifest is the
same as the manifest URI with which the algorithm was invoked</dt>
@@ -29671,6 +29732,7 @@
</dd>
+ <!-- XXXURL change to URL -->
<dt>If the resource being loaded was loaded from an application
cache and the URI of that application cache's manifest is
<em>not</em> the same as the manifest URI with which the algorithm
@@ -29707,12 +29769,14 @@
<ol>
+ <!-- XXXURL change to URL -->
<li><p>If the manifest URI does not have the <span>same
origin</span> as the resource's own URI, then invoke the <span
title="concept-appcache-init-no-attribute">application cache
selection algorithm</span> again, but without a manifest, and
abort these steps.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If there is already an <span>application cache</span>
identified by this manifest URI, and the most up to date version
of that <span>application cache</span> contains a resource with
@@ -29724,6 +29788,7 @@
<span>application cache update process</span>, and abort these
steps.</p></li>
+ <!-- XXXURL change to URL -->
<li id="flagAsCandidateForCache"><p>Flag the resource's
<code>Document</code> as a candidate for this manifest URI's
caches, so that it will be <a
@@ -29731,6 +29796,7 @@
application cache identified by this manifest URI</a> later, when
such an <span>application cache</span> is ready.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If there is already an <span>application cache</span>
identified by this manifest URI, then the most up to date version
of that <span>application cache</span> does not yet contain a
@@ -29744,6 +29810,7 @@
abort these steps. (An <span>application cache update
process</span> is already in progress.)</p></li>
+ <!-- XXXURL change to URL -->
<li><p>Otherwise, there is no matching <span>application
cache</span>: create a new application cache identified by this
manifest URI, store the resource in that cache, categorized as an
@@ -29790,11 +29857,13 @@
mechanism or equivalent, then fetch the resource normally and abort
these steps.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If the resource's URI, ignoring its fragment identifier if
any, is listed in the <span>application cache</span>'s <span
title="concept-appcache-onlinewhitelist">online whitelist</span>,
then fetch the resource normally and abort these steps.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If the resource's URI is <span
title="concept-appcache-implicit">an implicit entry</span>, <span
title="concept-appcache-manifest">the manifest</span>, <span
@@ -29807,6 +29876,7 @@
<li>
+ <!-- XXXURL change to URL -->
<p>If the resource's URI has the <span>same origin</span> as the
manifest's URI, and the start of the resource's URI's <path>
component is exactly matched by the <path> component of an
@@ -29954,6 +30024,7 @@
index <span><code
title="dom-appcache-length">length</code>-1</span>.</p>
+ <!-- XXXURL change to URL -->
<p>The <dfn title="dom-appcache-item"><code>item(<var
title="">index</var>)</code></dfn> method must return the absolute
URI of the <span title="concept-appcache-dynamic">dynamic
@@ -29977,14 +30048,17 @@
<code>INVALID_STATE_ERR</code> exception and abort these
steps.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If <var title="">uri</var> is not a valid URI reference,
then raise a <code>SYNTAX_ERR</code> exception and abort these
steps. <a href="#refsRFC3986">[RFC3986]</a> <a
href="#refsRFC3987">[RFC3987]</a></p></li>
+ <!-- XXXURL change to URL -->
<li><p class="big-issue">resolve relative URIs; on failure, raise a
<code>SYNTAX_ERR</code> exception</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If there is already a resource in in the <span>application
cache</span> with which the <code>ApplicationCache</code> object is
associated that has the address <var title="">uri</var>, then
@@ -29992,12 +30066,14 @@
title="concept-appcache-dynamic">dynamic entry</span> and return
and abort these steps.</p></li>
+ <!-- XXXURL change to URL -->
<li><p>If <var title="">uri</var> has a different <scheme>
component than the manifest's URI, then raise a <span>security
exception</span>.</p></li>
<li><p>Return, but do not abort these steps.</p></li>
+ <!-- XXXURL change to URL, maybe xref "fetch"? -->
<li><p>Fetch the resource referenced by <var
title="">uri</var>.</p></li>
@@ -30030,6 +30106,7 @@
interface. This would also make this far more complex to spec and
implement.</p>
+ <!-- XXXURL algorithms -->
<p>The <dfn title="dom-appcache-remove"><code>remove(<var
title="">uri</var>)</code></dfn> method must remove the <span
title="concept-appcache-dynamic">dynamic entry</span> categorization
@@ -30210,6 +30287,7 @@
implementing the <code>History</code> interface for that
<code>Window</code> object's <span>active document</span>.</p>
+ <!-- XXXURL change to URL -->
<p><code>History</code> objects represent their <span>browsing
context</span>'s session history as a flat list of <span
title="session history entry">session history entries</span>. Each
@@ -30221,6 +30299,7 @@
<p class="note">This does not imply that the user interface need be
linear. See the <a href="#history-notes">notes below</a>.</p>
+ <!-- XXXURL change to URL -->
<p>URIs without associated <span title="state object">state
objects</span> are added to the session history as the user (or
script) navigates from page to page.</p>
@@ -30279,10 +30358,12 @@
<code>Document</code> object with it must share the new object as
well.</p>
+ <!-- XXXURL change to URL -->
<p>When state object entries are added, a URI can be provided. This
URI is used to replace the state object entry if the
<code>Document</code> is evicted.</p>
+ <!-- XXXURL change to URL -->
<p>When a user agent discards the DOM from an entry in the session
history, it must also discard all the entries that share that
<code>Document</code> but do not have an associated URI
@@ -30372,19 +30453,21 @@
title="">url</var>)</code></dfn> method adds a state object to the
history.</p>
+ <!-- XXXURL algorithms XXXDOCURL -->
<p>When this method is invoked, the user agent must first check the
third argument. If a third argument is specified, then the user
agent must verify that the third argument is a valid URI or IRI (as
defined by RFC 3986 and 3987), and if so, that, after resolving it
- to an absolute URI, it is either identical to the document's URI, or
- that it differs from the document's URI only in the <query>,
- <abs_path>, and/or <fragment> parts, as applicable (the
- <query> and <abs_path> parts can only be the same if the
- document's URI uses a hierarchical <scheme>). If the
- verification fails (either because the argument is syntactically
- incorrect, or differs in a way not described as acceptable in the
- previous sentence) then the user agent must raise a <span>security
- exception</span>. <a href="#refsRFC3986">[RFC3986]</a> <a
+ to an absolute URI, it is either identical to <span>the document's
+ address</span>, or that it differs from that address only in the
+ <query>, <abs_path>, and/or <fragment> parts, as
+ applicable (the <query> and <abs_path> parts can only be
+ the same if the document's URI uses a hierarchical
+ <scheme>). If the verification fails (either because the
+ argument is syntactically incorrect, or differs in a way not
+ described as acceptable in the previous sentence) then the user
+ agent must raise a <span>security exception</span>. <a
+ href="#refsRFC3986">[RFC3986]</a> <a
href="#refsRFC3987">[RFC3987]</a></p>
<p>If the third argument passes its verification step, or if the
@@ -30398,6 +30481,7 @@
reference the same <code>Document</code> object, then no entries are
removed.</p>
+ <!-- XXXURL change to URL -->
<p>Then, the user agent must add a state object entry to the session
history, after the <span>current entry</span>, with the specified
<var title="">data</var> as the state object, the given <var
@@ -30467,6 +30551,7 @@
<!-- XXX onpopstate should be defined somewhere -->
+ <!-- XXXURL check with DOM3 Events -->
<pre class="idl">interface <dfn>PopStateEvent</dfn> : Event {
readonly attribute DOMObject <span title="dom-PopStateEvent-state">state</span>;
void <span title="dom-PopStateEvent-initPopStateEvent">initPopStateEvent</span>(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMObject stateArg);
@@ -30505,11 +30590,12 @@
<code>Location</code> object for that <code>Window</code> object's
<span>active document</span>.</p>
- <p><code>Location</code> objects provide a representation of the URI
- of their document, and allow the <span>current entry</span> of the
- <span>browsing context</span>'s session history to be changed, by
- adding or replacing entries in the <code
- title="dom-history">history</code> object.</p>
+ <p><code>Location</code> objects provide a representation of <span
+ title="the document's address">their document's address</span>, and
+ allow the <span>current entry</span> of the <span>browsing
+ context</span>'s session history to be changed, by adding or
+ replacing entries in the <code title="dom-history">history</code>
+ object.</p>
<pre class="idl">interface <dfn>Location</dfn> {
readonly attribute DOMString <span title="dom-location-href">href</span>;
@@ -30517,7 +30603,8 @@
void <span title="dom-location-replace">replace</span>(in DOMString url);
void <span title="dom-location-reload">reload</span>();
- // <span>URI decomposition attributes</span> <!-- blame brendan for these "innovative" names -->
+ <!-- XXXURL change to URL
+ --> // <span>URI decomposition attributes</span> <!-- blame brendan for these "innovative" names -->
attribute DOMString <span title="dom-location-protocol">protocol</span>;
attribute DOMString <span title="dom-location-host">host</span>;
attribute DOMString <span title="dom-location-hostname">hostname</span>;
@@ -30527,6 +30614,7 @@
attribute DOMString <span title="dom-location-hash">hash</span>;
};</pre>
+ <!-- XXXURL change to URL -->
<p>The <dfn title="dom-location-href"><code>href</code></dfn>
attribute returns the address of the page represented by the
associated <code>Document</code> object, as an absolute URI or IRI
@@ -30571,6 +30659,7 @@
script isn't a <code>Window</code> object, then it can't ever get to
a <code>Location</code> object to call these methods.</p>
+ <!-- XXXURL algorithms -->
<p>Relative <var title="">url</var> arguments for <code
title="dom-location-assign">assign()</code> and <code
title="dom-location-replace">replace()</code> must be resolved
@@ -30579,6 +30668,8 @@
the base URI is data: or javascript: or about: or something else
without a way to resolve base URIs? -->
+<!-- XXXURLXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
+
<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
More information about the Commit-Watchers
mailing list