RFR: JDK-8285939: javadoc java.lang.Record should not have "Direct Known Subclasses:" section [v3]

[Jonathan Gibbons]

On Mon, 30 May 2022 14:06:54 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

>> Jonathan Gibbons has updated the pull request with a new target base due to a merge or a rebase. The pull request now contains five commits:
>> 
>>  - Merge remote-tracking branch 'upstream/master' into 8285939.record-subtypes
>>  - address review comments: add doc comments to new methods
>>  - merge with upstream master
>>  - fix copyright; update test description
>>  - JDK-8285939: javadoc java.lang.Record should not have "Direct Known Subclasses:" section
>
> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/util/ClassTree.java line 128:
> 
>> 126:     /**
>> 127:      * A map giving the subtypes for each of a collection of type elements.
>> 128:      * The subtypes may be subclasses or subinterfaces, depending on the context.
> 
> For a separate PR: we should consider dropping hyphens from "super-" and "sub-" in words that relate to classes, interfaces, types, and packages.

[JDK-8287606](https://bugs.openjdk.java.net/browse/JDK-8287606)

> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/util/ClassTree.java line 228:
> 
>> 226: 
>> 227:     /**
>> 228:      * Generate the hierarchies for the given set of type elements.
> 
> Suggestion:
> 
>      * Generate the hierarchies for the given type elements.

Done

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

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