On Mon, 9 Dec 2024 18:12:15 GMT, Hannes Wallnöfer <hann...@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
