[giow] (0) Captions - Stage 20.4: tidy up some domintro blocks and ma…

…ke sure in-band cues are also added in the event loop so that scripts can't see the list of cues changing from under them. git-svn-id: http://svn.whatwg.org/webapps@5141 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Jul 8, 2010 · 935de44 · 935de44
1 parent 22d07fb
commit 935de44
Show file tree

Hide file tree

Showing 3 changed files with 15 additions and 33 deletions.
diff --git a/complete.html b/complete.html
@@ -24855,8 +24855,9 @@ <h5 id=loading-the-media-resource><span class=secno>4.8.10.5 </span>Loading the
 
      <dd>
 
-      <p>Run the <a href=#steps-to-expose-a-media-resource-specific-timed-track>steps to expose a media-resource-specific timed
-      track</a> with the relevant data.</p>
+      <p><a href=#queue-a-task>Queue a task</a> to run the <a href=#steps-to-expose-a-media-resource-specific-timed-track>steps to expose a
+      media-resource-specific timed track</a> with the relevant
+      data.</p>
 
      </dd>
 <!--TT-->
@@ -26961,13 +26962,13 @@ <h6 id=timed-track-api><span class=secno>4.8.10.10.5 </span>Timed track API</h6>
    <dt><var title="">mutableTimedTrack</var> . <code title=dom-MutableTimedTrack-addCue><a href=#dom-mutabletimedtrack-addcue>addCue</a></code>( <var title="">cue</var> )</dt>
    <dd>
     <p>Adds the given cue to <var title="">mutableTimedTrack</var>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>.</p>
-    <!-- XXX exception thrown if the cue is already bound -->
+    <p>Raises an exception if the argument is null, associated with another <a href=#timed-track>timed track</a>, or already in the list of cues.</p>
    </dd>
 
    <dt><var title="">mutableTimedTrack</var> . <code title=dom-MutableTimedTrack-addCue><a href=#dom-mutabletimedtrack-addcue>addCue</a></code>( <var title="">cue</var> )</dt>
    <dd>
     <p>Removes the given cue from <var title="">mutableTimedTrack</var>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>.</p>
-    <!-- XXX exception thrown if it's not there -->
+    <p>Raises an exception if the argument is null, associated with another <a href=#timed-track>timed track</a>, or not in the list of cues.</p>
    </dd>
 
   </dl><div class=impl>
@@ -27087,13 +27088,6 @@ <h6 id=timed-track-api><span class=secno>4.8.10.10.5 </span>Timed track API</h6>
 
   </dl><div class=impl>
 
-<!-- XXX
-   Make sure that <code>TimedTrackCueList</code>s don't change while
-   script is running, except for addCue/removeCue and the removal of
-   all cues in the face of a dynamic track.src change.
-   (right now only in-band cues can change this, I think)
--->
-
   <p class=XXX>...</p>
 
   </div>

diff --git a/index b/index
@@ -24782,8 +24782,9 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
 
      <dd>
 
-      <p>Run the <a href=#steps-to-expose-a-media-resource-specific-timed-track>steps to expose a media-resource-specific timed
-      track</a> with the relevant data.</p>
+      <p><a href=#queue-a-task>Queue a task</a> to run the <a href=#steps-to-expose-a-media-resource-specific-timed-track>steps to expose a
+      media-resource-specific timed track</a> with the relevant
+      data.</p>
 
      </dd>
 <!--TT-->
@@ -26888,13 +26889,13 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
    <dt><var title="">mutableTimedTrack</var> . <code title=dom-MutableTimedTrack-addCue><a href=#dom-mutabletimedtrack-addcue>addCue</a></code>( <var title="">cue</var> )</dt>
    <dd>
     <p>Adds the given cue to <var title="">mutableTimedTrack</var>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>.</p>
-    <!-- XXX exception thrown if the cue is already bound -->
+    <p>Raises an exception if the argument is null, associated with another <a href=#timed-track>timed track</a>, or already in the list of cues.</p>
    </dd>
 
    <dt><var title="">mutableTimedTrack</var> . <code title=dom-MutableTimedTrack-addCue><a href=#dom-mutabletimedtrack-addcue>addCue</a></code>( <var title="">cue</var> )</dt>
    <dd>
     <p>Removes the given cue from <var title="">mutableTimedTrack</var>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>.</p>
-    <!-- XXX exception thrown if it's not there -->
+    <p>Raises an exception if the argument is null, associated with another <a href=#timed-track>timed track</a>, or not in the list of cues.</p>
    </dd>
 
   </dl><div class=impl>
@@ -27014,13 +27015,6 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
 
   </dl><div class=impl>
 
-<!-- XXX
-   Make sure that <code>TimedTrackCueList</code>s don't change while
-   script is running, except for addCue/removeCue and the removal of
-   all cues in the face of a dynamic track.src change.
-   (right now only in-band cues can change this, I think)
--->
-
   <p class=XXX>...</p>
 
   </div>

diff --git a/source b/source
@@ -26758,8 +26758,9 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>
 
      <dd>
 
-      <p>Run the <span>steps to expose a media-resource-specific timed
-      track</span> with the relevant data.</p>
+      <p><span>Queue a task</span> to run the <span>steps to expose a
+      media-resource-specific timed track</span> with the relevant
+      data.</p>
 
      </dd>
 <!--START w3c-html--><!--TT-->
@@ -29216,13 +29217,13 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>
    <dt><var title="">mutableTimedTrack</var> . <code title="dom-MutableTimedTrack-addCue">addCue</code>( <var title="">cue</var> )</dt>
    <dd>
     <p>Adds the given cue to <var title="">mutableTimedTrack</var>'s <span>timed track list of cues</span>.</p>
-    <!-- XXX exception thrown if the cue is already bound -->
+    <p>Raises an exception if the argument is null, associated with another <span>timed track</span>, or already in the list of cues.</p>
    </dd>
 
    <dt><var title="">mutableTimedTrack</var> . <code title="dom-MutableTimedTrack-addCue">addCue</code>( <var title="">cue</var> )</dt>
    <dd>
     <p>Removes the given cue from <var title="">mutableTimedTrack</var>'s <span>timed track list of cues</span>.</p>
-    <!-- XXX exception thrown if it's not there -->
+    <p>Raises an exception if the argument is null, associated with another <span>timed track</span>, or not in the list of cues.</p>
    </dd>
 
   </dl>
@@ -29370,13 +29371,6 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>
 
   <div class="impl">
 
-<!-- XXX
-   Make sure that <code>TimedTrackCueList</code>s don't change while
-   script is running, except for addCue/removeCue and the removal of
-   all cues in the face of a dynamic track.src change.
-   (right now only in-band cues can change this, I think)
--->
-
   <p class="XXX">...</p>
 
   </div>