From: Jeongmo Yang <jm80.yang@samsung.com>
Date: Wed, 12 Apr 2023 03:24:07 +0000 (+0900)
Subject: Update header file to fix issues from header checker
X-Git-Tag: accepted/tizen/unified/20230605.170347~6
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=20a67247cbea739453489087660d542debd22bfa;p=platform%2Fcore%2Fapi%2Fcamera.git

Update header file to fix issues from header checker

- Reorder return values by priority
- Add remarks and comments
- Update description

[Version] 0.4.103
[Issue Type] Update

Change-Id: I96386e413f59d3c98e98c379a735a60da208e6a0
Signed-off-by: Jeongmo Yang <jm80.yang@samsung.com>
---

diff --git a/include/camera.h b/include/camera.h
index d9d35b9..aff7405 100644
--- a/include/camera.h
+++ b/include/camera.h
@@ -35,6 +35,10 @@ extern "C" {
  * @{
  */
 
+/**
+ * @brief Tizen error class for camera.
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ */
 #define CAMERA_ERROR_CLASS          TIZEN_ERROR_CAMERA | 0x00
 
 /**
@@ -282,7 +286,7 @@ typedef struct {
 			unsigned char *data;    /**< The RGB data pointer */
 			unsigned int size;      /**< The size of RGB data */
 		} rgb_plane;                /**< RGB plane frame data (Since 5.0) */
-	} data;
+	} data;                         /**< The frame data */
 } camera_preview_data_s;
 
 
@@ -586,20 +590,20 @@ typedef enum {
  */
 
 /**
- * @brief Called when the camera state is changed.
+ * @brief Invoked when the camera state is changed.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] previous  The previous state of the camera
  * @param[in] current   The current state of the camera
  * @param[in] by_policy If @c true the state is changed by policy, otherwise @c false
  * @param[in] user_data The user data passed from the callback registration function
  * @pre camera_start_preview(), camera_start_capture() or camera_stop_preview()
- *      will invoke this callback if you register this callback using camera_set_state_changed_cb().
+ *      will invoke this callback if you set this callback using camera_set_state_changed_cb().
  * @see camera_set_state_changed_cb()
  */
 typedef void (*camera_state_changed_cb)(camera_state_e previous, camera_state_e current, bool by_policy, void *user_data);
 
 /**
- * @brief Called when the camera device state is changed.
+ * @brief Invoked when the camera device state is changed.
  * @since_tizen 3.0
  * @param[in] device    The hardware camera type
  * @param[in] state     The state of the camera device
@@ -609,9 +613,9 @@ typedef void (*camera_state_changed_cb)(camera_state_e previous, camera_state_e
 typedef void (*camera_device_state_changed_cb)(camera_device_e device, camera_device_state_e state, void *user_data);
 
 /**
- * @brief Called when the camera is interrupted by policy.
+ * @brief Invoked when the camera is interrupted by policy.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @remarks This callback is called after interrupt handling is completed.
+ * @remarks This callback is invoked after interrupt handling is completed.
  * @param[in] policy    The policy that interrupted the camera
  * @param[in] previous  The previous state of the camera
  * @param[in] current   The current state of the camera
@@ -621,9 +625,9 @@ typedef void (*camera_device_state_changed_cb)(camera_device_e device, camera_de
 typedef void (*camera_interrupted_cb)(camera_policy_e policy, camera_state_e previous, camera_state_e current, void *user_data);
 
 /**
- * @brief Called when the camera interrupt is started by policy.
+ * @brief Invoked when the camera interrupt is started by policy.
  * @since_tizen 4.0
- * @remarks This callback is called before interrupt handling is started.
+ * @remarks This callback is invoked before interrupt handling is started.
  * @param[in] policy    The policy that is interrupting the camera
  * @param[in] state     The current state of the camera
  * @param[in] user_data The user data passed from the callback registration function
@@ -632,7 +636,7 @@ typedef void (*camera_interrupted_cb)(camera_policy_e policy, camera_state_e pre
 typedef void (*camera_interrupt_started_cb)(camera_policy_e policy, camera_state_e state, void *user_data);
 
 /**
- * @brief Called when the camera focus state is changed.
+ * @brief Invoked when the camera focus state is changed.
  * @details When the camera auto focus completes or a change to the focus state occurs,
  *          this callback is invoked. \n \n
  *          Changes of focus state are as follows: \n
@@ -642,7 +646,7 @@ typedef void (*camera_interrupt_started_cb)(camera_policy_e policy, camera_state
  *
  * @param[in] state     The current state of the auto-focus
  * @param[in] user_data The user data passed from the callback registration function
- * @pre camera_start_focusing() will invoke this callback if you register it using camera_set_focus_changed_cb().
+ * @pre camera_start_focusing() will invoke this callback if you set it using camera_set_focus_changed_cb().
  * @see camera_set_focus_changed_cb()
  * @see camera_unset_focus_changed_cb()
  * @see camera_start_focusing()
@@ -651,16 +655,16 @@ typedef void (*camera_interrupt_started_cb)(camera_policy_e policy, camera_state
 typedef void (*camera_focus_changed_cb)(camera_focus_state_e state, void *user_data);
 
 /**
- * @brief Called to register for notifications about delivering a copy of the new preview frame when every preview frame is displayed.
+ * @brief Invoked for notifications about delivering a copy of the new preview frame when every preview frame is displayed.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
- * @remarks This function is issued in the context of internal framework so the UI update code should not be directly invoked.\n
- *          If the camera is used as a recorder then this callback function won't be called.
+ * @remarks This function is invoked in the context of internal framework so the UI update code should not be directly called.\n
+ *          If the camera is used as a recorder then this callback function won't be invoked.
  * @remarks The @a frame should not be released and it's available until the callback returns.
  *
  * @param[in] frame     The reference pointer to preview stream data
  * @param[in] user_data The user data passed from the callback registration function
- * @pre camera_start_preview() will invoke this callback function if you register this callback using camera_set_preview_cb().
+ * @pre camera_start_preview() will invoke this callback function if you set this callback using camera_set_preview_cb().
  * @see camera_start_preview()
  * @see camera_set_preview_cb()
  * @see camera_unset_preview_cb()
@@ -668,16 +672,16 @@ typedef void (*camera_focus_changed_cb)(camera_focus_state_e state, void *user_d
 typedef void (*camera_preview_cb)(camera_preview_data_s *frame, void *user_data);
 
 /**
- * @brief Called to register for notifications about delivering media packet when every preview frame is displayed.
+ * @brief Invoked for notifications about delivering media packet when every preview frame is displayed.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
- * @remarks This function is issued in the context of internal framework so the UI update code should not be directly invoked.\n
- *          If the camera is used as a recorder then this callback function won't be called.\n
+ * @remarks This function is invoked in the context of internal framework so the UI update code should not be directly called.\n
+ *          If the camera is used as a recorder then this callback function won't be invoked.\n
  *          and the packet should be released by media_packet_destroy() after use.
  *
  * @param[in] pkt       Reference pointer to media packet
  * @param[in] user_data The user data passed from the callback registration function
- * @pre camera_start_preview() will invoke this callback function if you register this callback using camera_set_media_packet_preview_cb().
+ * @pre camera_start_preview() will invoke this callback function if you set this callback using camera_set_media_packet_preview_cb().
  * @see camera_start_preview()
  * @see camera_set_media_packet_preview_cb()
  * @see camera_unset_media_packet_preview_cb()
@@ -685,17 +689,17 @@ typedef void (*camera_preview_cb)(camera_preview_data_s *frame, void *user_data)
 typedef void (*camera_media_packet_preview_cb)(media_packet_h pkt, void *user_data);
 
 /**
- * @brief Called to get information about image data taken by the camera once per frame while capturing.
+ * @brief Invoked to get information about image data taken by the camera once per frame while capturing.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
- * @remarks This function is issued in the context of internal framework so the UI update code should not be directly invoked.
- *          You must not call camera_start_preview() within this callback.
- *
+ * @remarks This function is invoked in the context of internal framework so the UI update code should not be directly called.
+ *          You must not call camera_start_preview() within this callback. \n
+ *          The @a image, @a postview and @a thumbnail should not be released and it can be used only in the callback. To use outside, make a copy.
  * @param[in] image     The image data of the captured picture
  * @param[in] postview  The image data of the postview
  * @param[in] thumbnail The image data of the thumbnail (it should be @c NULL if the available thumbnail data does not exist)
  * @param[in] user_data The user data passed from the callback registration function
- * @pre camera_start_capture() or camera_start_continuous_capture() will invoke this callback function if it is registered using camera_start_capture() or camera_start_continuous_capture().
+ * @pre camera_start_capture() or camera_start_continuous_capture() will invoke this callback function if it is set using camera_start_capture() or camera_start_continuous_capture().
  * @see camera_start_capture()
  * @see camera_start_continuous_capture()
  * @see camera_capture_completed_cb()
@@ -703,14 +707,14 @@ typedef void (*camera_media_packet_preview_cb)(media_packet_h pkt, void *user_da
 typedef void (*camera_capturing_cb)(camera_image_data_s *image, camera_image_data_s *postview, camera_image_data_s *thumbnail, void *user_data);
 
 /**
- * @brief Called when the camera capturing completes.
+ * @brief Invoked when the camera capturing completes.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
- * @remarks The callback is called after camera_capturing_cb() is completed.\n
+ * @remarks The callback is invoked after camera_capturing_cb() is completed.\n
  *          If you want to show the user a preview after capturing is finished, \n
  *          an application can use camera_start_preview() after calling this callback.
  * @param[in] user_data The user data passed from the callback registration function
- * @pre This callback function is invoked if it is registered using camera_start_capture() or camera_start_continuous_capture().
+ * @pre This callback function is invoked if it is set using camera_start_capture() or camera_start_continuous_capture().
  * @see camera_start_capture()
  * @see camera_start_continuous_capture()
  * @see camera_capturing_cb()
@@ -718,7 +722,7 @@ typedef void (*camera_capturing_cb)(camera_image_data_s *image, camera_image_dat
 typedef void (*camera_capture_completed_cb)(void *user_data);
 
 /**
- * @brief Called when an error occurs.
+ * @brief Invoked when an error occurs.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
  * @remarks This callback informs about a critical error situation.\n
@@ -730,15 +734,16 @@ typedef void (*camera_capture_completed_cb)(void *user_data);
  * @param[in] error         The error code
  * @param[in] current_state The current state of the camera
  * @param[in] user_data     The user data passed from the callback registration function
- * @pre This callback function is invoked if it is registered using camera_set_error_cb().
+ * @pre This callback function is invoked if it is set using camera_set_error_cb().
  * @see camera_set_error_cb()
  * @see camera_unset_error_cb()
  */
 typedef void (*camera_error_cb)(camera_error_e error, camera_state_e current_state, void *user_data);
 
 /**
- * @brief Called when a face is detected in the preview frame.
+ * @brief Invoked when a face is detected in the preview frame.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks The @a faces should not be released and it can be used only in the callback. To use outside, make a copy.
  * @param[in] faces     The detected face array
  * @param[in] count     The length of the array
  * @param[in] user_data The user data passed from the callback registration function
@@ -747,8 +752,9 @@ typedef void (*camera_error_cb)(camera_error_e error, camera_state_e current_sta
 typedef void (*camera_face_detected_cb)(camera_detected_face_s *faces, int count, void *user_data);
 
 /**
- * @brief Called when the connection state of a camera device was changed.
+ * @brief Invoked when the connection state of a camera device was changed.
  * @since_tizen 7.0
+ * @remarks The @a device should not be released and it can be used only in the callback. To use outside, make a copy.
  * @param[in] device                    The camera device
  * @param[in] is_connected              The state of device connection: (@c true = connected, @c false = disconnected)
  * @param[in] user_data                 The user data passed from the callback registration function
@@ -758,12 +764,13 @@ typedef void (*camera_face_detected_cb)(camera_detected_face_s *faces, int count
 typedef void (*camera_device_connection_changed_cb)(camera_device_s *device, bool is_connected, void *user_data);
 
 /**
- * @brief Called when the extra preview frame is delivered from the camera device.
+ * @brief Invoked when the extra preview frame is delivered from the camera device.
  * @since_tizen 7.0
+ * @remarks The @a frame should not be released and it can be used only in the callback. To use outside, make a copy.
  * @param[in] frame     The reference pointer to extra preview stream data
  * @param[in] stream_id The ID of the preview stream
  * @param[in] user_data The user data passed from the callback registration function
- * @pre camera_start_preview() will invoke this callback function if you register this callback using camera_set_extra_preview_cb().
+ * @pre camera_start_preview() will invoke this callback function if you set this callback using camera_set_extra_preview_cb().
  * @see camera_start_preview()
  * @see camera_set_extra_preview_cb()
  * @see camera_unset_extra_preview_cb()
@@ -780,7 +787,7 @@ typedef void (*camera_extra_preview_cb)(camera_preview_data_s *frame, int stream
  */
 
 /**
- * @brief Called once for each supported preview resolution.
+ * @brief Invoked once for each supported preview resolution.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] width     The preview image width
  * @param[in] height    The preview image height
@@ -792,7 +799,7 @@ typedef void (*camera_extra_preview_cb)(camera_preview_data_s *frame, int stream
 typedef bool (*camera_supported_preview_resolution_cb)(int width, int height, void *user_data);
 
 /**
- * @brief Called once for each supported capture resolution.
+ * @brief Invoked once for each supported capture resolution.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] width     The capture resolution width
  * @param[in] height    The capture resolution height
@@ -804,7 +811,7 @@ typedef bool (*camera_supported_preview_resolution_cb)(int width, int height, vo
 typedef bool (*camera_supported_capture_resolution_cb)(int width, int height, void *user_data);
 
 /**
- * @brief Called once for the pixel format of each supported capture format.
+ * @brief Invoked once for the pixel format of each supported capture format.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] format    The supported pixel format
  * @param[in] user_data The user data passed from the foreach function
@@ -815,7 +822,7 @@ typedef bool (*camera_supported_capture_resolution_cb)(int width, int height, vo
 typedef bool (*camera_supported_capture_format_cb)(camera_pixel_format_e format, void *user_data);
 
 /**
- * @brief Called once for the pixel format of each supported preview format.
+ * @brief Invoked once for the pixel format of each supported preview format.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] format    The supported preview data format
  * @param[in] user_data The user data passed from the foreach function
@@ -826,8 +833,9 @@ typedef bool (*camera_supported_capture_format_cb)(camera_pixel_format_e format,
 typedef bool (*camera_supported_preview_format_cb)(camera_pixel_format_e format, void *user_data);
 
 /**
- * @brief Called once for the each supported device.
+ * @brief Invoked once for the each supported device.
  * @since_tizen 7.0
+ * @remarks The @a device should not be released and it can be used only in the callback. To use outside, make a copy.
  * @param[in] device    The camera device
  * @param[in] user_data The user data passed from the foreach function
  * @return @c true to continue with the next iteration of the loop, \n otherwise @c false to break out of the loop
@@ -860,10 +868,10 @@ typedef bool (*camera_supported_device_cb)(camera_device_s *device, void *user_d
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_OUT_OF_MEMORY Out of memory
  * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @post If it succeeds, the camera state will be #CAMERA_STATE_CREATED.
  *
  * @see camera_destroy()
@@ -903,10 +911,10 @@ int camera_change_device(camera_h camera, camera_device_e device);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @see camera_create()
  * @see camera_create_network()
  */
@@ -970,7 +978,7 @@ int camera_device_manager_deinitialize(camera_device_manager_h manager);
  * @brief Retrieves all supported devices by invoking the callback function once for each supported device.
  * @since_tizen 7.0
  * @param[in] manager   The handle to the camera device manager
- * @param[in] callback  The callback function to register
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
@@ -994,12 +1002,12 @@ int camera_device_manager_foreach_supported_device(camera_device_manager_h manag
  */
 
 /**
- * @brief Adds a callback function to be called when the connection state of camera device is changed.
+ * @brief Adds a callback function to be invoked when the connection state of camera device is changed.
  * @since_tizen 7.0
  * @param[in]  manager   The handle to the camera device manager
- * @param[in]  callback  The callback function to register
+ * @param[in]  callback  The callback function to be invoked
  * @param[in]  user_data The user data to be passed to the callback function
- * @param[out] cb_id     The id of registered callback
+ * @param[out] cb_id     The id of added callback
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
@@ -1012,10 +1020,10 @@ int camera_device_manager_foreach_supported_device(camera_device_manager_h manag
 int camera_device_manager_add_device_connection_changed_cb(camera_device_manager_h manager, camera_device_connection_changed_cb callback, void *user_data, int *cb_id);
 
 /**
- * @brief Removes the callback function.
+ * @brief Removes the device connection changed callback function.
  * @since_tizen 7.0
  * @param[in] manager The handle to the camera device manager
- * @param[in] cb_id   The id of registered callback
+ * @param[in] cb_id   The id of added callback
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
@@ -1035,20 +1043,20 @@ int camera_device_manager_remove_device_connection_changed_cb(camera_device_mana
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_RESOURCE_CONFLICT Resource conflict error
  * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation
  * @retval #CAMERA_ERROR_DEVICE_BUSY The device is being used in another application or is performing other operations
  * @retval #CAMERA_ERROR_DEVICE_NOT_FOUND No camera device
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre    The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_CAPTURED.\n
  *         You must set the display handle. \n
  *         If needed, modify preview FPS(camera_attr_set_preview_fps()),
  *         preview resolution(camera_set_preview_resolution()), or preview format(camera_set_preview_format()).
  * @post   If it succeeds, the camera state will be #CAMERA_STATE_PREVIEW.\n
- *         camera_preview_cb() will be called when preview image data becomes available.
+ *         camera_preview_cb() will be invoked when preview image data becomes available.
  *
  * @see camera_stop_preview()
  * @see camera_set_display()
@@ -1075,10 +1083,10 @@ int camera_start_preview(camera_h camera);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_PREVIEW.
  * @post The camera state will be #CAMERA_STATE_CREATED.
@@ -1106,10 +1114,10 @@ int camera_stop_preview(camera_h camera);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_PREVIEW. \n
  *      If needed, modify capture resolution(camera_set_capture_resolution()),
@@ -1150,10 +1158,10 @@ int camera_start_capture(camera_h camera, camera_capturing_cb capturing_cb, came
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post   If it succeeds the camera state will be #CAMERA_STATE_CAPTURED.
  *
@@ -1175,10 +1183,10 @@ int camera_start_continuous_capture(camera_h camera, int count, int interval, ca
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_PREVIEW.
  *
@@ -1195,8 +1203,8 @@ int camera_stop_continuous_capture(camera_h camera);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_create()
  * @see camera_start_preview()
@@ -1217,10 +1225,10 @@ int camera_get_state(camera_h camera, camera_state_e *state);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_PREVIEW.
  * @post The camera focus state will be #CAMERA_FOCUS_STATE_ONGOING.
@@ -1241,10 +1249,10 @@ int camera_start_focusing(camera_h camera, bool continuous);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_PREVIEW.
  *
@@ -1270,10 +1278,10 @@ int camera_cancel_focusing(camera_h camera);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED.
  *
@@ -1295,9 +1303,9 @@ int camera_set_display(camera_h camera, camera_display_type_e type, camera_displ
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  *
@@ -1317,8 +1325,8 @@ int camera_set_preview_resolution(camera_h camera, int width, int height);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_preview_resolution()
  * @see camera_foreach_supported_preview_resolution()
@@ -1336,8 +1344,8 @@ int camera_get_preview_resolution(camera_h camera, int *width, int *height);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_preview_resolution()
  * @see camera_foreach_supported_preview_resolution()
@@ -1353,7 +1361,7 @@ int camera_get_recommended_preview_resolution(camera_h camera, int *width, int *
  *          This callback will be invoked when the face is detected in the preview frame.\n
  *          Internally it starts continuous focus and focusing on the detected face.\n
  *          When face detection is running, the camera_start_focusing(), camera_cancel_focusing(), camera_attr_set_af_mode(), camera_attr_set_af_area(), camera_attr_set_exposure_mode(), and camera_attr_set_whitebalance() settings are ignored.\n
- *          If camera_stop_preview() is invoked, face detection is stopped and then preview is resumed using camera_start_preview(), this method should be called again to resume face detection.
+ *          If camera_stop_preview() is called, face detection is stopped and then preview is resumed using camera_start_preview(), this should be called again to resume face detection.
  * @param[in] camera    The handle to the camera
  * @param[in] callback  The callback to notify face detection
  * @param[in] user_data The user data to be passed to the callback function
@@ -1361,10 +1369,10 @@ int camera_get_recommended_preview_resolution(camera_h camera, int *width, int *
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Not preview state
  * @retval #CAMERA_ERROR_INVALID_OPERATION Not supported this feature
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be #CAMERA_STATE_PREVIEW.
  *
@@ -1384,8 +1392,8 @@ int camera_start_face_detection(camera_h camera, camera_face_detected_cb callbac
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre This should be called after face detection is started.
  *
@@ -1412,8 +1420,8 @@ int camera_stop_face_detection(camera_h camera);
  * @return @c true on supported, otherwise false
  * @exception #CAMERA_ERROR_NONE Successful
  * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  *
  */
 bool camera_is_supported_continuous_capture(camera_h camera);
@@ -1428,8 +1436,8 @@ bool camera_is_supported_continuous_capture(camera_h camera);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_supported_preview_resolution_cb() repeatedly to retrieve each supported preview resolution.
  *
@@ -1459,10 +1467,10 @@ int camera_foreach_supported_preview_resolution(camera_h camera, camera_supporte
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_INVALID_OPERATION Display type is incorrect
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_start_preview()
  * @see camera_get_display_rotation()
@@ -1479,8 +1487,8 @@ int camera_set_display_rotation(camera_h camera, camera_rotation_e rotation);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_display_rotation()
  */
@@ -1496,10 +1504,10 @@ int camera_get_display_rotation(camera_h camera, camera_rotation_e *rotation);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_INVALID_OPERATION Display type is incorrect
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_get_display_flip()
  */
@@ -1515,8 +1523,8 @@ int camera_set_display_flip(camera_h camera, camera_flip_e flip);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_display_flip()
  */
@@ -1533,8 +1541,8 @@ int camera_get_display_flip(camera_h camera, camera_flip_e *flip);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_is_display_visible()
  */
@@ -1551,8 +1559,8 @@ int camera_set_display_visible(camera_h camera, bool visible);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_display_visible()
  */
@@ -1569,8 +1577,8 @@ int camera_is_display_visible(camera_h camera, bool *visible);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_get_display_mode()
  */
@@ -1587,8 +1595,8 @@ int camera_set_display_mode(camera_h camera, camera_display_mode_e mode);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_display_mode()
  */
@@ -1638,9 +1646,9 @@ int camera_get_display_reuse_hint(camera_h camera, bool *hint);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_start_capture()
@@ -1658,8 +1666,8 @@ int camera_set_capture_resolution(camera_h camera, int width, int height);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_capture_resolution()
  * @see camera_foreach_supported_capture_resolution()
@@ -1680,13 +1688,13 @@ int camera_get_capture_resolution(camera_h camera, int *width, int *height);
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to register
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_supported_capture_resolution_cb() repeatedly to retrieve each supported capture resolution.
  * @see camera_set_capture_resolution()
@@ -1709,14 +1717,14 @@ int camera_foreach_supported_capture_resolution(camera_h camera, camera_supporte
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks This function should be called before capturing (see camera_start_capture()).
- * @param[in]  camera The handle to the camera
- * @param[out] format The format of the image to be captured
+ * @param[in] camera The handle to the camera
+ * @param[in] format The format of the image to be captured
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_start_capture()
@@ -1734,8 +1742,8 @@ int camera_set_capture_format(camera_h camera, camera_pixel_format_e format);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_capture_format()
  * @see camera_foreach_supported_capture_format()
@@ -1761,8 +1769,8 @@ int camera_get_capture_format(camera_h camera, camera_pixel_format_e *format);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_supported_capture_format_cb() repeatedly to retrieve each supported capture format.
  * @see camera_set_capture_format()
@@ -1789,9 +1797,9 @@ int camera_foreach_supported_capture_format(camera_h camera, camera_supported_ca
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED.
  * @see camera_start_preview()
@@ -1808,8 +1816,8 @@ int camera_set_preview_format(camera_h camera, camera_pixel_format_e format);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_preview_format()
  * @see camera_foreach_supported_preview_format()
@@ -1824,8 +1832,8 @@ int camera_get_preview_format(camera_h camera, camera_pixel_format_e *format);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  */
 int camera_get_facing_direction(camera_h camera, camera_facing_direction_e *facing_direction);
@@ -1838,18 +1846,18 @@ int camera_get_facing_direction(camera_h camera, camera_facing_direction_e *faci
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @see camera_attr_set_flash_mode()
  * @see camera_attr_get_flash_mode()
  */
 int camera_get_flash_state(camera_device_e device, camera_flash_state_e *state);
 
 /**
- * @brief Sets a callback function to be called for extra preview frames.
+ * @brief Sets a callback function to be invoked for extra preview frames.
  * @since_tizen 7.0
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to be registered
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
@@ -1864,7 +1872,7 @@ int camera_get_flash_state(camera_device_e device, camera_flash_state_e *state);
 int camera_set_extra_preview_cb(camera_h camera, camera_extra_preview_cb callback, void *user_data);
 
 /**
- * @brief Unsets the callback function.
+ * @brief Unsets the extra preview callback function.
  * @since_tizen 7.0
  * @param[in] camera The handle to the camera
  * @return @c 0 on success, otherwise a negative error value
@@ -1940,8 +1948,8 @@ int camera_get_extra_preview_stream_format(camera_h camera, int stream_id, camer
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_supported_preview_format_cb() repeatedly to retrieve each supported preview format.
  * @see camera_set_preview_format()
@@ -1959,8 +1967,8 @@ int camera_foreach_supported_preview_format(camera_h camera, camera_supported_pr
  * @return @c true if supported, otherwise @c false
  * @exception #CAMERA_ERROR_NONE Successful
  * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @see camera_start_face_detection()
  * @see camera_stop_face_detection()
  */
@@ -1976,8 +1984,8 @@ bool camera_is_supported_face_detection(camera_h camera);
  * @return @c true if supported, otherwise @c false
  * @exception #CAMERA_ERROR_NONE Successful
  * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  */
 bool camera_is_supported_zero_shutter_lag(camera_h camera);
 
@@ -1991,8 +1999,8 @@ bool camera_is_supported_zero_shutter_lag(camera_h camera);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  */
 int camera_get_device_count(camera_h camera, int *device_count);
@@ -2006,8 +2014,8 @@ int camera_get_device_count(camera_h camera, int *device_count);
  * @return @c true if supported, otherwise @c false
  * @exception #CAMERA_ERROR_NONE Successful
  * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  *
  */
 bool camera_is_supported_media_packet_preview_cb(camera_h camera);
@@ -2034,27 +2042,27 @@ bool camera_is_supported_extra_preview(camera_h camera);
  */
 
 /**
- * @brief Registers a callback function to be called once per frame when previewing.
+ * @brief Sets a callback function to be invoked once per frame when previewing.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks This callback does not work in the video recorder mode.\n
  *          Before 4.0, the only allowed state for calling this function was #CAMERA_STATE_CREATED.\n
  *          Since 4.0, #CAMERA_STATE_PREVIEW has been added as an allowed state,\n
- *          so that this function could be called before previewing or even while previewing.\n
- *          A registered callback is called on the internal thread of the camera.\n
- *          A video frame can be retrieved using a registered callback,\n
- *          and the buffer is only available in a registered callback.\n
- *          Since tizen 3.0, if you change the buffer in a registered callback,\n
+ *          so that this function could be invoked before previewing or even while previewing.\n
+ *          A @a callback is invoked on the internal thread of the camera.\n
+ *          A video frame can be retrieved using a @a callback,\n
+ *          and the buffer is only available in a @a callback.\n
+ *          Since tizen 3.0, if you change the buffer in a @a callback,\n
  *          it could not be displayed on the device in case of copied buffer.\n
  *          and if camera_is_supported_media_packet_preview_cb() returns false,\n
  *          it's copied buffer case.
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to be registered
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre Before 4.0 : The camera state must be set to #CAMERA_STATE_CREATED.\n
  *      Since  4.0 : The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
@@ -2065,37 +2073,37 @@ bool camera_is_supported_extra_preview(camera_h camera);
 int camera_set_preview_cb(camera_h camera, camera_preview_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the preview callback function.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera The handle to the camera
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_preview_cb()
  */
 int camera_unset_preview_cb(camera_h camera);
 
 /**
- * @brief Registers a media packet callback function to be called once per frame when previewing.
+ * @brief Sets a media packet callback function to be invoked once per frame when previewing.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks This callback does not work in video recorder mode.\n
  *          This function should be called before previewing (see camera_start_preview())\n
- *          A registered callback is called on the internal thread of the camera.\n
- *          A video frame can be retrieved using a registered callback as a media packet.\n
+ *          A @a callback is invoked on the internal thread of the camera.\n
+ *          A video frame can be retrieved using a @a callback as a media packet.\n
  *          The callback function holds the same buffer that will be drawn on the display device.\n
- *          So if you change the media packet in a registered callback, it will be displayed on the device\n
+ *          So if you change the media packet in a callback, it will be displayed on the device\n
  *          and the media packet is available until it's destroyed by media_packet_destroy().
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to be registered
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera's state should be #CAMERA_STATE_CREATED.
  * @see camera_start_preview()
@@ -2105,30 +2113,30 @@ int camera_unset_preview_cb(camera_h camera);
 int camera_set_media_packet_preview_cb(camera_h camera, camera_media_packet_preview_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the media packet callback function.
+ * @brief Unsets the media packet callback function.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera The handle to the camera
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_media_packet_preview_cb()
  */
 int camera_unset_media_packet_preview_cb(camera_h camera);
 
 /**
- * @brief Registers a callback function to be called when the camera state changes.
+ * @brief Sets a callback function to be invoked when the camera state changes.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to register
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function will invoke camera_state_changed_cb() when the camera state changes.
  * @see camera_unset_state_changed_cb()
@@ -2137,30 +2145,30 @@ int camera_unset_media_packet_preview_cb(camera_h camera);
 int camera_set_state_changed_cb(camera_h camera, camera_state_changed_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the state changed callback function.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera The handle to the camera
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_state_changed_cb()
  */
 int camera_unset_state_changed_cb(camera_h camera);
 
 /**
- * @brief Registers a callback function to be called when the camera is interrupted by policy.
+ * @brief Sets a callback function to be invoked when the camera is interrupted by policy.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to register
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_unset_interrupted_cb()
  * @see camera_interrupted_cb()
@@ -2168,24 +2176,24 @@ int camera_unset_state_changed_cb(camera_h camera);
 int camera_set_interrupted_cb(camera_h camera, camera_interrupted_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the interrupted callback function.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera The handle to the camera
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_interrupted_cb()
  */
 int camera_unset_interrupted_cb(camera_h camera);
 
 /**
- * @brief Registers a callback function to be called when the camera interrupt is started by policy.
+ * @brief Sets a callback function to be invoked when the camera interrupt is started by policy.
  * @since_tizen 4.0
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to register
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
@@ -2196,7 +2204,7 @@ int camera_unset_interrupted_cb(camera_h camera);
 int camera_set_interrupt_started_cb(camera_h camera, camera_interrupt_started_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the interrupt started callback function.
  * @since_tizen 4.0
  * @param[in] camera The handle to the camera
  * @return @c 0 on success, otherwise a negative error value
@@ -2207,16 +2215,16 @@ int camera_set_interrupt_started_cb(camera_h camera, camera_interrupt_started_cb
 int camera_unset_interrupt_started_cb(camera_h camera);
 
 /**
- * @brief Registers a callback function to be called when the auto-focus state changes.
+ * @brief Sets a callback function to be invoked when the auto-focus state changes.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to register
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function will invoke camera_focus_changed_cb() when the auto-focus state changes.
  * @see camera_start_focusing()
@@ -2227,21 +2235,21 @@ int camera_unset_interrupt_started_cb(camera_h camera);
 int camera_set_focus_changed_cb(camera_h camera, camera_focus_changed_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the focus changed callback function.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera The handle to the camera
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_focus_changed_cb()
  */
 int camera_unset_focus_changed_cb(camera_h camera);
 
 /**
- * @brief Registers a callback function to be called when an asynchronous operation error occurs.
+ * @brief Sets a callback function to be invoked when an asynchronous operation error occurs.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks This callback informs about a critical error situation.\n
  *          When this callback is invoked, the user should release the resource and terminate the application.\n
@@ -2250,13 +2258,13 @@ int camera_unset_focus_changed_cb(camera_h camera);
  *          #CAMERA_ERROR_INVALID_OPERATION,\n
  *          #CAMERA_ERROR_OUT_OF_MEMORY.
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to register
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function will invoke camera_error_cb() when an asynchronous operation error occurs.
 
@@ -2266,14 +2274,14 @@ int camera_unset_focus_changed_cb(camera_h camera);
 int camera_set_error_cb(camera_h camera, camera_error_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the error callback function.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera The handle to the camera
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_error_cb()
  */
@@ -2293,11 +2301,11 @@ int camera_unset_error_cb(camera_h camera);
 int camera_get_device_state(camera_device_e device, camera_device_state_e *state);
 
 /**
- * @brief Registers a callback function to be called when the camera device state changes.
+ * @brief Adds a callback function to be invoked when the camera device state changes.
  * @since_tizen 3.0
- * @param[in]  callback  The callback function to register
+ * @param[in]  callback  The callback function to be invoked
  * @param[in]  user_data The user data to be passed to the callback function
- * @param[out] cb_id     The id of registered callback
+ * @param[out] cb_id     The id of added callback
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
@@ -2311,9 +2319,9 @@ int camera_get_device_state(camera_device_e device, camera_device_state_e *state
 int camera_add_device_state_changed_cb(camera_device_state_changed_cb callback, void *user_data, int *cb_id);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Removes the device state changed callback function.
  * @since_tizen 3.0
- * @param[in] cb_id The id of registered callback
+ * @param[in] cb_id The id of added callback
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
@@ -2333,7 +2341,7 @@ int camera_remove_device_state_changed_cb(int cb_id);
  */
 
 /**
- * @brief Called to get each supported auto-focus mode.
+ * @brief Invoked to get each supported auto-focus mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] mode      The supported auto-focus mode
  * @param[in] user_data The user data passed from the foreach function
@@ -2344,7 +2352,7 @@ int camera_remove_device_state_changed_cb(int cb_id);
 typedef bool (*camera_attr_supported_af_mode_cb)(camera_attr_af_mode_e mode, void *user_data);
 
 /**
- * @brief Called to get each supported exposure mode.
+ * @brief Invoked to get each supported exposure mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] mode      The supported exposure mode
  * @param[in] user_data The user data passed from the foreach function
@@ -2356,7 +2364,7 @@ typedef bool (*camera_attr_supported_af_mode_cb)(camera_attr_af_mode_e mode, voi
 typedef bool (*camera_attr_supported_exposure_mode_cb)(camera_attr_exposure_mode_e mode, void *user_data);
 
 /**
- * @brief Called to get each supported ISO mode.
+ * @brief Invoked to get each supported ISO mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] iso       The supported ISO mode
  * @param[in] user_data The user data passed from the foreach function
@@ -2367,7 +2375,7 @@ typedef bool (*camera_attr_supported_exposure_mode_cb)(camera_attr_exposure_mode
 typedef bool (*camera_attr_supported_iso_cb)(camera_attr_iso_e iso, void *user_data);
 
 /**
- * @brief Called to get each supported white balance.
+ * @brief Invoked to get each supported white balance.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] wb        The supported white balance mode
  * @param[in] user_data The user data passed from the foreach function
@@ -2379,7 +2387,7 @@ typedef bool (*camera_attr_supported_iso_cb)(camera_attr_iso_e iso, void *user_d
 typedef bool (*camera_attr_supported_whitebalance_cb)(camera_attr_whitebalance_e wb, void *user_data);
 
 /**
- * @brief Called to get each supported effect mode.
+ * @brief Invoked to get each supported effect mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] effect    The supported effect mode
  * @param[in] user_data The user data passed from the foreach function
@@ -2390,7 +2398,7 @@ typedef bool (*camera_attr_supported_whitebalance_cb)(camera_attr_whitebalance_e
 typedef bool (*camera_attr_supported_effect_cb)(camera_attr_effect_mode_e effect, void *user_data);
 
 /**
- * @brief Called to get each supported scene mode.
+ * @brief Invoked to get each supported scene mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] mode      The supported scene mode
  * @param[in] user_data The user data passed from the foreach function
@@ -2402,7 +2410,7 @@ typedef bool (*camera_attr_supported_effect_cb)(camera_attr_effect_mode_e effect
 typedef bool (*camera_attr_supported_scene_mode_cb)(camera_attr_scene_mode_e mode, void *user_data);
 
 /**
- * @brief Called to get each supported flash mode.
+ * @brief Invoked to get each supported flash mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] mode      The supported flash mode
  * @param[in] user_data The user data passed from the foreach function
@@ -2413,7 +2421,7 @@ typedef bool (*camera_attr_supported_scene_mode_cb)(camera_attr_scene_mode_e mod
 typedef bool (*camera_attr_supported_flash_mode_cb)(camera_attr_flash_mode_e mode, void *user_data);
 
 /**
- * @brief Called to get each supported FPS mode.
+ * @brief Invoked to get each supported FPS mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] fps       The supported FPS mode
  * @param[in] user_data The user data passed from the foreach function
@@ -2424,7 +2432,7 @@ typedef bool (*camera_attr_supported_flash_mode_cb)(camera_attr_flash_mode_e mod
 typedef bool (*camera_attr_supported_fps_cb)(camera_attr_fps_e fps, void *user_data);
 
 /**
- * @brief Called to get each supported stream flip mode.
+ * @brief Invoked to get each supported stream flip mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] flip      The supported stream flip mode
  * @param[in] user_data The user data passed from the foreach function
@@ -2435,7 +2443,7 @@ typedef bool (*camera_attr_supported_fps_cb)(camera_attr_fps_e fps, void *user_d
 typedef bool (*camera_attr_supported_stream_flip_cb)(camera_flip_e flip, void *user_data);
 
 /**
- * @brief Called to get each supported stream rotation mode.
+ * @brief Invoked to get each supported stream rotation mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] rotation  The supported stream rotation mode
  * @param[in] user_data The user data passed from the foreach function
@@ -2446,7 +2454,7 @@ typedef bool (*camera_attr_supported_stream_flip_cb)(camera_flip_e flip, void *u
 typedef bool (*camera_attr_supported_stream_rotation_cb)(camera_rotation_e rotation, void *user_data);
 
 /**
- * @brief Called to get each supported theater mode.
+ * @brief Invoked to get each supported theater mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] mode      The supported theater mode
  * @param[in] user_data The user data passed from the foreach function
@@ -2457,7 +2465,7 @@ typedef bool (*camera_attr_supported_stream_rotation_cb)(camera_rotation_e rotat
 typedef bool (*camera_attr_supported_theater_mode_cb)(camera_attr_theater_mode_e mode, void *user_data);
 
 /**
- * @brief Called to get each supported PTZ (Pan Tilt Zoom) type.
+ * @brief Invoked to get each supported PTZ (Pan Tilt Zoom) type.
  * @since_tizen 3.0
  * @param[in] type      The supported ptz type
  * @param[in] user_data The user data passed from the foreach function
@@ -2486,9 +2494,9 @@ typedef bool (*camera_attr_supported_ptz_type_cb)(camera_attr_ptz_type_e type, v
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED.
  * @see camera_start_preview()
@@ -2505,8 +2513,8 @@ int camera_attr_set_preview_fps(camera_h camera, camera_attr_fps_e fps);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_preview_fps()
  * @see camera_attr_foreach_supported_fps()
@@ -2522,8 +2530,8 @@ int camera_attr_get_preview_fps(camera_h camera, camera_attr_fps_e *fps);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_get_extra_preview_bitrate()
  */
@@ -2538,8 +2546,8 @@ int camera_attr_set_extra_preview_bitrate(camera_h camera, int stream_id, int bi
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_extra_preview_bitrate()
  */
@@ -2556,8 +2564,8 @@ int camera_attr_get_extra_preview_bitrate(camera_h camera, int stream_id, int *b
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_get_extra_preview_gop_interval()
  */
@@ -2572,8 +2580,8 @@ int camera_attr_set_extra_preview_gop_interval(camera_h camera, int stream_id, i
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_extra_preview_gop_interval()
  */
@@ -2588,8 +2596,8 @@ int camera_attr_get_extra_preview_gop_interval(camera_h camera, int stream_id, i
  * @param[out] rotation The rotation of preview frame
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  */
 int camera_attr_get_preview_frame_rotation(camera_h camera, camera_rotation_e *rotation);
@@ -2607,13 +2615,13 @@ int camera_attr_get_preview_frame_rotation(camera_h camera, camera_rotation_e *r
  * @brief Retrieves all supported FPS modes by invoking the callback function once for each supported FPS mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to invoke
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_attr_supported_fps_cb() repeatedly to get each supported FPS mode.
  * @see camera_attr_set_preview_fps()
@@ -2623,18 +2631,18 @@ int camera_attr_get_preview_frame_rotation(camera_h camera, camera_rotation_e *r
 int camera_attr_foreach_supported_fps(camera_h camera, camera_attr_supported_fps_cb callback, void *user_data);
 
 /**
- * @brief Retrieves all supported FPS modes by invoking the callback function once for each supported FPS mode.
+ * @brief Retrieves all supported FPS modes by invoking the callback function once for each supported FPS mode by resolution.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @param[in] camera    The handle to the camera
  * @param[in] width     Required preview resolution's width
  * @param[in] height    Required preview resolution's height
- * @param[in] callback  The callback function to invoke
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_attr_supported_fps_cb() repeatedly to get each supported FPS mode.
  * @see camera_attr_set_preview_fps()
@@ -2661,9 +2669,9 @@ int camera_attr_foreach_supported_fps_by_resolution(camera_h camera, int width,
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_start_preview()
@@ -2679,8 +2687,8 @@ int camera_attr_set_image_quality(camera_h camera, int quality);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_image_quality()
  */
@@ -2694,8 +2702,8 @@ int camera_attr_get_image_quality(camera_h camera, int *quality);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_encoded_preview_bitrate()
  */
@@ -2711,8 +2719,8 @@ int camera_attr_get_encoded_preview_bitrate(camera_h camera, int *bitrate);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_get_encoded_preview_bitrate()
  */
@@ -2726,8 +2734,8 @@ int camera_attr_set_encoded_preview_bitrate(camera_h camera, int bitrate);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_encoded_preview_gop_interval()
  */
@@ -2743,8 +2751,8 @@ int camera_attr_get_encoded_preview_gop_interval(camera_h camera, int *interval)
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_get_encoded_preview_gop_interval()
  */
@@ -2759,9 +2767,9 @@ int camera_attr_set_encoded_preview_gop_interval(camera_h camera, int interval);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_get_zoom()
@@ -2777,8 +2785,8 @@ int camera_attr_set_zoom(camera_h camera, int zoom);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_zoom()
  * @see camera_attr_get_zoom_range()
@@ -2795,8 +2803,8 @@ int camera_attr_get_zoom(camera_h camera, int *zoom);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_zoom()
  * @see camera_attr_get_zoom()
@@ -2812,9 +2820,9 @@ int camera_attr_get_zoom_range(camera_h camera, int *min, int *max);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_get_af_mode()
@@ -2831,8 +2839,8 @@ int camera_attr_set_af_mode(camera_h camera, camera_attr_af_mode_e mode);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_foreach_supported_af_mode()
  * @see camera_attr_set_af_mode()
@@ -2843,7 +2851,7 @@ int camera_attr_get_af_mode(camera_h camera, camera_attr_af_mode_e *mode);
 /**
  * @brief Sets auto focus area.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @remarks This API is invalid in the #CAMERA_ATTR_AF_NONE mode.\n
+ * @remarks It will return #CAMERA_ERROR_INVALID_OPERATION in the #CAMERA_ATTR_AF_NONE mode.\n
  *          The coordinates are mapped to preview area.
  * @param[in] camera The handle to the camera
  * @param[in] x      The x coordinates of the focus area
@@ -2851,10 +2859,10 @@ int camera_attr_get_af_mode(camera_h camera, camera_attr_af_mode_e *mode);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_set_af_mode()
@@ -2870,9 +2878,9 @@ int camera_attr_set_af_area(camera_h camera, int x, int y);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_af_mode()
  * @see camera_attr_set_af_area()
@@ -2892,13 +2900,13 @@ int camera_attr_clear_af_area(camera_h camera);
  * @brief Retrieves all supported auto focus modes by invoking the callback function once for each supported auto focus mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to invoke
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_attr_supported_af_mode_cb() to get all the supported auto focus modes.
  * @see camera_attr_set_af_mode()
@@ -2924,9 +2932,9 @@ int camera_attr_foreach_supported_af_mode(camera_h camera, camera_attr_supported
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_get_exposure_mode()
@@ -2942,8 +2950,8 @@ int camera_attr_set_exposure_mode(camera_h camera, camera_attr_exposure_mode_e m
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_exposure_mode()
  * @see camera_attr_foreach_supported_exposure_mode()
@@ -2968,8 +2976,8 @@ int camera_attr_get_exposure_mode(camera_h camera, camera_attr_exposure_mode_e *
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_attr_supported_exposure_mode_cb() to get all the supported exposure modes.
  * @see camera_attr_set_exposure_mode()
@@ -2995,8 +3003,8 @@ int camera_attr_foreach_supported_exposure_mode(camera_h camera, camera_attr_sup
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_get_exposure()
  */
@@ -3010,8 +3018,8 @@ int camera_attr_set_exposure(camera_h camera, int value);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_exposure()
  */
@@ -3027,8 +3035,8 @@ int camera_attr_get_exposure(camera_h camera, int *value);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_exposure()
  */
@@ -3042,9 +3050,9 @@ int camera_attr_get_exposure_range(camera_h camera, int *min, int *max);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_get_iso()
@@ -3060,8 +3068,8 @@ int camera_attr_set_iso(camera_h camera, camera_attr_iso_e iso);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_iso()
  * @see camera_attr_foreach_supported_iso()
@@ -3154,8 +3162,8 @@ int camera_attr_get_gain_step(camera_h camera, int *step);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_attr_supported_iso_cb() to get all the supported ISO levels.
  * @see camera_attr_set_iso()
@@ -3182,8 +3190,8 @@ int camera_attr_foreach_supported_iso(camera_h camera, camera_attr_supported_iso
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre This function is valid only when the external display is connected.
  * @see camera_attr_get_theater_mode()
@@ -3198,8 +3206,8 @@ int camera_attr_set_theater_mode(camera_h camera, camera_attr_theater_mode_e mod
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_theater_mode()
  */
@@ -3223,8 +3231,8 @@ int camera_attr_get_theater_mode(camera_h camera, camera_attr_theater_mode_e *mo
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_attr_supported_theater_mode_cb() to get all supported theater modes.
  * @see camera_attr_set_theater_mode()
@@ -3253,9 +3261,9 @@ int camera_attr_foreach_supported_theater_mode(camera_h camera, camera_attr_supp
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_get_brightness()
@@ -3271,8 +3279,8 @@ int camera_attr_set_brightness(camera_h camera, int level);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_brightness()
  * @see camera_attr_get_brightness_range()
@@ -3289,8 +3297,8 @@ int camera_attr_get_brightness(camera_h camera, int *level);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_brightness()
  * @see camera_attr_get_brightness()
@@ -3305,9 +3313,9 @@ int camera_attr_get_brightness_range(camera_h camera, int *min, int *max);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_get_contrast()
@@ -3323,8 +3331,8 @@ int camera_attr_set_contrast(camera_h camera, int level);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_contrast()
  * @see camera_attr_get_contrast_range()
@@ -3341,8 +3349,8 @@ int camera_attr_get_contrast(camera_h camera, int *level);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_contrast()
  * @see camera_attr_get_contrast()
@@ -3401,9 +3409,9 @@ int camera_attr_get_hue_range(camera_h camera, int *min, int *max);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_foreach_supported_whitebalance()
@@ -3419,8 +3427,8 @@ int camera_attr_set_whitebalance(camera_h camera, camera_attr_whitebalance_e whi
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_foreach_supported_whitebalance()
  * @see camera_attr_set_whitebalance()
@@ -3605,8 +3613,8 @@ int camera_attr_get_sharpness_range(camera_h camera, int *min, int *max);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_attr_supported_whitebalance_cb() to get all the supported white balances.
  * @see camera_attr_set_whitebalance()
@@ -3632,9 +3640,9 @@ int camera_attr_foreach_supported_whitebalance(camera_h camera, camera_attr_supp
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_foreach_supported_effect()
@@ -3651,8 +3659,8 @@ int camera_attr_set_effect(camera_h camera, camera_attr_effect_mode_e effect);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_foreach_supported_effect()
  * @see camera_attr_set_effect()
@@ -3672,13 +3680,13 @@ int camera_attr_get_effect(camera_h camera, camera_attr_effect_mode_e *effect);
  * @brief Retrieves all supported effect modes by invoking the callback function once for each supported effect mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to invoke
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_attr_supported_effect_cb() to get all the supported effect modes.
  * @see camera_attr_set_effect()
@@ -3704,9 +3712,9 @@ int camera_attr_foreach_supported_effect(camera_h camera, camera_attr_supported_
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_foreach_supported_scene_mode()
@@ -3722,8 +3730,8 @@ int camera_attr_set_scene_mode(camera_h camera, camera_attr_scene_mode_e mode);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_foreach_supported_scene_mode()
  * @see camera_attr_set_scene_mode()
@@ -3743,13 +3751,13 @@ int camera_attr_get_scene_mode(camera_h camera, camera_attr_scene_mode_e *mode);
  * @brief Retrieves all supported scene modes by invoking the callback function once for each supported scene mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to invoke
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_attr_supported_scene_mode_cb() to get all the supported scene modes.
  * @see camera_attr_set_scene_mode()
@@ -3768,52 +3776,52 @@ int camera_attr_foreach_supported_scene_mode(camera_h camera, camera_attr_suppor
  */
 
 /**
- * @brief Enables to write EXIF(Exchangeable image file format) tags in a JPEG file.
+ * @brief Enables to write EXIF (Exchangeable image file format) tags in a JPEG file.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera The handle to the camera
  * @param[in] enable If @c true writing EXIF tags in a JPEG file is enabled, otherwise @c false
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see         camera_attr_is_enabled_tag()
  */
 int camera_attr_enable_tag(camera_h camera, bool enable);
 
 /**
- * @brief Gets the value that indicates whether writing EXIF(Exchangeable image file format) tags in a JPEG file is enabled.
+ * @brief Gets the value that indicates whether writing EXIF (Exchangeable image file format) tags in a JPEG file is enabled.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in]  camera   The handle to the camera
  * @param[out] enabled  If @c true camera information is enabled, otherwise @c false
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see         camera_attr_enable_tag()
  */
 int camera_attr_is_enabled_tag(camera_h camera, bool *enabled);
 
 /**
- * @brief Sets the camera image description in the EXIF(Exchangeable image file format) tag.
+ * @brief Sets the camera image description in the EXIF (Exchangeable image file format) tag.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera      The handle to the camera
  * @param[in] description The string with description
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_get_tag_image_description()
  */
 int camera_attr_set_tag_image_description(camera_h camera, const char *description);
 
 /**
- * @brief Gets the camera image description in EXIF(Exchangeable image file format) tag.
+ * @brief Gets the camera image description in EXIF (Exchangeable image file format) tag.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks You must release @a description using free().
  * @param[in]  camera      The handle to the camera
@@ -3821,60 +3829,60 @@ int camera_attr_set_tag_image_description(camera_h camera, const char *descripti
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_tag_image_description()
  */
 int camera_attr_get_tag_image_description(camera_h camera, char **description);
 
 /**
- * @brief Sets the camera orientation in the EXIF(Exchangeable image file format) tag.
+ * @brief Sets the camera orientation in the EXIF (Exchangeable image file format) tag.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera      The handle to the camera
  * @param[in] orientation The camera orientation
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_get_tag_orientation()
  */
 int camera_attr_set_tag_orientation(camera_h camera, camera_attr_tag_orientation_e orientation);
 
 /**
- * @brief Gets the camera orientation in the EXIF(Exchangeable image file format) tag.
+ * @brief Gets the camera orientation in the EXIF (Exchangeable image file format) tag.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in]  camera      The handle to the camera
  * @param[out] orientation The camera orientation
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_tag_orientation()
  */
 int camera_attr_get_tag_orientation(camera_h camera, camera_attr_tag_orientation_e *orientation);
 
 /**
- * @brief Sets the software information in the EXIF(Exchangeable image file format) tag.
+ * @brief Sets the software information in the EXIF (Exchangeable image file format) tag.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera   The handle to the camera
  * @param[in] software The software information tag
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_get_tag_software()
  */
 int camera_attr_set_tag_software(camera_h camera, const char *software);
 
 /**
- * @brief Gets the software information in the EXIF(Exchangeable image file format) tag.
+ * @brief Gets the software information in the EXIF (Exchangeable image file format) tag.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks You must release @a software using free().
  * @param[in]  camera   The handle to the camera
@@ -3882,15 +3890,15 @@ int camera_attr_set_tag_software(camera_h camera, const char *software);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_tag_software()
  */
 int camera_attr_get_tag_software(camera_h camera, char **software);
 
 /**
- * @brief Sets the geotag(GPS data) in the EXIF(Exchangeable image file format) tag.
+ * @brief Sets the geotag (GPS data) in the EXIF (Exchangeable image file format) tag.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera    The handle to the camera
  * @param[in] latitude  The latitude data
@@ -3899,9 +3907,9 @@ int camera_attr_get_tag_software(camera_h camera, char **software);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_get_geotag()
@@ -3910,7 +3918,7 @@ int camera_attr_get_tag_software(camera_h camera, char **software);
 int camera_attr_set_geotag(camera_h camera, double latitude, double longitude, double altitude);
 
 /**
- * @brief Gets the geotag(GPS data) in the EXIF(Exchangeable image file format) tag.
+ * @brief Gets the geotag (GPS data) in the EXIF (Exchangeable image file format) tag.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in]  camera    The handle to the camera
  * @param[out] latitude  The latitude data
@@ -3919,8 +3927,8 @@ int camera_attr_set_geotag(camera_h camera, double latitude, double longitude, d
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_geotag()
  * @see camera_attr_remove_geotag()
@@ -3928,15 +3936,15 @@ int camera_attr_set_geotag(camera_h camera, double latitude, double longitude, d
 int camera_attr_get_geotag(camera_h camera, double *latitude, double *longitude, double *altitude);
 
 /**
- * @brief Removes the geotag(GPS data) in the EXIF(Exchangeable image file format) tag.
+ * @brief Removes the geotag (GPS data) in the EXIF (Exchangeable image file format) tag.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera The handle to the camera
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_set_geotag()
@@ -3954,9 +3962,9 @@ int camera_attr_remove_geotag(camera_h camera);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @retval #CAMERA_ERROR_DEVICE_BUSY The flash was preempted by other API
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
@@ -3973,8 +3981,8 @@ int camera_attr_set_flash_mode(camera_h camera, camera_attr_flash_mode_e mode);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_foreach_supported_flash_mode()
  * @see camera_attr_set_flash_mode()
@@ -3994,13 +4002,13 @@ int camera_attr_get_flash_mode(camera_h camera, camera_attr_flash_mode_e *mode);
  * @brief Retrieves all supported flash modes by invoking the callback function once for each supported flash mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to invoke
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data passed to the callback registration function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_attr_supported_flash_mode_cb() to get all supported flash modes.
  * @see camera_attr_set_flash_mode()
@@ -4026,8 +4034,8 @@ int camera_attr_foreach_supported_flash_mode(camera_h camera, camera_attr_suppor
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_set_display_rotation()
  */
@@ -4041,8 +4049,8 @@ int camera_attr_get_lens_orientation(camera_h camera, int *angle);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED.
  * @see camera_attr_get_stream_rotation()
@@ -4057,8 +4065,8 @@ int camera_attr_set_stream_rotation(camera_h camera, camera_rotation_e rotation)
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED.
  * @see camera_attr_set_stream_rotation()
@@ -4078,13 +4086,13 @@ int camera_attr_get_stream_rotation(camera_h camera, camera_rotation_e *rotation
  * @brief Retrieves all supported stream rotation modes by invoking callback function once for each supported stream rotation mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to invoke
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_attr_supported_stream_rotation_cb() to get all supported stream rotation mode.
  * @see camera_attr_set_stream_rotation()
@@ -4110,9 +4118,9 @@ int camera_attr_foreach_supported_stream_rotation(camera_h camera, camera_attr_s
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED.
  * @see camera_attr_set_stream_rotation()
@@ -4127,8 +4135,8 @@ int camera_attr_set_stream_flip(camera_h camera, camera_flip_e flip);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED.
  * @see camera_attr_set_stream_rotation()
@@ -4148,13 +4156,13 @@ int camera_attr_get_stream_flip(camera_h camera, camera_flip_e *flip);
  * @brief Retrieves all supported stream flip modes by invoking callback function once for each supported stream flip mode.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to invoke
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parametergranted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_attr_supported_stream_flip_cb() to get all supported stream flip mode.
  * @see camera_attr_set_stream_flip()
@@ -4173,11 +4181,11 @@ int camera_attr_foreach_supported_stream_flip(camera_h camera, camera_attr_suppo
  */
 
 /**
- * @brief Called when the HDR capture process is updated.
+ * @brief Invoked when the HDR capture process is updated.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] percent   The progress percentage of HDR capture
  * @param[in] user_data The user data passed from the callback registration function
- * @pre camera_start_capture() will invoke this callback if you register it using camera_attr_set_hdr_capture_progress_cb().
+ * @pre camera_start_capture() will invoke this callback if you set it using camera_attr_set_hdr_capture_progress_cb().
  * @see camera_attr_get_hdr_mode()
  * @see camera_attr_set_hdr_capture_progress_cb()
  * @see camera_attr_unset_hdr_capture_progress_cb()
@@ -4196,9 +4204,9 @@ typedef void (*camera_attr_hdr_progress_cb)(int percent, void *user_data);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_get_hdr_mode()
@@ -4217,8 +4225,8 @@ int camera_attr_set_hdr_mode(camera_h camera, camera_attr_hdr_mode_e mode);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_hdr_mode()
  * @see camera_attr_set_hdr_capture_progress_cb()
@@ -4228,17 +4236,17 @@ int camera_attr_set_hdr_mode(camera_h camera, camera_attr_hdr_mode_e mode);
 int camera_attr_get_hdr_mode(camera_h camera, camera_attr_hdr_mode_e *mode);
 
 /**
- * @brief Registers a callback function to be called when HDR capture is progressing.
+ * @brief Sets a callback function to be invoked when HDR capture is progressing.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks This callback notifies progress of the HDR process.
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to invoke
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data passed to the callback registration function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_hdr_mode()
  * @see camera_attr_get_hdr_mode()
@@ -4248,14 +4256,14 @@ int camera_attr_get_hdr_mode(camera_h camera, camera_attr_hdr_mode_e *mode);
 int camera_attr_set_hdr_capture_progress_cb(camera_h camera, camera_attr_hdr_progress_cb callback, void* user_data);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the HDR capture progress callback function.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] camera The handle to the camera
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_hdr_mode()
  * @see camera_attr_get_hdr_mode()
@@ -4273,8 +4281,8 @@ int camera_attr_unset_hdr_capture_progress_cb(camera_h camera);
  * @return @c true if supported, otherwise @c false
  * @exception #CAMERA_ERROR_NONE Successful
  * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @see camera_attr_set_hdr_mode()
  * @see camera_attr_get_hdr_mode()
  * @see camera_attr_set_hdr_capture_progress_cb()
@@ -4291,8 +4299,8 @@ bool camera_attr_is_supported_hdr_capture(camera_h camera);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_is_enabled_anti_shake()
  * @see camera_attr_is_supported_anti_shake()
@@ -4308,8 +4316,8 @@ int camera_attr_enable_anti_shake(camera_h camera, bool enable);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_enable_anti_shake()
  * @see camera_attr_is_supported_anti_shake()
@@ -4325,8 +4333,8 @@ int camera_attr_is_enabled_anti_shake(camera_h camera, bool *enabled);
  * @return @c true if supported, otherwise @c false
  * @exception #CAMERA_ERROR_NONE Successful
  * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @see camera_attr_enable_anti_shake()
  * @see camera_attr_is_enabled_anti_shake()
  */
@@ -4342,8 +4350,8 @@ bool camera_attr_is_supported_anti_shake(camera_h camera);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_is_enabled_video_stabilization()
  * @see camera_attr_is_supported_video_stabilization()
@@ -4359,8 +4367,8 @@ int camera_attr_enable_video_stabilization(camera_h camera, bool enable);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_enable_video_stabilization()
  * @see camera_attr_is_supported_video_stabilization()
@@ -4376,8 +4384,8 @@ int camera_attr_is_enabled_video_stabilization(camera_h camera, bool *enabled);
  * @return @c true if supported, otherwise @c false
  * @exception #CAMERA_ERROR_NONE Successful
  * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @see camera_attr_enable_video_stabilization()
  * @see camera_attr_is_enabled_video_stabilization()
  */
@@ -4391,9 +4399,9 @@ bool camera_attr_is_supported_video_stabilization(camera_h camera);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW.
  * @see camera_attr_is_enabled_auto_contrast()
@@ -4408,8 +4416,8 @@ int camera_attr_enable_auto_contrast(camera_h camera, bool enable);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_enable_auto_contrast()
  */
@@ -4433,8 +4441,8 @@ int camera_attr_is_enabled_auto_contrast(camera_h camera, bool *enabled);
  * @return true on supported, otherwise false
  * @exception #CAMERA_ERROR_NONE Successful
  * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @see camera_attr_enable_auto_contrast()
  * @see camera_attr_is_enabled_auto_contrast()
  */
@@ -4458,9 +4466,9 @@ bool camera_attr_is_supported_auto_contrast(camera_h camera);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
+ * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_INVALID_OPERATION Disabling shutter sound is not permitted
- * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  */
 int camera_attr_disable_shutter_sound(camera_h camera, bool disable);
@@ -4469,13 +4477,13 @@ int camera_attr_disable_shutter_sound(camera_h camera, bool disable);
  * @brief Sets the position to move horizontally.
  * @since_tizen 3.0
  * @param[in] camera    The handle to the camera
- * @param[in] move_type The PTZ(Pan Tilt Zoom) move type
+ * @param[in] move_type The PTZ (Pan Tilt Zoom) move type
  * @param[in] pan_step  The step to move the camera
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_PREVIEW.
@@ -4485,15 +4493,15 @@ int camera_attr_disable_shutter_sound(camera_h camera, bool disable);
 int camera_attr_set_pan(camera_h camera, camera_attr_ptz_move_type_e move_type, int pan_step);
 
 /**
- * @brief Gets the current position of the camera.
+ * @brief Gets the current horizontal position of the camera.
  * @since_tizen 3.0
  * @param[in]  camera   The handle to the camera
  * @param[out] pan_step The current horizontal distance from the starting point.
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_pan()
  * @see camera_attr_get_pan_range()
@@ -4510,8 +4518,8 @@ int camera_attr_get_pan(camera_h camera, int *pan_step);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_pan()
  * @see camera_attr_get_pan()
@@ -4522,13 +4530,13 @@ int camera_attr_get_pan_range(camera_h camera, int *min, int *max);
  * @brief Sets the position to move vertically.
  * @since_tizen 3.0
  * @param[in] camera    The handle to the camera
- * @param[in] move_type The PTZ(Pan Tilt Zoom) move type
+ * @param[in] move_type The PTZ (Pan Tilt Zoom) move type
  * @param[in] tilt_step The step to move the camera
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_PREVIEW.
@@ -4538,15 +4546,15 @@ int camera_attr_get_pan_range(camera_h camera, int *min, int *max);
 int camera_attr_set_tilt(camera_h camera, camera_attr_ptz_move_type_e move_type, int tilt_step);
 
 /**
- * @brief Gets the current position of the camera.
+ * @brief Gets the current vertical position of the camera.
  * @since_tizen 3.0
  * @param[in]  camera    The handle to the camera
  * @param[out] tilt_step The current vertical distance from the starting point.
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_tilt()
  * @see camera_attr_get_tilt_range()
@@ -4563,8 +4571,8 @@ int camera_attr_get_tilt(camera_h camera, int *tilt_step);
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_tilt()
  * @see camera_attr_get_tilt()
@@ -4572,15 +4580,15 @@ int camera_attr_get_tilt(camera_h camera, int *tilt_step);
 int camera_attr_get_tilt_range(camera_h camera, int *min, int *max);
 
 /**
- * @brief Sets the type of PTZ(Pan Tilt Zoom).
+ * @brief Sets the type of PTZ (Pan Tilt Zoom).
  * @since_tizen 3.0
  * @param[in] camera   The handle to the camera
  * @param[in] ptz_type PTZ type
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_STATE Invalid state
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @pre The camera state must be set to #CAMERA_STATE_PREVIEW.
@@ -4604,16 +4612,16 @@ int camera_attr_set_ptz_type(camera_h camera, camera_attr_ptz_type_e ptz_type);
  */
 
 /**
- * @brief Retrieves all supported PTZ(Pan Tilt Zoom) types by invoking callback function once for each supported ptz type.
+ * @brief Retrieves all supported PTZ (Pan Tilt Zoom) types by invoking callback function once for each supported ptz type.
  * @since_tizen 3.0
  * @param[in] camera    The handle to the camera
- * @param[in] callback  The callback function to invoke
+ * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted
+ * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @post This function invokes camera_attr_supported_ptz_type_cb() to get all supported ptz type.
  * @see camera_attr_set_ptz_type()
@@ -4630,7 +4638,7 @@ int camera_attr_foreach_supported_ptz_type(camera_h camera, camera_attr_supporte
  */
 
 /**
- * @brief Sets the ROI(Region Of Interest) area of display.
+ * @brief Sets the ROI (Region Of Interest) area of display.
  * @since_tizen 3.0
  * @remarks If no display is set, no operation is performed and
  *          the ROI area is valid only in #CAMERA_DISPLAY_MODE_CUSTOM_ROI display mode.
@@ -4644,15 +4652,15 @@ int camera_attr_foreach_supported_ptz_type(camera_h camera, camera_attr_supporte
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_get_display_roi_area()
  */
 int camera_attr_set_display_roi_area(camera_h camera, int x, int y, int width, int height);
 
 /**
- * @brief Gets the ROI(Region Of Interest) area of display.
+ * @brief Gets the ROI (Region Of Interest) area of display.
  * @since_tizen 3.0
  * @param[in]  camera The handle to the camera
  * @param[out] x      X coordinate of area
@@ -4662,8 +4670,8 @@ int camera_attr_set_display_roi_area(camera_h camera, int x, int y, int width, i
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CAMERA_ERROR_NONE Successful
  * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported
- * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error
  * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
  * @see camera_attr_set_display_roi_area()
  */
diff --git a/packaging/capi-media-camera.spec b/packaging/capi-media-camera.spec
index b16d768..0e65914 100644
--- a/packaging/capi-media-camera.spec
+++ b/packaging/capi-media-camera.spec
@@ -1,6 +1,6 @@
 Name:       capi-media-camera
 Summary:    A Camera API
-Version:    0.4.102
+Version:    0.4.103
 Release:    0
 Group:      Multimedia/API
 License:    Apache-2.0