3.0 Native API Reference standard applied

Change-Id: Ib75f81c26d357eaa123e95fd2560cf72808cdcef
Signed-off-by: Kyeonghun Lee <kh9090.lee@samsung.com>
(cherry picked from commit d6fabbaa5cf898a6a80c30ed13782946a479b492)

diff --git a/doc/messages_doc.h b/doc/messages_doc.h
index 96bac07..1188343 100755 (executable)
--- a/doc/messages_doc.h
+++ b/doc/messages_doc.h
@@ -18,20 +18,17 @@
 #ifndef __TIZEN_MESSAGES_DOC_H__
 #define __TIZEN_MESSAGES_DOC_H__
 
+
 /**
- * @defgroup CAPI_MESSAGING_MESSAGES_MODULE Messages
- * @brief The @ref CAPI_MESSAGING_MESSAGES_MODULE API provides functions to create, set properties and send a SMS/MMS message.
  * @ingroup CAPI_MESSAGING_FRAMEWORK
- *
+ * @defgroup CAPI_MESSAGING_MESSAGES_MODULE Messages
  * @addtogroup CAPI_MESSAGING_MESSAGES_MODULE
- *
+ * @brief The @ref CAPI_MESSAGING_MESSAGES_MODULE API provides functions to create, set properties, and send a SMS/MMS message.
  * @section CAPI_MESSAGING_MESSAGES_MODULE_HEADER Required Header
  *   \#include <messages.h>
  *
  * @section CAPI_MESSAGING_MESSAGES_MODULE_OVERVIEW Overview
- *
  * The Messages API provides the following functionalities:
- *
  * - Creating a message
  * - Setting the text of the message
  * - Setting the message recipient(s)
@@ -42,34 +39,27 @@
  *
  * @section CAPI_MESSAGING_MESSAGES_MODULE_FEATURE Related Features
  * This API is related with the following features:\n
- *  - http://tizen.org/feature/network.telephony\n
- *  - http://tizen.org/feature/network.telephony.sms\n
- *  - http://tizen.org/feature/network.telephony.mms\n
- *
+ * - http://tizen.org/feature/network.telephony\n
+ * - http://tizen.org/feature/network.telephony.sms\n
+ * - http://tizen.org/feature/network.telephony.mms\n
  * It is recommended to design feature related codes in your application for reliability.\n
- *
  * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
- *
  * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
- *
  * More details on featuring your application can be found from <a href="https://developer.tizen.org/development/tools/native-tools/manifest-text-editor#feature"><b>Feature Element</b>.</a>
  * <BR>
  */
 
+
 /**
- * @defgroup CAPI_MESSAGING_MESSAGES_MMS_MODULE MMS
- * @brief The MMS API provides functions to manage attachments and subject of the MMS message.
  * @ingroup CAPI_MESSAGING_MESSAGES_MODULE
- *
+ * @defgroup CAPI_MESSAGING_MESSAGES_MMS_MODULE MMS
  * @addtogroup CAPI_MESSAGING_MESSAGES_MMS_MODULE
- *
+ * @brief The MMS API provides functions to manage attachments and subject of the MMS message.
  * @section CAPI_MESSAGING_MESSAGES_MMS_MODULE_HEADER Required Header
  *   \#include <messages.h>
  *
  * @section CAPI_MESSAGING_MESSAGES_MMS_MODULE_OVERVIEW Overview
- *
  * The MMS API provides the following functionalities:
- *
  * - Setting/Getting the subject
  * - Attaching the media files(image, video, audio)
  * - Retrieving the attachments
@@ -77,50 +67,38 @@
  *
  * @section CAPI_MESSAGING_MESSAGES_MMS_MODULE_FEATURE Related Features
  * This API is related with the following features:\n
- *  - http://tizen.org/feature/network.telephony\n
- *  - http://tizen.org/feature/network.telephony.sms\n
- *  - http://tizen.org/feature/network.telephony.mms\n
- *
+ * - http://tizen.org/feature/network.telephony\n
+ * - http://tizen.org/feature/network.telephony.sms\n
+ * - http://tizen.org/feature/network.telephony.mms\n
  * It is recommended to design feature related codes in your application for reliability.\n
- *
  * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
- *
  * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
- *
  * More details on featuring your application can be found from <a href="https://developer.tizen.org/development/tools/native-tools/manifest-text-editor#feature"><b>Feature Element</b>.</a>
- *
  */
 
+
 /**
- * @defgroup CAPI_MESSAGING_MESSAGES_PUSH_MODULE WAP Push
- * @brief The WAP PUSH API provides functions to add/remove incoming callback for WAP Push messages and register current application to push server.
  * @ingroup CAPI_MESSAGING_MESSAGES_MODULE
- *
+ * @defgroup CAPI_MESSAGING_MESSAGES_PUSH_MODULE WAP Push
  * @addtogroup CAPI_MESSAGING_MESSAGES_PUSH_MODULE
- *
+ * @brief The WAP PUSH API provides functions to add/remove incoming callback for WAP Push messages and register current application to push server.
  * @section CAPI_MESSAGING_MESSAGES_PUSH_MODULE_HEADER Required Header
  *   \#include <messages.h>
  *
  * @section CAPI_MESSAGING_MESSAGES_PUSH_MODULE_OVERVIEW Overview
- *
  * The WAP PUSH API provides the following functionalities:
- *
  * - Adding/Removing incoming callback for WAP Push messages
  * - Managing the registration
  *
  * @section CAPI_MESSAGING_MESSAGES_PUSH_MODULE_FEATURE Related Features
  * This API is related with the following features:\n
- *  - http://tizen.org/feature/network.telephony\n
- *  - http://tizen.org/feature/network.telephony.sms\n
+ * - http://tizen.org/feature/network.telephony\n
+ * - http://tizen.org/feature/network.telephony.sms\n
  *
  * It is recommended to design feature related codes in your application for reliability.\n
- *
  * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
- *
  * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
- *
  * More details on featuring your application can be found from <a href="https://developer.tizen.org/development/tools/native-tools/manifest-text-editor#feature"><b>Feature Element</b>.</a>
- *
  */
 
 

diff --git a/include/messages.h b/include/messages.h
index 4ba0fb2..4995ebc 100644 (file)
--- a/include/messages.h
+++ b/include/messages.h
@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 
+
 #ifndef __TIZEN_MESSAGING_H__
 #define __TIZEN_MESSAGING_H__
 
@@ -22,11 +23,13 @@
 #include <messages_types.h>
 #include <messages_error.h>
 
+
 #ifdef __cplusplus
 extern "C"
 {
 #endif
 
+
 /*
  * @file messages.h
  * @brief This file contains the messages API.
@@ -41,25 +44,19 @@ extern "C"
 
 /**
  * @brief Opens a handle for the messaging service.
- *
  * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.read
- *
  * @remarks You must release @a service using messages_close_service().
- *
  * @param[out] service The message service handle
- *
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE                             Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER                Invalid parameter
- * @retval #MESSAGES_ERROR_SERVER_NOT_READY                 Server is not read
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_SERVER_NOT_READY Server is not ready
  * @retval #MESSAGES_ERROR_COMMUNICATION_WITH_SERVER_FAILED Communication with server failed
- * @retval #MESSAGES_ERROR_PERMISSION_DENIED                The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED                    Not supported
- *
+ * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_close_service()
  */
 int messages_open_service(messages_service_h *service);
@@ -67,22 +64,17 @@ int messages_open_service(messages_service_h *service);
 
 /**
  * @brief Closes a handle for the messaging service.
- *
  * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.read
- *
  * @param[in] service The message service handle
- *
  * @return @c 0 on success,
- *        otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE                             Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER                Invalid parameter
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MESSAGES_ERROR_COMMUNICATION_WITH_SERVER_FAILED Communication with server failed
- * @retval #MESSAGES_ERROR_PERMISSION_DENIED                The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED                    Not supported
- *
+ * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_open_service()
  */
 int messages_close_service(messages_service_h service);
@@ -90,23 +82,17 @@ int messages_close_service(messages_service_h service);
 
 /**
  * @brief Creates a message handle.
- *
  * @since_tizen 2.3
- *
  * @remarks You must release @a msg using messages_destroy_message().
- *
- * @param[in] type  The message type (#MESSAGES_TYPE_SMS or #MESSAGES_TYPE_MMS) \n
- *                  If @a type is #MESSAGES_TYPE_UNKNOWN, #MESSAGES_ERROR_INVALID_PARAMETER occurs.
- * @param[out] msg  The message handle that is newly created if successful
- *
+ * @param[in] type The message type (#MESSAGES_TYPE_SMS or #MESSAGES_TYPE_MMS) \n
+ *                 If @a type is #MESSAGES_TYPE_UNKNOWN, #MESSAGES_ERROR_INVALID_PARAMETER occurs
+ * @param[out] msg The message handle that is newly created if successful
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY     Out of memory
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_destroy_message()
  */
 int messages_create_message(messages_message_type_e type, messages_message_h *msg);
@@ -114,18 +100,13 @@ int messages_create_message(messages_message_type_e type, messages_message_h *ms
 
 /**
  * @brief Destroys a message handle and releases all its resources.
- *
  * @since_tizen 2.3
- *
  * @param[in] msg The message handle to destroy
- *
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
- *
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_create_message()
  */
 int messages_destroy_message(messages_message_h msg);
@@ -133,45 +114,35 @@ int messages_destroy_message(messages_message_h msg);
 
 /**
  * @brief Adds the message to message database.
- *
  * @since_tizen 3.0
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.write
- *
- * @param[in] service         The message service handle
- * @param[in] msg             The message handle
- * @param[out] msg_id         The message ID of added message
- *
+ * @param[in] service The message service handle
+ * @param[in] msg The message handle
+ * @param[out] msg_id The message ID of added message
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OPERATION_FAILED  Messaging operation failed
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_create_message()
- *
  */
 int messages_add_message(messages_service_h service, messages_message_h msg, int *msg_id);
 
+
 /**
  * @brief Gets the message ID of the message.
- *
  * @since_tizen 2.3
- *
- * @param[in]  msg     The message handle
- * @param[out] msg_id  The message ID
- *
+ * @param[in] msg The message handle
+ * @param[out] msg_id The message ID
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_OPERATION_FAILED   Messaging operation failed
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
- *
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_search_message_by_id()
  */
 int messages_get_message_id(messages_message_h msg, int *msg_id);
@@ -179,20 +150,15 @@ int messages_get_message_id(messages_message_h msg, int *msg_id);
 
 /**
  * @brief Sets the SIM ID of the sending message.
- *
  * @since_tizen 2.3
- *
- * @param[in]  msg     The message handle
- * @param[in]  sim_id  The SIM id to send message
- *
+ * @param[in] msg The message handle
+ * @param[in] sim_id The SIM ID to send message
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_OPERATION_FAILED   Messaging operation failed
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
- *
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_get_sim_id()
  */
 int messages_set_sim_id(messages_message_h msg, int sim_id);
@@ -200,113 +166,90 @@ int messages_set_sim_id(messages_message_h msg, int sim_id);
 
 /**
  * @brief Gets the SIM ID of the message.
- *
  * @since_tizen 2.3
- *
- * @param[in]  msg     The message handle
- * @param[out] sim_id  The SIM id of message
- *
+ * @param[in] msg The message handle
+ * @param[out] sim_id The SIM ID of message
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_OPERATION_FAILED   Messaging operation failed
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
- *
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_set_sim_id()
  */
 int messages_get_sim_id(messages_message_h msg, int *sim_id);
 
+
 /**
  * @brief Sets the message box type of the message.
- *
  * @since_tizen 3.0
- *
- * @param[in]  msg   The message handle
- * @param[in]  mbox  The message box type
- *
+ * @param[in] msg The message handle
+ * @param[in] mbox The message box type
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
 int messages_set_mbox_type(messages_message_h msg, messages_message_box_e mbox);
 
+
 /**
  * @brief Gets the message box type of the message.
- *
  * @since_tizen 2.3
- *
- * @param[in]  msg   The message handle
- * @param[out] mbox  The message box type
- *
+ * @param[in] msg The message handle
+ * @param[out] mbox The message box type
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
 int messages_get_mbox_type(messages_message_h msg, messages_message_box_e *mbox);
 
+
 /**
  * @brief Gets the destination port of the message.
- *
  * @since_tizen 2.3
- *
- * @param[in]  msg   The message handle
- * @param[out] port  The destination port of the message
- *
+ * @param[in] msg The message handle
+ * @param[out] port The destination port of the message
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
- *
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_add_sms_listening_port()
  */
 int messages_get_message_port(messages_message_h msg, int *port);
 
+
 /**
  * @brief Gets the type of the message.
- *
  * @since_tizen 2.3
- *
- * @param[in]  msg  The message handle
+ * @param[in] msg The message handle
  * @param[out] type The message type
- *
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
 int messages_get_message_type(messages_message_h msg, messages_message_type_e *type);
 
 
 /**
  * @brief Adds an recipient's address(phone number) to the message.
- * @details The maximum number of recipients per a message is 10.
- *
+ * @details The maximum number of recipients per message is 10.
  * @since_tizen 2.3
- *
- * @param[in] msg      The message handle
- * @param[in] address  The recipient's address to receive a message \n
- *                     The maximum length of @a address is @c 254.
- * @param[in] type     The recipient's type of the @a address
- *
+ * @param[in] msg The message handle
+ * @param[in] address The recipient's address to receive a message \n
+ *                    The maximum length of @a address is @c 254.
+ * @param[in] type The recipient's type of the @a address
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
- *
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_get_address()
  * @see        messages_remove_all_addresses()
  */
@@ -315,19 +258,14 @@ int messages_add_address(messages_message_h msg, const char *address, messages_r
 
 /**
  * @brief Gets the total number of recipients in the message.
- *
  * @since_tizen 2.3
- *
- * @param[in]  msg    The message handle
- * @param[out] count  The total number of recipients
- *
+ * @param[in] msg The message handle
+ * @param[out] count The total number of recipients
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
- *
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_add_address()
  * @see        messages_remove_all_addresses()
  */
@@ -336,24 +274,18 @@ int messages_get_address_count(messages_message_h msg, int *count);
 
 /**
  * @brief Gets a recipient's address with specified index.
- *
  * @since_tizen 2.3
- *
  * @remarks You must release @a address using free().
- *
- * @param[in]  msg      The message handle
- * @param[in]  index    The zero-based index of an address to receive a message.
- * @param[out] address  The recipient's address with specified index
- * @param[out] type     The recipient's type of the @a address
- *
+ * @param[in] msg The message handle
+ * @param[in] index The zero-based index of an address to receive a message
+ * @param[out] address The recipient's address with specified index
+ * @param[out] type The recipient's type of the @a address
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY      Out of memory
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
- *
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_add_address()
  * @see        messages_remove_all_addresses()
  */
@@ -362,18 +294,13 @@ int messages_get_address(messages_message_h msg, int index, char **address, mess
 
 /**
  * @brief Removes all recipients in the message.
- *
  * @since_tizen 2.3
- *
  * @param[in] msg The message handle
- *
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
- *
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_add_address()
  * @see        messages_get_address()
  */
@@ -382,21 +309,16 @@ int messages_remove_all_addresses(messages_message_h msg);
 
 /**
  * @brief Sets the text of the message.
- *
  * @since_tizen 2.3
- *
- * @param[in] msg  The message handle
+ * @param[in] msg The message handle
  * @param[in] text The text of the message \n
- *                 The maximum length of @a text is @c 1530.
- *
+ *                 The maximum length of @a text is @c 1530
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY      Out of memory
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
- *
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_get_text()
  */
 int messages_set_text(messages_message_h msg, const char *text);
@@ -404,151 +326,123 @@ int messages_set_text(messages_message_h msg, const char *text);
 
 /**
  * @brief Gets the text of the message.
- *
  * @since_tizen 2.3
- *
  * @remarks You must release @a text using free().
- *
- * @param[in]  msg   The message handle
- * @param[out] text  The text of the message
- *
+ * @param[in] msg The message handle
+ * @param[out] text The text of the message
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY      Out of memory
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
- *
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_set_text()
  */
 int messages_get_text(messages_message_h msg, char **text);
 
+
 /**
  * @brief Sets the time of the message.
- *
  * @since_tizen 3.0
- *
- * @param[in]  msg   The message handle
- * @param[in]  time  The time of the message
- *
+ * @param[in] msg The message handle
+ * @param[in] time The time of the message
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
 int messages_set_time(messages_message_h msg, time_t time);
 
+
 /**
  * @brief Gets the time of the message.
- *
  * @since_tizen 2.3
- *
- * @param[in]  msg   The message handle
- * @param[out] time  The time of the message
- *
+ * @param[in] msg The message handle
+ * @param[out] time The time of the message
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE               Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER  Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED      Not supported
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
 int messages_get_time(messages_message_h msg, time_t *time);
 
+
 /**
  * @brief Sends the message to all recipients.
- *
  * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.write
- *
- * @param[in] service         The message service handle
- * @param[in] msg             The message handle
+ * @param[in] service The message service handle
+ * @param[in] msg The message handle
  * @param[in] save_to_sentbox Set to @c true to save the message in the sentbox,
  *                            otherwise set to @c false to not save the message in the sentbox
- * @param[in] callback        The callback function
- * @param[in] user_data       The user data to be passed to the callback function
- *
+ * @param[in] callback The callback function
+ * @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 #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_SENDING_FAILED    Sending a message failed
- * @retval #MESSAGES_ERROR_OPERATION_FAILED  Messaging operation failed
+ * @retval #MESSAGES_ERROR_SENDING_FAILED Sending message failed
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_sent_cb()
  */
 int messages_send_message(messages_service_h service, messages_message_h msg, bool save_to_sentbox, messages_sent_cb callback, void *user_data);
 
+
 /**
  * @brief Gets the message count in the specific message box.
  * @since_tizen 2.3
- *
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.read
- *
- * @param[in]  service The message service handle
- * @param[in]  mbox    The message box type
- * @param[in]  type    The message type \n
- *                     If @a type is #MESSAGES_TYPE_UNKNOWN, all SMS and MMS messages are counted.
- * @param[out] count   The number of messages
- *
+ * @param[in] service The message service handle
+ * @param[in] mbox The message box type
+ * @param[in] type The message type \n
+ *                 If @a type is #MESSAGES_TYPE_UNKNOWN, all SMS and MMS messages are counted
+ * @param[out] count The number of messages
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OPERATION_FAILED  Messaging operation failed
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
-int messages_get_message_count(messages_service_h service,
-                                                       messages_message_box_e mbox, messages_message_type_e type,
-                                                       int *count);
+int messages_get_message_count(messages_service_h service, messages_message_box_e mbox, messages_message_type_e type, int *count);
 
 
 
 /**
  * @brief Searches for messages.
- *
  * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.read
- *
  * @remarks You must release @a message_array using messages_free_message_array().
- *
- * @param[in] service         The message service handle
- * @param[in] mbox            The message box type
- * @param[in] type            The message type \n
- *                            If @a type is #MESSAGES_TYPE_UNKNOWN, all SMS and MMS messages are searched.
- * @param[in] keyword         The keyword search in the text and subject
- * @param[in] address         The recipient address
- * @param[in] offset          The start position (base @c 0)
- * @param[in] limit           The maximum amount of messages to get \n
- *                    In case of @c 0, this method passes to the callback all searched messages.
- * @param[out] message_array  The array of the message handle
- * @param[out] length         The number of messages of the @a message_array
- * @param[out] total          The count of the messages that have been retrieved as a result without applying @a limit and @a offset\ n
- *                            The value can be used to calculate the total number of page views for the searched messages\ n
- *                            For example, if the count of message search is @c 50 and the limit is @c 20, then using this value, you can notice the total page is @c 3.
- *
- * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ * @param[in] service The message service handle
+ * @param[in] mbox The message box type
+ * @param[in] type The message type \n
+ *                 If @a type is #MESSAGES_TYPE_UNKNOWN, all SMS and MMS messages are searched
+ * @param[in] keyword The keyword search in the text and subject
+ * @param[in] address The recipient address
+ * @param[in] offset The start position (base @c 0)
+ * @param[in] limit The maximum amount of messages to get \n
+ *                  In case of @c 0, this method passes to the callback all searched messages
+ * @param[out] message_array The array of the message handle
+ * @param[out] length The number of messages of the @a message_array
+ * @param[out] total The count of the messages that have been retrieved as a result without applying @a limit and @a offset \n
+ *                   The value can be used to calculate the total number of page views for the searched messages \n
+ *                   For example, if the count of message search is @c 50 and the limit is @c 20, then using this value, you can notice the total page is @c 3
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY     Out of memory
- * @retval #MESSAGES_ERROR_OPERATION_FAILED  Messaging operation failed
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_free_message_array()
  */
 int messages_search_message(messages_service_h service,
@@ -558,28 +452,23 @@ int messages_search_message(messages_service_h service,
                                                        int offset, int limit,
                                                        messages_message_h **message_array, int *length, int *total);
 
+
 /**
  * @brief Searches a message with the given message ID.
- *
  * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.read
- *
  * @remarks You must release @a msg using messages_destroy_message().
- *
- * @param[in]  service The message service handle
- * @param[in]  msg_id  The message ID
- * @param[out] msg     The message handle that is newly created if successful
- *
+ * @param[in] service The message service handle
+ * @param[in] msg_id The message ID
+ * @param[out] msg The message handle that is newly created if successful
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY     Out of memory
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_get_message_id()
  */
 int messages_search_message_by_id(messages_service_h service, int msg_id, messages_message_h *msg);
@@ -587,18 +476,13 @@ int messages_search_message_by_id(messages_service_h service, int msg_id, messag
 
 /**
  * @brief Frees the message array.
- *
  * @since_tizen 2.3
- *
  * @param[in] message_array The array of the message handle
- *
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_search_message()
  */
 int messages_free_message_array(messages_message_h *message_array);
@@ -606,35 +490,29 @@ int messages_free_message_array(messages_message_h *message_array);
 
 /**
  * @brief Retrieves the searched messages by invoking the given callback function iteratively.
- *
  * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.read
- *
- * @param[in] service   The message service handle
- * @param[in] mbox      The message box type
- * @param[in] type      The message type \n
- *                      If @a type is #MESSAGES_TYPE_UNKNOWN, all SMS and MMS messages are searched.
- * @param[in] keyword   The keyword search in the text and subject
- * @param[in] address   The recipient address
- * @param[in] offset    The start position (base 0)
- * @param[in] limit     The maximum amount of messages to get \n
- *              In case of @c 0, this method passes to the callback all searched messages.
- * @param[in] callback  The callback function to get a message
+ * @param[in] service The message service handle
+ * @param[in] mbox The message box type
+ * @param[in] type The message type \n
+ *                 If @a type is #MESSAGES_TYPE_UNKNOWN, all SMS and MMS messages are searched
+ * @param[in] keyword The keyword search in the text and subject
+ * @param[in] address The recipient address
+ * @param[in] offset The start position (base 0)
+ * @param[in] limit The maximum amount of messages to get \n
+ *                  In case of @c 0, this method passes to the callback all searched messages
+ * @param[in] callback The callback function to get a message
  * @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 #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY     Out of memory
- * @retval #MESSAGES_ERROR_OPERATION_FAILED  Messaging operation failed
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @post It invokes messages_search_cb().
- *
  * @see messages_search_cb()
  */
 int messages_foreach_message(messages_service_h service,
@@ -644,28 +522,23 @@ int messages_foreach_message(messages_service_h service,
                                                         int offset, int limit,
                                                         messages_search_cb callback, void *user_data);
 
+
 /**
  * @brief Registers a callback to be invoked when an incoming message is received.
- *
  * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.read
- *
- * @param[in] service   The message service handle
- * @param[in] callback  The callback function
+ * @param[in] service The message service handle
+ * @param[in] callback The callback function
  * @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 #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OPERATION_FAILED  Messaging operation failed
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @post It will invoke messages_incoming_cb().
- *
  * @see messages_unset_message_incoming_cb()
  * @see messages_incoming_cb()
  */
@@ -674,44 +547,35 @@ int messages_set_message_incoming_cb(messages_service_h service, messages_incomi
 
 /**
  * @brief Unregisters the callback function.
- *
  * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.write
- *
  * @param[in] service The message service handle
- *
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_set_message_incoming_cb()
  * @see messages_incoming_cb()
  */
 int messages_unset_message_incoming_cb(messages_service_h service);
 
+
 /**
  * @brief Adds an additional listening port for the incoming SMS messages.
- *
  * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.read
- *
  * @param[in] service The message service handle
- * @param[in] port    The listening port for the SMS messages
- *
+ * @param[in] port The listening port for the SMS messages
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_set_message_incoming_cb()
  * @see messages_get_message_port()
  */
@@ -722,24 +586,20 @@ int messages_add_sms_listening_port(messages_service_h service, int port);
  * @addtogroup CAPI_MESSAGING_MESSAGES_MMS_MODULE
  * @{
  */
+
+
 /**
  * @brief Sets the subject of the message.
- *
  * @since_tizen 2.3
- *
- * @param[in] msg     The message handle
+ * @param[in] msg The message handle
  * @param[in] subject The subject of the message \n
- *                    The maximum length of @a subject is @c 120.
- *
+ *                    The maximum length of @a subject is @c 120
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @pre @a msg is created as a #MESSAGES_TYPE_MMS.
- *
  * @see        messages_mms_get_subject()
  */
 int messages_mms_set_subject(messages_message_h msg, const char *subject);
@@ -747,24 +607,17 @@ int messages_mms_set_subject(messages_message_h msg, const char *subject);
 
 /**
  * @brief Gets the subject of the message.
- *
  * @since_tizen 2.3
- *
  * @remarks You must release @a subject using free().
- *
- * @param[in]  msg     The message handle
+ * @param[in] msg The message handle
  * @param[out] subject The subject of the message
- *
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY     Out of memory
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @pre @a msg is created as a #MESSAGES_TYPE_MMS.
- *
  * @see        messages_mms_set_subject()
  */
 int messages_mms_get_subject(messages_message_h msg, char **subject);
@@ -772,24 +625,18 @@ int messages_mms_get_subject(messages_message_h msg, char **subject);
 
 /**
  * @brief Adds the attachment to the MMS message.
- *
  * @since_tizen 2.3
- *
- * @param[in] msg  The message handle
+ * @param[in] msg The message handle
  * @param[in] type The attachment type
  * @param[in] path The file path to attach \n
- *                 The maximum length of @a path is @c 1024.
- *
+ *                 The maximum length of @a path is @c 1024
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY     Out of memory
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @pre @a msg is created as a #MESSAGES_TYPE_MMS.
- *
  * @see        messages_mms_get_attachment()
  * @see        messages_mms_get_attachment_count()
  * @see        messages_mms_remove_all_attachments()
@@ -799,26 +646,19 @@ int messages_mms_add_attachment(messages_message_h msg, messages_media_type_e ty
 
 /**
  * @brief Gets the file path of the attachment with the specified index.
- *
  * @since_tizen 2.3
- *
  * @remarks You must release @a path using free().
- *
- * @param[in]  msg   The message handle
- * @param[in]  index The zero-based index of the attachment
- * @param[out] type  The attachment type
- * @param[out] path  The file path to attach
- *
+ * @param[in] msg The message handle
+ * @param[in] index The zero-based index of the attachment
+ * @param[out] type The attachment type
+ * @param[out] path The file path to attach
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY     Out of memory
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @pre @a msg is created as a #MESSAGES_TYPE_MMS.
- *
  * @see        messages_mms_add_attachment()
  * @see        messages_mms_get_attachment_count()
  * @see        messages_mms_remove_all_attachments()
@@ -828,21 +668,15 @@ int messages_mms_get_attachment(messages_message_h msg, int index, messages_medi
 
 /**
  * @brief Gets the attachment with the specified index.
- *
  * @since_tizen 2.3
- *
- * @param[in]  msg   The message handle
+ * @param[in] msg The message handle
  * @param[out] count The total number of attachments
- *
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @pre @a msg is created as a #MESSAGES_TYPE_MMS.
- *
  * @see        messages_mms_add_attachment()
  * @see        messages_mms_get_attachment()
  * @see        messages_mms_remove_all_attachments()
@@ -852,53 +686,47 @@ int messages_mms_get_attachment_count(messages_message_h msg, int *count);
 
 /**
  * @brief Removes all attachments to the MMS message.
- *
  * @since_tizen 2.3
- *
  * @param[in] msg The message handle
- *
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @pre @a msg is created as a #MESSAGES_TYPE_MMS.
- *
  * @see        messages_mms_add_attachment()
  * @see        messages_mms_get_attachment()
  * @see        messages_mms_get_attachment_count()
  */
 int messages_mms_remove_all_attachments(messages_message_h msg);
+
+
 /**
  * @}
  */
 
+
 /**
  * @addtogroup CAPI_MESSAGING_MESSAGES_PUSH_MODULE
  * @{
  */
 
+
 /**
  * @brief Registers a callback to be invoked when an WAP Push message is received.
- *
  * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.read
- *
- * @param[in] service   The message service handle
- * @param[in] app_id    The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
- * @param[in] callback  The callback function
+ * @param[in] service The message service handle
+ * @param[in] app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
+ * @param[in] callback The callback function
  * @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 #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
 int messages_push_add_incoming_cb(messages_service_h service, const char *app_id,
                                          messages_push_incoming_cb callback, void *user_data);
@@ -906,97 +734,82 @@ int messages_push_add_incoming_cb(messages_service_h service, const char *app_id
 
 /**
  * @brief Unregisters the WAP push incoming callback function.
- *
  * @since_tizen 2.3
- *
  * @param[in] service The message service handle
- * @param[in] app_id  The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
- *
+ * @param[in] app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
 int messages_push_remove_incoming_cb(messages_service_h service, const char *app_id);
 
 
 /**
  * @brief Registers an application to the mapping table of the WAP Push service.
- *
  * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.write
- *
- * @param[in] service      The message service handle
+ * @param[in] service The message service handle
  * @param[in] content_type The MIME content type of the content
- * @param[in] app_id       The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
- *
+ * @param[in] app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
 int messages_push_register(messages_service_h service, const char *content_type, const char *app_id);
 
 
 /**
  * @brief De-registers an application from the mapping table of the WAP Push service.
- *
  * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.write
- *
- * @param[in] service      The message service handle
+ * @param[in] service The message service handle
  * @param[in] content_type The MIME content type of the content
- * @param[in] app_id       The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
- *
+ * @param[in] app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
 int messages_push_deregister(messages_service_h service, const char *content_type, const char *app_id);
 
 
 /**
  * @brief Re-registers an application to the mapping table of the WAP Push service.
- *
  * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/message.write
- *
- * @param[in] service          The message service handle
- * @param[in] content_type     An element of the composite key for searching registered entry \n
- *                             The MIME content type of the content.
- * @param[in] app_id           The composite key for searching mapping information \n
- *                             The "X-WAP-Application-ID" to indicate a destination WAP Push application ID.
+ * @param[in] service The message service handle
+ * @param[in] content_type An element of the composite key for searching registered entry \n
+ *                         The MIME content type of the content
+ * @param[in] app_id The composite key for searching mapping information \n
+ *                   The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
  * @param[in] dst_content_type The MIME content type of the content
- * @param[in] dst_app_id       The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
- *
+ * @param[in] dst_app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
  * @return @c 0 on success,
- *       otherwise a negative error value
- *
- * @retval #MESSAGES_ERROR_NONE              Successful
+ *         otherwise a negative error value
+ * @retval #MESSAGES_ERROR_NONE Successful
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval #MESSAGES_ERROR_NOT_SUPPORTED     Not supported
- *
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
 int messages_push_reregister(messages_service_h service, const char *content_type, const char *app_id,
                                                         const char *dst_content_type, const char *dst_app_id);
 
+
 /**
  * @}
  */
 
+
 /**
  * @}
  */

diff --git a/include/messages_error.h b/include/messages_error.h
index 463b5cb..c0fcf01 100644 (file)
--- a/include/messages_error.h
+++ b/include/messages_error.h
@@ -14,11 +14,14 @@
  * limitations under the License.
  */
 
+
 #ifndef __TIZEN_MESSAGING_ERROR_H__
 #define __TIZEN_MESSAGING_ERROR_H__
 
+
 #include <tizen.h>
 
+
 #ifdef __cplusplus
 extern "C"
 {
@@ -32,7 +35,7 @@ extern "C"
 
 
 /**
- * @brief Enumerations of error code for Messaging.
+ * @brief Enumeration for Messaging of error code.
  */
 typedef enum {
        MESSAGES_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */
@@ -46,15 +49,18 @@ typedef enum {
        MESSAGES_ERROR_NO_SIM_CARD = TIZEN_ERROR_MESSAGING_SERVICE|0x506, /**< No SIM Card */
        MESSAGES_ERROR_NO_DATA = TIZEN_ERROR_MESSAGING_SERVICE|0x507, /**< No data available */
        MESSAGES_ERROR_PERMISSION_DENIED = TIZEN_ERROR_PERMISSION_DENIED, /**< Permission denied */
-       MESSAGES_ERROR_NOT_SUPPORTED = TIZEN_ERROR_NOT_SUPPORTED,       /**< Not supported */
+       MESSAGES_ERROR_NOT_SUPPORTED = TIZEN_ERROR_NOT_SUPPORTED, /**< Not supported */
 } messages_error_e;
 
+
 /**
  * @}
  */
 
+
 #ifdef __cplusplus
 }
 #endif
 
+
 #endif /* __TIZEN_MESSAGING_ERROR_H__ */

diff --git a/include/messages_types.h b/include/messages_types.h
index ee400c2..fb8fef2 100644 (file)
--- a/include/messages_types.h
+++ b/include/messages_types.h
@@ -14,21 +14,26 @@
  * limitations under the License.
  */
 
+
 #ifndef __TIZEN_MESSAGING_TYPES_H__
 #define __TIZEN_MESSAGING_TYPES_H__
 
+
 #include <stdbool.h>
 
+
 #ifdef __cplusplus
 extern "C"
 {
 #endif
 
+
 /**
  * @addtogroup CAPI_MESSAGING_MESSAGES_MODULE
  * @{
  */
 
+
 /**
  * @brief The messaging service handle.
  * @since_tizen 2.3
@@ -42,16 +47,17 @@ typedef struct messages_service_s *messages_service_h;
  */
 typedef struct messages_message_s *messages_message_h;
 
+
 /**
  * @brief Enumeration for the message box type.
  * @since_tizen 2.3
  */
 typedef enum {
-       MESSAGES_MBOX_ALL = 0,      /**< All message box type */
-       MESSAGES_MBOX_INBOX = 1,    /**< Inbox type */
-       MESSAGES_MBOX_OUTBOX = 2,   /**< Outbox type*/
-       MESSAGES_MBOX_SENTBOX = 3,  /**< Sentbox type */
-       MESSAGES_MBOX_DRAFT = 4,    /**< Draft type */
+       MESSAGES_MBOX_ALL = 0, /**< All message box type */
+       MESSAGES_MBOX_INBOX = 1, /**< Inbox type */
+       MESSAGES_MBOX_OUTBOX = 2, /**< Outbox type*/
+       MESSAGES_MBOX_SENTBOX = 3, /**< Sentbox type */
+       MESSAGES_MBOX_DRAFT = 4, /**< Draft type */
 } messages_message_box_e;
 
 
@@ -60,13 +66,13 @@ typedef enum {
  * @since_tizen 2.3
  */
 typedef enum {
-       MESSAGES_TYPE_UNKNOWN = 0,                                        /**< Unknown type */
-       MESSAGES_TYPE_SMS = 1,                                            /**< SMS type */
-       MESSAGES_TYPE_MMS = 2,                                            /**< MMS type */
-       MESSAGES_TYPE_SMS_CB   = MESSAGES_TYPE_SMS | 1 << 4,              /**< CB(Cell Broadcast) Type */
-       MESSAGES_TYPE_SMS_PUSH = MESSAGES_TYPE_SMS | 10 << 4,             /**< WAP Push Type */
-       MESSAGES_TYPE_SMS_ETWS_PRIMARY = MESSAGES_TYPE_SMS | 21 << 4,     /**< ETWS(Earthquake and Tsunami Warning System) Primary Type */
-       MESSAGES_TYPE_SMS_ETWS_SECONDARY = MESSAGES_TYPE_SMS | 22 << 4,   /**< ETWS(Earthquake and Tsunami Warning System) Secondary Type */
+       MESSAGES_TYPE_UNKNOWN = 0, /**< Unknown type */
+       MESSAGES_TYPE_SMS = 1, /**< SMS type */
+       MESSAGES_TYPE_MMS = 2, /**< MMS type */
+       MESSAGES_TYPE_SMS_CB   = MESSAGES_TYPE_SMS | 1 << 4, /**< CB(Cell Broadcast) Type */
+       MESSAGES_TYPE_SMS_PUSH = MESSAGES_TYPE_SMS | 10 << 4, /**< WAP Push Type */
+       MESSAGES_TYPE_SMS_ETWS_PRIMARY = MESSAGES_TYPE_SMS | 21 << 4, /**< ETWS(Earthquake and Tsunami Warning System) Primary Type */
+       MESSAGES_TYPE_SMS_ETWS_SECONDARY = MESSAGES_TYPE_SMS | 22 << 4, /**< ETWS(Earthquake and Tsunami Warning System) Secondary Type */
 } messages_message_type_e;
 
 
@@ -75,52 +81,52 @@ typedef enum {
  * @since_tizen 2.3
  */
 typedef enum {
-       MESSAGES_MEDIA_UNKNOWN = 0,  /**< Unknown */
-       MESSAGES_MEDIA_IMAGE = 1,    /**< The image */
-       MESSAGES_MEDIA_AUDIO = 2,    /**< The audio */
-       MESSAGES_MEDIA_VIDEO = 3,    /**< The video */
+       MESSAGES_MEDIA_UNKNOWN = 0, /**< Unknown */
+       MESSAGES_MEDIA_IMAGE = 1, /**< The image */
+       MESSAGES_MEDIA_AUDIO = 2, /**< The audio */
+       MESSAGES_MEDIA_VIDEO = 3, /**< The video */
 } messages_media_type_e;
 
+
 /**
  * @brief Enumeration for the recipient type of a message.
  * @since_tizen 2.3
  */
 typedef enum {
        MESSAGES_RECIPIENT_UNKNOWN = 0, /**< Unknown */
-       MESSAGES_RECIPIENT_TO = 1,      /**< The 'To' recipient  */
-       MESSAGES_RECIPIENT_CC = 2,      /**< The 'Cc' (carbon copy) recipient */
-       MESSAGES_RECIPIENT_BCC = 3,     /**< The 'Bcc' (blind carbon copy) recipient */
+       MESSAGES_RECIPIENT_TO = 1, /**< The 'To' recipient  */
+       MESSAGES_RECIPIENT_CC = 2, /**< The 'Cc' (carbon copy) recipient */
+       MESSAGES_RECIPIENT_BCC = 3, /**< The 'Bcc' (blind carbon copy) recipient */
 } messages_recipient_type_e;
 
+
 /**
  * @brief Enumeration for the result of sending a message.
  * @since_tizen 2.3
  */
 typedef enum {
-       MESSAGES_SENDING_FAILED = -1,   /**< Message sending failed */
+       MESSAGES_SENDING_FAILED = -1, /**< Message sending failed */
        MESSAGES_SENDING_SUCCEEDED = 0, /**< Message sending succeeded */
 } messages_sending_result_e;
 
+
 /**
  * @brief Enumeration for the SIM index of a message.
  * @since_tizen 2.3
  */
 typedef enum {
-       MESSAGES_SIM_INDEX_UNKNOWN = 0, /**< Unknown SIM Index*/
-       MESSAGES_SIM_INDEX_1 = 1,               /**< SIM Index 1 */
-       MESSAGES_SIM_INDEX_2 = 2,               /**< SIM Index 2 */
+       MESSAGES_SIM_INDEX_UNKNOWN = 0, /**< Unknown SIM Index*/
+       MESSAGES_SIM_INDEX_1 = 1, /**< SIM Index 1 */
+       MESSAGES_SIM_INDEX_2 = 2, /**< SIM Index 2 */
 } messages_sim_index_e;
 
 
 /**
  * @brief Called when the process of sending a message to all recipients finishes.
  * @since_tizen 2.3
- *
- * @param[in] result     The result of message sending
- * @param[in] user_data  The user data passed from the callback registration function
- *
+ * @param[in] result The result of message sending
+ * @param[in] user_data The user data passed from the callback registration function
  * @pre messages_send_message() will invoke this callback function.
- *
  * @see messages_send_message()
  */
 typedef void (*messages_sent_cb)(messages_sending_result_e result, void *user_data);
@@ -129,12 +135,9 @@ typedef void (*messages_sent_cb)(messages_sending_result_e result, void *user_da
 /**
  * @brief Called when an incoming message is received.
  * @since_tizen 2.3
- *
- * @param[in] incoming_msg  The incoming message
- * @param[in] user_data     The user data passed from the callback registration function
- *
+ * @param[in] incoming_msg The incoming message
+ * @param[in] user_data The user data passed from the callback registration function
  * @pre You register this callback using messages_set_message_incoming_cb() for getting an incoming message.
- *
  * @see messages_set_message_incoming_cb()
  * @see messages_unset_message_incoming_cb()
  */
@@ -144,24 +147,19 @@ typedef void (*messages_incoming_cb)(messages_message_h incoming_msg, void *user
 /**
  * @brief Called when a message is retrieved from a search request.
  * @since_tizen 2.3
- *
  * @remarks You should not call messages_destroy_message() with @a msg.
- *
- * @param[in] msg          The message handle \n
- *                         It can be @c NULL if nothing is found.
- * @param[in] user_data    The user data passed from the foreach function
- * @param[in] index        The index of a message from the messages that have been retrieved as a search result
+ * @param[in] msg The message handle \n
+ *                It can be @c NULL if nothing is found
+ * @param[in] user_data The user data passed from the foreach function
+ * @param[in] index The index of a message from the messages that have been retrieved as a search result
  * @param[in] result_count The count of the messages that have been retrieved as a result applying @a limit and @a offset \n
- *                         If the search has a @a limit, then this value is always equal or less than the limit.
- * @param[in] total_count  The count of the messages that have been retrieved as a result without applying @a limit and @a offset \n
- *                         The value can be used to calculate the total number of page views for the searched messages. \n
- *                          For example, if the count of message search is @c 50 and the limit is @c 20, then using this value, you can notice the total page is @c 3.
- *
+ *                         If the search has a @a limit, then this value is always equal or less than the limit
+ * @param[in] total_count The count of the messages that have been retrieved as a result without applying @a limit and @a offset \n
+ *                        The value can be used to calculate the total number of page views for the searched messages. \n
+ *                        For example, if the count of message search is @c 50 and the limit is @c 20, then using this value, you can notice the total page is @c 3
  * @return @c true to continue with the next iteration of the loop,
  *         otherwise return @c false to break out of the loop
- *
  * @pre messages_foreach_message() will invoke this callback function.
- *
  * @see messages_foreach_message()
  */
 typedef bool (*messages_search_cb)(messages_message_h msg, int index, int result_count, int total_count, void *user_data);
@@ -172,23 +170,22 @@ typedef bool (*messages_search_cb)(messages_message_h msg, int index, int result
  * @{
  */
 
+
 /**
  * @brief Called when an incoming push message is received.
  * @since_tizen 2.3
- *
- * @param[in] header      The header of the push message
- * @param[in] body        The body of the push message \n
- *                        It is not a null-terminated string.
+ * @param[in] header The header of the push message
+ * @param[in] body The body of the push message \n
+ *                 It is not a null-terminated string
  * @param[in] body_length The length of @a body
- * @param[in] user_data   The user data to be passed to the callback function
- *
+ * @param[in] user_data The user data to be passed to the callback function
  * @pre You register this callback using messages_push_set_incoming_cb() for getting an incoming message.
- *
  * @see messages_push_set_incoming_cb()
  * @see messages_push_unset_incoming_cb()
  */
 typedef void (*messages_push_incoming_cb)(const char *header, const char *body, int body_length, void *user_data);
 
+
 /**
  * @}
  */
@@ -198,8 +195,10 @@ typedef void (*messages_push_incoming_cb)(const char *header, const char *body,
  * @}
  */
 
+
 #ifdef __cplusplus
 }
 #endif
 
+
 #endif /* __TIZEN_MESSAGING_TYPES_H__ */