RFR: 8344942: Template-Based Testing Framework [v40]

[Emanuel Peter]

On Tue, 20 May 2025 08:43:13 GMT, Roberto Castañeda Lozano <rcastanedalo at openjdk.org> wrote:

>> Emanuel Peter has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Offline review
>
> test/hotspot/jtreg/compiler/lib/template_framework/Template.java line 197:
> 
>> 195:  * <p>
>> 196:  * More examples for these functionalities can be found in {@link TestTutorial}, {@link TestSimple}, and
>> 197:  * {@link TestAdvanced}.
> 
> These links cannot be resolved by `javadoc` when using the command recommended in the PR description:
> 
> $ javadoc -sourcepath test/hotspot/jtreg:./test/lib compiler.lib.template_framework
> Loading source files for package compiler.lib.template_framework...
> Constructing Javadoc information...
> Building index for all the packages and classes...
> Standard Doclet version 25-internal-2025-05-20-0715327.rocastan.open
> Building tree for all the packages and classes...
> test/hotspot/jtreg/compiler/lib/template_framework/Template.java:196: error: reference not found
>  * More examples for these functionalities can be found in {@link TestTutorial}, {@link TestSimple}, and
>                                                                   ^
> test/hotspot/jtreg/compiler/lib/template_framework/Template.java:196: error: reference not found
>  * More examples for these functionalities can be found in {@link TestTutorial}, {@link TestSimple}, and
>                                                                                         ^
> test/hotspot/jtreg/compiler/lib/template_framework/Template.java:197: error: reference not found
>  * {@link TestAdvanced}.
>           ^
> (...)

@robcasloz I saw that as well. But IDE / neovim still thinks its ok. Do you know an alternative that works for `javadoc`?

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

PR Review Comment: https://git.openjdk.org/jdk/pull/24217#discussion_r2097398947