###@###.### 2004-03-08

J2SE Version (please include all output from java -version flag):
  java version "1.5.0-beta2"
  Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0-beta2-b40)
  Java HotSpot(TM) Client VM (build 1.5.0-beta2-b40, mixed mode)

Does this problem occur on J2SE 1.3.x or 1.4.x? Yes / No (pick one)
  No

Bug Description:

The documentation generated by Javadoc's standard doclet does not show
type arguments on indirectly extended generic classes/interfaces, only
on those which are directly extended. This can be important, for
example given a class Foo which indirectly implements Comparable, an
instance of Foo may be Comparable or Comparable<SomeSuperTypeOfFoo> yet
it is not possible to tell exactly what without examining the
documentation for each of the extended classes/interfaces.

The documentation for java.util.ArrayList reads:

    java.util
    Class ArrayList<E>
   
    java.lang.Object
     |_java.util.AbstractCollection
        |_java.util.AbstractList
           |_java.util.ArrayList
   
    All Implemented Interfaces:
        Cloneable, Collection, Iterable, List, RandomAccess, Serializable
   
    Direct Known Subclasses:
        AttributeList, RoleList, RoleUnresolvedList
   
    ---------------------------------------------------------------------
   
    public class ArrayList<E>
    extends AbstractList<E>
    implements List<E>, RandomAccess, Cloneable, Serializable
   

It would be preferable if this read:

  
    java.util
    Class ArrayList<E>
   
    java.lang.Object
     |_java.util.AbstractCollection<E>
        |_java.util.AbstractList<E>
           |_java.util.ArrayList<E>
   
    All Implemented Interfaces:
        Cloneable, Collection<E>, Iterable<E>, List<E>, RandomAccess,
Serializable
   
    Direct Known Subclasses:
        AttributeList, RoleList, RoleUnresolvedList
   
    ---------------------------------------------------------------------
   
    public class ArrayList<E>
    extends AbstractList<E>
    implements List<E>, RandomAccess, Cloneable, Serializable