Hi all,
if you're curious about generating javadocs with embedded uml diagrams
with UMLGraph have a look at the bottom of:
http://docs.codehaus.org/display/GEOSDOC/2+Maven+Quickstart
I've committed patches that allow the generation on 1.4.x, trunk and ows4.
Cheers
Andrea
PS: being on codehaus we may want to try out also yDoc, which is not open
source but generates better looking diagrams (even if not as informative as
UMLGraph ones in my opinion, but I'm biased :-p )