---

mziccard · mziccard · commit 411ec3c8002b · 2015-10-12T19:22:26.000+02:00
yaml --- r: 6267 b: refs/heads/tswast-patch-1 c: 75f1c09 h: refs/heads/master i: 6265: d8a4514 6263: 26d7cee
diff --git a/[refs] b/[refs]
@@ -57,5 +57,5 @@ refs/tags/v0.18.0: 9d193c4c4b9d1c6f21515dd8e50836b9194ec9bb
 refs/tags/v0.19.0: e67b56e4d8dad5f9a7b38c9b2107c23c828f2ed5
 refs/tags/v0.20.0: 839f7fb7156535146aa1cb2c5aadd8d375d854e8
 refs/tags/v0.20.1: 370471f437f1f4f68a11e068df5cd6bf39edb1fa
-refs/heads/tswast-patch-1: 2ffd822500842b7345498b8f84501dd60105ca14
+refs/heads/tswast-patch-1: 75f1c09c1f8769df651e7c86bdeb1320a3d5f8fd
 refs/heads/pubsub-streaming-pull: 19262b752ee874eb2ca3b950eb2aef44d5a5267b
diff --git a/branches/tswast-patch-1/gcloud-java-core/src/main/java/com/google/gcloud/RetryParams.java b/branches/tswast-patch-1/gcloud-java-core/src/main/java/com/google/gcloud/RetryParams.java
@@ -66,7 +66,6 @@ public final class RetryParams implements Serializable {
   private static final RetryParams NO_RETRIES =
       builder().retryMaxAttempts(1).retryMinAttempts(1).build();
 
-
   /**
    * RetryParams builder.
    */
@@ -206,47 +205,53 @@ public static RetryParams getDefaultInstance() {
     return DEFAULT_INSTANCE;
   }
 
+  /**
+   * Returns an instance of {@code RetryParams} where `retryMaxAttempts` and `retryMinAttempts` are
+   * set to `1`.
+   */
   public static RetryParams noRetries() {
     return NO_RETRIES;
   }
 
   /**
-   * Returns the retryMinAttempts.
+   * Returns the retryMinAttempts. Default value is {@value #DEFAULT_RETRY_MIN_ATTEMPTS}.
    */
   public int getRetryMinAttempts() {
     return retryMinAttempts;
   }
 
   /**
-   * Returns the retryMaxAttempts.
+   * Returns the retryMaxAttempts. Default value is {@value #DEFAULT_RETRY_MAX_ATTEMPTS}.
    */
   public int getRetryMaxAttempts() {
     return retryMaxAttempts;
   }
 
   /**
-   * Returns the initialRetryDelayMillis.
+   * Returns the initialRetryDelayMillis. Default value is
+   * {@value #DEFAULT_INITIAL_RETRY_DELAY_MILLIS}.
    */
   public long getInitialRetryDelayMillis() {
     return initialRetryDelayMillis;
   }
 
   /**
-   * Returns the maxRetryDelayMillis.
+   * Returns the maxRetryDelayMillis. Default values is {@value #DEFAULT_MAX_RETRY_DELAY_MILLIS}.
    */
   public long getMaxRetryDelayMillis() {
     return maxRetryDelayMillis;
   }
 
   /**
-   * Returns the maxRetryDelayBackoffFactor.
+   * Returns the maxRetryDelayBackoffFactor. Default values is
+   * {@value #DEFAULT_RETRY_DELAY_BACKOFF_FACTOR}.
    */
   public double getRetryDelayBackoffFactor() {
     return retryDelayBackoffFactor;
   }
 
   /**
-   * Returns the totalRetryPeriodMillis.
+   * Returns the totalRetryPeriodMillis. Default value is {@value #DEFAULT_TOTAL_RETRY_PERIOD_MILLIS}.
    */
   public long getTotalRetryPeriodMillis() {
     return totalRetryPeriodMillis;
diff --git a/branches/tswast-patch-1/gcloud-java-core/src/main/java/com/google/gcloud/ServiceOptions.java b/branches/tswast-patch-1/gcloud-java-core/src/main/java/com/google/gcloud/ServiceOptions.java
@@ -16,7 +16,6 @@
 
 package com.google.gcloud;
 
-
 import static com.google.common.base.MoreObjects.firstNonNull;
 import static com.google.common.base.Preconditions.checkNotNull;
 import static java.nio.charset.StandardCharsets.UTF_8;
@@ -167,7 +166,8 @@ public B authCredentials(AuthCredentials authCredentials) {
     }
 
     /**
-     * Sets configuration parameters for request retries.
+     * Sets configuration parameters for request retries. If no configuration is set
+     * {@link RetryParams#noRetries()} is used.
      *
      * @return the builder.
      */
@@ -367,7 +367,8 @@ public AuthCredentials authCredentials() {
   }
 
   /**
-   * Returns configuration parameters for request retries.
+   * Returns configuration parameters for request retries. By default requests are not retried:
+   * {@link RetryParams#noRetries()} is used.
    */
   public RetryParams retryParams() {
     return retryParams != null ? retryParams : RetryParams.noRetries();
