src/java.desktop/share/classes/javax/swing/text/AbstractDocument.java

@@ -306,13 +306,12 @@
      *
      * <pre>DocumentListener[] mls = (DocumentListener[])(d.getListeners(DocumentListener.class));</pre>
      *
      * If no such listeners exist, this method returns an empty array.
      *
-     * @param listenerType the type of listeners requested; this parameter
-     *          should specify an interface that descends from
-     *          <code>java.util.EventListener</code>
+     * @param <T> the listener type
+     * @param listenerType the type of listeners requested
      * @return an array of all objects registered as
      *          <code><em>Foo</em>Listener</code>s on this component,
      *          or an empty array if no such
      *          listeners have been added
      * @exception ClassCastException if <code>listenerType</code>

@@ -903,10 +902,12 @@
 
     /**
      * Returns the root element of the bidirectional structure for this
      * document.  Its children represent character runs with a given
      * Unicode bidi level.
+     * @return the root element of the bidirectional structure for this
+     * document
      */
     public Element getBidiRootElement() {
         return bidiRoot;
     }