On Wed, 5 Aug 2026 07:17:16 GMT, Volkan Yazici <[email protected]> wrote:
>> src/java.net.http/share/classes/java/net/http/HttpResponse.java line 167:
>>
>>> 165: * @apiNote
>>> 166: *
>>> 167: * Exactly when {@code null} can be returned is implementation
>>> dependent. It
>>
>> I think you should add something like `The body may be {@code null}.` in the
>> first paragraph instead of as part of the notes.
>
> `@apiNote` was suggested by @dfuch, see [JDK-8328894]. I will wait for him to
> comment on this.
>
> [JDK-8328894]: https://bugs.openjdk.org/browse/JDK-8328894
FYI if you are sticking with notes only, you don't need a CSR. Only API/impl
spec changes require a CSR.
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/32196#discussion_r3720307830