Minor Javadoc fixes

Author: jhalterman

src/main/java/net/jodah/failsafe/Failsafe.java

@@ -36,7 +36,8 @@ public class Failsafe {
    *   Failsafe.with(fallback, retryPolicy, circuitBreaker).get(supplier);
    * </pre>
    * </p>
-   * This results in the following internal composition when executing the {@code supplier} and handling its result:
+   * This results in the following internal composition when executing a {@code runnable} or {@code supplier} and
+   * handling its result:
    * <p>
    * <pre>
    *   Fallback(RetryPolicy(CircuitBreaker(Supplier)))
@@ -65,10 +66,11 @@ public static <R, P extends Policy<R>> FailsafeExecutor<R> with(P outerPolicy, P
    * the last policy being applied first. For example, consider:
    * <p>
    * <pre>
-   *   Failsafe.with(fallback, retryPolicy, circuitBreaker).get(supplier);
+   *   Failsafe.with(Arrays.asList(fallback, retryPolicy, circuitBreaker)).get(supplier);
    * </pre>
    * </p>
-   * This results in the following internal composition when executing the {@code supplier} and handling its result:
+   * This results in the following internal composition when executing a {@code runnable} or {@code supplier} and
+   * handling its result:
    * <p>
    * <pre>
    *   Fallback(RetryPolicy(CircuitBreaker(Supplier)))

src/main/java/net/jodah/failsafe/FailurePolicy.java

@@ -27,7 +27,8 @@
 /**
  * A Policy that captures conditions to determine whether an execution is a failure.
  * <p>
- * If no handlers are configured, the execution is considered a failure if an Exception was thrown.
+ * By default, if no handlers are configured, the execution is considered a failure if an Exception was thrown. If
+ * multuple handlers are configured, they are logically OR'ed.
  * </p>
  *
  * @param <S> self type