[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