[html5] r6013 - [e] (0) more minor tweaks to the event descriptions

whatwg at whatwg.org whatwg at whatwg.org
Thu Apr 14 18:10:32 PDT 2011


Author: ianh
Date: 2011-04-14 18:10:31 -0700 (Thu, 14 Apr 2011)
New Revision: 6013

Modified:
   complete.html
   index
   source
Log:
[e] (0) more minor tweaks to the event descriptions

Modified: complete.html
===================================================================
--- complete.html	2011-04-15 01:03:25 UTC (rev 6012)
+++ complete.html	2011-04-15 01:10:31 UTC (rev 6013)
@@ -33095,13 +33095,13 @@
      <a href=#ended-playback title="ended playback">playback ended</a>, or playback <a href=#stopped-due-to-errors>stopped due to errors</a>, or the element has <a href=#paused-for-user-interaction>paused for user interaction</a>.
     <tr><td><dfn id=event-media-playing title=event-media-playing><code>playing</code></dfn>
      <td><code><a href=#event>Event</a></code>
-     <td>Playback has started.
+     <td>Playback has started after having been delayed due to lack of <a href=#media-data>media data</a>.
      <td>The element is newly <a href=#potentially-playing>potentially playing</a>, either because <code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> is newly equal to or greater than <code title=dom-media-HAVE_FUTURE_DATA><a href=#dom-media-have_future_data>HAVE_FUTURE_DATA</a></code>, or because <code title=dom-media-paused><a href=#dom-media-paused>paused</a></code> is newly false. It is possible for playback to start without this event firing, e.g. if when playback would have started, 
 <!--CONTROLLER-->
      one of the element's <a href=#current-media-controller>current media controller</a>'s other <a href=#slaved-media-elements>slaved media elements</a> was a <a href=#blocked-media-element>blocked media element</a>, or
 <!--CONTROLLER-->
-     the element had <a href=#paused-for-user-interaction>paused for user interaction</a> but the user has now made the necesary selection.
-
+     the element had been <a href=#paused-for-user-interaction>paused for user interaction</a>.
+     <!-- XXX we should consider changing that so that 'playing' fires in those two cases too (but when readyState/paused change, not when playback actually starts) -->
    <tbody><tr><td><dfn id=event-media-seeking title=event-media-seeking><code>seeking</code></dfn>
      <td><code><a href=#event>Event</a></code>
      <td>The <code title=dom-media-seeking><a href=#dom-media-seeking>seeking</a></code> IDL attribute changed to true and the seek operation is taking long enough that the user agent has time to fire the event.
@@ -33125,11 +33125,11 @@
      <td>
     <tr><td><dfn id=event-media-play title=event-media-play><code>play</code></dfn>
      <td><code><a href=#event>Event</a></code>
-     <td>Playback has begun. Fired after the <code title=dom-media-play><a href=#dom-media-play>play()</a></code> method has returned, or when the <code title=attr-media-autoplay><a href=#attr-media-autoplay>autoplay</a></code> attribute has caused playback to begin.
+     <td>The element is no longer paused. Fired after the <code title=dom-media-play><a href=#dom-media-play>play()</a></code> method has returned, or when the <code title=attr-media-autoplay><a href=#attr-media-autoplay>autoplay</a></code> attribute has caused playback to begin.
      <td><code title=dom-media-paused><a href=#dom-media-paused>paused</a></code> is newly false.
     <tr><td><dfn id=event-media-pause title=event-media-pause><code>pause</code></dfn>
      <td><code><a href=#event>Event</a></code>
-     <td>Playback has been paused. Fired after the <code title=dom-media-pause><a href=#dom-media-pause>pause()</a></code> method has returned.
+     <td>The element has been paused. Fired after the <code title=dom-media-pause><a href=#dom-media-pause>pause()</a></code> method has returned.
      <td><code title=dom-media-paused><a href=#dom-media-paused>paused</a></code> is newly true.
     <tr><td><dfn id=event-media-ratechange title=event-media-ratechange><code>ratechange</code></dfn>
      <td><code><a href=#event>Event</a></code>

Modified: index
===================================================================
--- index	2011-04-15 01:03:25 UTC (rev 6012)
+++ index	2011-04-15 01:10:31 UTC (rev 6013)
@@ -33107,13 +33107,13 @@
      <a href=#ended-playback title="ended playback">playback ended</a>, or playback <a href=#stopped-due-to-errors>stopped due to errors</a>, or the element has <a href=#paused-for-user-interaction>paused for user interaction</a>.
     <tr><td><dfn id=event-media-playing title=event-media-playing><code>playing</code></dfn>
      <td><code><a href=#event>Event</a></code>
-     <td>Playback has started.
+     <td>Playback has started after having been delayed due to lack of <a href=#media-data>media data</a>.
      <td>The element is newly <a href=#potentially-playing>potentially playing</a>, either because <code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> is newly equal to or greater than <code title=dom-media-HAVE_FUTURE_DATA><a href=#dom-media-have_future_data>HAVE_FUTURE_DATA</a></code>, or because <code title=dom-media-paused><a href=#dom-media-paused>paused</a></code> is newly false. It is possible for playback to start without this event firing, e.g. if when playback would have started, 
 <!--CONTROLLER-->
      one of the element's <a href=#current-media-controller>current media controller</a>'s other <a href=#slaved-media-elements>slaved media elements</a> was a <a href=#blocked-media-element>blocked media element</a>, or
 <!--CONTROLLER-->
-     the element had <a href=#paused-for-user-interaction>paused for user interaction</a> but the user has now made the necesary selection.
-
+     the element had been <a href=#paused-for-user-interaction>paused for user interaction</a>.
+     <!-- XXX we should consider changing that so that 'playing' fires in those two cases too (but when readyState/paused change, not when playback actually starts) -->
    <tbody><tr><td><dfn id=event-media-seeking title=event-media-seeking><code>seeking</code></dfn>
      <td><code><a href=#event>Event</a></code>
      <td>The <code title=dom-media-seeking><a href=#dom-media-seeking>seeking</a></code> IDL attribute changed to true and the seek operation is taking long enough that the user agent has time to fire the event.
@@ -33137,11 +33137,11 @@
      <td>
     <tr><td><dfn id=event-media-play title=event-media-play><code>play</code></dfn>
      <td><code><a href=#event>Event</a></code>
-     <td>Playback has begun. Fired after the <code title=dom-media-play><a href=#dom-media-play>play()</a></code> method has returned, or when the <code title=attr-media-autoplay><a href=#attr-media-autoplay>autoplay</a></code> attribute has caused playback to begin.
+     <td>The element is no longer paused. Fired after the <code title=dom-media-play><a href=#dom-media-play>play()</a></code> method has returned, or when the <code title=attr-media-autoplay><a href=#attr-media-autoplay>autoplay</a></code> attribute has caused playback to begin.
      <td><code title=dom-media-paused><a href=#dom-media-paused>paused</a></code> is newly false.
     <tr><td><dfn id=event-media-pause title=event-media-pause><code>pause</code></dfn>
      <td><code><a href=#event>Event</a></code>
-     <td>Playback has been paused. Fired after the <code title=dom-media-pause><a href=#dom-media-pause>pause()</a></code> method has returned.
+     <td>The element has been paused. Fired after the <code title=dom-media-pause><a href=#dom-media-pause>pause()</a></code> method has returned.
      <td><code title=dom-media-paused><a href=#dom-media-paused>paused</a></code> is newly true.
     <tr><td><dfn id=event-media-ratechange title=event-media-ratechange><code>ratechange</code></dfn>
      <td><code><a href=#event>Event</a></code>

Modified: source
===================================================================
--- source	2011-04-15 01:03:25 UTC (rev 6012)
+++ source	2011-04-15 01:10:31 UTC (rev 6013)
@@ -36408,13 +36408,13 @@
     <tr>
      <td><dfn title="event-media-playing"><code>playing</code></dfn>
      <td><code>Event</code>
-     <td>Playback has started.
+     <td>Playback has started after having been delayed due to lack of <span>media data</span>.
      <td>The element is newly <span>potentially playing</span>, either because <code title="dom-media-readyState">readyState</code> is newly equal to or greater than <code title="dom-media-HAVE_FUTURE_DATA">HAVE_FUTURE_DATA</code>, or because <code title="dom-media-paused">paused</code> is newly false. It is possible for playback to start without this event firing, e.g. if when playback would have started, 
 <!--END w3c-html--><!--CONTROLLER-->
      one of the element's <span>current media controller</span>'s other <span>slaved media elements</span> was a <span>blocked media element</span>, or
 <!--START w3c-html--><!--CONTROLLER-->
-     the element had <span>paused for user interaction</span> but the user has now made the necesary selection.
-
+     the element had been <span>paused for user interaction</span>.
+     <!-- XXX we should consider changing that so that 'playing' fires in those two cases too (but when readyState/paused change, not when playback actually starts) -->
    <tbody>
     <tr>
      <td><dfn title="event-media-seeking"><code>seeking</code></dfn>
@@ -36446,12 +36446,12 @@
     <tr>
      <td><dfn title="event-media-play"><code>play</code></dfn>
      <td><code>Event</code>
-     <td>Playback has begun. Fired after the <code title="dom-media-play">play()</code> method has returned, or when the <code title="attr-media-autoplay">autoplay</code> attribute has caused playback to begin.
+     <td>The element is no longer paused. Fired after the <code title="dom-media-play">play()</code> method has returned, or when the <code title="attr-media-autoplay">autoplay</code> attribute has caused playback to begin.
      <td><code title="dom-media-paused">paused</code> is newly false.
     <tr>
      <td><dfn title="event-media-pause"><code>pause</code></dfn>
      <td><code>Event</code>
-     <td>Playback has been paused. Fired after the <code title="dom-media-pause">pause()</code> method has returned.
+     <td>The element has been paused. Fired after the <code title="dom-media-pause">pause()</code> method has returned.
      <td><code title="dom-media-paused">paused</code> is newly true.
     <tr>
      <td><dfn title="event-media-ratechange"><code>ratechange</code></dfn>




More information about the Commit-Watchers mailing list