Updated some documents for network APIs 83/60583/1
authorWootak Jung <wootak.jung@samsung.com>
Mon, 29 Feb 2016 07:01:18 +0000 (16:01 +0900)
committerWootak Jung <wootak.jung@samsung.com>
Mon, 29 Feb 2016 07:01:18 +0000 (16:01 +0900)
Change-Id: I00570e5dfe344aff392272d9897740e2e551763d

include/telephony_network.h

index 7e86a2c61444b72f8ecd9e02fa0db44816cdce4b..577c3303cf8d995c4646b950b5b2561ab6d0ca13 100644 (file)
@@ -237,7 +237,7 @@ int telephony_network_get_roaming_status(telephony_h handle, bool *status);
  * @privilege %http://tizen.org/privilege/telephony
  *
  * @remarks This API can be used in GSM / WCDMA / LTE network.
- *          You must release @c mcc using free() on success case.
+ *          You must release @c mcc using free() on success case, empty string if unknown.
  *
  * @param[in] handle The handle from telephony_init()
  * @param[out] mcc The Mobile Country Code (three digits)
@@ -262,7 +262,7 @@ int telephony_network_get_mcc(telephony_h handle, char **mcc);
  * @privilege %http://tizen.org/privilege/telephony
  *
  * @remarks This API can be used in GSM / WCDMA / LTE network.
- *          You must release @c mnc using free() on success case.
+ *          You must release @c mnc using free() on success case, empty string if unknown.
  *
  * @param[in] handle The handle from telephony_init()
  * @param[out] mnc The Mobile Network Code (three digits)
@@ -286,10 +286,11 @@ int telephony_network_get_mnc(telephony_h handle, char **mnc);
  * @privlevel public
  * @privilege %http://tizen.org/privilege/telephony
  *
- * @remarks You must release @c network_name using free() on success case.
+ * @remarks This API can be used in GSM / WCDMA / LTE network.
+ *          You must release @c network_name using free() on success case.
  *
  * @param[in] handle The handle from telephony_init()
- * @param[out] network_name The name of the current registered network
+ * @param[out] network_name The name of the current registered network, empty string if unknown.
  *
  * @return @c 0 on success,
  *         otherwise a negative error value