RFR CSR: JDK-8237391 Add -Werror option to javadoc

[Pavel Rappo]

I like it.

When comparing the wording for the corresponding option for javac I noticed that
it is more vague than that of the proposed for javadoc:

    -Werror  Terminate compilation if warnings occur (javac)
    -Werror: treat warnings as if they were errors (proposed for javadoc)

Does the latter preclude lazy behaviour (i.e. the documenting process terminates
immediately after the first warning occurs)?

It might not be a big deal, especially taking into account that javadoc doesn't
have options such as:

     -Xmaxerrors number
              Set the maximum number of errors to print.

       -Xmaxwarns number
              Set the maximum number of warnings to print.

-Pavel

> On 16 Jan 2020, at 20:13, Jonathan Gibbons <jonathan.gibbons at oracle.com> wrote:
> 
> Please review a simple CSR to have javadoc support a new option, -Werror, similar to the equivalent javac option.
> 
> https://bugs.openjdk.java.net/browse/JDK-8237391
> 
> -- Jon
>