[
https://issues.apache.org/jira/browse/MJAVADOC-387?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15516457#comment-15516457
]
Stian Soiland-Reyes commented on MJAVADOC-387:
----------------------------------------------
Any progress on this?
I must agree that it's not very good of Oracle to have added an activated
default which must be disabled with a (previously unknown) "nonstandard option".
The use of Maven activation profiles is not a good workaround. So I would go
with Tubbs' solution - default is as-is, and a new
{{<doclint>whatever</doclint>}} will add {{-Xdoclint:whatever}} without any
validation. There can be a special recognition of {{<doclint>none</doclint>}}
which means {{-Xdoclint:none}} on JDK 8++ but nothing on JDK 7--. Use of any
other {{<doclint>}} in pre-Java 8 should log a warning (not be bluntly passed
as -Xdoclint). {{<doclint />}} can be equivalent to {{-Xdoclint}} - the
arbitrarily selected profile built in to the Javadoc distro.
I don't know what the behaviour should be for non-Oracle / non-OpenJDK javadoc
which may not hava doclint - but at least with a special option it's possible
to fix that generally in the javadoc plugin as opposed to the use of profiles
and {{additionalparam}}.
> Handle JDK8 -Xdoclint
> ---------------------
>
> Key: MJAVADOC-387
> URL: https://issues.apache.org/jira/browse/MJAVADOC-387
> Project: Maven Javadoc Plugin
> Issue Type: Improvement
> Reporter: scolebourne2
>
> 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)
