W3C home > Mailing lists > Public > public-html-commits@w3.org > July 2008

html5/spec Overview.html,1.1055,1.1056

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Sat, 12 Jul 2008 10:50:17 +0000
To: public-html-commits@w3.org
Message-Id: <E1KHcgD-0002LM-DJ@lionel-hutz.w3.org>

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv8843

Modified Files:
	Overview.html 
Log Message:
Define the Pipe constructor; do other maintenance work around constructors. (whatwg r1867)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1055
retrieving revision 1.1056
diff -u -d -r1.1055 -r1.1056
--- Overview.html	12 Jul 2008 02:50:14 -0000	1.1055
+++ Overview.html	12 Jul 2008 10:50:14 -0000	1.1056
@@ -30460,9 +30460,6 @@
      processing</span>
   </dl>
 
-  <p class=big-issue>And when constructors are invoked but without using the
-   constructor syntax...?
-
   <h4 id=apis-for><span class=secno>5.2.3 </span>APIs for creating and
    navigating browsing contexts by name</h4>
 
@@ -41366,7 +41363,7 @@
 
   <pre class=idl>interface <dfn id=websocket0>WebSocket</dfn> {
   // constructor
-  [Constructor] <a href="#websocket0">WebSocket</a>(in DOMString url);
+  [<a href="#websocket1" title=dom-WebSocket>Constructor</a>] <a href="#websocket0">WebSocket</a>(in DOMString url);
   readonly attribute DOMString <a href="#url2" title=dom-WebSocket-URL>URL</a>;
 
   // ready state
@@ -41387,18 +41384,19 @@
    implement the <code>EventTarget</code> interface. <a
    href="#references">[DOM3EVENTS]</a>
 
-  <p>The <dfn id=websocket1 title=dom-WebSocket><code>WebSocket</code></dfn>
-   constructor takes one argument, <var title="">url</var>, which specifies
-   the <a href="#url">URL</a> to which to connect. When a <code><a
-   href="#websocket0">WebSocket</a></code> object is created, the UA must <a
-   href="#parse0" title="parse a url">parse</a> this argument and verify that
-   the URL parses without failure and has a <a href="#ltschemegt"
-   title=url-scheme>&lt;scheme&gt;</a> component whose value is either "<code
-   title="">ws</code>" or "<code title="">wss</code>", when compared
-   case-insensitively<!-- XXX ASCII -->. If it does, it has, and it is, then
-   the user agent must asynchronously <a href="#establish">establish a Web
-   Socket connection</a> to <var title="">url</var>. Otherwise, the
-   constructor must raise a <code>SYNTAX_ERR</code> exception.
+  <p>The <dfn id=websocket1 title=dom-WebSocket><code>WebSocket(<var
+   title="">url</var>)</code></dfn> constructor takes one argument, <var
+   title="">url</var>, which specifies the <a href="#url">URL</a> to which to
+   connect. When a <code><a href="#websocket0">WebSocket</a></code> object is
+   created, the UA must <a href="#parse0" title="parse a url">parse</a> this
+   argument and verify that the URL parses without failure and has a <a
+   href="#ltschemegt" title=url-scheme>&lt;scheme&gt;</a> component whose
+   value is either "<code title="">ws</code>" or "<code title="">wss</code>",
+   when compared case-insensitively<!-- XXX ASCII -->. If it does, it has,
+   and it is, then the user agent must asynchronously <a
+   href="#establish">establish a Web Socket connection</a> to <var
+   title="">url</var>. Otherwise, the constructor must raise a
+   <code>SYNTAX_ERR</code> exception.
 
   <p>The <dfn id=url2 title=dom-WebSocket-URL><code>URL</code></dfn>
    attribute must return the value that was passed to the constructor.
@@ -41642,8 +41640,8 @@
 
     <p>Send the <a href="#ascii" title="ASCII serialization of an
      origin">ASCII serialization</a> of the <a href="#origin0">origin</a> of
-     the script that invoked the <code><a
-     href="#websocket0">WebSocket</a></code> constructor.</p>
+     the script that invoked the <code title=dom-WebSocket><a
+     href="#websocket1">WebSocket()</a></code> constructor.</p>
 
     <p>Send the following bytes:</p>
 
@@ -41839,9 +41837,10 @@
 
      <dd>Assume the value is a <a href="#url">URL</a>. If the value does not
       have the <a href="#same-origin">same origin</a> as the script that
-      invoked the <code><a href="#websocket0">WebSocket</a></code>
-      constructor, then <a href="#fail-the">fail the Web Socket
-      connection</a> and abort these steps.
+      invoked the <code title=dom-WebSocket><a
+      href="#websocket1">WebSocket()</a></code> constructor, then <a
+      href="#fail-the">fail the Web Socket connection</a> and abort these
+      steps.
 
      <dt>If the entry's name is "<code title="">websocket-location</code>"
 
@@ -42334,10 +42333,9 @@
   <h3 id=pipe-messaging><span class=secno>7.5 </span><dfn
    id=pipe-messaging0>Pipe messaging</dfn></h3>
 
-  <p class=big-issue>...
-
-  <pre class=idl>[Constructor] interface <dfn id=pipe>Pipe</dfn> {
-  readonly attribute <a href="#pipeend0">PipeEnd</a> <span title=dom-pipe-end1>end1</span>;
+  <pre
+   class=idl>[<a href="#pipe0" title=dom-Pipe>Constructor</a>] interface <dfn id=pipe>Pipe</dfn> {
+  readonly attribute <a href="#pipeend0">PipeEnd</a> <a href="#end2" title=dom-pipe-end1>end1</a>;
   readonly attribute <a href="#pipeend0">PipeEnd</a> <span title=dom-pipe-end2>end2</span>;
 };
 
@@ -42353,7 +42351,54 @@
            attribute <span>EventListener</span> <span title=handler-endpipe-onunload>onunload</span>;
 };</pre>
 
-  <p class=big-issue>...
+  <p>When the <dfn id=pipe0 title=dom-Pipe><code>Pipe()</code></dfn>
+   constructor is called, it must run the following algorithm:
+
+  <ol>
+   <li>
+    <p><a href="#create">Create a new <code>PipeEnd</code> object</a> owned
+     by the <a href="#script3">script browsing context</a>, and let <var
+     title="">end1</var> be that object.
+
+   <li>
+    <p><a href="#create">Create a new <code>PipeEnd</code> object</a> owned
+     by the <a href="#script3">script browsing context</a>, and let <var
+     title="">end2</var> be that object.
+
+   <li>
+    <p><a href="#entangle">Entangle</a> the <var title="">end1</var> and <var
+     title="">end2</var> objects.
+
+   <li>
+    <p>Create a new <code><a href="#pipe">Pipe</a></code> object, and let
+     <var title="">pipe</var> be that object.
+
+   <li>
+    <p>Let the <code title=dom-pipe-end1><a href="#end2">end1</a></code>
+     attribute of the <var title="">pipe</var> object be <var
+     title="">end1</var>.</p>
+
+   <li>
+    <p>Let the <code title=dom-pipe-end2>end2</code> attribute of the <var
+     title="">pipe</var> object be <var title="">end2</var>.</p>
+
+   <li>
+    <p>Return <var title="">pipe</var>.
+  </ol>
+
+  <p class=big-issue><dfn id=end1 title=dom-pipe-end1><code>end1</code></dfn>
+   <dfn id=end2 title=dom-pipe-end1><code>end2</code></dfn>
+
+  <hr>
+
+  <p class=big-issue>When the user agent is to <dfn id=create>create a new
+   <code>PipeEnd</code> object</dfn> owned by a <code><a
+   href="#window">Window</a></code> object <var title="">owner</var>, it
+   must...
+
+  <p class=big-issue>When the user agent is to <dfn
+   id=entangle>entangle</dfn> teo <code><a
+   href="#pipeend0">PipeEnd</a></code> objects, it must...
 
   <h2 id=syntax><span class=secno>8. </span>The HTML syntax</h2>
 
@@ -46314,7 +46359,7 @@
   <h5 id=creating><span class=secno>8.2.5.1. </span>Creating and inserting
    elements</h5>
 
-  <p>When the steps below require the UA to <dfn id=create title="create an
+  <p>When the steps below require the UA to <dfn id=create0 title="create an
    element for the token">create an element for a token</dfn> in a particular
    namespace, the UA must create a node implementing the interface
    appropriate for the element type corresponding to the tag name of the
@@ -46334,7 +46379,7 @@
    defined by that namespace's specification is <code>Element</code>.
 
   <p>When the steps below require the UA to <dfn id=insert0>insert an HTML
-   element</dfn> for a token, the UA must first <a href="#create">create an
+   element</dfn> for a token, the UA must first <a href="#create0">create an
    element for the token</a> in the <a href="#html-namespace0">HTML
    namespace</a>, and then append this node to the <a
    href="#current5">current node</a>, and push it onto the <a
@@ -46348,7 +46393,7 @@
    happens in particular during the parsing of tables with invalid content.)
 
   <p>When the steps below require the UA to <dfn id=insert1>insert a foreign
-   element</dfn> for a token, the UA must first <a href="#create">create an
+   element</dfn> for a token, the UA must first <a href="#create0">create an
    element for the token</a> in the given namespace, and then append this
    node to the <a href="#current5">current node</a>, and push it onto the <a
    href="#stack">stack of open elements</a> so that it is the new <a
@@ -46571,7 +46616,7 @@
 
   <ol>
    <li>
-    <p><a href="#create">Create an element for the token</a> in the <a
+    <p><a href="#create0">Create an element for the token</a> in the <a
      href="#html-namespace0">HTML namespace</a>.
 
    <li>
@@ -46999,7 +47044,7 @@
    <dt>A start tag whose tag name is "html"
 
    <dd>
-    <p><a href="#create">Create an element for the token</a> in the <a
+    <p><a href="#create0">Create an element for the token</a> in the <a
      href="#html-namespace0">HTML namespace</a>. Append it to the
      <code>Document</code> object. Put this element in the <a
      href="#stack">stack of open elements</a>.</p>
@@ -47216,7 +47261,7 @@
    <dt id=scriptTag>A start tag whose tag name is "script"
 
    <dd>
-    <p><a href="#create">Create an element for the token</a> in the <a
+    <p><a href="#create0">Create an element for the token</a> in the <a
      href="#html-namespace0">HTML namespace</a>.</p>
 
     <p>Mark the element as being <a
@@ -48429,7 +48474,7 @@
    <dt>A start tag whose tag name is "textarea"
 
    <dd>
-    <p><a href="#create">Create an element for the token</a> in the <a
+    <p><a href="#create0">Create an element for the token</a> in the <a
      href="#html-namespace0">HTML namespace</a>. Append the new element to
      the <a href="#current5">current node</a>.</p>
 
Received on Saturday, 12 July 2008 10:50:51 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 9 October 2008 20:32:58 GMT