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

html5/spec Overview.html,1.1067,1.1068

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 15 Jul 2008 11:17:44 +0000
To: public-html-commits@w3.org
Message-Id: <E1KIiXQ-0001sT-7N@lionel-hutz.w3.org>

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

Modified Files:
	Overview.html 
Log Message:
Split Window into two (editorial-level) definitions. Clean up some timeout stuff. (whatwg r1879)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1067
retrieving revision 1.1068
diff -u -d -r1.1067 -r1.1068
--- Overview.html	15 Jul 2008 10:54:03 -0000	1.1067
+++ Overview.html	15 Jul 2008 11:17:41 -0000	1.1068
@@ -30308,12 +30308,17 @@
 
   <p>The <code>AbstractView</code> object of <a href="#default3"
    title="default view">default views</a> must also implement the <code><a
-   href="#window">Window</a></code> object.
+   href="#window">Window</a></code> and <code><a
+   href="#windowbrowsingcontext">WindowBrowsingContext</a></code> objects.
 
   <pre class=idl>[NoInterfaceObject] interface <dfn id=window>Window</dfn> {
-  // the current browsing context
+  // self-reference
   readonly attribute <a href="#window">Window</a> <a href="#window0" title=dom-window>window</a>;
   readonly attribute <a href="#window">Window</a> <a href="#self" title=dom-self>self</a>;
+};
+
+[NoInterfaceObject] interface <dfn id=windowbrowsingcontext>WindowBrowsingContext</dfn> {
+  // the current browsing context
            attribute DOMString <a href="#name9" title=dom-name>name</a>;
   [PutForwards=href] readonly attribute <a href="#location2">Location</a> <a href="#location0" title=dom-document-location>location</a>;
   readonly attribute <a href="#history2">History</a> <a href="#history1" title=dom-history>history</a>;
@@ -53386,22 +53391,26 @@
 
   <h3 id=timers><span class=secno>10.4 </span>Timers</h3>
 
-  <p>This section is expected to be moved to the Window Object specification
-   in due course.
+  <p class=big-issue>This section is expected to be moved to the Window
+   Object specification in due course.
 
-  <pre class=idl>
-[NoInterfaceObject] interface <dfn id=windowtimers>WindowTimers</dfn> {
+  <p>Objects that implement the <code><a href="#window">Window</a></code>
+   interface must also implement the <code><a
+   href="#windowtimers">WindowTimers</a></code> interface:
+
+  <pre
+   class=idl>[NoInterfaceObject] interface <dfn id=windowtimers>WindowTimers</dfn> {
   // timers
-  long <a href="#settimeout">setTimeout</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout);
-  long <a href="#settimeout">setTimeout</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout, <var title="">arguments...</var>);
-  long <a href="#settimeout">setTimeout</a>(in DOMString code, in long timeout);
-  long <a href="#settimeout">setTimeout</a>(in DOMString code, in long timeout, in DOMString language);
-  void <a href="#cleartimeout">clearTimeout</a>(in long handle);
-  long <a href="#setinterval...">setInterval</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout);
-  long <a href="#setinterval...">setInterval</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout, <var title="">arguments...</var>);
-  long <a href="#setinterval...">setInterval</a>(in DOMString code, in long timeout);
-  long <a href="#setinterval...">setInterval</a>(in DOMString code, in long timeout, in DOMString language);
-  void <a href="#clearinterval">clearInterval</a>(in long handle);
+  long <a href="#settimeout" title=dom-windowtimers-setTimeout>setTimeout</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout);
+  long <a href="#settimeout" title=dom-windowtimers-setTimeout>setTimeout</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout, <var title="">arguments...</var>);
+  long <a href="#settimeout" title=dom-windowtimers-setTimeout>setTimeout</a>(in DOMString code, in long timeout);
+  long <a href="#settimeout" title=dom-windowtimers-setTimeout>setTimeout</a>(in DOMString code, in long timeout, in DOMString language);
+  void <a href="#cleartimeout" title=dom-windowtimers-clearTimeout>clearTimeout</a>(in long handle);
+  long <a href="#setinterval..." title=dom-windowtimers-setInterval>setInterval</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout);
+  long <a href="#setinterval..." title=dom-windowtimers-setInterval>setInterval</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout, <var title="">arguments...</var>);
+  long <a href="#setinterval..." title=dom-windowtimers-setInterval>setInterval</a>(in DOMString code, in long timeout);
+  long <a href="#setinterval..." title=dom-windowtimers-setInterval>setInterval</a>(in DOMString code, in long timeout, in DOMString language);
+  void <a href="#clearinterval" title=dom-windowtimers-clearInterval>clearInterval</a>(in long handle);
 };
 
 interface <dfn id=timeouthandler>TimeoutHandler</dfn> {
@@ -53409,18 +53418,14 @@
 };
 </pre>
 
-  <p>The <code><a href="#windowtimers">WindowTimers</a></code> interface must
-   be obtainable from any <code><a href="#window">Window</a></code> object
-   using binding-specific casting methods.
-
-  <p class=big-issue>Actually even better would be to just mix it straight
-   into Window somehow.
-
-  <p>The <code><a href="#settimeout">setTimeout</a></code> and <code><a
+  <p>The <code title=dom-windowtimers-setTimeout><a
+   href="#settimeout">setTimeout</a></code> and <code
+   title=dom-windowtimers-setInterval><a
    href="#setinterval...">setInterval</a></code> methods allow authors to
    schedule timer-based events.
 
-  <p>The <dfn id=settimeout title=setTimeout><code>setTimeout(<var
+  <p>The <dfn id=settimeout
+   title=dom-windowtimers-setTimeout><code>setTimeout(<var
    title="">handler</var>, <var title="">timeout</var>[, <var
    title="">arguments...</var>])</code></dfn> method takes a reference to a
    <code><a href="#timeouthandler">TimeoutHandler</a></code> object and a
@@ -53440,32 +53445,33 @@
    ECMAScript if the third argument is omitted) and executed in the scope of
    the <a href="#browsing1">browsing context</a> associated with the <code><a
    href="#window">Window</a></code> object on which the <code
-   title=setTimeout><a href="#settimeout">setTimeout()</a></code> method was
-   invoked.
+   title=setTimeout>setTimeout()</code> method was invoked.
 
   <p class=big-issue>Need to define <var title="">language</var> values.
 
-  <p>The <dfn id=setinterval...><code>setInterval(...)</code></dfn> variants
-   must work in the same way as the <code><a
-   href="#settimeout">setTimeout</a></code> variants except that if <var
-   title="">timeout</var> is a value greater than zero, the <var
-   title="">handler</var> or <code><a href="#code">code</a></code> must be
-   invoked again every <var title="">timeout</var> milliseconds, not just the
-   once.</p>
-  <!-- so setInterval(x) and setInterval(x, 0) are
-  equivalent to setTimeout(x) and setTimeout(x, 0) respectively -->
+  <p>The <dfn id=setinterval...
+   title=dom-windowtimers-setInterval><code>setInterval(...)</code></dfn>
+   variants must work in the same way as the <code>setTimeout</code> variants
+   except that if <var title="">timeout</var> is a value greater than zero,
+   the <var title="">handler</var> or <code><a href="#code">code</a></code>
+   must be invoked again every <var title="">timeout</var> milliseconds, not
+   just the once.</p>
+  <!-- so
+  setInterval(x) and setInterval(x, 0) are equivalent to setTimeout(x)
+  and setTimeout(x, 0) respectively -->
 
-  <p>The <dfn id=cleartimeout><code>clearTimeout()</code></dfn> and <dfn
-   id=clearinterval><code>clearInterval()</code></dfn> methods take one
-   integer (the value returned by <code><a
-   href="#settimeout">setTimeout</a></code> and <code><a
-   href="#setinterval...">setInterval</a></code> respectively) and must
-   cancel the specified timeout. When called with a value that does not
-   correspond to an active timeout or interval, the methods must return
-   without doing anything.
+  <p>The <dfn id=cleartimeout
+   title=dom-windowtimers-clearTimeout><code>clearTimeout()</code></dfn> and
+   <dfn id=clearinterval
+   title=dom-windowtimers-clearInterval><code>clearInterval()</code></dfn>
+   methods take one integer (the value returned by <code>setTimeout</code>
+   and <code>setInterval</code> respectively) and must cancel the specified
+   timeout. When called with a value that does not correspond to an active
+   timeout or interval, the methods must return without doing anything.
 
   <p>Timeouts must never fire while another script is executing. (Thus the
-   HTML scripting model is strictly single-threaded and not reentrant.)
+   HTML scripting model is strictly single-threaded and not reentrant.)</p>
+  <!-- XXX queue -->
 
   <h2 class=no-num id=index>Index</h2>
 
Received on Tuesday, 15 July 2008 11:18:19 GMT

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