Fix API description

Change-Id: Icbac9f9b0c182d0a4f642afc6f23f29f01bf7907
Signed-off-by: Jiwoong Im <jiwoong.im@samsung.com>
(cherry picked from commit 123244c3b022862cf349729b771a21094bf1d1b6)

2 files changed, 304 insertions, 272 deletions

diff --git a/doc/bundle_doc.h b/doc/bundle_doc.h
index 263b9d5..8809145 100755
--- a/doc/bundle_doc.h
+++ b/doc/bundle_doc.h
@@ -18,17 +18,17 @@
 #ifndef __TIZEN_CORE_LIB_BUNDLE_DOC_H__
 #define __TIZEN_CORE_LIB_BUNDLE_DOC_H__
 
+
 /**
  * @ingroup CAPI_APPLICATION_FRAMEWORK
  * @defgroup CORE_LIB_BUNDLE_MODULE Bundle
- * @brief  A simple string-based dictionary ADT.
- *
+ * @brief A simple string-based dictionary ADT.
  * @section CORE_LIB_BUNDLE_MODULE_HEADER Required Header
- *   \#include <bundle.h>
+ * \#include <bundle.h>
  *
  * @section CORE_LIB_BUNDLE_MODULE_OVERVIEW Overview
  *  Bundle is a string based Dictionary ADT. A dictionary is an ordered or unordered list of key element pairs, where keys are used to locate elements in the list.
-*
-*/
+ */
+
 
 #endif /* __TIZEN_CORE_LIB_BUNDLE_DOC_H__ */
diff --git a/include/bundle.h b/include/bundle.h
index fedfd80..275cbf3 100755
--- a/include/bundle.h
+++ b/include/bundle.h
@@ -19,7 +19,7 @@
 
 /**
  * @file bundle.h
- * @brief    This file declares has API of the bundle library
+ * @brief This file declares API of the bundle library.
  */
 
 /**
@@ -40,8 +40,7 @@ extern "C" {
 #define unlikely(x) __builtin_expect(x, 0)
 
 /**
- * @brief Enumeration for error code of Bundle.
- *
+ * @brief Enumeration for error codes of Bundle.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  */
 typedef enum {
@@ -52,12 +51,14 @@ typedef enum {
 	BUNDLE_ERROR_KEY_EXISTS = TIZEN_ERROR_BUNDLE | 0x01 /**< Key exists */
 } bundle_error_e;
 
+
 /**
  * @brief The bundle handle.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  */
 typedef struct _bundle_t bundle;
 
+
 /**
  * @brief The encoded data type.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -66,6 +67,7 @@ typedef struct _bundle_t bundle;
  */
 typedef unsigned char bundle_raw;
 
+
 /**
  * @brief Enumeration for key-value pair types.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -76,6 +78,7 @@ enum bundle_type_property {
 	BUNDLE_TYPE_MEASURABLE = 0x0400 /**< Measurable type */
 };
 
+
 /**
  * @brief Enumeration for bundle types.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -89,6 +92,7 @@ enum bundle_type {
 	BUNDLE_TYPE_BYTE_ARRAY = BUNDLE_TYPE_BYTE | BUNDLE_TYPE_ARRAY /**< Byte array type */
 };
 
+
 /**
  * @brief The key-value pair handle.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -96,461 +100,489 @@ enum bundle_type {
  */
 typedef struct keyval_t bundle_keyval_t;
 
+
 /**
  * @brief Called for every key-value pair.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @see bundle_foreach()
  */
-typedef void (*bundle_iterator_t) (
-		const char *key,
-		const int type,
-		const bundle_keyval_t *kv,
-		void *user_data
-);
+typedef void (*bundle_iterator_t) (const char *key, const int type, const bundle_keyval_t *kv, void *user_data );
+
 
 /**
  * @brief Creates a bundle object.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
- * @return	The bundle object
- * @retval	@c NULL - Failure
- * @exception BUNDLE_ERROR_NONE	Success
- * @exception BUNDLE_ERROR_OUT_OF_MEMORY	Out of memory
- * @see			bundle_free()
+ * @return The bundle object
+ * @retval @c NULL - Failure
+ * @exception BUNDLE_ERROR_NONE Success
+ * @exception BUNDLE_ERROR_OUT_OF_MEMORY Out of memory
+ * @see bundle_free()
  *
- @code
+ * @code
  #include <bundle.h>
- bundle *b = bundle_create(); // Create new bundle object
- bundle_free(b); // free bundle
- @endcode
+ bundle *b = bundle_create(); // Create a new bundle object
+ bundle_free(b); // Free the bundle
+ * @endcode
  */
 API bundle *bundle_create(void);
 
+
 /**
  * @brief Frees the given bundle object with key-value pairs in it.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in]	b	The bundle object to be freed
- * @return		The operation result;
- * @retval BUNDLE_ERROR_NONE	Success
- * @retval BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @pre			@a b must be a valid bundle object.
- * @see			bundle_create()
- @code
+ * @param[in] b The bundle object to be freed
+ * @return The operation result
+ * @retval BUNDLE_ERROR_NONE Success
+ * @retval BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @pre @a b must be a valid bundle object.
+ * @see bundle_create()
+ *
+ * @code
  #include <bundle.h>
- bundle *b = bundle_create(); // Create new bundle object
- bundle_free(b); // free bundle
- @endcode
+ bundle *b = bundle_create(); // Create a new bundle object
+ bundle_free(b); // Free the bundle
+ * @endcode
  */
 API int bundle_free(bundle *b);
 
+
 /**
  * @brief Adds a strings array type key-value pair into a given bundle.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in]	b	The bundle object
- * @param[in]	key	The key
- * @param[in]	str_array The string type value; if @c NULL, an empty array is created; you can change an item with
- * @param[in]	len The length of the array
- * @return		The operation result
- * @retval BUNDLE_ERROR_NONE	Success
- * @retval BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @retval BUNDLE_ERROR_KEY_EXISTS	Key already exists
- * @retval BUNDLE_ERROR_OUT_OF_MEMORY	Out of memory
- * @pre			@a b must be a valid bundle object.
- * @see			bundle_get_str_array()
+ * @param[in] b The bundle object
+ * @param[in] key The key
+ * @param[in] str_array The string type value; if @c NULL, an empty array is created; you can change an item with
+ * @param[in] len The length of the array
+ * @return The operation result
+ * @retval BUNDLE_ERROR_NONE Success
+ * @retval BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval BUNDLE_ERROR_KEY_EXISTS Key already exists
+ * @retval BUNDLE_ERROR_OUT_OF_MEMORY Out of memory
+ * @pre @a b must be a valid bundle object.
+ * @see bundle_get_str_array()
  *
- @code
+ * @code
  #include <bundle.h>
- char *sa = { "aaa", "bbb", "ccc" };	// A string array of length 3
+ char *sa = {"aaa", "bbb", "ccc"}; // String array of length 3
  bundle *b = bundle_create();
- bundle_add_str_array(b, "foo", sa, 3); // add a key-val pair
+ bundle_add_str_array(b, "foo", sa, 3); // Add a key-value pair
  bundle_free(b);
- @endcode
+ * @endcode
  */
 API int bundle_add_str_array(bundle *b, const char *key, const char **str_array, const int len);
 
+
 /**
  * @brief Deletes a key-value object with the given key.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in]	b	The bundle object
- * @param[in]	key	The given key
- * @return		The operation result
- * @retval BUNDLE_ERROR_NONE	Success
- * @retval BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @retval BUNDLE_ERROR_KEY_NOT_AVAILABLE	Key not available
- * @pre			@a b must be a valid bundle object.
- @code
+ * @param[in] b The bundle object
+ * @param[in] key The given key
+ * @return The operation result
+ * @retval BUNDLE_ERROR_NONE Success
+ * @retval BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval BUNDLE_ERROR_KEY_NOT_AVAILABLE Key not available
+ * @pre @a b must be a valid bundle object.
+ *
+ * @code
  #include <bundle.h>
- bundle *b = bundle_create(); // Create new bundle object
- bundle_add_str(b, "foo_key", "bar_val"); // add a key-val pair
- bundle_del(b, "foo_key"); // del "foo_key" from b
+ bundle *b = bundle_create(); // Create a new bundle object
+ bundle_add_str(b, "foo_key", "bar_val"); // Add a key-value pair
+ bundle_del(b, "foo_key"); // Delete "foo_key" from b
 
  bundle_free(b);
- @endcode
+ * @endcode
  */
 API int bundle_del(bundle *b, const char *key);
 
+
 /**
  * @brief Gets a string array from a given key.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @remarks	You MUST NOT free or modify the returned string!
- *		The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
- * @param[in]	b	The bundle object
- * @param[in]	key	The key
- * @param[out]	len	The array length
- * @return		The pointer to the array of strings
- * @retval		@c NULL - Key not found
- * @exception BUNDLE_ERROR_NONE	Success
- * @exception BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @exception BUNDLE_ERROR_KEY_NOT_AVAILABLE	Key not available
- * @pre			@a b must be a valid bundle object.
- * @see			bundle_add_str_array()
- @code
+ * @remarks You MUST NOT free or modify the returned string. \n
+ *          The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
+ * @param[in] b The bundle object
+ * @param[in] key The key
+ * @param[out] len The array length
+ * @return The pointer to the array of strings
+ * @retval @c NULL - Key not found
+ * @exception BUNDLE_ERROR_NONE Success
+ * @exception BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception BUNDLE_ERROR_KEY_NOT_AVAILABLE Key not available
+ * @pre @a b must be a valid bundle object.
+ * @see bundle_add_str_array()
+ *
+ * @code
  #include <bundle.h>
  bundle *b = bundle_create();
- char *sa = { "aaa", "bbb", "ccc" };	// A string array of length 3
- bundle_add_str_array(b, "foo", sa, 3); // add a key-val pair
+ char *sa = {"aaa", "bbb", "ccc"}; // String array of length 3
+ bundle_add_str_array(b, "foo", sa, 3); // Add a key-value pair
 
  char **str_array = NULL;
  int len_str_array = 0;
 
  str_array=bundle_get_str_array(b, "foo", &len_str_array);
- // str_array = { "aaa", "bbb", "ccc" }, and len_str_array = 3
+ // str_array = {"aaa", "bbb", "ccc"}, and len_str_array = 3
 
  bundle_free(b);
- @endcode
+ * @endcode
  */
 API const char **bundle_get_str_array(bundle *b, const char *key, int *len);
 
+
 /**
  * @brief Gets the number of bundle items.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in]	b	The bundle object
- * @return		The number of bundle items
- * @pre			@a b must be a valid bundle object.
- @code
+ * @param[in] b The bundle object
+ * @return The number of bundle items
+ * @pre @a b must be a valid bundle object.
+ *
+ * @code
  #include <bundle.h>
- bundle *b = bundle_create(); // Create new bundle object
- bundle_add_str(b, "key1", "val1"); //add a key-val pair
- int count = bundle_get_count(b);	// count=1
- bundle_add_str(b, "key2", "val2"); // add another key-val pair
- count = bundle_get_count(b); // count=2
+ bundle *b = bundle_create(); // Create a new bundle object
+ bundle_add_str(b, "key1", "val1"); // Add a key-value pair
+ int count = bundle_get_count(b); // count = 1
+ bundle_add_str(b, "key2", "val2"); // Add another key-value pair
+ count = bundle_get_count(b); // count = 2
 
  bundle_free(b);
- @endcode
+ * @endcode
  */
 API int bundle_get_count(bundle *b);
 
+
 /**
- * @brief Gets the type of a value with a given key.
+ * @brief Gets the type of the value with a given key.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
- * @param[in]	b	A bundle
- * @param[in]	key	A key in the bundle
- * @return	The type of a key in @a b
- * @exception BUNDLE_ERROR_NONE	Success
- * @exception BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @exception BUNDLE_ERROR_KEY_NOT_AVAILABLE	Key not available
- * @pre		@a b must be a valid bundle object.
- * @see		bundle_type_t
- @code
- @endcode
+ * @param[in] b A bundle
+ * @param[in] key A key in the bundle
+ * @return The type of a key in @a b
+ * @exception BUNDLE_ERROR_NONE Success
+ * @exception BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception BUNDLE_ERROR_KEY_NOT_AVAILABLE Key not available
+ * @pre @a b must be a valid bundle object.
+ * @see bundle_type_t
  */
 API int bundle_get_type(bundle *b, const char *key);
 
+
 /**
  * @brief Duplicates a given bundle object.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
- * @param[in]   b_from  the bundle object to be duplicated
- * @return              The new bundle object
- * @retval              @c NULL - Failure
+ * @param[in] b_from The bundle object to be duplicated
+ * @return The new bundle object
+ * @retval @c NULL - Failure
  * @exception BUNDLE_ERROR_NONE Success
- * @exception BUNDLE_ERROR_INVALID_PARAMETER    Invalid parameter
- * @pre                 @a b must be a valid bundle object.
- @code
+ * @exception BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @pre @a b must be a valid bundle object.
+ *
+ * @code
  #include <bundle.h>
- bundle *b = bundle_create(); // Create new bundle object
- bundle_add_str(b, "foo_key", "bar_val"); // add a key-val pair
- bundle *b_dup = bundle_dup(b); // duplicate b
+ bundle *b = bundle_create(); // Create a new bundle object
+ bundle_add_str(b, "foo_key", "bar_val"); // Add a key-value pair
+ bundle *b_dup = bundle_dup(b); // Duplicate b
 
  bundle_free(b);
  bundle_free(b_dup);
- @endcode
+ * @endcode
  */
 API bundle *bundle_dup(bundle *b_from);
 
+
 /**
  * @brief Iterates a callback function for each key-value pair in a given bundle.
  * @details Supports all types of values.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
- * @remarks		This function supports all types.
- * @param[in]	b	The bundle object
- * @param[in]	iter	The iteration callback function
- * @param[in]	user_data	The data for the callback function
- * @exception BUNDLE_ERROR_NONE	Success
- * @exception BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @pre			@a b must be a valid bundle object.
- * @see			bundle_keyval_get_type()
- * @see			bundle_keyval_type_is_array()
- * @see			bundle_keyval_get_basic_val()
- * @see			bundle_keyval_get_array_val()
- @code
+ * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section. \n
+ *          This function supports all types.
+ * @param[in] b The bundle object
+ * @param[in] iter The iteration callback function
+ * @param[in] user_data The data for the callback function
+ * @exception BUNDLE_ERROR_NONE Success
+ * @exception BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @pre @a b must be a valid bundle object.
+ * @see bundle_keyval_get_type()
+ * @see bundle_keyval_type_is_array()
+ * @see bundle_keyval_get_basic_val()
+ * @see bundle_keyval_get_array_val()
+ *
+ * @code
  #include <stdio.h>
  #include <bundle.h>
- void sample_cb(const char *key, const int type, const bundle_keyval_t *kv, void *user_data) {
-   void *basic_val = NULL;
-   size_t basic_size = 0;
-   void **array_val = NULL;
-   int array_len = 0;
-   size_t *array_elem_size = NULL;
-
-   printf("Key:%s, Type:%d\n", key, type);
-   if(bundle_keyval_type_is_array(kv)) {
-     bundle_keyval_get_array_val(kv, &array_val, &array_len, &array_elem_size);
-	 // Do something...
-   }
-   else {
-     bundle_keyval_get_basic_val(kv, &basic_val, &basic_size);
-	 // Do something...
-   }
+ void
+ sample_cb(const char *key, const int type, const bundle_keyval_t *kv, void *user_data)
+ {
+     void *basic_val = NULL;
+     size_t basic_size = 0;
+     void **array_val = NULL;
+     int array_len = 0;
+     size_t *array_elem_size = NULL;
+
+     printf("Key:%s, Type:%d\n", key, type);
+     if (bundle_keyval_type_is_array(kv)) {
+         bundle_keyval_get_array_val(kv, &array_val, &array_len, &array_elem_size);
+         // Do something
+     }
+     else {
+         bundle_keyval_get_basic_val(kv, &basic_val, &basic_size);
+         // Do something
+     }
  }
 
- int main(void) {
-	 bundle *b = bundle_create(); // Create new bundle object
-	 bundle_add_str(b, "k1", "v1"); // add a key-val pair
-	 bundle_add_byte(b, "k2", "v2", 3); // add a key-val pair
-	 char *s_arr[] = {"abc", "bcd", "cde"};
-	 bundle_add_str_array(b, "k3", s_arr, 3); // add a key-val pair
-	 bundle_foreach(b, sample_cb, NULL);	// iterate sample_cb() for each key/val
-	 return 0;
+ int main(void)
+ {
+     bundle *b = bundle_create(); // Create a new bundle object
+     bundle_add_str(b, "k1", "v1"); // Add a key-value pair
+     bundle_add_byte(b, "k2", "v2", 3); // Add a key-value pair
+     char *s_arr[] = {"abc", "bcd", "cde"};
+     bundle_add_str_array(b, "k3", s_arr, 3); // Add a key-value pair
+     bundle_foreach(b, sample_cb, NULL); // Iterate sample_cb() for each key/value
+
+     return 0;
  }
- @endcode
+ * @endcode
  */
 API void bundle_foreach(bundle *b, bundle_iterator_t iter, void *user_data);
 
+
 /**
  * @brief Gets the type of a key-value pair.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
- * @param[in]	kv	A bundle_keyval_t object
- * @return	The type of @a kv
- * @retval	@c -1 - Failure
- * @exception BUNDLE_ERROR_NONE	Success
- * @exception BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @pre		@a kv must be a valid bundle_keyval_t object.
- * @see		bundle_foreach()
+ * @param[in] kv A bundle_keyval_t object
+ * @return The type of @a kv
+ * @retval @c -1 - Failure
+ * @exception BUNDLE_ERROR_NONE Success
+ * @exception BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @pre @a kv must be a valid bundle_keyval_t object.
+ * @see bundle_foreach()
  */
 API int bundle_keyval_get_type(bundle_keyval_t *kv);
 
+
 /**
- * @brief Determines whether the  type of a key-value pair is array.
+ * @brief Determines whether the type of a key-value pair is an array.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
- * @param[in]	kv	A bundle_keyval_t object
- * @return		The operation result
- * @retval		@c 1 - @a kv is an array
- * @retval		@c 0 - @a kv is not an array
- * @exception BUNDLE_ERROR_NONE	Success
- * @exception BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @pre		@a kv must be a valid bundle_keyval_t object.
- * @see		bundle_foreach()
+ * @param[in] kv A bundle_keyval_t object
+ * @return The operation result
+ * @retval @c 1 - @a kv is an array
+ * @retval @c 0 - @a kv is not an array
+ * @exception BUNDLE_ERROR_NONE Success
+ * @exception BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @pre @a kv must be a valid bundle_keyval_t object.
+ * @see bundle_foreach()
  */
 API int bundle_keyval_type_is_array(bundle_keyval_t *kv);
 
+
 /**
  * @brief Gets the value and size of the value from a key-value pair of basic type.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @remarks	You must not free @a val.
- * @param[in]	kv		A bundle_keyval_t object
- * @param[out]	val		The value
- * @param[out]	size	The size of @a val
- * @return	The operation result
- * @retval BUNDLE_ERROR_NONE	Success
- * @retval BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @pre		@a kv must be a valid bundle_keyval_t object.
- * @post	@a val and @a size are set.
- * @see		bundle_foreach()
+ * @remarks You must not free @a val.
+ * @param[in] kv A bundle_keyval_t object
+ * @param[out] val The value
+ * @param[out] size The size of @a val
+ * @return The operation result
+ * @retval BUNDLE_ERROR_NONE Success
+ * @retval BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @pre @a kv must be a valid bundle_keyval_t object.
+ * @post @a val and @a size are set.
+ * @see bundle_foreach()
  */
 API int bundle_keyval_get_basic_val(bundle_keyval_t *kv, void **val, size_t *size);
 
+
 /**
  * @brief Gets the value array, length of the array, and size of each array item.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in]	kv		A bundle_keyval_t object
- * @param[out]	array_val	The array pointer of values
- * @param[out]	array_len	The length of @a array_val
- * @param[out]	array_element_size	The array of size of each array element
- * @return	The operation result
- * @retval BUNDLE_ERROR_NONE	Success
- * @retval BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @pre		@a kv must be a valid bundle_keyval_t object.
- * @post	@a array_val, @a array_len, @a array_item_size are set.
- * @see		bundle_foreach()
+ * @param[in] kv A bundle_keyval_t object
+ * @param[out] array_val The array pointer of values
+ * @param[out] array_len The length of @a array_val
+ * @param[out] array_element_size The array of size of each array element
+ * @return The operation result
+ * @retval BUNDLE_ERROR_NONE Success
+ * @retval BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @pre @a kv must be a valid bundle_keyval_t object.
+ * @post @a array_val, @a array_len, @a array_item_size are set.
+ * @see bundle_foreach()
  */
 API int bundle_keyval_get_array_val(bundle_keyval_t *kv, void ***array_val, unsigned int *array_len, size_t **array_element_size);
 
+
 /**
  * @brief Encodes a bundle to the bundle_raw format (uses base64 format).
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in]	b	The bundle object
- * @param[out]	r	The returned bundle_raw data(byte data)
- *					@a r MUST BE FREED by free(r)
- * @param[out]	len	The size of @a r (in bytes)
- * @return	The size of the raw data
- * @retval BUNDLE_ERROR_NONE	Success
- * @retval BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @pre			@a b must be a valid bundle object.
- @code
+ * @param[in] b The bundle object
+ * @param[out] r The returned bundle_raw data(byte data)
+ *               @a r MUST BE FREED by free(r)
+ * @param[out] len The size of @a r (in bytes)
+ * @return The size of the raw data
+ * @retval BUNDLE_ERROR_NONE Success
+ * @retval BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @pre @a b must be a valid bundle object.
+ *
+ * @code
  #include <bundle.h>
- bundle *b = bundle_create(); // Create new bundle object
- bundle_add_str(b, "foo_key", "bar_val"); // add a key-val pair
+ bundle *b = bundle_create(); // Create a new bundle object
+ bundle_add_str(b, "foo_key", "bar_val"); // Add a key-value pair
  bundle_raw *r;
  int len;
- bundle_encode(b, &r, &len);	// encode b
+ bundle_encode(b, &r, &len); // Encode b
 
  bundle_free(b);
- @endcode
+ * @endcode
  */
 API int bundle_encode(bundle *b, bundle_raw **r, int *len);
 
+
 /**
  * @brief Deserializes bundle_raw and gets the bundle object.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
- * @param[in]	r	The bundle_raw data to be converted to bundle object
- * @param[in]	len	The size of @a r
- * @return	The bundle object
- * @retval	@c NULL - Failure
- * @exception BUNDLE_ERROR_NONE	Success
- * @exception BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @pre			@a b must be a valid bundle object.
- @code
+ * @param[in] r The bundle_raw data to be converted to bundle object
+ * @param[in] len The size of @a r
+ * @return The bundle object
+ * @retval @c NULL - Failure
+ * @exception BUNDLE_ERROR_NONE Success
+ * @exception BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @pre @a b must be a valid bundle object.
+ *
+ * @code
  #include <bundle.h>
- bundle *b = bundle_create(); // Create new bundle object
- bundle_add_str(b, "foo_key", "bar_val"); // add a key-val pair
+ bundle *b = bundle_create(); // Create a new bundle object
+ bundle_add_str(b, "foo_key", "bar_val"); // Add a key-value pair
 
  bundle_raw *encoded_b;
  int len;
- bundle_encode(b, &encoded_b, &len);	// encode b
+ bundle_encode(b, &encoded_b, &len); // Encode b
 
  bundle *b_dup;
- b_dup = bundle_decode(encoded_b, len);	// decoded bundle object
+ b_dup = bundle_decode(encoded_b, len); // Decoded bundle object
 
  bundle_free(b);
  free(encoded_b);
  bundle_free(b_dup);
- @endcode
+ * @endcode
  */
 API bundle *bundle_decode(const bundle_raw *r, const int len);
 
+
 /**
  * @brief Adds a string type key-value pair into a bundle.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in]	b	The bundle object
- * @param[in]	key	The key
- * @param[in]	str The string type value
- * @return		The operation result
- * @retval BUNDLE_ERROR_NONE	Success
- * @retval BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @retval BUNDLE_ERROR_KEY_EXISTS	Key already exists
- * @retval BUNDLE_ERROR_OUT_OF_MEMORY	Out of memory
- * @pre			@a b must be a valid bundle object.
- * @see			bundle_get_str()
- @code
+ * @param[in] b The bundle object
+ * @param[in] key The key
+ * @param[in] str The string type value
+ * @return The operation result
+ * @retval BUNDLE_ERROR_NONE Success
+ * @retval BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval BUNDLE_ERROR_KEY_EXISTS Key already exists
+ * @retval BUNDLE_ERROR_OUT_OF_MEMORY Out of memory
+ * @pre @a b must be a valid bundle object.
+ * @see bundle_get_str()
+ * @code
  #include <bundle.h>
- bundle *b = bundle_create(); // Create new bundle object
- bundle_add_str(b, "foo", "bar"); // add a key-val pair
+ bundle *b = bundle_create(); // Create a new bundle object
+ bundle_add_str(b, "foo", "bar"); // Add a key-value pair
 
  bundle_free(b);
- @endcode
+ * @endcode
  */
 API int bundle_add_str(bundle *b, const char *key, const char *str);
 
+
 /**
  * @brief Adds a byte type key-value pair into a bundle.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in]	b	The bundle object
- * @param[in]	key	The key
- * @param[in]	byte The string type value
- * @param[in]	size The size of @a byte
- * @return		The operation result
- * @retval BUNDLE_ERROR_NONE	Success
- * @retval BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @retval BUNDLE_ERROR_KEY_EXISTS	Key already exists
- * @retval BUNDLE_ERROR_OUT_OF_MEMORY	Out of memory
- * @pre			@a b must be a valid bundle object.
- * @see			bundle_get_byte()
- @code
+ * @param[in] b The bundle object
+ * @param[in] key The key
+ * @param[in] byte The string type value
+ * @param[in] size The size of @a byte
+ * @return The operation result
+ * @retval BUNDLE_ERROR_NONE Success
+ * @retval BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval BUNDLE_ERROR_KEY_EXISTS Key already exists
+ * @retval BUNDLE_ERROR_OUT_OF_MEMORY Out of memory
+ * @pre @a b must be a valid bundle object.
+ * @see bundle_get_byte()
+ *
+ * @code
  #include <bundle.h>
- bundle *b = bundle_create(); // Create new bundle object
- bundle_add_byte(b, "foo", "bar\0", 4); // add a key-val pair
+ bundle *b = bundle_create(); // Create a new bundle object
+ bundle_add_byte(b, "foo", "bar\0", 4); // Add a key-value pair
 
  int number = 12345;
  bundle_add_byte(b, "number", &number, sizeof(int));
 
  bundle_free(b);
- @endcode
+ * @endcode
  */
 API int bundle_add_byte(bundle *b, const char *key, const void *byte, const size_t size);
 
+
 /**
  * @brief Gets the string value with the given key.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @remarks		You must not free str!
- * @param[in]	b	The bundle object
- * @param[in]	key	The key
- * @param[out]	str The returned value
- * @return		The operation result
- * @retval BUNDLE_ERROR_NONE	Success
- * @retval BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @retval BUNDLE_ERROR_KEY_NOT_AVAILABLE	Key not available
- * @pre			@a b must be a valid bundle object.
- * @see			bundle_add_str()
- @code
+ * @remarks You must not free str.
+ * @param[in] b The bundle object
+ * @param[in] key The key
+ * @param[out] str The returned value
+ * @return The operation result
+ * @retval BUNDLE_ERROR_NONE Success
+ * @retval BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval BUNDLE_ERROR_KEY_NOT_AVAILABLE Key not available
+ * @pre @a b must be a valid bundle object.
+ * @see bundle_add_str()
+ *
+ * @code
  #include <bundle.h>
- bundle *b = bundle_create(); // Create new bundle object
- bundle_add_str(b, "foo_key", "bar_val"); // add a key-val pair
+ bundle *b = bundle_create(); // Create a new bundle object
+ bundle_add_str(b, "foo_key", "bar_val"); // Add a key-value pair
 
  char *v = NULL;
- bundle_get_str(b, "foo_key", &v);	// v = "bar_val"
+ bundle_get_str(b, "foo_key", &v); // v = "bar_val"
 
- bundle_free(b);	// After freeing b, v becomes a dangling pointer.
+ bundle_free(b); // After freeing b, v becomes a dangling pointer
  v = NULL;
- @endcode
+ * @endcode
  */
 API int bundle_get_str(bundle *b, const char *key, char **str);
 
+
 /**
  * @brief Gets the byte value with the given key.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @remarks		You must not free @a byte!
- * @param[in]	b	The bundle object
- * @param[in]	key	The key
- * @param[out]	byte The returned value
- * @param[out]	size The size of the byte
- * @return		The operation result
- * @retval BUNDLE_ERROR_NONE	Success
- * @retval BUNDLE_ERROR_INVALID_PARAMETER	Invalid parameter
- * @retval BUNDLE_ERROR_KEY_NOT_AVAILABLE	Key not available
- * @pre			@a b must be a valid bundle object.
- * @see			bundle_add_byte()
- @code
+ * @remarks You must not free @a byte.
+ * @param[in] b The bundle object
+ * @param[in] key The key
+ * @param[out] byte The returned value
+ * @param[out] size The size of the byte
+ * @return The operation result
+ * @retval BUNDLE_ERROR_NONE Success
+ * @retval BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval BUNDLE_ERROR_KEY_NOT_AVAILABLE Key not available
+ * @pre @a b must be a valid bundle object.
+ * @see bundle_add_byte()
+ *
+ * @code
  #include <bundle.h>
- bundle *b = bundle_create(); // Create new bundle object
- bundle_add_byte(b, "foo", "bar\0", 4); // add string to bundle
+ bundle *b = bundle_create(); // Create a new bundle object
+ bundle_add_byte(b, "foo", "bar\0", 4); // Add a string to the bundle
  int number = 12345;
- bundle_add_byte(b, "number", (const void**)&number, sizeof(int)); // add integer to bundle
+ bundle_add_byte(b, "number", (const void**)&number, sizeof(int)); // Add an integer to the bundle
 
  unsigned char *v = NULL;
  size_t v_size;
- bundle_get_byte(b, "foo", (void**)&v, &v_size);    // v = "bar\0"
+ bundle_get_byte(b, "foo", (void**)&v, &v_size); // v = "bar\0"
  int *n = NULL;
  size_t n_size;
  bundle_get_byte(b, "number", (void**)&n, &n_size); // number = 12345
 
- bundle_free(b);	// After freeing b, v and n becomes a dangling pointer.
- @endcode
+ bundle_free(b); // After freeing b, v and n become a dangling pointer
+ * @endcode
  */
 API int bundle_get_byte(bundle *b, const char *key, void **byte, size_t *size);
 
@@ -562,4 +594,4 @@ API int bundle_get_byte(bundle *b, const char *key, void **byte, size_t *size);
  * @}
  */
 
-#endif	/* __BUNDLE_H__ */
+#endif /* __BUNDLE_H__ */