Umlgraph from www.umlgraph.org is a great tool for automatically creating UML class (and possibly sequence) diagrams from Java classes. It would be very handy to have them in the documentation if the integration into JavaDoc could be automated. Try it!
moving to low prio, documentation will not be changed for a long time