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