[html5] r7735 - [e] (0) Point out that the constructor isn't really useful here. Fixing https:// [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2013-03-06 12:51:45 -0800 (Wed, 06 Mar 2013)
New Revision: 7735

Modified:
   complete.html
   index
   source
Log:
[e] (0) Point out that the constructor isn't really useful here.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=20004
Affected topics: HTML

Modified: complete.html
===================================================================
--- complete.html	2013-03-06 20:44:39 UTC (rev 7734)
+++ complete.html	2013-03-06 20:51:45 UTC (rev 7735)
@@ -77359,8 +77359,13 @@
 
    </dd>
 
-  </dl><div class=impl>
+  </dl><p class=note>Although, for consistency with other event interfaces, the <code><a href=#dragevent>DragEvent</a></code>
+  interface has a constructor, it is not particularly useful. In particular, there's no way to
+  create a useful <code><a href=#datatransfer>DataTransfer</a></code> object from script, as <code><a href=#datatransfer>DataTransfer</a></code> objects
+  have a processing and security model that is coordinated by the browser during drag-and-drops.</p>
 
+  <div class=impl>
+
   <p>The <dfn id=dom-dragevent-datatransfer title=dom-DragEvent-dataTransfer><code>dataTransfer</code></dfn>
   attribute of the <code><a href=#dragevent>DragEvent</a></code> interface must return the
   value it was initialized to. When the object is created, this

Modified: index
===================================================================
--- index	2013-03-06 20:44:39 UTC (rev 7734)
+++ index	2013-03-06 20:51:45 UTC (rev 7735)
@@ -77359,8 +77359,13 @@
 
    </dd>
 
-  </dl><div class=impl>
+  </dl><p class=note>Although, for consistency with other event interfaces, the <code><a href=#dragevent>DragEvent</a></code>
+  interface has a constructor, it is not particularly useful. In particular, there's no way to
+  create a useful <code><a href=#datatransfer>DataTransfer</a></code> object from script, as <code><a href=#datatransfer>DataTransfer</a></code> objects
+  have a processing and security model that is coordinated by the browser during drag-and-drops.</p>
 
+  <div class=impl>
+
   <p>The <dfn id=dom-dragevent-datatransfer title=dom-DragEvent-dataTransfer><code>dataTransfer</code></dfn>
   attribute of the <code><a href=#dragevent>DragEvent</a></code> interface must return the
   value it was initialized to. When the object is created, this

Modified: source
===================================================================
--- source	2013-03-06 20:44:39 UTC (rev 7734)
+++ source	2013-03-06 20:51:45 UTC (rev 7735)
@@ -90125,6 +90125,11 @@
 
   </dl>
 
+  <p class="note">Although, for consistency with other event interfaces, the <code>DragEvent</code>
+  interface has a constructor, it is not particularly useful. In particular, there's no way to
+  create a useful <code>DataTransfer</code> object from script, as <code>DataTransfer</code> objects
+  have a processing and security model that is coordinated by the browser during drag-and-drops.</p>
+
   <div class="impl">
 
   <p>The <dfn