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