> 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]>

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/26842/files
  - new: https://git.openjdk.org/jdk/pull/26842/files/f0788bd1..dddfdc05

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=26842&range=01
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=26842&range=00-01

  Stats: 1 line in 1 file changed: 0 ins; 0 del; 1 mod
  Patch: https://git.openjdk.org/jdk/pull/26842.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/26842/head:pull/26842

PR: https://git.openjdk.org/jdk/pull/26842

Reply via email to