update javadoc

Author: mutianf

gax-java/gax/src/main/java/com/google/api/gax/retrying/RetrySettings.java

@@ -158,6 +158,10 @@ public abstract class RetrySettings implements Serializable {
    * Duration.ZERO} allows the RPC to continue indefinitely (until it hits a Connect Timeout or the
    * connection has been terminated).
    *
+   * <p>{@link #getTotalTimeout()} caps how long the logic should keep trying the RPC until it gives
+   * up completely. If {@link #getTotalTimeout()} is set, initialRpcTimeout should be <=
+   * totalTimeout.
+   *
    * <p>If there are no configurations, Retries have the default initial RPC timeout value of {@code
    * Duration.ZERO}. LRO polling does not use the Initial RPC Timeout value.
    */
@@ -283,8 +287,9 @@ public abstract static class Builder {
      * Duration.ZERO} allows the RPC to continue indefinitely (until it hits a Connect Timeout or
      * the connection has been terminated).
      *
-     * <p>If totalTimeout is set, initialRpcTimeout should be <= totalTimeout which caps how long
-     * the logic should keep trying until give up completely.
+     * <p>{@link #getTotalTimeout()} caps how long the logic should keep trying the RPC until it
+     * gives up completely. If {@link #getTotalTimeout()} is set, initialRpcTimeout should be <=
+     * totalTimeout.
      *
      * <p>If there are no configurations, Retries have the default initial RPC timeout value of
      * {@code Duration.ZERO}. LRO polling does not use the Initial RPC Timeout value.
@@ -385,8 +390,9 @@ public abstract static class Builder {
      * Duration.ZERO} allows the RPC to continue indefinitely (until it hits a Connect Timeout or
      * the connection has been terminated).
      *
-     * <p>If totalTimeout is set, initialRpcTimeout should be <= totalTimeout which caps how long
-     * the logic should keep trying until give up completely.
+     * <p>{@link #getTotalTimeout()} caps how long the logic should keep trying the RPC until it
+     * gives up completely. If {@link #getTotalTimeout()} is set, initialRpcTimeout should be <=
+     * totalTimeout.
      *
      * <p>If there are no configurations, Retries have the default initial RPC timeout value of
      * {@code Duration.ZERO}. LRO polling does not use the Initial RPC Timeout value.