[DRILL-4547] Javadoc fails with Java8

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.6.0
• Fix Version/s: 1.17.0
• Component/s: Tools, Build & Test
• Assignee: Vova Vysotskyi
• Reporter: Laurent Goujon
• Created: 28/Mar/16 20:47
• Updated: 04/Dec/19 13:07
• Resolved: 04/Dec/19 13:07

Description

Javadoc cannot be generated when using Java8 (likely because the parser is now more strict).

Here's an example of issues when trying to generate javadocs in module drill-fmpp-maven-plugin

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.9.1:jar (attach-javadocs) on project drill-fmpp-maven-plugin: MavenReportException: Error while creating archive:
[ERROR] Exit code: 1 - /Users/laurent/devel/drill/tools/fmpp/src/main/java/org/apache/drill/fmpp/mojo/FMPPMojo.java:44: error: unknown tag: goal
[ERROR] * @goal generate
[ERROR] ^
[ERROR] /Users/laurent/devel/drill/tools/fmpp/src/main/java/org/apache/drill/fmpp/mojo/FMPPMojo.java:45: error: unknown tag: phase
[ERROR] * @phase generate-sources
[ERROR] ^
[ERROR] /Users/laurent/devel/drill/tools/fmpp/target/generated-sources/plugin/org/apache/drill/fmpp/mojo/HelpMojo.java:25: error: unknown tag: goal
[ERROR] * @goal help
[ERROR] ^
[ERROR] /Users/laurent/devel/drill/tools/fmpp/target/generated-sources/plugin/org/apache/drill/fmpp/mojo/HelpMojo.java:26: error: unknown tag: requiresProject
[ERROR] * @requiresProject false
[ERROR] ^
[ERROR] /Users/laurent/devel/drill/tools/fmpp/target/generated-sources/plugin/org/apache/drill/fmpp/mojo/HelpMojo.java:27: error: unknown tag: threadSafe
[ERROR] * @threadSafe
[ERROR] ^
[ERROR] 
[ERROR] Command line was: /Library/Java/JavaVirtualMachines/jdk1.8.0_72.jdk/Contents/Home/bin/javadoc @options @packages
[ERROR] 
[ERROR] Refer to the generated Javadoc files in '/Users/laurent/devel/drill/tools/fmpp/target/apidocs' dir.
[ERROR] -> [Help 1]
[ERROR] 
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
[ERROR] 
[ERROR] After correcting the problems, you can resume the build with the command
[ERROR]   mvn <goals> -rf :drill-fmpp-maven-plugin

Issue Links

• blocks: DRILL-1491 Support for JDK 8
• causes: DRILL-6287 apache-release profile should be disabled by default
• is related to: DRILL-6904 Update maven-javadoc-plugin to 3.0.1 version
• relates to: DRILL-6333 Fix Quotation marks in Javadocs