RFR: 8356632: Fix remaining {@link/@linkplain} tags with refer to private/protected types in java.base
Nizar Benalla
nbenalla at openjdk.org
Tue May 20 14:27:51 UTC 2025
On Mon, 19 May 2025 20:41:13 GMT, Joe Darcy <darcy at openjdk.org> wrote:
>> They are documented in [this page](https://download.java.net/java/early_access/jdk25/docs/api/serialized-form.html#java.lang.invoke.MethodType)
>
> Okay -- if there is some link to the private serial-related methods even in a public javadoc run, I think it would be preferable if links to those methods could be resolved by javadoc. Otherwise, if the links to private methods _from a private method_, would be valid in a private javadoc run, I thinks more refined version of warning would let those be.
>
> As it is, if the see tags are going to stay, I don't think `<code>foo</code>` markup should be used.
I will revert the changes to `MethoType.java` and try to make the links to the private methods resolvable. (In a future patch)
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/25287#discussion_r2098123931
More information about the core-libs-dev
mailing list