W3C home > Mailing lists > Public > public-dap-commits@w3.org > August 2012

2011/webrtc/editor webrtc-20120813.html,NONE,1.1 webrtc.html,1.20,1.21 webrtc.js,1.1,1.2

From: Anant Narayanan via cvs-syncmail <cvsmail@w3.org>
Date: Mon, 13 Aug 2012 19:14:23 +0000
To: public-dap-commits@w3.org
Message-Id: <E1T105n-0005Bd-KY@lionel-hutz.w3.org>
Update of /sources/public/2011/webrtc/editor
In directory hutz:/tmp/cvs-serv19898/editor

Modified Files:
	webrtc.html webrtc.js 
Added Files:
	webrtc-20120813.html 
Log Message:
Updating draft to github version webrtc-20120813.html

--- NEW FILE: webrtc-20120813.html ---
<!DOCTYPE html>

<html lang="en">
<head>
  <title>WebRTC 1.0: Real-time Communication Between Browsers</title>
  <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
  <!--
     After making changes to this document in the github repo, run:
      ./publish.sh webrtc.html
    to publish a new editor's draft to the W3C CVS. This assumes your
    CVS checkout is located at ../2011/webrtc, you can specify the location
    as the second argument, for example:
      ./publish.sh webrtc.html ~/path/to/w3/2011/webrtc
  -->

  <script class="remove" src="http://www.w3.org/Tools/respec/respec-w3c-common"
  type="text/javascript">
  // keep this comment
  </script>
[...2762 lines suppressed...]
      <li>Updated the LocalMediaStream.stop() algorithm to implicitly use the
      end track algorithm.</li>

      <li>Replaced an occurrence the term finished track with ended track (to
      align with rest of spec).</li>

      <li>Moved (and extended) the explanation about track references and media
      sources from LocalMediaStream to MediaStreamTrack.</li>

    </ol>
  </section>

  <section class="appendix">
    <h2>Acknowledgements</h2>

    <p>The editors wish to thank the Working Group chairs, Harald Alvestrand
    and Stefan HÃ¥kansson, for their support.</p>
  </section>
</body>
</html>

Index: webrtc.html
===================================================================
RCS file: /sources/public/2011/webrtc/editor/webrtc.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -d -r1.20 -r1.21
--- webrtc.html	21 Jul 2012 05:00:26 -0000	1.20
+++ webrtc.html	13 Aug 2012 19:14:21 -0000	1.21
@@ -5,52 +5,13 @@
   <title>WebRTC 1.0: Real-time Communication Between Browsers</title>
   <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
   <!--
-     === NOTA BENE ===
-      For the three scripts below, if your spec resides on dev.w3 you can check them
-      out in the same tree and use relative links so that they'll work offline.
-
-      To tag a new releas in git hub
-
-          Once the version is checked in and ready to go, you tag it with (need
-          to chance the 20110823 to correct date )
-
-               git tag -a v20120323 -m "This is release 20120323"
-
-         Tags are not transferred by default with the push so you have to
-         add a - -tags parameter to the push so it looks like. Note you need to
-         remoce the space between the - and -tag to make a double dash.
-
-              git push - -tags
-
-         or alternatively you can push just the new tag with
-
-              git push origin v20120323
-
-
-      To generate the dated version of the specification:
-
-           Open this doc in Mozilla.
-
-           Do a CTRL-ALT-SHIFT-S
-
-           Select "XHMTL( source)" from dialog box. This will pop a new tab with
-           generated version of the document.
-
-           This will open a new tab with generated html. Copy and paste this to
-           a new file. Note if you use Chrome or Safari, this step will not
-           work. What will happen is the paste will have the original document,
-           not what was displayed in the window that you did the copy on.
-
-           Rename the new file to the correct day such as
-           webrtc-broken-20111003.html then search for and edit the links for
-           "This version" and "Previos version". Add the new file into CVS and
-           check in.
-
-           Once everyone is happy, the webrtc-broken.html and
-           webrtc-broken-20111003.html files can be copied to
-           webrtc.html and webrtc-20111003.html
-           respectively in the ../editor/. directory.
-    -->
+     After making changes to this document in the github repo, run:
+      ./publish.sh webrtc.html
+    to publish a new editor's draft to the W3C CVS. This assumes your
+    CVS checkout is located at ../2011/webrtc, you can specify the location
+    as the second argument, for example:
+      ./publish.sh webrtc.html ~/path/to/w3/2011/webrtc
+  -->
 
   <script class="remove" src="http://www.w3.org/Tools/respec/respec-w3c-common"
   type="text/javascript">
@@ -364,6 +325,10 @@
     <section>
       <h4>AudioMediaStreamTrack</h4>
 
+      <p class="issue">ISSUE: The DTMF API is having a bunch of list discussion
+   and will probably change. </p>
+
+
       <p>The <code><a>AudioMediaStreamTrack</a></code> is a specialization of
       of a normal <code><a>MediaStreamTrack</a></code> that only carries audio
       and is extended to have the capability to send and/or receive DTMF
@@ -1027,8 +992,12 @@
       <section>
         <h3>RTCPeerConnection Interface</h3>
 
+        <p class="issue">ISSUE: "optional optional" occurs twice several times
+          in the following class description.</p>
+
         <dl class="idl" title=
-        "[Constructor (RTCConfiguration configuration, optional MediaConstraints constraints)] interface RTCPeerConnection">
+        "[Constructor (RTCConfiguration configuration, optional MediaConstraints
+        constraints)] interface RTCPeerConnection : EventTarget ">
         <!--
             <dt>void getCapabilities ( RTCSessionDescriptionCallback
             successCallback )</dt>
@@ -1662,7 +1631,6 @@
           time the iceState changes.</dd>
         </dl>
 
-        <dl class="idl" title="RTCPeerConnection implements EventTarget"></dl>
       </section>
     </section>
   </section>
@@ -1840,16 +1808,53 @@
     </div>
   </section>
 
+
+    <section>
+    <h3>Call Flow Browser to Browser </h3>
+    
+    <p class="note">Editor Note: This example flow needs to be discussed on the
+    list and is likely wrong in many ways.</p>
+    
+    <p>This shows an example of one possible call flow between two
+    browsers. This does not show every callback that gets fired but instead
+    tries to reduce it down to only show the key events and messages. </p>
+    
+    <p><img alt="A MediaStream" src="images/ladder-2party-simple.svg" width=
+    "100%"></p>
+    
+    <p> The following flow show a more complete set of the callbacks and events
+    that happen. </p>
+    
+    <p><img alt="A MediaStream" src="images/ladder-2party-full.svg" width=
+    "100%"></p>
+     </section>
+    
+
+    <section>
+    <h3>Call Flow Browser to MCU </h3>
+    
+    <p class="note">Editor Note: This example flow needs to be discussed on the
+    list and is likely wrong in many ways.</p>
+    
+    <p>This shows an example of one possible call flow between a centralized
+    conferencing server and a browsers. This does not show every callback that
+    gets fired but instead tries to reduce it down to only show the key events
+    and messages. </p>
+    
+    <p><img alt="A MediaStream" src="images/ladder-mcu-simple.svg" width=
+    "100%"></p>
+    
+    </section>
+
+    
+    
   <section>
     <h2>Peer-to-peer Data API</h2>
 
     <p>The Peer-to-peer Data API lets a web application send and receive
     generic application data peer-to-peer.</p>
 
-    <div class="issue" title="hello">
-      <p>ISSUES (this should not be considered as a complete list of open
-      issues)</p>
-
+    <div class="issue" title="More Open Issue">
       <ul>
         <li>Data channel setup signaling (signaling via SDP and application
         specific signaling channel or first channel via SDP and consecutive
@@ -2635,7 +2640,7 @@
     <h2>Change Log</h2>
 
     <p>This section will be removed before publication.</p>
-
+ 
     <!-- Why do the first two headings automatically convert to <h2>? -->
     <h3>Changes since Jul 20, 2012</h3>
 
@@ -2647,7 +2652,9 @@
       <li>Added correlating lines to candidate structure.</li>
 
       <li>Converted setLocalDescription and setRemoteDescription to be asynchronous.</li>
-    </ol>
+
+      <li>Added call flows.</li>
+     </ol>
 
     <h3>Changes since Jul 13, 2012</h3>
 

Index: webrtc.js
===================================================================
RCS file: /sources/public/2011/webrtc/editor/webrtc.js,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- webrtc.js	21 Jul 2012 05:01:34 -0000	1.1
+++ webrtc.js	13 Aug 2012 19:14:21 -0000	1.2
@@ -1,78 +1,75 @@
 
-      var respecConfig = {
-         // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
-          //specStatus:           "Member-SUBM",
-          specStatus:           "ED",
+var respecConfig = {
+  // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
+  specStatus:           "ED",
 
-         // the specification's short name, as in http://www.w3.org/TR/short-name/
-          shortName:            "webrtc",
-          // if your specification has a subtitle that goes below the main
-          // formal title, define it here
-          // subtitle   :  "an excellent document",
+  // the specification's short name, as in http://www.w3.org/TR/short-name/
+  shortName:            "webrtc",
+  
+  // if your specification has a subtitle that goes below the main
+  // formal title, define it here
+  // subtitle   :  "an excellent document",
 
-          // if you wish the publication date to be other than today, set this
-          // publishDate:  "2012-05-28",
+  // if you wish the publication date to be other than today, set this
+  // publishDate:  "2012-05-28",
 
-          // new ability to override the copyright completely
-                  overrideCopyright:  "<p class='copyright'>Initial Author of this Specification was Ian Hickson, Google Inc., with the following copyright statement:<br /> &#169; Copyright 2004-2011 Apple Computer, Inc., Mozilla Foundation, and Opera Software ASA. You are granted a license to use, reproduce and create derivative works of this document.</p> <p class='copyright'>All subsequent changes since 26 July 2011 done by the W3C WebRTC Working Group are under the following <a href='http://www.w3.org/Consortium/Legal/ipr-notice#Copyright'>Copyright</a>:<br />&#169; 2011-2012 <a href='http://www.w3.org/'><acronym title='World Wide Web Consortium'>W3C</acronym></a><sup>&#174;</sup> (<a href='http://www.csail.mit.edu/'><acronym title='Massachusetts Institute of Technology'>MIT</acronym></a>, <a href='http://www.ercim.eu/'><acronym title='European Research Consortium for Informatics and Mathematics'>ERCIM</acronym></a>, <a href='http://www.keio.ac.jp/'>Keio</a>), All Rights Reserved. <a href='http://www.w3.org/Consortium/Legal/copyright-documents'>Document use</a>  rules apply.</p> <p class='copyright'>For the entire publication on the W3C site the <a href='http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer'>liability</a> and <a href='http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks'>trademark</a> rules apply.</p>",
+  // new ability to override the copyright completely
+  overrideCopyright:  "<p class='copyright'>Initial Author of this Specification was Ian Hickson, Google Inc., with the following copyright statement:<br /> &#169; Copyright 2004-2011 Apple Computer, Inc., Mozilla Foundation, and Opera Software ASA. You are granted a license to use, reproduce and create derivative works of this document.</p> <p class='copyright'>All subsequent changes since 26 July 2011 done by the W3C WebRTC Working Group are under the following <a href='http://www.w3.org/Consortium/Legal/ipr-notice#Copyright'>Copyright</a>:<br />&#169; 2011-2012 <a href='http://www.w3.org/'><acronym title='World Wide Web Consortium'>W3C</acronym></a><sup>&#174;</sup> (<a href='http://www.csail.mit.edu/'><acronym title='Massachusetts Institute of Technology'>MIT</acronym></a>, <a href='http://www.ercim.eu/'><acronym title='European Research Consortium for Informatics and Mathematics'>ERCIM</acronym></a>, <a href='http://www.keio.ac.jp/'>Keio</a>), All Rights Reserved. <a href='http://www.w3.org/Consortium/Legal/copyright-documents'>Document use</a>  rules apply.</p> <p class='copyright'>For the entire publication on the W3C site the <a href='http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer'>liability</a> and <a href='http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks'>trademark</a> rules apply.</p>",
 
 
-          // if the specification's copyright date is a range of years, specify
-          // the start date here:
-          // copyrightStart: "2005",
+  // if the specification's copyright date is a range of years, specify
+  // the start date here:
+  // copyrightStart: "2005",
 
-          // if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
-          // and its maturity status
-          previousPublishDate:  "2012-01-12",
-          previousMaturity:  "ED",
-          previousURI: "http://dev.w3.org/2011/webrtc/editor/webrtc-20120530.html",
+  // if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
+  // and its maturity status
+  previousMaturity: "ED",
+  previousURI: "http://dev.w3.org/2011/webrtc/editor/webrtc-20120720.html",
 
-          // if there a publicly available Editor's Draft, this is the link
-          edDraftURI: "http://dev.w3.org/2011/webrtc/editor/webrtc.html",
+  // if there a publicly available Editor's Draft, this is the link
+  edDraftURI: "http://dev.w3.org/2011/webrtc/editor/webrtc.html",
 
-          // if this is a LCWD, uncomment and set the end of its review period
-          // lcEnd: "2009-08-05",
+  // if this is a LCWD, uncomment and set the end of its review period
+  // lcEnd: "2009-08-05",
 
-          // if you want to have extra CSS, append them to this list
-          // it is RECOMMENDED that the respec.css stylesheet be kept
+  // if you want to have extra CSS, append them to this list
+  // it is RECOMMENDED that the respec.css stylesheet be kept
   //        extraCSS:             ["ReSpec.js/css/respec.css"],
-  //          extraCSS:             ["../../../2009/dap/ReSpec.js/css/respec.css"],
-
-          // editors, add as many as you like
-          // only "name" is REQUIRED
-          editors:  [
-  //              { name: "Your Name", url: "http://example.org/",
-  //                company: "Your Company", companyURL: "http://example.com/" },
-             { name: "Adam Bergkvist", company: "Ericsson" },
-              { name: "Daniel C. Burnett", company: "Voxeo" },
-              { name: "Cullen Jennings", company: "Cisco" },
-             { name: "Anant Narayanan", company: "Mozilla" },
-          ],
+  //        extraCSS:             ["../../../2009/dap/ReSpec.js/css/respec.css"],
 
-          // authors, add as many as you like. 
-          // This is optional, uncomment if you have authors as well as editors.
-          // only "name" is REQUIRED. Same format as editors.
+  // editors, add as many as you like
+  // only "name" is REQUIRED
+  editors:  [
+    //              { name: "Your Name", url: "http://example.org/",
+    //                company: "Your Company", companyURL: "http://example.com/" },
+    { name: "Adam Bergkvist", company: "Ericsson" },
+    { name: "Daniel C. Burnett", company: "Voxeo" },
+    { name: "Cullen Jennings", company: "Cisco" },
+    { name: "Anant Narayanan", company: "Mozilla" },
+  ],
 
-          //authors:  [
-          //    { name: "Your Name", url: "http://example.org/",
-          //      company: "Your Company", companyURL: "http://example.com/" },
-          // { name: "Cullen Jennings", company: "Cisco" },
-          //],
-          
-          // name of the WG
-          wg:           "Web Real-Time Communications Working Group",
-          
-          // URI of the public WG page
-          wgURI:        "http://www.w3.org/2011/04/webrtc/",
-          
-          // name (without the @w3c.org) of the public mailing to which comments are due
-          wgPublicList: "public-webrtc",
-          
-          // URI of the patent status for this WG, for Rec-track documents
-          // !!!! IMPORTANT !!!!
-          // This is important for Rec-track documents, do not copy a patent URI from a random
-          // document unless you know what you're doing. If in doubt ask your friendly neighbourhood
-          // Team Contact.
-          wgPatentURI:  "http://www.w3.org/2004/01/pp-impl/47318/status",
-      };
+  // authors, add as many as you like. 
+  // This is optional, uncomment if you have authors as well as editors.
+  // only "name" is REQUIRED. Same format as editors.
 
+  //authors:  [
+  //    { name: "Your Name", url: "http://example.org/",
+  //      company: "Your Company", companyURL: "http://example.com/" }
+  //],
+    
+  // name of the WG
+  wg:           "Web Real-Time Communications Working Group",
+    
+  // URI of the public WG page
+  wgURI:        "http://www.w3.org/2011/04/webrtc/",
+    
+  // name (without the @w3c.org) of the public mailing to which comments are due
+  wgPublicList: "public-webrtc",
+    
+  // URI of the patent status for this WG, for Rec-track documents
+  // !!!! IMPORTANT !!!!
+  // This is important for Rec-track documents, do not copy a patent URI from a random
+  // document unless you know what you're doing. If in doubt ask your friendly neighbourhood
+  // Team Contact.
+  wgPatentURI:  "http://www.w3.org/2004/01/pp-impl/47318/status",
+};
Received on Monday, 13 August 2012 19:14:26 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 13 August 2012 19:14:27 GMT