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

Reply via email to