W3C home > Mailing lists > Public > public-html-commits@w3.org > January 2009

html5/workers Overview.html,1.76,1.77

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 14 Jan 2009 09:10:09 +0000
To: public-html-commits@w3.org
Message-Id: <E1LN1lJ-0005AL-4R@lionel-hutz.w3.org>

Update of /sources/public/html5/workers
In directory hutz:/tmp/cvs-serv19843

Modified Files:
	Overview.html 
Log Message:
Drag the IDL of Workers into 2009. (whatwg r84)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/workers/Overview.html,v
retrieving revision 1.76
retrieving revision 1.77
diff -u -d -r1.76 -r1.77
--- Overview.html	27 Dec 2008 23:24:21 -0000	1.76
+++ Overview.html	14 Jan 2009 09:10:06 -0000	1.77
@@ -16,11 +16,11 @@
    <h1>Web Workers</h1>
 
    <h2 class="no-num no-toc" id=editors><!-- "W3C Working Draft" --> Editor's
-    Draft <!--ZZZ-->27 December 2008</h2>
+    Draft <!--ZZZ-->14 January 2009</h2>
 
    <dl><!-- ZZZ: update the month/day
     <dt>This Version:</dt>
-    <dd><a href="http://www.w3.org/TR/2008/WD-workers-20080101/">http://www.w3.org/TR/2008/WD-workers-20080101/</a></dd>
+    <dd><a href="http://www.w3.org/TR/2009/WD-workers-20090101/">http://www.w3.org/TR/2009/WD-workers-20090101/</a></dd>
     <dt>Latest Published Version:</dt>
     <dd><a href="http://www.w3.org/TR/workers/">http://www.w3.org/TR/workers/</a></dd>
  :ZZZ -->
@@ -142,7 +142,7 @@
   <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 27 December 2008 <!--ZZZ "Working Draft"-->Editor's
+   specification is the 14 January 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 -->
   <!-- relationship to other work (required) -->
@@ -177,7 +177,7 @@
   <!--begin-toc-->
 
   <ul class=toc>
-   <li><a href="#introduction"><span class=secno>1. </span>Introduction</a>
+   <li><a href="#introduction"><span class=secno>1 </span>Introduction</a>
     <ul class=toc>
      <li><a href="#scope"><span class=secno>1.1 </span>Scope</a>
 
@@ -212,7 +212,7 @@
      <li><a href="#terminology"><span class=secno>1.4 </span>Terminology</a>
     </ul>
 
-   <li><a href="#infrastructure"><span class=secno>2.
+   <li><a href="#infrastructure"><span class=secno>2
     </span>Infrastructure</a>
     <ul class=toc>
      <li><a href="#the-global"><span class=secno>2.1 </span>The global
@@ -259,8 +259,8 @@
       </ul>
     </ul>
 
-   <li><a href="#apis-available"><span class=secno>3. </span>APIs available
-    to workers</a>
+   <li><a href="#apis-available"><span class=secno>3 </span>APIs available to
+    workers</a>
     <ul class=toc>
      <li><a href="#importing"><span class=secno>3.1 </span>Importing scripts
       and libraries</a>
@@ -286,7 +286,7 @@
 
   <hr>
 
-  <h2 id=introduction><span class=secno>1. </span>Introduction</h2>
+  <h2 id=introduction><span class=secno>1 </span>Introduction</h2>
 
   <h3 id=scope><span class=secno>1.1 </span>Scope</h3>
 
@@ -1214,7 +1214,7 @@
    retrieved (e.g. by author script), and is said to be <em>setting</em> when
    a new value is assigned to it.
 
-  <h2 id=infrastructure><span class=secno>2. </span>Infrastructure</h2>
+  <h2 id=infrastructure><span class=secno>2 </span>Infrastructure</h2>
 
   <p>There are two kinds of workers; dedicated workers, and shared workers.
    Dedicated workers, once created, and are linked to their creator; but
@@ -1232,7 +1232,7 @@
    href="#workerglobalscope">WorkerGlobalScope</a></code> abstract interface</h4>
 
   <pre
-   class=idl>[NoInterfaceObject] interface <dfn id=workerglobalscope>WorkerGlobalScope</dfn> {
+   class=idl>interface <dfn id=workerglobalscope>WorkerGlobalScope</dfn> {
   readonly attribute <a href="#workerglobalscope">WorkerGlobalScope</a> <a href="#self" title=dom-WorkerGlobalScope-self>self</a>;
   readonly attribute <a href="#workerlocation">WorkerLocation</a> <a href="#location" title=dom-WorkerGlobalScope-location>location</a>;
   // also implements everything on <a href="#workerutils">WorkerUtils</a>
@@ -1314,12 +1314,12 @@
    <code><a
    href="#dedicatedworkerglobalscope">DedicatedWorkerGlobalScope</a></code>
    interface</h4>
+  <!-- the XXX below is for collapsing this interface onto WorkerGlobalScope so it looks like just one interface - the inheritance is a spec fiction only -->
 
   <pre
-   class=idl>[NoInterfaceObject] interface <dfn id=dedicatedworkerglobalscope>DedicatedWorkerGlobalScope</dfn> : <a href="#workerglobalscope">WorkerGlobalScope</a> {
-  void <a href="#postmessage" title=dom-DedicatedWorkerGlobalScope-postMessage>postMessage</a>(in DOMString message);
-  void <a href="#postmessage" title=dom-DedicatedWorkerGlobalScope-postMessage>postMessage</a>(in DOMString message, in <span>MessagePort</span> messagePort);<!--
-  <span>MessagePort</span> <span title="dom-DedicatedWorkerGlobalScope-startConversation">startConversation</span>(in DOMString message);-->
+   class=idl>[NoInterfaceObject, XXX] interface <dfn id=dedicatedworkerglobalscope>DedicatedWorkerGlobalScope</dfn> : <a href="#workerglobalscope">WorkerGlobalScope</a> {
+  void <a href="#postmessage" title=dom-DedicatedWorkerGlobalScope-postMessage>postMessage</a>(in any message, [Optional] in <span>MessagePort</span> messagePort);<!--
+  <span>MessagePort</span> <span title="dom-DedicatedWorkerGlobalScope-startConversation">startConversation</span>(in any message);-->
            attribute <span>EventListener</span> <a href="#onmessage" title=handler-DedicatedWorkerGlobalScope-onmessage>onmessage</a>;
 };</pre>
 
@@ -1368,9 +1368,10 @@
    <code><a
    href="#sharedworkerglobalscope">SharedWorkerGlobalScope</a></code>
    inteface</h4>
+  <!-- the XXX below is for collapsing this interface onto WorkerGlobalScope so it looks like just one interface - the inheritance is a spec fiction only -->
 
   <pre
-   class=idl>[NoInterfaceObject] interface <dfn id=sharedworkerglobalscope>SharedWorkerGlobalScope</dfn> : <a href="#workerglobalscope">WorkerGlobalScope</a> {
+   class=idl>[NoInterfaceObject, XXX] interface <dfn id=sharedworkerglobalscope>SharedWorkerGlobalScope</dfn> : <a href="#workerglobalscope">WorkerGlobalScope</a> {
   readonly attribute DOMString <a href="#name" title=dom-SharedWorkerGlobalScope-name>name</a>;
            attribute <span>EventListener</span> <a href="#onconnect" title=handler-SharedWorkerGlobalScope-onconnect>onconnect</a>;
 };</pre>
@@ -1831,8 +1832,7 @@
   <h4 id=the-abstractworker><span class=secno>2.6.1 </span>The <code><a
    href="#abstractworker">AbstractWorker</a></code> abstract interface</h4>
 
-  <pre
-   class=idl>[NoInterfaceObject] interface <dfn id=abstractworker>AbstractWorker</dfn> {
+  <pre class=idl>interface <dfn id=abstractworker>AbstractWorker</dfn> {
            attribute <span>EventListener</span> <a href="#onerror0" title=handler-AbstractWorker-onerror>onerror</a>;
            attribute <span>EventListener</span> <a href="#onclose0" title=handler-AbstractWorker-onclose>onclose</a>;
 };</pre>
@@ -1866,14 +1866,13 @@
   <h4 id=dedicated0><span class=secno>2.6.2 </span>Dedicated workers and the
    <code><a href="#worker1">Worker</a></code> interface</h4>
 
-  <pre class=idl>[NoInterfaceObject,
- <a href="#worker2" title=dom-Worker>Constructor</a>(in DOMString scriptURL)]
+  <pre
+   class=idl>[<a href="#worker2" title=dom-Worker>Constructor</a>(in DOMString scriptURL)]
 interface <dfn id=worker1>Worker</dfn> : <a href="#abstractworker">AbstractWorker</a> {
   void <a href="#terminate0" title=dom-Worker-terminate>terminate</a>();
 
-  void <a href="#postmessage0" title=dom-Worker-postMessage>postMessage</a>(in DOMString message);
-  void <a href="#postmessage0" title=dom-Worker-postMessage>postMessage</a>(in DOMString message, in <span>MessagePort</span> messagePort);<!--
-  <span>MessagePort</span> <span title="dom-Worker-startConversation">startConversation</span>(in DOMString message);-->
+  void <a href="#postmessage0" title=dom-Worker-postMessage>postMessage</a>(in any message, [Optional] in <span>MessagePort</span> messagePort);<!--
+  <span>MessagePort</span> <span title="dom-Worker-startConversation">startConversation</span>(in any message);-->
            attribute <span>EventListener</span> <a href="#onmessage0" title=handler-Worker-onmessage>onmessage</a>;
 };</pre>
 
@@ -1991,8 +1990,8 @@
   <h4 id=shared1><span class=secno>2.6.3 </span>Shared workers and the
    <code><a href="#sharedworker">SharedWorker</a></code> interface</h4>
 
-  <pre class=idl>[NoInterfaceObject,
- <a href="#sharedworker0" title=dom-SharedWorker>Constructor</a>(in DOMString scriptURL, in DOMString name)]
+  <pre
+   class=idl>[<a href="#sharedworker0" title=dom-SharedWorker>Constructor</a>(in DOMString scriptURL, in DOMString name)]
 interface <dfn id=sharedworker>SharedWorker</dfn> : <a href="#abstractworker">AbstractWorker</a> {
   readonly attribute <code>MessagePort</code> <a href="#port" title=dom-SharedWorker-port>port</a>;
 };</pre>
@@ -2147,16 +2146,16 @@
      global scope.</p>
   </ol>
 
-  <h2 id=apis-available><span class=secno>3. </span>APIs available to workers</h2>
+  <h2 id=apis-available><span class=secno>3 </span>APIs available to workers</h2>
+  <!-- the XXX below is for collapsing this interface onto WorkerGlobalScope so it looks like just one interface - the inheritance is a spec fiction only -->
 
   <pre
-   class=idl>[NoInterfaceObject] interface <dfn id=workerutils>WorkerUtils</dfn> {
+   class=idl>[NoInterfaceObject, ImplementedOn=WorkerGlobalScope, XXX] interface <dfn id=workerutils>WorkerUtils</dfn> {
   void <a href="#importscripts" title=dom-WorkerGlobalScope-importScripts>importScripts</a>([Variadic] in DOMString urls);
   readonly attribute <span>Storage</span> <a href="#localstorage" title=dom-localStorage>localStorage</a>;
   readonly attribute <a href="#navigator0">Navigator</a> <a href="#navigator" title=dom-navigator>navigator</a>;
-  <span>Database</span> <a href="#opendatabase" title=dom-opendatabase>openDatabase</a>(in DOMString name, in DOMString version, in DOMString displayName, in unsigned long estimatedSize);
-  void <a href="#shownotification" title=dom-showNotification>showNotification</a>(in DOMString title, in DOMString subtitle, in DOMString description);
-  void <a href="#shownotification" title=dom-showNotification>showNotification</a>(in DOMString title, in DOMString subtitle, in DOMString description, in VoidCallback onclick);
+  <span>Database</span> <a href="#opendatabase" title=dom-opendatabase>openDatabase</a>(in DOMString name, in DOMString version, in DOMString displayName, in unsigned long estimatedSize);<!--
+  void <span title="dom-showNotification">showNotification</span>(in DOMString title, in DOMString subtitle, in DOMString description, [Optional] in VoidCallback onclick); XXX-NOTIFY -->
 };</pre>
 
   <p>Objects that implement the <code><a
@@ -2271,8 +2270,7 @@
    href="#navigator0">Navigator</a></code> interface, which represents the
    identity and state of the user agent (the client):
 
-  <pre
-   class=idl>[NoInterfaceObject] interface <dfn id=navigator0>Navigator</dfn> {
+  <pre class=idl>interface <dfn id=navigator0>Navigator</dfn> {
   // objects implementing this interface also implement the interfaces listed below
 };</pre>
 
@@ -2334,8 +2332,7 @@
 
   <h3 id=worker0><span class=secno>3.5 </span>Worker locations</h3>
 
-  <pre
-   class=idl>[NoInterfaceObject] interface <dfn id=workerlocation>WorkerLocation</dfn> {
+  <pre class=idl>interface <dfn id=workerlocation>WorkerLocation</dfn> {
   readonly attribute DOMString <a href="#href" title=dom-WorkerLocation-href>href</a>;
   readonly attribute DOMString <a href="#protocol" title=dom-WorkerLocation-protocol>protocol</a>;
   readonly attribute DOMString <a href="#host" title=dom-WorkerLocation-host>host</a>;
Received on Wednesday, 14 January 2009 09:10:17 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 14 January 2009 09:10:18 GMT