Hi Mark,
I think we need to make a decision for the plugin first on how to handle
this.
IMHO it's not the task of the maven-javadoc-plugin to maintain backwards
compatibility because Oracle has decided to change the behavior.
However, if we keep it like it is, we'll get a huge number of jira issues
blaming the maven-javadoc-plugin to be broken.
Since we can't tell if the javadoc errors were based old or new code
changes, we might need to give a message/disclaimer describing that the
build could have failed due to the changes of the javadoc executable.
Add to that message the xdoclint options to get the original behavior.
regarding the parent, we probably also want to add -reference ( as
suggested by one of the Oracle developers )
thanks,
Robert
Op Thu, 01 May 2014 12:15:45 +0200 schreef Mark Struberg
<strub...@yahoo.de>:
Hi!
Building with Java8 breaks buiding JavaDocs many existing maven projects.
And thus most times also breaks releasing them.
The reason is that they enabled all warnings and errors now by default.
This means that we get tons of oddly broken builds because it also
breaks for missing @param, etc.
I first had
<additionalparam>-Xdoclint:none</additionalparam>
But this is way too strict for apache-parent
My next try was
<additionalparam>-Xdoclint:all,-missing</additionalparam>
But this triggers a bug in maven-javadoc-plugin because the comma gets
used for splitting the parameters. And
-Xdoclint:all,-missing
is really different to
-Xdoclint:all
-missing
You can check it yourself in ./target/site/apidocs/options of your own
projects.
What seems to work is splitting them up into 2 parameters:
<additionalparam>-Xdoclint:all -Xdoclint:-missing</additionalparam>
Should we add this to apache-parent?
Any other doclint tweaks you like to do for it?
LieGrue,
strub
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
For additional commands, e-mail: dev-h...@maven.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
For additional commands, e-mail: dev-h...@maven.apache.org
