RFR: 8177100: APIs duplicated in JavaDoc [v4]
    Nizar Benalla 
    nbenalla at openjdk.org
       
    Mon May 12 12:57:10 UTC 2025
    
    
  
> Please review this patch to fix a bug where a method can be documented multiple times 
> Consider these 4 classes
> 
>                     A       (interface)
>                    / \
>                   /   \
> (abstract class)  C     B   ( interface)
>                   \   /
>                    \ /
>                     D       (class)
> 
> 
> Where `A` declares `testA()`, `C` implements it `public final void testA()`, `B` extends `A` but does *not* override it, `D` extends `C` and implements `B`
> 
> In the generated javadoc, `testA()` is documented twice.
> 
> 
> 
> After the patch, `testA()` is only documented once:
> 
> 
Nizar Benalla 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 seven additional commits since the last revision:
 - update javadoc
 - Merge branch 'master' into duplicate-APIs
 - new approach - make sure there is no negative effect on JDK doc output
 - revert VisibleMemberTable back to master
 - fix comment
 - simplify check
 - merge methods from invisible supetypes
-------------
Changes:
  - all: https://git.openjdk.org/jdk/pull/25123/files
  - new: https://git.openjdk.org/jdk/pull/25123/files/8d300463..c7b62698
Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=25123&range=03
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=25123&range=02-03
  Stats: 7613 lines in 417 files changed: 4786 ins; 1488 del; 1339 mod
  Patch: https://git.openjdk.org/jdk/pull/25123.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/25123/head:pull/25123
PR: https://git.openjdk.org/jdk/pull/25123
    
    
More information about the javadoc-dev
mailing list