From: hj kim <backto.kim@samsung.com>
Date: Tue, 11 Jun 2019 04:35:33 +0000 (+0900)
Subject: Update API description
X-Git-Tag: accepted/tizen/unified/20190617.061726~2
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=refs%2Fchanges%2F76%2F207676%2F1;p=platform%2Fcore%2Fapi%2Fmedia-controller.git

Update API description

Change-Id: If2fcb1f5dfbb98bf09c07cfd8e43782c9b4df58e
---

diff --git a/include/media_controller_playlist.h b/include/media_controller_playlist.h
index 97dc6ce..8881a91 100755
--- a/include/media_controller_playlist.h
+++ b/include/media_controller_playlist.h
@@ -160,19 +160,19 @@ int mc_playlist_foreach_item(mc_playlist_h playlist, mc_playlist_item_cb callbac
 
 /**
  * @brief Gets the number of playlists for the given @a app_id.
- * @details The media controller server can have several playlists. You can get playlist count only for the activated media controller server.
- *            If @a app_id is not an ID of an activated media controller server, this function will return #MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER.
+ * @details The media controller server can have several playlists. You can get a count of playlists only for the activated media controller server.
+ *            If @a app_id is not the ID of an activated media controller server, this function returns #MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER.
  * @since_tizen 5.5
  *
  * @privlevel public
  * @privilege %http://tizen.org/privilege/mediacontroller.server \n
  *               %http://tizen.org/privilege/mediacontroller.client \n
  *
- * @remarks You must add privilege %http://tizen.org/privilege/mediacontroller.server, if you are the media controller server.
- *              You must add privilege %http://tizen.org/privilege/mediacontroller.client, if you are the media controller client.
+ * @remarks You must add privilege %http://tizen.org/privilege/mediacontroller.server, if your application is a media controller server.
+ *              You must add privilege %http://tizen.org/privilege/mediacontroller.client, if your application is a media controller client.
  *
  * @param[in] app_id                The app_id of the media controller server
- * @param[out] playlist_count      The number of playlists the media controller server has.
+ * @param[out] playlist_count      The number of playlists that the media controller server has.
  *
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -187,7 +187,7 @@ int mc_playlist_foreach_item(mc_playlist_h playlist, mc_playlist_item_cb callbac
 int mc_playlist_get_playlist_count(const char *app_id, int *playlist_count);
 
 /**
- * @brief Iterates through playlists of the media controller server.
+ * @brief Iterates over playlists of the media controller server.
  * @details This function iterates through all playlists of the given @a app_id.
  *          The media controller server can have several playlists. You can get playlists only for the activated media controller server.
  *          If @a app_id is not an ID of an activated media controller server, this function will return #MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER.
@@ -199,8 +199,8 @@ int mc_playlist_get_playlist_count(const char *app_id, int *playlist_count);
  * @privilege %http://tizen.org/privilege/mediacontroller.server \n
  *               %http://tizen.org/privilege/mediacontroller.client \n
  *
- * @remarks You must add privilege %http://tizen.org/privilege/mediacontroller.server, if you are the media controller server.
- *              You must add privilege %http://tizen.org/privilege/mediacontroller.client, if you are the media controller client.
+ * @remarks You must add privilege %http://tizen.org/privilege/mediacontroller.server, if your application is a media controller server.
+ *              You must add privilege %http://tizen.org/privilege/mediacontroller.client, if your application is a media controller client.
  *
  * @param[in] app_id         The app_id of the media controller server
  * @param[in] callback       The callback function to be invoked
@@ -233,8 +233,8 @@ int mc_playlist_foreach_playlist(const char *app_id, mc_playlist_cb callback, vo
  * @privilege %http://tizen.org/privilege/mediacontroller.server \n
  *               %http://tizen.org/privilege/mediacontroller.client \n
  *
- * @remarks You must add privilege %http://tizen.org/privilege/mediacontroller.server, if you are the media controller server.
- *              You must add privilege %http://tizen.org/privilege/mediacontroller.client, if you are the media controller client.
+ * @remarks You must add privilege %http://tizen.org/privilege/mediacontroller.server, if your application is a media controller server.
+ *              You must add privilege %http://tizen.org/privilege/mediacontroller.client, if your application is a media controller client.
  *              The @a playlist should be released using mc_playlist_destroy().
  *
  * @param[in] app_id         The app_id of the media controller server