RFR: 8345777: Improve sections for inherited members [v2]

[Pavel Rappo]

On Mon, 9 Dec 2024 18:12:15 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

>> Please review a set of changes to make the sections for inherited members in API docs more usable. 
>> 
>>  - Link to the relevant member summary in the parent type instead of the top of the page in headings for inherited members
>>  - Omit parent type's package name in headings for inherited members
>>  - Add method signature as title attribute (tooltip) in links to inherited methods
>>  - Omit type bounds and do not create separate links for type parameters in links to inherited nested classes
>> 
>> Before/after comparisons for methods and nested classes (the first two items also apply to other kinds of members):
>> 
>> java.util.TreeMap:
>> -  inherited nested classes [before][1], [after][2]
>> -  inherited methods [before][3], [after][4]
>> 
>> java.util.Spliterator.OfInt:
>>  - inherited nested classes [before][5], [after][6]
>>  - inherited  methods [before][7], [after][8]
>> 
>> [1]: https://download.java.net/java/early_access/jdk25/docs/api/java.base/java/util/TreeMap.html#nested-class-summary
>> [2]: https://cr.openjdk.org/~hannesw/8345777/api.00/java.base/java/util/TreeMap.html#nested-class-summary
>> 
>> [3]: https://download.java.net/java/early_access/jdk25/docs/api/java.base/java/util/TreeMap.html#methods-inherited-from-class-java.util.AbstractMap
>> [4]: https://cr.openjdk.org/~hannesw/8345777/api.00/java.base/java/util/TreeMap.html#methods-inherited-from-class-java.util.AbstractMap
>> 
>> [5]: https://download.java.net/java/early_access/jdk25/docs/api/java.base/java/util/Spliterator.OfInt.html#nested-class-summary
>> [6]: https://cr.openjdk.org/~hannesw/8345777/api.00/java.base/java/util/Spliterator.OfInt.html#nested-class-summary
>> 
>> [7]: https://download.java.net/java/early_access/jdk25/docs/api/java.base/java/util/Spliterator.OfInt.html#methods-inherited-from-class-java.util.Spliterator
>> [8]: https://cr.openjdk.org/~hannesw/8345777/api.00/java.base/java/util/Spliterator.OfInt.html#methods-inherited-from-class-java.util.Spliterator
>
> Hannes Wallnöfer has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Render signature of inherited method in context of the local type.

I see this:

> Omit type bounds and do not create separate links for type parameters in links to inherited nested classes

But I also wonder if the below is acceptable information loss.

Before:

    Spliterator.OfPrimitive<T, T_CONS, T_SPLITR extends Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>>

After:

    Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>

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

PR Comment: https://git.openjdk.org/jdk/pull/22651#issuecomment-2538478657