html5/websockets Overview.html,1.31,1.32

Update of /sources/public/html5/websockets
In directory hutz:/tmp/cvs-serv29049

Modified Files:
	Overview.html 
Log Message:
Pimp My Spec changes... (should be no actual difference here) (whatwg r2803)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/websockets/Overview.html,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -d -r1.31 -r1.32
--- Overview.html	12 Feb 2009 01:21:38 -0000	1.31
+++ Overview.html	13 Feb 2009 01:06:27 -0000	1.32
@@ -1,18 +1,26 @@
-<!DOCTYPE html><!-- when publishing, change bits marked ZZZ --><html lang=en-US-x-Hixie><title>The Web Sockets API</title><link href=http://www.w3.org/StyleSheets/TR/%57%33%43-ED rel=stylesheet type=text/css><!-- ZZZ ED vs WD --><style>
+<!DOCTYPE html><!-- when publishing, change bits marked ZZZ --><html lang=en-US-x-Hixie><head><meta charset=utf-8>
+  <title>The Web Sockets API</title>
+  <link href=http://www.w3.org/StyleSheets/TR/%57%33%43-ED rel=stylesheet type=text/css> <!-- ZZZ ED vs WD -->
+  <style>
    .toc ~ hr { display: block; background: none; border: none; padding: 0; margin: 2em 0; }
    .XXX { border: solid thick red; }
    pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em; }
    pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
-  </style><div class=head>
+  </style>
+ </head>
+ <body>
+  <div class=head>
    <p><a href=http://www.w3.org/><img alt=W3C height=48 src=http://www.w3.org/Icons/w3c_home width=72></a></p>
    <h1>The Web Sockets API</h1>
-   <h2 class="no-num no-toc" id=editor-s-draft-date-zzz-9-june-2008><!-- "W3C Working Draft" --> Editor's Draft <!--ZZZ-->12 February 2009</h2>
-   <dl><!-- ZZZ: update the month/day
+   <h2 class="no-num no-toc" id=editor-s-draft-date-zzz-9-june-2008><!-- "W3C Working Draft" --> Editor's Draft <!--ZZZ-->13 February 2009</h2>
+   <dl>
+<!-- ZZZ: update the month/day
     <dt>This Version:</dt>
     <dd><a href="http://www.w3.org/TR/2009/WD-websockets-20090101/">http://www.w3.org/TR/2009/WD-websockets-20090101/</a></dd>
     <dt>Latest Published Version:</dt>
     <dd><a href="http://www.w3.org/TR/websockets/">http://www.w3.org/TR/websockets/</a></dd>
- :ZZZ --><dt>Latest Editor's Draft:</dt>
+ :ZZZ -->
+    <dt>Latest Editor's Draft:</dt>
     <dd><a href=http://dev.w3.org/html5/websockets/>http://dev.w3.org/html5/websockets/</a></dd>
 <!-- ZZZ: add the new version after it has shipped
     <dt>Previous Versions:</dt>
@@ -20,9 +28,10 @@
  :ZZZ -->
     <dt>Editors:</dt>
     <dd><a href=mailto:ian@hixie.ch>Ian Hickson</a>, Google, Inc.</dd>
-   </dl><p class=copyright><a href=http://www.w3.org/Consortium/Legal/ipr-notice#Copyright>Copyright</a>
-   &copy; 2008 <a href=http://www.w3.org/><abbr title="World Wide
-   Web Consortium">W3C</abbr></a><sup>&reg;</sup> (<a href=http://www.csail.mit.edu/><abbr title="Massachusetts
+   </dl>
+   <p class=copyright><a href=http://www.w3.org/Consortium/Legal/ipr-notice#Copyright>Copyright</a>
+   © 2008 <a href=http://www.w3.org/><abbr title="World Wide
+   Web Consortium">W3C</abbr></a><sup>®</sup> (<a href=http://www.csail.mit.edu/><abbr title="Massachusetts
    Institute of Technology">MIT</abbr></a>, <a href=http://www.ercim.org/><abbr title="European Research
    Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href=http://www.keio.ac.jp/>Keio</a>), All Rights Reserved. W3C
    <a href=http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer>liability</a>,
@@ -36,14 +45,30 @@
    permissive license.</p>
    <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
 
-  </div><hr><h2 class="no-num no-toc" id=abstract>Abstract</h2><p>This specification defines an API that enables Web pages to use
+  </div>
+
+  <hr>
+
+  <h2 class="no-num no-toc" id=abstract>Abstract</h2>
+
+  <p>This specification defines an API that enables Web pages to use
   the Web Sockets protocol for two-way communication with a remote
-  host.<h2 class="no-num no-toc" id=status-of-this-document>Status of this document</h2><!-- intro boilerplate (required) --><p><em>This section describes the status of this document at the
+  host.</p>
+
+
+  <h2 class="no-num no-toc" id=status-of-this-document>Status of this document</h2>
+
+  <!-- intro boilerplate (required) -->
+  <p><em>This section describes the status of this document at the
   time of its publication. Other documents may supersede this
   document. A list of current W3C publications and the most recently
   formally published revision of this technical report can be found in
   the <a href=http://www.w3.org/TR/>W3C technical reports index</a>
-  at http://www.w3.org/TR/.</em></p><!-- where to send feedback (required) --><p>If you wish to make comments regarding this document, please send
+  at http://www.w3.org/TR/.</em></p>
+
+
+  <!-- where to send feedback (required) -->
+  <p>If you wish to make comments regarding this document, please send
   them to <a href=mailto:public-webapps-comments@w3.org>public-webapps-comments@w3.org</a>
   (<a href="mailto:public-webapps-comments-request@w3.org?subject=subscribe">subscribe</a>,
   <a href=http://lists.w3.org/Archives/Public/public-webapps-comments/>archives</a>)
@@ -53,17 +78,33 @@
   <a href=http://lists.whatwg.org/pipermail/whatwg-whatwg.org/>archives</a>).
    <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING SENTENCE TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
 
-  All feedback is welcome.</p><!-- stability (required) --><p>Implementors should be aware that this specification is not
+  All feedback is welcome.</p>
+
+
+  <!-- stability (required) -->
+  <p>Implementors should be aware that this specification is not
   stable. <strong>Implementors who are not taking part in the
   discussions are likely to find the specification changing out from
   under them in incompatible ways.</strong> Vendors interested in
   implementing this specification before it eventually reaches the
   Candidate Recommendation stage should join the aforementioned
-  mailing lists and take part in the discussions.</p><!-- version history or list of changes (required) --><p>The latest stable version of the editor's draft of this
+  mailing lists and take part in the discussions.</p>
+
+
+  <!-- version history or list of changes (required) -->
+
+  <p>The latest stable version of the editor's draft of this
   specification is always available on <a href=http://dev.w3.org/html5/websockets/Overview.html>the W3C CVS
   server</a>. Change tracking for this document is available at the
-  following location:<ul><li>CVS log: <a href=http://dev.w3.org/cvsweb/html5/apps/Overview.html>http://dev.w3.org/cvsweb/html5/apps/Overview.html</a></li>
-  </ul><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is automatically generated from the
+  following location:</p>
+
+  <ul>
+   <li>CVS log: <a href=http://dev.w3.org/cvsweb/html5/apps/Overview.html>http://dev.w3.org/cvsweb/html5/apps/Overview.html</a></li>
+  </ul>
+
+  <!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
+  <!-- relationship to other work (required) -->
+  <p>This specification is automatically generated from the
   corresponding section in the HTML5 specification, as hosted in the
   <a href=http://svn.whatwg.org/webapps/>WHATWG Subversion
   repository</a>. The latest editor's working copy of HTML5 (which may
@@ -71,26 +112,49 @@
   available <a href=http://www.whatwg.org/specs/web-apps/current-work/>on the
   WHATWG site</a>. Detailed change history for all of HTML5, including
   the parts that form this specification, can be found at the
-  following locations:</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING LIST TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><ul><li>Twitter messages (non-editorial changes only): <a href=http://twitter.com/WHATWG>http://twitter.com/WHATWG</a></li>
+  following locations:</p>
+  <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
+
+  <!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING LIST TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
+  <ul>
+   <li>Twitter messages (non-editorial changes only): <a href=http://twitter.com/WHATWG>http://twitter.com/WHATWG</a></li>
    <li>Interactive Web interface: <a href=http://html5.org/tools/web-apps-tracker>http://html5.org/tools/web-apps-tracker</a></li>
    <li>Commit-Watchers mailing list: <a href=http://lists.whatwg.org/listinfo.cgi/commit-watchers-whatwg.org>http://lists.whatwg.org/listinfo.cgi/commit-watchers-whatwg.org</a></li>
    <li>Subversion interface: <a href=http://svn.whatwg.org/webapps/>http://svn.whatwg.org/webapps/</a></li>
-  </ul><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING LIST TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- status of document, group responsible (required) --><p>The W3C <a href=http://www.w3.org/2008/webapps/>Web Apps
+  </ul>
+  <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING LIST TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
+
+
+  <!-- status of document, group responsible (required) -->
+  <p>The W3C <a href=http://www.w3.org/2008/webapps/>Web Apps
   Working Group</a> is the W3C working group responsible for this
   specification's progress along the W3C Recommendation track.
   <!--ZZZ:-->
-  This specification is the 12 February 2009 <!--ZZZ "Working Draft"-->Editor's Draft.
+  This specification is the 13 February 2009 <!--ZZZ "Working Draft"-->Editor's Draft.
   <!--:ZZZ-->
-  </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to specify a part of the Web
+  </p>
+
+
+  <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
+  <!-- context and rationale (required) -->
+  <p>This specification is intended to specify a part of the Web
   platform closely related to HTML5. It is defined in a separate
-  document primarily to ease the cognitive load on reviewers.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- required patent boilerplate --><p>This document was produced by a group operating under the <a href=http://www.w3.org/Consortium/Patent-Policy-20040205/>5
+  document primarily to ease the cognitive load on reviewers.</p>
+  <!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
+
+
+  <!-- required patent boilerplate -->
+  <p>This document was produced by a group operating under the <a href=http://www.w3.org/Consortium/Patent-Policy-20040205/>5
   February 2004 W3C Patent Policy</a>. W3C maintains a <a href=http://www.w3.org/2004/01/pp-impl/42538/status rel=disclosure>public list of
   any patent disclosures</a> made in connection with the deliverables
   of the group; that page also includes instructions for disclosing a
   patent. An individual who has actual knowledge of a patent which the
   individual believes contains <a href=http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential>Essential
   Claim(s)</a> must disclose the information in accordance with <a href=http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure>section
-  6 of the W3C Patent Policy</a>.<h2 class="no-num no-toc" id=contents>Table of contents</h2>
+  6 of the W3C Patent Policy</a>.</p>
+
+  <h2 class="no-num no-toc" id=contents>Table of contents</h2>
+  
 <!--begin-toc-->
 <ol class=toc>
  <li><a href=#network-intro><span class=secno>1 </span>Introduction</a>
@@ -103,34 +167,72 @@
  <li><a href=#websocket-events><span class=secno>3 </span>WebSocket Events</a></li>
  <li><a href=#feedback-from-the-protocol><span class=secno>4 </span>Feedback from the protocol</a></li>
  <li><a class=no-num href=#references>References</a></ol>
-<!--end-toc--><hr><h2 id=network-intro><span class=secno>1 </span>Introduction</h2><p><em>This section is non-normative.</em><p>To enable Web applications to maintain bidirectional
+<!--end-toc-->
+  <hr>
+
+  <h2 id=network-intro><span class=secno>1 </span>Introduction</h2>
+
+  <p><em>This section is non-normative.</em></p>
+
+  <p>To enable Web applications to maintain bidirectional
   communications with server-side processes, this specification
-  introduces the <code><a href=#websocket>WebSocket</a></code> interface.<p class=note>This interface does not allow for raw access to the
+  introduces the <code><a href=#websocket>WebSocket</a></code> interface.</p>
+
+  <p class=note>This interface does not allow for raw access to the
   underlying network. For example, this interface could not be used to
   implement an IRC client without proxying messages through a custom
-  server.<p class=XXX>An introduction to the client-side and
-  server-side of using the direct connection APIs.<h3 id=conformance-requirements><span class=secno>1.1 </span>Conformance requirements</h3><p>All diagrams, examples, and notes in this specification are
+  server.</p>
+
+  <p class=XXX>An introduction to the client-side and
+  server-side of using the direct connection APIs.</p>
+
+  
+
+  <h3 id=conformance-requirements><span class=secno>1.1 </span>Conformance requirements</h3>
+
+  <p>All diagrams, examples, and notes in this specification are
   non-normative, as are all sections explicitly marked non-normative.
-  Everything else in this specification is normative.<p>The key words "MUST", "MUST NOT", "REQUIRED", <!--"SHALL", "SHALL
+  Everything else in this specification is normative.</p>
+
+  <p>The key words "MUST", "MUST NOT", "REQUIRED", <!--"SHALL", "SHALL
   NOT",--> "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
   "OPTIONAL" in the normative parts of this document are to be
   interpreted as described in RFC2119. For readability, these words do
-  not appear in all uppercase letters in this specification. <a href=#refsRFC2119>[RFC2119]</a><p>Requirements phrased in the imperative as part of algorithms
+  not appear in all uppercase letters in this specification. <a href=#refsRFC2119>[RFC2119]</a></p>
+
+  <p>Requirements phrased in the imperative as part of algorithms
   (such as "strip any leading space characters" or "return false and
   abort these steps") are to be interpreted with the meaning of the
   key word ("must", "should", "may", etc) used in introducing the
-  algorithm.<p>Some conformance requirements are phrased as requirements on
+  algorithm.</p>
+
+  <p>Some conformance requirements are phrased as requirements on
   attributes, methods or objects. Such requirements are to be
-  interpreted as requirements on user agents.<p>Conformance requirements phrased as algorithms or specific steps
+  interpreted as requirements on user agents.</p>
+
+  <p>Conformance requirements phrased as algorithms or specific steps
   may be implemented in any manner, so long as the end result is
   equivalent. (In particular, the algorithms defined in this
   specification are intended to be easy to follow, and not intended to
-  be performant.)<p>The only conformance class defined by this specification is user
-  agents.<p>User agents may impose implementation-specific limits on
+  be performant.)</p>
+
+  <p>The only conformance class defined by this specification is user
+  agents.</p>
+
+  <p>User agents may impose implementation-specific limits on
   otherwise unconstrained inputs, e.g. to prevent denial of service
   attacks, to guard against running out of memory, or to work around
-  platform-specific limitations.<h4 id=dependencies><span class=secno>1.1.1 </span>Dependencies</h4><p>This specification relies on several other underlying
-  specifications.<dl><dt>HTML5</dt>
+  platform-specific limitations.</p>
+
+
+  <h4 id=dependencies><span class=secno>1.1.1 </span>Dependencies</h4>
+
+  <p>This specification relies on several other underlying
+  specifications.</p>
+
+  <dl>
+
+   <dt>HTML5</dt>
 
    <dd>
 
@@ -148,16 +250,31 @@
 
    </dd>
 
-  </dl><h3 id=terminology><span class=secno>1.2 </span>Terminology</h3><p>The construction "a <code title="">Foo</code> object", where
+  </dl>
+
+
+  <h3 id=terminology><span class=secno>1.2 </span>Terminology</h3>
+
+  <p>The construction "a <code title="">Foo</code> object", where
   <code title="">Foo</code> is actually an interface, is sometimes
   used instead of the more accurate "an object implementing the
-  interface <code title="">Foo</code>".<p>The term DOM is used to refer to the API set made available to
+  interface <code title="">Foo</code>".</p>
+
+  <p>The term DOM is used to refer to the API set made available to
   scripts in Web applications, and does not necessarily imply the
   existence of an actual <code>Document</code> object or of any other
   <code>Node</code> objects as defined in the DOM Core
-  specifications. <a href=#refsDOM3CORE>[DOM3CORE]</a><p>A DOM attribute is said to be <em>getting</em> when its value is
+  specifications. <a href=#refsDOM3CORE>[DOM3CORE]</a></p>
+
+  <p>A DOM attribute is said to be <em>getting</em> when its value is
   being retrieved (e.g. by author script), and is said to be
-  <em>setting</em> when a new value is assigned to it.<h2 id=the-websocket-interface><span class=secno>2 </span>The <code><a href=#websocket>WebSocket</a></code> interface</h2><pre class=idl>[<a href=#dom-websocket title=dom-WebSocket>Constructor</a>(in DOMString url)]
+  <em>setting</em> when a new value is assigned to it.</p>
+
+
+
+  <h2 id=the-websocket-interface><span class=secno>2 </span>The <code><a href=#websocket>WebSocket</a></code> interface</h2>
+ 
+  <pre class=idl>[<a href=#dom-websocket title=dom-WebSocket>Constructor</a>(in DOMString url)]
 interface <dfn id=websocket>WebSocket</dfn> {
   readonly attribute DOMString <a href=#dom-websocket-url title=dom-WebSocket-URL>URL</a>;
 
@@ -173,13 +290,19 @@
            attribute <span>Function</span> <a href=#handler-websocket-onclosed title=handler-WebSocket-onclosed>onclosed</a>;
   void <a href=#dom-websocket-postmessage title=dom-WebSocket-postMessage>postMessage</a>(in DOMString data);
   void <a href=#dom-websocket-disconnect title=dom-WebSocket-disconnect>disconnect</a>();
-};</pre><p><code><a href=#websocket>WebSocket</a></code> objects must also implement the
+};</pre>
+
+  <p><code><a href=#websocket>WebSocket</a></code> objects must also implement the
   <code>EventTarget</code> interface. <a href=#refsDOM3EVENTS>[DOM3EVENTS]</a>
 
   <p>The <dfn id=dom-websocket title=dom-WebSocket><code>WebSocket(<var title="">url</var>)</code></dfn> constructor takes one argument,
   <var title="">url</var>, which specifies the <span>URL</span> to
   which to connect. When the <code>WebSocket()</code> constructor is
-  invoked, the UA must run these steps:<ol><li><p><span title="parse a url">Parse</span> the <var title="">url</var> argument.</li>
+  invoked, the UA must run these steps:</p>
+
+  <ol>
+
+   <li><p><span title="parse a url">Parse</span> the <var title="">url</var> argument.</li>
 
    <li><p>If the previous step failed, or if <var title="">url</var>
    does not have a <span title=url-scheme>&lt;scheme&gt;</span>
@@ -221,11 +344,21 @@
    was specified), from <var title="">origin</var>, with the flag <var title="">secure</var>, and with <var title="">resource name</var>
    as the resource name.</li>
 
-  </ol><hr><p>The <dfn id=dom-websocket-url title=dom-WebSocket-URL><code>URL</code></dfn>
+  </ol>
+
+  <hr>
+
+  <p>The <dfn id=dom-websocket-url title=dom-WebSocket-URL><code>URL</code></dfn>
   attribute must return the value that was passed to the
-  constructor.<p>The <dfn id=dom-websocket-readystate title=dom-WebSocket-readyState><code>readyState</code></dfn>
+  constructor.</p>
+
+  <p>The <dfn id=dom-websocket-readystate title=dom-WebSocket-readyState><code>readyState</code></dfn>
   attribute represents the state of the connection. It can have the
-  following values:<dl><dt><dfn id=dom-websocket-connecting title=dom-WebSocket-CONNECTING><code>CONNECTING</code></dfn> (numeric value 0)</dt>
+  following values:</p>
+
+  <dl>
+
+   <dt><dfn id=dom-websocket-connecting title=dom-WebSocket-CONNECTING><code>CONNECTING</code></dfn> (numeric value 0)</dt>
 
    <dd>The connection has not yet been established.</dd>
 
@@ -237,29 +370,54 @@
 
    <dd>The connection has been closed or could not be opened.</dd>
 
-  </dl><p>When the object is created its <code title=dom-WebSocket-readyState><a href=#dom-websocket-readystate>readyState</a></code> must be set to
+  </dl>
+
+  <p>When the object is created its <code title=dom-WebSocket-readyState><a href=#dom-websocket-readystate>readyState</a></code> must be set to
   <code title=dom-WebSocket-CONNECTING><a href=#dom-websocket-connecting>CONNECTING</a></code> (0). The
   steps executed when the constructor is invoked change this
-  attribute's value.<p>The <dfn id=dom-websocket-postmessage title=dom-WebSocket-postMessage><code>postMessage(<var title="">data</var>)</code></dfn> method transmits data using the
+  attribute's value.</p>
+
+  <p>The <dfn id=dom-websocket-postmessage title=dom-WebSocket-postMessage><code>postMessage(<var title="">data</var>)</code></dfn> method transmits data using the
   connection. If the connection is not established (<code title=dom-WebSocket-readyState><a href=#dom-websocket-readystate>readyState</a></code> is not <code title=dom-WebSocket-OPEN><a href=#dom-websocket-open>OPEN</a></code>), it must raise an
   <code>INVALID_STATE_ERR</code> exception. If the connection
-  <em>is</em> established, then the user agent must <span>send <var title="">data</var> using the Web Socket</span>.<p>The <dfn id=dom-websocket-disconnect title=dom-WebSocket-disconnect><code>disconnect()</code></dfn>
+  <em>is</em> established, then the user agent must <span>send <var title="">data</var> using the Web Socket</span>.</p>
+
+  <p>The <dfn id=dom-websocket-disconnect title=dom-WebSocket-disconnect><code>disconnect()</code></dfn>
   method must <span>close the Web Socket connection</span> or
   connection attempt, if any. If the connection is already closed, it
   must do nothing. Closing the connection causes a <code title=event-WebSocket-close><a href=#event-websocket-close>close</a></code> event to be fired and
   the <code title=dom-WebSocket-readyState><a href=#dom-websocket-readystate>readyState</a></code>
   attribute's value to change, as <a href=#closeWebSocket>described
-  below</a>.<h2 id=websocket-events><span class=secno>3 </span>WebSocket Events</h2><p>The <dfn id=event-websocket-open title=event-WebSocket-open><code>open</code></dfn>
+  below</a>.</p>
+
+
+  <h2 id=websocket-events><span class=secno>3 </span>WebSocket Events</h2>
+
+  <p>The <dfn id=event-websocket-open title=event-WebSocket-open><code>open</code></dfn>
   event is fired when the <span>Web Socket connection is
-  established</span>.<p>The <dfn id=event-websocket-close title=event-WebSocket-close><code>close</code></dfn>
+  established</span>.</p>
+
+  <p>The <dfn id=event-websocket-close title=event-WebSocket-close><code>close</code></dfn>
   event is fired when the connection is closed (whether by the author,
   calling the <code title=dom-WebSocket-disconnect><a href=#dom-websocket-disconnect>disconnect()</a></code> method, or by
-  the server, or by a network error).<p class=note>No information regarding why the connection was
+  the server, or by a network error).</p>
+
+  <p class=note>No information regarding why the connection was
   closed is passed to the application in this version of this
-  specification.<p>The <code title=event-message>message</code> event is fired
-  when when data is received for a connection.</p><hr><p>The following are the <span>event handler attributes</span> that
+  specification.</p>
+
+  <p>The <code title=event-message>message</code> event is fired
+  when when data is received for a connection.</p>
+
+  <hr>
+
+  <p>The following are the <span>event handler attributes</span> that
   must be supported, as DOM attributes, by all objects implementing
-  the <code><a href=#websocket>WebSocket</a></code> interface:<dl><dt><dfn id=handler-websocket-onopen title=handler-WebSocket-onopen><code>onopen</code></dfn></dt>
+  the <code><a href=#websocket>WebSocket</a></code> interface:</p>
+
+  <dl>
+
+   <dt><dfn id=handler-websocket-onopen title=handler-WebSocket-onopen><code>onopen</code></dfn></dt>
 
    <dd><p>Must be invoked whenever an <code title=event-WebSocket-open><a href=#event-websocket-open>open</a></code> event is targeted at or
    bubbles through the <code><a href=#websocket>WebSocket</a></code> object.</dd>
@@ -274,8 +432,18 @@
    <dd><p>Must be invoked whenever an <code title=event-WebSocket-closed>closed</code> event is targeted at or
    bubbles through the <code><a href=#websocket>WebSocket</a></code> object.</dd>
 
-  </dl><h2 id=feedback-from-the-protocol><span class=secno>4 </span>Feedback from the protocol</h2><p>When the <i>Web Socket connection is established</i>, the user
-  agent must run the following steps:<ol><li>
+  </dl>
+
+
+
+  <h2 id=feedback-from-the-protocol><span class=secno>4 </span>Feedback from the protocol</h2>
+
+  <p>When the <i>Web Socket connection is established</i>, the user
+  agent must run the following steps:</p>
+
+  <ol>
+
+   <li>
 
     <p>Change the <code title=dom-WebSocket-readyState><a href=#dom-websocket-readystate>readyState</a></code> attribute's value
     to <code title=dom-WebSocket-OPEN><a href=#dom-websocket-open>OPEN</a></code> (1).</p>
@@ -290,15 +458,38 @@
 
    </li>
 
-  </ol><hr><p>When <i>a Web Socket message has been received</i> with text <var title="">data</var>, the user agent must create an event that uses
+  </ol>
+
+  <hr>
+
+  <p>When <i>a Web Socket message has been received</i> with text <var title="">data</var>, the user agent must create an event that uses
   the <code>MessageEvent</code> interface, with the event name <code title=event-message>message</code>, which does not bubble, is
   cancelable, has no default action, and whose <code title=dom-MessageEvent-data>data</code> attribute is set to <var title="">data</var>, and <span>queue a task</span> to dispatch it at
-  the <code><a href=#websocket>WebSocket</a></code> object.</p><hr><p id=closeWebSocket>When the <i>Web Socket connection is
+  the <code><a href=#websocket>WebSocket</a></code> object.</p>
+
+  <hr>
+
+  <p id=closeWebSocket>When the <i>Web Socket connection is
   closed</i>, the <code title=dom-WebSocket-readyState><a href=#dom-websocket-readystate>readyState</a></code> attribute's value
   must be changed to <code title=dom-WebSocket-CLOSED><a href=#dom-websocket-closed>CLOSED</a></code>
   (2), and the user agent must <span>queue a task</span> to <span>fire
   a simple event</span> named <code title=event-WebSocket-close><a href=#event-websocket-close>close</a></code> at the
-  <code><a href=#websocket>WebSocket</a></code> object.</p><hr><p>The <span>task source</span> for all <span title=concept-task>tasks</span> <span title="queue a
+  <code><a href=#websocket>WebSocket</a></code> object.</p>
+
+  <hr>
+
+  <p>The <span>task source</span> for all <span title=concept-task>tasks</span> <span title="queue a
   task">queued</span> in this section is the <dfn id=web-socket-task-source>Web Socket task
-  source</dfn>.<h2 class=no-num id=references>References</h2><p class=big-issue>This section will be written in a future
-  draft.<!--XXX-->
+  source</dfn>.</p>
+
+
+
+
+  <h2 class=no-num id=references>References</h2>
+
+  <p class=big-issue>This section will be written in a future
+  draft.<!--XXX--></p>
+
+ 
+
+

Received on Friday, 13 February 2009 01:06:41 UTC