RFR: 8323698: Class use page does not include extends/implements type arguments [v2]

Chen Liang liach at openjdk.org
Tue Jan 23 14:35:44 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 three additional commits since the last revision:

 - Improve localization
 - Merge branch 'master' of https://github.com/openjdk/jdk into feature/jd-use-super-typearg
 - Use page to check extends/implements type arguments

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/17414/files
  - new: https://git.openjdk.org/jdk/pull/17414/files/0025478b..5001306d

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=17414&range=01
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=17414&range=00-01

  Stats: 13067 lines in 419 files changed: 6124 ins; 5371 del; 1572 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