[dna-dev] Adding umlgraph to our javadoc

[Stefano Maestri]

I tried to add UmlGraph generated images to dna project javadocs.
The result is nice: http://www.javalinuxlabs.org/apidocs/index.html
I attached here the only modification needed to pom.xml to get this result.
UmlGraph can also model composition relation with custom javadocs tags, 
but, IMHO the totally automatic results is fine and easy for all.
Also public method can be added to the model, but I think it's better to 
have easy to read structural model and leave to javadoc deeper 
descriptions of class components and methods.

The only problem with UmlGraph is that it depends on GraphViz, and this 
dependencies can't be administered by maven, since graphvz isn't a java 
package. UmlGraph just expect GraphViz instaed on building host and 
fails if it isn't. I didn't find any elegant and brief way to solve the 
problem: any suggestion?

BTW have Hudson's host GraphViz installed? Is this strong unmanaged 
dependency acceptable for javadoc target?

IMHO enriched javadocs is nice and could help a lot community to 
understand our sw architecture/class hierarchy. At least they helped me :)

best regards
S.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: pom.xml.patch
Type: text/x-diff
Size: 1225 bytes
Desc: not available
Url : http://lists.jboss.org/pipermail/dna-dev/attachments/20080626/f5b8803d/attachment.bin