RFR: 8323698: Class use page does not include extends/implements type arguments [v7]
Chen Liang
liach at openjdk.org
Fri Feb 23 05:44:08 UTC 2024
> Currently in the javadoc tool, the generated class use page does not track the occurrences of a class in the type arguments of the extends or implements list, where they can appear. (See more details on the JBS issue) For example:
>
> public class One {}
>
>
> import java.util.*;
> public class Two extends ArrayList<One> implements Comparator<One> {
> }
>
>
> This patch proposes to add new 2 usage categories, "Classes that extend types with arguments of type" and "Classes that implement types with arguments of type" to describe the missing usage scenarios.
>
> A preview of the new use page with the 2 new categories, generated based on the example above, can be found here: https://cr.openjdk.org/~liach/8323698-javadocuse/doc/class-use/One.html
Chen Liang has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains 11 additional commits since the last revision:
- Merge branch 'master' of https://github.com/openjdk/jdk into feature/jd-use-super-typearg
- Improve documentation
- Apply suggestions from code review
Co-authored-by: Pavel Rappo <32523691+pavelrappo at users.noreply.github.com>
- Distinguish subinterfaces, use clearer terms
- Merge branch 'master' of https://github.com/openjdk/jdk into feature/jd-use-super-typearg
- Review changes
- Merge branch 'master' of https://github.com/openjdk/jdk into feature/jd-use-super-typearg
- Fix tests
- Improve localization
- Merge branch 'master' of https://github.com/openjdk/jdk into feature/jd-use-super-typearg
- ... and 1 more: https://git.openjdk.org/jdk/compare/ae586ba9...98587bc6
-------------
Changes:
- all: https://git.openjdk.org/jdk/pull/17414/files
- new: https://git.openjdk.org/jdk/pull/17414/files/e18aec67..98587bc6
Webrevs:
- full: https://webrevs.openjdk.org/?repo=jdk&pr=17414&range=06
- incr: https://webrevs.openjdk.org/?repo=jdk&pr=17414&range=05-06
Stats: 4170 lines in 42 files changed: 3340 ins; 406 del; 424 mod
Patch: https://git.openjdk.org/jdk/pull/17414.diff
Fetch: git fetch https://git.openjdk.org/jdk.git pull/17414/head:pull/17414
PR: https://git.openjdk.org/jdk/pull/17414
More information about the javadoc-dev
mailing list