On Thu, 31 Jul 2025 23:21:17 GMT, Chen Liang <li...@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
