Polish Javadoc for BackOff implementations

Author: sbrannen

spring-core/src/main/java/org/springframework/util/backoff/ExponentialBackOff.java

@@ -22,9 +22,9 @@
  * max interval}, it is no longer increased. Stops retrying once the
  * {@link #setMaxElapsedTime(long) max elapsed time} has been reached.
  *
- * <p>Example: The default interval is {@value #DEFAULT_INITIAL_INTERVAL}ms, default
- * multiplier is {@value #DEFAULT_MULTIPLIER} and the default max interval is
- * {@value #DEFAULT_MAX_INTERVAL}. For 10 attempts the sequence will be
+ * <p>Example: The default interval is {@value #DEFAULT_INITIAL_INTERVAL} ms,
+ * the default multiplier is {@value #DEFAULT_MULTIPLIER}, and the default max
+ * interval is {@value #DEFAULT_MAX_INTERVAL}. For 10 attempts the sequence will be
  * as follows:
  *
  * <pre>
@@ -42,8 +42,8 @@
  * 10             30000
  * </pre>
  *
- * Note that the default max elapsed time is {@link Long#MAX_VALUE}. Use
- * {@link #setMaxElapsedTime(long)} to limit the maximum number of time
+ * <p>Note that the default max elapsed time is {@link Long#MAX_VALUE}. Use
+ * {@link #setMaxElapsedTime(long)} to limit the maximum length of time
  * that an instance should accumulate before returning
  * {@link BackOffExecution#STOP}.
  *
@@ -93,9 +93,9 @@ public ExponentialBackOff() {
 	}
 
 	/**
-	 * Create an instance.
+	 * Create an instance with the supplied settings.
 	 * @param initialInterval the initial interval in milliseconds
-	 * @param multiplier the multiplier (should be equal or higher to 1)
+	 * @param multiplier the multiplier (should be greater than or equal to 1)
 	 */
 	public ExponentialBackOff(long initialInterval, double multiplier) {
 		checkMultiplier(multiplier);
@@ -118,15 +118,15 @@ public long getInitialInterval() {
 	}
 
 	/**
-	 * The value to multiply the current interval with for each retry attempt.
+	 * The value to multiply the current interval by for each retry attempt.
 	 */
 	public void setMultiplier(double multiplier) {
 		checkMultiplier(multiplier);
 		this.multiplier = multiplier;
 	}
 
 	/**
-	 * Return the value to multiply the current interval with for each retry attempt.
+	 * Return the value to multiply the current interval by for each retry attempt.
 	 */
 	public double getMultiplier() {
 		return multiplier;

spring-core/src/main/java/org/springframework/util/backoff/FixedBackOff.java

@@ -50,7 +50,7 @@ public FixedBackOff() {
 	/**
 	 * Create an instance.
 	 * @param interval the interval between two attempts
-	 * @param maxAttempts the maximal number of attempts
+	 * @param maxAttempts the maximum number of attempts
 	 */
 	public FixedBackOff(long interval, long maxAttempts) {
 		this.interval = interval;
@@ -72,14 +72,14 @@ public long getInterval() {
 	}
 
 	/**
-	 * Set the maximal number of attempts in milliseconds.
+	 * Set the maximum number of attempts in milliseconds.
 	 */
 	public void setMaxAttempts(long maxAttempts) {
 		this.maxAttempts = maxAttempts;
 	}
 
 	/**
-	 * Return the maximal number of attempts in milliseconds.
+	 * Return the maximum number of attempts in milliseconds.
 	 */
 	public long getMaxAttempts() {
 		return maxAttempts;