On Mon, 11 Jul 2022 15:01:42 GMT, Jonathan Gibbons <[email protected]> wrote:

> 
> That's not the right question. The question is, how can we best replace the 
> functionality of those tests. It's the relative link that's important, not 
> the location. Since the comment containing the relative link can no longer be 
> placed on a top level declaration, they should be moved to a declaration 
> where they are legal, such as on a method.

Hm... While I understand what you are saying, I also think that we already have 
tests that exercise relative links on methods. Those tests are located in that 
same directory, no? Here, 
test/langtools/jdk/javadoc/doclet/testRelativeLinks/pkg/C.java:


public class C {

    /**
     * Here is a relative link in a field:\u0130
     * <a href="relative-field-link.html">relative field link</a>.
     */
    public C field = null;

    /**
     * Here are two relative links in a method:
     * <a href="relative-method-link.html">relative method link</a>,
     * <a href="#method-fragment">fragment method link</a>.
     */
    public C method() { return null;}

    /**
     * Here is a relative link in a method:
     * <a
     * href="relative-multi-line-link.html">relative-multi-line-link</a>.
     *
     * <a id="method-fragment">Method fragment</a>.
     */
    public C multipleLineTest() { return null;}

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

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

Reply via email to