Camera HALs: Promote device HAL v3.2

And deprecate older HALs.

Bug: 17445920
Change-Id: I37a5e53fda3c93080e37ec848f84c702a2c9120b
diff --git a/include/hardware/camera.h b/include/hardware/camera.h
index b7182f8..b1f18ff 100644
--- a/include/hardware/camera.h
+++ b/include/hardware/camera.h
@@ -22,7 +22,10 @@
 /**
  * Camera device HAL, initial version [ CAMERA_DEVICE_API_VERSION_1_0 ]
  *
- * Supports the android.hardware.Camera API.
+ * DEPRECATED. New devices should use Camera HAL v3.2 or newer.
+ *
+ * Supports the android.hardware.Camera API, and the android.hardware.camera2
+ * API in legacy mode only.
  *
  * Camera devices that support this version of the HAL must return a value in
  * the range HARDWARE_DEVICE_API_VERSION(0,0)-(1,FF) in