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

Brian Burkhalter brian.burkhalter at oracle.com
Thu Mar 19 14:30:05 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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.openjdk.java.net/pipermail/net-dev/attachments/20150319/2f983d06/attachment.html>


More information about the net-dev mailing list