On Tue, 19 Aug 2025 14:46:22 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. > > Hannes Wallnöfer has updated the pull request incrementally with one > additional commit since the last revision: > > Remove duplicate whitespace > > Co-authored-by: Andrey Turbanov <[email protected]> Looks good. ------------- Marked as reviewed by liach (Reviewer). PR Review: https://git.openjdk.org/jdk/pull/26842#pullrequestreview-3132937808
