Merge "[FocusAndMetering] Document exceptions for startFocusAndMetering to align with other CameraControl APIs" into androidx-main
diff --git a/camera/camera-core/src/main/java/androidx/camera/core/CameraControl.java b/camera/camera-core/src/main/java/androidx/camera/core/CameraControl.java
index e0c2bc1..b248db5 100644
--- a/camera/camera-core/src/main/java/androidx/camera/core/CameraControl.java
+++ b/camera/camera-core/src/main/java/androidx/camera/core/CameraControl.java
@@ -90,7 +90,10 @@
* @return A {@link ListenableFuture} which completes with {@link FocusMeteringAction} when
* auto focus is done and AF/AE/AWB regions are updated. In case AF points are not added,
* auto focus will not be triggered and this {@link ListenableFuture} completes when
- * AE/AWB regions are updated. Cancellation of this future is a no-op.
+ * AE/AWB regions are updated. It fails with {@link OperationCanceledException} if there is
+ * newer value being set or camera is closed. If none of the specified AF/AE/AWB
+ * {@link MeteringPoint} is supported, it fails with {@link IllegalArgumentException}.
+ * Cancellation of this future is a no-op.
*/
@NonNull
ListenableFuture<FocusMeteringResult> startFocusAndMetering(
