3.0 Native API reference english examination

Change-Id: Iabf29c053489aca65e467c6e64de0ebf6bee0714
Signed-off-by: Jongkyu Koo <jk.koo@samsung.com>

diff --git a/include/phone_number.h b/include/phone_number.h
index 12dca05b23d8d8b790e46dd6615803ceacdb656d..cc0425c9fc8e47fad8f84e0107aa25fc0fa70c4a 100644 (file)
--- a/include/phone_number.h
+++ b/include/phone_number.h
@@ -16,6 +16,7 @@
  * limitations under the License.
  *
  */
+
 #ifndef __TIZEN_TELEPHONY_PHONE_NUMBER_UTILS_H__
 #define __TIZEN_TELEPHONY_PHONE_NUMBER_UTILS_H__
 
@@ -42,7 +43,7 @@ extern "C"
  * @brief Connects to the phonenumber-utils service.
  * @since_tizen 3.0
  * @return @c 0 on success,
- *          otherwise a negative error value
+ *         otherwise a negative error value
  * @retval #PHONE_NUMBER_ERROR_NONE Successful
  * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @see phone_number_disconnect()
@@ -55,8 +56,8 @@ int phone_number_connect(void);
  * @since_tizen 3.0
  * @return @c 0 on success,
  *         otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE Successful
- * @retval  #PHONE_NUMBER_ERROR_SYSTEM Internal error
+ * @retval #PHONE_NUMBER_ERROR_NONE Successful
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @see phone_number_connect()
  */
 int phone_number_disconnect(void);
@@ -74,17 +75,18 @@ int phone_number_disconnect(void);
  * @param[out] location The location string to be returned
  * @return @c 0 on success,
  *         otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE Successful
- * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY Out of memory
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval  #PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICE FS Full
- * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED Permission denied
- * @retval  #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
- * @retval  #PHONE_NUMBER_ERROR_NO_DATA Requested data does not exist
+ * @retval #PHONE_NUMBER_ERROR_NONE Successful
+ * @retval #PHONE_NUMBER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICE FS Full
+ * @retval #PHONE_NUMBER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_NO_DATA Requested data does not exist
  * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)
  * @post phone_number_disconnect() should be called to close a connection to the phonenumber-utils service. (Since 3.0)
  */
-int phone_number_get_location_from_number(const char *number, phone_number_region_e region, phone_number_lang_e language, char **location);
+int phone_number_get_location_from_number(const char *number,
+               phone_number_region_e region, phone_number_lang_e language, char **location);
 
 
 /**
@@ -98,18 +100,18 @@ int phone_number_get_location_from_number(const char *number, phone_number_regio
  * @param[out] formatted_number The formatted number string to be returned
  * @return @c 0 on success,
  *         otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE Successful
- * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY Out of memory
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval  #PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICE FS Full
- * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED Permission denied
- * @retval  #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
- * @retval  #PHONE_NUMBER_ERROR_NO_DATA Requested data does not exist
+ * @retval #PHONE_NUMBER_ERROR_NONE Successful
+ * @retval #PHONE_NUMBER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICE FS Full
+ * @retval #PHONE_NUMBER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_NO_DATA Requested data does not exist
  * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)
  * @post phone_number_disconnect() should be called to close a connection to the phonenumber-utils service. (Since 3.0)
- *
  */
-int phone_number_get_formatted_number(const char *number, phone_number_region_e region, char **formatted_number);
+int phone_number_get_formatted_number(const char *number, phone_number_region_e region,
+               char **formatted_number);
 
 
 /**
@@ -126,16 +128,15 @@ int phone_number_get_formatted_number(const char *number, phone_number_region_e
  * @param[out] normalized_number The normalized number string to be returned
  * @return @c 0 on success,
  *         otherwise a negative error value
- * @retval  #PHONE_NUMBER_ERROR_NONE Successful
- * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY Out of memory
- * @retval  #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED Permission denied
- * @retval  #PHONE_NUMBER_ERROR_NO_DATA Requested data does not exist
- * @retval  #PHONE_NUMBER_ERROR_SYSTEM Internal error
+ * @retval #PHONE_NUMBER_ERROR_NONE Successful
+ * @retval #PHONE_NUMBER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PHONE_NUMBER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #PHONE_NUMBER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PHONE_NUMBER_ERROR_NO_DATA Requested data does not exist
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)
  * @post phone_number_disconnect() should be called to close a connection to the phonenumber-utils service. (Since 3.0)
- *
  */
 int phone_number_get_normalized_number(const char *number, char **normalized_number);
 

diff --git a/include/phone_number_errors.h b/include/phone_number_errors.h
index 6f4d4a59e014ba565eafb981ae2445273627cc7e..ae2728bcfa4a5785462bc1cba9704b113f7501cb 100644 (file)
--- a/include/phone_number_errors.h
+++ b/include/phone_number_errors.h
@@ -16,6 +16,7 @@
  * limitations under the License.
  *
  */
+
 #ifndef __TIZEN_TELEPHONY_PHONE_NUMBER_UTILS_ERRORS_H__
 #define __TIZEN_TELEPHONY_PHONE_NUMBER_UTILS_ERRORS_H__
 

diff --git a/include/phone_number_types.h b/include/phone_number_types.h
index 5ee8567618f0bfb459079a5fda97e603a1402101..ce0dadcf346ca0229e2a0ef3c3986e44e5934156 100644 (file)
--- a/include/phone_number_types.h
+++ b/include/phone_number_types.h
@@ -16,6 +16,7 @@
  * limitations under the License.
  *
  */
+
 #ifndef __TIZEN_TELEPHONY_PHONE_NUMBER_UTILS_TYPES_H__
 #define __TIZEN_TELEPHONY_PHONE_NUMBER_UTILS_TYPES_H__
 
@@ -74,7 +75,6 @@ typedef enum {
 /**
  * @brief Enumeration for region type.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
  */
 typedef enum {
        PHONE_NUMBER_REGION_ALAND_ISLANDS, /**< Aland Islands */
@@ -166,7 +166,7 @@ typedef enum {
        PHONE_NUMBER_REGION_POLAND, /**< Poland */
        PHONE_NUMBER_REGION_PORTUGAL, /**< Portugal */
        PHONE_NUMBER_REGION_PUERTO_RICO, /**< Puerto Rico */
-       PHONE_NUMBER_REGION_REPUBLIC_OF_KOREA,  /**< Korea (Republic of) */
+       PHONE_NUMBER_REGION_REPUBLIC_OF_KOREA, /**< Korea (Republic of) */
        PHONE_NUMBER_REGION_REPUBLIC_OF_MOLDOVA, /**< Moldova (Republic of)  */
        PHONE_NUMBER_REGION_ROMANIA, /**< Romania */
        PHONE_NUMBER_REGION_RUSSIAN_FEDERATION, /**< Russian Federation */
@@ -216,7 +216,7 @@ typedef enum {
        PHONE_NUMBER_REGION_ARUBA, /**< Aruba (Since 3.0) */
        PHONE_NUMBER_REGION_AZERBAIJAN, /**< Azerbaijan (Since 3.0) */
        PHONE_NUMBER_REGION_BOSNIA_AND_HERZEGOVINA, /**< Bosnia and Herzegovina (Since 3.0) */
-       PHONE_NUMBER_REGION_BANGLADESH,  /**< Bangladesh (Since 3.0) */
+       PHONE_NUMBER_REGION_BANGLADESH, /**< Bangladesh (Since 3.0) */
        PHONE_NUMBER_REGION_BAHRAIN, /**< Bahrain (Since 3.0) */
        PHONE_NUMBER_REGION_SAINT_BARTHELEMY, /**< Saint Barthelemy, French Antilles (Since 3.0) */
        PHONE_NUMBER_REGION_BRUNEI_DARUSSALAM, /**< Brunei Darussalam (Since 3.0) */
@@ -261,8 +261,8 @@ typedef enum {
        PHONE_NUMBER_REGION_LIBERIA, /**< Liberia (Since 3.0) */
        PHONE_NUMBER_REGION_LIBYA, /**< Libya (Soc. People's Libyan Arab Jamahiriya) (Since 3.0) */
        PHONE_NUMBER_REGION_MONACO, /**< Monaco (Since 3.0) */
-       PHONE_NUMBER_REGION_MONTENEGRO,  /**< Montenegro (Since 3.0) */
-       PHONE_NUMBER_REGION_SAINT_MARTIN,  /**< Saint-Martin, French Antilles (Since 3.0) */
+       PHONE_NUMBER_REGION_MONTENEGRO, /**< Montenegro (Since 3.0) */
+       PHONE_NUMBER_REGION_SAINT_MARTIN, /**< Saint-Martin, French Antilles (Since 3.0) */
        PHONE_NUMBER_REGION_MARSHALL_ISLANDS, /**< Marshall Islands (Since 3.0) */
        PHONE_NUMBER_REGION_MALI, /**< Mali (Since 3.0) */
        PHONE_NUMBER_REGION_MYANMAR, /**< Myanmar (Since 3.0) */
@@ -296,10 +296,10 @@ typedef enum {
        PHONE_NUMBER_REGION_REUNION, /**< Reunion (French Departments and Territories in the Indian Ocean) (Since 3.0) */
        PHONE_NUMBER_REGION_RWANDA, /**< Rwanda (Since 3.0) */
        PHONE_NUMBER_REGION_SOLOMON_ISLANDS, /**< Solomon Islands (Since 3.0) */
-       PHONE_NUMBER_REGION_SEYCHELLES,  /**< Seychelles (Since 3.0) */
+       PHONE_NUMBER_REGION_SEYCHELLES, /**< Seychelles (Since 3.0) */
        PHONE_NUMBER_REGION_SINGAPORE, /**< Singapore (Since 3.0) */
        PHONE_NUMBER_REGION_SLOVENIA, /**< Slovenia (Since 3.0) */
-       PHONE_NUMBER_REGION_SAN_MARINO,  /**< San Marino (Since 3.0) */
+       PHONE_NUMBER_REGION_SAN_MARINO, /**< San Marino (Since 3.0) */
        PHONE_NUMBER_REGION_SURINAME, /**< Suriname (Since 3.0) */
        PHONE_NUMBER_REGION_SOUTH_SUDAN, /**< South Sudan (Since 3.0) */
        PHONE_NUMBER_REGION_EL_SALVADOR, /**< El Salvador (Since 3.0) */
@@ -307,7 +307,7 @@ typedef enum {
        PHONE_NUMBER_REGION_CHAD, /**< Chad (Since 3.0) */
        PHONE_NUMBER_REGION_TAJIKISTAN, /**< Tajikistan (Since 3.0) */
        PHONE_NUMBER_REGION_TOKELAU, /**< Tokelau (Since 3.0) */
-       PHONE_NUMBER_REGION_TIMOR_LESTE,  /**< Timor-Leste (East Timor) (Since 3.0) */
+       PHONE_NUMBER_REGION_TIMOR_LESTE, /**< Timor-Leste (East Timor) (Since 3.0) */
        PHONE_NUMBER_REGION_TURKMENISTAN, /**< Turkmenistan (Since 3.0) */
        PHONE_NUMBER_REGION_TONGA, /**< Tonga (Since 3.0) */
        PHONE_NUMBER_REGION_TUVALU, /**< Tuvalu (Since 3.0) */
@@ -315,7 +315,7 @@ typedef enum {
        PHONE_NUMBER_REGION_UKRAINE, /**< Ukraine (Since 3.0) */
        PHONE_NUMBER_REGION_URUGUAY, /**< Uruguay (Since 3.0) */
        PHONE_NUMBER_REGION_UZBEKISTAN, /**< Uzbekistan (Since 3.0) */
-       PHONE_NUMBER_REGION_VATICAN_CITY,  /**< Vatican City (Since 3.0) */
+       PHONE_NUMBER_REGION_VATICAN_CITY, /**< Vatican City (Since 3.0) */
        PHONE_NUMBER_REGION_VANUATU, /**< Vanuatu (Since 3.0) */
        PHONE_NUMBER_REGION_WALLIS_AND_FUTUNA, /**< Wallis and Futuna (Territoire francais d'outre-mer) (Since 3.0) */
        PHONE_NUMBER_REGION_SAMOA, /**< Samoa (Since 3.0) */