opened 09:13PM - 20 Sep 18 UTC
When I run the Processing template targeting Java SE-1.8, the
> [javadoc] Co… nstructing Javadoc information...
> [javadoc] Standard Doclet version 10.0.1
> [javadoc] Building tree for all the packages and classes...
> [javadoc] javadoc: error - Error - Exception java.lang.ClassNotFoundException thrown while trying to register Taglet ExampleTaglet...
In the Processing Library template there is a file
resources > code > ExampleTaglet.java
It begins with
import com.sun.tools.doclets.Taglet;
I think that in Java 8+ that would instead would be:
import java.jdk.Taglet;
...I'm not sure if there are other changes that would need to be made.
I am not familiar with doclets and Taglets -- looking over the code, it isn't clear to me why ExampleTaglet would actually be used -- although is referenced in Ant's build.xml:
<taglet name="ExampleTaglet" path="resources/code" />
Anyway, when it fails the documentation as a whole fails to build.
Assuming this is a problem for others, it seems like either ExampleTaglet should be fixed or it should be removed from build.xml to not block javadoc generation.
My solution was to remove the above <taglet> line from build.xml.
Here are two possible solutions:
remove this line from build.xml.
<taglet name="ExampleTaglet" path="resources/code" />
make sure that the Eclipse project is using Java 8 – not just targeting 8 but using a built-in Java 10 or 11. Under Your project > Properties > Java Build Path > Libraries, confirm that you see JavaSE 1.8