RFR: 8325075: Enable -Werror for javadoc to fail on any warnings

[Kevin Rushforth]

On Tue, 5 Mar 2024 17:45:01 GMT, Andy Goryachev <angorya at openjdk.org> wrote:

> When used with the PR #1389, the build generates a sole javadoc warning and fails:

Good. That's expected.

> Is there any way to selectively suppress certain javadoc warnings (now errors?) if so, could we document them, possibly in the wiki page https://wiki.openjdk.org/pages/viewpage.action?spaceKey=OpenJFX&title=Building+OpenJFX
> 
> ?

You mean on the command line? Good question, I can check whether it is possible to turn off a single without turning off all errors (which is easy), but even better would be to add a flag to turn off `-Werror`. Maybe something like `-PDOC_WERROR=false` (defaults to true)?

-------------

PR Comment: https://git.openjdk.org/jfx/pull/1390#issuecomment-1979347095