From: Eunhae Choi <eunhae1.choi@samsung.com>
Date: Mon, 12 Feb 2018 10:01:13 +0000 (+0900)
Subject: [0.3.83] apply the api reference guildline compliance
X-Git-Tag: submit/tizen/20180228.035826~1
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=10d6de3028f0a4ed04ca3a672048f368bb71ab04;p=platform%2Fcore%2Fapi%2Fplayer.git

[0.3.83] apply the api reference guildline compliance

Change-Id: Id5a3bf97ff39bafda2f393d163315d328362e6dd
---

diff --git a/include/player.h b/include/player.h
index 347a0ba..2dbfe7a 100644
--- a/include/player.h
+++ b/include/player.h
@@ -25,9 +25,16 @@
 extern "C" {
 #endif
 
+/**
+ * @brief The player error class define.
+ * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
+ */
 #define PLAYER_ERROR_CLASS          TIZEN_ERROR_PLAYER | 0x20
 
-/* This is for custom defined player error. */
+/**
+ * @brief The player custom error class define.
+ * @since_tizen 3.0
+ */
 #define PLAYER_CUSTOM_ERROR_CLASS   TIZEN_ERROR_PLAYER | 0x1000
 
 /**
@@ -251,9 +258,11 @@ typedef enum {
 /**
  * @brief  Called when the subtitle is updated.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @param[in]   duration	The duration of the updated subtitle
- * @param[in]   text		The text of the updated subtitle
- * @param[in]   user_data	The user data passed from the callback registration function
+ * @remarks The @a text should not be released and it can be used only in the callback.
+ *          To use outside, make a copy.
+ * @param[in] duration    The duration of the updated subtitle
+ * @param[in] text        The text of the updated subtitle
+ * @param[in] user_data   The user data passed from the callback registration function
  * @see player_set_subtitle_updated_cb()
  * @see player_unset_subtitle_updated_cb()
  */
@@ -328,8 +337,8 @@ typedef void (*player_interrupted_cb)(player_interrupted_code_e code, void *user
  *          #PLAYER_ERROR_NOT_SUPPORTED_VIDEO_CODEC (Since 4.0)
  *          #PLAYER_ERROR_NOT_SUPPORTED_SUBTITLE (Since 4.0)
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @param[in]	error_code  The error code
- * @param[in]	user_data	The user data passed from the callback registration function
+ * @param[in] error_code  The error code
+ * @param[in] user_data   The user data passed from the callback registration function
  * @see player_set_error_cb()
  * @see player_unset_error_cb()
  */
@@ -339,8 +348,8 @@ typedef void (*player_error_cb)(int error_code, void *user_data);
  * @brief Called when the buffering percentage of the media playback is updated.
  * @details If the buffer is full, it will return 100%.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @param[in]   percent	The percentage of buffering completed (0~100)
- * @param[in]   user_data	The user data passed from the callback registration function
+ * @param[in] percent     The percentage of buffering completed (0~100)
+ * @param[in] user_data   The user data passed from the callback registration function
  * @see player_set_buffering_cb()
  * @see player_unset_buffering_cb()
  */
@@ -349,8 +358,8 @@ typedef void (*player_buffering_cb)(int percent, void *user_data);
 /**
  * @brief Called when progressive download is started or completed.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @param[in]   type		The message type for progressive download
- * @param[in]   user_data	The user data passed from the callback registration function
+ * @param[in] type        The message type for progressive download
+ * @param[in] user_data   The user data passed from the callback registration function
  */
 typedef void (*player_pd_message_cb)(player_pd_message_type_e type, void *user_data);
 
@@ -358,32 +367,33 @@ typedef void (*player_pd_message_cb)(player_pd_message_type_e type, void *user_d
  * @brief Called when the video is captured.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @remarks The color space format of the captured image is IMAGE_UTIL_COLORSPACE_RGB888.
- * @param[in]   data	The captured image buffer
- * @param[in]   width	The width of the captured image
- * @param[in]   height  The height of the captured image
- * @param[in]   size	The size of the captured image
- * @param[in]   user_data	The user data passed from the callback registration function
+ * @remarks The @a captured_data should not be released and it can be used only in the callback.
+ *          To use outside, make a copy.
+ * @param[in] captured_data     The captured image buffer
+ * @param[in] width             The width of the captured image
+ * @param[in] height            The height of the captured image
+ * @param[in] size              The size of the captured image
+ * @param[in] user_data         The user data passed from the callback registration function
  * @see player_capture_video()
  */
-typedef void (*player_video_captured_cb)(unsigned char *data, int width, int height, unsigned int size, void *user_data);
+typedef void (*player_video_captured_cb)(unsigned char *captured_data, int width, int height, unsigned int size, void *user_data);
 
 /**
  * @brief Called to register for notifications about delivering media packet when every video frame is decoded.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- *
- * @remarks This function is called in the context of gstreamer so the UI update code must not be directly invoked.\n
- *          The packet must be released after use by calling media_packet_destroy(). \n
+ * @remarks The UI update code must not be directly invoked.\n
+ * @remarks The @a packet should be released using media_packet_destroy(). \n
  *          If not, the decoder will fail due to having insufficient buffer space for the decoded frame.
  *
- * @param[in] pkt Reference pointer to the media packet
- * @param[in] user_data The user data passed from the callback registration function
+ * @param[in] packet      Reference pointer to the media packet
+ * @param[in] user_data   The user data passed from the callback registration function
  */
-typedef void (*player_media_packet_video_decoded_cb)(media_packet_h pkt, void *user_data);
+typedef void (*player_media_packet_video_decoded_cb)(media_packet_h packet, void *user_data);
 
 /**
  * @brief Called when the buffer level drops below the threshold of max size or no free space in buffer.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @remarks This API is used for media stream playback only.
+ * @remarks This function is used for media stream playback only.
  * @param[in] status The buffer status
  * @param[in] user_data The user data passed from the callback registration function
  * @see player_set_media_stream_buffer_status_cb()
@@ -396,7 +406,7 @@ typedef void (*player_media_stream_buffer_status_cb) (player_media_stream_buffer
  * @brief Called to notify the next push-buffer offset when seeking is occurred.
  * @details The next push-buffer should produce buffers from the new offset.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @remarks This API is used for media stream playback only.
+ * @remarks This function is used for media stream playback only.
  * @param[in] offset The new byte position to seek
  * @param[in] user_data The user data passed from the callback registration function
  */
@@ -406,13 +416,13 @@ typedef void (*player_media_stream_seek_cb) (unsigned long long offset, void *us
  * @brief Called to notify the video stream changed.
  * @details The video stream changing is detected just before rendering operation.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @param[in] width	The width of the captured image
- * @param[in] height The height of the captured image
- * @param[in] fps The frame per second of the video \n
- *            It can be @c 0 if there is no video stream information.
- * @param[in] bit_rate The video bit rate [Hz] \n
- *            It can be an invalid value if there is no video stream information.
- * @param[in] user_data The user data passed from the callback registration function
+ * @param[in] width       The width of the captured image
+ * @param[in] height      The height of the captured image
+ * @param[in] fps         The frame per second of the video \n
+ *                        It can be @c 0 if there is no video stream information.
+ * @param[in] bit_rate    The video bit rate [Hz] \n
+ *                        It can be an invalid value if there is no video stream information.
+ * @param[in] user_data   The user data passed from the callback registration function
  * @see player_set_video_stream_changed_cb()
  */
 typedef void (*player_video_stream_changed_cb) (int width, int height, int fps, int bit_rate, void *user_data);
@@ -422,10 +432,10 @@ typedef void (*player_video_stream_changed_cb) (int width, int height, int fps,
  * @details The adaptive streaming protocol(hls, mpeg dash) can support variant stream condition.
  *          All the streaming variant information can be shared by calling player_foreach_adaptive_variant().
  * @since_tizen 4.0
- * @param[in] bandwidth The bandwidth of the stream can be supportable, this is mandatory parameter
- * @param[in] width The width of the stream, this is optional parameter
- * @param[in] height The height of the stream, this is optional parameter
- * @param[in] user_data The user data passed from the callback registration function
+ * @param[in] bandwidth   The bandwidth of the stream can be supportable, this is mandatory parameter
+ * @param[in] width       The width of the stream, this is optional parameter
+ * @param[in] height      The height of the stream, this is optional parameter
+ * @param[in] user_data   The user data passed from the callback registration function
  * @see player_foreach_adaptive_variant()
  */
 typedef void (*player_adaptive_variant_cb) (int bandwidth, int width, int height, void *user_data);
@@ -438,7 +448,7 @@ typedef void (*player_adaptive_variant_cb) (int bandwidth, int width, int height
  *          the player cannot guarantee proper operation because of limited resources, such as
  *          audio or display device.
  *
- * @param[out]  player  A new handle to the media player
+ * @param[out] player   A new handle to the media player
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -455,7 +465,7 @@ int player_create(player_h *player);
  * @brief Destroys the media player handle and releases all its resources.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @remarks To completely shutdown player operation, call this function with a valid player handle from any player state.
- * @param[in] player The handle to the media player to be destroyed
+ * @param[in] player   The handle to the media player to be destroyed
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -473,7 +483,7 @@ int player_destroy(player_h player);
  * @remarks The mediastorage privilege(http://tizen.org/privilege/mediastorage) must be added if any video/audio files are used to play located in the internal storage.
  * @remarks The externalstorage privilege(http://tizen.org/privilege/externalstorage) must be added if any video/audio files are used to play located in the external storage.
  * @remarks The internet privilege(http://tizen.org/privilege/internet) must be added if any URLs are used to play from network.
- * @param[in]	player The handle to the media player
+ * @param[in] player   The handle to the media player
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -486,7 +496,7 @@ int player_destroy(player_h player);
  * @retval #PLAYER_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PLAYER_ERROR_NOT_SUPPORTED_AUDIO_CODEC Not support audio codec format (Since 4.0)
  * @retval #PLAYER_ERROR_NOT_SUPPORTED_VIDEO_CODEC Not support video codec format (Since 4.0)
- * @pre	The player state must be set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare(). After that, call player_set_uri() to load the media content you want to play.
+ * @pre The player state must be set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare(). After that, call player_set_uri() to load the media content you want to play.
  * @post The player state will be #PLAYER_STATE_READY.
  * @see player_prepare_async()
  * @see player_unprepare()
@@ -500,9 +510,9 @@ int player_prepare(player_h player);
  * @remarks The mediastorage privilege(http://tizen.org/privilege/mediastorage) must be added if any video/audio files are used to play located in the internal storage.
  * @remarks The externalstorage privilege(http://tizen.org/privilege/externalstorage) must be added if any video/audio files are used to play located in the external storage.
  * @remarks The internet privilege(http://tizen.org/privilege/internet) must be added if any URLs are used to play from network.
- * @param[in] player The handle to the media player
- * @param[in] callback	The callback function to register
- * @param[in] user_data	The user data to be passed to the callback function
+ * @param[in] player      The handle to the media player
+ * @param[in] callback    The callback function to register
+ * @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 #PLAYER_ERROR_NONE Successful
@@ -513,7 +523,7 @@ int player_prepare(player_h player);
  * @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation
  * @retval #PLAYER_ERROR_INVALID_STATE Invalid player state
  * @retval #PLAYER_ERROR_PERMISSION_DENIED Permission denied
- * @pre	The player state must be set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare(). After that, call player_set_uri() to load the media content you want to play.
+ * @pre The player state must be set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare(). After that, call player_set_uri() to load the media content you want to play.
  * @post It invokes player_prepared_cb() when playback is prepared.
  * @see player_prepare()
  * @see player_prepared_cb()
@@ -528,14 +538,14 @@ int player_prepare_async(player_h player, player_prepared_cb callback, void* use
  *          Playback is no longer possible. If you want to use the player again, you must set the data URI and call
  *          player_prepare() again.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @param[in] player The handle to the media player
+ * @param[in] player   The handle to the media player
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
  * @retval #PLAYER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation
  * @retval #PLAYER_ERROR_INVALID_STATE Invalid player state
- * @pre	The player state must be higher than #PLAYER_STATE_IDLE.
+ * @pre The player state must be higher than #PLAYER_STATE_IDLE.
  * @post The player state will be #PLAYER_STATE_IDLE.
  * @see player_prepare()
  */
@@ -549,13 +559,13 @@ int player_unprepare(player_h player);
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @remarks If you use HTTP or RTSP, URI must start with "http://" or "rtsp://". The default protocol is "file://".
  *          If you provide an invalid URI, you won't receive an error message until you call player_start().
- * @remarks This API must be called before calling the player_prepare() or player_prepare_async() to build the player based on the uri information.
+ * @remarks This function must be called before calling the player_prepare() or player_prepare_async() to build the player based on the URI information.
  * @remarks The mediastorage privilege(http://tizen.org/privilege/mediastorage) must be added if any video/audio files are used to play located in the internal storage.
  * @remarks The externalstorage privilege(http://tizen.org/privilege/externalstorage) must be added if any video/audio files are used to play located in the external storage.
  * @remarks The internet privilege(http://tizen.org/privilege/internet) must be added if any URLs are used to play from network.
  *
- * @param[in]   player The handle to the media player
- * @param[in]   uri The content location, such as the file path, the URI of the HTTP or RTSP stream you want to play
+ * @param[in] player   The handle to the media player
+ * @param[in] uri      The content location, such as the file path, the URI of the HTTP or RTSP stream you want to play
  *
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -577,19 +587,19 @@ int player_set_uri(player_h player, const char * uri);
  *          If the function call is successful, subsequent calls to player_prepare() and player_start() will start playing the media.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @remarks If you provide an invalid data, you won't receive an error message until you call player_start().
- * @remarks This API must be called before calling the player_prepare() or player_prepare_async()
+ * @remarks This function must be called before calling the player_prepare() or player_prepare_async()
  *          to build the player based on the data.
  *
- * @param[in]   player The handle to the media player
- * @param[in]   data The memory pointer of media data
- * @param[in]   size The size of media data
+ * @param[in] player   The handle to the media player
+ * @param[in] data     The memory pointer of media data
+ * @param[in] size     The size of media data
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
  * @retval #PLAYER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation
  * @retval #PLAYER_ERROR_INVALID_STATE Invalid player state
- * @pre	The player state must be set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare().
+ * @pre The player state must be set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare().
  * @see player_set_uri()
  */
 int player_set_memory_buffer(player_h player, const void * data, int size);
@@ -597,8 +607,8 @@ int player_set_memory_buffer(player_h player, const void * data, int size);
 /**
  * @brief Gets the player's current state.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @param[in]   player	The handle to the media player
- * @param[out]  state	The current state of the player
+ * @param[in]  player   The handle to the media player
+ * @param[out] state    The current state of the player
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -614,9 +624,9 @@ int player_get_state(player_h player, player_state_e *state);
  *           To change system volume, use the @ref CAPI_MEDIA_SOUND_MANAGER_MODULE API.
  *           Finally, it does not support to set other value into each channel currently.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @param[in]   player The handle to the media player
- * @param[in]   left The left volume scalar
- * @param[in]   right The right volume scalar
+ * @param[in] player   The handle to the media player
+ * @param[in] left     The left volume scalar
+ * @param[in] right    The right volume scalar
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -632,9 +642,9 @@ int player_set_volume(player_h player, float left, float right);
  *          This function gets the player volume, not the system volume.
  *          To get the system volume, use the @ref CAPI_MEDIA_SOUND_MANAGER_MODULE API.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @param[in]   player The handle to the media player
- * @param[out]  left The current left volume scalar
- * @param[out]  right The current right volume scalar
+ * @param[in]  player   The handle to the media player
+ * @param[out] left     The current left volume scalar
+ * @param[out] right    The current right volume scalar
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -670,7 +680,7 @@ int player_set_sound_type(player_h player, sound_type_e type) TIZEN_DEPRECATED_A
  * @since_tizen 3.0
  * @remarks You can set sound stream information including audio routing and volume type.
  *          For more details, please refer to sound_manager.h
- * @remarks This API must be called before calling the player_prepare() or player_prepare_async()
+ * @remarks This function must be called before calling the player_prepare() or player_prepare_async()
  *          to reflect the sound stream information when the player is building.
  * @remarks This function is related to the following feature:\n
  *          %http://tizen.org/feature/multimedia.player.stream_info\n
@@ -711,9 +721,9 @@ int player_set_sound_stream_info(player_h player, sound_stream_info_h stream_inf
  * @brief Sets the audio latency mode.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @remarks The default audio latency mode of the player is #AUDIO_LATENCY_MODE_MID.
- *		To get the current audio latency mode, use player_get_audio_latency_mode().
- *		If it's high mode, audio output interval can be increased so, it can keep more audio data to play.
- *		But, state transition like pause or resume can be more slower than default(mid) mode.
+ *          To get the current audio latency mode, use player_get_audio_latency_mode().
+ *          If it's high mode, audio output interval can be increased so, it can keep more audio data to play.
+ *          But, state transition like pause or resume can be more slower than default(mid) mode.
  *
  * @param[in] player The handle to the media player
  * @param[in] latency_mode The latency mode to be applied to the audio
@@ -795,7 +805,7 @@ int player_stop(player_h player);
 /**
  * @brief Pauses the player.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @remarks	You can resume playback using player_start().
+ * @remarks You can resume playback using player_start().
  *
  * @param[in]   player The handle to the media player
  * @return @c 0 on success,
@@ -814,22 +824,22 @@ int player_pause(player_h player);
 /**
  * @brief Sets the seek position for playback, asynchronously.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @remarks This api will trigger the seeking operation on player instance.
+ * @remarks This function will trigger the seeking operation on player instance.
  *          Normally application need to wait for player_seek_completed_cb() before calling it again.
  *          Otherwise it will return PLAYER_ERROR_SEEK_FAILED.
  *          Please note that if application is playing external media data via player_set_media_stream_info(),
- *          then consecutive calling of this api will always success and no need to wait for player_seek_completed_cb()
- *          before next calling of this api.(since_tizen 3.0)
+ *          then consecutive calling of this function will always success and no need to wait for player_seek_completed_cb()
+ *          before next calling of this function.(since_tizen 3.0)
  * @remarks Even if you don't set visible to true by calling player_set_display_visible,
  *          the video will be shown when the _seek_completed cb is invoked.
  * @remarks In case of non-seekable content, it will return PLAYER_ERROR_INVALID_OPERATION.
  *          If application ignore this error, player will keep playing without changing play position.
- * @param[in] player The handle to the media player
- * @param[in] millisecond The position in milliseconds from the start to the seek point
- * @param[in] accurate If @c true the selected position is returned, but this might be considerably slow,
- *                     if @c false the nearest key frame position is returned, but this might be faster but less accurate.
- * @param[in] callback	The callback function to register
- * @param[in] user_data	The user data to be passed to the callback function
+ * @param[in] player        The handle to the media player
+ * @param[in] millisecond   The position in milliseconds from the start to the seek point
+ * @param[in] accurate      If @c true the selected position is returned, but this might be considerably slow,
+ *                          if @c false the nearest key frame position is returned, but this might be faster but less accurate.
+ * @param[in] callback      The callback function to register
+ * @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 #PLAYER_ERROR_NONE Successful
@@ -936,7 +946,7 @@ int player_is_looping(player_h player, bool *looping);
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @remarks To get @a display to set, use #GET_DISPLAY().
  * @remarks We are not supporting changing display.
- * @remarks This API have be called before calling the player_prepare() or player_prepare_async() \n
+ * @remarks This function have be called before calling the player_prepare() or player_prepare_async() \n
  *          to reflect the display type.
  * @param[in]   player The handle to the media player
  * @param[in]   type The display type
@@ -947,7 +957,7 @@ int player_is_looping(player_h player, bool *looping);
  * @retval #PLAYER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation
  * @retval #PLAYER_ERROR_INVALID_STATE Invalid player state
- * @pre	The player state must be set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare().
+ * @pre The player state must be set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare().
  * @see #player_display_type_e
  * @see player_set_display_mode
  * @see player_set_display_roi_area
@@ -957,7 +967,7 @@ int player_is_looping(player_h player, bool *looping);
 int player_set_display(player_h player, player_display_type_e type, player_display_h display);
 
 /**
- * @brief Registers a media packet video callback function to be called once per frame.
+ * @brief Sets a media packet video callback function to be called once per frame.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @remarks This function must be called before calling player_prepare() or player_prepare_async().\n
  *          A registered callback is called in a separate thread (not in the main loop).\n
@@ -975,13 +985,13 @@ int player_set_display(player_h player, player_display_type_e type, player_displ
  * @retval #PLAYER_ERROR_NONE Successful
  * @retval #PLAYER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PLAYER_ERROR_INVALID_STATE Invalid state
- * @pre	The player's state must be #PLAYER_STATE_IDLE. And, #PLAYER_DISPLAY_TYPE_NONE must be set by calling player_set_display().
+ * @pre The player's state must be #PLAYER_STATE_IDLE. And, #PLAYER_DISPLAY_TYPE_NONE must be set by calling player_set_display().
  * @see player_unset_media_packet_video_frame_decoded_cb
  */
 int player_set_media_packet_video_frame_decoded_cb(player_h player, player_media_packet_video_decoded_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the media packet video frame callback function.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @param[in] player The handle to the media player
  * @return @c 0 on success,
@@ -996,9 +1006,9 @@ int player_unset_media_packet_video_frame_decoded_cb(player_h player);
 /**
  * @brief  Pushes elementary stream to decode audio or video.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @remarks player_set_media_stream_info() must be called before using this API.
- * @remarks The available buffer size can be set by calling player_set_media_stream_buffer_max_size() API.
- *          If there is no available buffer space, this api will return error since 3.0.
+ * @remarks player_set_media_stream_info() must be called before using this function.
+ * @remarks The available buffer size can be set by calling player_set_media_stream_buffer_max_size().
+ *          If there is no available buffer space, this function will return error since 3.0.
  * @param[in]  player   The handle to media player
  * @param[in]  packet   The media packet to decode
  * @return @c 0 on success,
@@ -1019,7 +1029,7 @@ int player_push_media_stream(player_h player, media_packet_h packet);
  * @brief  Sets contents information for media stream.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
  * @remarks AV format must be set before pushing elementary stream with player_push_media_stream().
- * @remarks This API must be called before calling the player_prepare() or player_prepare_async()
+ * @remarks This function must be called before calling the player_prepare() or player_prepare_async()
  *          to reflect the media information.
  * @remarks AAC can be supported.
  * @remarks H.264 can be supported.
@@ -1037,9 +1047,9 @@ int player_push_media_stream(player_h player, media_packet_h packet);
 int player_set_media_stream_info(player_h player, player_stream_type_e type, media_format_h format);
 
 /**
- * @brief Registers a callback function to be invoked when buffer underrun or overflow is occurred.
+ * @brief Sets a callback function to be invoked when buffer underrun or overflow is occurred.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @remarks This API is used for media stream playback only.
+ * @remarks This function is used for media stream playback only.
  * @remarks The callback is called in a separate thread (not in the main loop).
  * @param[in] player   The handle to the media player
  * @param[in] type     The type of target stream
@@ -1058,9 +1068,9 @@ int player_set_media_stream_info(player_h player, player_stream_type_e type, med
 int player_set_media_stream_buffer_status_cb(player_h player, player_stream_type_e type, player_media_stream_buffer_status_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the buffer status callback function.
+ * @brief Unsets the buffer status callback function.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @remarks This API is used for media stream playback only.
+ * @remarks This function is used for media stream playback only.
  * @param[in] player The handle to the media player
  * @param[in] type   The type of target stream
  * @return @c 0 on success,
@@ -1073,9 +1083,9 @@ int player_set_media_stream_buffer_status_cb(player_h player, player_stream_type
 int player_unset_media_stream_buffer_status_cb(player_h player, player_stream_type_e type);
 
 /**
- * @brief Registers a callback function to be invoked when seeking is occurred.
+ * @brief Sets a callback function to be invoked when seeking is occurred.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @remarks This API is used for media stream playback only.
+ * @remarks This function is used for media stream playback only.
  * @remarks The callback is called in a separate thread (not in the main loop).
  * @param[in] player    The handle to the media player
  * @param[in] type      The type of target stream
@@ -1094,7 +1104,7 @@ int player_unset_media_stream_buffer_status_cb(player_h player, player_stream_ty
 int player_set_media_stream_seek_cb(player_h player, player_stream_type_e type, player_media_stream_seek_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the seek callback function.
+ * @brief Unsets the seek callback function.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
  * @param[in] player The handle to the media player
  * @param[in] type   The type of target stream
@@ -1110,7 +1120,7 @@ int player_unset_media_stream_seek_cb(player_h player, player_stream_type_e type
 /**
  * @brief Sets the max size bytes of buffer.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @remarks This API is used for media stream playback only.
+ * @remarks This function is used for media stream playback only.
  * @remarks If the buffer level over the max size, player_media_stream_buffer_status_cb() will be invoked with overflow status.
  * @param[in] player The handle to the media player
  * @param[in] type   The type of target stream
@@ -1129,7 +1139,7 @@ int player_set_media_stream_buffer_max_size(player_h player, player_stream_type_
 /**
  * @brief Gets the max size bytes of buffer.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @remarks This API is used for media stream playback only.
+ * @remarks This function is used for media stream playback only.
  * @remarks If the buffer level over the max size, player_media_stream_buffer_status_cb() will be invoked with overflow status.
  * @param[in] player The handle to the media player
  * @param[in] type   The type of target stream
@@ -1148,7 +1158,7 @@ int player_get_media_stream_buffer_max_size(player_h player, player_stream_type_
 /**
  * @brief Sets the buffer threshold percent of buffer.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @remarks This API is used for media stream playback only.
+ * @remarks This function is used for media stream playback only.
  * @remarks If the buffer level drops below the percent value, player_media_stream_buffer_status_cb() will be invoked with underrun status.
  * @param[in] player The handle to the media player
  * @param[in] type   The type of target stream
@@ -1167,7 +1177,7 @@ int player_set_media_stream_buffer_min_threshold(player_h player, player_stream_
 /**
  * @brief Gets the buffer threshold percent of buffer.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @remarks This API is used for media stream playback only.
+ * @remarks This function is used for media stream playback only.
  * @remarks If the buffer level drops below the percent value, player_media_stream_buffer_status_cb() will be invoked with underrun status.
  * @param[in] player The handle to the media player
  * @param[in] type   The type of target stream
@@ -1207,7 +1217,7 @@ int player_get_media_stream_buffer_min_threshold(player_h player, player_stream_
  * @pre The player state must be one of #PLAYER_STATE_IDLE, #PLAYER_STATE_READY, #PLAYER_STATE_PLAYING, or #PLAYER_STATE_PAUSED.
  * @see #player_display_mode_e
  * @see player_set_display()
- * @see	player_get_display_mode()
+ * @see player_get_display_mode()
  */
 int player_set_display_mode(player_h player, player_display_mode_e mode);
 
@@ -1266,7 +1276,7 @@ int player_set_display_roi_area(player_h player, int x, int y, int width, int he
  * @retval #PLAYER_ERROR_INVALID_STATE Invalid state
  * @pre The player state must be one of #PLAYER_STATE_IDLE, #PLAYER_STATE_READY, #PLAYER_STATE_PLAYING, or #PLAYER_STATE_PAUSED.
  * @see player_set_display()
- * @see	player_is_display_visible()
+ * @see player_is_display_visible()
  */
 int player_set_display_visible(player_h player, bool visible);
 
@@ -1281,7 +1291,7 @@ int player_set_display_visible(player_h player, bool visible);
  * @retval  #PLAYER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval  #PLAYER_ERROR_INVALID_OPERATION Invalid operation
  * @pre The player state must be one of #PLAYER_STATE_IDLE, #PLAYER_STATE_READY, #PLAYER_STATE_PLAYING, or #PLAYER_STATE_PAUSED.
- * @see	player_set_display_visible()
+ * @see player_set_display_visible()
  */
 int player_is_display_visible(player_h player, bool* visible);
 
@@ -1433,7 +1443,9 @@ int player_get_video_size(player_h player, int *width, int *height);
 /**
  * @brief Gets the album art in the media resource.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @remarks You must not release @a album_art. It will be released by framework when the player is destroyed.
+ * @remarks You must not release @a album_art.
+ *          The @a album_art is managed by the platform and will be released
+ *          when the player is unprepared or destroyed by calling player_unprepare() or player_destroy().
  * @param[in] player The handle to the media player
  * @param[out] album_art The encoded artwork image
  * @param[out] size The encoded artwork size
@@ -1649,9 +1661,9 @@ int player_audio_effect_equalizer_is_available(player_h player, bool *available)
 /**
  * @brief Captures the video frame, asynchronously.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @param[in] player The handle to the media player
- * @param[in] callback	The callback function to register
- * @param[in] user_data	The user data to be passed to the callback function
+ * @param[in] player      The handle to the media player
+ * @param[in] callback    The callback function to register
+ * @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 #PLAYER_ERROR_NONE Successful
@@ -1668,7 +1680,7 @@ int player_capture_video(player_h player, player_video_captured_cb callback, voi
 /**
  * @brief Sets the cookie for streaming playback.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @remarks This API must be called before calling the player_prepare() or player_prepare_async()
+ * @remarks This function must be called before calling the player_prepare() or player_prepare_async()
  *          to reflect the cookie information when the streaming connection is set up.
  * @param[in] player The handle to the media player
  * @param[in] cookie The cookie to set
@@ -1688,7 +1700,7 @@ int player_set_streaming_cookie(player_h player, const char *cookie, int size);
 /**
  * @brief Sets the streaming user agent for playback.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @remarks This API must be called before calling the player_prepare() or player_prepare_async()
+ * @remarks This function must be called before calling the player_prepare() or player_prepare_async()
  *          to reflect the user agent information when the streaming connection is set up.
  * @param[in] player The handle to the media player
  * @param[in] user_agent The user agent to set
@@ -1722,11 +1734,11 @@ int player_set_streaming_user_agent(player_h player, const char *user_agent, int
 int player_get_streaming_download_progress(player_h player, int *start, int *current);
 
 /**
- * @brief Registers a callback function to be invoked when the playback is finished.
+ * @brief Sets a callback function to be invoked when the playback is finished.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @param[in] player	The handle to the media player
- * @param[in] callback	The callback function to register
- * @param[in] user_data	The user data to be passed to the callback function
+ * @param[in] player      The handle to the media player
+ * @param[in] callback    The callback function to register
+ * @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 #PLAYER_ERROR_NONE Successful
@@ -1740,7 +1752,7 @@ int player_get_streaming_download_progress(player_h player, int *start, int *cur
 int player_set_completed_cb(player_h player, player_completed_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the playback completed callback function.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @param[in] player The handle to the media player
  * @return @c 0 on success,
@@ -1753,11 +1765,11 @@ int player_set_completed_cb(player_h player, player_completed_cb callback, void
 int player_unset_completed_cb(player_h player);
 
 /**
- * @brief Registers a callback function to be invoked when the playback is interrupted or the interrupt is completed.
+ * @brief Sets a callback function to be invoked when the playback is interrupted or the interrupt is completed.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @param[in] player	The handle to the media player
- * @param[in] callback	The callback function to register
- * @param[in] user_data	The user data to be passed to the callback function
+ * @param[in] player      The handle to the media player
+ * @param[in] callback    The callback function to register
+ * @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 #PLAYER_ERROR_NONE Successful
@@ -1771,7 +1783,7 @@ int player_unset_completed_cb(player_h player);
 int player_set_interrupted_cb(player_h player, player_interrupted_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the interrupted callback function.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @param[in] player The handle to the media player
  * @return @c 0 on success,
@@ -1784,11 +1796,11 @@ int player_set_interrupted_cb(player_h player, player_interrupted_cb callback, v
 int player_unset_interrupted_cb(player_h player);
 
 /**
- * @brief Registers a callback function to be invoked when an error occurs.
+ * @brief Sets a callback function to be invoked when an error occurs.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @param[in] player	The handle to the media player
- * @param[in] callback	The callback function to register
- * @param[in] user_data	The user data to be passed to the callback function
+ * @param[in] player      The handle to the media player
+ * @param[in] callback    The callback function to register
+ * @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 #PLAYER_ERROR_NONE Successful
@@ -1801,7 +1813,7 @@ int player_unset_interrupted_cb(player_h player);
 int player_set_error_cb(player_h player, player_error_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the error callback function.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @param[in] player The handle to the media player
  * @return @c 0 on success,
@@ -1814,12 +1826,12 @@ int player_set_error_cb(player_h player, player_error_cb callback, void *user_da
 int player_unset_error_cb(player_h player);
 
 /**
- * @brief Registers a callback function to be invoked when there is a change in the buffering status of a media stream.
+ * @brief Sets a callback function to be invoked when there is a change in the buffering status of a media stream.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @remarks The media resource should be streamed over the network.
- * @param[in] player	The handle to the media player
- * @param[in] callback	The callback function to register
- * @param[in] user_data	The user data to be passed to the callback function
+ * @param[in] player      The handle to the media player
+ * @param[in] callback    The callback function to register
+ * @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 #PLAYER_ERROR_NONE Successful
@@ -1834,7 +1846,7 @@ int player_unset_error_cb(player_h player);
 int player_set_buffering_cb(player_h player, player_buffering_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the buffering callback function.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @param[in] player The handle to the media player
  * @return @c 0 on success,
@@ -1851,12 +1863,12 @@ int player_unset_buffering_cb(player_h player);
  * @brief Sets a path to download, progressively.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @remarks Progressive download will be started when you invoke player_start().
- * @remarks This API must be called before calling the player_prepare() or player_prepare_async() to reflect the download path when the player is building.
+ * @remarks This function must be called before calling the player_prepare() or player_prepare_async() to reflect the download path when the player is building.
  * @remarks The mediastorage privilege(http://tizen.org/privilege/mediastorage) must be added if any files are used to download and play located in the internal storage.
  * @remarks The externalstorage privilege(http://tizen.org/privilege/externalstorage) must be added if any files are used to download and play located in the external storage.
  *
- * @param[in]   player The handle to the media player
- * @param[in]   path The absolute path to download
+ * @param[in] player   The handle to the media player
+ * @param[in] path     The absolute path to download
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -1889,11 +1901,11 @@ int player_get_progressive_download_status(player_h player, unsigned long *curre
 
 /**
  * @deprecated Deprecated since 4.0.
- * @brief Registers a callback function to be invoked when progressive download is started or completed.
+ * @brief Sets a callback function to be invoked when progressive download is started or completed.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
- * @param[in] player	The handle to the media player
- * @param[in] callback	The callback function to register
- * @param[in] user_data	The user data to be passed to the callback function
+ * @param[in] player      The handle to the media player
+ * @param[in] callback    The callback function to register
+ * @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 #PLAYER_ERROR_NONE Successful
@@ -1907,7 +1919,7 @@ int player_set_progressive_download_message_cb(player_h player, player_pd_messag
 
 /**
  * @deprecated Deprecated since 4.0.
- * @brief Unregisters the callback function.
+ * @brief Unsets the progressive download message callback function.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @param[in] player The handle to the media player
  * @return @c 0 on success,
@@ -1925,8 +1937,8 @@ int player_unset_progressive_download_message_cb(player_h player) TIZEN_DEPRECAT
  * @remarks #PLAYER_ERROR_INVALID_OPERATION occurs when streaming playback.
  * @remarks No operation is performed, if @a rate is @c 0.
  * @remarks The sound is muted, when playback rate is under @c 0.0 and over @c 2.0.
- * @param[in] player The handle to the media player
- * @param[in] rate The playback rate (-5.0x ~ 5.0x)
+ * @param[in] player   The handle to the media player
+ * @param[in] rate     The playback rate (-5.0x ~ 5.0x)
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -1954,8 +1966,8 @@ int player_set_playback_rate(player_h player, float rate);
  * @remarks The externalstorage privilege(http://tizen.org/privilege/externalstorage) must be added if any files are used to play located in the external storage.
  * @remarks The path value can be @c NULL for reset before calling player_prepare() or player_prepare_async().
  *
- * @param[in]   player The handle to the media player
- * @param[in]   path The absolute path of the subtitle file, it can be @c NULL in the #PLAYER_STATE_IDLE state.
+ * @param[in] player   The handle to the media player
+ * @param[in] path     The absolute path of the subtitle file, it can be @c NULL in the #PLAYER_STATE_IDLE state.
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -1969,12 +1981,12 @@ int player_set_playback_rate(player_h player, float rate);
 int player_set_subtitle_path(player_h player, const char *path);
 
 /**
- * @brief Registers a callback function to be invoked when a subtitle updates.
+ * @brief Sets a callback function to be invoked when a subtitle updates.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @remarks The callback is called in a separate thread (not in the main loop).
- * @param[in] player	The handle to the media player
- * @param[in] callback	The callback function to register
- * @param[in] user_data	The user data to be passed to the callback function
+ * @param[in] player      The handle to the media player
+ * @param[in] callback    The callback function to register
+ * @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 #PLAYER_ERROR_NONE Successful
@@ -1989,7 +2001,7 @@ int player_set_subtitle_path(player_h player, const char *path);
 int player_set_subtitle_updated_cb(player_h player, player_subtitle_updated_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the callback function.
+ * @brief Unsets the subtitle updated callback function.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @param[in] player The handle to the media player
  * @return @c 0 on success,
@@ -2005,8 +2017,8 @@ int player_unset_subtitle_updated_cb(player_h player);
  * @brief Sets the seek position for the subtitle.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif.1
  * @remarks Only MicroDVD/SubViewer(*.sub), SAMI(*.smi), and SubRip(*.srt) subtitle formats are supported.
- * @param[in]  player The handle to the media player
- * @param[in]  millisecond The position in milliseconds from the start to the seek point
+ * @param[in]  player        The handle to the media player
+ * @param[in]  millisecond   The position in milliseconds from the start to the seek point
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -2019,15 +2031,15 @@ int player_unset_subtitle_updated_cb(player_h player);
 int player_set_subtitle_position_offset(player_h player, int millisecond);
 
 /**
- * @brief Registers a callback function to be invoked when video stream is changed.
+ * @brief Sets a callback function to be invoked when video stream is changed.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
  * @remarks The stream changing is detected just before rendering operation.
  * @remarks The callback is called in a separate thread (not in the main loop).
- * @remarks This API must be called before calling the player_prepare() or player_prepare_async()
+ * @remarks This function must be called before calling the player_prepare() or player_prepare_async()
  *          to reflect the requirement when the player is building.
- * @param[in] player   The handle to the media player
- * @param[in] callback The stream changed callback function to register
- * @param[in] user_data The user data to be passed to the callback function
+ * @param[in] player      The handle to the media player
+ * @param[in] callback    The stream changed callback function to register
+ * @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 #PLAYER_ERROR_NONE Successful
@@ -2041,9 +2053,9 @@ int player_set_subtitle_position_offset(player_h player, int millisecond);
 int player_set_video_stream_changed_cb(player_h player, player_video_stream_changed_cb callback, void *user_data);
 
 /**
- * @brief Unregisters the video stream changed callback function.
+ * @brief Unsets the video stream changed callback function.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @param[in] player The handle to the media player
+ * @param[in] player   The handle to the media player
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -2057,9 +2069,9 @@ int player_unset_video_stream_changed_cb(player_h player);
  * @brief Gets current track index.
  * @details Index starts from 0.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @param[in] player The handle to the media player
- * @param[in] type The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
- * @param[out] index  The index of track
+ * @param[in]  player   The handle to the media player
+ * @param[in]  type     The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
+ * @param[out] index    The index of track
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -2074,9 +2086,9 @@ int player_get_current_track(player_h player, player_stream_type_e type, int *in
  * @brief Gets language code of a track.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
  * @remarks @a code must be released with @c free() by caller
- * @param[in] player The handle to the media player
- * @param[in] type The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
- * @param[in] index  The index of track
+ * @param[in] player   The handle to the media player
+ * @param[in] type     The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
+ * @param[in] index    The index of track
  * @param[out] code A language code in ISO 639-1. "und" will be returned if the language is undefined.
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -2091,8 +2103,8 @@ int player_get_track_language_code(player_h player, player_stream_type_e type, i
 /**
  * @brief Gets the track count.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @param[in] player The handle to the media player
- * @param[in] type The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
+ * @param[in] player   The handle to the media player
+ * @param[in] type     The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
  * @param[out] count The number of track
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -2107,9 +2119,9 @@ int player_get_track_count(player_h player, player_stream_type_e type, int *coun
 /**
  * @brief Selects a track to play.
  * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
- * @param[in] player The handle to the media player
- * @param[in] type The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
- * @param[in] index  The index of track
+ * @param[in] player   The handle to the media player
+ * @param[in] type     The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
+ * @param[in] index    The index of track
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -2124,10 +2136,10 @@ int player_select_track(player_h player, player_stream_type_e type, int index);
 /**
  * @brief Retrieves all the streaming variant information.
  * @since_tizen 4.0
- * @remarks This API is used for adaptive streaming(hls/mpeg dash) only.
- * @param[in] player The handle to the media player
- * @param[in] callback The iteration callback function
- * @param[in] user_data The user data to be passed to the callback function
+ * @remarks This function is used for adaptive streaming(hls/mpeg dash) only.
+ * @param[in] player      The handle to the media player
+ * @param[in] callback    The iteration callback function
+ * @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 #PLAYER_ERROR_NONE Successful
@@ -2142,14 +2154,14 @@ int player_foreach_adaptive_variant(player_h player, player_adaptive_variant_cb
 /**
  * @brief Sets the maximum limit of the streaming variant.
  * @since_tizen 4.0
- * @remarks This API is used for adaptive streaming(hls/mpeg dash) only.
+ * @remarks This function is used for adaptive streaming(hls/mpeg dash) only.
  * @remarks The bandwidth setting can only be applied if there is no width, height information at streaming variant header.
  *          Application can get all the variant information by calling player_foreach_adaptive_variant() function.
  * @remarks If there is no affordable stream for the condition, the minimum bandwidth stream will be selected.
- * @param[in] player The handle to the media player
- * @param[in] bandwidth The max bandwidth limit of the stream variant (default: -1)
- * @param[in] width The max width limit of the stream variant (deafult: -1)
- * @param[in] height The max height limit of the stream variant (deafult: -1)
+ * @param[in] player      The handle to the media player
+ * @param[in] bandwidth   The max bandwidth limit of the stream variant (default: -1)
+ * @param[in] width       The max width limit of the stream variant (deafult: -1)
+ * @param[in] height      The max height limit of the stream variant (deafult: -1)
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -2164,11 +2176,11 @@ int player_set_max_adaptive_variant_limit(player_h player, int bandwidth, int wi
 /**
  * @brief Gets the maximum limit of the streaming variant.
  * @since_tizen 4.0
- * @remarks This API is used for adaptive streaming(hls/mpeg dash) only.
- * @param[in] player The handle to the media player
- * @param[out] bandwidth The max bandwidth limit of the stream variant (default: -1)
- * @param[out] width The max width limit of the stream variant (deafult: -1)
- * @param[out] height The max height limit of the stream variant (deafult: -1)
+ * @remarks This function is used for adaptive streaming(hls/mpeg dash) only.
+ * @param[in]  player      The handle to the media player
+ * @param[out] bandwidth   The max bandwidth limit of the stream variant (default: -1)
+ * @param[out] width       The max width limit of the stream variant (deafult: -1)
+ * @param[out] height      The max height limit of the stream variant (deafult: -1)
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE Successful
@@ -2200,8 +2212,8 @@ int player_set_audio_only(player_h player, bool audio_only);
 /**
  * @brief Gets the audio only mode status.
  * @since_tizen 4.0
- * @param[in]  player      The handle to the media player
- * @param[out] audio_only  The current audio only status: (@c true = audio only enabled, @c false = audio only disabled)
+ * @param[in]  player       The handle to the media player
+ * @param[out] audio_only   The current audio only status: (@c true = audio only enabled, @c false = audio only disabled)
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE                Successful
@@ -2254,7 +2266,7 @@ int player_get_streaming_buffering_time(player_h player, int *prebuffer_ms, int
  * @param[in] enable   The 360 video display status: @c true = display with 360 video mode,
                        @c false = display with full panorama mode. The default value is @c true.
  * @return @c 0 on success,
- *		  otherwise a negative error value
+ *         otherwise a negative error value
  * @retval #PLAYER_ERROR_NONE              Successful
  * @retval #PLAYER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PLAYER_ERROR_INVALID_STATE     Invalid player state
diff --git a/packaging/capi-media-player.spec b/packaging/capi-media-player.spec
index 4d6f181..4a6f607 100644
--- a/packaging/capi-media-player.spec
+++ b/packaging/capi-media-player.spec
@@ -1,6 +1,6 @@
 Name:       capi-media-player
 Summary:    A Media Player API
-Version:    0.3.82
+Version:    0.3.83
 Release:    0
 Group:      Multimedia/API
 License:    Apache-2.0