Name: krC82822 Date: 10/31/2000
java version "1.3.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.0-C)
Java HotSpot(TM) Client VM (build 1.3.0-C, mixed mode)


When reading JavaDoc-generated documentation of an abstract class, it is an
annoying job to have to collect/build a list of all methods that must be implemented in the
class's subclasses. To do it, a programmer has to:

- go through all methods declared in the abstract class and pick methods that
are declared abstract
- add all methods declared at sections "Methods inherited from interface ..."
- and finally look at all methods from sections "Methods inherited from
class ..." and test each one method (follow the link) whether it is or is not
declared abstract. Add the abstract ones to the bucket and you have a list of all
abstract methods.

[As an example, generate] JavaDoc documentation for the following classes,
display the documentation generated for ClassB and try to determine which
of the methods must be implemented in its subclass if you want to
create an instance of it.

public abstract class ClassA {

  public abstract void a();
  public void b() {
    System.out.println("b()");
  }
  public void c() {
    System.out.println("c()");
  }
  public abstract void d();
  
}

public abstract class ClassB extends ClassA {

  public void d() {
    System.out.println("d()");
  }

}

I would appreciate if it would be possible to automatically generate a list of
all methods not implemented in each abstract class. Another solution is to mark
abstract methods inherited from superclasses (italics?).
(Review ID: 111635)
======================================================================