From: Taeyoung Kim <ty317.kim@samsung.com>
Date: Wed, 13 Jan 2016 05:56:17 +0000 (+0900)
Subject: doc: update document
X-Git-Tag: submit/tizen/20160115.065618^0
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=f1b59ffe028eb7469874a5682ee2267384fea007;p=platform%2Fcore%2Fapi%2Fdevice.git

doc: update document

- add comments for deprecated apis since Tizen 2.4
- change guide url for featuring on the manifest file

Change-Id: Iced5ffa65f010c6ae10e80bd64c62c78a37c5843
Signed-off-by: Taeyoung Kim <ty317.kim@samsung.com>
---

diff --git a/doc/device_doc.h b/doc/device_doc.h
index eef11de..f518917 100755
--- a/doc/device_doc.h
+++ b/doc/device_doc.h
@@ -110,7 +110,7 @@
  *
  * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
  *
- * More details on featuring your application can be found from <a href="../org.tizen.mobile.native.appprogramming/html/ide_sdk_tools/feature_element.htm"><b>Feature Element</b>.</a>
+ * More details on featuring your application can be found from <a href="https://developer.tizen.org/development/tools/native-tools/manifest-text-editor#feature"><b>Feature Element</b>.</a>
  *
  */
 
diff --git a/include/display.h b/include/display.h
index c613949..db282e7 100755
--- a/include/display.h
+++ b/include/display.h
@@ -170,12 +170,15 @@ typedef enum
 int device_display_get_state(display_state_e *state);
 
 /**
+ * @deprecated Deprecated Since 2.4
  * @brief Changes the display state by force.
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/display
  *
+ * @remarks This API triggers display change process and then updates the status when it completes. While the operation is on-going, the device_display_get_state() function returns previous display state
+ *
  * @param[in] state the display state
  *
  * @return @c 0 on success,
diff --git a/include/power.h b/include/power.h
index a461188..7cf0c7b 100755
--- a/include/power.h
+++ b/include/power.h
@@ -38,7 +38,11 @@ extern "C" {
  *                                 CPU    Brightness \n
  *          POWER_LOCK_CPU          ON      OFF \n
  *          POWER_LOCK_DISPLAY      ON      ON(normal) \n
- *          POWER_LOCK_DISPLAY_DIM  ON      ON(dim)
+ *          POWER_LOCK_DISPLAY_DIM  ON      ON(dim) \n\n
+ *          The POWER_LOCK_DISPLAY and POWER_LOCK_DISPLAY_DIM types were deprecated in Tizen 2.4.\n
+ *          Please use below api set instead of these types.\n
+ *          int efl_util_set_window_screen_mode(Evas_Object *window, efl_util_screen_mode_e mode);\n
+ *          int efl_util_get_window_screen_mode(Evas_Object *window, efl_util_screen_mode_e *mode);
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -50,8 +54,8 @@ extern "C" {
 typedef enum
 {
     POWER_LOCK_CPU,         /**< CPU lock */
-    POWER_LOCK_DISPLAY,     /**< Display normal lock */
-    POWER_LOCK_DISPLAY_DIM, /**< Display dim lock */
+    POWER_LOCK_DISPLAY,     /**< Display normal lock (Deprecated since 2.4. Use efl_util_set_window_screen_mode() instead) */
+    POWER_LOCK_DISPLAY_DIM, /**< Display dim lock (Deprecated since 2.4. Use efl_util_set_window_screen_mode() instead) */
 } power_lock_e;
 
 /**
@@ -102,12 +106,15 @@ int device_power_request_lock(power_lock_e type, int timeout_ms);
 int device_power_release_lock(power_lock_e type);
 
 /**
+ * @deprecated Deprecated Since 2.4
  * @brief Changes the current power state to the normal/dim state.
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/display
  *
+ * @remarks This API triggers turn on process and then updates the status when it completes. While the operation is on-going, the device_display_get_state() function returns previous display state
+ *
  * @param[in] dim Set @c true to set the dim state,
  *                otherwise set @c false to not set the dim state
  *