[html5] r7301 - [e] (0) Clean up some IDL and be more consistent with Web IDL. Fixing https://ww [...]

whatwg at whatwg.org whatwg at whatwg.org
Thu Aug 30 12:03:33 PDT 2012


Author: ianh
Date: 2012-08-30 12:03:31 -0700 (Thu, 30 Aug 2012)
New Revision: 7301

Modified:
   complete.html
   index
   source
Log:
[e] (0) Clean up some IDL and be more consistent with Web IDL.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=17612
Affected topics: HTML

Modified: complete.html
===================================================================
--- complete.html	2012-08-30 17:58:22 UTC (rev 7300)
+++ complete.html	2012-08-30 19:03:31 UTC (rev 7301)
@@ -75709,17 +75709,15 @@
 
   <pre class=idl>[NoInterfaceObject]
 interface <dfn id=windowtimers>WindowTimers</dfn> {
-  long <a href=#dom-windowtimers-settimeout title=dom-windowtimers-setTimeout>setTimeout</a>(<a href=#arbitrarycallback>ArbitraryCallback</a> handler, optional long timeout, any... args);
-  long <a href=#dom-windowtimers-settimeout title=dom-windowtimers-setTimeout>setTimeout</a>(DOMString handler, optional long timeout, any... args);
+  long <a href=#dom-windowtimers-settimeout title=dom-windowtimers-setTimeout>setTimeout</a>(<span>Function</span> handler, optional long timeout, any... arguments);
+  long <a href=#dom-windowtimers-settimeout title=dom-windowtimers-setTimeout>setTimeout</a>(DOMString handler, optional long timeout, any... arguments);
   void <a href=#dom-windowtimers-cleartimeout title=dom-windowtimers-clearTimeout>clearTimeout</a>(long handle);
-  long <a href=#dom-windowtimers-setinterval title=dom-windowtimers-setInterval>setInterval</a>(<a href=#arbitrarycallback>ArbitraryCallback</a> handler, optional long timeout, any... args);
-  long <a href=#dom-windowtimers-setinterval title=dom-windowtimers-setInterval>setInterval</a>(DOMString handler, optional long timeout, any... args);
+  long <a href=#dom-windowtimers-setinterval title=dom-windowtimers-setInterval>setInterval</a>(<span>Function</span> handler, optional long timeout, any... arguments);
+  long <a href=#dom-windowtimers-setinterval title=dom-windowtimers-setInterval>setInterval</a>(DOMString handler, optional long timeout, any... arguments);
   void <a href=#dom-windowtimers-clearinterval title=dom-windowtimers-clearInterval>clearInterval</a>(long handle);
 };
-<a href=#window>Window</a> implements <a href=#windowtimers>WindowTimers</a>;
+<a href=#window>Window</a> implements <a href=#windowtimers>WindowTimers</a>;</pre>
 
-[TreatNonCallableAsNull] callback <dfn id=arbitrarycallback>ArbitraryCallback</dfn> = any (any... args);</pre>
-
   <!-- Demonstrating the need for wrapping of the timeout argument value treated as long rather than clamping or treating as double:
           http://software.hixie.ch/utilities/js/live-dom-viewer/saved/1228
        Demonstrating the need for the timeout argument to be signed rather than unsigned:
@@ -75809,7 +75807,7 @@
    <li><p><a href=#get-the-timed-task>Get the timed task</a> <var title="">handle</var>
    in the <a href=#list-of-active-timers>list of active timers</a>, and let <var title="">task</var> be the result. This algorithm uses the first
    argument to the method (<var title="">handler</var>) and, if there
-   are any, the third and subsequent arguments to the method (<var title="">args</var>), to establish precisely what <var title="">task</var> does.</li>
+   are any, the third and subsequent arguments to the method (<var title="">arguments</var>), to establish precisely what <var title="">task</var> does.</li>
 
    <li><p>Let <var title="">timeout</var> be the second argument to
    the method, or zero if the argument was omitted.</li>
@@ -75910,7 +75908,7 @@
    <li><p><a href=#get-the-timed-task>Get the timed task</a> <var title="">handle</var>
    in the <a href=#list-of-active-timers>list of active timers</a>, and let <var title="">task</var> be the result. This algorithm uses the first
    argument to the method (<var title="">handler</var>) and, if there
-   are any, the third and subsequent arguments to the method (<var title="">args</var>), to establish precisely what <var title="">task</var> does.</li>
+   are any, the third and subsequent arguments to the method (<var title="">arguments</var>), to establish precisely what <var title="">task</var> does.</li>
 
    <li><p>Let <var title="">timeout</var> be the second argument to
    the method, or zero if the argument was omitted.</li>
@@ -75983,12 +75981,12 @@
 
   <ol><li>
 
-    <p>If the first argument to the invoked method is an
-    <code><a href=#arbitrarycallback>ArbitraryCallback</a></code>, then return a <a href=#concept-task title=concept-task>task</a> that checks if the entry for <var title="">handle</var> in <var title="">list</var> has been
-    cleared, and if it has not, calls the
-    <code><a href=#arbitrarycallback>ArbitraryCallback</a></code> with as its arguments the third and
-    subsequent arguments to the invoked method (if any) and with an
-    undefined <var title="">thisArg</var>, and abort these steps. <a href=#refsECMA262>[ECMA262]</a></p>
+    <p>If the first argument to the invoked method is a
+    <code>Function</code>, then return a <a href=#concept-task title=concept-task>task</a> that checks if the entry for <var title="">handle</var> in <var title="">list</var> has been
+    cleared, and if it has not, calls the <code>Function</code> with
+    as its arguments the third and subsequent arguments to the invoked
+    method (if any) and with an undefined <var title="">thisArg</var>,
+    and abort these steps. <a href=#refsECMA262>[ECMA262]</a></p>
 
     <p class=note>Setting <var title="">thisArg</var> to undefined
     means that the function code will be executed with the <code title="">this</code> keyword bound to the <code><a href=#windowproxy>WindowProxy</a></code>

Modified: index
===================================================================
--- index	2012-08-30 17:58:22 UTC (rev 7300)
+++ index	2012-08-30 19:03:31 UTC (rev 7301)
@@ -75709,17 +75709,15 @@
 
   <pre class=idl>[NoInterfaceObject]
 interface <dfn id=windowtimers>WindowTimers</dfn> {
-  long <a href=#dom-windowtimers-settimeout title=dom-windowtimers-setTimeout>setTimeout</a>(<a href=#arbitrarycallback>ArbitraryCallback</a> handler, optional long timeout, any... args);
-  long <a href=#dom-windowtimers-settimeout title=dom-windowtimers-setTimeout>setTimeout</a>(DOMString handler, optional long timeout, any... args);
+  long <a href=#dom-windowtimers-settimeout title=dom-windowtimers-setTimeout>setTimeout</a>(<span>Function</span> handler, optional long timeout, any... arguments);
+  long <a href=#dom-windowtimers-settimeout title=dom-windowtimers-setTimeout>setTimeout</a>(DOMString handler, optional long timeout, any... arguments);
   void <a href=#dom-windowtimers-cleartimeout title=dom-windowtimers-clearTimeout>clearTimeout</a>(long handle);
-  long <a href=#dom-windowtimers-setinterval title=dom-windowtimers-setInterval>setInterval</a>(<a href=#arbitrarycallback>ArbitraryCallback</a> handler, optional long timeout, any... args);
-  long <a href=#dom-windowtimers-setinterval title=dom-windowtimers-setInterval>setInterval</a>(DOMString handler, optional long timeout, any... args);
+  long <a href=#dom-windowtimers-setinterval title=dom-windowtimers-setInterval>setInterval</a>(<span>Function</span> handler, optional long timeout, any... arguments);
+  long <a href=#dom-windowtimers-setinterval title=dom-windowtimers-setInterval>setInterval</a>(DOMString handler, optional long timeout, any... arguments);
   void <a href=#dom-windowtimers-clearinterval title=dom-windowtimers-clearInterval>clearInterval</a>(long handle);
 };
-<a href=#window>Window</a> implements <a href=#windowtimers>WindowTimers</a>;
+<a href=#window>Window</a> implements <a href=#windowtimers>WindowTimers</a>;</pre>
 
-[TreatNonCallableAsNull] callback <dfn id=arbitrarycallback>ArbitraryCallback</dfn> = any (any... args);</pre>
-
   <!-- Demonstrating the need for wrapping of the timeout argument value treated as long rather than clamping or treating as double:
           http://software.hixie.ch/utilities/js/live-dom-viewer/saved/1228
        Demonstrating the need for the timeout argument to be signed rather than unsigned:
@@ -75809,7 +75807,7 @@
    <li><p><a href=#get-the-timed-task>Get the timed task</a> <var title="">handle</var>
    in the <a href=#list-of-active-timers>list of active timers</a>, and let <var title="">task</var> be the result. This algorithm uses the first
    argument to the method (<var title="">handler</var>) and, if there
-   are any, the third and subsequent arguments to the method (<var title="">args</var>), to establish precisely what <var title="">task</var> does.</li>
+   are any, the third and subsequent arguments to the method (<var title="">arguments</var>), to establish precisely what <var title="">task</var> does.</li>
 
    <li><p>Let <var title="">timeout</var> be the second argument to
    the method, or zero if the argument was omitted.</li>
@@ -75910,7 +75908,7 @@
    <li><p><a href=#get-the-timed-task>Get the timed task</a> <var title="">handle</var>
    in the <a href=#list-of-active-timers>list of active timers</a>, and let <var title="">task</var> be the result. This algorithm uses the first
    argument to the method (<var title="">handler</var>) and, if there
-   are any, the third and subsequent arguments to the method (<var title="">args</var>), to establish precisely what <var title="">task</var> does.</li>
+   are any, the third and subsequent arguments to the method (<var title="">arguments</var>), to establish precisely what <var title="">task</var> does.</li>
 
    <li><p>Let <var title="">timeout</var> be the second argument to
    the method, or zero if the argument was omitted.</li>
@@ -75983,12 +75981,12 @@
 
   <ol><li>
 
-    <p>If the first argument to the invoked method is an
-    <code><a href=#arbitrarycallback>ArbitraryCallback</a></code>, then return a <a href=#concept-task title=concept-task>task</a> that checks if the entry for <var title="">handle</var> in <var title="">list</var> has been
-    cleared, and if it has not, calls the
-    <code><a href=#arbitrarycallback>ArbitraryCallback</a></code> with as its arguments the third and
-    subsequent arguments to the invoked method (if any) and with an
-    undefined <var title="">thisArg</var>, and abort these steps. <a href=#refsECMA262>[ECMA262]</a></p>
+    <p>If the first argument to the invoked method is a
+    <code>Function</code>, then return a <a href=#concept-task title=concept-task>task</a> that checks if the entry for <var title="">handle</var> in <var title="">list</var> has been
+    cleared, and if it has not, calls the <code>Function</code> with
+    as its arguments the third and subsequent arguments to the invoked
+    method (if any) and with an undefined <var title="">thisArg</var>,
+    and abort these steps. <a href=#refsECMA262>[ECMA262]</a></p>
 
     <p class=note>Setting <var title="">thisArg</var> to undefined
     means that the function code will be executed with the <code title="">this</code> keyword bound to the <code><a href=#windowproxy>WindowProxy</a></code>

Modified: source
===================================================================
--- source	2012-08-30 17:58:22 UTC (rev 7300)
+++ source	2012-08-30 19:03:31 UTC (rev 7301)
@@ -88515,17 +88515,15 @@
 
   <pre class="idl">[NoInterfaceObject]
 interface <dfn>WindowTimers</dfn> {
-  long <span title="dom-windowtimers-setTimeout">setTimeout</span>(<span>ArbitraryCallback</span> handler, optional long timeout, any... args);
-  long <span title="dom-windowtimers-setTimeout">setTimeout</span>(DOMString handler, optional long timeout, any... args);
+  long <span title="dom-windowtimers-setTimeout">setTimeout</span>(<span>Function</span> handler, optional long timeout, any... arguments);
+  long <span title="dom-windowtimers-setTimeout">setTimeout</span>(DOMString handler, optional long timeout, any... arguments);
   void <span title="dom-windowtimers-clearTimeout">clearTimeout</span>(long handle);
-  long <span title="dom-windowtimers-setInterval">setInterval</span>(<span>ArbitraryCallback</span> handler, optional long timeout, any... args);
-  long <span title="dom-windowtimers-setInterval">setInterval</span>(DOMString handler, optional long timeout, any... args);
+  long <span title="dom-windowtimers-setInterval">setInterval</span>(<span>Function</span> handler, optional long timeout, any... arguments);
+  long <span title="dom-windowtimers-setInterval">setInterval</span>(DOMString handler, optional long timeout, any... arguments);
   void <span title="dom-windowtimers-clearInterval">clearInterval</span>(long handle);
 };
-<span>Window</span> implements <span>WindowTimers</span>;
+<span>Window</span> implements <span>WindowTimers</span>;</pre>
 
-[TreatNonCallableAsNull] callback <dfn>ArbitraryCallback</dfn> = any (any... args);</pre>
-
   <!-- Demonstrating the need for wrapping of the timeout argument value treated as long rather than clamping or treating as double:
           http://software.hixie.ch/utilities/js/live-dom-viewer/saved/1228
        Demonstrating the need for the timeout argument to be signed rather than unsigned:
@@ -88633,7 +88631,7 @@
    title="">task</var> be the result. This algorithm uses the first
    argument to the method (<var title="">handler</var>) and, if there
    are any, the third and subsequent arguments to the method (<var
-   title="">args</var>), to establish precisely what <var
+   title="">arguments</var>), to establish precisely what <var
    title="">task</var> does.</p></li>
 
    <li><p>Let <var title="">timeout</var> be the second argument to
@@ -88748,7 +88746,7 @@
    title="">task</var> be the result. This algorithm uses the first
    argument to the method (<var title="">handler</var>) and, if there
    are any, the third and subsequent arguments to the method (<var
-   title="">args</var>), to establish precisely what <var
+   title="">arguments</var>), to establish precisely what <var
    title="">task</var> does.</p></li>
 
    <li><p>Let <var title="">timeout</var> be the second argument to
@@ -88836,15 +88834,14 @@
 
    <li>
 
-    <p>If the first argument to the invoked method is an
-    <code>ArbitraryCallback</code>, then return a <span
+    <p>If the first argument to the invoked method is a
+    <code>Function</code>, then return a <span
     title="concept-task">task</span> that checks if the entry for <var
     title="">handle</var> in <var title="">list</var> has been
-    cleared, and if it has not, calls the
-    <code>ArbitraryCallback</code> with as its arguments the third and
-    subsequent arguments to the invoked method (if any) and with an
-    undefined <var title="">thisArg</var>, and abort these steps. <a
-    href="#refsECMA262">[ECMA262]</a></p>
+    cleared, and if it has not, calls the <code>Function</code> with
+    as its arguments the third and subsequent arguments to the invoked
+    method (if any) and with an undefined <var title="">thisArg</var>,
+    and abort these steps. <a href="#refsECMA262">[ECMA262]</a></p>
 
     <p class="note">Setting <var title="">thisArg</var> to undefined
     means that the function code will be executed with the <code




More information about the Commit-Watchers mailing list