You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Hendy Irawan (JIRA)" <ji...@codehaus.org> on 2015/01/06 11:22:19 UTC
[jira] (MJAVADOC-387) Handle JDK8 -Xdoclint
[ https://jira.codehaus.org/browse/MJAVADOC-387?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=360788#comment-360788 ]
Hendy Irawan commented on MJAVADOC-387:
---------------------------------------
{{doclint}} should be a configuration option in maven javadoc plugin, which the user can set to {{none}} to disable in JDK8+.
In < JDK8, this configuration if set to {{none}} or {{auto}} will have no effect. But if set to a valid value, should probably log a warning since {{doclint}} is not supported.
Thus making everybody happy. :)
> Handle JDK8 -Xdoclint
> ---------------------
>
> Key: MJAVADOC-387
> URL: https://jira.codehaus.org/browse/MJAVADOC-387
> Project: Maven Javadoc Plugin
> Issue Type: Improvement
> Reporter: Stephen Colebourne
>
> 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.1.6#6162)