Integrated: 8177100: APIs duplicated in JavaDoc

Nizar Benalla nbenalla at openjdk.org
Fri Jul 4 15:12:49 UTC 2025


On Thu, 8 May 2025 14:53:41 GMT, Nizar Benalla <nbenalla at openjdk.org> wrote:

> 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.
> 
> ![Screenshot 2025-05-08 at 15 51 19](https://github.com/user-attachments/assets/46538e61-1546-4128-8041-296d8491406f)
> 
> After the patch, `testA()` is only documented once:
> 
> ![Screenshot 2025-05-08 at 15 52 16](https://github.com/user-attachments/assets/a6b86a21-7104-460c-8f3f-36cee5962eed)

This pull request has now been integrated.

Changeset: f2d2eef9
Author:    Nizar Benalla <nbenalla at openjdk.org>
URL:       https://git.openjdk.org/jdk/commit/f2d2eef988c57cc9f6194a8fd5b2b422035ee68f
Stats:     234 lines in 2 files changed: 220 ins; 6 del; 8 mod

8177100: APIs duplicated in JavaDoc

Reviewed-by: liach, hannesw

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

PR: https://git.openjdk.org/jdk/pull/25123


More information about the javadoc-dev mailing list