Merge "Updated onStartWork Javadoc to reflect user cancellation of future." into androidx-master-dev
diff --git a/work/workmanager/src/main/java/androidx/work/ListenableWorker.java b/work/workmanager/src/main/java/androidx/work/ListenableWorker.java
index e8ef01b..b96c596 100644
--- a/work/workmanager/src/main/java/androidx/work/ListenableWorker.java
+++ b/work/workmanager/src/main/java/androidx/work/ListenableWorker.java
@@ -177,7 +177,8 @@
      * Override this method to start your actual background processing. This method is called on
      * the main thread.
      *
-     * @return A {@link ListenableFuture} with the {@link Payload} of the computation
+     * @return A {@link ListenableFuture} with the {@link Payload} of the computation.  If you
+     *         cancel this Future, WorkManager will treat this unit of work as failed.
      */
     @MainThread
     public abstract @NonNull ListenableFuture<Payload> onStartWork();