Skip to content

Commit

Permalink
[e] (0) Correct the interface for 'stalled' events in the media event…
Browse files Browse the repository at this point in the history
… summary; Add the interface name to the appcache event summary; Add references to [PROGRESS] where appropriate.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=7772

git-svn-id: http://svn.whatwg.org/webapps@4168 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Oct 18, 2009
1 parent 6d42790 commit bccf674
Show file tree
Hide file tree
Showing 3 changed files with 55 additions and 12 deletions.
25 changes: 21 additions & 4 deletions complete.html
Expand Up @@ -24294,7 +24294,7 @@ <h5 id=mediaevents><span class=secno>4.8.10.12 </span>Event summary</h5>
<td>A <a href=#media-element>media element</a> whose <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> was previously not in the <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code> state has just switched to that state (either because of a fatal error during load that's about to be reported, or because the <code title=dom-media-load><a href=#dom-media-load>load()</a></code> method was invoked while the <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource selection algorithm</a> was already running, in which case it is fired synchronously during the <code title=dom-media-load><a href=#dom-media-load>load()</a></code> method call).
<td><code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> is <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code>; all the IDL attributes are in their initial states.
<tr><td><dfn id=event-media-stalled title=event-media-stalled><code>stalled</code></dfn>
<td><code>ProgressEvent</code>
<td><code>Event</code>
<td>The user agent is trying to fetch <a href=#media-data>media data</a>, but data is unexpectedly not forthcoming.
<td><code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> is <code title=dom-media-NETWORK_LOADING><a href=#dom-media-network_loading>NETWORK_LOADING</a></code>.

Expand Down Expand Up @@ -52638,30 +52638,39 @@ <h5 id=appcacheevents><span class=secno>6.9.1.1 </span>Event summary</h5>
can be notified appropriately. The events are as follows:</p>

<table><thead><tr><th> Event name
<th> Occasion
<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> <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.)
<tr><td> <dfn id=event-appcache-downloading title=event-appcache-downloading><code>downloading</code></dfn>
<td> <code>ProgressEvent</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.
<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-progress title=event-appcache-progress><code>progress</code></dfn>
<td> <code>Event</code>
<td> The user agent is downloading resources listed by the manifest.
<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>Event</code>
<td> The resources listed in the manifest have been downloaded, and the application is now cached.
<td> Last event in sequence.
<tr><td> <dfn id=event-appcache-updateready title=event-appcache-updateready><code>updateready</code></dfn>
<td> <code>Event</code>
<td> The resources listed in the manifest have been newly redownloaded, and the script can use <code title=dom-appcache-swapCache><a href=#dom-appcache-swapcache>swapCache()</a></code> to switch to the new cache.
<td> Last event in sequence.
<tr><td> <dfn id=event-appcache-obsolete title=event-appcache-obsolete><code>obsolete</code></dfn>
<td> <code>Event</code>
<td> The manifest was found to have become a 404 or 410 page, so the application cache is being deleted.
<td> Last event in sequence.
<tr><td rowspan=4> <dfn id=event-appcache-error title=event-appcache-error><code>error</code></dfn>
<td rowspan=4> <code>Event</code>
<td> The manifest was a 404 or 410 page, so the attempt to cache the application has been aborted.
<td rowspan=3> Last event in sequence.
<tr><td> The manifest hadn't changed, but the page referencing the manifest failed to download properly.
Expand Down Expand Up @@ -53675,7 +53684,7 @@ <h4 id=updating-an-application-cache><span class=secno>6.9.4 </span>Updating an
the user agent <a href=#shows-caching-progress>shows caching progress</a>, the display
of some sort of user interface indicating to the user that a file
is being downloaded in preparation for updating the
application.</li>
application. <a href=#refsPROGRESS>[PROGRESS]</a></li>

<li>

Expand Down Expand Up @@ -53799,7 +53808,7 @@ <h4 id=updating-an-application-cache><span class=secno>6.9.4 </span>Updating an
list</var>. The default action of these events must be, if the user
agent <a href=#shows-caching-progress>shows caching progress</a>, the display of some sort
of user interface indicating to the user that all the files have
been downloaded.</li>
been downloaded. <a href=#refsPROGRESS>[PROGRESS]</a></li>

<li><p>Store the list of <a href=#concept-appcache-fallback-ns title=concept-appcache-fallback-ns>fallback namespaces</a>,
and the URLs of the <a href=#concept-appcache-fallback title=concept-appcache-fallback>fallback entries</a> that they
Expand Down Expand Up @@ -85298,6 +85307,14 @@ <h2 class=no-num id=references>References</h2><!--REFS-->
September 1997. In <cite>Proceedings of the 11th International
Unicode Conference</cite>.</dd>

<dt id=refsPROGRESS>[PROGRESS]</dt>
<!--
<dd><cite><a href="http://www.w3.org/TR/progress-events/">Progress
Events</a></cite>, C. McCathieNevile. W3C, May 2008.</dd>
-->
<dd><cite><a href=http://dev.w3.org/2006/webapi/progress/Progress.html>Progress
Events</a></cite>, C. McCathieNevile. W3C, March 2009.</dd>

<dt id=refsPSL>[PSL]</dt>
<dd><cite><a href=http://publicsuffix.org/>Public Suffix List</a></cite>.
Mozilla Foundation.</dd>
Expand Down
25 changes: 21 additions & 4 deletions index
Expand Up @@ -24123,7 +24123,7 @@ interface <dfn>CueRangeCallback</dfn> {
<td>A <a href=#media-element>media element</a> whose <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> was previously not in the <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code> state has just switched to that state (either because of a fatal error during load that's about to be reported, or because the <code title=dom-media-load><a href=#dom-media-load>load()</a></code> method was invoked while the <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource selection algorithm</a> was already running, in which case it is fired synchronously during the <code title=dom-media-load><a href=#dom-media-load>load()</a></code> method call).
<td><code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> is <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code>; all the IDL attributes are in their initial states.
<tr><td><dfn id=event-media-stalled title=event-media-stalled><code>stalled</code></dfn>
<td><code>ProgressEvent</code>
<td><code>Event</code>
<td>The user agent is trying to fetch <a href=#media-data>media data</a>, but data is unexpectedly not forthcoming.
<td><code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> is <code title=dom-media-NETWORK_LOADING><a href=#dom-media-network_loading>NETWORK_LOADING</a></code>.

Expand Down Expand Up @@ -49797,30 +49797,39 @@ clock.js</pre>
can be notified appropriately. The events are as follows:</p>

<table><thead><tr><th> Event name
<th> Occasion
<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> <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.)
<tr><td> <dfn id=event-appcache-downloading title=event-appcache-downloading><code>downloading</code></dfn>
<td> <code>ProgressEvent</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.
<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-progress title=event-appcache-progress><code>progress</code></dfn>
<td> <code>Event</code>
<td> The user agent is downloading resources listed by the manifest.
<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>Event</code>
<td> The resources listed in the manifest have been downloaded, and the application is now cached.
<td> Last event in sequence.
<tr><td> <dfn id=event-appcache-updateready title=event-appcache-updateready><code>updateready</code></dfn>
<td> <code>Event</code>
<td> The resources listed in the manifest have been newly redownloaded, and the script can use <code title=dom-appcache-swapCache><a href=#dom-appcache-swapcache>swapCache()</a></code> to switch to the new cache.
<td> Last event in sequence.
<tr><td> <dfn id=event-appcache-obsolete title=event-appcache-obsolete><code>obsolete</code></dfn>
<td> <code>Event</code>
<td> The manifest was found to have become a 404 or 410 page, so the application cache is being deleted.
<td> Last event in sequence.
<tr><td rowspan=4> <dfn id=event-appcache-error title=event-appcache-error><code>error</code></dfn>
<td rowspan=4> <code>Event</code>
<td> The manifest was a 404 or 410 page, so the attempt to cache the application has been aborted.
<td rowspan=3> Last event in sequence.
<tr><td> The manifest hadn't changed, but the page referencing the manifest failed to download properly.
Expand Down Expand Up @@ -50834,7 +50843,7 @@ NETWORK:
the user agent <a href=#shows-caching-progress>shows caching progress</a>, the display
of some sort of user interface indicating to the user that a file
is being downloaded in preparation for updating the
application.</li>
application. <a href=#refsPROGRESS>[PROGRESS]</a></li>

<li>

Expand Down Expand Up @@ -50958,7 +50967,7 @@ NETWORK:
list</var>. The default action of these events must be, if the user
agent <a href=#shows-caching-progress>shows caching progress</a>, the display of some sort
of user interface indicating to the user that all the files have
been downloaded.</li>
been downloaded. <a href=#refsPROGRESS>[PROGRESS]</a></li>

<li><p>Store the list of <a href=#concept-appcache-fallback-ns title=concept-appcache-fallback-ns>fallback namespaces</a>,
and the URLs of the <a href=#concept-appcache-fallback title=concept-appcache-fallback>fallback entries</a> that they
Expand Down Expand Up @@ -76340,6 +76349,14 @@ interface <a href=#htmldocument>HTMLDocument</a> {
September 1997. In <cite>Proceedings of the 11th International
Unicode Conference</cite>.</dd>

<dt id=refsPROGRESS>[PROGRESS]</dt>
<!--
<dd><cite><a href="http://www.w3.org/TR/progress-events/">Progress
Events</a></cite>, C. McCathieNevile. W3C, May 2008.</dd>
-->
<dd><cite><a href=http://dev.w3.org/2006/webapi/progress/Progress.html>Progress
Events</a></cite>, C. McCathieNevile. W3C, March 2009.</dd>

<dt id=refsPSL>[PSL]</dt>
<dd><cite><a href=http://publicsuffix.org/>Public Suffix List</a></cite>.
Mozilla Foundation.</dd>
Expand Down
17 changes: 13 additions & 4 deletions source
Expand Up @@ -26176,7 +26176,7 @@ interface <dfn>CueRangeCallback</dfn> {
<td><code title="dom-media-networkState">networkState</code> is <code title="dom-media-NETWORK_EMPTY">NETWORK_EMPTY</code>; all the IDL attributes are in their initial states.
<tr>
<td><dfn title="event-media-stalled"><code>stalled</code></dfn>
<td><code>ProgressEvent</code>
<td><code>Event</code>
<td>The user agent is trying to fetch <span>media data</span>, but data is unexpectedly not forthcoming.
<td><code title="dom-media-networkState">networkState</code> is <code title="dom-media-NETWORK_LOADING">NETWORK_LOADING</code>.

Expand Down Expand Up @@ -59247,39 +59247,48 @@ interface <dfn>NavigatorAbilities</dfn> {
<thead>
<tr>
<th> Event name
<th> Occasion
<th> Interface
<th> Dispatched when...
<th> Next events
<tbody>
<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> <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.)
<tr>
<td> <dfn title="event-appcache-downloading"><code>downloading</code></dfn>
<td> <code>ProgressEvent</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.
<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-progress"><code>progress</code></dfn>
<td> <code>Event</code>
<td> The user agent is downloading resources listed by the manifest.
<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>
<td> <code>Event</code>
<td> The resources listed in the manifest have been downloaded, and the application is now cached.
<td> Last event in sequence.
<tr>
<td> <dfn title="event-appcache-updateready"><code>updateready</code></dfn>
<td> <code>Event</code>
<td> The resources listed in the manifest have been newly redownloaded, and the script can use <code title="dom-appcache-swapCache">swapCache()</code> to switch to the new cache.
<td> Last event in sequence.
<tr>
<td> <dfn title="event-appcache-obsolete"><code>obsolete</code></dfn>
<td> <code>Event</code>
<td> The manifest was found to have become a 404 or 410 page, so the application cache is being deleted.
<td> Last event in sequence.
<tr>
<td rowspan=4> <dfn title="event-appcache-error"><code>error</code></dfn>
<td rowspan=4> <code>Event</code>
<td> The manifest was a 404 or 410 page, so the attempt to cache the application has been aborted.
<td rowspan=3> Last event in sequence.
<tr>
Expand Down Expand Up @@ -60502,7 +60511,7 @@ NETWORK:
the user agent <span>shows caching progress</span>, the display
of some sort of user interface indicating to the user that a file
is being downloaded in preparation for updating the
application.</p></li>
application. <a href="#refsPROGRESS">[PROGRESS]</a></p></li>

<li>

Expand Down Expand Up @@ -60641,7 +60650,7 @@ NETWORK:
list</var>. The default action of these events must be, if the user
agent <span>shows caching progress</span>, the display of some sort
of user interface indicating to the user that all the files have
been downloaded.</p></li>
been downloaded. <a href="#refsPROGRESS">[PROGRESS]</a></p></li>

<li><p>Store the list of <span
title="concept-appcache-fallback-ns">fallback namespaces</span>,
Expand Down

0 comments on commit bccf674

Please sign in to comment.