RFR: 8228773: URLClassLoader constructors should include API note warning that the parent should not be null [v3]

[Jaikiran Pai]

On Thu, 29 May 2025 14:01:16 GMT, Jaikiran Pai <jpai at openjdk.org> wrote:

>>> Should we add a link to {@linkplain ClassLoader##builtinLoaders ...} somewhere in this API note?
>> 
>> I think we can add that as a link for "bootstrap class loader". Something like:
>> 
>> 
>>  * @apiNote If the {@code parent} is specified as {@code null} (for the
>>  * {@linkplain ClassLoader##builtinLoaders bootstrap class loader}) then
>>  * there is no guarantee that all platform classes are visible.
>> 
>> 
>> Should we use this?
>
>> Should we use this?
> 
> I missed Alan's suggestion to add a separate sentence linking to the ClassLoader section. I will update this PR accordingly.

> something like "See Run-time Built-in Class Loaders for information on the system class loader other and the other built-in class loaders". I think that might work.

Done. Updated the PR with this text.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/25517#discussion_r2114072976