RFR: 8352612: No way to add back lint categories after "none" [v4]

[Archie Cobbs]

On Thu, 10 Apr 2025 21:03:33 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> wrote:

>> Yes more words are helpful. I think we also need to say that `all` and `none` can't be preceded by a hyphen (I just learned this not long ago :)
>> 
>> What do you think about this?
>> 
>> <a id="option-Xlint-custom">`-Xlint:`[`-`]*key*(`,`[`-`]*key*)*</a>
>> :   Enables and/or disables selected warning categories. Categories are identified by one or more
>>     keys separated by commas. Keys preceded by a hyphen (`-`) disable the corresponding category;
>>     hyphens are not supported by the special keys `all` and `none`.
>
> It's good --- but I guess I liked to say that a key was either a warning category (serial) or something to enable/disable things in bulk (all/none). This is now missing in the new text.

Hmm how about this:

<a id="option-Xlint-custom">`-Xlint:`[`-`]*key*(`,`[`-`]*key*)*</a>
:   Enables and/or disables warning categories using the one or more of the keys described
    below separated by commas. The keys `all` and `none` enable or disable all categories
    (respectively); other keys enable the corresponding category, or disable it if preceded
    by a hyphen (`-`).

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

PR Review Comment: https://git.openjdk.org/jdk/pull/24227#discussion_r2038377021