The javadoc for the connect() method in java.net.Socket
says:

    /**
     * Connects this socket to the server with a specified timeout value.
     * A timeout value of zero means no timeout. The connection will then
     * block until established or an error occurs.
     ...
     */


This is potentially confusing. Instead, we should document this
with wording similar to the javadoc for setSoTimeout() which says:

    * A timeout of zero is interpreted as an infinite timeout.

The same issue exists in java.net.SocketImpl for it's connect()
method.