Complemented api documentations

Change-Id: Iad26a7de072dbd1212df50c99ce72b850a7c1646

diff --git a/include/telephony_network.h b/include/telephony_network.h
index af9ed3bb4934c293d78f638e948b391e84fbc418..e50cd9eac01ac4edd86e2212e0b3eba8ad8d808a 100644 (file)
--- a/include/telephony_network.h
+++ b/include/telephony_network.h
@@ -140,6 +140,9 @@ typedef enum {
  * @privlevel public
  * @privilege %http://tizen.org/privilege/telephony
  *
+ * @remarks This API returns #TELEPHONY_ERROR_NONE with unknown value (@c lac)
+ *          if precondition is not be satisfied.
+ *
  * @param[in] handle The handle from telephony_init()
  * @param[out] lac The Location Area Code, -1 if unknown
  *
@@ -165,6 +168,9 @@ int telephony_network_get_lac(telephony_h handle, int *lac);
  * @privlevel public
  * @privilege %http://tizen.org/privilege/telephony
  *
+ * @remarks This API returns #TELEPHONY_ERROR_NONE with unknown value (@c cell_id)
+ *          if precondition is not be satisfied.
+ *
  * @param[in] handle The handle from telephony_init()
  * @param[out] cell_id The cell identification number, -1 if unknown
  *
@@ -494,6 +500,9 @@ int telephony_network_get_selection_mode(telephony_h handle,
  * @privlevel public
  * @privilege %http://tizen.org/privilege/telephony
  *
+ * @remarks This API returns #TELEPHONY_ERROR_NONE with unknown value (@c tac)
+ *          if precondition is not be satisfied.
+ *
  * @param[in] handle The handle from telephony_init()
  * @param[out] tac The Tracking Area Code, -1 if unknown
  *
@@ -521,6 +530,9 @@ int telephony_network_get_tac(telephony_h handle, int *tac);
  * @privlevel public
  * @privilege %http://tizen.org/privilege/telephony
  *
+ * @remarks This API returns #TELEPHONY_ERROR_NONE with unknown value (@c sid)
+ *          if precondition is not be satisfied.
+ *
  * @param[in] handle The handle from telephony_init()
  * @param[out] sid The system ID, -1 if unknown
  *
@@ -548,6 +560,9 @@ int telephony_network_get_system_id(telephony_h handle, int *sid);
  * @privlevel public
  * @privilege %http://tizen.org/privilege/telephony
  *
+ * @remarks This API returns #TELEPHONY_ERROR_NONE with unknown value (@c nid)
+ *          if precondition is not be satisfied.
+ *
  * @param[in] handle The handle from telephony_init()
  * @param[out] nid The network ID, -1 if unknown
  *
@@ -575,6 +590,9 @@ int telephony_network_get_network_id(telephony_h handle, int *nid);
  * @privlevel public
  * @privilege %http://tizen.org/privilege/telephony
  *
+ * @remarks This API returns #TELEPHONY_ERROR_NONE with unknown value (@c bs_id)
+ *          if precondition is not be satisfied.
+ *
  * @param[in] handle The handle from telephony_init()
  * @param[out] bs_id The base station ID, -1 if unknown
  *
@@ -602,6 +620,9 @@ int telephony_network_get_base_station_id(telephony_h handle, int *bs_id);
  * @privlevel public
  * @privilege %http://tizen.org/privilege/telephony
  *
+ * @remarks This API returns #TELEPHONY_ERROR_NONE with unknown value (@c bs_latitude)
+ *          if precondition is not be satisfied.
+ *
  * @param[in] handle The handle from telephony_init()
  * @param[out] bs_latitude The base station latitude, 0x7FFFFFFF if unknown
  *
@@ -629,6 +650,9 @@ int telephony_network_get_base_station_latitude(telephony_h handle, int *bs_lati
  * @privlevel public
  * @privilege %http://tizen.org/privilege/telephony
  *
+ * @remarks This API returns #TELEPHONY_ERROR_NONE with unknown value (@c bs_longitude)
+ *          if precondition is not be satisfied.
+ *
  * @param[in] handle The handle from telephony_init()
  * @param[out] bs_longitude The base station longitude, 0x7FFFFFFF if unknown
  *