[jdk19] RFR: 8281969: Bad result for javadoc snippet (//@link) tag for White space substring/regex. [v2]

Pavel Rappo prappo at openjdk.org
Thu Jul 14 19:09:49 UTC 2022


> This PR fixes how links inside a snippet treat whitespace.
> 
> During the development of the "Snippets" feature, the concern was about presentation of links that contain leading or trailing whitespace. For that reason, any such whitespace was trimmed. I think it's now reasonable to simplify code and say that any such presentation concerns should be solved with presentation tools, such as CSS.

Pavel Rappo has updated the pull request incrementally with one additional commit since the last revision:

  refactor: improve test infrastructure
  
  Clarifies comment. In particular, the fact that the linking mechanism is
  shared between the @link standard doclet tag and the similarly named
  snippet markup tag is not specified. It's the Programmer's Guide that
  mentions such sharing:
  
    https://docs.oracle.com/en/java/javase/18/code-snippet/index.html
  
  But that guide is not a specification.

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

Changes:
  - all: https://git.openjdk.org/jdk19/pull/142/files
  - new: https://git.openjdk.org/jdk19/pull/142/files/b7d0ab03..f7b0cd0f

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

  Stats: 14 lines in 1 file changed: 3 ins; 1 del; 10 mod
  Patch: https://git.openjdk.org/jdk19/pull/142.diff
  Fetch: git fetch https://git.openjdk.org/jdk19 pull/142/head:pull/142

PR: https://git.openjdk.org/jdk19/pull/142


More information about the javadoc-dev mailing list