[AXIS2-5885] Generating apidocs fails with Java 8.

• Type: Bug
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 1.7.6
• Fix Version/s: 1.7.7
• Component/s: documentation
• Environment: Windows 10 x86-64, JDK 1.8
• Assignee: Unassigned
• Reporter: Thorsten Schöning
• Created: 06/Sep/17 19:06
• Updated: 10/Sep/17 13:27
• Resolved: 10/Sep/17 13:27

Description

The project "apidocs" can not be build by default using Java 8 because of a lot of errors in the Javadocs and the new "javadoc" errors on those problems instead of warning/ignoring them. A workaround is to add "<failOnError>false</failOnError>" to the configuration, in that case the errors are turned to warnings and the build succeeds.

Most of the errors are pretty easy, like wrong HTML etc. and one just needs to fix what and where "javadoc" says. But some errors are related to missing packages and might be a hint to classpath issues or some problems with available packages in the build?

https://stackoverflow.com/questions/15886209/maven-is-not-working-in-java-8-when-javadoc-tags-are-incomplete

[ERROR] Exit code: 1 - C:\Users\tschoening\Documents\Eclipse\Java Axis2\axis2\apidocs\target\distro-javadoc-sources\org.apache.axis2.osgi-1.8.0-SNAPSHOT-sources\org\apache\axis2\extensions\osgi\util\Logger.java:4: error: package org.osgi.service.log does not exist
[ERROR] import org.osgi.service.log.LogService;
[ERROR] ^

[ERROR] C:\Users\tschoening\Documents\Eclipse\Java Axis2\axis2\apidocs\target\distro-javadoc-sources\axis2-adb-1.8.0-SNAPSHOT-sources\org\apache\axis2\databinding\ADBDataSource.java:44: warning: no description for @param
[ERROR] * @param xmlWriter
[ERROR] ^