From: Krishna Kant Jaju Date: Fri, 8 Mar 2024 04:19:41 +0000 (+0530) Subject: [9.0] Remove conditional statements for Mobile/Wearable profile X-Git-Tag: accepted/tizen/unified/20240308.174205^0 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=860c2da5f161f0c99161edd4563498dfb757171f;p=platform%2Fcore%2Fpim%2Fcontacts-service.git [9.0] Remove conditional statements for Mobile/Wearable profile Change-Id: Ia005df58411e8b5af848932466f7601b046e0cdf Signed-off-by: Krishna Kant Jaju --- diff --git a/include/contacts_db.h b/include/contacts_db.h index 8292b5f..0b31298 100644 --- a/include/contacts_db.h +++ b/include/contacts_db.h @@ -46,7 +46,7 @@ extern "C" /** * @brief Enumeration for contact change state. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_CHANGE_INSERTED, /**< Inserted */ @@ -57,7 +57,7 @@ typedef enum { /** * @brief Called when the designated view changes. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] view_uri The view URI * @param[in] user_data The user data passed from the callback registration function * @pre The callback must be registered using contacts_db_add_changed_cb(). @@ -68,7 +68,7 @@ typedef void (*contacts_db_changed_cb)(const char *view_uri, void *user_data); /** * @brief Inserts a record to the contacts database. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.write * @privilege %http://tizen.org/privilege/callhistory.write @@ -107,7 +107,7 @@ int contacts_db_insert_record(contacts_record_h record, int *id); * @brief Gets a record from the contacts database. * @details This function creates a new contact handle from the contacts database by the given @a record_id. \n * @a record will be created, which is filled with contact information. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @privilege %http://tizen.org/privilege/callhistory.read @@ -144,7 +144,7 @@ int contacts_db_get_record(const char *view_uri, int record_id, contacts_record_ /** * @brief Updates a record in the contacts database. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.write * @privilege %http://tizen.org/privilege/callhistory.write @@ -180,7 +180,7 @@ int contacts_db_update_record(contacts_record_h record); /** * @brief Deletes a record from the contacts database with related child records. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.write * @privilege %http://tizen.org/privilege/callhistory.write @@ -216,7 +216,7 @@ int contacts_db_delete_record(const char *view_uri, int record_id); /** * @brief Replaces an id-identified record with the given record. * @details Now, this API supports only _contacts_contact view_uri. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.write * @remarks The write-once value of @a record is not replaced. \n @@ -247,7 +247,7 @@ int contacts_db_replace_record(contacts_record_h record, int id); /** * @brief Retrieves all records and returns the results list. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @privilege %http://tizen.org/privilege/callhistory.read @@ -286,7 +286,7 @@ int contacts_db_get_all_records(const char *view_uri, int offset, int limit, con /** * @brief Uses a query to find records. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @privilege %http://tizen.org/privilege/callhistory.read @@ -325,7 +325,7 @@ int contacts_db_get_records_with_query(contacts_query_h query, int offset, int l /** * @brief Inserts multiple records to the contacts database. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.write * @privilege %http://tizen.org/privilege/callhistory.write @@ -362,7 +362,7 @@ int contacts_db_insert_records(contacts_list_h record_list, int **ids, int *coun /** * @brief Updates multiple records in the contacts database. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.write * @privilege %http://tizen.org/privilege/callhistory.write @@ -397,7 +397,7 @@ int contacts_db_update_records(contacts_list_h record_list); /** * @brief Deletes multiple records in the contacts database with related child records. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.write * @privilege %http://tizen.org/privilege/callhistory.write @@ -434,7 +434,7 @@ int contacts_db_delete_records(const char *view_uri, int record_id_array[], int /** * @brief Replaces database records identified by given ids with a given record list. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.write * @remarks The write-once value of record is not replaced. \n @@ -466,7 +466,7 @@ int contacts_db_replace_records(contacts_list_h list, int record_id_array[], int /** * @brief Gets the current contacts database version. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @privilege %http://tizen.org/privilege/callhistory.read @@ -491,7 +491,7 @@ int contacts_db_get_current_version(int *contacts_db_version); /** * @brief Registers a callback function to be invoked when a record changes. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @privilege %http://tizen.org/privilege/callhistory.read @@ -529,7 +529,7 @@ int contacts_db_add_changed_cb(const char *view_uri, contacts_db_changed_cb call /** * @brief Unregisters a callback function. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] view_uri The view URI of records whose changes are monitored * @param[in] callback The callback function to register * @param[in] user_data The user data to be passed to the callback function @@ -554,7 +554,7 @@ int contacts_db_remove_changed_cb(const char *view_uri, contacts_db_changed_cb c * @details This function will find all changed records since the given @a contacts_db_version. \n * Now, support @ref CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_contact_updated_info, @ref CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_group_updated_info \n * @ref CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_my_profile_updated_info and @ref CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_grouprel_updated_info. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @remarks You must release @a record_list using contacts_list_destroy(). @@ -588,7 +588,7 @@ int contacts_db_get_changes_by_version(const char *view_uri, /** * @brief Finds records based on a given keyword. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @remarks You must release @a record_list using contacts_list_destroy(). \n @@ -619,7 +619,7 @@ int contacts_db_search_records(const char *view_uri, const char *keyword, int of /** * @brief Finds records based on given query and keyword. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @remarks You must release @a record_list using contacts_list_destroy(). \n @@ -651,7 +651,7 @@ int contacts_db_search_records_with_query(contacts_query_h query, const char *ke /** * @brief Finds records based on a keyword and range. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @remarks You must release @a record_list using contacts_list_destroy(). \n @@ -794,7 +794,7 @@ int contacts_db_search_records_with_range_for_snippet(const char *view_uri, cons /** * @brief Gets the number of records in a specific view. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @privilege %http://tizen.org/privilege/callhistory.read @@ -828,7 +828,7 @@ int contacts_db_get_count(const char *view_uri, int *count); /** * @brief Gets the number of records matching a query. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @privilege %http://tizen.org/privilege/callhistory.read @@ -862,7 +862,7 @@ int contacts_db_get_count_with_query(contacts_query_h query, int *count); /** * @brief Gets the last successful changed contacts database version on the current connection. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @privilege %http://tizen.org/privilege/callhistory.read diff --git a/include/contacts_errors.h b/include/contacts_errors.h index 7f453ed..4797d75 100644 --- a/include/contacts_errors.h +++ b/include/contacts_errors.h @@ -44,7 +44,7 @@ extern "C" /** * @brief Enumeration for contacts errors. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { /* GENERAL */ diff --git a/include/contacts_filter.h b/include/contacts_filter.h index 612b3d9..f9e3881 100644 --- a/include/contacts_filter.h +++ b/include/contacts_filter.h @@ -46,7 +46,7 @@ extern "C" /** * @brief Enumeration for Contacts match string flags. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_MATCH_EXACTLY, /**< Full string, case-sensitive */ @@ -60,7 +60,7 @@ typedef enum { /** * @brief Enumeration for Contacts match int flags. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_MATCH_EQUAL, /**< '=' */ @@ -75,7 +75,7 @@ typedef enum { /** * @brief Enumeration for Contacts filter operators. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_FILTER_OPERATOR_AND, /**< AND */ @@ -85,7 +85,7 @@ typedef enum { /** * @brief Creates a filter. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @remarks You must release @a filter using contacts_filter_destroy(). * @param[in] view_uri The view URI of a filter * @param[out] filter The filter handle @@ -104,7 +104,7 @@ int contacts_filter_create(const char *view_uri, contacts_filter_h *filter); /** * @brief Destroys a filter. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] filter The filter handle * @return @c 0 on success, * otherwise a negative error value @@ -119,7 +119,7 @@ int contacts_filter_destroy(contacts_filter_h filter); /** * @brief Adds a condition for a string type property. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] filter The filter handle * @param[in] property_id The property ID to add a condition * @param[in] match The match flag @@ -137,7 +137,7 @@ int contacts_filter_add_str(contacts_filter_h filter, unsigned int property_id, /** * @brief Adds a condition for an integer type property. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] filter The filter handle * @param[in] property_id The property ID to add a condition * @param[in] match The match flag @@ -155,7 +155,7 @@ int contacts_filter_add_int(contacts_filter_h filter, unsigned int property_id, /** * @brief Adds a condition for a long int type property. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] filter The filter handle * @param[in] property_id The property ID to add a condition * @param[in] match The match flag @@ -173,7 +173,7 @@ int contacts_filter_add_lli(contacts_filter_h filter, unsigned int property_id, /** * @brief Adds a condition for a double type property. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] filter The filter handle * @param[in] property_id The property ID to add a condition * @param[in] match The match flag @@ -191,7 +191,7 @@ int contacts_filter_add_double(contacts_filter_h filter, unsigned int property_i /** * @brief Adds a condition for a boolean type property. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] filter The filter handle * @param[in] property_id The property ID to add a condition * @param[in] match_value The match value @@ -208,7 +208,7 @@ int contacts_filter_add_bool(contacts_filter_h filter, unsigned int property_id, /** * @brief Adds an operator between conditions. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] filter The filter handle * @param[in] operator_type The operator type * @return @c 0 on success, @@ -226,7 +226,7 @@ int contacts_filter_add_operator(contacts_filter_h filter, contacts_filter_opera /** * @brief Adds a filter to a given filter. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] parent_filter The parent filter handle * @param[in] child_filter The child filter handle * @return @c 0 on success, diff --git a/include/contacts_query.h b/include/contacts_query.h index 080e581..b46c063 100644 --- a/include/contacts_query.h +++ b/include/contacts_query.h @@ -46,7 +46,7 @@ extern "C" /** * @brief Creates a query. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @remarks You must release @a query using contacts_query_destroy(). * @param[in] view_uri The view URI of a query * @param[out] query The filter handle @@ -65,7 +65,7 @@ int contacts_query_create(const char *view_uri, contacts_query_h *query); /** * @brief Destroys a query. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] query The query handle * @return @c 0 on success, * otherwise a negative error value @@ -80,7 +80,7 @@ int contacts_query_destroy(contacts_query_h query); /** * @brief Adds property IDs for projection. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] query The query handle * @param[in] property_id_array The property ID array * @param[in] count The number of property IDs @@ -96,7 +96,7 @@ int contacts_query_set_projection(contacts_query_h query, unsigned int property_ /** * @brief Sets the "distinct" option for projection. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] query The query handle * @param[in] set Set @c true to set the distinct option for projection, * otherwise @c false to unset the distinct option @@ -112,7 +112,7 @@ int contacts_query_set_distinct(contacts_query_h query, bool set); /** * @brief Sets a filter for query. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] query The query handle * @param[in] filter The filter handle * @return @c 0 on success, @@ -128,7 +128,7 @@ int contacts_query_set_filter(contacts_query_h query, contacts_filter_h filter); /** * @brief Sets a sort mode for query. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] query The query handle * @param[in] property_id The property ID to sort * @param[in] is_ascending Set @c true for ascending sort mode, diff --git a/include/contacts_record.h b/include/contacts_record.h index 5dba26c..8825942 100644 --- a/include/contacts_record.h +++ b/include/contacts_record.h @@ -46,7 +46,7 @@ extern "C" /** * @brief Creates a record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @remarks You must release @a record using contacts_record_destroy(). * @param[in] view_uri The view URI * @param[out] record The record handle @@ -65,7 +65,7 @@ int contacts_record_create(const char *view_uri, contacts_record_h *record); /** * @brief Destroys a record and releases its all resources. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The record handle * @param[in] delete_child Set @c true to destroy child records automatically, * otherwise set @c false to not destroy child records automatically @@ -82,7 +82,7 @@ int contacts_record_destroy(contacts_record_h record, bool delete_child); /** * @brief Makes a clone of a record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @remarks You must release @a cloned_record using contacts_record_destroy(). * @param[in] record The record handle * @param[out] cloned_record The cloned record handle @@ -100,7 +100,7 @@ int contacts_record_clone(contacts_record_h record, contacts_record_h *cloned_re /** * @brief Gets a string from the record handle. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @remarks You must release @a value using free(). * @param[in] record The record handle * @param[in] property_id The property ID @@ -119,7 +119,7 @@ int contacts_record_get_str(contacts_record_h record, unsigned int property_id, /** * @brief Gets a string pointer from the record handle. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @remarks You MUST NOT release @a value. * @param[in] record The record handle * @param[in] property_id The property ID @@ -138,7 +138,7 @@ int contacts_record_get_str_p(contacts_record_h record, unsigned int property_id /** * @brief Sets a string to a record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The record handle * @param[in] property_id The property ID * @param[in] value The value to set @@ -156,7 +156,7 @@ int contacts_record_set_str(contacts_record_h record, unsigned int property_id, /** * @brief Gets a record's integer value. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The record handle * @param[in] property_id The property ID * @param[out] value The value to be returned @@ -173,7 +173,7 @@ int contacts_record_get_int(contacts_record_h record, unsigned int property_id, /** * @brief Sets an integer value to a record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The record handle * @param[in] property_id The property ID * @param[in] value The value to set @@ -190,7 +190,7 @@ int contacts_record_set_int(contacts_record_h record, unsigned int property_id, /** * @brief Gets a record's long integer value. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The record handle * @param[in] property_id The property ID * @param[out] value The value to be returned @@ -207,7 +207,7 @@ int contacts_record_get_lli(contacts_record_h record, unsigned int property_id, /** * @brief Sets a long long integer value to a record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The record handle * @param[in] property_id The property ID * @param[in] value The value to set @@ -224,7 +224,7 @@ int contacts_record_set_lli(contacts_record_h record, unsigned int property_id, /** * @brief Gets a record's boolean value. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The record handle * @param[in] property_id The property ID * @param[out] value The value to be returned @@ -241,7 +241,7 @@ int contacts_record_get_bool(contacts_record_h record, unsigned int property_id, /** * @brief Sets a boolean value to a record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The record handle * @param[in] property_id The property ID * @param[in] value The value to set @@ -258,7 +258,7 @@ int contacts_record_set_bool(contacts_record_h record, unsigned int property_id, /** * @brief Gets a record's double value. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The record handle * @param[in] property_id The property ID * @param[out] value The value to be returned @@ -275,7 +275,7 @@ int contacts_record_get_double(contacts_record_h record, unsigned int property_i /** * @brief Sets a double value to a record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The record handle * @param[in] property_id The property ID * @param[in] value The value to set @@ -292,7 +292,7 @@ int contacts_record_set_double(contacts_record_h record, unsigned int property_i /** * @brief Adds a child record to the parent record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The parent record handle * @param[in] property_id The property ID * @param[in] child_record The child record handle to be added to parent record handle @@ -309,7 +309,7 @@ int contacts_record_add_child_record(contacts_record_h record, unsigned int prop /** * @brief Removes a child record from the parent record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The parent record handle * @param[in] property_id The property ID * @param[in] child_record The child record handle to be removed from parent record handle @@ -326,7 +326,7 @@ int contacts_record_remove_child_record(contacts_record_h record, unsigned int p /** * @brief Gets the number of child records of a parent record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The parent record handle * @param[in] property_id The property ID * @param[out] count The child record count @@ -344,7 +344,7 @@ int contacts_record_get_child_record_count(contacts_record_h record, unsigned in /** * @brief Gets a child record handle pointer from the parent record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @remarks You MUST NOT release @a child_record. It is released when the parent record is destroyed. * @param[in] record The record handle * @param[in] property_id The property ID @@ -366,7 +366,7 @@ int contacts_record_get_child_record_at_p(contacts_record_h record, unsigned int /** * @brief Clones a child record list of the given parent record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @remarks You must release @a cloned_list using contacts_list_destroy(). * @param[in] record The record handle * @param[in] property_id The property ID @@ -384,7 +384,7 @@ int contacts_record_clone_child_record_list(contacts_record_h record, unsigned i /** * @brief Gets URI string from a record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The record handle * @param[out] view_uri The URI of record * @return @c 0 on success, diff --git a/include/contacts_setting.h b/include/contacts_setting.h index 05a1efc..9876253 100644 --- a/include/contacts_setting.h +++ b/include/contacts_setting.h @@ -46,7 +46,7 @@ extern "C" /** * @brief Enumeration for name display order. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_NAME_DISPLAY_ORDER_FIRSTLAST, /**< First name comes at the first */ @@ -56,7 +56,7 @@ typedef enum { /** * @brief Gets the contacts name display order. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @param[out] name_display_order The name display order @@ -76,7 +76,7 @@ int contacts_setting_get_name_display_order(contacts_name_display_order_e *name_ /** * @brief Sets the contacts name display order. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.write * @param[in] name_display_order The name display order @@ -98,7 +98,7 @@ int contacts_setting_set_name_display_order(contacts_name_display_order_e name_d /** * @brief Enumeration for name sorting order. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_NAME_SORTING_ORDER_FIRSTLAST, /**< Contacts are first sorted based on the first name */ @@ -108,7 +108,7 @@ typedef enum { /** * @brief Gets the contacts name sorting order in which contacts are returned. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @param[out] name_sorting_order The name sorting order @@ -128,7 +128,7 @@ int contacts_setting_get_name_sorting_order(contacts_name_sorting_order_e *name_ /** * @brief Sets the contacts name sorting order in which contacts are returned. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.write * @param[in] name_sorting_order The name sorting order @@ -150,7 +150,7 @@ int contacts_setting_set_name_sorting_order(contacts_name_sorting_order_e name_s /** * @brief Called when a designated view changes. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] name_display_order The name display order setting value * @param[in] user_data The user data passed from the callback registration function * @pre The callback must be registered using contacts_setting_add_name_display_order_changed_cb(). @@ -163,7 +163,7 @@ typedef void (*contacts_setting_name_display_order_changed_cb)(contacts_name_dis /** * @brief Registers a callback function. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @param[in] callback The callback function to register @@ -187,7 +187,7 @@ int contacts_setting_add_name_display_order_changed_cb(contacts_setting_name_dis /** * @brief Unregisters a callback function. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] callback The callback function to register * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, @@ -206,7 +206,7 @@ int contacts_setting_remove_name_display_order_changed_cb(contacts_setting_name_ /** * @brief Called when a designated view changes. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] name_sorting_order The name sorting order setting value * @param[in] user_data The user data passed from the callback registration function * @pre The callback must be registered using contacts_setting_add_name_sorting_order_changed_cb(). @@ -219,7 +219,7 @@ typedef void (*contacts_setting_name_sorting_order_changed_cb)(contacts_name_sor /** * @brief Registers a callback function. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @param[in] callback The callback function to register @@ -243,7 +243,7 @@ int contacts_setting_add_name_sorting_order_changed_cb(contacts_setting_name_sor /** * @brief Unregisters a callback function. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] callback The callback function to register * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, diff --git a/include/contacts_types.h b/include/contacts_types.h index 5409f4e..bb4ed28 100644 --- a/include/contacts_types.h +++ b/include/contacts_types.h @@ -71,31 +71,31 @@ extern "C" /** * @brief Handle for contacts record. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ _CONTACTS_HANDLE(contacts_record_h) /** * @brief Handle for contacts filter. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ _CONTACTS_HANDLE(contacts_filter_h) /** * @brief Handle for contacts list. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ _CONTACTS_HANDLE(contacts_list_h) /** * @brief Handle for contacts query. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ _CONTACTS_HANDLE(contacts_query_h) /** * @brief The contacts handle. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ _CONTACTS_HANDLE(contacts_h) @@ -143,7 +143,7 @@ typedef enum { * @details The number can be made with a set of values by specifying one or more values. * Example : CTS_NUM_TYPE_HOME|CTS_NUM_TYPE_VOICE * Exceptionally, CTS_NUM_TYPE_CUSTOM is exclusive. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_NUMBER_TYPE_OTHER, /**< Other number type */ @@ -170,7 +170,7 @@ typedef enum { /** * @brief Enumeration for Contact email type. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_EMAIL_TYPE_OTHER, /**< Other email type */ @@ -183,7 +183,7 @@ typedef enum { /** * @brief Enumeration for Contact company type. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_COMPANY_TYPE_OTHER, /**< Other company type */ @@ -194,7 +194,7 @@ typedef enum { /** * @brief Enumeration for Contact address type. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_ADDRESS_TYPE_OTHER, /**< Other address type */ @@ -210,7 +210,7 @@ typedef enum { /** * @brief Enumeration for Contact URL type. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_URL_TYPE_OTHER, /**< Other URL type*/ @@ -222,7 +222,7 @@ typedef enum { /** * @brief Enumeration for Contact messenger type. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_MESSENGER_TYPE_OTHER, /**< Other messenger type */ @@ -242,7 +242,7 @@ typedef enum { /** * @brief Enumeration for Call history type. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_PLOG_TYPE_NONE, /**< None */ @@ -274,7 +274,7 @@ typedef enum { /** * @brief Enumeration for Contact event type. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_EVENT_TYPE_OTHER, /**< Other event type */ @@ -286,7 +286,7 @@ typedef enum { /** * @brief Enumeration for Contact event calendar type. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_EVENT_CALENDAR_TYPE_GREGORIAN, /**< Gregorian calendar */ @@ -296,7 +296,7 @@ typedef enum { /** * @brief Enumeration for Contact image type. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * */ typedef enum { @@ -307,7 +307,7 @@ typedef enum { /** * @brief Enumeration for usage type. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_USAGE_STAT_TYPE_NONE, /**< None */ @@ -326,7 +326,7 @@ typedef enum { /** * @brief Enumeration for Contact display name source type. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_DISPLAY_NAME_SOURCE_TYPE_INVALID, /**< Invalid source of display name */ @@ -340,7 +340,7 @@ typedef enum { /** * @brief Enumeration for Address book mode. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_ADDRESS_BOOK_MODE_NONE, /**< All module can read and write contacts of this address_book */ @@ -350,7 +350,7 @@ typedef enum { /** * @brief Enumeration for link mode when inserting contact. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_CONTACT_LINK_MODE_NONE, /**< Auto link immediately */ @@ -360,7 +360,7 @@ typedef enum { /** * @brief Enumeration for Contact relationship type. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_RELATIONSHIP_TYPE_OTHER, /**< Other relationship type*/ @@ -384,7 +384,7 @@ typedef enum { /** * @brief Enumeration for Contact search range. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 */ typedef enum { CONTACTS_SEARCH_RANGE_NAME = 0x00000001, /**< Search record from name */ diff --git a/include/contacts_vcard.h b/include/contacts_vcard.h index c3ea01a..1a9fe02 100644 --- a/include/contacts_vcard.h +++ b/include/contacts_vcard.h @@ -46,7 +46,7 @@ extern "C" /** * @brief Called to get a record handle of @ref CAPI_SOCIAL_CONTACTS_SVC_VIEW_MODULE_contacts_contact. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] record The record handle * @param[in] user_data The user data passed from the foreach function * @return @c true to continue with the next iteration of the loop, @@ -59,7 +59,7 @@ typedef bool (*contacts_vcard_parse_cb)(contacts_record_h record, void *user_dat /** * @brief Retrieves all contacts with a record handle (_contacts_contact) from a vCard file. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] vcard_file_path The file path of vCard stream file * @param[in] callback The callback function to invoke * @param[in] user_data The user data to be passed to the callback function @@ -80,7 +80,7 @@ int contacts_vcard_parse_to_contact_foreach(const char *vcard_file_path, contact /** * @brief Retrieves all contacts with a contacts list from a vCard stream. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] vcard_stream The vCard stream * @param[out] contacts_list The contacts list handle * @return @c 0 on success, @@ -97,7 +97,7 @@ int contacts_vcard_parse_to_contacts(const char *vcard_stream, contacts_list_h * /** * @brief Retrieves the vCard stream from a contact. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] contact The contact record handle * @param[out] vcard_stream The vCard stream * @return @c 0 on success, @@ -113,7 +113,7 @@ int contacts_vcard_make_from_contact(contacts_record_h contact, char **vcard_str /** * @brief Retrieves the vCard stream from a contact. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] my_profile The my_profile record handle * @param[out] vcard_stream The vCard stream * @return @c 0 on success, @@ -129,7 +129,7 @@ int contacts_vcard_make_from_my_profile(contacts_record_h my_profile, char **vca /** * @brief Retrieves the vCard stream from a person. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/contact.read * @param[in] person The person record handle @@ -152,7 +152,7 @@ int contacts_vcard_make_from_person(contacts_record_h person, char **vcard_strea /** * @brief Retrieves the count of contact entities from a vCard file. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif + * @since_tizen 2.3 * @param[in] vcard_file_path The person record handle * @param[out] count The count of contact entity * @return @c 0 on success,