From: Wootak Jung <wootak.jung@samsung.com>
Date: Mon, 29 Feb 2016 07:01:18 +0000 (+0900)
Subject: Updated some documents for network APIs
X-Git-Tag: submit/tizen/20160303.013045~1
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=b6b2e9d122f202c261bd19da31f18daebc6f0d7c;p=platform%2Fcore%2Fapi%2Ftelephony.git

Updated some documents for network APIs

Change-Id: I00570e5dfe344aff392272d9897740e2e551763d
---

diff --git a/include/telephony_network.h b/include/telephony_network.h
index 7e86a2c..577c330 100644
--- a/include/telephony_network.h
+++ b/include/telephony_network.h
@@ -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