Skip to content

Running Gradle JavaDoc task on Java 9 and later throws warnings and errors. #1076

Closed
@georgeajit

Description

@georgeajit

So we can address your issue, please include the following:

Version of MarkLogic Java Client API

4.2.0

Version of MarkLogic Server

9.0 nightly build

Java version

Java 9, OpenJDK 10, 11

OS and version

Linux

Input: Some code to illustrate the problem, preferably in a state that can be independently reproduced on our end

N/A

Actual output: What did you observe? What errors did you see? Can you attach the logs? (Java logs, MarkLogic logs)

+ ./gradlew -Dorg.gradle.java.home=/home/builder/java/jdk-10.0.2 -Dkotlin.compiler.execution.strategy=in-process -Dorg.gradle.daemon=false javaDoc
WARNING: An illegal reflective access operation has occurred
WARNING: Illegal reflective access by org.codehaus.groovy.vmplugin.v7.Java7$1 (file:/tmp/.gradle/wrapper/dists/gradle-5.0-bin/pu5208521seraqlersebvqk/gradle-5.0/lib/groovy-all-1.0-2.5.4.jar) to constructor java.lang.invoke.MethodHandles$Lookup(java.lang.Class,int)
WARNING: Please consider reporting this to the maintainers of org.codehaus.groovy.vmplugin.v7.Java7$1
WARNING: Use --illegal-access=warn to enable warnings of further illegal reflective access operations
WARNING: All illegal access operations will be denied in a future release
> Task :marklogic-client-api:compileJava UP-TO-DATE
> Task :marklogic-client-api:processResources UP-TO-DATE
> Task :marklogic-client-api:classes UP-TO-DATE

> Task :marklogic-client-api:javadoc
javadoc: warning - You have not specified the version of HTML to use.
The default is currently HTML 4.01, but this will change to HTML5
in a future release. To suppress this warning, please specify the
version of HTML used in your documentation comments and to be
generated by this doclet, using the -html4 or -html5 options.
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/pojo/PojoRepository.java:221: warning: @return has already been specified
   * @return the number of instance in the db matching the query
     ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/DatabaseClientFactory.java:585: warning: no @param for authorizationToken
		public SAMLAuthContext(String authorizationToken) {
		       ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/WriteBatcher.java:74: warning: no @return
    WriteBatcher withDefaultMetadata(DocumentMetadataHandle handle);
                 ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/JacksonCSVSplitter.java:119: warning: no @throws for java.lang.Exception
    public Stream<JacksonHandle> split(Reader input) throws Exception  { 
                                 ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/Splitter.java:33: warning: no @throws for java.lang.Exception
    Stream<T> split(InputStream input) throws Exception;
              ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/ProgressListener.java:69: warning: no description for @param
	 * @param consumers
	   ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/ProgressListener.java:79: warning: no description for @param
	 * @param consumers
	   ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/ProgressListener.java:80: warning: no description for @param
	 * @param totalResults
	   ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/ProgressListener.java:102: warning: no description for @param
	 * @param queryBatcher
	   ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/ProgressListener.java:116: warning: no description for @param
	 * @param batch
	   ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/ProgressListener.java:148: warning: no description for @param
	 * @param batch
	   ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/ProgressListener.java:149: warning: no description for @param
	 * @param startTime
	   ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/ProgressListener.java:150: warning: no description for @param
	 * @param totalForThisUpdate
	   ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/ProgressListener.java:151: warning: no description for @param
	 * @param timeSoFar
	   ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/ProgressListener.java:152: warning: no description for @return
	 * @return
	   ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/ProgressListener.java:161: warning: no description for @param
	 * @param consumer
	   ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/datamovement/ProgressListener.java:162: warning: no description for @param
	 * @param progressUpdate
	   ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/example/cookbook/datamovement/JobInformationRecorder.java:122: warning: no @param for dataMovementManager
  public JobInformationRecorder withWriteBatcher(DataMovementManager dataMovementManager, WriteBatcher writeBatcher) {
                                ^
/space/Jenkins/workspace/Java10/Java-client-api-master-9.0-nightly_OPENJDK10/java-client-api/marklogic-client-api/src/main/java/com/marklogic/client/example/cookbook/datamovement/JobInformationRecorder.java:213: warning: no description for @return
   * @return
     ^
src/main/javadoc/overview.html:292: error: reference not found
    {@link com.marklogic.client.extra.xom.XOMHandle}, you download the
           ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
     ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
          ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
               ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                    ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                         ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                              ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                   ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                        ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                             ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                  ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                       ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                            ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                                 ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                                      ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                                           ^
src/main/javadoc/overview.html:339: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                                                ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
     ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
          ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
               ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                    ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                         ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                              ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                   ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                        ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                             ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                  ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                       ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                            ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                                 ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                                      ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                                           ^
src/main/javadoc/overview.html:340: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                                                ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
     ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
          ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
               ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                    ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                         ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                              ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                   ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                        ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                             ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                  ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                       ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                            ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                                 ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                                      ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                                           ^
src/main/javadoc/overview.html:341: error: self-closing element not allowed
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
                                                                                ^
52 errors
20 warnings

> Task :marklogic-client-api:javadoc FAILED

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':marklogic-client-api:javadoc'.

Expected output: What specifically did you expect to happen?

Task should be marked as successful.

Alternatives: What else have you tried, actual/expected?

N/A.

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions