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

[Archie Cobbs]

On Thu, 10 Apr 2025 18:30:50 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> wrote:

>> Archie Cobbs has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Tweak wording changes and sync to man page per review suggestions.
>
> src/jdk.compiler/share/man/javac.md line 564:
> 
>> 562: 
>> 563: <a id="option-Xlint-custom">`-Xlint:`\[`-`\]*key*(`,`\[`-`\]*key*)\*</a>
>> 564: :   Specifies warning categories to enable or disable, separated by comma.
> 
> This text uses `categories` and `key` in a very loose way -- they seem to refer to the same concept, yet none seems to be defined.
> 
> 
> Enables or disables selected warning categories. Each warning category is identified by a key. Some keys allow multiple categories to be enabled or disabled in bulk. Keys are separated by a comma. Precede a key by a hyphen (-) to disable the corresponding warning category.
> 
> Supported keys are:
> ...
> 
> 
> What do you think?

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`.

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

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