[ 
https://issues.apache.org/jira/browse/MJAVADOC-387?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15578516#comment-15578516
 ] 

Hudson commented on MJAVADOC-387:
---------------------------------

SUCCESS: Integrated in Jenkins build maven-plugins #7350 (See 
[https://builds.apache.org/job/maven-plugins/7350/])
[MJAVADOC-387] Handle JDK8 -Xdoclint

Add proper handling of -Xdoclint. Option is only evaluated if Java 1.8+ is used 
otherwise a warning is issued.
Due to a limitation in Modello, it cannot simply enabled by <doclint /> because 
it is umarshaled to null instead of "". One has to use <doclint>all</doclint> 
explicitly. (michaelo: [http://svn.apache.org/viewvc/?view=rev&rev=1765097])
* (edit) 
maven-javadoc-plugin/src/main/java/org/apache/maven/plugin/javadoc/AbstractJavadocMojo.java


> Handle JDK8 -Xdoclint
> ---------------------
>
>                 Key: MJAVADOC-387
>                 URL: https://issues.apache.org/jira/browse/MJAVADOC-387
>             Project: Maven Javadoc Plugin
>          Issue Type: Improvement
>          Components: javadoc
>    Affects Versions: 2.10.4
>            Reporter: scolebourne2
>            Assignee: Michael Osipov
>              Labels: close-pending
>             Fix For: 3.0.0
>
>
> The Oracle team have added the doclint tool to JDK 8. The tool validates 
> Javadoc as part of a standard Javadoc run. Unfortunately, with the default 
> settings, it rejects many HTML elements that are perfectly acceptable to 
> browsers, and all invalid Javadoc references (@links). This is likely to 
> prove very unpopular with developers.
> Action needed:
> 1) Provide a maven-javadoc-plugin configuration item and property that can 
> control the doclint tool (currently this requires using additionalparam 
> AFAICT).
> 2) Apply the {{-Xdoclint:none}} option by default, so that doclint is opt-in, 
> not opt-out (ie. fix Oracle's messed up default). This will also make it much 
> easier for developers to handle migration to JDK 8.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to