From 9c58bd569a3a5e82faf6e4ef70d0f0bb6413f7e7 Mon Sep 17 00:00:00 2001
From: Yin-Chia Yeh <yinchiayeh@google.com>
Date: Thu, 4 Apr 2019 12:13:47 -0700
Subject: [PATCH] Camera NDK: document not all cameras are supported

Test: check html output of: frameworks/native/doc/make website
      (with a tweak in Doxyfile to add "__ANDROID__API__=24" to
       PREDEFINED)
Bug: 120916880

Change-Id: Idf93a13b9bbe2974fa4256de1f3ca67b7eee1bb6
---
 camera/ndk/include/camera/NdkCameraManager.h | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/camera/ndk/include/camera/NdkCameraManager.h b/camera/ndk/include/camera/NdkCameraManager.h
index 136a4979fc..5c810bbc5d 100644
--- a/camera/ndk/include/camera/NdkCameraManager.h
+++ b/camera/ndk/include/camera/NdkCameraManager.h
@@ -85,6 +85,11 @@ void ACameraManager_delete(ACameraManager* manager) __INTRODUCED_IN(24);
  * <p>ACameraManager_getCameraIdList will allocate and return an {@link ACameraIdList}.
  * The caller must call {@link ACameraManager_deleteCameraIdList} to free the memory</p>
  *
+ * <p>Note: the returned camera list might be a subset to the output of <a href=
+ * "https://developer.android.com/reference/android/hardware/camera2/CameraManager.html#getCameraIdList()">
+ * SDK CameraManager#getCameraIdList API</a> as the NDK API does not support some legacy camera
+ * hardware.</p>
+ *
  * @param manager the {@link ACameraManager} of interest
  * @param cameraIdList the output {@link ACameraIdList} will be filled in here if the method call
  *        succeeds.