hixie: Try to make the appcache event sequence clearer. (whatwg r4686)

hixie: Try to make the appcache event sequence clearer. (whatwg r4686)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.3739&r2=1.3740&f=h
http://html5.org/tools/web-apps-tracker?from=4685&to=4686

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3739
retrieving revision 1.3740
diff -u -d -r1.3739 -r1.3740
--- Overview.html 10 Feb 2010 02:27:48 -0000 1.3739
+++ Overview.html 10 Feb 2010 08:09:31 -0000 1.3740
@@ -42171,20 +42171,21 @@
   will try to update the cache. It does this by fetching a copy of the
   manifest and, if the manifest has changed since the user agent last
   saw it, redownloading all the resources it mentions and caching them
-  anew.<p>As this is going on, a number of events get fired to keep the
-  script updated as to the state of the cache update, so that the user
-  can be notified appropriately. The events are as follows:<table><thead><tr><th> Event name
+  anew.<p>As this is going on, a number of events get fired on the
+  <code><a href="#applicationcache">ApplicationCache</a></code> object to keep the script updated as
+  to the state of the cache update, so that the user can be notified
+  appropriately. The events are as follows:<table><thead><tr><th> Event name
      <th> Interface
      <th> Dispatched when...
      <th> Next events
    <tbody><tr><td> <dfn id="event-appcache-checking" title="event-appcache-checking"><code>checking</code></dfn>
      <td> <code>Event</code>
-     <td> The user agent is checking for an update, or attempting to download the manifest for the first time.
+     <td> The user agent is checking for an update, or attempting to download the manifest for the first time. <strong>This is always the first event in the sequence.</strong>
      <td> <code title="event-appcache-noupdate"><a href="#event-appcache-noupdate">noupdate</a></code>, <code title="event-appcache-downloading"><a href="#event-appcache-downloading">downloading</a></code>, <code title="event-appcache-obsolete"><a href="#event-appcache-obsolete">obsolete</a></code>, <code title="event-appcache-error"><a href="#event-appcache-error">error</a></code>
     <tr><td> <dfn id="event-appcache-noupdate" title="event-appcache-noupdate"><code>noupdate</code></dfn>
      <td> <code>Event</code>
      <td> The manifest hadn't changed.
-     <td> (Last event in sequence.)
+     <td> Last event in sequence.
     <tr><td> <dfn id="event-appcache-downloading" title="event-appcache-downloading"><code>downloading</code></dfn>
      <td> <code>Event</code>
      <td> The user agent has found an update and is fetching it, or is downloading the resources listed by the manifest for the first time.
@@ -68043,6 +68044,7 @@
   Wojciech Mach,
   Wolfram Kriesing,
   Yang Chen,
+  Yehuda Katz,
   Yi-An Huang,
   Yngve Nysaeter Pettersen,
   Yuzo Fujishima,

Received on Wednesday, 10 February 2010 08:10:15 UTC