Do minor improvements to method docs in ClusterSettings (mongodb#1304)

Author: stIncMale

driver-core/src/main/com/mongodb/connection/ClusterSettings.java

@@ -151,10 +151,12 @@ public Builder srvHost(final String srvHost) {
 
  /**
  * Sets the maximum number of hosts to connect to when using SRV protocol.
+ * This setting is not used if {@link #getMode()} is {@link ClusterConnectionMode#LOAD_BALANCED}.
  *
  * @param srvMaxHosts the maximum number of hosts to connect to when using SRV protocol
  * @return this
  * @since 4.4
+ * @see #getSrvMaxHosts()
  */
  public Builder srvMaxHosts(final Integer srvMaxHosts) {
  this.srvMaxHosts = srvMaxHosts;
@@ -168,15 +170,16 @@ public Builder srvMaxHosts(final Integer srvMaxHosts) {
  * The SRV resource record (<a href="https://www.rfc-editor.org/rfc/rfc2782">RFC 2782</a>)
  * service name, which is limited to 15 characters
  * (<a href="https://www.rfc-editor.org/rfc/rfc6335#section-5.1">RFC 6335 section 5.1</a>).
- * If specified, it is combined with the single host name specified by
- * {@link #getHosts()} as follows: {@code _srvServiceName._tcp.hostName}. The combined string is an SRV resource record
+ * It is combined with the host name specified by
+ * {@link #getSrvHost()} as follows: {@code _srvServiceName._tcp.hostName}. The combined string is an SRV resource record
  * name (<a href="https://www.rfc-editor.org/rfc/rfc1035#section-2.3.1">RFC 1035 section 2.3.1</a>), which is limited to 255
  * characters (<a href="https://www.rfc-editor.org/rfc/rfc1035#section-2.3.4">RFC 1035 section 2.3.4</a>).
  * </p>
  *
  * @param srvServiceName the SRV service name
  * @return this
  * @since 4.5
+ * @see #getSrvServiceName()
  */
  public Builder srvServiceName(final String srvServiceName) {
  this.srvServiceName = notNull("srvServiceName", srvServiceName);
@@ -219,6 +222,7 @@ public Builder mode(final ClusterConnectionMode mode) {
 
  /**
  * Sets the required replica set name for the cluster.
+ * This setting is not used if {@link #getMode()} is {@link ClusterConnectionMode#LOAD_BALANCED}.
  *
  * @param requiredReplicaSetName the required replica set name.
  * @return this
@@ -231,9 +235,11 @@ public Builder requiredReplicaSetName(@Nullable final String requiredReplicaSetN
 
  /**
  * Sets the required cluster type for the cluster.
+ * This setting is not used if {@link #getMode()} is {@link ClusterConnectionMode#LOAD_BALANCED}.
  *
  * @param requiredClusterType the required cluster type
  * @return this
+ * @see #getRequiredClusterType()
  */
  public Builder requiredClusterType(final ClusterType requiredClusterType) {
  this.requiredClusterType = notNull("requiredClusterType", requiredClusterType);
@@ -384,9 +390,11 @@ public String getSrvHost() {
 
  /**
  * Gets the maximum number of hosts to connect to when using SRV protocol.
+ * This setting is not used if {@link #getMode()} is {@link ClusterConnectionMode#LOAD_BALANCED}.
  *
  * @return the maximum number of hosts to connect to when using SRV protocol. Defaults to null.
  * @since 4.4
+ * @see Builder#srvMaxHosts(Integer)
  */
  @Nullable
  public Integer getSrvMaxHosts() {
@@ -400,14 +408,15 @@ public Integer getSrvMaxHosts() {
  * The SRV resource record (<a href="https://www.rfc-editor.org/rfc/rfc2782">RFC 2782</a>)
  * service name, which is limited to 15 characters
  * (<a href="https://www.rfc-editor.org/rfc/rfc6335#section-5.1">RFC 6335 section 5.1</a>).
- * If specified, it is combined with the single host name specified by
- * {@link #getHosts()} as follows: {@code _srvServiceName._tcp.hostName}. The combined string is an SRV resource record
+ * It is combined with the host name specified by
+ * {@link #getSrvHost()} as follows: {@code _srvServiceName._tcp.hostName}. The combined string is an SRV resource record
  * name (<a href="https://www.rfc-editor.org/rfc/rfc1035#section-2.3.1">RFC 1035 section 2.3.1</a>), which is limited to 255
  * characters (<a href="https://www.rfc-editor.org/rfc/rfc1035#section-2.3.4">RFC 1035 section 2.3.4</a>).
  * </p>
  *
  * @return the SRV service name, which defaults to {@code "mongodb"}
  * @since 4.5
+ * @see Builder#srvServiceName(String)
  */
  public String getSrvServiceName() {
  return srvServiceName;
@@ -433,15 +442,18 @@ public ClusterConnectionMode getMode() {
 
  /**
  * Gets the required cluster type
+ * This setting is not used if {@link #getMode()} is {@link ClusterConnectionMode#LOAD_BALANCED}.
  *
  * @return the required cluster type
+ * @see Builder#requiredClusterType(ClusterType)
  */
  public ClusterType getRequiredClusterType() {
  return requiredClusterType;
  }
 
  /**
  * Gets the required replica set name.
+ * This setting is not used if {@link #getMode()} is {@link ClusterConnectionMode#LOAD_BALANCED}.
  *
  * @return the required replica set name
  * @see Builder#requiredReplicaSetName(String)