[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 git-svn-id: http://svn.whatwg.org/webapps@7735 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Mar 6, 2013 · 5317ad4 · 5317ad4
1 parent 94b5d74
commit 5317ad4
Show file tree

Hide file tree

Showing 3 changed files with 17 additions and 2 deletions.
diff --git a/complete.html b/complete.html
@@ -77359,7 +77359,12 @@ <h4 id=the-dragevent-interface><span class=secno>8.7.4 </span>The <code><a href=
 
    </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

diff --git a/index b/index
@@ -77359,7 +77359,12 @@ dictionary <dfn id=drageventinit>DragEventInit</dfn> : <a href=#mouseeventinit>M
 
    </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

diff --git a/source b/source
@@ -90125,6 +90125,11 @@ dictionary <dfn>DragEventInit</dfn> : <span>MouseEventInit</span> {
 
   </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