[CMIS-977] Fix Javadoc to comply with Java8 DocLint

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: OpenCMIS 0.14.0
• Fix Version/s: OpenCMIS 1.0.0
• Component/s: build&release
• Assignee: Unassigned
• Reporter: Gabriele Columbro
• Created: 26/Apr/16 20:09
• Updated: 30/Aug/16 09:02
• Resolved: 30/Aug/16 09:02

Description

As we moved to Java 8, DocLint was introduced and our build fails on many incomplete Javadoc tags (description of the issue http://stackoverflow.com/questions/15886209/maven-is-not-working-in-java-8-when-javadoc-tags-are-incomplete).

Details of the errors to fix are attached.

In the meanwhile I have added a temporary fix to process with 0.14.0 release, but I believe this should be fixed for 1.0.0.

The fix is to disable docLint for Java 8 and above as follows:

<!-- Added profile to fix "doclint" (see
This is a temporary solution, until we solve
-->
<profile>
<id>disable-java8-doclint</id>
<activation>
<jdk>[1.8,)</jdk>
</activation>
<properties>
<additionalparam>-Xdoclint:none</additionalparam>
</properties>
</profile>