[html5] r1423 - /

[whatwg at whatwg.org]

Author: ianh
Date: 2008-04-09 22:39:13 -0700 (Wed, 09 Apr 2008)
New Revision: 1423

Modified:
   index
   source
Log:
[e] (0) Clarify event handler attributes and how they work.

Modified: index
===================================================================
--- index	2008-04-09 23:19:32 UTC (rev 1422)
+++ index	2008-04-10 05:39:13 UTC (rev 1423)
@@ -24,7 +24,7 @@
 
    <h1 id=html-5>HTML 5</h1>
 
-   <h2 class="no-num no-toc" id=working>Working Draft — 9 April 2008</h2>
+   <h2 class="no-num no-toc" id=working>Working Draft — 10 April 2008</h2>
 
    <p>You can take part in this work. <a
     href="http://www.whatwg.org/mailing-list">Join the working group's
@@ -27337,7 +27337,8 @@
   <!-- IE actually uncancels the event if the function returns true -->
 
   <p>When <a href="#scripting1">scripting is disabled</a>, event handler
-   attributes must do nothing.
+   attributes must do nothing.</p>
+  <!-- XXX arguments should use <var>, not <code>: -->
 
   <p>When <a href="#scripting2">scripting is enabled</a>, all event handler
    attributes on an element, whether set to null or to a function, must be
@@ -27355,7 +27356,8 @@
    event listener itself (<code title=dom-event-listener>listener</code>
    argument) set to do nothing while the event handler attribute is null, and
    set to invoke the function associated with the event handler attribute
-   otherwise.
+   otherwise. (The <code title=dom-event-listener>listener</code> argument is
+   emphatically <em>not</em> the event handler attribute itself.)
 
   <h5 id=event><span class=secno>4.3.6.2. </span>Event firing</h5>
 

Modified: source
===================================================================
--- source	2008-04-09 23:19:32 UTC (rev 1422)
+++ source	2008-04-10 05:39:13 UTC (rev 1423)
@@ -24949,9 +24949,10 @@
   <p>When <span>scripting is disabled</span>, event handler attributes
   must do nothing.</p>
 
-  <p>When <span>scripting is enabled</span>, all event handler
-  attributes on an element, whether set to null or to a function, must
-  be registered as event listeners on the element, as if the <code
+  <!-- XXX arguments should use <var>, not <code>: --> <p>When
+  <span>scripting is enabled</span>, all event handler attributes on
+  an element, whether set to null or to a function, must be registered
+  as event listeners on the element, as if the <code
   title="dom-EventTarget-addEventListenerNS">addEventListenerNS()</code>
   method on the <code>Element</code> object's <code>EventTarget</code>
   interface had been invoked when the element was created, with the
@@ -24967,7 +24968,9 @@
   title="dom-event-listener">listener</code> argument) set to do
   nothing while the event handler attribute is null, and set to invoke
   the function associated with the event handler attribute
-  otherwise.</p>
+  otherwise. (The <code title="dom-event-listener">listener</code>
+  argument is emphatically <em>not</em> the event handler attribute
+  itself.)</p>
 
 
   <h5>Event firing</h5>