Tim, Personally, I have liked using Doxygen because I am able to use the same style of documentation comments in both Java and C code, not to mention using the external hook to for a custom filter to document scripts, Makefiles, and the like.
What specifically are you looking to do? It has been quite a while since I reviewed our Doxygen-based source code, so I am not up on the latest, but the Doxygen control file can do some amazing stuff. Is there something specifically that is an issue? Dan Lydick > [Original Message] > From: Tim Ellison <[EMAIL PROTECTED]> > To: <[email protected]> > Date: 1/29/2008 5:42:56 AM > Subject: [doc] A better javadoc? > > I have been running doc tools over our code to generate developer API > documentation. I tried both Javadoc and Doxygen. > > I'll admit that I'm not too keen on the Doxygen output style for Java. > Maybe I'm just not used to it, but I find it hard to navigate and > visualize the code structure using their pages. > > While the JavaDoc output is more familiar to most people, it too is not > great. > > I wonder, in this world of rich client side functionality, is there a > documentation tool that renders javadoc comments in a smarter and more > usable style? > > Regards, > Tim
