RFR: 8364370: java.text.DecimalFormat specification indentation correction

[Chen Liang]

On Thu, 31 Jul 2025 23:12:56 GMT, Justin Lu <jlu 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.

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

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