Update description

Change-Id: Icdfa353005dfa51ecb312f716215cebcac07545a
Signed-off-by: Minje Ahn <minje.ahn@samsung.com>

diff --git a/include/media_controller_client.h b/include/media_controller_client.h
index e139fef9a5fdca15ed8fcc98e04c215f4a78f1af..2977445430daac487fa13a1b1c6a56447fb4c401 100755 (executable)
--- a/include/media_controller_client.h
+++ b/include/media_controller_client.h
@@ -42,11 +42,11 @@ extern "C" {
  * @brief Called when updating status of the media controller server.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
- * @remarks The callback is called in the dbus event loop.
- *              The @a server_name should not be released by the application. \n
+ * @remarks The callback is called in the dbus event loop.\n
+ *              The @a server_name should not be released by the application.\n
  *              The @a server_name can be used only in the callback. To use outside, make a copy.
  *
- * @param[in] server_name The app_id of the media controller server which sent the notification.
+ * @param[in] server_name The app_id of the media controller server which sent the notification
  * @param[in] state The state of the updated media controller server
  * @param[in] user_data        The user data passed from the mc_client_set_server_updated_cb() function
  *
@@ -60,13 +60,13 @@ typedef void (*mc_server_state_updated_cb)(const char *server_name, mc_server_st
  * @brief Called when updating the playback information of the media controller server.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
- * @remarks The callback is called in the dbus event loop.
+ * @remarks The callback is called in the dbus event loop.\n
  *               The @a server_name and @a playback should not be released by the application. \n
- *               The @a server_name can be used only in the callback. To use outside, make a copy.
- *               And @a playback also can be used only in the callback. \n
+ *               The @a server_name can be used only in the callback. To use outside, make a copy. \n
+ *               And @a playback also can be used only in the callback.
  *
- * @param[in] server_name The app_id of the media controller server which sent the notification.
- * @param[in] playback The playback information of the updated media controller server.
+ * @param[in] server_name The app_id of the media controller server which sent the notification
+ * @param[in] playback The playback information of the updated media controller server
  * @param[in] user_data        The user data passed from the mc_client_set_playback_updated_cb() function
  *
  * @pre mc_client_set_playback_updated_cb()
@@ -82,13 +82,13 @@ typedef void (*mc_playback_updated_cb)(const char *server_name, mc_playback_h pl
  * @brief Called when updating the metadata of the media controller server.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
- * @remarks The callback is called in the dbus event loop.
+ * @remarks The callback is called in the dbus event loop.\n
  *               The @a server_name and @a metadata should not be released by the application. \n
- *               The @a server_name can be used only in the callback. To use outside, make a copy.
- *               And @a metadata also can be used only in the callback. To use outside, make a copy using mc_metadata_clone() \n
+ *               The @a server_name can be used only in the callback. To use outside, make a copy. \n
+ *               And @a metadata also can be used only in the callback. To use outside, make a copy using mc_metadata_clone().
  *
- * @param[in] server_name The app_id of the media controller server which sent the notification.
- * @param[in] metadata The metadata of the updated media controller server.
+ * @param[in] server_name The app_id of the media controller server which sent the notification
+ * @param[in] metadata The metadata of the updated media controller server
  * @param[in] user_data        The user data passed from the mc_client_set_metadata_updated_cb() function
  *
  * @pre mc_client_set_metadata_updated_cb()
@@ -102,11 +102,11 @@ typedef void (*mc_metadata_updated_cb)(const char *server_name, mc_metadata_h me
  * @brief Called when updating the shuffle mode of the media controller server.
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
- * @remarks The callback is called in the dbus event loop.
+ * @remarks The callback is called in the dbus event loop.\n
  *               The @a server_name should not be released by the application. \n
  *               The @a server_name can be used only in the callback. To use outside, make a copy.
  *
- * @param[in] server_name The app_id of the media controller server which sent the notification.
+ * @param[in] server_name The app_id of the media controller server which sent the notification
  * @param[in] mode The shuffle mode of the updated media controller server
  * @param[in] user_data        The user data passed from the mc_client_set_shuffle_mode_updated_cb() function
  *
@@ -120,11 +120,11 @@ typedef void (*mc_shuffle_mode_updated_cb)(const char *server_name, mc_shuffle_m
  * @brief Called when updating the repeat mode of the media controller server.
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
- * @remarks The callback is called in the dbus event loop.
+ * @remarks The callback is called in the dbus event loop.\n
  *               The @a server_name should not be released by the application. \n
  *               The @a server_name can be used only in the callback. To use outside, make a copy.
  *
- * @param[in] server_name The app_id of the media controller server which sent the notification.
+ * @param[in] server_name The app_id of the media controller server which sent the notification
  * @param[in] mode The repeat mode of the updated media controller server
  * @param[in] user_data        The user data passed from the mc_client_set_repeat_mode_updated_cb() function
  *
@@ -138,10 +138,10 @@ typedef void (*mc_repeat_mode_updated_cb)(const char *server_name, mc_repeat_mod
  * @brief Called when updating the playback ability of the media controller server.
  * @since_tizen 5.0
  *
- * @remarks The callback is called in the dbus event loop.
+ * @remarks The callback is called in the dbus event loop.\n
  *               The @a server_name should not be released by the application. \n
- *               The @a server_name can be used only in the callback. To use outside, make a copy.
- *               And @a ability also can be used only in the callback. To use outside, make a copy using mc_playback_ability_clone() \n
+ *               The @a server_name can be used only in the callback. To use outside, make a copy. \n
+ *               And @a ability also can be used only in the callback. To use outside, make a copy using mc_playback_ability_clone().
  *
  * @param[in] server_name The app_id of the media controller server which sent the notification
  * @param[in] ability The ability of the updated media controller server
@@ -158,7 +158,7 @@ typedef void (*mc_playback_ability_updated_cb)(const char *server_name, mc_playb
  * @brief Called when updating the shuffle ability of the media controller server.
  * @since_tizen 5.0
  *
- * @remarks The callback is called in the dbus event loop.
+ * @remarks The callback is called in the dbus event loop.\n
  *               The @a server_name should not be released by the application. \n
  *               The @a server_name can be used only in the callback. To use outside, make a copy.
  *
@@ -176,7 +176,7 @@ typedef void (*mc_shuffle_ability_updated_cb)(const char *server_name, mc_abilit
  * @brief Called when updating the repeat ability of the media controller server.
  * @since_tizen 5.0
  *
- * @remarks The callback is called in the dbus event loop.
+ * @remarks The callback is called in the dbus event loop.\n
  *               The @a server_name should not be released by the application. \n
  *               The @a server_name can be used only in the callback. To use outside, make a copy.
  *
@@ -196,11 +196,11 @@ typedef void (*mc_repeat_ability_updated_cb)(const char *server_name, mc_ability
  * @brief Called when requesting the list of created servers.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
- * @remarks The callback is called in the main loop.
+ * @remarks The callback is called in the main loop.\n
  *               The @a server_name should not be released by the application. \n
  *               The @a server_name can be used only in the callback. To use outside, make a copy.
  *
- * @param[in] server_name The app_id of the created media controller server.
+ * @param[in] server_name The app_id of the created media controller server
  * @param[in] user_data        The user data passed from the mc_client_foreach_server() function
  *
  * @return @c true to continue with the next iteration of the loop,
@@ -216,7 +216,7 @@ typedef bool (*mc_activated_server_cb)(const char *server_name, void *user_data)
  * @brief Called when the result of the command from the server is received.
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
- * @remarks The callback is called in the dbus event loop. @a data should be released using bundle_free().
+ * @remarks The callback is called in the dbus event loop.\n @a data should be released using bundle_free().\n
  *              The @a server_name and @ request_id should not be released by the application. \n
  *              The @a server_name and @ request_id can be used only in the callback. To use outside, make a copy.
  *
@@ -237,7 +237,7 @@ typedef void (*mc_cmd_reply_received_cb)(const char *server_name, const char *re
  * @brief Called when requesting the list of subscribed servers.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
- * @remarks The callback is called in the dbus event loop.
+ * @remarks The callback is called in the dbus event loop.\n
  *              The @a server_name should not be released by the application. \n
  *              The @a server_name can be used only in the callback. To use outside, make a copy.
  *
@@ -257,15 +257,15 @@ typedef bool (*mc_subscribed_server_cb)(const char *server_name, void *user_data
  * @brief Called when updating the playlist of the media controller server.
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
- * @remarks The callback is called in the dbus event loop.
+ * @remarks The callback is called in the dbus event loop.\n
  *              The @a server_name, @a playlist_name and @a playlist should not be released by the application. \n
- *              The @a server_name and @a playlist_name can be used only in the callback. To use outside, make a copy.
- *              And @a playlist also can be used only in the callback. To use outside, make a copy using mc_playlist_clone(). \n
+ *              The @a server_name and @a playlist_name can be used only in the callback. To use outside, make a copy.\n
+ *              And @a playlist also can be used only in the callback. To use outside, make a copy using mc_playlist_clone().
  *
- * @param[in] server_name The app_id of the media controller server which sent the notification.
+ * @param[in] server_name The app_id of the media controller server which sent the notification
  * @param[in] mode The playlist update mode of the updated media controller server
- * @param[in] playlist_name Updated playlist name.
- * @param[in] playlist        The handle of the media controller playlist.
+ * @param[in] playlist_name Updated playlist name
+ * @param[in] playlist        The handle of the media controller playlist
  * @param[in] user_data The user data passed from the mc_client_set_playlist_updated_cb() function
  *
  * @pre mc_client_set_playlist_updated_cb()
@@ -279,11 +279,11 @@ typedef void (*mc_playlist_updated_cb)(const char *server_name, mc_playlist_upda
  * @brief Called when receiving custom event of media controller servers.
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
- * @remarks The callback is called in the dbus event loop. The @a data should be released using bundle_free(). \n
+ * @remarks The callback is called in the dbus event loop.\n The @a data should be released using bundle_free(). \n
  *          The @a server_name, @a request_id and @a event should not be released by the application. \n
  *          The @a server_name, @a request_id and @a event can be used only in the callback. To use outside, make a copy.
  *
- * @param[in] server_name The app_id of the subscribed media controller server.
+ * @param[in] server_name The app_id of the subscribed media controller server
  * @param[in] request_id     The id of the custom event request
  * @param[in] event          The name of the custom event
  * @param[in] data           The data can include other information associated with the event
@@ -368,7 +368,7 @@ int mc_client_unset_server_updated_cb(mc_client_h client);
 
 /**
  * @brief Sets the callback for monitoring playback status of the media controller server.
- * @details The media controller client which calls this function will receive notifications from all media controller servers. \n
+ * @details The media controller client which calls this function will receive notifications from all media controller servers.
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
  * @privlevel public
@@ -793,7 +793,7 @@ int mc_client_unset_playlist_updated_cb(mc_client_h client);
  * @privilege %http://tizen.org/privilege/mediacontroller.client
  *
  * @param[in] client    The handle to media controller client
- * @param[in] callback      The callback to be invoked when the media controller client receives custom event from a media controller server.
+ * @param[in] callback      The callback to be invoked when the media controller client receives custom event from a media controller server
  * @param[in] user_data   The user data to be passed to the callback function
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -842,13 +842,13 @@ int mc_client_unset_custom_event_received_cb(mc_client_h client);
  * @privlevel public
  * @privilege %http://tizen.org/privilege/mediacontroller.client
  *
- * @remarks The media controller client get the @a server_name and @a request_id through the mc_client_custom_event_received_cb().
+ * @remarks The media controller client get the @a server_name and @a request_id through the mc_client_custom_event_received_cb(). \n
  *          If @a request_id is not null there, the media controller client should send the reply to the media controller server with the @a request_id. \n
  *          If @a request_id is null, this function will return #MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER.
  *
  * @param[in] client    The handle of the media controller client
  * @param[in] server_name    The app_id of the media controller server
- * @param[in] request_id    The id of the event request, received in the mc_client_set_custom_event_received_cb() function.
+ * @param[in] request_id    The id of the event request, received in the mc_client_set_custom_event_received_cb() function
  * @param[in] result_code    The result code of custom event
  * @param[in] data                The extra data
  * @return @c 0 on success,
@@ -869,12 +869,12 @@ int mc_client_send_event_reply(mc_client_h client, const char *server_name, cons
 
 /**
  * @brief Subscribes media controller server for monitoring status.
- * @details If media controller client subscribe media controller server, \n
+ * @details If media controller client subscribe media controller server,
  *              the media controller client receive callback from subscribed media controller server. \n
- *              If media controller client subscribe media controller server one or more, \n
+ *              If media controller client subscribe media controller server one or more,
  *              the media controller client can receive callback from only subscribed media controller server. \n
- *              If you want to subscribe for the all media controller server again, \n
- *              unset mode update callback and set the callback for the monitoring status again. \n
+ *              If you want to subscribe for the all media controller server again,
+ *              unset mode update callback and set the callback for the monitoring status again.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
  * @privlevel public
@@ -903,9 +903,9 @@ int mc_client_subscribe(mc_client_h client, mc_subscription_type_e subscription_
  * @brief Unsubscribes media controller server for monitoring status.
  * @details If media controller client unsubscribe media controller server, \n
  *              the media controller client don't receive callback from unsubscribed media controller server. \n
- *              If media controller client unsubscribe all subscribed media controller server, \n
+ *              If media controller client unsubscribe all subscribed media controller server,
  *              the media controller client don't receive callback from all media controller server. \n
- *              After unset and set update callback function is called again, the media controller client can receive callback from all media controller servers. \n
+ *              After unset and set update callback function is called again, the media controller client can receive callback from all media controller servers.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
  * @privlevel public
@@ -937,7 +937,7 @@ int mc_client_unsubscribe(mc_client_h client, mc_subscription_type_e subscriptio
  *
  * @param[in] client    The handle of the media controller client
  * @param[in] subscription_type    The subscription type
- * @param[in] callback      The callback to be invoked when the list of the subscribed media controller server.
+ * @param[in] callback      The callback to be invoked when the list of the subscribed media controller server
  * @param[in] user_data   The user data to be passed to the callback function
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -1022,7 +1022,8 @@ int mc_client_get_playlist_item_index(mc_playback_h playback, char **index) TIZE
 
 /**
  * @brief Gets the playlist name and index of the media in playlist.
- * @details Gets the playlist name and index of the current playing media in a playlist. If the media controller server didn't set the info, @a playlist_name and @a index will be set to NULL.
+ * @details Gets the playlist name and index of the current playing media in a playlist. \n
+ *          If the media controller server didn't set the info, @a playlist_name and @a index will be set to NULL.
  * @since_tizen 5.0
  *
  * @privlevel public
@@ -1117,8 +1118,8 @@ int mc_client_destroy_playback(mc_playback_h playback);
  *
  * @remarks The @a server_name should be released using free(). \n
  *               If there is no activated media controller server, return value of the server name is NULL. \n
- *               Before a media controller server sets the playback state to #MC_PLAYBACK_STATE_PLAYING, the @a server_state is #MC_SERVER_STATE_NONE.
- *               After a media controller server sets the playback state to #MC_PLAYBACK_STATE_PLAYING, the @a server_state is #MC_SERVER_STATE_ACTIVATE.
+ *               Before a media controller server sets the playback state to #MC_PLAYBACK_STATE_PLAYING, the @a server_state is #MC_SERVER_STATE_NONE. \n
+ *               After a media controller server sets the playback state to #MC_PLAYBACK_STATE_PLAYING, the @a server_state is #MC_SERVER_STATE_ACTIVATE. \n
  *               After a media controller server is destroyed, @a server_state is #MC_SERVER_STATE_DEACTIVATE.
  *
  * @param[in] client    The handle of the media controller client
@@ -1379,7 +1380,7 @@ int mc_client_foreach_server(mc_client_h client, mc_activated_server_cb callback
  *
  * @param[in] client    The handle of the media controller client
  * @param[in] server_name    The app_id of the media controller server
- * @param[in] callback      The callback function to be invoked.
+ * @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,
@@ -1438,7 +1439,7 @@ int mc_client_send_playback_action_cmd(mc_client_h client, const char *server_na
  *
  * @param[in] client    The handle of the media controller client
  * @param[in] server_name    The app_id of the media controller server
- * @param[in] position   The position of the playback in milliseconds to send to media controller server.
+ * @param[in] position   The position of the playback in milliseconds to send to media controller server
  * @param[out] request_id   The id of the command request, it will be passed to the mc_cmd_reply_received_cb() function
  * @return @c 0 on success,
  *         otherwise a negative error value

diff --git a/include/media_controller_server.h b/include/media_controller_server.h
index 8d39fed4ab62e812fa5a463b3fdabb2704c85cb9..37b549e011d1b275669e38b487d0d2a6e27dc9c9 100755 (executable)
--- a/include/media_controller_server.h
+++ b/include/media_controller_server.h
@@ -43,12 +43,12 @@ extern "C" {
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
  * @remarks The callback is called in the dbus event loop.\n
- *          If @a request_id is not null, the server should send the reply to the client with the @a request_id.
+ *          If @a request_id is not null, the server should send the reply to the client with the @a request_id. \n
  *          The @a client_name and @ request_id should not be released by the application. \n
  *          The @a client_name and @ request_id can be used only in the callback. To use outside, make a copy.
  *
- * @param[in] client_name    The app_id of the media controller client.
- * @param[in] request_id    The request_id of the media controller client.
+ * @param[in] client_name    The app_id of the media controller client
+ * @param[in] request_id    The request_id of the media controller client
  * @param[in] action    The received playback action
  * @param[in] user_data        The user data passed from the mc_server_set_playback_action_cmd_received_cb() function
  *
@@ -64,12 +64,12 @@ typedef void (*mc_server_playback_action_cmd_received_cb)(const char* client_nam
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
  * @remarks The callback is called in the dbus event loop.\n
- *          If @a request_id is not null, the server should send the reply to the client with the @a request_id.
+ *          If @a request_id is not null, the server should send the reply to the client with the @a request_id.\n
  *          The @a client_name and @ request_id should not be released by the application. \n
  *          The @a client_name and @ request_id can be used only in the callback. To use outside, make a copy.
  *
- * @param[in] client_name    The app_id of the media controller client.
- * @param[in] request_id    The request_id of the media controller client.
+ * @param[in] client_name    The app_id of the media controller client
+ * @param[in] request_id    The request_id of the media controller client
  * @param[in] position    The received playback position (milliseconds)
  * @param[in] user_data        The user data passed from the mc_server_set_playback_position_cmd_received_cb() function
  *
@@ -85,12 +85,12 @@ typedef void (*mc_server_playback_position_cmd_received_cb)(const char* client_n
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
  * @remarks The callback is called in the dbus event loop.\n
- *          If @a request_id is not null, the server should send the reply to the client with the @a request_id.
+ *          If @a request_id is not null, the server should send the reply to the client with the @a request_id.\n
  *          The @a client_name and @ request_id should not be released by the application. \n
  *          The @a client_name and @ request_id can be used only in the callback. To use outside, make a copy.
  *
- * @param[in] client_name    The app_id of the media controller client.
- * @param[in] request_id    The request_id of the media controller client.
+ * @param[in] client_name    The app_id of the media controller client
+ * @param[in] request_id    The request_id of the media controller client
  * @param[in] shuffle_mode    The received shuffle_mode
  * @param[in] user_data        The user data passed from the mc_server_set_shuffle_mode_cmd_received_cb() function
  *
@@ -106,12 +106,12 @@ typedef void (*mc_server_shuffle_mode_cmd_received_cb)(const char* client_name,
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
  * @remarks The callback is called in the dbus event loop.\n
- *          If @a request_id is not null, the server should send the reply to the client with the @a request_id.
+ *          If @a request_id is not null, the server should send the reply to the client with the @a request_id.\n
  *          The @a client_name and @ request_id should not be released by the application. \n
  *          The @a client_name and @ request_id can be used only in the callback. To use outside, make a copy.
  *
- * @param[in] client_name    The app_id of the media controller client.
- * @param[in] request_id    The request_id of the media controller client.
+ * @param[in] client_name    The app_id of the media controller client
+ * @param[in] request_id    The request_id of the media controller client
  * @param[in] repeat_mode    The received repeat mode
  * @param[in] user_data        The user data passed from the mc_server_set_repeat_mode_cmd_received_cb() function
  *
@@ -127,14 +127,14 @@ typedef void (*mc_server_repeat_mode_cmd_received_cb)(const char* client_name, c
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
  * @remarks The callback is called in the dbus event loop. \n
- *          If @a request_id is not null, the server should send the reply to the client with the @a request_id.
+ *          If @a request_id is not null, the server should send the reply to the client with the @a request_id.\n
  *          The @a client_name, @ request_id, @ playlist_name and @ index should not be released by the application. \n
  *          The @a client_name, @ request_id, @ playlist_name and @ index can be used only in the callback. To use outside, make a copy.
  *
- * @param[in] client_name    The app_id of the media controller client.
- * @param[in] request_id    The request_id of the media controller client.
- * @param[in] playlist_name    The name of the server playlist.
- * @param[in] index    The index of the media in playlist.
+ * @param[in] client_name    The app_id of the media controller client
+ * @param[in] request_id    The request_id of the media controller client
+ * @param[in] playlist_name    The name of the server playlist
+ * @param[in] index    The index of the media in playlist
  * @param[in] action    The received playback action
  * @param[in] position    The received playback position (milliseconds)
  * @param[in] user_data    The user data passed from the mc_server_set_playlist_cmd_received_cb() function
@@ -153,13 +153,13 @@ typedef void (*mc_server_playlist_cmd_received_cb)(const char* client_name, cons
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
  * @remarks The callback is called in the dbus event loop. @a data should be released using bundle_free().\n
- *          If @a request_id is not null, the server should send the reply to the client with the @a request_id.
+ *          If @a request_id is not null, the server should send the reply to the client with the @a request_id.\n
  *          The @a client_name, @ request_id and @ command should not be released by the application. \n
  *          The @a client_name, @ request_id and @ command can be used only in the callback. To use outside, make a copy.
  *
- * @param[in] client_name    The app_id of the media controller client.
+ * @param[in] client_name    The app_id of the media controller client
  * @param[in] request_id     The id of the command request
- * @param[in] command    The received command.
+ * @param[in] command    The received command
  * @param[in] data    The extra data
  * @param[in] user_data        The user data passed from the mc_server_set_custom_cmd_received_cb() function
  *
@@ -179,7 +179,7 @@ typedef void (*mc_server_custom_cmd_received_cb)(const char* client_name, const
  *          The @a client_name should not be released by the application. \n
  *          The @a client_name can be used only in the callback. To use outside, make a copy.
  *
- * @param[in] client_name The app_id of the created media controller client.
+ * @param[in] client_name The app_id of the created media controller client
  * @param[in] user_data        The user data passed from the mc_client_foreach_server() function
  *
  * @return @c true to continue with the next iteration of the loop,
@@ -199,7 +199,7 @@ typedef bool (*mc_activated_client_cb)(const char *client_name, void *user_data)
  *          The @a client_name and @a request_id should not be released by the application. \n
  *          The @a client_name and @a request_id can be used only in the callback. To use outside, make a copy.
  *
- * @param[in] client_name    The app_id of the media controller client which sent the reply. It can be used only in the callback. To use outside, make a copy.
+ * @param[in] client_name    The app_id of the media controller client
  * @param[in] request_id     The id of the event request
  * @param[in] result_code    The result code of the event
  * @param[in] data The extra data
@@ -221,12 +221,12 @@ typedef void (*mc_server_event_reply_received_cb)(const char *client_name, const
  * @since_tizen 5.0
  *
  * @remarks The callback is called in the dbus event loop.\n
- *          If @a request_id is not null, the server should send the reply to the client with the @a request_id.
+ *          If @a request_id is not null, the server should send the reply to the client with the @a request_id.\n
  *          The @a client_name, @a request_id and @a search should not be released by the application. \n
- *          The @a client_name and @a request_id can be used only in the callback. To use outside, make a copy.
- *          @a search also can be used only in the callback. To use outside, make a copy using mc_search_clone(). \n
+ *          The @a client_name and @a request_id can be used only in the callback. To use outside, make a copy.\n
+ *          @a search also can be used only in the callback. To use outside, make a copy using mc_search_clone().
  *
- * @param[in] client_name    The app_id of the media controller client.
+ * @param[in] client_name    The app_id of the media controller client
  * @param[in] request_id     The id of the command request
  * @param[in] search    The handle to search
  * @param[in] user_data        The user data passed from the mc_server_set_search_cmd_received_cb() function
@@ -315,7 +315,8 @@ int mc_server_set_playback_position(mc_server_h server, unsigned long long posit
 /**
  * @deprecated Deprecated since 5.0. Use mc_server_set_playlist_item_info() instead.
  * @brief Sets the index of the current playing media in the playlist to update the latest playback info.
- * @details If a media controller server has a playlist, the server can register and share it with media controller client. A playlist is a set of "index" and "media metadata".\n
+ * @details If a media controller server has a playlist, the server can register and share it with media controller client.
+ *            A playlist is a set of "index" and "media metadata".\n
  *            The media controller server can let media controller clients know the index of current playing media by using this function.
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
@@ -343,7 +344,8 @@ int mc_server_set_playlist_item_index(mc_server_h server, const char *index)  TI
 
 /**
  * @brief Sets the playlist name and index of the current playing media in the playlist to update the latest playback info.
- * @details If a media controller server has a playlist, the server can register and share it with media controller client. A playlist is a set of "index" and "media metadata".\n
+ * @details If a media controller server has a playlist, the server can register and share it with media controller client.
+ *            A playlist is a set of "index" and "media metadata".\n
  *            The media controller server can let media controller clients know the playlist name and index of current playing media by using this function.
  * @since_tizen 5.0
  *
@@ -595,7 +597,7 @@ int mc_server_unset_playback_action_cmd_received_cb(mc_server_h server);
  * @privilege %http://tizen.org/privilege/mediacontroller.server
  *
  * @param[in] server    The handle to media controller server
- * @param[in] callback      The callback to be invoked when media controller server receives position command from client.
+ * @param[in] callback      The callback to be invoked when media controller server receives position command from client
  * @param[in] user_data   The user data to be passed to the callback function
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -640,7 +642,7 @@ int mc_server_unset_playback_position_cmd_received_cb(mc_server_h server);
  * @privilege %http://tizen.org/privilege/mediacontroller.server
  *
  * @param[in] server    The handle to media controller server
- * @param[in] callback      The callback to be invoked when media controller server receives shuffle mode from client.
+ * @param[in] callback      The callback to be invoked when media controller server receives shuffle mode from client
  * @param[in] user_data   The user data to be passed to the callback function
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -685,7 +687,7 @@ int mc_server_unset_shuffle_mode_cmd_received_cb(mc_server_h server);
  * @privilege %http://tizen.org/privilege/mediacontroller.server
  *
  * @param[in] server    The handle to media controller server
- * @param[in] callback      The callback to be invoked when media controller server receives repeat mode from client.
+ * @param[in] callback      The callback to be invoked when media controller server receives repeat mode from client
  * @param[in] user_data   The user data to be passed to the callback function
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -730,7 +732,7 @@ int mc_server_unset_repeat_mode_cmd_received_cb(mc_server_h server);
  * @privilege %http://tizen.org/privilege/mediacontroller.server
  *
  * @param[in] server    The handle to media controller server
- * @param[in] callback      The callback to be invoked when media controller server receives playlist command from client.
+ * @param[in] callback      The callback to be invoked when media controller server receives playlist command from client
  * @param[in] user_data   The user data to be passed to the callback function
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -775,7 +777,7 @@ int mc_server_unset_playlist_cmd_received_cb(mc_server_h server);
  * @privilege %http://tizen.org/privilege/mediacontroller.server
  *
  * @param[in] server    The handle to media controller server
- * @param[in] callback      The callback to be invoked when media controller server receives custom command from client.
+ * @param[in] callback      The callback to be invoked when media controller server receives custom command from client
  * @param[in] user_data   The user data to be passed to the callback function
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -824,7 +826,7 @@ int mc_server_unset_custom_cmd_received_cb(mc_server_h server);
  *
  * @param[in] server    The handle to media controller server
  * @param[in] client_name    The app_id of the media controller client
- * @param[in] request_id    The id of the command request, received in the mc_server_custom_cmd_received_cb() function.
+ * @param[in] request_id    The id of the command request, received in the mc_server_custom_cmd_received_cb() function
  * @param[in] result_code    The result code of custom command
  * @param[in] data                The extra data
  * @return @c 0 on success,
@@ -909,7 +911,7 @@ int mc_server_send_custom_event(mc_server_h server, const char *client_name, con
 
 /**
  * @brief Sets the callback for receiving the result of the event from the media controller client.
- * @details The media controller server which calls this function will receive the result of the event from all media controller clients.
+ * @details The media controller server which calls this function will receive the result of the event from all media controller clients.\n
  *             The media controller server can send event by using mc_server_send_custom_event().
  * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif
  *
@@ -965,7 +967,7 @@ int mc_server_unset_event_reply_received_cb(mc_server_h server);
  * @privilege %http://tizen.org/privilege/mediacontroller.server
  *
  * @param[in] server    The handle to media controller server
- * @param[in] callback      The callback to be invoked when media controller server receives search command from client.
+ * @param[in] callback      The callback to be invoked when media controller server receives search command from client
  * @param[in] user_data   The user data to be passed to the callback function
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -1012,6 +1014,7 @@ int mc_server_unset_search_cmd_received_cb(mc_server_h server);
  * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful
  * @retval #MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTROLLER_ERROR_INVALID_OPERATION Invalid operation
+ *
  * @pre Create a media controller server handle by calling mc_server_create().
  * @see mc_server_create()
  */
@@ -1024,11 +1027,11 @@ int mc_server_destroy(mc_server_h server);
  * @privlevel public
  * @privilege %http://tizen.org/privilege/mediacontroller.server
  *
- * @remarks The @a playlist should be released using mc_playlist_destroy().
+ * @remarks The @a playlist should be released using mc_playlist_destroy().\n
  *              When the server is destroyed, all its playlists will be deleted automatically.
  *
  * @param[in] server The handle to media controller server
- * @param[in] playlist_name The name of the created playlist. It should not be NULL.
+ * @param[in] playlist_name The name of the created playlist
  * @param[out] playlist  The handle of the media controller playlist
  *
  * @return @c 0 on success,