From f5bb5cf1d250826553bc582caa1347dc297886c1 Mon Sep 17 00:00:00 2001 From: hj kim Date: Wed, 24 Jan 2018 13:57:38 +0900 Subject: [PATCH] Fix Doxygen mistakes Change-Id: I772e13cda9cc88cc8041eb3d2af3932c77c95406 --- include/media_controller_client.h | 243 ++++++++++++++++++----------------- include/media_controller_db.h | 6 +- include/media_controller_private.h | 6 +- include/media_controller_server.h | 144 +++++++++++---------- include/media_controller_type.h | 6 +- packaging/capi-media-controller.spec | 2 +- 6 files changed, 205 insertions(+), 202 deletions(-) mode change 100644 => 100755 include/media_controller_db.h diff --git a/include/media_controller_client.h b/include/media_controller_client.h index 1192460..9b25e7a 100755 --- a/include/media_controller_client.h +++ b/include/media_controller_client.h @@ -14,8 +14,8 @@ * limitations under the License. */ -#ifndef __TIZEN_MEDIA_CONTROLLER_CLIENT_H__ -#define __TIZEN_MEDIA_CONTROLLER_CLIENT_H__ +#ifndef __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_CLIENT_H__ +#define __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_CLIENT_H__ #include @@ -40,9 +40,9 @@ extern "C" { * * @remarks The callback is called in the dbus event loop. * - * @param [in] server_name, The app_id of the updated media controller server, it can be used only in the callback. To use outside, make a copy. - * @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_update_cb() fuction + * @param[in] server_name The app_id of the updated media controller server, it can be used only in the callback. To use outside, make a copy. + * @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_update_cb() fuction * * @pre mc_client_set_server_update_cb() * @@ -56,9 +56,9 @@ typedef void (*mc_server_state_updated_cb)(const char *server_name, mc_server_st * * @remarks The callback is called in the dbus event loop. * - * @param [in] server_name, The app_id of the updated media controller server, it can be used only in the callback. To use outside, make a copy. - * @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_update_cb() fuction + * @param[in] server_name The app_id of the updated media controller server, it can be used only in the callback. To use outside, make a copy. + * @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_update_cb() fuction * * @pre mc_client_set_playback_update_cb() * @@ -72,9 +72,9 @@ typedef void (*mc_playback_updated_cb)(const char *server_name, mc_playback_h pl * * @remarks The callback is called in the dbus event loop. * - * @param [in] server_name, The app_id of the updated media controller server, it can be used only in the callback. To use outside, make a copy. - * @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_update_cb() fuction + * @param[in] server_name The app_id of the updated media controller server, it can be used only in the callback. To use outside, make a copy. + * @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_update_cb() fuction * * @pre mc_client_set_metadata_update_cb() * @@ -88,9 +88,9 @@ typedef void (*mc_metadata_updated_cb)(const char *server_name, mc_metadata_h me * * @remarks The callback is called in the dbus event loop. * - * @param [in] server_name, The app_id of the updated media controller server, it can be used only in the callback. To use outside, make a copy. - * @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_update_cb() fuction + * @param[in] server_name The app_id of the updated media controller server, it can be used only in the callback. To use outside, make a copy. + * @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_update_cb() fuction * * @pre mc_client_set_shuffle_mode_update_cb() * @@ -104,9 +104,9 @@ typedef void (*mc_shuffle_mode_changed_cb)(const char *server_name, mc_shuffle_m * * @remarks The callback is called in the dbus event loop. * - * @param [in] server_name, The app_id of the updated media controller server, it can be used only in the callback. To use outside, make a copy. - * @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_update_cb() fuction + * @param[in] server_name The app_id of the updated media controller server, it can be used only in the callback. To use outside, make a copy. + * @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_update_cb() fuction * * @pre mc_client_set_repeat_mode_update_cb() * @@ -120,8 +120,8 @@ typedef void (*mc_repeat_mode_changed_cb)(const char *server_name, mc_repeat_mod * * @remarks The callback is called in the dbus event loop. * - * @param [in] server_name, The app_id of the activated media controller server, it can be used only in the callback. To use outside, make a copy. - * @param [in] user_data The user data passed from the mc_client_foreach_server() fuction + * @param[in] server_name The app_id of the activated media controller server, it can be used only in the callback. To use outside, make a copy. + * @param[in] user_data The user data passed from the mc_client_foreach_server() fuction * * @return @c true to continue with the next iteration of the loop, * otherwise @c false to break out of the loop @@ -138,10 +138,10 @@ typedef bool (*mc_activated_server_cb)(const char *server_name, void *user_data) * * @remarks The callback is called in the dbus event loop. * - * @param [in] server_name The app_id of the updated media controller server, it can be used only in the callback. To use outside, make a copy. - * @param [in] result_code The result code of custom command - * @param [in] data The extra data - * @param [in] user_data The user data passed from the mc_client_send_custom_command() fuction + * @param[in] server_name The app_id of the updated media controller server, it can be used only in the callback. To use outside, make a copy. + * @param[in] result_code The result code of custom command + * @param[in] data The extra data + * @param[in] user_data The user data passed from the mc_client_send_custom_command() fuction * * @pre mc_client_send_custom_command() * @@ -155,8 +155,8 @@ typedef void (*mc_command_reply_received_cb)(const char *server_name, int result * * @remarks The callback is called in the dbus event loop. * - * @param [in] server_name, The app_id of the subscribed media controller server, it can be used only in the callback. To use outside, make a copy. - * @param [in] user_data The user data passed from the mc_client_foreach_server_subscribed() fuction + * @param[in] server_name The app_id of the subscribed media controller server, it can be used only in the callback. To use outside, make a copy. + * @param[in] user_data The user data passed from the mc_client_foreach_server_subscribed() fuction * * @return @c true to continue with the next iteration of the loop, * otherwise @c false to break out of the loop @@ -175,9 +175,9 @@ typedef bool (*mc_subscribed_server_cb)(const char *server_name, void *user_data * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @remarks You must release @a client using mc_client_destroy(). + * @remarks The @a client should be released using mc_client_destroy(). * - * @param [out] client The handle to the media controller client + * @param[out] client The handle to the media controller client * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -190,15 +190,15 @@ int mc_client_create(mc_client_h *client); /** * @brief Sets the callback for monitoring status of the media controller server. - * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * @details If media controller client call this function, basically the media controller client recieve the callback from all media controller servers. + * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client - * @param [in] callback The callback to be invoked when the media controller server status is changed - * @param [in] user_data The user data to be passed to the callback function + * @param[in] client The handle to the media controller client + * @param[in] callback The callback to be invoked when the media controller server status is changed + * @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 #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -217,7 +217,7 @@ int mc_client_set_server_update_cb(mc_client_h client, mc_server_state_updated_c * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client + * @param[in] client The handle to the media controller client * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -231,15 +231,15 @@ int mc_client_unset_server_update_cb(mc_client_h client); /** * @brief Sets the callback for monitoring playback status of the media controller server. - * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * @details If media controller client call this function, basically the media controller client recieve the callback from all media controller servers. \n + * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client - * @param [in] callback The callback to be invoked when the playback status is changed - * @param [in] user_data The user data to be passed to the callback function + * @param[in] client The handle to the media controller client + * @param[in] callback The callback to be invoked when the playback status is changed + * @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 #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -258,7 +258,7 @@ int mc_client_set_playback_update_cb(mc_client_h client, mc_playback_updated_cb * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client + * @param[in] client The handle to the media controller client * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -272,15 +272,15 @@ int mc_client_unset_playback_update_cb(mc_client_h client); /** * @brief Sets the callback for monitoring metadata status of the media controller server. - * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * @details If media controller client call this function, basically the media controller client recieve the callback from all media controller servers. + * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client - * @param [in] callback The callback to be invoked when the metadata status is changed - * @param [in] user_data The user data to be passed to the callback function + * @param[in] client The handle to the media controller client + * @param[in] callback The callback to be invoked when the metadata status is changed + * @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 #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -299,7 +299,7 @@ int mc_client_set_metadata_update_cb(mc_client_h client, mc_metadata_updated_cb * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client + * @param[in] client The handle to the media controller client * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -313,15 +313,15 @@ int mc_client_unset_metadata_update_cb(mc_client_h client); /** * @brief Sets the callback for monitoring shuffle mode of the media controller server. - * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * @details If media controller client call this function, basically the media controller client recieve the callback from all media controller servers. + * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client - * @param [in] callback The callback to be invoked when the shuffle mode is changed - * @param [in] user_data The user data to be passed to the callback function + * @param[in] client The handle to the media controller client + * @param[in] callback The callback to be invoked when the shuffle mode is changed + * @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 #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -340,7 +340,7 @@ int mc_client_set_shuffle_mode_update_cb(mc_client_h client, mc_shuffle_mode_cha * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client + * @param[in] client The handle to the media controller client * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -354,15 +354,15 @@ int mc_client_unset_shuffle_mode_update_cb(mc_client_h client); /** * @brief Sets the callback for monitoring repeat mode of the media controller server. - * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * @details If media controller client call this function, basically the media controller client recieve the callback from all media controller servers. + * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client - * @param [in] callback The callback to be invoked when the repeat mode is changed - * @param [in] user_data The user data to be passed to the callback function + * @param[in] client The handle to the media controller client + * @param[in] callback The callback to be invoked when the repeat mode is changed + * @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 #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -381,7 +381,7 @@ int mc_client_set_repeat_mode_update_cb(mc_client_h client, mc_repeat_mode_chang * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client + * @param[in] client The handle to the media controller client * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -395,20 +395,20 @@ int mc_client_unset_repeat_mode_update_cb(mc_client_h client); /** * @brief Subscribes media controller server for monitoring status. - * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * @details If media controller client subscribe media controller server, \n * the media controller client recieve callback from subscribed media controller server. \n * If media controller client subscribe media controller server one or more, \n * the media controller client can recieve 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 + * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client - * @param [in] subscription_type The subscription type - * @param [in] server_name The app_id of the media controller server + * @param[in] client The handle to the media controller client + * @param[in] subscription_type The subscription type + * @param[in] server_name The app_id of the media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -423,19 +423,19 @@ int mc_client_subscribe(mc_client_h client, mc_subscription_type_e subscription_ /** * @brief Unsubscribes media controller server for monitoring status. - * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * @details If media controller client unsubscribe media controller server, \n * the media controller client don't recieve callback from unsubscribed media controller server. \n * If media controller client unsubscribe all subscibed media controller server, \n * the media controller client don't recieve callback from all media controller server. \n * After unset and set update callback function is called again, the media controller client can recieve callback from all media controller servers. \n + * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client - * @param [in] subscription_type The subscription type - * @param [in] server_name The app_id of the media controller server + * @param[in] client The handle to the media controller client + * @param[in] subscription_type The subscription type + * @param[in] server_name The app_id of the media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -454,10 +454,10 @@ int mc_client_unsubscribe(mc_client_h client, mc_subscription_type_e subscriptio * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to 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] user_data The user data to be passed to the callback function + * @param[in] client The handle to 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] user_data The user data to be passed to the callback function * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -473,10 +473,10 @@ int mc_client_foreach_server_subscribed(mc_client_h client, mc_subscription_type * @brief Gets the playback state. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * - * @remarks You must release @a playback using @c mc_client_destroy_playback(). + * @remarks The @a playback should be released using @c mc_client_destroy_playback(). * - * @param [in] playback The handle to playback - * @param [out] state The state of the playback + * @param[in] playback The handle to playback + * @param[out] state The state of the playback * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -491,10 +491,10 @@ int mc_client_get_playback_state(mc_playback_h playback, mc_playback_states_e *s * @brief Gets the playback position. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * - * @remarks You must release @a playback using @c mc_client_destroy_playback(). + * @remarks The @a playback should be released using @c mc_client_destroy_playback(). * - * @param [in] playback The handle to playback - * @param [out] position The position of the playback in milliseconds + * @param[in] playback The handle to playback + * @param[out] position The position of the playback in milliseconds * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -506,10 +506,10 @@ int mc_client_get_playback_state(mc_playback_h playback, mc_playback_states_e *s int mc_client_get_playback_position(mc_playback_h playback, unsigned long long *position); /** - * @brief Destroys playback + * @brief Destroys playback. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * - * @param [in] playback The handle to playback + * @param[in] playback The handle to playback * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -523,13 +523,13 @@ int mc_client_destroy_playback(mc_playback_h playback); * @brief Gets the metadata. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * - * @remarks You must release @a metadata using @c mc_client_destroy_metadata(). \n - * And also You must release @a value using free(). + * @remarks The @a metadata should be released using @c mc_client_destroy_metadata(). \n + * And also The @a value should be released using free(). * If the attribute value of the metadata is empty, return value is NULL. * - * @param [in] metadata The handle to metadata - * @param [in] attribute The key attribute name to get - * @param [out] value The value of the attribute + * @param[in] metadata The handle to metadata + * @param[in] attribute The key attribute name to get + * @param[out] value The value of the attribute * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -540,10 +540,10 @@ int mc_client_destroy_playback(mc_playback_h playback); int mc_client_get_metadata(mc_metadata_h metadata, mc_meta_e attribute, char **value); /** - * @brief Destroys metadata + * @brief Destroys metadata. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * - * @param [in] metadata The handle to metadata + * @param[in] metadata The handle to metadata * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -562,11 +562,12 @@ int mc_client_destroy_metadata(mc_metadata_h metadata); * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @remarks If there is no activated media controller server, return value of the server name is NULL. + * @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 * - * @param [in] client The handle to the media controller client - * @param [out] server_name The app_id of the latest media controller server - * @param [out] server_state The state of the latest media controller server + * @param[in] client The handle to the media controller client + * @param[out] server_name The app_id of the latest media controller server + * @param[out] server_state The state of the latest media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -583,12 +584,12 @@ int mc_client_get_latest_server_info(mc_client_h client, char **server_name, mc_ * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @remarks You must release @a playback using @c mc_client_destroy_playback(). \n + * @remarks The @a playback should be released using @c mc_client_destroy_playback(). \n * If there is no playback info, return value of the playback is NULL. * - * @param [in] client The handle to the media controller client - * @param [in] server_name The app_id of the server to requesting - * @param [out] playback The handle to playback + * @param[in] client The handle to the media controller client + * @param[in] server_name The app_id of the server to requesting + * @param[out] playback The handle to playback * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -605,12 +606,12 @@ int mc_client_get_server_playback_info(mc_client_h client, const char *server_na * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @remarks You must release @a metadata using @c mc_client_destroy_metadata(). \n + * @remarks The @a metadata should be released using @c mc_client_destroy_metadata(). \n * If there is no metadata, return value of the metadata is NULL. * - * @param [in] client The handle to the media controller client - * @param [in] server_name The app_id of the server to requesting - * @param [out] metadata The handle to metadata + * @param[in] client The handle to the media controller client + * @param[in] server_name The app_id of the server to requesting + * @param[out] metadata The handle to metadata * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -629,9 +630,9 @@ int mc_client_get_server_metadata(mc_client_h client, const char *server_name, m * * @remarks If there is no shuffle mode info, return value is #MC_SHUFFLE_MODE_OFF. * - * @param [in] client The handle to the media controller client - * @param [in] server_name The app_id of the server to requesting - * @param [out] mode The info of the latest shuffle mode + * @param[in] client The handle to the media controller client + * @param[in] server_name The app_id of the server to requesting + * @param[out] mode The info of the latest shuffle mode * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -650,9 +651,9 @@ int mc_client_get_server_shuffle_mode(mc_client_h client, const char *server_nam * * @remarks If there is no repeat mode info, return value is #MC_REPEAT_MODE_OFF. * - * @param [in] client The handle to the media controller client - * @param [in] server_name The app_id of the server to requesting - * @param [out] mode The info of the latest shuffle mode + * @param[in] client The handle to the media controller client + * @param[in] server_name The app_id of the server to requesting + * @param[out] mode The info of the latest shuffle mode * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -668,9 +669,9 @@ int mc_client_get_server_repeat_mode(mc_client_h client, const char *server_name * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client - * @param [in] callback The callback to be invoked when the list of the registered media controller server created completely. - * @param [in] user_data The user data to be passed to the callback function + * @param[in] client The handle to the media controller client + * @param[in] callback The callback to be invoked when the list of the registered media controller server created completely. + * @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 #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -688,9 +689,9 @@ int mc_client_foreach_server(mc_client_h client, mc_activated_server_cb callback * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client - * @param [in] server_name The app_id of the media controller server - * @param [in] state The playback state to send to media controller server + * @param[in] client The handle to the media controller client + * @param[in] server_name The app_id of the media controller server + * @param[in] state The playback state to send to media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -709,9 +710,9 @@ int mc_client_send_playback_state_command(mc_client_h client, const char *server * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client - * @param [in] server_name The app_id of the media controller server - * @param [in] position The playback position to send to media controller server + * @param[in] client The handle to the media controller client + * @param[in] server_name The app_id of the media controller server + * @param[in] position The playback position to send to media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -730,9 +731,9 @@ int mc_client_send_playback_position_command(mc_client_h client, const char *ser * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client - * @param [in] server_name The app_id of the media controller server - * @param [in] shuffle_mode The shuffle mode to send to media controller server + * @param[in] client The handle to the media controller client + * @param[in] server_name The app_id of the media controller server + * @param[in] shuffle_mode The shuffle mode to send to media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -751,9 +752,9 @@ int mc_client_send_shuffle_mode_command(mc_client_h client, const char *server_n * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client - * @param [in] server_name The app_id of the media controller server - * @param [in] repeat_mode The repeat mode to send to media controller server + * @param[in] client The handle to the media controller client + * @param[in] server_name The app_id of the media controller server + * @param[in] repeat_mode The repeat mode to send to media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -767,18 +768,18 @@ int mc_client_send_repeat_mode_command(mc_client_h client, const char *server_na /** * @brief Sends the custom command to server. - * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * @details If there is the result for comand from server, the media controller client will get the result of the custom command by mc_command_reply_received_cb() callback. + * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client * - * @param [in] client The handle to the media controller client - * @param [in] server_name The app_id of the media controller server - * @param [in] command The command to be sent - * @param [in] data The extra data - * @param [in] callback The callback to be invoked when the custom command execute completely. - * @param [in] user_data The user data to be passed to the callback function + * @param[in] client The handle to the media controller client + * @param[in] server_name The app_id of the media controller server + * @param[in] command The command to be sent + * @param[in] data The extra data + * @param[in] callback The callback to be invoked when the custom command execute completely. + * @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 #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -792,7 +793,7 @@ int mc_client_send_custom_command(mc_client_h client, const char *server_name, c /** * @brief Destroys client. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif - * @param [in] client The handle to the media controller client + * @param[in] client The handle to the media controller client * @return @c 0 on success, * otherwise a negative error value * @retval #METADATA_EXTRACTOR_ERROR_NONE Successful @@ -811,4 +812,4 @@ int mc_client_destroy(mc_client_h client); } #endif /* __cplusplus */ -#endif /* __TIZEN_MEDIA_CONTROLLER_CLIENT_H__ */ +#endif /* __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_CLIENT_H__ */ diff --git a/include/media_controller_db.h b/include/media_controller_db.h old mode 100644 new mode 100755 index ab7c692..3ffaf14 --- a/include/media_controller_db.h +++ b/include/media_controller_db.h @@ -14,8 +14,8 @@ * limitations under the License. */ -#ifndef __TIZEN_MEDIA_CONTROLLER_DB_H__ -#define __TIZEN_MEDIA_CONTROLLER_DB_H__ +#ifndef __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_DB_H__ +#define __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_DB_H__ #include #include @@ -91,4 +91,4 @@ int mc_db_update_server_state(void *handle, const char *server_name, mc_server_s int mc_db_update_latest_server_table(void *handle, const char *server_name); -#endif /*__MEDIA_CONTROL_DB_H__*/ +#endif /*__TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_DB_H__*/ diff --git a/include/media_controller_private.h b/include/media_controller_private.h index b81cd20..5458a47 100755 --- a/include/media_controller_private.h +++ b/include/media_controller_private.h @@ -14,8 +14,8 @@ * limitations under the License. */ -#ifndef __TIZEN_MEDIA_CONTROLLER_PRIVATE_H__ -#define __TIZEN_MEDIA_CONTROLLER_PRIVATE_H__ +#ifndef __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_PRIVATE_H__ +#define __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_PRIVATE_H__ #ifdef __cplusplus @@ -276,4 +276,4 @@ int mc_ipc_service_connect(const int type); } #endif /* __cplusplus */ -#endif /* __TIZEN_MEDIA_CONTROLLER_PRIVATE_H__ */ +#endif /* __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_PRIVATE_H__ */ diff --git a/include/media_controller_server.h b/include/media_controller_server.h index 96834cf..3741cda 100755 --- a/include/media_controller_server.h +++ b/include/media_controller_server.h @@ -14,8 +14,8 @@ * limitations under the License. */ -#ifndef __TIZEN_MEDIA_CONTROLLER_SERVER_H__ -#define __TIZEN_MEDIA_CONTROLLER_SERVER_H__ +#ifndef __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_SERVER_H__ +#define __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_SERVER_H__ #include @@ -40,9 +40,9 @@ extern "C" { * * @remarks The callback is called in the dbus event loop. * - * @param [in] client_name The app_id of the media controller client, it can be used only in the callback. To use outside, make a copy. - * @param [in] state The received playback state - * @param [in] user_data The user data passed from the mc_server_set_playback_state_command_received_cb() fuction + * @param[in] client_name The app_id of the media controller client, it can be used only in the callback. To use outside, make a copy. + * @param[in] state The received playback state + * @param[in] user_data The user data passed from the mc_server_set_playback_state_command_received_cb() fuction * * @pre mc_server_set_playback_state_command_received_cb() * @@ -56,9 +56,9 @@ typedef void (*mc_server_playback_state_command_received_cb)(const char* client_ * * @remarks The callback is called in the dbus event loop. * - * @param [in] client_name The app_id of the media controller client, it can be used only in the callback. To use outside, make a copy. - * @param [in] position The received playback position - * @param [in] user_data The user data passed from the mc_server_set_playback_position_command_received_cb() fuction + * @param[in] client_name The app_id of the media controller client, it can be used only in the callback. To use outside, make a copy. + * @param[in] position The received playback position + * @param[in] user_data The user data passed from the mc_server_set_playback_position_command_received_cb() fuction * * @pre mc_server_set_playback_position_command_received_cb() * @@ -72,9 +72,9 @@ typedef void (*mc_server_playback_position_command_received_cb)(const char* clie * * @remarks The callback is called in the dbus event loop. * - * @param [in] client_name The app_id of the media controller client, it can be used only in the callback. To use outside, make a copy. - * @param [in] shuffle_mode The received shuffle_mode - * @param [in] user_data The user data passed from the mc_server_set_shuffle_mode_command_received_cb() fuction + * @param[in] client_name The app_id of the media controller client, it can be used only in the callback. To use outside, make a copy. + * @param[in] shuffle_mode The received shuffle_mode + * @param[in] user_data The user data passed from the mc_server_set_shuffle_mode_command_received_cb() fuction * * @pre mc_server_set_shuffle_mode_command_received_cb() * @@ -88,9 +88,9 @@ typedef void (*mc_server_shuffle_mode_command_received_cb)(const char* client_na * * @remarks The callback is called in the dbus event loop. * - * @param [in] client_name The app_id of the media controller client, it can be used only in the callback. To use outside, make a copy. - * @param [in] repeat_mode The received repeat mode - * @param [in] user_data The user data passed from the mc_server_set_repeat_mode_command_received_cb() fuction + * @param[in] client_name The app_id of the media controller client, it can be used only in the callback. To use outside, make a copy. + * @param[in] repeat_mode The received repeat mode + * @param[in] user_data The user data passed from the mc_server_set_repeat_mode_command_received_cb() fuction * * @pre mc_server_set_repeat_mode_command_received_cb() * @@ -106,10 +106,10 @@ typedef void (*mc_server_repeat_mode_command_received_cb)(const char* client_nam * * @remarks The callback is called in the dbus event loop. * - * @param [in] client_name The app_id of the media controller client, it can be used only in the callback. To use outside, make a copy. - * @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_command_received_cb() fuction + * @param[in] client_name The app_id of the media controller client, it can be used only in the callback. To use outside, make a copy. + * @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_command_received_cb() fuction * * @pre mc_server_set_custom_command_received_cb() * @@ -120,12 +120,13 @@ typedef void (*mc_server_custom_command_received_cb)(const char* client_name, co /** * @brief Creates a media controller server. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif - * @remarks You must release @a server using mc_server_destroy(). * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server * - * @param [out] server The handle to media controller server + * @remarks The @a server should be released using mc_server_destroy(). + * + * @param[out] server The handle to media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -137,10 +138,10 @@ typedef void (*mc_server_custom_command_received_cb)(const char* client_name, co int mc_server_create(mc_server_h *server); /** - * @brief Sets the playback state to update the latest state info + * @brief Sets the playback state to update the latest state info. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif - * @param [in] server The handle to media controller server - * @param [in] state The state to set + * @param[in] server The handle to media controller server + * @param[in] state The state to set * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -155,10 +156,10 @@ int mc_server_create(mc_server_h *server); int mc_server_set_playback_state(mc_server_h server, mc_playback_states_e state); /** - * @brief Sets the playback position to update the latest playback info + * @brief Sets the playback position to update the latest playback info. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif - * @param [in] server The handle to media controller server - * @param [in] position The position to set in milliseconds + * @param[in] server The handle to media controller server + * @param[in] position The position to set in milliseconds * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -173,14 +174,14 @@ int mc_server_set_playback_state(mc_server_h server, mc_playback_states_e state) int mc_server_set_playback_position(mc_server_h server, unsigned long long position); /** - * @brief Update the modified playback info - * @details If this API is called, the updated playback information will be sent to the controller. + * @brief Updates the modified playback info. + * @details If this function is called, the updated playback information will be sent to the controller. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server * - * @param [in] server The handle to media controller server + * @param[in] server The handle to media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -194,15 +195,15 @@ int mc_server_set_playback_position(mc_server_h server, unsigned long long posit int mc_server_update_playback_info(mc_server_h server); /** - * @brief Sets the metadata to update the latest metadata info + * @brief Sets the metadata to update the latest metadata info. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server * - * @param [in] server The handle to media controller server - * @param [in] attribute The key attribute name to set - * @param [in] value The value of the attribute + * @param[in] server The handle to media controller server + * @param[in] attribute The key attribute name to set + * @param[in] value The value of the attribute * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -218,14 +219,14 @@ int mc_server_update_playback_info(mc_server_h server); int mc_server_set_metadata(mc_server_h server, mc_meta_e attribute, const char *value); /** - * @brief Update the modified metadata info. - * @details If this API is called, the updated metadata will be sent to all controllers. + * @brief Updates the modified metadata info. + * @details If this function is called, the updated metadata will be sent to all controllers. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server * - * @param [in] server The handle to media controller server + * @param[in] server The handle to media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -239,15 +240,15 @@ int mc_server_set_metadata(mc_server_h server, mc_meta_e attribute, const char * int mc_server_update_metadata(mc_server_h server); /** - * @brief Update the modified shuffle mode - * @details If this API is called, the updated mode information will be sent to all controllers. + * @brief Updates the modified shuffle mode. + * @details If this function is called, the updated mode information will be sent to all controllers. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server * - * @param [in] server The handle to media controller server - * @param [in] mode The shuffle mode to update the latest status + * @param[in] server The handle to media controller server + * @param[in] mode The shuffle mode to update the latest status * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -261,15 +262,15 @@ int mc_server_update_metadata(mc_server_h server); int mc_server_update_shuffle_mode(mc_server_h server, mc_shuffle_mode_e mode); /** - * @brief Updates the modified repeat mode - * @details If this API is called, the updated mode information will be sent to all controllers. + * @brief Updates the modified repeat mode. + * @details If this function is called, the updated mode information will be sent to all controllers. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server * - * @param [in] server The handle to media controller server - * @param [in] mode The repeat mode to update the latest status + * @param[in] server The handle to media controller server + * @param[in] mode The repeat mode to update the latest status * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -289,9 +290,9 @@ int mc_server_update_repeat_mode(mc_server_h server, mc_repeat_mode_e mode); * @privlevel public * @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 playback command from client. - * @param [in] user_data The user data to be passed to the callback function + * @param[in] server The handle to media controller server + * @param[in] callback The callback to be invoked when media controller server receives playback 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 * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -310,7 +311,7 @@ int mc_server_set_playback_state_command_received_cb(mc_server_h server, mc_serv * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server * - * @param [in] server The handle to media controller server + * @param[in] server The handle to media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -329,9 +330,9 @@ int mc_server_unset_playback_state_command_received_cb(mc_server_h server); * @privlevel public * @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] user_data The user data to be passed to the callback function + * @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] user_data The user data to be passed to the callback function * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -350,7 +351,7 @@ int mc_server_set_playback_position_command_received_cb(mc_server_h server, mc_s * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server * - * @param [in] server The handle to media controller server + * @param[in] server The handle to media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -369,9 +370,9 @@ int mc_server_unset_playback_position_command_received_cb(mc_server_h server); * @privlevel public * @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] user_data The user data to be passed to the callback function + * @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] user_data The user data to be passed to the callback function * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -390,7 +391,7 @@ int mc_server_set_shuffle_mode_command_received_cb(mc_server_h server, mc_server * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server * - * @param [in] server The handle to media controller server + * @param[in] server The handle to media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -409,9 +410,9 @@ int mc_server_unset_shuffle_mode_command_received_cb(mc_server_h server); * @privlevel public * @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] user_data The user data to be passed to the callback function + * @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] user_data The user data to be passed to the callback function * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -430,7 +431,7 @@ int mc_server_set_repeat_mode_command_received_cb(mc_server_h server, mc_server_ * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server * - * @param [in] server The handle to media controller server + * @param[in] server The handle to media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -449,9 +450,9 @@ int mc_server_unset_repeat_mode_command_received_cb(mc_server_h server); * @privlevel public * @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] user_data The user data to be passed to the callback function + * @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] user_data The user data to be passed to the callback function * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -470,7 +471,7 @@ int mc_server_set_custom_command_received_cb(mc_server_h server, mc_server_custo * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server * - * @param [in] server The handle to media controller server + * @param[in] server The handle to media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -485,15 +486,16 @@ int mc_server_unset_custom_command_received_cb(mc_server_h server); /** * @brief Sends a reply for the requested command to the client. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif - * @remarks When server recieve command, this API can be called by mc_server_custom_command_received_cb(). * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server * - * @param [in] server The handle to media controller server - * @param [in] client_name The app_id of the media controller client - * @param [in] result_code The result code of custom command - * @param [in] data The extra data + * @remarks When server recieve command, this function can be called by mc_server_custom_command_received_cb(). + * + * @param[in] server The handle to media controller server + * @param[in] client_name The app_id of the media controller client + * @param[in] result_code The result code of custom command + * @param[in] data The extra data * @return @c 0 on success, * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful @@ -509,7 +511,7 @@ int mc_server_send_command_reply(mc_server_h server, const char *client_name, in /** * @brief Destroys media controller server. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif - * @param [in] server The handle to media controller server + * @param[in] server The handle to media controller server * @return @c 0 on success, * otherwise a negative error value * @retval #METADATA_EXTRACTOR_ERROR_NONE Successful @@ -528,4 +530,4 @@ int mc_server_destroy(mc_server_h server); } #endif /* __cplusplus */ -#endif /* __TIZEN_MEDIA_CONTROLLER_SERVER_H__ */ +#endif /* __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_SERVER_H__ */ diff --git a/include/media_controller_type.h b/include/media_controller_type.h index 60e9572..454c4ff 100755 --- a/include/media_controller_type.h +++ b/include/media_controller_type.h @@ -14,8 +14,8 @@ * limitations under the License. */ -#ifndef __TIZEN_MEDIA_CONTROLLER_TYPE_H__ -#define __TIZEN_MEDIA_CONTROLLER_TYPE_H__ +#ifndef __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_TYPE_H__ +#define __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_TYPE_H__ #include #include @@ -154,4 +154,4 @@ typedef enum { } #endif /* __cplusplus */ -#endif /* __TIZEN_MEDIA_CONTROLLER_TYPE_H__ */ +#endif /* __TIZEN_MULTIMEDIA_MEDIA_CONTROLLER_TYPE_H__ */ diff --git a/packaging/capi-media-controller.spec b/packaging/capi-media-controller.spec index 5cbec56..2aa589c 100755 --- a/packaging/capi-media-controller.spec +++ b/packaging/capi-media-controller.spec @@ -1,6 +1,6 @@ Name: capi-media-controller Summary: A media controller library in Tizen Native API -Version: 0.1.51 +Version: 0.1.52 Release: 1 Group: Multimedia/API License: Apache-2.0 -- 2.7.4