Clarify that socketTimeoutMS affects only reads (#975)

JAVA-4664

Author: stIncMale

driver-core/src/main/com/mongodb/ConnectionString.java

@@ -18,6 +18,7 @@
 
 import com.mongodb.connection.ClusterSettings;
 import com.mongodb.connection.ConnectionPoolSettings;
+import com.mongodb.connection.SocketSettings;
 import com.mongodb.diagnostics.logging.Logger;
 import com.mongodb.diagnostics.logging.Loggers;
 import com.mongodb.internal.dns.DefaultDnsResolver;
@@ -121,7 +122,8 @@
  * <li>{@code tlsAllowInvalidHostnames=true|false}: Whether to allow invalid host names for TLS connections. Supersedes the
  * sslInvalidHostNameAllowed option</li>
  * <li>{@code connectTimeoutMS=ms}: How long a connection can take to be opened before timing out.</li>
- * <li>{@code socketTimeoutMS=ms}: How long a send or receive on a socket can take before timing out.</li>
+ * <li>{@code socketTimeoutMS=ms}: How long a receive on a socket can take before timing out.
+ * This option is the same as {@link SocketSettings#getReadTimeout(TimeUnit)}.</li>
  * <li>{@code maxIdleTimeMS=ms}: Maximum idle time of a pooled connection. A connection that exceeds this limit will be closed</li>
  * <li>{@code maxLifeTimeMS=ms}: Maximum life time of a pooled connection. A connection that exceeds this limit will be closed</li>
  * </ul>

driver-legacy/src/main/com/mongodb/MongoClientOptions.java

@@ -281,7 +281,7 @@ public int getConnectTimeout() {
     }
 
     /**
-     * <p>The socket timeout in milliseconds. It is used for I/O socket read and write operations {@link
+     * <p>The socket timeout in milliseconds. It is used for I/O socket read operations {@link
      * java.net.Socket#setSoTimeout(int)}</p>
      *
      * <p>Default is 0 and means no timeout.</p>

driver-legacy/src/main/com/mongodb/MongoClientURI.java

@@ -100,7 +100,8 @@
  * <li>{@code tlsAllowInvalidHostnames=true|false}: Whether to allow invalid host names for TLS connections. Supersedes the
  * sslInvalidHostNameAllowed option</li>
  * <li>{@code connectTimeoutMS=ms}: How long a connection can take to be opened before timing out.</li>
- * <li>{@code socketTimeoutMS=ms}: How long a send or receive on a socket can take before timing out.</li>
+ * <li>{@code socketTimeoutMS=ms}: How long a receive on a socket can take before timing out.
+ * This option is the same as {@link MongoClientOptions#getSocketTimeout()}.</li>
  * <li>{@code maxIdleTimeMS=ms}: Maximum idle time of a pooled connection. A connection that exceeds this limit will be closed</li>
  * <li>{@code maxLifeTimeMS=ms}: Maximum life time of a pooled connection. A connection that exceeds this limit will be closed</li>
  * </ul>