W3C home > Mailing lists > Public > public-html-commits@w3.org > April 2011

html5/spec spec.html,1.1446,1.1447 video.html,1.941,1.942

From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 20 Apr 2011 00:47:21 +0000
To: public-html-commits@w3.org
Message-Id: <E1QCLZn-0000kw-DW@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv2781

Modified Files:
	spec.html video.html 
Log Message:
Rework MediaController so that it exposes more events so that you can keep track of the overall state. (whatwg r6018)

[updated by splitter]


Index: video.html
===================================================================
RCS file: /sources/public/html5/spec/video.html,v
retrieving revision 1.941
retrieving revision 1.942
diff -u -d -r1.941 -r1.942
--- video.html	15 Apr 2011 21:46:55 -0000	1.941
+++ video.html	20 Apr 2011 00:47:18 -0000	1.942
@@ -1328,7 +1328,11 @@
     <code title="dom-media-NETWORK_EMPTY"><a href="#dom-media-network_empty">NETWORK_EMPTY</a></code>, then
     run these substeps:</p>
 
-    <ol><li><p>If a fetching process is in progress for the <a href="#media-element">media
+    <ol><li><p><a href="webappapis.html#queue-a-task">Queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple
+     event</a> named <code title="event-media-emptied"><a href="#event-media-emptied">emptied</a></code> at the <a href="#media-element">media
+     element</a>.</p></li>
+
+     <li><p>If a fetching process is in progress for the <a href="#media-element">media
      element</a>, the user agent should stop it.</p></li>
 
      <li><p>Set the <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> attribute to
@@ -1339,7 +1343,9 @@
 
      <li><p>If <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> is
      not set to <code title="dom-media-HAVE_NOTHING"><a href="#dom-media-have_nothing">HAVE_NOTHING</a></code>, then set it
-     to that state.</p></li>
+     to that state.
+     
+     </p></li>
 
      <li><p>If the <code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code>
      attribute is false, then set it to true.</p></li>
@@ -1375,10 +1381,6 @@
 
      </li>
 
-     <li><p><a href="webappapis.html#queue-a-task">Queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple
-     event</a> named <code title="event-media-emptied"><a href="#event-media-emptied">emptied</a></code> at the <a href="#media-element">media
-     element</a>.</p></li>
-
     </ol></li>
 
    <li><p>Set the <code title="dom-media-playbackRate"><a href="#dom-media-playbackrate">playbackRate</a></code> attribute to the
@@ -1808,21 +1810,20 @@
 
        </li>
 
-       <li><p>Set the <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute to
-       <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata">HAVE_METADATA</a></code>.</p></li>
-
        <li><p>For <code><a href="#video">video</a></code> elements, set the <code title="dom-video-videoWidth"><a href="#dom-video-videowidth">videoWidth</a></code> and <code title="dom-video-videoHeight"><a href="#dom-video-videoheight">videoHeight</a></code>
        attributes.</p></li>
 
-       <li id="fire-loadedmetadata">
+       <li>
 
-        <p><a href="webappapis.html#queue-a-task">Queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple
-        event</a> named <code title="event-media-loadedmetadata"><a href="#event-media-loadedmetadata">loadedmetadata</a></code> at the
-        element.</p>
+        <p>Set the <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute to
+        <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata">HAVE_METADATA</a></code>.</p>
 
-        <p class="note">Before this task is run, as part of the event
-        loop mechanism, the rendering will have been updated to resize
-        the <code><a href="#video">video</a></code> element if appropriate.</p>
+        <p class="note">A <code title="event-media-loadedmetadata"><a href="#event-media-loadedmetadata">loadedmetadata</a></code> DOM
+        event <a href="#fire-loadedmetadata">will be fired</a> as part
+        of setting the <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute to a
+        new value.</p>
+
+        
 
        </li>
 
@@ -2435,99 +2436,122 @@
   <p>When the ready state of a <a href="#media-element">media element</a> whose <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> is not <code title="dom-media-NETWORK_EMPTY"><a href="#dom-media-network_empty">NETWORK_EMPTY</a></code> changes, the
   user agent must follow the steps given below:</p>
 
-  <dl class="switch"><dt>If the previous ready state was <code title="dom-media-HAVE_NOTHING"><a href="#dom-media-have_nothing">HAVE_NOTHING</a></code>, and the new
-   ready state is <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata">HAVE_METADATA</a></code></dt>
+  <ol><li>
 
-   <dd>
+    <p>Apply the first applicable set of substeps from the following
+    list:</p>
 
-    <p class="note">A <code title="event-media-loadedmetadata"><a href="#event-media-loadedmetadata">loadedmetadata</a></code> DOM event <a href="#fire-loadedmetadata">will be fired</a> as part of the <code title="dom-media-load"><a href="#dom-media-load">load()</a></code> algorithm.</p>
 
-   </dd>
+    <dl class="switch"><dt>If the previous ready state was <code title="dom-media-HAVE_NOTHING"><a href="#dom-media-have_nothing">HAVE_NOTHING</a></code>, and the new
+     ready state is <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata">HAVE_METADATA</a></code></dt>
 
-   
+     <dd id="fire-loadedmetadata">
 
-   <dt id="handling-first-frame-available">If the previous ready state
-   was <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata">HAVE_METADATA</a></code> and
-   the new ready state is <code title="dom-media-HAVE_CURRENT_DATA"><a href="#dom-media-have_current_data">HAVE_CURRENT_DATA</a></code> or
-   greater</dt>
+      <p><a href="webappapis.html#queue-a-task">Queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple event</a>
+      named <code title="event-media-loadedmetadata"><a href="#event-media-loadedmetadata">loadedmetadata</a></code> at the
+      element.</p>
 
-   <dd>
+      <p class="note">Before this task is run, as part of the event
+      loop mechanism, the rendering will have been updated to resize
+      the <code><a href="#video">video</a></code> element if appropriate.</p>
 
-    <p id="fire-loadeddata">If this is the first time this occurs for
-    this <a href="#media-element">media element</a> since the <code title="dom-media-load"><a href="#dom-media-load">load()</a></code> algorithm was last invoked,
-    the user agent must <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a
-    simple event</a> named <code title="event-media-loadeddata"><a href="#event-media-loadeddata">loadeddata</a></code> at the element.</p>
+     </dd>
 
-    <p>If the new ready state is <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code> or
-    <code title="dom-media-HAVE_ENOUGH_DATA"><a href="#dom-media-have_enough_data">HAVE_ENOUGH_DATA</a></code>,
-    then the relevant steps below must then be run also.</p>
+     
 
-   </dd>
+     <dt id="handling-first-frame-available">If the previous ready state
+     was <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata">HAVE_METADATA</a></code> and
+     the new ready state is <code title="dom-media-HAVE_CURRENT_DATA"><a href="#dom-media-have_current_data">HAVE_CURRENT_DATA</a></code> or
+     greater</dt>
 
-   
-   <dt>If the previous ready state was <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code> or more,
-   and the new ready state is <code title="dom-media-HAVE_CURRENT_DATA"><a href="#dom-media-have_current_data">HAVE_CURRENT_DATA</a></code> or
-   less</dt>
+     <dd>
 
-   <dd>
+      <p id="fire-loadeddata">If this is the first time this occurs for
+      this <a href="#media-element">media element</a> since the <code title="dom-media-load"><a href="#dom-media-load">load()</a></code> algorithm was last invoked,
+      the user agent must <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a
+      simple event</a> named <code title="event-media-loadeddata"><a href="#event-media-loadeddata">loadeddata</a></code> at the element.</p>
 
-    <p class="note">A <code title="event-media-waiting"><a href="#event-media-waiting">waiting</a></code> DOM
-    event <a href="#fire-waiting-when-waiting">can be fired</a>,
-    depending on the current state of playback.</p>
+      <p>If the new ready state is <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code> or
+      <code title="dom-media-HAVE_ENOUGH_DATA"><a href="#dom-media-have_enough_data">HAVE_ENOUGH_DATA</a></code>,
+      then the relevant steps below must then be run also.</p>
 
-   </dd>
+     </dd>
 
-   
-   <dt>If the previous ready state was <code title="dom-media-HAVE_CURRENT_DATA"><a href="#dom-media-have_current_data">HAVE_CURRENT_DATA</a></code> or
-   less, and the new ready state is <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code></dt>
+     
+     <dt>If the previous ready state was <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code> or more,
+     and the new ready state is <code title="dom-media-HAVE_CURRENT_DATA"><a href="#dom-media-have_current_data">HAVE_CURRENT_DATA</a></code> or
+     less</dt>
 
-   <dd>
+     <dd>
 
-    <p>The user agent must <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a
-    simple event</a> named <code title="event-media-canplay"><a href="#event-media-canplay">canplay</a></code>.</p>
+      <p id="fire-waiting-when-waiting">If the <a href="#media-element">media
+      element</a> was <a href="#potentially-playing">potentially playing</a> before its
+      <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute
+      changed to a value lower than <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code>, and
+      the element has not <a href="#ended-playback">ended playback</a>, and playback
+      has not <a href="#stopped-due-to-errors">stopped due to errors</a>, and playback has not
+      <a href="#paused-for-user-interaction">paused for user interaction</a>, the user agent must
+      <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple event</a>
+      named <code title="event-media-timeupdate"><a href="#event-media-timeupdate">timeupdate</a></code> at
+      the element, and <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a
+      simple event</a> named <code title="event-media-waiting"><a href="#event-media-waiting">waiting</a></code> at the element.</p>
 
-    <p>If the element's <code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code>
-    attribute is false, the user agent must <a href="webappapis.html#queue-a-task">queue a task</a>
-    to <a href="webappapis.html#fire-a-simple-event">fire a simple event</a> named <code title="event-media-playing"><a href="#event-media-playing">playing</a></code>.</p>
+     </dd>
 
-   </dd>
+     
+     <dt>If the previous ready state was <code title="dom-media-HAVE_CURRENT_DATA"><a href="#dom-media-have_current_data">HAVE_CURRENT_DATA</a></code> or
+     less, and the new ready state is <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code></dt>
 
-   
-   <dt>If the new ready state is <code title="dom-media-HAVE_ENOUGH_DATA"><a href="#dom-media-have_enough_data">HAVE_ENOUGH_DATA</a></code></dt>
+     <dd>
 
-   <dd>
+      <p>The user agent must <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a
+      simple event</a> named <code title="event-media-canplay"><a href="#event-media-canplay">canplay</a></code>.</p>
 
-    <p>If the previous ready state was <code title="dom-media-HAVE_CURRENT_DATA"><a href="#dom-media-have_current_data">HAVE_CURRENT_DATA</a></code> or
-    less, the user agent must <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire
-    a simple event</a> named <code title="event-media-canplay"><a href="#event-media-canplay">canplay</a></code>, and, if the element's
-    <code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code> attribute is false,
-    <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple event</a>
-    named <code title="event-media-playing"><a href="#event-media-playing">playing</a></code>.</p>
+      <p>If the element's <code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code>
+      attribute is false, the user agent must <a href="webappapis.html#queue-a-task">queue a task</a>
+      to <a href="webappapis.html#fire-a-simple-event">fire a simple event</a> named <code title="event-media-playing"><a href="#event-media-playing">playing</a></code>.</p>
 
-    <p>If the <a href="#autoplaying-flag">autoplaying flag</a> is true, and the <code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code> attribute is true, and the
-    <a href="#media-element">media element</a> has an <code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code> attribute specified,
-    and the <a href="#media-element">media element</a>'s <code><a href="infrastructure.html#document">Document</a></code>'s
-    <a href="browsers.html#browsing-context">browsing context</a> did not have the <a href="the-iframe-element.html#sandboxed-automatic-features-browsing-context-flag">sandboxed
-    automatic features browsing context flag</a> set when the
-    <code><a href="infrastructure.html#document">Document</a></code> was created, then the user agent may also
-    set the <code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code> attribute to
-    false, <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple
-    event</a> named <code title="event-media-play"><a href="#event-media-play">play</a></code>, and
-    <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple event</a>
-    named <code title="event-media-playing"><a href="#event-media-playing">playing</a></code>.</p>
+     </dd>
 
-    <p class="note">User agents do not need to support autoplay,
-    and it is suggested that user agents honor user preferences on the
-    matter. Authors are urged to use the <code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code> attribute rather than
-    using script to force the video to play, so as to allow the user
-    to override the behavior if so desired.</p>
+     
+     <dt>If the new ready state is <code title="dom-media-HAVE_ENOUGH_DATA"><a href="#dom-media-have_enough_data">HAVE_ENOUGH_DATA</a></code></dt>
 
-    <p>In any case, the user agent must finally <a href="webappapis.html#queue-a-task">queue a
-    task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple event</a> named <code title="event-media-canplaythrough"><a href="#event-media-canplaythrough">canplaythrough</a></code>.</p>
+     <dd>
 
-   </dd>
+      <p>If the previous ready state was <code title="dom-media-HAVE_CURRENT_DATA"><a href="#dom-media-have_current_data">HAVE_CURRENT_DATA</a></code> or
+      less, the user agent must <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire
+      a simple event</a> named <code title="event-media-canplay"><a href="#event-media-canplay">canplay</a></code>, and, if the element's
+      <code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code> attribute is false,
+      <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple event</a>
+      named <code title="event-media-playing"><a href="#event-media-playing">playing</a></code>.</p>
 
-  </dl></div><p class="note">It is possible for the ready state of a media
+      <p>If the <a href="#autoplaying-flag">autoplaying flag</a> is true, and the <code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code> attribute is true, and the
+      <a href="#media-element">media element</a> has an <code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code> attribute specified,
+      and the <a href="#media-element">media element</a>'s <code><a href="infrastructure.html#document">Document</a></code>'s
+      <a href="browsers.html#browsing-context">browsing context</a> did not have the <a href="the-iframe-element.html#sandboxed-automatic-features-browsing-context-flag">sandboxed
+      automatic features browsing context flag</a> set when the
+      <code><a href="infrastructure.html#document">Document</a></code> was created, then the user agent may also
+      set the <code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code> attribute to
+      false, <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple
+      event</a> named <code title="event-media-play"><a href="#event-media-play">play</a></code>, and
+      <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple event</a>
+      named <code title="event-media-playing"><a href="#event-media-playing">playing</a></code>.</p>
+
+      <p class="note">User agents do not need to support autoplay,
+      and it is suggested that user agents honor user preferences on the
+      matter. Authors are urged to use the <code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code> attribute rather than
+      using script to force the video to play, so as to allow the user
+      to override the behavior if so desired.</p>
+
+      <p>In any case, the user agent must finally <a href="webappapis.html#queue-a-task">queue a
+      task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple event</a> named <code title="event-media-canplaythrough"><a href="#event-media-canplaythrough">canplaythrough</a></code>.</p>
+
+     </dd>
+
+    </dl></li>
+
+
+  </ol></div><p class="note">It is possible for the ready state of a media
   element to jump between these states discontinuously. For example,
   the state of a media element can jump straight from <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata">HAVE_METADATA</a></code> to <code title="dom-media-HAVE_ENOUGH_DATA"><a href="#dom-media-have_enough_data">HAVE_ENOUGH_DATA</a></code> without
   passing through the <code title="dom-media-HAVE_CURRENT_DATA"><a href="#dom-media-have_current_data">HAVE_CURRENT_DATA</a></code> and
@@ -2694,7 +2718,8 @@
   <code title="dom-media-HAVE_ENOUGH_DATA"><a href="#dom-media-have_enough_data">HAVE_ENOUGH_DATA</a></code> and
   the user agent has reached a point in the <a href="#media-resource">media
   resource</a> where the user has to make a selection for the
-  resource to continue.</p>
+  resource to continue.
+  </p>
 
   <p>It is possible for a <a href="#media-element">media element</a> to have both
   <a href="#ended-playback">ended playback</a> and <a href="#paused-for-user-interaction">paused for user
@@ -2705,18 +2730,11 @@
   interaction</a>, the user agent must <a href="webappapis.html#queue-a-task">queue a task</a> to
   <a href="webappapis.html#fire-a-simple-event">fire a simple event</a> named <code title="event-media-timeupdate"><a href="#event-media-timeupdate">timeupdate</a></code> at the element.</p>
 
-  <p id="fire-waiting-when-waiting">When a <a href="#media-element">media element</a>
-  that is <a href="#potentially-playing">potentially playing</a> stops playing because its
-  <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute
-  changes to a value lower than <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code>, without
-  the element having <a href="#ended-playback">ended playback</a>, or playback having
-  <a href="#stopped-due-to-errors">stopped due to errors</a>, or playback having <a href="#paused-for-user-interaction">paused
-  for user interaction</a>, or the <a href="#dom-media-seek" title="dom-media-seek">seeking algorithm</a> being invoked, the
-  user agent must <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple
-  event</a> named <code title="event-media-timeupdate"><a href="#event-media-timeupdate">timeupdate</a></code>
-  at the element, and <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple
-  event</a> named <code title="event-media-waiting"><a href="#event-media-waiting">waiting</a></code> at
-  the element.</p>
+  <p class="note">A <code title="event-media-waiting"><a href="#event-media-waiting">waiting</a></code>
+  DOM event <a href="#fire-waiting-when-waiting">can be fired</a> as a
+  result of an element that is <a href="#potentially-playing">potentially playing</a>
+  stopping playback due to its <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute changing to
+  a value lower than <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code>.</p>
 
   <p>When the <a href="#current-playback-position">current playback position</a> reaches the end
   of the <a href="#media-resource">media resource</a> when the <a href="#direction-of-playback">direction of
@@ -2839,6 +2857,7 @@
    <li><p>Set the <a href="#media-element">media element</a>'s <a href="#autoplaying-flag">autoplaying
    flag</a> to false.</p></li>
 
+
   </ol><hr><p>When the <dfn id="dom-media-pause" title="dom-media-pause"><code>pause()</code></dfn>
   method is invoked, and when the user agent is required to pause the
   <a href="#media-element">media element</a>, the user agent must run the following
@@ -2867,6 +2886,7 @@
 
     </ol></li>
 
+
   </ol><hr><p>The
   <span>effective playback rate</span> is just the element's <code title="dom-media-playbackRate"><a href="#dom-media-playbackrate">playbackRate</a></code>.
   </p>
@@ -3127,29 +3147,30 @@
    <code title="dom-media-seeking"><a href="#dom-media-seeking">seeking</a></code> IDL attribute to
    false and abort these steps.</p></li>
 
-   <li><p>Set the <a href="#current-playback-position">current playback position</a> to the given
-   <var title="">new playback position</var>.</p></li>
-
    <li><p><a href="webappapis.html#queue-a-task">Queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple
    event</a> named <code title="event-media-seeking"><a href="#event-media-seeking">seeking</a></code>
    at the element.</p></li>
 
-   <li id="seekUpdate"><p><a href="webappapis.html#queue-a-task">Queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a
-   simple event</a> named <code title="event-media-timeupdate"><a href="#event-media-timeupdate">timeupdate</a></code> at the
-   element.</p></li>
+   <li>
 
-   <li><p>If the <a href="#media-element">media element</a> was <a href="#potentially-playing">potentially
-   playing</a> immediately before it started seeking, but seeking
-   caused its <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code>
-   attribute to change to a value lower than <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code>, then
-   <a href="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple event</a> named
-   <code title="event-media-waiting"><a href="#event-media-waiting">waiting</a></code> at the
-   element.</p></li>
+    <p>Set the <a href="#current-playback-position">current playback position</a> to the given
+    <var title="">new playback position</var>.</p>
+
+    <p class="note">If the <a href="#media-element">media element</a> was
+    <a href="#potentially-playing">potentially playing</a> immediately before it started
+    seeking, but seeking caused its <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute to change
+    to a value lower than <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code>, then a
+    <code title="event-media-waiting"><a href="#event-media-waiting">waiting</a></code> <a href="#fire-waiting-when-waiting">will be fired</a> at the
+    element.</p> 
+    
+
+   </li>
 
    <li><p>Wait until the user agent has established whether or not the
    <a href="#media-data">media data</a> for the <var title="">new playback
    position</var> is available, and, if it is, until it has decoded
-   enough data to play back that position.</p></li>
+   enough data to play back that position.</p>
+      </li>
 
    <li><p><a href="webappapis.html#await-a-stable-state">Await a stable state</a>. The <a href="webappapis.html#synchronous-section">synchronous
    section</a> consists of all the remaining steps of this
@@ -3159,6 +3180,10 @@
    <li><p>&#8987; Set the <code title="dom-media-seeking"><a href="#dom-media-seeking">seeking</a></code> IDL attribute to
    false.</p></li>
 
+   <li id="seekUpdate"><p><a href="webappapis.html#queue-a-task">Queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a
+   simple event</a> named <code title="event-media-timeupdate"><a href="#event-media-timeupdate">timeupdate</a></code> at the
+   element.</p></li>
+
    <li><p>&#8987; <a href="webappapis.html#queue-a-task">Queue a task</a> to <a href="webappapis.html#fire-a-simple-event">fire a simple
    event</a> named <code title="event-media-seeked"><a href="#event-media-seeked">seeked</a></code>
    at the element.</p></li>

Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec/spec.html,v
retrieving revision 1.1446
retrieving revision 1.1447
diff -u -d -r1.1446 -r1.1447
--- spec.html	15 Apr 2011 21:46:55 -0000	1.1446
+++ spec.html	20 Apr 2011 00:47:18 -0000	1.1447
@@ -344,7 +344,7 @@
 
    <h1>HTML5</h1>
    <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
-   <h2 class="no-num no-toc" id="editor-s-draft-15-april-2011">Editor's Draft 15 April 2011</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-20-april-2011">Editor's Draft 20 April 2011</h2>
    <dl><dt>Latest Published Version:</dt>
     <dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
     <dt>Latest Editor's Draft:</dt>
@@ -367,7 +367,7 @@
     <a href="Overview.html">single page HTML</a>,
     <a href="spec.html">multipage HTML</a>,
     <a href="author/">web developer edition</a>.
-This is revision 1.4839.
+This is revision 1.4840.
    </p> 
      <p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
    &#169; 2010 <a href="http://www.w3.org/"><abbr title="World Wide
@@ -487,7 +487,7 @@
   Group</a> is the W3C working group responsible for this
   specification's progress along the W3C Recommendation
   track.
-  This specification is the 15 April 2011 Editor's Draft.
+  This specification is the 20 April 2011 Editor's Draft.
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>Work on this specification is also done at the <a href="http://www.whatwg.org/">WHATWG</a>. The W3C HTML working group
   actively pursues convergence with the WHATWG, as required by the <a href="http://www.w3.org/2007/03/HTML-WG-charter">W3C HTML working
   group charter</a>.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
Received on Wednesday, 20 April 2011 00:47:29 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 20 April 2011 00:47:33 GMT