The documentation
does not seem to indicate a way to do this. I was thinking I could
write a custom template to do it, since there are template hooks to get the methods, classnames, etc; but wondered if anyone else had
already written such a template, at least for the JavaDocs.
I don't know of any existing one, but I guess the todo list generation subtask might give you a starting point; that already generates pages for each package & class and a suitable frameset etc. Just change it to print the signatures & javadoc comments instead of only the @todo values.
Is the todo list part of the standard source download?
For generating XML of the Java source itself I don't see any template libs which dig into the code deeper than the field / method / argument level.
There aren't any. The xjavadoc parser was only designed for accessing the javadocs, since that's all we needed.
Ah. Then that answers my question then. I figured somewhere there had to be an actual java code parser, though obviously it would be much slower than one for just javadocs.
Is it possible to access the actual lines of source via XDoclet, say to make annotated HTMLs of the source?
Anything's possible, I guess, but I don't know how easy it would be. You'd have to adapt xjavadoc to give access to the code as well as the
javadocs. What sort of annotations are you thinking of? Maybe there's
some other (easier) way to do it?
I've been working on three different ideas, all of which I've been hoping xdoclets could help me with.
1) I want to generate javadocs as XML. Then I could run XSLTs on the XML to convert it into whatever I want. I'm working on a Swing application which will allow you to search and display a set of javadocs in interesting ways.
2) I want to print out the sourcecode as HTML so that I can browse the source tree via the web. I'm sure that there must be other tools that do this though.
3) I want to create abridged versions of some Javadocs. Imagine two versions of the docs for javax.swing.JButton, one which is the full API and one which only has the 10 methods that you use 99% of the time. One for new developers and one for advanced developers. Or perhaps combine them but have the advanced apis hidden until you click a 'show more' button.
Thanks for your help,
- Joshua
-------------------------------------------------------
This SF.Net email sponsored by Black Hat Briefings & Training.
Attend Black Hat Briefings & Training, Las Vegas July 24-29 - digital self defense, top technical experts, no vendor pitches, unmatched networking opportunities. Visit www.blackhat.com
_______________________________________________
xdoclet-user mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-user
