[ https://jira.codehaus.org/browse/MJAVADOC-387?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=345159#comment-345159 ]
Stephen Colebourne commented on MJAVADOC-387: --------------------------------------------- Based on observation, the real issue seems to be trying to get a build to work in both JDK 8 and earlier JDKs. IIUC, the -X flag is not accepted by earlier javadocs, so the only approach is the tedious and non-helpful fixing of Javadoc to Oracle's artificial standards. > 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)