[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