diff --git a/core/java/android/hardware/camera2/CaptureRequest.java b/core/java/android/hardware/camera2/CaptureRequest.java
index ada7ebf0f5dac..98901a1e69190 100644
--- a/core/java/android/hardware/camera2/CaptureRequest.java
+++ b/core/java/android/hardware/camera2/CaptureRequest.java
@@ -1457,7 +1457,8 @@ public final class CaptureRequest extends CameraMetadata
If all regions have 0 weight, then no specific metering area needs to be used by the - * camera device.
+ * camera device. The capture result will either be a zero weight region as well, or + * the region selected by the camera device as the focus area of interest. *If the metering region is outside the used {@link CaptureRequest#SCALER_CROP_REGION android.scaler.cropRegion} returned in
* capture result metadata, the camera device will ignore the sections outside the crop
* region and output only the intersection rectangle as the metering region in the result
diff --git a/core/java/android/hardware/camera2/CaptureResult.java b/core/java/android/hardware/camera2/CaptureResult.java
index 8c2f8c1e85534..e14dfa88fb8bf 100644
--- a/core/java/android/hardware/camera2/CaptureResult.java
+++ b/core/java/android/hardware/camera2/CaptureResult.java
@@ -1156,7 +1156,8 @@ public class CaptureResult extends CameraMetadata
If all regions have 0 weight, then no specific metering area needs to be used by the - * camera device.
+ * camera device. The capture result will either be a zero weight region as well, or + * the region selected by the camera device as the focus area of interest. *If the metering region is outside the used {@link CaptureRequest#SCALER_CROP_REGION android.scaler.cropRegion} returned in * capture result metadata, the camera device will ignore the sections outside the crop * region and output only the intersection rectangle as the metering region in the result