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

Chen Liang liach at openjdk.org
Thu Feb 22 04:53:20 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 eight additional commits since the last revision:

 - 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
 - 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/384a8ea0..bdd03743

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

  Stats: 43964 lines in 1372 files changed: 21530 ins; 14004 del; 8430 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