Minor javadoc improvements

Author: jhalterman

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

@@ -34,8 +34,8 @@
  * Failsafe#with(Policy[])}.
  * <p>
  * Async executions are run by default on the {@link ForkJoinPool#commonPool()}. Alternative executors can be configured
- * via {@link #with(ScheduledExecutorService)} and similar methods. All async executions are cancellable via the
- * returned CompletableFuture, even those run by a {@link ForkJoinPool} or {@link CompletionStage}.
+ * via {@link #with(ScheduledExecutorService)} and similar methods. All async executions are cancellable and
+ * interruptable via the returned CompletableFuture, even those run by a {@link ForkJoinPool} or {@link CompletionStage}.
  *
  * @param <R> result type
  * @author Jonathan Halterman

src/test/java/net/jodah/failsafe/Testing.java

@@ -85,12 +85,18 @@ public static <T extends CircuitState> T stateFor(CircuitBreaker breaker) {
     }
   }
 
+  /**
+   * Returns a future that is completed with the {@code result} on the {@code executor}.
+   */
   public static CompletableFuture<Object> futureResult(ScheduledExecutorService executor, Object result) {
     CompletableFuture<Object> future = new CompletableFuture<>();
     executor.schedule(() -> future.complete(result), 0, TimeUnit.MILLISECONDS);
     return future;
   }
 
+  /**
+   * Returns a future that is completed with the {@code exception} on the {@code executor}.
+   */
   public static CompletableFuture<Object> futureException(ScheduledExecutorService executor, Exception exception) {
     CompletableFuture<Object> future = new CompletableFuture<>();
     executor.schedule(() -> future.completeExceptionally(exception), 0, TimeUnit.MILLISECONDS);