[cgiow] (1) Drop <source media> since nobody uses it and it is mostly…

… useless anyway.

Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=19619
Affected topics: DOM APIs, HTML, Video and Audio

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

complete.html

    <dd><a href=#global-attributes>Global attributes</a></dd>
    <dd><code title=attr-source-src><a href=#attr-source-src>src</a></code> &mdash; Address of the resource</dd>
    <dd><code title=attr-source-type><a href=#attr-source-type>type</a></code> &mdash; Type of embedded resource</dd>
-   <dd><code title=attr-source-media><a href=#attr-source-media>media</a></code> &mdash; Applicable media</dd>
    <dt><a href=#element-dfn-dom title=element-dfn-dom>DOM interface</a>:</dt><!--TOPIC:DOM APIs-->
    <dd>
 <pre class=idl>interface <dfn id=htmlsourceelement>HTMLSourceElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
            attribute DOMString <a href=#dom-source-src title=dom-source-src>src</a>;
            attribute DOMString <a href=#dom-source-type title=dom-source-type>type</a>;
-           attribute DOMString <a href=#dom-source-media title=dom-source-media>media</a>;
 };</pre>
    </dd>
   </dl><!--TOPIC:HTML--><p>The <code><a href=#the-source-element>source</a></code> element allows authors to specify multiple alternative <a href=#media-resource title="media resource">media resources</a> for <a href=#media-element title="media element">media
 
    </dl></div>
 
-  <p>The <dfn id=attr-source-media title=attr-source-media><code>media</code></dfn> attribute gives the intended media
-  type of the <a href=#media-resource>media resource</a>, to help the user agent determine if this <a href=#media-resource>media
-  resource</a> is useful to the user before fetching it. Its value must be a <a href=#valid-media-query>valid media
-  query</a>.</p>
-
-  <!-- for similar paragraphs, search for "The default, if the" -->
-  <p id=source-default-media class=note>The <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource
-  selection algorithm</a> is defined in such a way that when the <code title=attr-source-media><a href=#attr-source-media>media</a></code> attribute is omitted the user agent acts the same as if the
-  value was "<code title="">all</code>", i.e. by default the <a href=#media-resource>media resource</a> is suitable
-  for all media.</p>
-
   <div class=impl>
 
   <p>If a <code><a href=#the-source-element>source</a></code> element is inserted as a child of a <a href=#media-element>media element</a> that
   has no <code title=attr-media-src><a href=#attr-media-src>src</a></code> attribute and whose <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> has the value <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code>, the user agent must invoke the <a href=#media-element>media
   element</a>'s <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource selection
   algorithm</a>.</p>
 
-  <p>The IDL attributes <dfn id=dom-source-src title=dom-source-src><code>src</code></dfn>, <dfn id=dom-source-type title=dom-source-type><code>type</code></dfn>, and <dfn id=dom-source-media title=dom-source-media><code>media</code></dfn> must <a href=#reflect>reflect</a> the respective content
+  <p>The IDL attributes <dfn id=dom-source-src title=dom-source-src><code>src</code></dfn> and <dfn id=dom-source-type title=dom-source-type><code>type</code></dfn> must <a href=#reflect>reflect</a> the respective content
   attributes of the same name.</p>
 
   </div>
      types that define that parameter), represents <a href=#a-type-that-the-user-agent-knows-it-cannot-render>a type that the user agent knows it cannot
      render</a>, then end the <a href=#synchronous-section>synchronous section</a>, and jump down to the <i title="">failed with elements</i> step below.</li>
 
-     <li><p>&#x231b; If <var title="">candidate</var> has a <code title=attr-source-media><a href=#attr-source-media>media</a></code> attribute whose value does not <a href=#matches-the-environment title="matches the
-     environment">match the environment</a>, then end the <a href=#synchronous-section>synchronous section</a>, and
-     jump down to the <i title="">failed with elements</i> step below.</li>
-
      <li><p>&#x231b; Set the <code title=dom-media-currentSrc><a href=#dom-media-currentsrc>currentSrc</a></code> attribute to <var title="">absolute URL</var>.</li>
 
      <li><p>End the <a href=#synchronous-section>synchronous section</a>, continuing the remaining steps
    <dt><dfn id=attr-script-for title=attr-script-for><code>for</code></dfn> on <code><a href=#the-script-element>script</a></code> elements</dt>
    <dd><p>Use DOM Events mechanisms to register event listeners. <a href=#refsDOM>[DOM]</a></dd>
 
+   <dt><dfn id=attr-source-media title=attr-source-media><code>media</code></dfn> on <code><a href=#the-source-element>source</a></code> elements</dt>
+   <dd><p>Use script to select the media resource(s) to use.</dd>
+
    <dt><dfn id=attr-table-datapagesize title=attr-table-datapagesize><code>datapagesize</code></dfn> on <code><a href=#the-table-element>table</a></code> elements</dt>
    <dd><p>Unnecessary. Omit it altogether.</dd>
 
      <td>empty</td>
      <td><a href=#global-attributes title="global attributes">globals</a>;
          <code title=attr-source-src><a href=#attr-source-src>src</a></code>;
-         <code title=attr-source-type><a href=#attr-source-type>type</a></code>;
-         <code title=attr-source-media><a href=#attr-source-media>media</a></code></td>
+         <code title=attr-source-type><a href=#attr-source-type>type</a></code></td>
      <td><code><a href=#htmlsourceelement>HTMLSourceElement</a></code></td>
     <tr><th><code><a href=#the-span-element>span</a></code></th>
      <td>Generic phrasing container</td>
      <td> <a href=#valid-non-negative-integer>Valid non-negative integer</a>
     <tr><th> <code title="">media</code>
      <td> <code title=attr-link-media><a href=#attr-link-media>link</a></code>;
-          <code title=attr-source-media><a href=#attr-source-media>source</a></code>;
           <code title=attr-style-media><a href=#attr-style-media>style</a></code>
      <td> Applicable media
      <td> <a href=#valid-media-query>Valid media query</a>

index

    <dd><a href=#global-attributes>Global attributes</a></dd>
    <dd><code title=attr-source-src><a href=#attr-source-src>src</a></code> &mdash; Address of the resource</dd>
    <dd><code title=attr-source-type><a href=#attr-source-type>type</a></code> &mdash; Type of embedded resource</dd>
-   <dd><code title=attr-source-media><a href=#attr-source-media>media</a></code> &mdash; Applicable media</dd>
    <dt><a href=#element-dfn-dom title=element-dfn-dom>DOM interface</a>:</dt><!--TOPIC:DOM APIs-->
    <dd>
 <pre class=idl>interface <dfn id=htmlsourceelement>HTMLSourceElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
            attribute DOMString <a href=#dom-source-src title=dom-source-src>src</a>;
            attribute DOMString <a href=#dom-source-type title=dom-source-type>type</a>;
-           attribute DOMString <a href=#dom-source-media title=dom-source-media>media</a>;
 };</pre>
    </dd>
   </dl><!--TOPIC:HTML--><p>The <code><a href=#the-source-element>source</a></code> element allows authors to specify multiple alternative <a href=#media-resource title="media resource">media resources</a> for <a href=#media-element title="media element">media
 
    </dl></div>
 
-  <p>The <dfn id=attr-source-media title=attr-source-media><code>media</code></dfn> attribute gives the intended media
-  type of the <a href=#media-resource>media resource</a>, to help the user agent determine if this <a href=#media-resource>media
-  resource</a> is useful to the user before fetching it. Its value must be a <a href=#valid-media-query>valid media
-  query</a>.</p>
-
-  <!-- for similar paragraphs, search for "The default, if the" -->
-  <p id=source-default-media class=note>The <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource
-  selection algorithm</a> is defined in such a way that when the <code title=attr-source-media><a href=#attr-source-media>media</a></code> attribute is omitted the user agent acts the same as if the
-  value was "<code title="">all</code>", i.e. by default the <a href=#media-resource>media resource</a> is suitable
-  for all media.</p>
-
   <div class=impl>
 
   <p>If a <code><a href=#the-source-element>source</a></code> element is inserted as a child of a <a href=#media-element>media element</a> that
   has no <code title=attr-media-src><a href=#attr-media-src>src</a></code> attribute and whose <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> has the value <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code>, the user agent must invoke the <a href=#media-element>media
   element</a>'s <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource selection
   algorithm</a>.</p>
 
-  <p>The IDL attributes <dfn id=dom-source-src title=dom-source-src><code>src</code></dfn>, <dfn id=dom-source-type title=dom-source-type><code>type</code></dfn>, and <dfn id=dom-source-media title=dom-source-media><code>media</code></dfn> must <a href=#reflect>reflect</a> the respective content
+  <p>The IDL attributes <dfn id=dom-source-src title=dom-source-src><code>src</code></dfn> and <dfn id=dom-source-type title=dom-source-type><code>type</code></dfn> must <a href=#reflect>reflect</a> the respective content
   attributes of the same name.</p>
 
   </div>
      types that define that parameter), represents <a href=#a-type-that-the-user-agent-knows-it-cannot-render>a type that the user agent knows it cannot
      render</a>, then end the <a href=#synchronous-section>synchronous section</a>, and jump down to the <i title="">failed with elements</i> step below.</li>
 
-     <li><p>&#x231b; If <var title="">candidate</var> has a <code title=attr-source-media><a href=#attr-source-media>media</a></code> attribute whose value does not <a href=#matches-the-environment title="matches the
-     environment">match the environment</a>, then end the <a href=#synchronous-section>synchronous section</a>, and
-     jump down to the <i title="">failed with elements</i> step below.</li>
-
      <li><p>&#x231b; Set the <code title=dom-media-currentSrc><a href=#dom-media-currentsrc>currentSrc</a></code> attribute to <var title="">absolute URL</var>.</li>
 
      <li><p>End the <a href=#synchronous-section>synchronous section</a>, continuing the remaining steps
    <dt><dfn id=attr-script-for title=attr-script-for><code>for</code></dfn> on <code><a href=#the-script-element>script</a></code> elements</dt>
    <dd><p>Use DOM Events mechanisms to register event listeners. <a href=#refsDOM>[DOM]</a></dd>
 
+   <dt><dfn id=attr-source-media title=attr-source-media><code>media</code></dfn> on <code><a href=#the-source-element>source</a></code> elements</dt>
+   <dd><p>Use script to select the media resource(s) to use.</dd>
+
    <dt><dfn id=attr-table-datapagesize title=attr-table-datapagesize><code>datapagesize</code></dfn> on <code><a href=#the-table-element>table</a></code> elements</dt>
    <dd><p>Unnecessary. Omit it altogether.</dd>
 
      <td>empty</td>
      <td><a href=#global-attributes title="global attributes">globals</a>;
          <code title=attr-source-src><a href=#attr-source-src>src</a></code>;
-         <code title=attr-source-type><a href=#attr-source-type>type</a></code>;
-         <code title=attr-source-media><a href=#attr-source-media>media</a></code></td>
+         <code title=attr-source-type><a href=#attr-source-type>type</a></code></td>
      <td><code><a href=#htmlsourceelement>HTMLSourceElement</a></code></td>
     <tr><th><code><a href=#the-span-element>span</a></code></th>
      <td>Generic phrasing container</td>
      <td> <a href=#valid-non-negative-integer>Valid non-negative integer</a>
     <tr><th> <code title="">media</code>
      <td> <code title=attr-link-media><a href=#attr-link-media>link</a></code>;
-          <code title=attr-source-media><a href=#attr-source-media>source</a></code>;
           <code title=attr-style-media><a href=#attr-style-media>style</a></code>
      <td> Applicable media
      <td> <a href=#valid-media-query>Valid media query</a>

source

    <dd><span>Global attributes</span></dd>
    <dd><code data-x="attr-source-src">src</code></dd>
    <dd><code data-x="attr-source-type">type</code></dd>
-   <dd><code data-x="attr-source-media">media</code></dd>
    <dt><span data-x="element-dfn-dom">DOM interface</span>:</dt><!--TOPIC:DOM APIs-->
    <dd>
 <pre class="idl">interface <dfn>HTMLSourceElement</dfn> : <span>HTMLElement</span> {
            attribute DOMString <span data-x="dom-source-src">src</span>;
            attribute DOMString <span data-x="dom-source-type">type</span>;
-           attribute DOMString <span data-x="dom-source-media">media</span>;
 };</pre>
    </dd>
   </dl><!--TOPIC:HTML-->
 
   </div>
 
-  <p>The <dfn data-x="attr-source-media"><code>media</code></dfn> attribute gives the intended media
-  type of the <span>media resource</span>, to help the user agent determine if this <span>media
-  resource</span> is useful to the user before fetching it. Its value must be a <span>valid media
-  query</span>.</p>
-
-  <!-- for similar paragraphs, search for "The default, if the" -->
-  <p id="source-default-media" class="note">The <span data-x="concept-media-load-algorithm">resource
-  selection algorithm</span> is defined in such a way that when the <code
-  data-x="attr-source-media">media</code> attribute is omitted the user agent acts the same as if the
-  value was "<code data-x="">all</code>", i.e. by default the <span>media resource</span> is suitable
-  for all media.</p>
-
   <div class="impl">
 
   <p>If a <code>source</code> element is inserted as a child of a <span>media element</span> that
   element</span>'s <span data-x="concept-media-load-algorithm">resource selection
   algorithm</span>.</p>
 
-  <p>The IDL attributes <dfn data-x="dom-source-src"><code>src</code></dfn>, <dfn
-  data-x="dom-source-type"><code>type</code></dfn>, and <dfn
-  data-x="dom-source-media"><code>media</code></dfn> must <span>reflect</span> the respective content
+  <p>The IDL attributes <dfn data-x="dom-source-src"><code>src</code></dfn> and <dfn
+  data-x="dom-source-type"><code>type</code></dfn> must <span>reflect</span> the respective content
   attributes of the same name.</p>
 
   </div>
      render</span>, then end the <span>synchronous section</span>, and jump down to the <i
      data-x="">failed with elements</i> step below.</p></li>
 
-     <li><p>&#x231B; If <var data-x="">candidate</var> has a <code
-     data-x="attr-source-media">media</code> attribute whose value does not <span data-x="matches the
-     environment">match the environment</span>, then end the <span>synchronous section</span>, and
-     jump down to the <i data-x="">failed with elements</i> step below.</p></li>
-
      <li><p>&#x231B; Set the <code data-x="dom-media-currentSrc">currentSrc</code> attribute to <var
      data-x="">absolute URL</var>.</p></li>
 
    <dt><dfn data-x="attr-script-for"><code>for</code></dfn> on <code>script</code> elements</dt>
    <dd><p>Use DOM Events mechanisms to register event listeners. <a href="#refsDOM">[DOM]</a></p></dd>
 
+   <dt><dfn data-x="attr-source-media"><code>media</code></dfn> on <code>source</code> elements</dt>
+   <dd><p>Use script to select the media resource(s) to use.</p></dd>
+
    <dt><dfn data-x="attr-table-datapagesize"><code>datapagesize</code></dfn> on <code>table</code> elements</dt>
    <dd><p>Unnecessary. Omit it altogether.</p></dd>
 
      <td>empty</td>
      <td><span data-x="global attributes">globals</span>;
          <code data-x="attr-source-src">src</code>;
-         <code data-x="attr-source-type">type</code>;
-         <code data-x="attr-source-media">media</code></td>
+         <code data-x="attr-source-type">type</code></td>
      <td><code>HTMLSourceElement</code></td>
     </tr>
 
     <tr>
      <th> <code data-x="">media</code>
      <td> <code data-x="attr-link-media">link</code>;
-          <code data-x="attr-source-media">source</code>;
           <code data-x="attr-style-media">style</code>
      <td> Applicable media
      <td> <span>Valid media query</span>