/**
* @if OSPDEPREC
- * Initializes this instance of %Addressbook with the specified listener.
+ * Initializes this instance of %Addressbook with a specified listener.
*
* @brief <i> [Deprecated] </i>
* @deprecated This method and IRecordEventListener are deprecated. Instead of using this method, use AddressbookManager::GetAddressbookN() and SetEventListener().
result RemoveContact(RecordId contactId);
/**
- * Updates the specified contact. @n
+ * Updates a specified contact. @n
* At least one property of the contact must have been set.
*
* @since 2.0
Tizen::Base::Collection::IList* GetAllContactsN(void) const;
/**
- * Gets the member contacts of the specified category. @n
+ * Gets the member contacts of a specified category. @n
* If the specified @c category is INVALID_RECORD_ID, this method returns the list of contacts that are not member of any category.
* The contacts are ordered by display name.
*
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.read
*
- * @return A list of contacts that are members of the specified category, @n
+ * @return A list of contacts that are members of a specified category, @n
* else an empty list if there is no contact, or @c null if an exception occurs (@ref Contact list)
* @param[in] categoryId The category ID
* @exception E_SUCCESS The method is successful.
Tizen::Base::Collection::IList* GetContactsByCategoryN(RecordId categoryId) const;
/**
- * Gets contacts in the specified range in the address book. @n
+ * Gets contacts in a specified range in the address book. @n
* The contacts are ordered by display name.
*
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.read
*
- * @return A list of contacts in the specified range, @n
+ * @return A list of contacts in a specified range, @n
* else an empty list if there is no contact, or @c null if an exception occurs (@ref Contact list)
* @param[in] pageNo The page number of the result list @n
* It starts from @c 1.
Tizen::Base::Collection::IList* GetContactsN(int pageNo, int countPerPage) const;
/**
- * Gets contacts that are in the specified range of the specified category. @n
+ * Gets contacts that are in the specified range of a specified category. @n
* The contacts are ordered by display name.
*
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.read
*
- * @return A list of contacts in the specified range of the specified category, @n
+ * @return A list of contacts in the specified range of a specified category, @n
* else an empty list if there is no contact, or @c null if an exception occurs (@ref Contact list)
* @param[in] category The category
* @param[in] pageNo The page number of the result list, which starts from @c 1
Tizen::Base::Collection::IList* GetContactsInN(const Category& category, int pageNo, int countPerPage) const;
/**
- * Gets the contact with the specified contact ID.
+ * Gets the contact with a specified contact ID.
*
* @since 2.0
* @privlevel public
int GetContactCount(void) const;
/**
- * Adds the specified contact to the specified category.
+ * Adds a specified contact to a specified category.
*
* @since 2.0
* @privlevel public
result AddMemberToCategory(RecordId categoryId, RecordId contactId);
/**
- * Removes the specified contact from the specified category.
+ * Removes a specified contact from a specified category.
*
* @since 2.0
* @privlevel public
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.read
*
- * @return A list of categories that has the specified contact as a member, @n
+ * @return A list of categories that has a specified contact as a member, @n
* else an empty list if there is no category, or @c null if an exception occurs (@ref Category list)
* @param[in] contactId The contact ID
* @exception E_SUCCESS The method is successful.
int GetCategoryCount(void) const;
/**
- * Gets the category with the specified category ID.
+ * Gets the category with a specified category ID.
*
* @since 2.0
* @privlevel public
int GetLatestVersion(void) const;
/**
- * Gets the change information of the contacts that have been changed after the specified change version. @n
+ * Gets the change information of the contacts that have been changed after a specified change version. @n
*
* @brief <i> [Deprecated] </i>
* @deprecated This method is deprecated. Instead of using this method, use GetChangedContactInfoListN().
Tizen::Base::Collection::IList* GetChangedContactsAfterN(int version, int& latestVersion) const;
/**
- * Gets the change information of the contacts that have been changed after the specified change version. @n
+ * Gets the change information of the contacts that have been changed after a specified change version.
*
* @since 2.1
* @privlevel public
Tizen::Base::Collection::IList* GetChangedContactInfoListN(int version, int& latestVersion) const;
/**
- * Gets the change information of the categories that have been changed after the specified version.
+ * Gets the change information of the categories that have been changed after a specified version.
*
* @brief <i> [Deprecated] </i>
* @deprecated This method is deprecated. Instead of using this method, use GetChangedCategoryInfoListN().
Tizen::Base::Collection::IList* GetChangedCategoriesAfterN(int version, int& latestVersion) const;
/**
- * Gets the change information of the categories that have been changed after the specified version.
+ * Gets the change information of the categories that have been changed after a specified version.
*
* @since 2.1
* @privlevel public
UserProfile* GetUserProfileN(void) const;
/**
- * Checks whether the user profile of this address book has been changed after the specified version or not.
- * If the user profile does not exist, this method returns false.
+ * Checks whether the user profile of this address book has been changed after a specified version or not.
+ * If the user profile does not exist, this method returns @c false.
*
* @since 2.1
* @privlevel public
*
* @return @c true if the user profile has been changed, @n
* else @c false
- * @param[in] version The change version
+ * @param[in] version The changed version
* @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method.