Javadoc custom Taglets

[Alan Bateman]

On 17/04/2016 12:03, Robert Scholte wrote:
> Hi,
>
> in preparation of the DevoxxFr talk about Maven and Java9 by Hervé 
> Boutemy and Arnaud Héritier I noticed some issues with custom taglets 
> when generation Javadoc reports.
>
> For the developers of Maven plugins we have a set of Annotations or 
> DocletTags[1] to generate the plugin descriptor.
> The taglets are based on com.sun.tools.doclets.Taglet, but when trying 
> to run this with Java 9-ea+113 I get the following exception.
>
> Caused by: org.apache.maven.plugin.MojoExecutionException: An error 
> has occurred in JavaDocs report generation:
> Exit code: 1 - javadoc: error - Error - Exception 
> java.lang.ClassCastException thrown while trying to register Taglet 
> org.apache.maven.tools.plugin.javadoc.MojoAggregatorTypeTaglet...
>
> What's the preferred way to write custom Taglets when using Java9 and 
> will this also work with older versions of Java?
>
I will guess that this is related to the JEP 221 work on the new doclet 
API, maybe jdk.javadoc.doclet.taglet.Taglet vs. 
com.sun.tools.doclets.Taglet. It might be best to bring this to 
javadoc-dev for discussion.

-Alan