dev@glassfish.java.net

Re: javadoc and annotations

From: Bill Shannon <bill.shannon_at_sun.com>
Date: Tue, 12 May 2009 11:35:31 -0700

Lloyd Chambers wrote:
> Does anyone know if there is a way of getting the javadoc tool to emit
> documentation on annotations?
>
> I've read the docs and as far as I can tell, javadoc blindly ignores all
> annotations.
>
> For example, I'd like the @Taxonomy annotation to be included in the
> javadoc as a key part of the documentation.
>
> @Taxonomy(stability = Stability.COMMITTED)
> public interface AMX_SPI {
> ...
> }

I think you have to annotate the annotation with @Documented.