Documenting misleading DataTransfer API.

sdk/lib/html/dart2js/html_dart2js.dart

Index: sdk/lib/html/dart2js/html_dart2js.dart
diff --git a/sdk/lib/html/dart2js/html_dart2js.dart b/sdk/lib/html/dart2js/html_dart2js.dart
index fa018931621c5a3aed08d0e726ea9903aae0da69..4cfd36899f8f499391038e968a0850fde126c8ac 100644
--- a/sdk/lib/html/dart2js/html_dart2js.dart
+++ b/sdk/lib/html/dart2js/html_dart2js.dart
@@ -5828,6 +5828,12 @@ class DataTransfer native "*Clipboard" {
   @DocsEditable
   void clearData([String type]) native;
 
+  /**
+   * Gets the data for the specified MIME type.

[Andrei Mouravski, 2013/02/01 18:23:21]

Do we want to add more data like here:
http://msdn.microsoft.com/en-us/library/ie/ms536436(v=vs.85).aspx

Specifically the bits in "Remarks."

Also, will this trigger the Chrome, "this app is trying to access your clipboard
message"?

+   *
+   * The  data is only available from within a drop operation (such as an
+   * onDrop event) and will return `null` before then.

[Andrei Mouravski, 2013/02/01 18:23:21]

Can you please add an example?

+   */
   @DomName('Clipboard.getData')
   @DocsEditable
   String getData(String type) native;