[e] (0) Try to make the appcache event sequence clearer.

git-svn-id: http://svn.whatwg.org/webapps@4686 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Feb 10, 2010 · 15f5ea6 · 15f5ea6
1 parent 5cd101c
commit 15f5ea6
Show file tree

Hide file tree

Showing 3 changed files with 21 additions and 15 deletions.
diff --git a/complete.html b/complete.html
@@ -54984,22 +54984,23 @@ <h5 id=appcacheevents><span class=secno>6.6.1.1 </span>Event summary</h5>
   saw it, redownloading all the resources it mentions and caching them
   anew.</p>
 
-  <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:</p>
+  <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:</p>
 
   <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.
@@ -88449,6 +88450,7 @@ <h3 class="no-num">Reflecting IDL attributes</h3>
   Wojciech Mach,
   Wolfram Kriesing,
   Yang Chen,
+  Yehuda Katz,
   Yi-An Huang,
   Yngve Nysaeter Pettersen,
   Yuzo Fujishima,

diff --git a/index b/index
@@ -54883,22 +54883,23 @@ clock.js</pre>
   saw it, redownloading all the resources it mentions and caching them
   anew.</p>
 
-  <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:</p>
+  <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:</p>
 
   <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.
@@ -82896,6 +82897,7 @@ interface <a href=#htmldocument>HTMLDocument</a> {
   Wojciech Mach,
   Wolfram Kriesing,
   Yang Chen,
+  Yehuda Katz,
   Yi-An Huang,
   Yngve Nysaeter Pettersen,
   Yuzo Fujishima,

diff --git a/source b/source
@@ -62004,9 +62004,10 @@ State: &lt;OUTPUT NAME=I>1&lt;/OUTPUT> &lt;INPUT VALUE="Increment" TYPE=BUTTON O
   saw it, redownloading all the resources it mentions and caching them
   anew.</p>
 
-  <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:</p>
+  <p>As this is going on, a number of events get fired on the
+  <code>ApplicationCache</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:</p>
 
   <table>
    <thead>
@@ -62019,13 +62020,13 @@ State: &lt;OUTPUT NAME=I>1&lt;/OUTPUT> &lt;INPUT VALUE="Increment" TYPE=BUTTON O
     <tr>
      <td> <dfn 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">noupdate</code>, <code title="event-appcache-downloading">downloading</code>, <code title="event-appcache-obsolete">obsolete</code>, <code title="event-appcache-error">error</code>
     <tr>
      <td> <dfn 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 title="event-appcache-downloading"><code>downloading</code></dfn>
      <td> <code>Event</code>
@@ -99040,6 +99041,7 @@ interface <span>HTMLDocument</span> {
   Wojciech Mach,
   Wolfram Kriesing,
   Yang Chen,
+  Yehuda Katz,
   Yi-An Huang,
   Yngve Nysaeter Pettersen,
   Yuzo Fujishima,