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

[Joe Darcy]

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?
> 
> 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.

Looping back on this, independent of what the intended or specified behavior was before, if the behavior is changing now, even in agreed upon ways, the change should probably go through CSR review.

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

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