RFR: JDK-8298405: Support Markdown in Documentation Comments [v22]

[Jonathan Gibbons]

On Mon, 12 Feb 2024 17:23:56 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

>> It's possible, but that would be a more global setting, whereas this is a very targeted modification.
>> 
>> I guess it depends how much we want to import the code as-is, without knowing any lint-warts.
>> 
>> FWIW, any module can be compiled with module-specific lint settings, if we choose to do so.
>
>> I guess it depends how much we want to import the code as-is, without knowing any lint-warts.
> 
> I think it would be nice not to have to modify code beyond superficial edits: addition of headers, renaming of packages, and converting of non-ASCII symbols.

I think adding `@SuppressWarnings` is a superficial edit, but I see the writing on the wall.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/16388#discussion_r1486531142