The java.net.SocketOptions is a legacy interface with constants for java.net.SocketImpl implementations. The newer class java.net.StandardSocketOptions is meant to be used by application developers.

The current javadoc on some of the legacy java.net.SocketOptions interface's field isn't accurate. For example java.net.SocketOptions.SO_REUSEADDR currently says:

> ... This is used only for MulticastSockets in java, and it is set by default for MulticastSockets.
> Valid for: DatagramSocketImpl

This isn't true.

The javadoc on each of these fields should be cleaned up to instead point to the corresponding field in java.net.StandardSocketOptions.