hixie: Add an abort() method to appcache to allow scripts to provide an abort UI when caching a site. (whatwg r6349)

hixie: Add an abort() method to appcache to allow scripts to provide an
abort UI when caching a site. (whatwg r6349)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5071&r2=1.5072&f=h
http://html5.org/tools/web-apps-tracker?from=6348&to=6349

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5071
retrieving revision 1.5072
diff -u -d -r1.5071 -r1.5072
--- Overview.html 2 Aug 2011 22:02:27 -0000 1.5071
+++ Overview.html 2 Aug 2011 22:19:27 -0000 1.5072
@@ -47725,7 +47725,11 @@
 
     <p>For each URL in <var title="">file list</var>, run the
     following steps. These steps may be run in parallel for two or
-    more of the URLs at a time.</p>
+    more of the URLs at a time. If, while running these steps, the
+    <code><a href="#applicationcache">ApplicationCache</a></code> object's <code title="dom-appcache-abort"><a href="#dom-appcache-abort">abort()</a></code> method <a href="#send-a-signal" title="send
+    a signal">sends a signal</a> to this instance of the
+    <a href="#application-cache-download-process">application cache download process</a> algorithm, then
+    run the <a href="#cache-failure-steps">cache failure steps</a> instead.</p>
 
     <ol><li>
 
@@ -47802,7 +47806,10 @@
 
        <dd>
 
-        <p>Run the <a href="#cache-failure-steps">cache failure steps</a>.</p>
+        <p>If these steps are being run in parallel for any other URLs
+        in <var title="">file list</var>, then abort these steps for
+        those other URLs. Run the <a href="#cache-failure-steps">cache failure
+        steps</a>.</p>
 
         <p class="note">Redirects are fatal because they are either
         indicative of a network problem (e.g. a captive portal); or
@@ -48333,6 +48340,7 @@
 
   // updates
   void <a href="#dom-appcache-update" title="dom-appcache-update">update</a>();
+  void <a href="#dom-appcache-abort" title="dom-appcache-abort">abort</a>();
   void <a href="#dom-appcache-swapcache" title="dom-appcache-swapCache">swapCache</a>();
 
   // events
@@ -48483,6 +48491,15 @@
   <a href="#application-cache">application cache</a>, or if it is marked as <a href="#concept-appcache-obsolete" title="concept-appcache-obsolete">obsolete</a>, then the method
   must raise an <code><a href="#invalid_state_err">INVALID_STATE_ERR</a></code> exception instead.</p>
 
+  <p>If the <dfn id="dom-appcache-abort" title="dom-appcache-abort"><code>abort()</code></dfn>
+  method is invoked, the user agent must <dfn id="send-a-signal">send a signal</dfn> to
+  the current <a href="#application-cache-download-process">application cache download process</a> for the
+  <a href="#application-cache">application cache</a> with which the
+  <code><a href="#applicationcache">ApplicationCache</a></code> object's <a href="#cache-host">cache host</a> is
+  associated, if any. If there is no such <a href="#application-cache">application
+  cache</a>, or if does not have a current <a href="#application-cache-download-process">application cache
+  download process</a>, then do nothing.</p>
+
   <p>If the <dfn id="dom-appcache-swapcache" title="dom-appcache-swapCache"><code>swapCache()</code></dfn> method
   is invoked, the user agent must run the following steps:

Received on Tuesday, 2 August 2011 22:19:41 UTC