CODEWITHSUNDEEP
javajavadocdoclet
Cheeso
Cheeso

Reputation: 192637

Java: How can I create good looking class docs with Javadoc?

I'd like to create HTML documentation for a Java class library that includes

I want it to look well-styled. Something like this:

alt text

I think that Javadoc exposes a doclet API that allows other parties to provide doc generation integrated in Javadoc. Is there a doclet option that I can use (for free) that does something a little nicer than the standard javadoc output?

I tried googling for this but no luck. Suggestions?

Addendum
I found doclet.com but I don't know how to evaluate the options. Recommendations?

In particular, XHtmlDoclet sounds like it wants to address these issues. Anyone used it? I can't get it to work. Also the example offered by the XHTML Doclet guys doesn't look any better than the docs generated from c.1998 javadoc .

Related:
Why does Javadoc generate non-compliant XHTML?

Upvotes: 3

Views: 1390

Answers (2)

duffymo
duffymo

Reputation: 309008

Perhaps you're thinking of Java doclet API:

http://www.oracle.com/technetwork/java/javase/documentation/index-jsp-135444.html

It appears that you're adding examples and some text. I think it's entirely possible with existing javadocs. The problem will be the content rather than the rendering.

Castor used doclet to ease its config burden. So did EJB 1.0. Take a look at those if you'd like.

Upvotes: 1

ig0774
ig0774

Reputation: 41287

This question got me thinking (ok, Googling) and I stumbled on this set of taglets. Never tried it, but it looks pretty promising.

Upvotes: 1

Related Questions