Tweak docs for Event#addNativePreviewHandler to warn of multi-app fail
git-svn-id: https://google-web-toolkit.googlecode.com/svn/trunk@5815 8db76d5a-ed1c-0410-87a9-c151d255dfc7
diff --git a/user/src/com/google/gwt/user/client/Event.java b/user/src/com/google/gwt/user/client/Event.java
index 613ef07..5cf2251 100644
--- a/user/src/com/google/gwt/user/client/Event.java
+++ b/user/src/com/google/gwt/user/client/Event.java
@@ -387,6 +387,13 @@
* {@link NativePreviewEvent} that was added is the first to be fired.
* </p>
*
+ * <p>
+ * Please note that nondeterministic behavior will result if more than one GWT
+ * application registers preview handlers. See <a href=
+ * 'http://code.google.com/p/google-web-toolkit/issues/detail?id=3892'>issue
+ * 3892</a> for details.
+ * </p>
+ *
* @param handler the {@link NativePreviewHandler}
* @return {@link HandlerRegistration} used to remove this handler
*/
