RFR: 8345777: Improve sections for inherited members [v2]
Hannes Wallnöfer
hannesw at openjdk.org
Mon Dec 9 18:12:15 UTC 2024
> 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.
-------------
Changes:
- all: https://git.openjdk.org/jdk/pull/22651/files
- new: https://git.openjdk.org/jdk/pull/22651/files/10814b6d..f455d7c6
Webrevs:
- full: https://webrevs.openjdk.org/?repo=jdk&pr=22651&range=01
- incr: https://webrevs.openjdk.org/?repo=jdk&pr=22651&range=00-01
Stats: 2 lines in 2 files changed: 0 ins; 0 del; 2 mod
Patch: https://git.openjdk.org/jdk/pull/22651.diff
Fetch: git fetch https://git.openjdk.org/jdk.git pull/22651/head:pull/22651
PR: https://git.openjdk.org/jdk/pull/22651
More information about the javadoc-dev
mailing list