What I neglected to follow on post was that I have been using Doc++ to generate the class reference in the distributions and web page.
What we really should do, for the distributions, is detected either or and allow the docs to be generated based on what it (configure) finds. At the last time I checked, I thought both Doc++ and Doxygen work with the same JavaDoc tags, but I prefered the Doc++ generation of the class hierarchy diagrams.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
We need something (Doc++?) that will at least generate HTML pages for the interface. This will be needed to bring new developers up to speed.
We all agree that using the JavaDoc syntax keeps us in the clear as the suggested tools all work with this format.
You might want to take a look at doxygen (http://www.stack.nl/~dimitri/doxygen/index.html).
What I neglected to follow on post was that I have been using Doc++ to generate the class reference in the distributions and web page.
What we really should do, for the distributions, is detected either or and allow the docs to be generated based on what it (configure) finds. At the last time I checked, I thought both Doc++ and Doxygen work with the same JavaDoc tags, but I prefered the Doc++ generation of the class hierarchy diagrams.