A DESCRIPTION OF THE PROBLEM :
Link to the "receive" method was not parsed by javadoc.
The same bug exists in 1.4.2 documentation

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
correct receive link
ACTUAL -
public void close()
...
Any thread currently blocked in {#link receive} upon this socket will throw a SocketException.

URL OF FAULTY DOCUMENTATION :
http://java.sun.com/j2se/1.4.2/docs/api/java/net/DatagramSocket.html#close()