- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 12 Jul 2008 10:50:17 +0000
- To: public-html-commits@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><scheme></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><scheme></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 UTC