On Tue, 17 Jun 2025 08:40:10 GMT, Jaikiran Pai <j...@openjdk.org> wrote:
>> Can I please get a review of this doc-only change which proposes to add a >> `@apiNote` to the `Socket.connect(SocketAddress endpoint, int timeout)` >> method? This addresses https://bugs.openjdk.org/browse/JDK-7116990. >> >> As noted in that issue, users can find it surprising that when the >> `Socket.connect(...)` method is called with a `timeout` value, then if that >> timeout value happens to be greater than the connect timeout that operating >> systems typically impose, then a `IOException` gets thrown instead of the >> `SocketTimeoutException`. The change in this PR proposes to add a `@apiNote` >> which explains this current behaviour. >> >> If this requires a CSR, I'll open one once we settle on the proposed text. > > Jaikiran Pai has updated the pull request incrementally with one additional > commit since the last revision: > > Alan's suggestion Marked as reviewed by alanb (Reviewer). ------------- PR Review: https://git.openjdk.org/jdk/pull/25690#pullrequestreview-2935117330