[9] RFR of 8074937: ServerSocket.accept() API Descriptions should include past tense

Brian Burkhalter brian.burkhalter at oracle.com
Wed Mar 18 22:16:27 UTC 2015


Please review at your convenience. This a doc-only change.

Issue:	https://bugs.openjdk.java.net/browse/JDK-8074937
Patch:	http://cr.openjdk.java.net/~bpb/8074937/webrev.00/

This is in effect an amplification of extant javadoc suggested as an enhancement by an external user. I performed some testing to verify the accuracy of the suggested documentation change prior to crafting the verbiage, and the criticism does seem to be well-founded in the behavior of the APIs in question.

It would be good however if someone with a more profound knowledge of this area were to review the proposed documentation update for accuracy, especially as it is not unlikely that there might be platform-specific behavior with which these statements conflict.

Thanks,

Brian


More information about the core-libs-dev mailing list