[html5] r4389 - [e] (0) Explain one reason you might want to use EventSource.

[whatwg at whatwg.org]

Author: ianh
Date: 2009-12-01 00:36:34 -0800 (Tue, 01 Dec 2009)
New Revision: 4389

Modified:
   complete.html
   index
   source
Log:
[e] (0) Explain one reason you might want to use EventSource.

Modified: complete.html
===================================================================
--- complete.html	2009-12-01 07:22:38 UTC (rev 4388)
+++ complete.html	2009-12-01 08:36:34 UTC (rev 4389)
@@ -902,7 +902,7 @@
      <li><a href=#parsing-an-event-stream><span class=secno>10.2.4 </span>Parsing an event stream</a></li>
      <li><a href=#event-stream-interpretation><span class=secno>10.2.5 </span>Interpreting an event stream</a></li>
      <li><a href=#notes><span class=secno>10.2.6 </span>Notes</a></li>
-     <li><a href=#connectionless-push-and-other-features><span class=secno>10.2.7 </span>Connectionless push and other features</a></li>
+     <li><a href=#eventsource-push><span class=secno>10.2.7 </span>Connectionless push and other features</a></li>
      <li><a href=#garbage-collection-0><span class=secno>10.2.8 </span>Garbage collection</a></li>
      <li><a href=#iana-considerations><span class=secno>10.2.9 </span>IANA considerations</a>
       <ol>
@@ -64482,7 +64482,15 @@
 
 data: This is the third message.</pre>
 
+  <p>Using this API rather than emulating it using
+  <code>XMLHttpRequest</code> or an <code><a href=#the-iframe-element>iframe</a></code> allows the
+  user agent to make better use of network resources in cases where
+  the user agent implementor and the network operator are able to
+  coordinate in advance. Amongst other benefits, this can result in
+  significant savings in battery life on portable devices. This is
+  discussed further in the section below on <a href=#eventsource-push>connectionless push</a>.</p>
 
+
   <h4 id=the-eventsource-interface><span class=secno>10.2.2 </span>The <code><a href=#eventsource>EventSource</a></code> interface</h4>
 
   <pre class=idl>[<a href=#dom-eventsource title=dom-EventSource>Constructor</a>(in DOMString url)]
@@ -65066,7 +65074,7 @@
   <code><a href=#eventsource>EventSource</a></code> object using a <a href=#sharedworkerglobalscope title=SharedWorkerGlobalScope>shared worker</a>. <a href=#refsWEBWORKERS>[WEBWORKERS]</a></p>
 
 
-  <h4 id=connectionless-push-and-other-features><span class=secno>10.2.7 </span>Connectionless push and other features</h4>
+  <h4 id=eventsource-push><span class=secno>10.2.7 </span>Connectionless push and other features</h4>
 
   <p>User agents running in controlled environments, e.g. browsers on
   mobile handsets tied to specific carriers, may offload the
@@ -86207,6 +86215,7 @@
   Brian Ryner,
   Brian Smith,
   Brian Wilson,
+  Bryan Sullivan,
   Bruce D'Arcus,
   Bruce Lawson,
   Bruce Miller,
@@ -86512,6 +86521,7 @@
   Rigo Wenning,
   Rikkert Koppes,
   Rimantas Liubertas,
+  Rob Ennals,
   Robert Blaut,
   Robert Collins,
   Robert O'Callahan,

Modified: index
===================================================================
--- index	2009-12-01 07:22:38 UTC (rev 4388)
+++ index	2009-12-01 08:36:34 UTC (rev 4389)
@@ -78196,6 +78196,7 @@
   Brian Ryner,
   Brian Smith,
   Brian Wilson,
+  Bryan Sullivan,
   Bruce D'Arcus,
   Bruce Lawson,
   Bruce Miller,
@@ -78501,6 +78502,7 @@
   Rigo Wenning,
   Rikkert Koppes,
   Rimantas Liubertas,
+  Rob Ennals,
   Robert Blaut,
   Robert Collins,
   Robert O'Callahan,

Modified: source
===================================================================
--- source	2009-12-01 07:22:38 UTC (rev 4388)
+++ source	2009-12-01 08:36:34 UTC (rev 4389)
@@ -73519,6 +73519,15 @@
 
 data: This is the third message.</pre>
 
+  <p>Using this API rather than emulating it using
+  <code>XMLHttpRequest</code> or an <code>iframe</code> allows the
+  user agent to make better use of network resources in cases where
+  the user agent implementor and the network operator are able to
+  coordinate in advance. Amongst other benefits, this can result in
+  significant savings in battery life on portable devices. This is
+  discussed further in the section below on <a
+  href="#eventsource-push">connectionless push</a>.</p>
+
 <!--END complete-->
   <!--BOILERPLATE middle-w3c-api-intro-->
 <!--START complete-->
@@ -74183,7 +74192,7 @@
   href="#refsWEBWORKERS">[WEBWORKERS]</a></p>
 
 
-  <h4>Connectionless push and other features</h4>
+  <h4 id="eventsource-push">Connectionless push and other features</h4>
 
   <p>User agents running in controlled environments, e.g. browsers on
   mobile handsets tied to specific carriers, may offload the
@@ -96435,6 +96444,7 @@
   Brian Ryner,
   Brian Smith,
   Brian Wilson,
+  Bryan Sullivan,
   Bruce D'Arcus,
   Bruce Lawson,
   Bruce Miller,
@@ -96740,6 +96750,7 @@
   Rigo Wenning,
   Rikkert Koppes,
   Rimantas Liubertas,
+  Rob Ennals,
   Robert Blaut,
   Robert Collins,
   Robert O'Callahan,