<i18n dev> RFR: 8364370: java.text.DecimalFormat specification indentation correction

[Justin Lu]

On Thu, 31 Jul 2025 23:21:17 GMT, Chen Liang <liach at openjdk.org> wrote:

>> Please review this doc only PR.
>> 
>> java.text.DecimalFormat uses an implSpec tag in the middle of the class description. This location was on purpose as the contents related to the surrounding section. However, this has caused slight indentation in the rest of the class description below the tag (as pointed out by @naotoj) . Using the implSpec tag at the bottom of the class is preferable for formatting purposes.
>> 
>> There are no contract changes, simply a re-organization of existing contents, thus no CSR is filed.
>
> In fact, per the [specs](https://docs.oracle.com/en/java/javase/24/docs/specs/javadoc/doc-comment-spec.html#block-tags):
> 
>> The content of a block tag is any text following the tag up to, but not including, either the next block tag, or the end of the documentation comment.
> 
> It may be surprising that block tags have higher precedence over HTML headers. Just a note for the future.

Thanks @liach  for taking a look. Yes, I don't believe there should be anything preventing this from getting into 25 as well. 

I plan to integrate soon, but I want to make sure @naotoj is OK with the changes as well since he spotted the issue.

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

PR Comment: https://git.openjdk.org/jdk/pull/26585#issuecomment-3145250840