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();