[giow] (0) Add onaddtrack to all the TrackList interfaces. Also, make…

… the text that introduces event handler IDL attributes more consistent across the spec.

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

git-svn-id: http://svn.whatwg.org/webapps@6607 340c8d12-0b0e-0410-8428-c7bf67bfef74

complete.html

   readonly attribute unsigned long <a href=#dom-audiotracklist-length title=dom-AudioTrackList-length>length</a>;
   getter <a href=#audiotrack>AudioTrack</a> (unsigned long index);
   <a href=#audiotrack>AudioTrack</a>? <a href=#dom-audiotracklist-gettrackbyid title=dom-AudioTrackList-getTrackById>getTrackById</a>(DOMString id);
+
   [TreatNonCallableAsNull] attribute <a href=#function>Function</a>? <a href=#handler-tracklist-onchange title=handler-TrackList-onchange>onchange</a>;
+  [TreatNonCallableAsNull] attribute <a href=#function>Function</a>? <a href=#handler-tracklist-onaddtrack title=handler-TrackList-onaddtrack>onaddtrack</a>;
 };
 
 interface <dfn id=audiotrack>AudioTrack</dfn> {
   getter <a href=#videotrack>VideoTrack</a> (unsigned long index);
   <a href=#videotrack>VideoTrack</a>? <a href=#dom-videotracklist-gettrackbyid title=dom-VideoTrackList-getTrackById>getTrackById</a>(DOMString id);
   readonly attribute long <a href=#dom-videotracklist-selectedindex title=dom-VideoTrackList-selectedIndex>selectedIndex</a>;
+
   [TreatNonCallableAsNull] attribute <a href=#function>Function</a>? <a href=#handler-tracklist-onchange title=handler-TrackList-onchange>onchange</a>;
+  [TreatNonCallableAsNull] attribute <a href=#function>Function</a>? <a href=#handler-tracklist-onaddtrack title=handler-TrackList-onaddtrack>onaddtrack</a>;
 };
 
 interface <dfn id=videotrack>VideoTrack</dfn> {
 
   <table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
    <tbody><tr><td><dfn id=handler-tracklist-onchange title=handler-TrackList-onchange><code>onchange</code></dfn> <td> <code title=event-change>change</code>
+    <tr><td><dfn id=handler-tracklist-onaddtrack title=handler-TrackList-onaddtrack><code>onaddtrack</code></dfn> <td> <code title=event-addtrack>addtrack</code>
   </table><hr><p>The <a href=#task-source>task source</a> for the <a href=#concept-task title=concept-task>tasks</a> listed in this section is the
   <a href=#dom-manipulation-task-source>DOM manipulation task source</a>.</p>
 
    reported playback state</a> be <var title="">new playback
    state</var>.</li>
 
-  </ol><hr><p>The following are the <a href=#event-handlers>event handlers</a> that must be
-  supported, as IDL attributes, by all objects implementing the
-  <code><a href=#mediacontroller>MediaController</a></code> interface:</p>
+  </ol><hr><p>The following are the <a href=#event-handlers>event handlers</a> (and their
+  corresponding <a href=#event-handler-event-type title="event handler event type">event handler
+  event types</a>) that must be supported, as IDL attributes, by
+  all objects implementing the <code><a href=#mediacontroller>MediaController</a></code>
+  interface:</p>
 
   <table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
    <tbody><tr><td><dfn id=handler-mediacontroller-onemptied title=handler-MediaController-onemptied><code>onemptied</code></dfn> <td> <code title=event-MediaController-emptied><a href=#event-mediacontroller-emptied>emptied</a></code>
   <pre class=idl>interface <dfn id=texttracklist>TextTrackList</dfn> {
   readonly attribute unsigned long <a href=#dom-texttracklist-length title=dom-TextTrackList-length>length</a>;
   getter <a href=#texttrack>TextTrack</a> (unsigned long index);
+
+  [TreatNonCallableAsNull] attribute <a href=#function>Function</a>? <a href=#handler-texttracklist-onaddtrack title=handler-TextTrackList-onaddtrack>onaddtrack</a>;
 };</pre>
 
   <dl class=domintro><dt><var title="">media</var> . <code title=dom-media-textTracks><a href=#dom-media-texttracks>textTracks</a></code> . <code title="">length</code></dt>
 
   <h6 id=cue-events><span class=secno>4.8.10.12.7 </span>Event definitions</h6>
 
-  <p>The following are the <a href=#event-handlers>event handlers</a> that must be
+  <p>The following are the <a href=#event-handlers>event handlers</a> that (and their
+  corresponding <a href=#event-handler-event-type title="event handler event type">event handler
+  event types</a>) must be
   supported, as IDL attributes, by all objects implementing the
-  <code><a href=#texttrack>TextTrack</a></code> interface:</p>
+  <code><a href=#texttracklist>TextTrackList</a></code> interface:</p>
+
+  <table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
+   <tbody><tr><td><dfn id=handler-texttracklist-onaddtrack title=handler-TextTrackList-onaddtrack><code>onaddtrack</code></dfn> <td> <code title=event-addtrack>addtrack</code>
+  </table><p>The following are the <a href=#event-handlers>event handlers</a> that (and their
+  corresponding <a href=#event-handler-event-type title="event handler event type">event handler
+  event types</a>) must be supported, as IDL attributes, by all
+  objects implementing the <code><a href=#texttrack>TextTrack</a></code> interface:</p>
 
   <table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
    <tbody><tr><td><dfn id=handler-texttrack-onload title=handler-TextTrack-onload><code>onload</code></dfn> <td> <code title=event-load>load</code>
     <tr><td><dfn id=handler-texttrack-onerror title=handler-TextTrack-onerror><code>onerror</code></dfn> <td> <code title=event-error>error</code>
     <tr><td><dfn id=handler-texttrack-oncuechange title=handler-TextTrack-oncuechange><code>oncuechange</code></dfn> <td> <code title=event-cuechange>cuechange</code>
-  </table><p>The following are the <a href=#event-handlers>event handlers</a> that must be
-  supported, as IDL attributes, by all objects implementing the
-  <code><a href=#texttrackcue>TextTrackCue</a></code> interface:</p>
+  </table><p>The following are the <a href=#event-handlers>event handlers</a> that (and their
+  corresponding <a href=#event-handler-event-type title="event handler event type">event handler
+  event types</a>) must be supported, as IDL attributes, by all
+  objects implementing the <code><a href=#texttrackcue>TextTrackCue</a></code> interface:</p>
 
   <table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
    <tbody><tr><td><dfn id=handler-texttrackcue-onenter title=handler-TextTrackCue-onenter><code>onenter</code></dfn> <td> <code title=event-enter>enter</code>
 
    </dd>
 
-  </dl><hr><p>The following are the <a href=#event-handlers>event handlers</a> that must be
-  supported, as IDL attributes, by all objects implementing the
-  <code><a href=#websocket>WebSocket</a></code> interface:</p>
+  </dl><hr><p>The following are the <a href=#event-handlers>event handlers</a> (and their
+  corresponding <a href=#event-handler-event-type title="event handler event type">event handler
+  event types</a>) that must be supported, as IDL attributes, by
+  all objects implementing the <code><a href=#websocket>WebSocket</a></code> interface:</p>
 
   <table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
    <tbody><tr><td><dfn id=handler-websocket-onopen title=handler-WebSocket-onopen><code>onopen</code></dfn> <td> <code title=event-open>open</code>

index

   readonly attribute unsigned long <a href=#dom-audiotracklist-length title=dom-AudioTrackList-length>length</a>;
   getter <a href=#audiotrack>AudioTrack</a> (unsigned long index);
   <a href=#audiotrack>AudioTrack</a>? <a href=#dom-audiotracklist-gettrackbyid title=dom-AudioTrackList-getTrackById>getTrackById</a>(DOMString id);
+
   [TreatNonCallableAsNull] attribute <a href=#function>Function</a>? <a href=#handler-tracklist-onchange title=handler-TrackList-onchange>onchange</a>;
+  [TreatNonCallableAsNull] attribute <a href=#function>Function</a>? <a href=#handler-tracklist-onaddtrack title=handler-TrackList-onaddtrack>onaddtrack</a>;
 };
 
 interface <dfn id=audiotrack>AudioTrack</dfn> {
   getter <a href=#videotrack>VideoTrack</a> (unsigned long index);
   <a href=#videotrack>VideoTrack</a>? <a href=#dom-videotracklist-gettrackbyid title=dom-VideoTrackList-getTrackById>getTrackById</a>(DOMString id);
   readonly attribute long <a href=#dom-videotracklist-selectedindex title=dom-VideoTrackList-selectedIndex>selectedIndex</a>;
+
   [TreatNonCallableAsNull] attribute <a href=#function>Function</a>? <a href=#handler-tracklist-onchange title=handler-TrackList-onchange>onchange</a>;
+  [TreatNonCallableAsNull] attribute <a href=#function>Function</a>? <a href=#handler-tracklist-onaddtrack title=handler-TrackList-onaddtrack>onaddtrack</a>;
 };
 
 interface <dfn id=videotrack>VideoTrack</dfn> {
 
   <table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
    <tbody><tr><td><dfn id=handler-tracklist-onchange title=handler-TrackList-onchange><code>onchange</code></dfn> <td> <code title=event-change>change</code>
+    <tr><td><dfn id=handler-tracklist-onaddtrack title=handler-TrackList-onaddtrack><code>onaddtrack</code></dfn> <td> <code title=event-addtrack>addtrack</code>
   </table><hr><p>The <a href=#task-source>task source</a> for the <a href=#concept-task title=concept-task>tasks</a> listed in this section is the
   <a href=#dom-manipulation-task-source>DOM manipulation task source</a>.</p>
 
    reported playback state</a> be <var title="">new playback
    state</var>.</li>
 
-  </ol><hr><p>The following are the <a href=#event-handlers>event handlers</a> that must be
-  supported, as IDL attributes, by all objects implementing the
-  <code><a href=#mediacontroller>MediaController</a></code> interface:</p>
+  </ol><hr><p>The following are the <a href=#event-handlers>event handlers</a> (and their
+  corresponding <a href=#event-handler-event-type title="event handler event type">event handler
+  event types</a>) that must be supported, as IDL attributes, by
+  all objects implementing the <code><a href=#mediacontroller>MediaController</a></code>
+  interface:</p>
 
   <table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
    <tbody><tr><td><dfn id=handler-mediacontroller-onemptied title=handler-MediaController-onemptied><code>onemptied</code></dfn> <td> <code title=event-MediaController-emptied><a href=#event-mediacontroller-emptied>emptied</a></code>
   <pre class=idl>interface <dfn id=texttracklist>TextTrackList</dfn> {
   readonly attribute unsigned long <a href=#dom-texttracklist-length title=dom-TextTrackList-length>length</a>;
   getter <a href=#texttrack>TextTrack</a> (unsigned long index);
+
+  [TreatNonCallableAsNull] attribute <a href=#function>Function</a>? <a href=#handler-texttracklist-onaddtrack title=handler-TextTrackList-onaddtrack>onaddtrack</a>;
 };</pre>
 
   <dl class=domintro><dt><var title="">media</var> . <code title=dom-media-textTracks><a href=#dom-media-texttracks>textTracks</a></code> . <code title="">length</code></dt>
 
   <h6 id=cue-events><span class=secno>4.8.10.12.7 </span>Event definitions</h6>
 
-  <p>The following are the <a href=#event-handlers>event handlers</a> that must be
+  <p>The following are the <a href=#event-handlers>event handlers</a> that (and their
+  corresponding <a href=#event-handler-event-type title="event handler event type">event handler
+  event types</a>) must be
   supported, as IDL attributes, by all objects implementing the
-  <code><a href=#texttrack>TextTrack</a></code> interface:</p>
+  <code><a href=#texttracklist>TextTrackList</a></code> interface:</p>
+
+  <table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
+   <tbody><tr><td><dfn id=handler-texttracklist-onaddtrack title=handler-TextTrackList-onaddtrack><code>onaddtrack</code></dfn> <td> <code title=event-addtrack>addtrack</code>
+  </table><p>The following are the <a href=#event-handlers>event handlers</a> that (and their
+  corresponding <a href=#event-handler-event-type title="event handler event type">event handler
+  event types</a>) must be supported, as IDL attributes, by all
+  objects implementing the <code><a href=#texttrack>TextTrack</a></code> interface:</p>
 
   <table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
    <tbody><tr><td><dfn id=handler-texttrack-onload title=handler-TextTrack-onload><code>onload</code></dfn> <td> <code title=event-load>load</code>
     <tr><td><dfn id=handler-texttrack-onerror title=handler-TextTrack-onerror><code>onerror</code></dfn> <td> <code title=event-error>error</code>
     <tr><td><dfn id=handler-texttrack-oncuechange title=handler-TextTrack-oncuechange><code>oncuechange</code></dfn> <td> <code title=event-cuechange>cuechange</code>
-  </table><p>The following are the <a href=#event-handlers>event handlers</a> that must be
-  supported, as IDL attributes, by all objects implementing the
-  <code><a href=#texttrackcue>TextTrackCue</a></code> interface:</p>
+  </table><p>The following are the <a href=#event-handlers>event handlers</a> that (and their
+  corresponding <a href=#event-handler-event-type title="event handler event type">event handler
+  event types</a>) must be supported, as IDL attributes, by all
+  objects implementing the <code><a href=#texttrackcue>TextTrackCue</a></code> interface:</p>
 
   <table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
    <tbody><tr><td><dfn id=handler-texttrackcue-onenter title=handler-TextTrackCue-onenter><code>onenter</code></dfn> <td> <code title=event-enter>enter</code>

source

   readonly attribute unsigned long <span title="dom-AudioTrackList-length">length</span>;
   getter <span>AudioTrack</span> (unsigned long index);
   <span>AudioTrack</span>? <span title="dom-AudioTrackList-getTrackById">getTrackById</span>(DOMString id);
+
   [TreatNonCallableAsNull] attribute <span>Function</span>? <span title="handler-TrackList-onchange">onchange</span>;
+  [TreatNonCallableAsNull] attribute <span>Function</span>? <span title="handler-TrackList-onaddtrack">onaddtrack</span>;
 };
 
 interface <dfn>AudioTrack</dfn> {
   getter <span>VideoTrack</span> (unsigned long index);
   <span>VideoTrack</span>? <span title="dom-VideoTrackList-getTrackById">getTrackById</span>(DOMString id);
   readonly attribute long <span title="dom-VideoTrackList-selectedIndex">selectedIndex</span>;
+
   [TreatNonCallableAsNull] attribute <span>Function</span>? <span title="handler-TrackList-onchange">onchange</span>;
+  [TreatNonCallableAsNull] attribute <span>Function</span>? <span title="handler-TrackList-onaddtrack">onaddtrack</span>;
 };
 
 interface <dfn>VideoTrack</dfn> {
     <tr><th><span title="event handlers">Event handler</span> <th><span>Event handler event type</span>
    <tbody>
     <tr><td><dfn title="handler-TrackList-onchange"><code>onchange</code></dfn> <td> <code title="event-change">change</code>
+    <tr><td><dfn title="handler-TrackList-onaddtrack"><code>onaddtrack</code></dfn> <td> <code title="event-addtrack">addtrack</code>
   </table>
 
   <hr>
 
   <hr>
 
-  <p>The following are the <span>event handlers</span> that must be
-  supported, as IDL attributes, by all objects implementing the
-  <code>MediaController</code> interface:</p>
+  <p>The following are the <span>event handlers</span> (and their
+  corresponding <span title="event handler event type">event handler
+  event types</span>) that must be supported, as IDL attributes, by
+  all objects implementing the <code>MediaController</code>
+  interface:</p>
 
   <table>
    <thead>
   <pre class="idl">interface <dfn>TextTrackList</dfn> {
   readonly attribute unsigned long <span title="dom-TextTrackList-length">length</span>;
   getter <span>TextTrack</span> (unsigned long index);
+
+  [TreatNonCallableAsNull] attribute <span>Function</span>? <span title="handler-TextTrackList-onaddtrack">onaddtrack</span>;
 };</pre>
 
   <dl class="domintro">
 
   <h6 id="cue-events">Event definitions</h6>
 
-  <p>The following are the <span>event handlers</span> that must be
+  <p>The following are the <span>event handlers</span> that (and their
+  corresponding <span title="event handler event type">event handler
+  event types</span>) must be
   supported, as IDL attributes, by all objects implementing the
-  <code>TextTrack</code> interface:</p>
+  <code>TextTrackList</code> interface:</p>
+
+  <table>
+   <thead>
+    <tr><th><span title="event handlers">Event handler</span> <th><span>Event handler event type</span>
+   <tbody>
+    <tr><td><dfn title="handler-TextTrackList-onaddtrack"><code>onaddtrack</code></dfn> <td> <code title="event-addtrack">addtrack</code>
+  </table>
+
+  <p>The following are the <span>event handlers</span> that (and their
+  corresponding <span title="event handler event type">event handler
+  event types</span>) must be supported, as IDL attributes, by all
+  objects implementing the <code>TextTrack</code> interface:</p>
 
   <table>
    <thead>
     <tr><td><dfn title="handler-TextTrack-oncuechange"><code>oncuechange</code></dfn> <td> <code title="event-cuechange">cuechange</code>
   </table>
 
-  <p>The following are the <span>event handlers</span> that must be
-  supported, as IDL attributes, by all objects implementing the
-  <code>TextTrackCue</code> interface:</p>
+  <p>The following are the <span>event handlers</span> that (and their
+  corresponding <span title="event handler event type">event handler
+  event types</span>) must be supported, as IDL attributes, by all
+  objects implementing the <code>TextTrackCue</code> interface:</p>
 
   <table>
    <thead>
 
   <hr>
 
-  <p>The following are the <span>event handlers</span> that must be
-  supported, as IDL attributes, by all objects implementing the
-  <code>WebSocket</code> interface:</p>
+  <p>The following are the <span>event handlers</span> (and their
+  corresponding <span title="event handler event type">event handler
+  event types</span>) that must be supported, as IDL attributes, by
+  all objects implementing the <code>WebSocket</code> interface:</p>
 
   <table>
    <thead>