Hi,
I want to be able to generate a category overview for my Java code and was considering Javadoc as a way to do this.
- Add a custom block tag
@category
to my packages, classes, methods etc. (for example @category DESIGN
)
- Render these in the normal Javadoc output with a Taglet
- Use a custom doclet to find all these tags and produce an HTML doc with subheadings for each category, listing the places where that category is tagged. (ideally with hyperlinks to the main docs)
Does this sound possible?
I think I understand the Doclet interface but it's quite complicated and I expect I'll need a bit of advice. Where do the Javadoc experts hang out?
Thanks.