RFR: 8209992: Align SSLSocket and SSLEngine Javadocs [v3]

[Artur Barashev]

On Fri, 1 Aug 2025 00:39:32 GMT, Bradford Wetmore <wetmore at openjdk.org> wrote:

>> Artur Barashev has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Address Brad's code review
>
> src/java.base/share/classes/javax/net/ssl/SSLEngine.java line 1101:
> 
>> 1099:      * dependent. For example, in TLSv1.3 calling this method after the
>> 1100:      * connection has been established will force a key update. For prior TLS
>> 1101:      * versions it will force a renegotiation (re-handshake).
> 
> You should delete 1115-1116, as it's duplicating what you have here.

Good catch, done!

> src/java.base/share/classes/javax/net/ssl/SSLSocket.java line 520:
> 
>> 518:      * to flow during this handshake.  When the handshake completes, this
>> 519:      * will be signaled with an event.
>> 520:      * <P>
> 
> On line 524, put inside a {@code IOException}

Done, thanks!

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

PR Review Comment: https://git.openjdk.org/jdk/pull/26484#discussion_r2248230395
PR Review Comment: https://git.openjdk.org/jdk/pull/26484#discussion_r2248233328