[html5] r1879 - [e] (0) Split Window into two (editorial-level) definitions. Clean up some timeo [...]

whatwg at whatwg.org whatwg at whatwg.org
Tue Jul 15 04:17:38 PDT 2008


Author: ianh
Date: 2008-07-15 04:17:37 -0700 (Tue, 15 Jul 2008)
New Revision: 1879

Modified:
   index
   source
Log:
[e] (0) Split Window into two (editorial-level) definitions. Clean up some timeout stuff.

Modified: index
===================================================================
--- index	2008-07-15 10:53:59 UTC (rev 1878)
+++ index	2008-07-15 11:17:37 UTC (rev 1879)
@@ -30246,12 +30246,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>;
@@ -53324,22 +53329,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> {
@@ -53347,18 +53356,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
@@ -53378,32 +53383,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>
 

Modified: source
===================================================================
--- source	2008-07-15 10:53:59 UTC (rev 1878)
+++ source	2008-07-15 11:17:37 UTC (rev 1879)
@@ -27736,12 +27736,17 @@
 
   <p>The <code>AbstractView</code> object of <span title="default
   view">default views</span> must also implement the
-  <code>Window</code> object.</p>
+  <code>Window</code> and <code>WindowBrowsingContext</code>
+  objects.</p>
 
   <pre class="idl">[NoInterfaceObject] interface <dfn>Window</dfn> {
-  // the current browsing context
+  // self-reference
   readonly attribute <span>Window</span> <span title="dom-window">window</span>;
   readonly attribute <span>Window</span> <span title="dom-self">self</span>;
+};
+
+[NoInterfaceObject] interface <dfn>WindowBrowsingContext</dfn> {
+  // the current browsing context
            attribute DOMString <span title="dom-name">name</span>;
   [PutForwards=href] readonly attribute <span>Location</span> <span title="dom-document-location">location</span>;
   readonly attribute <span>History</span> <span title="dom-history">history</span>;
@@ -48574,22 +48579,24 @@
 
   <h3 id="timers">Timers</h3>
 
-  <p>This section is expected to be moved to the Window Object
-  specification in due course.</p>
+  <p class="big-issue">This section is expected to be moved to the
+  Window Object specification in due course.</p>
 
-<pre class="idl">
-[NoInterfaceObject] interface <dfn>WindowTimers</dfn> {
+  <p>Objects that implement the <code>Window</code> interface must
+  also implement the <code>WindowTimers</code> interface:</p>
+
+<pre class="idl">[NoInterfaceObject] interface <dfn>WindowTimers</dfn> {
   // timers
-  long <span>setTimeout</span>(in <span>TimeoutHandler</span> handler, in long timeout);
-  long <span>setTimeout</span>(in <span>TimeoutHandler</span> handler, in long timeout, <var title="">arguments...</var>);
-  long <span>setTimeout</span>(in DOMString code, in long timeout);
-  long <span>setTimeout</span>(in DOMString code, in long timeout, in DOMString language);
-  void <span>clearTimeout</span>(in long handle);
-  long <span>setInterval</span>(in <span>TimeoutHandler</span> handler, in long timeout);
-  long <span>setInterval</span>(in <span>TimeoutHandler</span> handler, in long timeout, <var title="">arguments...</var>);
-  long <span>setInterval</span>(in DOMString code, in long timeout);
-  long <span>setInterval</span>(in DOMString code, in long timeout, in DOMString language);
-  void <span>clearInterval</span>(in long handle);
+  long <span title="dom-windowtimers-setTimeout">setTimeout</span>(in <span>TimeoutHandler</span> handler, in long timeout);
+  long <span title="dom-windowtimers-setTimeout">setTimeout</span>(in <span>TimeoutHandler</span> handler, in long timeout, <var title="">arguments...</var>);
+  long <span title="dom-windowtimers-setTimeout">setTimeout</span>(in DOMString code, in long timeout);
+  long <span title="dom-windowtimers-setTimeout">setTimeout</span>(in DOMString code, in long timeout, in DOMString language);
+  void <span title="dom-windowtimers-clearTimeout">clearTimeout</span>(in long handle);
+  long <span title="dom-windowtimers-setInterval">setInterval</span>(in <span>TimeoutHandler</span> handler, in long timeout);
+  long <span title="dom-windowtimers-setInterval">setInterval</span>(in <span>TimeoutHandler</span> handler, in long timeout, <var title="">arguments...</var>);
+  long <span title="dom-windowtimers-setInterval">setInterval</span>(in DOMString code, in long timeout);
+  long <span title="dom-windowtimers-setInterval">setInterval</span>(in DOMString code, in long timeout, in DOMString language);
+  void <span title="dom-windowtimers-clearInterval">clearInterval</span>(in long handle);
 };
 
 interface <dfn>TimeoutHandler</dfn> {
@@ -48597,17 +48604,12 @@
 };
 </pre>
 
-  <p>The <code>WindowTimers</code> interface must be obtainable from
-  any <code>Window</code> object using binding-specific casting
-  methods.</p>
+  <p>The <code title="dom-windowtimers-setTimeout">setTimeout</code>
+  and <code title="dom-windowtimers-setInterval">setInterval</code>
+  methods allow authors to schedule timer-based events.</p>
 
-  <p class="big-issue">Actually even better would be to just mix it
-  straight into Window somehow.</p>
-
-  <p>The <code>setTimeout</code> and <code>setInterval</code> methods
-  allow authors to schedule timer-based events.</p>
-
-  <p>The <dfn title="setTimeout"><code>setTimeout(<var
+  <p>The <dfn
+  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>TimeoutHandler</code> object and a length of time in
@@ -48630,27 +48632,32 @@
   which the <code title="setTimeout">setTimeout()</code> method was
   invoked.</p>
 
-  <p class="big-issue">Need to define <var title="">language</var> values.</p>
+  <p class="big-issue">Need to define <var title="">language</var>
+  values.</p>
 
-  <p>The <dfn><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>code</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
+  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>code</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><code>clearTimeout()</code></dfn> and
-  <dfn><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>
+  <p>The <dfn
+  title="dom-windowtimers-clearTimeout"><code>clearTimeout()</code></dfn>
+  and <dfn
+  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>
 
   <p>Timeouts must never fire while another script is executing. (Thus
   the HTML scripting model is strictly single-threaded and not
-  reentrant.)</p>
+  reentrant.)</p><!-- XXX queue -->
 
 
 




More information about the Commit-Watchers mailing list