I forgot to add one more important point on this.

In Ada, I see why the need for something like javadoc will be less than
for Java. Becuase in Ada the specification part of the package is
separate from the body.  Hence the specification in Ada can be examined
without the clutter of the body code. in GNAT it even requires that the
specs be in a separate file on its own.

In Java (one of its weak points), is that there is no separate
specification for the package and a separate body. They are all go
togother in one file. So, the need to pull the specifcations for a Java
package out of the java file is more needed than for Ada.

I have not thought of this when I wrote earlier.

thanks,
Nasser