2005-11-23 David Gilbert <david.gilbert@object-refinery.com>

	* javax/swing/JComponent.java
	(getListeners): Updated API docs.

1 files changed, 15 insertions, 6 deletions

diff --git a/javax/swing/JComponent.java b/javax/swing/JComponent.java
index 482241ada..fda9ae70c 100644
--- a/javax/swing/JComponent.java
+++ b/javax/swing/JComponent.java
@@ -801,14 +801,23 @@ public abstract class JComponent extends Container implements Serializable
   }
 
   /**
-   * Return all registered listeners of a particular type.
-   *
-   * @param listenerType The type of listener to return
-   *
-   * @return All listeners in the {@link #listenerList} which 
-   * are of the specified type
+   * Returns all registered {@link EventListener}s of the given 
+   * <code>listenerType</code>.
    *
+   * @param listenerType the class of listeners to filter (<code>null</code> 
+   *                     not permitted).
+   *                     
+   * @return An array of registered listeners.
+   * 
+   * @throws ClassCastException if <code>listenerType</code> does not implement
+   *                            the {@link EventListener} interface.
+   * @throws NullPointerException if <code>listenerType</code> is 
+   *                              <code>null</code>.
+   *                            
+   * @see #getAncestorListeners()
    * @see #listenerList
+   * 
+   * @since 1.3
    */
   public EventListener[] getListeners(Class listenerType)
   {