[ https://issues.apache.org/jira/browse/MJAVADOC-481?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17045339#comment-17045339 ]
Stephen Colebourne commented on MJAVADOC-481: --------------------------------------------- I'm quite sure there are developers out there still using Java 8 pre u121! At this point I'd prefer to see a change to profiles, because there seem to be more flags getting added in update releases than previously, and Maven can't handle that in general (this is just one speific example). > Java 1.8.0_u121 allow-script-in-comments > ---------------------------------------- > > Key: MJAVADOC-481 > URL: https://issues.apache.org/jira/browse/MJAVADOC-481 > Project: Maven Javadoc Plugin > Issue Type: Improvement > Components: javadoc > Affects Versions: 2.10.4 > Reporter: Stephen Colebourne > Priority: Major > Fix For: wontfix-candidate > > > In its infinite wisdom, Oracle added a new command line flag in the standard > doclet in JDK 8 update release 1.8.0_u121. By default, they now reject any > script tags in headers and footers. An example use for these would be to add > Google Analytics to the footer of each page of Javadoc. For example [see > here|https://github.com/OpenGamma/Strata/blob/9712d78bec9f441024c30e9216e9b243fe679e2b/modules/pom.xml#L645] > > The rejection of scripts can be turned off using "--allow-script-in-comments" > (note the double hyphen). The new flag can only be added to javadoc in > 1.8.0u121 or later. If the flag is added to "additionalparam" and used on > earlier releases of JDK 8, it will complain that it is an unrecognised flag. > Sadly, this does not work: > {code} > <profile> > <activation> > <jdk>[1.8.0.121,]</jdk> > </activation> > <properties> > <additionalparam>--allow-script-in-comments</additionalparam> > </properties> > </profile> > {code} > As such, this needs to be exposed as a flag in Maven to provide a way to > create a Maven pom.xml that is valid for all JDK 8 releases. > Thread complaining about the lack of release notes: > http://mail.openjdk.java.net/pipermail/javadoc-dev/2017-January/thread.html > Issue in Gradle: https://github.com/gradle/gradle/issues/1393 -- This message was sent by Atlassian Jira (v8.3.4#803005)