RFR: 8216497: javadoc should auto-link to platform classes [v2]

Hannes Wallnöfer hannesw at openjdk.java.net
Wed Sep 23 11:06:50 UTC 2020


On Tue, 22 Sep 2020 17:30:19 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> Hannes Wallnöfer has updated the pull request incrementally with three additional commits since the last revision:
>> 
>>  - Merge pull request #1 from lahodaj/JDK-8216497
>>    
>>    Automatically generate the elements-list data from the ct.sym for releases 11+, including the current release under
>>    development
>>  - Generating current release list for javadoc; using hardcoded lists for versions < 11
>>  - Attempting to (mostly) generate the javadoc release manifests from ct.sym historical data.
>
> test/langtools/jdk/javadoc/doclet/testAnnotationTypes/TestAnnotationTypes.java line 49:
> 
>> 47:         javadoc("-d", "out-1",
>> 48:                 "-sourcepath", testSrc,
>> 49:                 "--no-platform-link",
> 
> I see lots of instances of `no-platform-link` in this and subsequent tests. `JavadocTester` does have the concept of
> default options, although that may be more for the behavior after executing javadoc and not for the options given to
> javadoc itself. Is it worth supporting default javadoc options, since that the default can be disabled for specific
> tests?

I can't really find how `JavadocTester` uses or supports default options. My concern with this would be that it would
make JavadocTester less transparent and intuitive to use, as you'd have to be aware what the default options are.

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

PR: https://git.openjdk.java.net/jdk/pull/171


More information about the core-libs-dev mailing list