On Tue, 19 Aug 2025 11:57:45 GMT, Hannes Wallnöfer <[email protected]> wrote:
> Please review a change to fix the reported position of the label in `@see` > tags in Markdown doc comments. When `MarkdownTransformer` would process the > label of a `@see` tag together with the leading reference, it would set the > position of the label to the position immediately following the reference, > losing the actual source position of the label. The solution is to process > the label without the leading reference. > > I have looked for other standard tags that may be affected by similar > problems, but the `@see` tag is the only tag that [supports multiple > forms](https://docs.oracle.com/en/java/javase/24/docs/specs/javadoc/doc-comment-spec.html#see) > where Markdown text is stored in a list together with non-Markdown arguments. > > The two tests are slightly redundant, but they test slightly different > aspects of the fix and they were easy to implement in their respective > frameworks. This pull request has now been integrated. Changeset: 908f3c96 Author: Hannes Wallnöfer <[email protected]> URL: https://git.openjdk.org/jdk/commit/908f3c96978bfa031414e576f444ec8f4dcc6925 Stats: 59 lines in 4 files changed: 48 ins; 0 del; 11 mod 8356411: Comment tree not reporting correct position for label Reviewed-by: liach ------------- PR: https://git.openjdk.org/jdk/pull/26842
