This week's book giveaway is in the OO, Patterns, UML and Refactoring forum. We're giving away four copies of Refactoring for Software Design Smells: Managing Technical Debt and have Girish Suryanarayana, Ganesh Samarthyam & Tushar Sharma on-line! See this thread for details.
I once wrote a plain doclet that I've used in several projects to do "native method folding." Basically there's a "@C" tag and you can use it to embed C-language code into the Javadoc for a native method, so Java and native code can be developed together in one source file. The doclet generates the stubs, sticks in the method bodies, compiles everything and builds libraries. For native methods that are just little wrappers for a platform library, it works great. Do you know of someone doing something similar with XDoclet? What's it like? [ December 09, 2003: Message edited by: Ernest Friedman-Hill ]
XDoclet can generate javadoc-like documentation for projects. It also has a couple of other documentation tasks. My of my favorite is the todo generator. You can mark classes/methods with @todo tags and the todo generator will generator a javadoc style todo report showing all your todo items, nicely sorted by class and package. It's also a good framework for generating your own custom documentation. I don't know of anyone generating JNI code from within XDoclet. There's no reason that you couldn't do it though. I don't know many people doing JNI, but it might an interesting possible standard task.
I’ve looked at a lot of different solutions, and in my humble opinion Aspose is the way to go. Here’s the link: http://aspose.com