RFR: 8356632: Fix remaining {@link/@linkplain} tags with refer to private/protected types in java.base
Alan Bateman
alanb at openjdk.org
Tue May 20 06:50:51 UTC 2025
On Sat, 17 May 2025 19:42:39 GMT, Nizar Benalla <nbenalla at openjdk.org> wrote:
> Please review this patch to fix some `javadoc` bugs in `java.base`.
> Certain `@link` tags used to refer to private fields instead of public APIs.
>
> A couple of `@see` tags in the [serialization page](https://download.java.net/java/early_access/jdk25/docs/api/serialized-form.html#java.lang.invoke.MethodType) referred to private methods, I updated the javadoc in a way to not change the way it is displayed to users but also remove `@link` tags to non-included types.
>
> TIA
src/java.base/share/classes/java/util/concurrent/ForkJoinTask.java line 138:
> 136: * {@link #isCompletedAbnormally} is true if a task was either
> 137: * cancelled or encountered an exception, in which case {@link
> 138: * #getException()} will return either the encountered exception or
Looks right too, the private overload of getException was added in JDK 22.
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/25287#discussion_r2097113958
More information about the core-libs-dev
mailing list