RFR [15] JDK-8247815: doclint: recategorize "no description for ..." as MISSING, not SYNTAX

[Pavel Rappo]

One can invoke DocLint in several different ways. Depending on the way they choose, the behaviour will slightly differ.

To understand what happens, I need to know how you invoke DocLint. Would you be able to provide the exact command lines or the code snippets (if you invoke DocLint programmatically)?

-Pavel

> On 19 Jun 2020, at 19:27, Martin Buchholz <martinrb at google.com> wrote:
> 
> Relatedly, today I noticed warnings for missing comments on non-public
> elements with javadoc16 that did not appear in javadoc11.
> 
> CompletableFuture.java:1718: warning: no comment
>    static final class AsyncSupply<T> extends ForkJoinTask<Void>
>                 ^
> 
> Naturally I added the flag -Xdoclint:all,-missing
> BUT I'd like to be able to control which access levels require javadoc comments.
> Few style guides will want to require javadoc comments on private elements.