[jira] [Created] (AXIS2-5885) Generating apidocs fails with Java 8.

["Thorsten Schöning (JIRA)" <ji...@apache.org>]

Thorsten Schöning created AXIS2-5885:
----------------------------------------

             Summary: Generating apidocs fails with Java 8.
                 Key: AXIS2-5885
                 URL: https://issues.apache.org/jira/browse/AXIS2-5885
             Project: Axis2
          Issue Type: Bug
          Components: documentation
    Affects Versions: 1.8.0
         Environment: Windows 10 x86-64, JDK 1.8
            Reporter: Thorsten Schöning
            Priority: Minor


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

{CODE}
[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] ^
{CODE}

{CODE}
[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] ^
{CODE}



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)

---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@axis.apache.org
For additional commands, e-mail: java-dev-help@axis.apache.org