- From: CVS User ihickson <cvsmail@w3.org>
- Date: Mon, 25 Mar 2013 23:36:41 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/eventsource
In directory roscoe:/tmp/cvs-serv1546
Modified Files:
Overview.html
Log Message:
Cleanup (whatwg r7771)
--- /sources/public/html5/eventsource/Overview.html 2013/01/30 23:32:01 1.236
+++ /sources/public/html5/eventsource/Overview.html 2013/03/25 23:36:41 1.237
@@ -216,7 +216,7 @@
<h1>Server-Sent Events</h1>
- <h2 class="no-num no-toc" id="editor-s-draft-30-january-2013">Editor's Draft 30 January 2013</h2>
+ <h2 class="no-num no-toc" id="editor-s-draft-25-march-2013">Editor's Draft 25 March 2013</h2>
<dl><dt>Latest Published Version:</dt>
<dd><a href="http://www.w3.org/TR/eventsource/">http://www.w3.org/TR/eventsource/</a></dd>
<dt>Latest Editor's Draft:</dt>
@@ -354,7 +354,7 @@
</dl><p>The W3C <a href="http://www.w3.org/2008/webapps/">Web Applications
Working Group</a> is the W3C working group responsible for this
specification's progress along the W3C Recommendation track.
- This specification is the 30 January 2013 Editor's Draft.
+ This specification is the 25 March 2013 Editor's Draft.
</p>
@@ -808,26 +808,23 @@
</ol></li>
- </ol><p>When a user agent is to <dfn id="fail-the-connection">fail the connection</dfn>, the user
- agent must <span>queue a task</span> which, if the <code title="dom-EventSource-readyState"><a href="#dom-eventsource-readystate">readyState</a></code> attribute is
- set to a value other than <code title="dom-EventSource-CLOSED"><a href="#dom-eventsource-closed">CLOSED</a></code>, sets the <code title="dom-EventSource-readyState"><a href="#dom-eventsource-readystate">readyState</a></code> attribute to
- <code title="dom-EventSource-CLOSED"><a href="#dom-eventsource-closed">CLOSED</a></code> and <span title="fire a simple event">fires a simple event</span> named <code title="event-error">error</code> at the <code><a href="#eventsource">EventSource</a></code>
- object. <strong>Once the user agent has <a href="#fail-the-connection" title="fail the
- connection">failed the connection</a>, it does <em>not</em>
- attempt to reconnect!</strong></p>
-
- <hr><p>The <span>task source</span> for any <span title="concept-task">tasks</span> that are <span title="queue a
- task">queued</span> by <code><a href="#eventsource">EventSource</a></code> objects is the
- <dfn id="remote-event-task-source">remote event task source</dfn>.</p>
+ </ol><p>When a user agent is to <dfn id="fail-the-connection">fail the connection</dfn>, the user agent must <span>queue a
+ task</span> which, if the <code title="dom-EventSource-readyState"><a href="#dom-eventsource-readystate">readyState</a></code> attribute is
+ set to a value other than <code title="dom-EventSource-CLOSED"><a href="#dom-eventsource-closed">CLOSED</a></code>, sets the <code title="dom-EventSource-readyState"><a href="#dom-eventsource-readystate">readyState</a></code> attribute to <code title="dom-EventSource-CLOSED"><a href="#dom-eventsource-closed">CLOSED</a></code> and <span title="fire a simple event">fires a simple
+ event</span> named <code title="event-error">error</code> at the <code><a href="#eventsource">EventSource</a></code> object.
+ <strong>Once the user agent has <a href="#fail-the-connection" title="fail the connection">failed the connection</a>, it
+ does <em>not</em> attempt to reconnect!</strong></p>
+
+ <hr><p>The <span>task source</span> for any <span title="concept-task">tasks</span> that are <span title="queue a task">queued</span> by <code><a href="#eventsource">EventSource</a></code> objects is the <dfn id="remote-event-task-source">remote event
+ task source</dfn>.</p>
<h2 id="parsing-an-event-stream"><span class="secno">6 </span>Parsing an event stream</h2>
- <p>This event stream format's <span>MIME type</span> is
- <code><a href="#text-event-stream">text/event-stream</a></code>.</p>
+ <p>This event stream format's <span>MIME type</span> is <code><a href="#text-event-stream">text/event-stream</a></code>.</p>
- <p>The event stream format is as described by the <code title="">stream</code> production of the following ABNF, the
- character set for which is Unicode. <a href="#refsABNF">[ABNF]</a></p>
+ <p>The event stream format is as described by the <code title="">stream</code> production of the
+ following ABNF, the character set for which is Unicode. <a href="#refsABNF">[ABNF]</a></p>
<pre>stream = [ bom ] *event
event = *( comment / field ) end-of-line
@@ -846,19 +843,17 @@
any-char = %x0000-0009 / %x000B-000C / %x000E-10FFFF
; a <span>Unicode character</span> other than U+000A LINE FEED (LF) or U+000D CARRIAGE RETURN (CR)</pre>
- <p>Event streams in this format must always be encoded as
- UTF-8. <a href="#refsRFC3629">[RFC3629]</a></p>
+ <p>Event streams in this format must always be encoded as UTF-8. <a href="#refsRFC3629">[RFC3629]</a></p>
- <p>Lines must be separated by either a U+000D CARRIAGE RETURN U+000A
- LINE FEED (CRLF) character pair, a single U+000A LINE FEED (LF)
- character, or a single U+000D CARRIAGE RETURN (CR) character.</p>
-
- <p>Since connections established to remote servers for such
- resources are expected to be long-lived, UAs should ensure that
- appropriate buffering is used. In particular, while line buffering
- with lines are defined to end with a single U+000A LINE FEED (LF)
- character is safe, block buffering or line buffering with different
- expected line endings can cause delays in event dispatch.</p>
+ <p>Lines must be separated by either a U+000D CARRIAGE RETURN U+000A LINE FEED (CRLF) character
+ pair, a single U+000A LINE FEED (LF) character, or a single U+000D CARRIAGE RETURN (CR)
+ character.</p>
+
+ <p>Since connections established to remote servers for such resources are expected to be
+ long-lived, UAs should ensure that appropriate buffering is used. In particular, while line
+ buffering with lines are defined to end with a single U+000A LINE FEED (LF) character is safe,
+ block buffering or line buffering with different expected line endings can cause delays in event
+ dispatch.</p>
<h2 id="event-stream-interpretation"><span class="secno">7 </span>Interpreting an event stream</h2>
@@ -870,28 +865,23 @@
</p>
- <p>One leading U+FEFF BYTE ORDER MARK character must be ignored if
- any are present.</p>
+ <p>One leading U+FEFF BYTE ORDER MARK character must be ignored if any are present.</p>
+
+ <p>The stream must then be parsed by reading everything line by line, with a U+000D CARRIAGE
+ RETURN U+000A LINE FEED (CRLF) character pair, a single U+000A LINE FEED (LF) character not
+ preceded by a U+000D CARRIAGE RETURN (CR) character, and a single U+000D CARRIAGE RETURN (CR)
+ character not followed by a U+000A LINE FEED (LF) character being the ways in which a line can
+ end.</p>
- <p>The stream must then be parsed by reading everything line by
- line, with a U+000D CARRIAGE RETURN U+000A LINE FEED (CRLF)
- character pair, a single U+000A LINE FEED (LF) character not
- preceded by a U+000D CARRIAGE RETURN (CR) character, and a single
- U+000D CARRIAGE RETURN (CR) character not followed by a U+000A LINE
- FEED (LF) character being the ways in which a line can end.</p>
-
- <p>When a stream is parsed, a <var title="">data</var> buffer, an
- <var title="">event type</var> buffer, and a <var title="">last
- event ID</var> buffer must be associated with it. They must be
+ <p>When a stream is parsed, a <var title="">data</var> buffer, an <var title="">event type</var>
+ buffer, and a <var title="">last event ID</var> buffer must be associated with it. They must be
initialized to the empty string</p>
- <p>Lines must be processed, in the order they are received, as
- follows:</p>
+ <p>Lines must be processed, in the order they are received, as follows:</p>
<dl class="switch"><dt>If the line is empty (a blank line)</dt>
- <dd><p><a href="#dispatchMessage">Dispatch the event</a>, as
- defined below.</dd>
+ <dd><p><a href="#dispatchMessage">Dispatch the event</a>, as defined below.</dd>
<dt>If the line starts with a U+003A COLON character (:)</dt>
@@ -903,18 +893,12 @@
<dd>
- <p>Collect the characters on the line before the first U+003A
- COLON character (:), and let <var title="">field</var> be that
- string.</p>
-
- <p>Collect the characters on the line after the first U+003A COLON
- character (:), and let <var title="">value</var> be that
- string. If <var title="">value</var> starts with a U+0020
- SPACE character, remove it from <var title="">value</var>.</p>
-
- <p><a href="#processField">Process the field</a> using the steps
- described below, using <var title="">field</var> as the field name
- and <var title="">value</var> as the field value.</p>
+ <p>Collect the characters on the line before the first U+003A COLON character (:), and let <var title="">field</var> be that string.</p>
+
+ <p>Collect the characters on the line after the first U+003A COLON character (:), and let <var title="">value</var> be that string. If <var title="">value</var> starts with a U+0020 SPACE
+ character, remove it from <var title="">value</var>.</p>
+
+ <p><a href="#processField">Process the field</a> using the steps described below, using <var title="">field</var> as the field name and <var title="">value</var> as the field value.</p>
</dd>
Received on Monday, 25 March 2013 23:36:47 UTC