Fixes issue 3196 by adding deprecation messages to all listener, listener adapter and listener collections.
Review by:jlabanca

git-svn-id: https://google-web-toolkit.googlecode.com/svn/releases/1.6@4383 8db76d5a-ed1c-0410-87a9-c151d255dfc7
diff --git a/user/src/com/google/gwt/user/client/ui/ChangeListener.java b/user/src/com/google/gwt/user/client/ui/ChangeListener.java
index 29e1bc4..cf75a46 100644
--- a/user/src/com/google/gwt/user/client/ui/ChangeListener.java
+++ b/user/src/com/google/gwt/user/client/ui/ChangeListener.java
@@ -19,6 +19,8 @@
 
 /**
  * Event listener interface for 'change' events.
+ * 
+ * @deprecated use {@link com.google.gwt.event.dom.client.ChangeHandler} instead
  */
 @Deprecated
 public interface ChangeListener extends EventListener {
diff --git a/user/src/com/google/gwt/user/client/ui/ChangeListenerCollection.java b/user/src/com/google/gwt/user/client/ui/ChangeListenerCollection.java
index 12ce182..ea4ca5a 100644
--- a/user/src/com/google/gwt/user/client/ui/ChangeListenerCollection.java
+++ b/user/src/com/google/gwt/user/client/ui/ChangeListenerCollection.java
@@ -21,6 +21,9 @@
  * A helper class for implementers of the SourcesChangeEvents interface. This
  * subclass of {@link ArrayList} assumes that all objects added to it will be of
  * type {@link com.google.gwt.user.client.ui.ChangeListener}.
+ * 
+ * @deprecated use <code>addDomHandler(myHandler, ChangeEvent.getType())</code>
+ *             instead to manage handlers for your widget
  */
 @Deprecated
 public class ChangeListenerCollection extends ArrayList<ChangeListener> {
diff --git a/user/src/com/google/gwt/user/client/ui/ClickListener.java b/user/src/com/google/gwt/user/client/ui/ClickListener.java
index 4c34bb6..cf998cc 100644
--- a/user/src/com/google/gwt/user/client/ui/ClickListener.java
+++ b/user/src/com/google/gwt/user/client/ui/ClickListener.java
@@ -19,6 +19,7 @@
 
 /**
  * Event listener interface for click events.
+ * @deprecated use {@link com.google.gwt.event.dom.client.ClickHandler} instead
  */
 @Deprecated
 public interface ClickListener extends EventListener {
diff --git a/user/src/com/google/gwt/user/client/ui/ClickListenerCollection.java b/user/src/com/google/gwt/user/client/ui/ClickListenerCollection.java
index 3f150ff..9d13313 100644
--- a/user/src/com/google/gwt/user/client/ui/ClickListenerCollection.java
+++ b/user/src/com/google/gwt/user/client/ui/ClickListenerCollection.java
@@ -21,6 +21,9 @@
  * A helper class for implementers of the SourcesClickEvents interface. This
  * subclass of {@link ArrayList} assumes that all objects added to it will be of
  * type {@link com.google.gwt.user.client.ui.ClickListener}.
+ * 
+ * @deprecated use <code>addDomHandler(myHandler, ClickEvent.getType())</code>
+ *             to manage handlers for your widget instead
  */
 @Deprecated
 public class ClickListenerCollection extends ArrayList<ClickListener> {
diff --git a/user/src/com/google/gwt/user/client/ui/DisclosureHandler.java b/user/src/com/google/gwt/user/client/ui/DisclosureHandler.java
index 5d09bd0..dd283e5 100644
--- a/user/src/com/google/gwt/user/client/ui/DisclosureHandler.java
+++ b/user/src/com/google/gwt/user/client/ui/DisclosureHandler.java
@@ -14,12 +14,14 @@
  * the License.
  */
 package com.google.gwt.user.client.ui;
-
+ 
 import java.util.EventListener;
 
 /**
  * Event handler interface for {@link DisclosureEvent}.
  * 
+ * @deprecated use {@link com.google.gwt.event.logical.shared.CloseHandler}
+ *             and/or {@link com.google.gwt.event.logical.shared.OpenHandler} instead
  * @see DisclosurePanel
  */
 @Deprecated
@@ -39,4 +41,4 @@
    */
   @Deprecated
   void onOpen(DisclosureEvent event);
-}
\ No newline at end of file
+}
diff --git a/user/src/com/google/gwt/user/client/ui/FocusListener.java b/user/src/com/google/gwt/user/client/ui/FocusListener.java
index e89ceed..23b707d 100644
--- a/user/src/com/google/gwt/user/client/ui/FocusListener.java
+++ b/user/src/com/google/gwt/user/client/ui/FocusListener.java
@@ -19,6 +19,9 @@
 
 /**
  * Event listener for focus events.
+ * 
+ * @deprecated use {@link com.google.gwt.event.dom.client.FocusHandler} and/or
+ *             {@link com.google.gwt.event.dom.client.BlurHandler} instead
  */
 @Deprecated
 public interface FocusListener extends EventListener {
diff --git a/user/src/com/google/gwt/user/client/ui/FocusListenerAdapter.java b/user/src/com/google/gwt/user/client/ui/FocusListenerAdapter.java
index 121269c..c72d948 100644
--- a/user/src/com/google/gwt/user/client/ui/FocusListenerAdapter.java
+++ b/user/src/com/google/gwt/user/client/ui/FocusListenerAdapter.java
@@ -18,6 +18,9 @@
 /**
  * An adapter to simplify focus event listeners that do not need all events
  * defined on the FocusListener interface.
+ * 
+ * @deprecated use {@link com.google.gwt.event.dom.client.FocusHandler} and
+ *             {@link com.google.gwt.event.dom.client.BlurHandler} instead
  */
 @Deprecated
 public abstract class FocusListenerAdapter implements FocusListener {
diff --git a/user/src/com/google/gwt/user/client/ui/FocusListenerCollection.java b/user/src/com/google/gwt/user/client/ui/FocusListenerCollection.java
index cfa0409..b2981aa 100644
--- a/user/src/com/google/gwt/user/client/ui/FocusListenerCollection.java
+++ b/user/src/com/google/gwt/user/client/ui/FocusListenerCollection.java
@@ -24,7 +24,11 @@
  * A helper class for implementers of the
  * {@link com.google.gwt.user.client.ui.SourcesFocusEvents} interface. This
  * subclass of {@link ArrayList} assumes that all objects added to it will be of
- * type {@link com.google.gwt.user.client.ui.FocusListener}.
+ * type {@link com.google.gwt.user.client.ui.FocusListener}
+ * 
+ * @deprecated use <code>addDomHandler(myHandler, FocusEvent.getType())</code>
+ *             and <code>addDomHandler(myHandler, BlurEvent.getType())</code>
+ *             to manage your widget's handlers instead
  */
 @Deprecated
 public class FocusListenerCollection extends ArrayList<FocusListener> {
diff --git a/user/src/com/google/gwt/user/client/ui/FormHandler.java b/user/src/com/google/gwt/user/client/ui/FormHandler.java
index 4c5faec..f4f8ab8 100644
--- a/user/src/com/google/gwt/user/client/ui/FormHandler.java
+++ b/user/src/com/google/gwt/user/client/ui/FormHandler.java
@@ -19,6 +19,7 @@
 
 /**
  * Handler interface for form submit events.
+ * @deprecated use {@link FormPanel.SubmitCompleteHandler} and/or {@link FormPanel.SubmitHandler} instead
  */
 @Deprecated
 public interface FormHandler extends EventListener {
diff --git a/user/src/com/google/gwt/user/client/ui/FormHandlerCollection.java b/user/src/com/google/gwt/user/client/ui/FormHandlerCollection.java
index ecb31b8..66c6a4c 100644
--- a/user/src/com/google/gwt/user/client/ui/FormHandlerCollection.java
+++ b/user/src/com/google/gwt/user/client/ui/FormHandlerCollection.java
@@ -22,6 +22,8 @@
  * {@link com.google.gwt.user.client.ui.FormHandler FormHandlers}. This
  * subclass of ArrayList assumes that all items added to it will be of type
  * {@link com.google.gwt.user.client.ui.FormHandler}.
+ * 
+ * @deprecated {@link FormPanel} now handles all handler management internally
  */
 @Deprecated
 public class FormHandlerCollection extends ArrayList<FormHandler> {
diff --git a/user/src/com/google/gwt/user/client/ui/KeyboardListener.java b/user/src/com/google/gwt/user/client/ui/KeyboardListener.java
index 2680f96..e0a90d1 100644
--- a/user/src/com/google/gwt/user/client/ui/KeyboardListener.java
+++ b/user/src/com/google/gwt/user/client/ui/KeyboardListener.java
@@ -19,6 +19,9 @@
 
 /**
  * Event listener interface for keyboard events.
+ * 
+ * @deprecated use {@link com.google.gwt.event.dom.client.KeyDownHandler}, {@link com.google.gwt.event.dom.client.KeyUpHandler} and/or {@link com.google.gwt.event.dom.client.KeyPressHandler}
+ *             instead
  */
 @Deprecated
 public interface KeyboardListener extends EventListener {
diff --git a/user/src/com/google/gwt/user/client/ui/KeyboardListenerAdapter.java b/user/src/com/google/gwt/user/client/ui/KeyboardListenerAdapter.java
index 1a2d6b1..52cc564 100644
--- a/user/src/com/google/gwt/user/client/ui/KeyboardListenerAdapter.java
+++ b/user/src/com/google/gwt/user/client/ui/KeyboardListenerAdapter.java
@@ -18,6 +18,10 @@
 /**
  * An adapter to simplify keyboard event listeners that do not need all events
  * defined on the KeyboardListener interface.
+ * 
+ * @deprecated use {@link com.google.gwt.event.dom.client.KeyDownHandler},
+ *             {@link com.google.gwt.event.dom.client.KeyUpHandler} and/or
+ *             {@link com.google.gwt.event.dom.client.KeyPressHandler} instead
  */
 @Deprecated
 public class KeyboardListenerAdapter implements KeyboardListener {
diff --git a/user/src/com/google/gwt/user/client/ui/KeyboardListenerCollection.java b/user/src/com/google/gwt/user/client/ui/KeyboardListenerCollection.java
index 74a1945..315913a 100644
--- a/user/src/com/google/gwt/user/client/ui/KeyboardListenerCollection.java
+++ b/user/src/com/google/gwt/user/client/ui/KeyboardListenerCollection.java
@@ -24,6 +24,10 @@
  * A helper class for implementers of the SourcesKeyboardEvents interface. This
  * subclass of {@link ArrayList} assumes that all objects added to it will be of
  * type {@link com.google.gwt.user.client.ui.KeyboardListener}.
+ * 
+ * @deprecated use
+ *             <code>addDomHandler(myHandler, Key(Down/Up/Press)Event.getType())</code>
+ *             to manage handlers within your widget
  */
 @Deprecated
 public class KeyboardListenerCollection extends ArrayList<KeyboardListener> {
diff --git a/user/src/com/google/gwt/user/client/ui/LoadListener.java b/user/src/com/google/gwt/user/client/ui/LoadListener.java
index 149259c..fed7374 100644
--- a/user/src/com/google/gwt/user/client/ui/LoadListener.java
+++ b/user/src/com/google/gwt/user/client/ui/LoadListener.java
@@ -19,6 +19,10 @@
 
 /**
  * Event listener interface for 'load' events.
+ * 
+ * @deprecated use {@link com.google.gwt.event.dom.client.LoadHandler}
+ *             and/or {@link com.google.gwt.event.dom.client.ErrorHandler}
+ *             instead
  */
 @Deprecated
 public interface LoadListener extends EventListener {
diff --git a/user/src/com/google/gwt/user/client/ui/LoadListenerCollection.java b/user/src/com/google/gwt/user/client/ui/LoadListenerCollection.java
index ffebb8c..e39b182 100644
--- a/user/src/com/google/gwt/user/client/ui/LoadListenerCollection.java
+++ b/user/src/com/google/gwt/user/client/ui/LoadListenerCollection.java
@@ -21,6 +21,10 @@
  * A helper class for implementers of the SourcesLoadEvents interface. This
  * subclass of {@link ArrayList} assumes that all objects added to it will be of
  * type {@link com.google.gwt.user.client.ui.LoadListener}.
+ * 
+ * @deprecated use
+ *             <code>addDomHandler(myHandler, (Load/Error)Event.getType())</code>
+ *             to manage handlers within your widget instead
  */
 @Deprecated
 public class LoadListenerCollection extends ArrayList<LoadListener> {
diff --git a/user/src/com/google/gwt/user/client/ui/MouseListener.java b/user/src/com/google/gwt/user/client/ui/MouseListener.java
index 9c250b2..f80c5c8 100644
--- a/user/src/com/google/gwt/user/client/ui/MouseListener.java
+++ b/user/src/com/google/gwt/user/client/ui/MouseListener.java
@@ -19,6 +19,13 @@
 
 /**
  * Event listener interface for mouse events.
+ * 
+ * @deprecated use
+ *             {@link com.google.gwt.event.dom.client.MouseDownHandler},
+ *             {@link com.google.gwt.event.dom.client.MouseUpHandler},
+ *             {@link com.google.gwt.event.dom.client.MouseOverHandler},
+ *             {@link com.google.gwt.event.dom.client.MouseMoveHandler}, and/or
+ *             {@link com.google.gwt.event.dom.client.MouseOutHandler} instead
  */
 @Deprecated
 public interface MouseListener extends EventListener {
diff --git a/user/src/com/google/gwt/user/client/ui/MouseListenerAdapter.java b/user/src/com/google/gwt/user/client/ui/MouseListenerAdapter.java
index bceee83..10b5018 100644
--- a/user/src/com/google/gwt/user/client/ui/MouseListenerAdapter.java
+++ b/user/src/com/google/gwt/user/client/ui/MouseListenerAdapter.java
@@ -18,6 +18,13 @@
 /**
  * An adapter to simplify mouse event listeners that do not need all events
  * defined on the MouseListener interface.
+ * 
+ * @deprecated use
+ *             {@link com.google.gwt.event.dom.client.MouseDownHandler},
+ *             {@link com.google.gwt.event.dom.client.MouseUpHandler},
+ *             {@link com.google.gwt.event.dom.client.MouseOverHandler},
+ *             {@link com.google.gwt.event.dom.client.MouseMoveHandler}, and/or
+ *             {@link com.google.gwt.event.dom.client.MouseOutHandler} instead
  */
 @Deprecated
 public class MouseListenerAdapter implements MouseListener {
diff --git a/user/src/com/google/gwt/user/client/ui/MouseListenerCollection.java b/user/src/com/google/gwt/user/client/ui/MouseListenerCollection.java
index 9d201b9..08c1336 100644
--- a/user/src/com/google/gwt/user/client/ui/MouseListenerCollection.java
+++ b/user/src/com/google/gwt/user/client/ui/MouseListenerCollection.java
@@ -26,6 +26,10 @@
  * A helper class for implementers of the SourcesMouseEvents interface. This
  * subclass of {@link ArrayList} assumes that all objects added to it will be of
  * type {@link com.google.gwt.user.client.ui.MouseListener}.
+ * 
+ * @deprecated use
+ *             <code>addDomHandler(myHandler, Mouse(Down/Up/Move/Over/Out)Event.getType())</code>
+ *             to manage handlers within your widget
  */
 @Deprecated
 public class MouseListenerCollection extends ArrayList<MouseListener> {
diff --git a/user/src/com/google/gwt/user/client/ui/MouseWheelListener.java b/user/src/com/google/gwt/user/client/ui/MouseWheelListener.java
index a74b3cc..b60bd93 100644
--- a/user/src/com/google/gwt/user/client/ui/MouseWheelListener.java
+++ b/user/src/com/google/gwt/user/client/ui/MouseWheelListener.java
@@ -19,6 +19,10 @@
 
 /**
  * Event listener interface for mouse wheel events.
+ * 
+ * @deprecated use
+ *             {@link com.google.gwt.event.dom.client.MouseWheelHandler} instead
+ *             
  */
 @Deprecated
 public interface MouseWheelListener extends EventListener {
diff --git a/user/src/com/google/gwt/user/client/ui/MouseWheelListenerCollection.java b/user/src/com/google/gwt/user/client/ui/MouseWheelListenerCollection.java
index 6bf8be5..16d10a1 100644
--- a/user/src/com/google/gwt/user/client/ui/MouseWheelListenerCollection.java
+++ b/user/src/com/google/gwt/user/client/ui/MouseWheelListenerCollection.java
@@ -24,6 +24,10 @@
  * A helper class for implementers of the SourcesMouseWheelEvents interface.
  * This subclass of {@link ArrayList} assumes that all objects added to it will
  * be of type {@link com.google.gwt.user.client.ui.MouseWheelListener}.
+ * 
+ * @deprecated use
+ *             <code>addDomHandler(myHandler, MouseWheelEvent.getType())</code>
+ *             to manage handlers within your widget
  */
 @Deprecated
 public class MouseWheelListenerCollection extends ArrayList<MouseWheelListener> {
diff --git a/user/src/com/google/gwt/user/client/ui/PopupListener.java b/user/src/com/google/gwt/user/client/ui/PopupListener.java
index bcae3c1..98cef26 100644
--- a/user/src/com/google/gwt/user/client/ui/PopupListener.java
+++ b/user/src/com/google/gwt/user/client/ui/PopupListener.java
@@ -19,6 +19,9 @@
 
 /**
  * Event listener interface for popup events.
+ * 
+ * @deprecated use
+ *             {@link com.google.gwt.event.logical.shared.CloseHandler} instead
  */
 @Deprecated
 public interface PopupListener extends EventListener {
diff --git a/user/src/com/google/gwt/user/client/ui/PopupListenerCollection.java b/user/src/com/google/gwt/user/client/ui/PopupListenerCollection.java
index b17e1b6..0c18403 100644
--- a/user/src/com/google/gwt/user/client/ui/PopupListenerCollection.java
+++ b/user/src/com/google/gwt/user/client/ui/PopupListenerCollection.java
@@ -21,6 +21,8 @@
  * A helper class for implementers of the SourcesPopupEvents interface. This
  * subclass of {@link ArrayList} assumes that all objects added to it will be of
  * type {@link com.google.gwt.user.client.ui.PopupListener}.
+ * @deprecated use <code>addHandler(myHandler,  CloseEvent.getType())</code>
+ *             to manage handlers within your widget instead
  */
 @Deprecated
 public class PopupListenerCollection extends ArrayList<PopupListener> {
diff --git a/user/src/com/google/gwt/user/client/ui/ScrollListener.java b/user/src/com/google/gwt/user/client/ui/ScrollListener.java
index d7e6130..6b50121 100644
--- a/user/src/com/google/gwt/user/client/ui/ScrollListener.java
+++ b/user/src/com/google/gwt/user/client/ui/ScrollListener.java
@@ -19,6 +19,9 @@
 
 /**
  * Event listener interface for scroll events.
+ * 
+ * @deprecated use {@link com.google.gwt.event.dom.client.ScrollHandler}
+ *             instead
  */
 @Deprecated
 public interface ScrollListener extends EventListener {
diff --git a/user/src/com/google/gwt/user/client/ui/ScrollListenerCollection.java b/user/src/com/google/gwt/user/client/ui/ScrollListenerCollection.java
index 5576063..15a0b03 100644
--- a/user/src/com/google/gwt/user/client/ui/ScrollListenerCollection.java
+++ b/user/src/com/google/gwt/user/client/ui/ScrollListenerCollection.java
@@ -21,6 +21,9 @@
  * A helper class for implementers of the SourcesScrollEvents interface. This
  * subclass of {@link ArrayList} assumes that all objects added to it will be of
  * type {@link com.google.gwt.user.client.ui.ScrollListener}.
+ * 
+ * @deprecated use <code>addDomHandler(myHandler, ScrollEvent.getType())</code>
+ *             to manage handlers within your widget instead
  */
 @Deprecated
 public class ScrollListenerCollection extends ArrayList<ScrollListener> {
diff --git a/user/src/com/google/gwt/user/client/ui/SourcesChangeEvents.java b/user/src/com/google/gwt/user/client/ui/SourcesChangeEvents.java
index 27f6c16..268f3ad 100644
--- a/user/src/com/google/gwt/user/client/ui/SourcesChangeEvents.java
+++ b/user/src/com/google/gwt/user/client/ui/SourcesChangeEvents.java
@@ -19,7 +19,7 @@
  * A widget that implements this interface sources the events defined by the
  * {@link com.google.gwt.user.client.ui.ChangeListener} interface.
  * 
- * @deprecated Use {@link com.google.gwt.event.dom.client.HasChangeHandlers}
+ * @deprecated use {@link com.google.gwt.event.dom.client.HasChangeHandlers}
  *             instead
  */
 @Deprecated
diff --git a/user/src/com/google/gwt/user/client/ui/SourcesMouseEvents.java b/user/src/com/google/gwt/user/client/ui/SourcesMouseEvents.java
index ce3c60a..96a6cad 100644
--- a/user/src/com/google/gwt/user/client/ui/SourcesMouseEvents.java
+++ b/user/src/com/google/gwt/user/client/ui/SourcesMouseEvents.java
@@ -19,7 +19,7 @@
  * A widget that implements this interface sources the events defined by the
  * {@link com.google.gwt.user.client.ui.MouseListener} interface.
  * 
- * @deprecated use {@link com.google.gwt.event.dom.client.HasAllMouseHandlerss}
+ * @deprecated use {@link com.google.gwt.event.dom.client.HasAllMouseHandlers}
  *             instead
  */
 @Deprecated
diff --git a/user/src/com/google/gwt/user/client/ui/SourcesMouseWheelEvents.java b/user/src/com/google/gwt/user/client/ui/SourcesMouseWheelEvents.java
index c003da6..f342544 100644
--- a/user/src/com/google/gwt/user/client/ui/SourcesMouseWheelEvents.java
+++ b/user/src/com/google/gwt/user/client/ui/SourcesMouseWheelEvents.java
@@ -19,9 +19,10 @@
  * A widget that implements this interface sources the events defined by the
  * {@link com.google.gwt.user.client.ui.MouseWheelListener} interface.
  * 
- * @deprecated use {@link com.google.gwt.event.dom.client.HasMouseDownHandlers}
+ * @deprecated use {@link com.google.gwt.event.dom.client.HasMouseWheelHandlers}
  *             instead
  */
+@Deprecated
 public interface SourcesMouseWheelEvents {
 
   /**
diff --git a/user/src/com/google/gwt/user/client/ui/SourcesTreeEvents.java b/user/src/com/google/gwt/user/client/ui/SourcesTreeEvents.java
index 4f7e8fe..e47c443 100644
--- a/user/src/com/google/gwt/user/client/ui/SourcesTreeEvents.java
+++ b/user/src/com/google/gwt/user/client/ui/SourcesTreeEvents.java
@@ -22,7 +22,7 @@
  * @deprecated use
  *             {@link com.google.gwt.event.logical.shared.HasBeforeSelectionHandlers}
  *             , {@link com.google.gwt.event.logical.shared.HasOpenHandlers},
- *             {@link com.google.gwt.event.logical.shared.HasClickHandlers}
+ *             {@link com.google.gwt.event.dom.client.HasClickHandlers}
  *             instead
  */
 @Deprecated
diff --git a/user/src/com/google/gwt/user/client/ui/TabListenerCollection.java b/user/src/com/google/gwt/user/client/ui/TabListenerCollection.java
index 2cf6fce..4693454 100644
--- a/user/src/com/google/gwt/user/client/ui/TabListenerCollection.java
+++ b/user/src/com/google/gwt/user/client/ui/TabListenerCollection.java
@@ -22,6 +22,9 @@
  * {@link com.google.gwt.user.client.ui.SourcesTabEvents} interface. This
  * subclass of {@link ArrayList} assumes that all objects added to it will be of
  * type {@link com.google.gwt.user.client.ui.TabListener}.
+ * 
+ * @deprecated {@link TabPanel} and {@link TabBar} should now completely manage
+ *             their own handlers
  */
 @Deprecated
 public class TabListenerCollection extends ArrayList<TabListener> {
diff --git a/user/src/com/google/gwt/user/client/ui/TableListenerCollection.java b/user/src/com/google/gwt/user/client/ui/TableListenerCollection.java
index 638f7d2..d013eed 100644
--- a/user/src/com/google/gwt/user/client/ui/TableListenerCollection.java
+++ b/user/src/com/google/gwt/user/client/ui/TableListenerCollection.java
@@ -22,6 +22,10 @@
  * {@link com.google.gwt.user.client.ui.SourcesTableEvents} interface. This
  * subclass of {@link ArrayList} assumes that all objects added to it will be of
  * type {@link com.google.gwt.user.client.ui.TableListener}.
+ * 
+ * @deprecated use
+ *             {@link HTMLTable#getCellForEvent(com.google.gwt.event.dom.client.ClickEvent)}
+ *             or similar code
  */
 @Deprecated
 public class TableListenerCollection extends ArrayList<TableListener> {
diff --git a/user/src/com/google/gwt/user/client/ui/TreeListenerCollection.java b/user/src/com/google/gwt/user/client/ui/TreeListenerCollection.java
index 92a2320..92bd35d 100644
--- a/user/src/com/google/gwt/user/client/ui/TreeListenerCollection.java
+++ b/user/src/com/google/gwt/user/client/ui/TreeListenerCollection.java
@@ -21,6 +21,8 @@
  * A helper class for implementers of the SourcesClickEvents interface. This
  * subclass of {@link ArrayList} assumes that all objects added to it will be of
  * type {@link com.google.gwt.user.client.ui.ClickListener}.
+ * 
+ * @deprecated {@link Tree} should now completely manage its own handlers
  */
 @Deprecated
 public class TreeListenerCollection extends ArrayList<TreeListener> {