[html5] r6166 - [e] (0) clarify note about <source>

[whatwg at whatwg.org]

Author: ianh
Date: 2011-05-31 17:27:42 -0700 (Tue, 31 May 2011)
New Revision: 6166

Modified:
   complete.html
   index
   source
Log:
[e] (0) clarify note about <source>

Modified: complete.html
===================================================================
--- complete.html	2011-05-31 23:35:33 UTC (rev 6165)
+++ complete.html	2011-06-01 00:27:42 UTC (rev 6166)
@@ -239,7 +239,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1>Web Applications 1.0</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 31 May 2011</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 1 June 2011</h2>
    </hgroup><dl><dt>Multiple-page version:</dt>
     <dd><a href=http://www.whatwg.org/specs/web-apps/current-work/complete/>http://www.whatwg.org/specs/web-apps/current-work/complete/</a></dd>
     <dt>One-page version:</dt>
@@ -26165,10 +26165,11 @@
   <p class=note>Dynamically modifying a <code><a href=#the-source-element>source</a></code> element
   and its attribute when the element is already inserted in a
   <code><a href=#the-video-element>video</a></code> or <code><a href=#the-audio-element>audio</a></code> element will have no
-  effect. To change what is playing, either just use the <code title=attr-media-src><a href=#attr-media-src>src</a></code> attribute on the <a href=#media-element>media
-  element</a> directly, or call the <code title=dom-media-load><a href=#dom-media-load>load()</a></code> method on the <a href=#media-element>media
-  element</a> after manipulating the <code><a href=#the-source-element>source</a></code>
-  elements.</p>
+  effect. To change what is playing, just use the <code title=attr-media-src><a href=#attr-media-src>src</a></code> attribute on the <a href=#media-element>media
+  element</a> directly, possibly making use of the <code title=dom-navigator-canPlayType><a href=#dom-navigator-canplaytype>canPlayType()</a></code> method to
+  pick from amongst available resources. Generally, manipulating
+  <code><a href=#the-source-element>source</a></code> elements manually after the document has been
+  parsed is an unncessarily complicated approach.</p>
 
   <p>The <dfn id=attr-source-type title=attr-source-type><code>type</code></dfn>
   attribute gives the type of the <a href=#media-resource>media resource</a>, to help

Modified: index
===================================================================
--- index	2011-05-31 23:35:33 UTC (rev 6165)
+++ index	2011-06-01 00:27:42 UTC (rev 6166)
@@ -243,7 +243,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 31 May 2011</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 1 June 2011</h2>
    </hgroup><dl><dt><strong>Web developer edition</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -26154,10 +26154,11 @@
   <p class=note>Dynamically modifying a <code><a href=#the-source-element>source</a></code> element
   and its attribute when the element is already inserted in a
   <code><a href=#the-video-element>video</a></code> or <code><a href=#the-audio-element>audio</a></code> element will have no
-  effect. To change what is playing, either just use the <code title=attr-media-src><a href=#attr-media-src>src</a></code> attribute on the <a href=#media-element>media
-  element</a> directly, or call the <code title=dom-media-load><a href=#dom-media-load>load()</a></code> method on the <a href=#media-element>media
-  element</a> after manipulating the <code><a href=#the-source-element>source</a></code>
-  elements.</p>
+  effect. To change what is playing, just use the <code title=attr-media-src><a href=#attr-media-src>src</a></code> attribute on the <a href=#media-element>media
+  element</a> directly, possibly making use of the <code title=dom-navigator-canPlayType><a href=#dom-navigator-canplaytype>canPlayType()</a></code> method to
+  pick from amongst available resources. Generally, manipulating
+  <code><a href=#the-source-element>source</a></code> elements manually after the document has been
+  parsed is an unncessarily complicated approach.</p>
 
   <p>The <dfn id=attr-source-type title=attr-source-type><code>type</code></dfn>
   attribute gives the type of the <a href=#media-resource>media resource</a>, to help

Modified: source
===================================================================
--- source	2011-05-31 23:35:33 UTC (rev 6165)
+++ source	2011-06-01 00:27:42 UTC (rev 6166)
@@ -28354,12 +28354,13 @@
   <p class="note">Dynamically modifying a <code>source</code> element
   and its attribute when the element is already inserted in a
   <code>video</code> or <code>audio</code> element will have no
-  effect. To change what is playing, either just use the <code
+  effect. To change what is playing, just use the <code
   title="attr-media-src">src</code> attribute on the <span>media
-  element</span> directly, or call the <code
-  title="dom-media-load">load()</code> method on the <span>media
-  element</span> after manipulating the <code>source</code>
-  elements.</p>
+  element</span> directly, possibly making use of the <code
+  title="dom-navigator-canPlayType">canPlayType()</code> method to
+  pick from amongst available resources. Generally, manipulating
+  <code>source</code> elements manually after the document has been
+  parsed is an unncessarily complicated approach.</p>
 
   <p>The <dfn title="attr-source-type"><code>type</code></dfn>
   attribute gives the type of the <span>media resource</span>, to help