[html5] r6287 - [] (0) Add more note material around .label to clarify it.

[whatwg at whatwg.org]

Author: ianh
Date: 2011-07-11 15:34:50 -0700 (Mon, 11 Jul 2011)
New Revision: 6287

Modified:
   complete.html
   index
   source
Log:
[] (0) Add more note material around .label to clarify it.

Modified: complete.html
===================================================================
--- complete.html	2011-07-11 21:21:03 UTC (rev 6286)
+++ complete.html	2011-07-11 22:34:50 UTC (rev 6287)
@@ -75547,7 +75547,7 @@
   <p>The <dfn id=dom-mediastream title=dom-MediaStream><code>MediaStream(<var title="">parentStream</var>)</code></dfn> constructor must return a
   new <code><a href=#mediastream>MediaStream</a></code> object whose tracks at any moment in
   time are the enabled tracks of <var title="">parentStream</var> at
-  that moment.</p>
+  that moment, and whose <code title=dom-MediaStream-label><a href=#dom-mediastream-label>label</a></code> is equal to the <var title="">parentStream</var>'s.</p>
 
   <p>The <dfn id=dom-mediastream-readystate title=dom-MediaStream-readyState><code>readyState</code></dfn>
   attribute represents the state of the stream. It must return the
@@ -75622,10 +75622,27 @@
   information provided by the remote source.</p> <!-- described below
   -->
 
+  <p>When a <code><a href=#mediastream>MediaStream</a></code> is created from another using the
+  <code title=dom-MediaStream><a href=#dom-mediastream>MediaStream()</a></code> constructor, the
+  <code title=dom-MediaStream-label><a href=#dom-mediastream-label>label</a></code> attribute is
+  initialized from the original.</p> <!-- described above -->
+
   <p>The <dfn id=dom-mediastream-label title=dom-MediaStream-label><code>label</code></dfn>
   attribute must return the value to which it was initialized when the
   object was created.</p>
 
+  <p class=note>The label of a <code><a href=#mediastream>MediaStream</a></code> object is
+  unique to the source of the stream, but that does not mean it is not
+  possible to end up with duplicates. For example, when a
+  <code><a href=#mediastream>MediaStream</a></code> object is created from another using the
+  <code title=dom-MediaStream><a href=#dom-mediastream>MediaStream()</a></code> constructor, the
+  fork has the same label as the original. Similarly, a locally
+  generated stream could be sent from one user to a remote peer using
+  <code><a href=#peerconnection>PeerConnection</a></code>, and then sent back to the original user
+  in the same manner, in which case the original user will have
+  multiple streams with the same label (the locally-generated one and
+  the one received from the remote peer).</p>
+
   <hr><p>When the <dfn id=dom-mediastream-record title=dom-MediaStream-record><code>record()</code></dfn> method is
   invoked, the user agent must return a new
   <code><a href=#mediastreamrecorder>MediaStreamRecorder</a></code> object associated with the stream.</p>

Modified: index
===================================================================
--- index	2011-07-11 21:21:03 UTC (rev 6286)
+++ index	2011-07-11 22:34:50 UTC (rev 6287)
@@ -75445,7 +75445,7 @@
   <p>The <dfn id=dom-mediastream title=dom-MediaStream><code>MediaStream(<var title="">parentStream</var>)</code></dfn> constructor must return a
   new <code><a href=#mediastream>MediaStream</a></code> object whose tracks at any moment in
   time are the enabled tracks of <var title="">parentStream</var> at
-  that moment.</p>
+  that moment, and whose <code title=dom-MediaStream-label><a href=#dom-mediastream-label>label</a></code> is equal to the <var title="">parentStream</var>'s.</p>
 
   <p>The <dfn id=dom-mediastream-readystate title=dom-MediaStream-readyState><code>readyState</code></dfn>
   attribute represents the state of the stream. It must return the
@@ -75520,10 +75520,27 @@
   information provided by the remote source.</p> <!-- described below
   -->
 
+  <p>When a <code><a href=#mediastream>MediaStream</a></code> is created from another using the
+  <code title=dom-MediaStream><a href=#dom-mediastream>MediaStream()</a></code> constructor, the
+  <code title=dom-MediaStream-label><a href=#dom-mediastream-label>label</a></code> attribute is
+  initialized from the original.</p> <!-- described above -->
+
   <p>The <dfn id=dom-mediastream-label title=dom-MediaStream-label><code>label</code></dfn>
   attribute must return the value to which it was initialized when the
   object was created.</p>
 
+  <p class=note>The label of a <code><a href=#mediastream>MediaStream</a></code> object is
+  unique to the source of the stream, but that does not mean it is not
+  possible to end up with duplicates. For example, when a
+  <code><a href=#mediastream>MediaStream</a></code> object is created from another using the
+  <code title=dom-MediaStream><a href=#dom-mediastream>MediaStream()</a></code> constructor, the
+  fork has the same label as the original. Similarly, a locally
+  generated stream could be sent from one user to a remote peer using
+  <code><a href=#peerconnection>PeerConnection</a></code>, and then sent back to the original user
+  in the same manner, in which case the original user will have
+  multiple streams with the same label (the locally-generated one and
+  the one received from the remote peer).</p>
+
   <hr><p>When the <dfn id=dom-mediastream-record title=dom-MediaStream-record><code>record()</code></dfn> method is
   invoked, the user agent must return a new
   <code><a href=#mediastreamrecorder>MediaStreamRecorder</a></code> object associated with the stream.</p>

Modified: source
===================================================================
--- source	2011-07-11 21:21:03 UTC (rev 6286)
+++ source	2011-07-11 22:34:50 UTC (rev 6287)
@@ -86174,7 +86174,9 @@
   title="">parentStream</var>)</code></dfn> constructor must return a
   new <code>MediaStream</code> object whose tracks at any moment in
   time are the enabled tracks of <var title="">parentStream</var> at
-  that moment.</p>
+  that moment, and whose <code
+  title="dom-MediaStream-label">label</code> is equal to the <var
+  title="">parentStream</var>'s.</p>
 
   <p>The <dfn
   title="dom-MediaStream-readyState"><code>readyState</code></dfn>
@@ -86270,10 +86272,27 @@
   information provided by the remote source.</p> <!-- described below
   -->
 
+  <p>When a <code>MediaStream</code> is created from another using the
+  <code title="dom-MediaStream">MediaStream()</code> constructor, the
+  <code title="dom-MediaStream-label">label</code> attribute is
+  initialized from the original.</p> <!-- described above -->
+
   <p>The <dfn title="dom-MediaStream-label"><code>label</code></dfn>
   attribute must return the value to which it was initialized when the
   object was created.</p>
 
+  <p class="note">The label of a <code>MediaStream</code> object is
+  unique to the source of the stream, but that does not mean it is not
+  possible to end up with duplicates. For example, when a
+  <code>MediaStream</code> object is created from another using the
+  <code title="dom-MediaStream">MediaStream()</code> constructor, the
+  fork has the same label as the original. Similarly, a locally
+  generated stream could be sent from one user to a remote peer using
+  <code>PeerConnection</code>, and then sent back to the original user
+  in the same manner, in which case the original user will have
+  multiple streams with the same label (the locally-generated one and
+  the one received from the remote peer).</p>
+
   <hr>
 
   <p>When the <dfn