[html5] r7456 - [e] (0) Clarify the events some more. Fixing https://www.w3.org/Bugs/Public/show [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2012-10-11 16:20:32 -0700 (Thu, 11 Oct 2012)
New Revision: 7456

Modified:
   complete.html
   index
   source
Log:
[e] (0) Clarify the events some more.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=16484
Affected topics: Offline Web Applications

Modified: complete.html
===================================================================
--- complete.html	2012-10-11 23:03:52 UTC (rev 7455)
+++ complete.html	2012-10-11 23:20:32 UTC (rev 7456)
@@ -72316,6 +72316,8 @@
     <tr><td> <dfn id=event-appcache-progress title=event-appcache-progress><code>progress</code></dfn>
      <td> <code>ProgressEvent</code>
      <td> The user agent is downloading resources listed by the manifest.
+          The event object's <code title=dom-ProgressEvents-total>total</code> attribute returns the total number of files to be downloaded.
+          The event object's <code title=dom-ProgressEvents-loaded>loaded</code> attribute returns the number of files processed so far.
      <td> <code title=event-appcache-progress><a href=#event-appcache-progress>progress</a></code>, <code title=event-appcache-error><a href=#event-appcache-error>error</a></code>, <code title=event-appcache-cached><a href=#event-appcache-cached>cached</a></code>, <code title=event-appcache-updateready><a href=#event-appcache-updateready>updateready</a></code>
     <tr><td> <dfn id=event-appcache-cached title=event-appcache-cached><code>cached</code></dfn>
      <td> <code><a href=#event>Event</a></code>
@@ -72337,8 +72339,14 @@
     <tr><td> A fatal error occurred while fetching the resources listed in the manifest.
     <tr><td> The manifest changed while the update was being run.
      <td> The user agent will try fetching the files again momentarily.
-  </table><div class=impl>
+  </table><p>These events are cancelable; their default action is for the user agent to show download
+  progress information. If the page shows its own update UI, canceling the events will prevent the
+  user agent from showing redundant progress information.</p>
 
+
+
+  <div class=impl>
+
   <h4 id=appcache><span class=secno>6.7.2 </span>Application caches</h4> <!--APPCACHE-->
 
   <p>An <dfn id=application-cache>application cache</dfn> is a set of cached resources

Modified: index
===================================================================
--- index	2012-10-11 23:03:52 UTC (rev 7455)
+++ index	2012-10-11 23:20:32 UTC (rev 7456)
@@ -72316,6 +72316,8 @@
     <tr><td> <dfn id=event-appcache-progress title=event-appcache-progress><code>progress</code></dfn>
      <td> <code>ProgressEvent</code>
      <td> The user agent is downloading resources listed by the manifest.
+          The event object's <code title=dom-ProgressEvents-total>total</code> attribute returns the total number of files to be downloaded.
+          The event object's <code title=dom-ProgressEvents-loaded>loaded</code> attribute returns the number of files processed so far.
      <td> <code title=event-appcache-progress><a href=#event-appcache-progress>progress</a></code>, <code title=event-appcache-error><a href=#event-appcache-error>error</a></code>, <code title=event-appcache-cached><a href=#event-appcache-cached>cached</a></code>, <code title=event-appcache-updateready><a href=#event-appcache-updateready>updateready</a></code>
     <tr><td> <dfn id=event-appcache-cached title=event-appcache-cached><code>cached</code></dfn>
      <td> <code><a href=#event>Event</a></code>
@@ -72337,8 +72339,14 @@
     <tr><td> A fatal error occurred while fetching the resources listed in the manifest.
     <tr><td> The manifest changed while the update was being run.
      <td> The user agent will try fetching the files again momentarily.
-  </table><div class=impl>
+  </table><p>These events are cancelable; their default action is for the user agent to show download
+  progress information. If the page shows its own update UI, canceling the events will prevent the
+  user agent from showing redundant progress information.</p>
 
+
+
+  <div class=impl>
+
   <h4 id=appcache><span class=secno>6.7.2 </span>Application caches</h4> <!--APPCACHE-->
 
   <p>An <dfn id=application-cache>application cache</dfn> is a set of cached resources

Modified: source
===================================================================
--- source	2012-10-11 23:03:52 UTC (rev 7455)
+++ source	2012-10-11 23:20:32 UTC (rev 7456)
@@ -84598,6 +84598,8 @@
      <td> <dfn title="event-appcache-progress"><code>progress</code></dfn>
      <td> <code>ProgressEvent</code>
      <td> The user agent is downloading resources listed by the manifest.
+          The event object's <code title="dom-ProgressEvents-total">total</code> attribute returns the total number of files to be downloaded.
+          The event object's <code title="dom-ProgressEvents-loaded">loaded</code> attribute returns the number of files processed so far.
      <td> <code title="event-appcache-progress">progress</code>, <code title="event-appcache-error">error</code>, <code title="event-appcache-cached">cached</code>, <code title="event-appcache-updateready">updateready</code>
     <tr>
      <td> <dfn title="event-appcache-cached"><code>cached</code></dfn>
@@ -84628,8 +84630,12 @@
      <td> The user agent will try fetching the files again momentarily.
   </table>
 
+  <p>These events are cancelable; their default action is for the user agent to show download
+  progress information. If the page shows its own update UI, canceling the events will prevent the
+  user agent from showing redundant progress information.</p>
 
 
+
   <div class="impl">
 
   <h4 id="appcache">Application caches</h4> <!--APPCACHE-->