[html5] r2691 - [] (0) Remove dynamic entries from the application cache for now.
whatwg at whatwg.org
whatwg at whatwg.org
Wed Jan 21 17:24:21 PST 2009
Author: ianh
Date: 2009-01-21 17:24:20 -0800 (Wed, 21 Jan 2009)
New Revision: 2691
Modified:
index
source
Log:
[] (0) Remove dynamic entries from the application cache for now.
Modified: index
===================================================================
--- index 2009-01-22 01:02:52 UTC (rev 2690)
+++ index 2009-01-22 01:24:20 UTC (rev 2691)
@@ -36565,7 +36565,7 @@
<dt><dfn id=concept-appcache-manifest title=concept-appcache-manifest>The manifest</dfn>
- <dd>The resource corresponding to the URL that was given in an
+ <dd>The resource corresponding to the URL that was given in a
master entry's <code><a href=#the-html-element>html</a></code> element's <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code> attribute. The
manifest is fetched and processed during the <a href=#application-cache-update-process>application
cache update process</a>. All the <a href=#concept-appcache-master title=concept-appcache-master>master entries</a> have
@@ -36586,14 +36586,11 @@
entries.
- <dt><dfn id=concept-appcache-dynamic title=concept-appcache-dynamic>Dynamic entries</dfn>
-
- <dd>Resources that were added to the cache by the <code title=dom-appcache-add><a href=#dom-appcache-add>add()</a></code> method.
-
</dl><p class=note>A URL 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>
+ multiple entries. For example, an entry can be a manfiest entry
+ and an explicit entry at the same time, if the manifest is listed
+ within the manifest.</p>
</li>
@@ -36639,7 +36636,7 @@
# there can be as many of these anywhere in the file
# they are all ignored
# comments can have spaces before them
- # but most be alone on the line
+ # but must be alone on the line
# blank lines are ignored too
@@ -37215,10 +37212,6 @@
attempt</a>, then add all the URLs of <a href=#concept-appcache-master title=concept-appcache-master>master entries</a> in <var title="">cache</var> to <var title="">file list</var>, each flagged
with "master entry".</li>
- <li><p>If this is an <a href=#concept-appcache-upgrade title=concept-appcache-upgrade>upgrade
- attempt</a>, then add all the URLs of <a href=#concept-appcache-dynamic title=concept-appcache-dynamic>dynamic entries</a> in <var title="">cache</var> to <var title="">file list</var>, each flagged
- with "dynamic entry".</li>
-
<li><p>If any URL is in <var title="">file list</var> more than
once, then merge the entries into one entry for that URL, that
entry having all the flags that the original entries had.</li>
@@ -37347,11 +37340,6 @@
entry as a <a href=#concept-appcache-master title=concept-appcache-master>master
entry</a>.</li>
- <li><p>If the URL being processed was flagged as an "dynamic
- entry" in <var title="">file list</var>, then categorize the
- entry as a <a href=#concept-appcache-dynamic title=concept-appcache-dynamic>dynamic
- entry</a>.</li>
-
<li><p>As an optimization, if the resource is an HTML or XML file
whose root element is an <code><a href=#the-html-element>html</a></code> element with a <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code> attribute whose value
doesn't match the manifest URL of the application cache being
@@ -37446,18 +37434,6 @@
<ol><li>
- <p>If any <a href=#concept-appcache-dynamic title=concept-appcache-dynamic>dynamic
- entries</a> in any of the <a href=#application-cache title="application
- cache">application caches</a> in the <var title="">cache
- group</var> were added or removed (using the <code title=dom-appcache-add><a href=#dom-appcache-add>add()</a></code> and <code title=dom-appcache-remove><a href=#dom-appcache-remove>remove()</a></code> methods) while the
- update process was in progress, then replay the sequence of adds
- and removes on <var title="">cache</var>, using the resources
- that were fetched by the <code title=dom-appcache-add><a href=#dom-appcache-add>add()</a></code> method if applicable.</p>
-
- </li>
-
- <li>
-
<p>For each <a href=#browsing-context>browsing context</a> whose <a href=#active-document>active
document</a> is associated with a cache in <var title="">cache group</var>, <a href=#queue-a-task>queue a task</a> to
<a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-updateready>updateready</code> at the relevant
@@ -37675,9 +37651,9 @@
<a href=#fetch>fetch</a> the resource normally and abort these
steps.</li>
- <li><p>If the resource's URL is <a href=#concept-appcache-master title=concept-appcache-master>an master entry</a>, <a href=#concept-appcache-manifest title=concept-appcache-manifest>the manifest</a>, <a href=#concept-appcache-explicit title=concept-appcache-explicit>an explicit entry</a>, <a href=#concept-appcache-fallback title=concept-appcache-fallback>a fallback entry</a>, or a
- <a href=#concept-appcache-dynamic title=concept-appcache-dynamic>dynamic entry</a> in the
- <a href=#application-cache>application cache</a>, then get the resource from the
+ <li><p>If the resource's URL is <a href=#concept-appcache-master title=concept-appcache-master>a master entry</a>, <a href=#concept-appcache-manifest title=concept-appcache-manifest>the manifest</a>, <a href=#concept-appcache-explicit title=concept-appcache-explicit>an explicit entry</a>, or
+ <a href=#concept-appcache-fallback title=concept-appcache-fallback>a fallback entry</a> in
+ the <a href=#application-cache>application cache</a>, then get the resource from the
cache (instead of fetching it), and abort these steps.</li>
<li>
@@ -37730,12 +37706,6 @@
void <a href=#dom-appcache-update title=dom-appcache-update>update</a>();
void <a href=#dom-appcache-swapcache title=dom-appcache-swapCache>swapCache</a>();
- // dynamic entries
- readonly attribute <span>DOMStringList</span> <a href=#dom-appcache-items title=dom-appcache-items>items</a>;
- boolean <a href=#dom-appcache-hasitem title=dom-appcache-hasItem>hasItem</a>(in DOMString url);
- void <a href=#dom-appcache-add title=dom-appcache-add>add</a>(in DOMString url);
- void <a href=#dom-appcache-remove title=dom-appcache-remove>remove</a>(in DOMString url);
-
// events
attribute <a href=#function>Function</a> <a href=#handler-appcache-onchecking title=handler-appcache-onchecking>onchecking</a>;
attribute <a href=#function>Function</a> <a href=#handler-appcache-onerror title=handler-appcache-onerror>onerror</a>;
@@ -37821,87 +37791,7 @@
<i>obsolete</i> <a href=#concept-appcache-lifecycle title=concept-appcache-lifecycle>lifecycle
status</a>.</dd>
- </dl><hr><p>The <a href=#concept-appcache-dynamic title=concept-appcache-dynamic>dynamic entries</a>
- in the <a href=#application-cache>application cache</a> are ordered in the same order
- as they were added to the cache by the <code title=dom-appcache-add><a href=#dom-appcache-add>add()</a></code> method, with the oldest entry
- being the zeroth entry.</p>
-
- <p>The <dfn id=dom-appcache-items title=dom-appcache-items><code>items</code></dfn> DOM
- attribute must return a new <code>DOMStringList</code> object. If
- the <code><a href=#applicationcache>ApplicationCache</a></code> object has an associated
- <a href=#application-cache>application cache</a> with one or more <a href=#concept-appcache-dynamic title=concept-appcache-dynamic>dynamic entries</a>, then the
- <code>DOMStringList</code> object's items must be the <a href=#absolute-url title="absolute URL">absolute URLs</a> of the <a href=#concept-appcache-dynamic title=concept-appcache-dynamic>dynamic entries</a> in that
- <a href=#application-cache>application cache</a>, in order; otherwise, the object must
- have no entries.</p>
-
- <p>The <dfn id=dom-appcache-hasitem title=dom-appcache-hasItem><code>hasItem(<var title="">url</var>)</code></dfn> method must run the following
- steps:</p>
-
- <ol><li><p>If the <code><a href=#applicationcache>ApplicationCache</a></code> object is not
- associated with any application cache, then raise an
- <code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code> exception and abort these
- steps.</li>
-
- <li><p><a href=#resolve-a-url title="resolve a URL">Resolve</a> the <var title="">url</var> argument. If this fails, raise a
- <code><a href=#syntax_err>SYNTAX_ERR</a></code> exception and abort these steps.</li>
-
- <li><p>If there is already a resource in in the <a href=#application-cache>application
- cache</a> with which the <code><a href=#applicationcache>ApplicationCache</a></code> object is
- associated that has the address <var title="">url</var>, and that
- entry is categorized as a <a href=#concept-appcache-dynamic title=concept-appcache-dynamic>dynamic entry</a>, then return
- true.</li>
-
- <li><p>Otherwise, return false.</li>
-
- </ol><p>The <dfn id=dom-appcache-add title=dom-appcache-add><code>add(<var title="">url</var>)</code></dfn> method must run the following
- steps:</p>
-
- <ol><li><p>If the <code><a href=#applicationcache>ApplicationCache</a></code> object is not
- associated with any application cache, then raise an
- <code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code> exception and abort these
- steps.</li>
-
- <li><p><a href=#resolve-a-url title="resolve a URL">Resolve</a> the <var title="">url</var> argument. If this fails, raise a
- <code><a href=#syntax_err>SYNTAX_ERR</a></code> exception and abort these steps.</li>
-
- <li><p>If there is already a resource in in the <a href=#application-cache>application
- cache</a> with which the <code><a href=#applicationcache>ApplicationCache</a></code> object is
- associated that has the address <var title="">url</var>, then
- ensure that entry is categorized as a <a href=#concept-appcache-dynamic title=concept-appcache-dynamic>dynamic entry</a> and return
- and abort these steps.</li>
-
- <li><p>If <var title="">url</var> has a different <a href=#url-scheme title=url-scheme><scheme></a> component than the
- manifest's URL, then raise a <code><a href=#security_err>SECURITY_ERR</a></code>
- exception.</li>
-
- <li><p>Return, but do not abort these steps.</li>
-
- <li><p><a href=#fetch>Fetch</a> the resource referenced by <var title="">url</var>.</li>
-
- <li><p>If this results in a redirect, or a 4xx or 5xx status code
- <a href=#concept-http-equivalent-codes title=concept-http-equivalent-codes>or equivalent</a>,
- or if there were network errors, or if the user canceled the
- download, then abort these steps.</li>
-
- <li><p>Add the fetched resource to the <a href=#application-cache>application
- cache</a> and categorize it as a <a href=#concept-appcache-dynamic title=concept-appcache-dynamic>dynamic entry</a>.</li>
-
- </ol><p>The <dfn id=dom-appcache-remove title=dom-appcache-remove><code>remove(<var title="">url</var>)</code></dfn> method must <a href=#resolve-a-url title="resolve a
- url">resolve</a> the <var title="">url</var> argument and, if
- that is successful, remove the <a href=#concept-appcache-dynamic title=concept-appcache-dynamic>dynamic entry</a> categorization
- of any entry whose address is the resulting <a href=#absolute-url>absolute
- URL</a> in the <a href=#application-cache>application cache</a> with which the
- <code><a href=#applicationcache>ApplicationCache</a></code> object is associated. If this removes
- the last categorization of an entry in that cache, then the entry
- must be removed entirely (such that if it is re-added, it will be
- loaded from the network again). If the <code><a href=#applicationcache>ApplicationCache</a></code>
- object is not associated with any application cache, then the method
- must raise an <code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code> exception instead.</p>
-
- <p class=warning>Authors should bear in mind that multiple scripts
- could be simultaneously modifying the same application cache.</p>
-
- <hr><p>If the <dfn id=dom-appcache-update title=dom-appcache-update><code>update()</code></dfn> method is
+ </dl><hr><p>If the <dfn id=dom-appcache-update title=dom-appcache-update><code>update()</code></dfn> method is
invoked, the user agent must invoke the <a href=#application-cache-update-process>application cache
update process</a>, in the background, for the <a href=#application-cache>application
cache</a> with which the <code><a href=#applicationcache>ApplicationCache</a></code> object is
Modified: source
===================================================================
--- source 2009-01-22 01:02:52 UTC (rev 2690)
+++ source 2009-01-22 01:24:20 UTC (rev 2691)
@@ -41580,7 +41580,7 @@
<dt><dfn title="concept-appcache-manifest">The manifest</dfn>
- <dd>The resource corresponding to the URL that was given in an
+ <dd>The resource corresponding to the URL that was given in a
master entry's <code>html</code> element's <code
title="attr-html-manifest">manifest</code> attribute. The
manifest is fetched and processed during the <span>application
@@ -41607,17 +41607,13 @@
entries.
- <dt><dfn title="concept-appcache-dynamic">Dynamic entries</dfn>
-
- <dd>Resources that were added to the cache by the <code
- title="dom-appcache-add">add()</code> method.
-
</dl>
<p class="note">A URL 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>
+ multiple entries. For example, an entry can be a manfiest entry
+ and an explicit entry at the same time, if the manifest is listed
+ within the manifest.</p>
</li>
@@ -41674,7 +41670,7 @@
# there can be as many of these anywhere in the file
# they are all ignored
# comments can have spaces before them
- # but most be alone on the line
+ # but must be alone on the line
# blank lines are ignored too
@@ -42352,12 +42348,6 @@
title="">cache</var> to <var title="">file list</var>, each flagged
with "master entry".</p></li>
- <li><p>If this is an <span title="concept-appcache-upgrade">upgrade
- attempt</span>, then add all the URLs 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>
-
<li><p>If any URL is in <var title="">file list</var> more than
once, then merge the entries into one entry for that URL, that
entry having all the flags that the original entries had.</p></li>
@@ -42496,11 +42486,6 @@
entry as a <span title="concept-appcache-master">master
entry</span>.</p></li>
- <li><p>If the URL 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
- entry</span>.</p></li>
-
<li><p>As an optimization, if the resource is an HTML or XML file
whose root element is an <code>html</code> element with a <code
title="attr-html-manifest">manifest</code> attribute whose value
@@ -42609,21 +42594,6 @@
<li>
- <p>If any <span title="concept-appcache-dynamic">dynamic
- entries</span> in any of the <span title="application
- cache">application caches</span> in the <var title="">cache
- group</var> were added or removed (using the <code
- title="dom-appcache-add">add()</code> and <code
- title="dom-appcache-remove">remove()</code> methods) while the
- update process was in progress, then replay the sequence of adds
- and removes on <var title="">cache</var>, using the resources
- that were fetched by the <code
- title="dom-appcache-add">add()</code> method if applicable.</p>
-
- </li>
-
- <li>
-
<p>For each <span>browsing context</span> whose <span>active
document</span> is associated with a cache in <var
title="">cache group</var>, <span>queue a task</span> to
@@ -42888,12 +42858,11 @@
steps.</p></li>
<li><p>If the resource's URL is <span
- title="concept-appcache-master">an master entry</span>, <span
+ title="concept-appcache-master">a master entry</span>, <span
title="concept-appcache-manifest">the manifest</span>, <span
- title="concept-appcache-explicit">an explicit entry</span>, <span
- title="concept-appcache-fallback">a fallback entry</span>, or a
- <span title="concept-appcache-dynamic">dynamic entry</span> in the
- <span>application cache</span>, then get the resource from the
+ title="concept-appcache-explicit">an explicit entry</span>, or
+ <span title="concept-appcache-fallback">a fallback entry</span> in
+ the <span>application cache</span>, then get the resource from the
cache (instead of fetching it), and abort these steps.</p></li>
<li>
@@ -42949,12 +42918,6 @@
void <span title="dom-appcache-update">update</span>();
void <span title="dom-appcache-swapCache">swapCache</span>();
- // dynamic entries
- readonly attribute <span>DOMStringList</span> <span title="dom-appcache-items">items</span>;
- boolean <span title="dom-appcache-hasItem">hasItem</span>(in DOMString url);
- void <span title="dom-appcache-add">add</span>(in DOMString url);
- void <span title="dom-appcache-remove">remove</span>(in DOMString url);
-
// events
attribute <span>Function</span> <span title="handler-appcache-onchecking">onchecking</span>;
attribute <span>Function</span> <span title="handler-appcache-onerror">onerror</span>;
@@ -43047,111 +43010,6 @@
<hr>
- <p>The <span title="concept-appcache-dynamic">dynamic entries</span>
- in the <span>application cache</span> are ordered in the same order
- as they were added to the cache by the <code
- title="dom-appcache-add">add()</code> method, with the oldest entry
- being the zeroth entry.</p>
-
- <p>The <dfn title="dom-appcache-items"><code>items</code></dfn> DOM
- attribute must return a new <code>DOMStringList</code> object. If
- the <code>ApplicationCache</code> object has an associated
- <span>application cache</span> with one or more <span
- title="concept-appcache-dynamic">dynamic entries</span>, then the
- <code>DOMStringList</code> object's items must be the <span
- title="absolute URL">absolute URLs</span> of the <span
- title="concept-appcache-dynamic">dynamic entries</span> in that
- <span>application cache</span>, in order; otherwise, the object must
- have no entries.</p>
-
- <p>The <dfn title="dom-appcache-hasItem"><code>hasItem(<var
- title="">url</var>)</code></dfn> method must run the following
- steps:</p>
-
- <ol>
-
- <li><p>If the <code>ApplicationCache</code> object is not
- associated with any application cache, then raise an
- <code>INVALID_STATE_ERR</code> exception and abort these
- steps.</p></li>
-
- <li><p><span title="resolve a URL">Resolve</span> the <var
- title="">url</var> argument. If this fails, raise a
- <code>SYNTAX_ERR</code> exception and abort these steps.</p></li>
-
- <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="">url</var>, and that
- entry is categorized as a <span
- title="concept-appcache-dynamic">dynamic entry</span>, then return
- true.</p></li>
-
- <li><p>Otherwise, return false.</p></li>
-
- </ol>
-
- <p>The <dfn title="dom-appcache-add"><code>add(<var
- title="">url</var>)</code></dfn> method must run the following
- steps:</p>
-
- <ol>
-
- <li><p>If the <code>ApplicationCache</code> object is not
- associated with any application cache, then raise an
- <code>INVALID_STATE_ERR</code> exception and abort these
- steps.</p></li>
-
- <li><p><span title="resolve a URL">Resolve</span> the <var
- title="">url</var> argument. If this fails, raise a
- <code>SYNTAX_ERR</code> exception and abort these steps.</p></li>
-
- <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="">url</var>, then
- ensure that entry is categorized as a <span
- title="concept-appcache-dynamic">dynamic entry</span> and return
- and abort these steps.</p></li>
-
- <li><p>If <var title="">url</var> has a different <span
- title="url-scheme"><scheme></span> component than the
- manifest's URL, then raise a <code>SECURITY_ERR</code>
- exception.</p></li>
-
- <li><p>Return, but do not abort these steps.</p></li>
-
- <li><p><span>Fetch</span> the resource referenced by <var
- title="">url</var>.</p></li>
-
- <li><p>If this results in a redirect, or a 4xx or 5xx status code
- <span title="concept-http-equivalent-codes">or equivalent</span>,
- or if there were network errors, or if the user canceled the
- download, then abort these steps.</p></li>
-
- <li><p>Add the fetched resource to the <span>application
- cache</span> and categorize it as a <span
- title="concept-appcache-dynamic">dynamic entry</span>.</p></li>
-
- </ol>
-
- <p>The <dfn title="dom-appcache-remove"><code>remove(<var
- title="">url</var>)</code></dfn> method must <span title="resolve a
- url">resolve</span> the <var title="">url</var> argument and, if
- that is successful, remove the <span
- title="concept-appcache-dynamic">dynamic entry</span> categorization
- of any entry whose address is the resulting <span>absolute
- URL</span> in the <span>application cache</span> with which the
- <code>ApplicationCache</code> object is associated. If this removes
- the last categorization of an entry in that cache, then the entry
- must be removed entirely (such that if it is re-added, it will be
- loaded from the network again). If the <code>ApplicationCache</code>
- object is not associated with any application cache, then the method
- must raise an <code>INVALID_STATE_ERR</code> exception instead.</p>
-
- <p class="warning">Authors should bear in mind that multiple scripts
- could be simultaneously modifying the same application cache.</p>
-
- <hr>
-
<p>If the <dfn
title="dom-appcache-update"><code>update()</code></dfn> method is
invoked, the user agent must invoke the <span>application cache
More information about the Commit-Watchers
mailing list