[jira] [Created] (IGNITE-13202) Javadoc HTML can't be generated correctly with maven-javadoc-plugin on JDK 11+

[Anton Vinogradov (Jira)]

Aleksey Plekhanov created IGNITE-13202:
------------------------------------------

             Summary: Javadoc HTML can't be generated correctly with maven-javadoc-plugin on JDK 11+
                 Key: IGNITE-13202
                 URL: https://issues.apache.org/jira/browse/IGNITE-13202
             Project: Ignite
          Issue Type: Bug
            Reporter: Aleksey Plekhanov


Javadoc utility has some bugs which don't allow to build Ignite Javadocs correctly.

Building javadoc under JDK 11+ throws an error "The code being documented uses modules but the packages defined in
https://docs.oracle.com/javase/8/docs/api are in the unnamed module". To workaround this error argument "source=1.8" can be specified, but there is another bug related to "source" and "subpackages" argument usages: [https://bugs.openjdk.java.net/browse/JDK-8193030.] We still can build javadoc with disabled {{detectJavaApiLink}} maven-javadoc-plugin option, but in this case there will be no references to Java API from Ignite Javadoc.  

Also, there is a bug with "-exclude" argument in JDK 11+, it doesn't exclude subpackages of specified to exclude packages, so in generated output there is a lot of javadocs for internal packages. 



--
This message was sent by Atlassian Jira
(v8.3.4#803005)