I would like to be able to integrate automatically generated Javadoc with text and illustrations. From the elaborate text parts I would like to have links/references to class documentation in Javadoc (used as a reference section).
There is a tool that makes Docbook XML from Javadoc, (Docbook Doclet) but I find it hard to integrate other material into the resulting document.
Imagine an ant task that creates Javadoc and merges that with more elaborate texts/illustration/UML diagrams into JavaHelp, PDF, HTML etc. Updated documentation every day.
Any thoughts on this?