On Fri, 20 Jan 2023 18:34:37 GMT, Lance Andersen <lan...@openjdk.org> wrote:
>> src/java.base/share/classes/java/text/DecimalFormat.java line 343:
>>
>>> 341: * <blockquote><pre><strong>{@code
>>> 342: * // Print out a number using the localized number, integer, currency,
>>> 343: * // and percent format for each locale}</strong>{@code
>>
>> This comment is originally in strong font within the code example. Replacing
>> both instances of `@ code` with `@ snippet` will just create two separate
>> snippet blocks, one for the comment and one for the code which does not seem
>> ideal.
>>
>> To maintain the strong font, the comment has to be outside of the code
>> snippet.
>>
>> If that's not desirable, I think some alternatives are
>>
>> - Leave the comment in the code snippet and get rid of the strong font
>> - Keep the strong font but convert the comment into a normal text description
>
> I would leave the comment in the code snippet. I don't see a compelling
> reason for it to be as it was originally
+1
-------------
PR: https://git.openjdk.org/jdk/pull/12121
