RFR: JDK-8164094: javadoc allows to create a @link to a non-existent method [v2]

Hannes Wallnöfer hannesw at openjdk.org
Mon Jan 22 15:17:28 UTC 2024


On Wed, 13 Dec 2023 10:44:43 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

>> Should this issue have a CSR for the behavioral change?
>
>> Should this issue have a CSR for the behavioral change?
> 
> My understanding of the issue is that the lookup of explicit-class member references in enclosing classes was an unintended consequence of doing the same for classless references from within nested classes. So I consider this a bug fix, not a feature change (even though it unfortunately changes javadoc to become stricter in what it accepts).
> 
> Actually, the feature of extending member reference lookup to enclosing classes is not specified in the taglet spec, which only says this:
> 
>> When the reference is to a member of the same class as that containing the documentation comment, all parts of the reference up to and including the # may be omitted, although the '#' may be retained for clarity.
> 
> This could be extended to include enclosing classes, but this is existing behaviour, not changed by this issue.

> @hns would you be able to create a linked bug to track that lookup order issue?

I filed an issue for it here: https://bugs.openjdk.org/browse/JDK-8324320

Ping: since most of the discussion in this PR was off-topic, could somebody please review the actual change?

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

PR Comment: https://git.openjdk.org/jdk/pull/17069#issuecomment-1904218001


More information about the compiler-dev mailing list