spec/Overview.html 1.1068 1879 Split Window into two (editorial-level)

Split Window into two (editorial-level) definitions. Clean up some
timeout stuff. (whatwg r1879) (changed by: Ian Hickson)

Diffs for this change per section: 
  Index
  http://people.w3.org/mike/diffs/html5/spec/Overview.1.1068.html#index
  WindowBrowsingContext
  http://people.w3.org/mike/diffs/html5/spec/Overview.1.1068.html#windowbrowsingcontext
  setTimeout(code, timeout[, language])
  http://people.w3.org/mike/diffs/html5/spec/Overview.1.1068.html#settimeout0
  TimeoutHandler
  http://people.w3.org/mike/diffs/html5/spec/Overview.1.1068.html#timeouthandler
  clearTimeout()
  http://people.w3.org/mike/diffs/html5/spec/Overview.1.1068.html#cleartimeout
  Window
  http://people.w3.org/mike/diffs/html5/spec/Overview.1.1068.html#window
  clearInterval()
  http://people.w3.org/mike/diffs/html5/spec/Overview.1.1068.html#clearinterval
  setInterval(...)
  http://people.w3.org/mike/diffs/html5/spec/Overview.1.1068.html#setinterval...
  WindowTimers
  http://people.w3.org/mike/diffs/html5/spec/Overview.1.1068.html#windowtimers
  5.2 The default view
  http://people.w3.org/mike/diffs/html5/spec/Overview.1.1068.html#the-default0
  10.4 Timers
  http://people.w3.org/mike/diffs/html5/spec/Overview.1.1068.html#timers
  10.3 Declarative 3D scenes
  http://people.w3.org/mike/diffs/html5/spec/Overview.1.1068.html#declarative0
  setTimeout(handler, timeout[, arguments...])
  http://people.w3.org/mike/diffs/html5/spec/Overview.1.1068.html#settimeout

Current content per affected section: 
  http://dev.w3.org/html5/spec/Overview.html#index
  http://dev.w3.org/html5/spec/Overview.html#windowbrowsingcontext
  http://dev.w3.org/html5/spec/Overview.html#settimeout0
  http://dev.w3.org/html5/spec/Overview.html#timeouthandler
  http://dev.w3.org/html5/spec/Overview.html#cleartimeout
  http://dev.w3.org/html5/spec/Overview.html#window
  http://dev.w3.org/html5/spec/Overview.html#clearinterval
  http://dev.w3.org/html5/spec/Overview.html#setinterval...
  http://dev.w3.org/html5/spec/Overview.html#windowtimers
  http://dev.w3.org/html5/spec/Overview.html#the-default0
  http://dev.w3.org/html5/spec/Overview.html#timers
  http://dev.w3.org/html5/spec/Overview.html#declarative0
  http://dev.w3.org/html5/spec/Overview.html#settimeout

Previously published WD content per affected section: 
  http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#index
  http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#windowbrowsingcontext
  http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#settimeout0
  http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#timeouthandler
  http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#cleartimeout
  http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#window
  http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#clearinterval
  http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#setinterval...
  http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#windowtimers
  http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#the-default0
  http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#timers
  http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#declarative0
  http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#settimeout

Cumulative diff: http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.1067&r2=1.1068&f=h

http://html5.org/tools/web-apps-tracker?from=1878&to=1879

===================================================================
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:43:38 UTC