Your comment about annotation targets made me think; @Documented does not only cause annotations on type definitions to be added to JavaDoc (element type TYPE) but also on method parameters, return values and other elements. But it doesn't seem to work for TYPE_USE. I've asked on the javadoc-dev mailing list for clarification whether that's a general shortcoming or whether there is some way to enable this.