FULL PRODUCT VERSION :
version 1.4.1

A DESCRIPTION OF THE PROBLEM :
The Java standard libraries are ever expanding. The Javadoc
generated API documentation is helpful but becomes difficult
to survey. A new kind of information compression is necessary.
Class diagrams could be up to this job.

  To be really useful these diagrams should be created by humans
and included in the HTML-documentation. The various elements
in the diagram should link to the normal API specifications.


REPRODUCIBILITY :
This bug can be reproduced always.

CUSTOMER WORKAROUND :
Class diagrams for JDK 1.4 that illustrate the concept
are found at www.falkhausen.de/en/index.html
(Review ID: 178316) 
======================================================================

N/A

The work at falkhausen.de would be an enormous amount 
of work for us to reproduce.  Since that work is already done, it seems
better to simply point to that work, perhaps from our docs page and javadoc
FAQ page.

  xxxxx@xxxxx   2002-12-03
  xxxxx@xxxxx   2004-12-16 23:30:10 GMT

A package to automatically generate class diagrams like
those at falkhausen.de should be included in a future
version of Java.

A package to automatically generate class diagrams like
those at falkhausen.de should be included in a future
version of Java.
He's right You know - and his diagrams are a beauty :-)
Bertil G

ditto telemus' comments of 4 Feb 2003
Graphic depiction of the classes is essential for me to get a 
fast, concise overview of the entire framework of the 
language.  

Providing a tool has a dual benefit: 1. Sun can reuse at any 
time it generates a new release of Java, or 2. Sun or anyone 
can use the tool to provide class diagrams of ANY package!!

Come on, time to communicate using UML!!  After all, we use 
it to communicate our designs, why not use it for the design 
of the infrastructure that we are building on?
--

Diagrams are very Usefull to scan/learn things quickly , 
especially when you first time going to use some package.
Falkhausen does GOOD Job!!! I like it.
It may be usefull to enter some signs to identify on the 
diagrams the deltas/changes of the version. To the full 
explanation of the changes link to other HTML.

A package to automatically generate class diagrams 
like those at falkhausen.de(beauty ones)should be 
included in a future version of Java. 

It should not difficult to develop a UML class diagram during javadoc generation such as the one provided by yWorks' yDoc (although this is only confined to the current class). This integrates nicely with javadoc and does not need too much extra work. It uses SVG.

Forgot to put the link: http://www.yworks.com/en/products_ydoc.htm

Work done by Falkhausen.de is fine but is limited to J2SE only. How about extending it to J2EE or fund them  to do so.

A package to automatically generate class diagrams like
those at falkhausen.de should be included in a future
version of Java

A package to automatically generate class diagrams like

I have searched  many hours for  this solution!
Jarek

I too would like to see something similar to that on falkhausen.de

Just extend javadoc comments (optional / javadoc recommendation) to include diagram-related properties (like: this method should appear in diagram with no param., this field should also show the default value etc.). Generation afterwards should be quite straightforward if this data is in place (UML community tools, plugged in javadoc, can be used).
As proof of concept, a free generation tool verified against falkhausen test cases can be released before any “official” effort.
The return on investment would include better Java language penetration and also better A&D on the core classes (including J2EE).

This would REALLY REALLY be slick. I mean REALLY.

Any hope of ever seeing this?  It *would* save me hours of studying as it's easier to understand layered information if it's drawn out; what's the programmer's number 1 rule for starting any project... draw a picture.  I have to run and memorize the first 1300 pages of my intro to Java book  for my 8am final which starts in 2 hours...Arg!

Just extend javadoc comments to automatically generate class diagrams 

Please add class diagrams as an on-demand feature to Java API docs.
Class diagrams are really very useful when some one tries to study a package thoroughly. And they become far more importent is somebody wants to implement some API e.g. JAXP for a new DOM implementation - my requirement.

It is high time sun realizes the importance of visual documentation. UML has come of age and doesn't need introduction. Should take it a step at a time adding class diagrams first, then may be follow it with sequence diagrams