RFR: 8366561: Improve documentation for how the -Xlint flag works [v3]

[Archie Cobbs]

On Fri, 26 Sep 2025 21:56:48 GMT, Vicente Romero <vromero at openjdk.org> wrote:

>> Archie Cobbs has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains nine additional commits since the last revision:
>> 
>>  - Merge branch 'master' into JDK-8366561 to get recent build fixes.
>>  - Changes based on CSR review suggestions.
>>  - Minor code cleanup.
>>  - Clarify that "processing" is not supported by @SuppressWarnings.
>>  - Synchronize --help-extra and man page descriptions of the "-Xlint" flag.
>>  - Minor refactoring creating method Lint.getDefaults().
>>  - Update man page with the same improvements applied to help output.
>>  - Note that unrecognized strings in @SuppressWarnings annotations are ignored.
>>  - Documentation improvements relating to -Xlint and lint categories.
>
> lgtm

@vicente-romero-oracle thanks for the review!

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

PR Comment: https://git.openjdk.org/jdk/pull/27129#issuecomment-3341038462