[3.0][geofence-manager][Modify] Modify APIs to remove privilege in some APIs 14/62014/5
authorjomui <jongmun.woo@samsung.com>
Mon, 14 Mar 2016 01:14:38 +0000 (10:14 +0900)
committerjongmun.woo <jongmun.woo@samsung.com>
Wed, 23 Mar 2016 07:20:05 +0000 (16:20 +0900)
Signed-off-by: jomui <jongmun.woo@samsung.com>
Change-Id: I2b2c3a2c86c422ef401f4af0b8695cd156a29570

include/geofence_manager.h

index c8b40291eb136cbf9a413d21323f60bb1a0a9443..edbdbce10234c10a232f4b164ff224e5f70126af 100644 (file)
@@ -120,9 +120,8 @@ int geofence_manager_is_supported(bool *supported);
 /**
  * @brief Creates a new geofence manager.
  * @since_tizen 2.4
- * @privlevel public
- * @privilege %http://tizen.org/privilege/location
- * @remarks The manager must be released using geofence_manager_destroy().
+ * @remarks The manager must be released using geofence_manager_destroy().\n
+ *          Since 3.0, http://tizen.org/privilege/location privilege is not required.
  * @param[out] manager  A geofence manager handle to be newly created on success
  * @return 0 on success, otherwise a negative error value
  * @retval #GEOFENCE_MANAGER_ERROR_NONE Successful
@@ -139,8 +138,7 @@ int geofence_manager_create(geofence_manager_h *manager);
 /**
  * @brief Releases the geofence manager.
  * @since_tizen 2.4
- * @privlevel public
- * @privilege %http://tizen.org/privilege/location
+ * @remarks Since 3.0, http://tizen.org/privilege/location privilege is not required.
  * @param[in] manager The geofence manager handle
  * @return 0 on success, otherwise a negative error value
  * @retval #GEOFENCE_MANAGER_ERROR_NONE Successful
@@ -487,9 +485,8 @@ int geofence_manager_get_place_name(geofence_manager_h manager, int place_id, ch
 /**
  * @brief Creates a geopoint type of new geofence.
  * @since_tizen 2.4
- * @privlevel public
- * @privilege %http://tizen.org/privilege/location
- * @remarks    The fence must be released using geofence_destroy().
+ * @remarks    The fence must be released using geofence_destroy().\n
+ *              Since 3.0, http://tizen.org/privilege/location privilege is not required.
  * @param[in] place_id The current place id
  * @param[in] latitude Specifies the value of latitude of geofence [-90.0 ~ 90.0] (degrees)
  * @param[in] longitude Specifies the value of longitude of geofence [-180.0 ~ 180.0] (degrees)
@@ -500,6 +497,7 @@ int geofence_manager_get_place_name(geofence_manager_h manager, int place_id, ch
  * @retval #GEOFENCE_MANAGER_ERROR_NONE Successful
  * @retval #GEOFENCE_MANAGER_ERROR_INVALID_PARAMETER Illegal argument
  * @retval #GEOFENCE_MANAGER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #GEOFENCE_MANAGER_ERROR_PERMISSION_DENIED The application does not have the privilege to call this function
  * @retval #GEOFENCE_MANAGER_ERROR_EXCEPTION Exception occurred
  * @retval #GEOFENCE_MANAGER_ERROR_PLACE_ACCESS_DENIED Access to specified place is denied
  * @see geofence_create_bluetooth()
@@ -511,9 +509,8 @@ int geofence_create_geopoint(int place_id, double latitude, double longitude, in
 /**
  * @brief Creates a bluetooth type of new geofence.
  * @since_tizen 2.4
- * @privlevel public
- * @privilege %http://tizen.org/privilege/location
- * @remarks    The fence must be released using geofence_destroy().
+ * @remarks    The fence must be released using geofence_destroy().\n
+ *              Since 3.0, http://tizen.org/privilege/location privilege is not required.
  * @param[in] place_id The current place id
  * @param[in] bssid Specifies the value of BSSID of BT MAC address
  * @param[in] ssid Specifies the value of SSID of BT Device
@@ -522,6 +519,7 @@ int geofence_create_geopoint(int place_id, double latitude, double longitude, in
  * @retval #GEOFENCE_MANAGER_ERROR_NONE Successful
  * @retval #GEOFENCE_MANAGER_ERROR_INVALID_PARAMETER Illegal argument
  * @retval #GEOFENCE_MANAGER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #GEOFENCE_MANAGER_ERROR_PERMISSION_DENIED The application does not have the privilege to call this function
  * @retval #GEOFENCE_MANAGER_ERROR_EXCEPTION Exception occurred
  * @retval #GEOFENCE_MANAGER_ERROR_PLACE_ACCESS_DENIED Access to specified place is denied
  * @see geofence_create_geopoint()
@@ -533,9 +531,8 @@ int geofence_create_bluetooth(int place_id, const char *bssid, const char *ssid,
 /**
  * @brief Creates a Wi-Fi type of new geofence.
  * @since_tizen 2.4
- * @privlevel public
- * @privilege %http://tizen.org/privilege/location
- * @remarks    The fence must be released using geofence_destroy().
+ * @remarks    The fence must be released using geofence_destroy().\n
+                Since 3.0, http://tizen.org/privilege/location privilege is not required.
  * @param[in] place_id The current place id
  * @param[in] bssid Specifies the value of BSSID of Wi-Fi MAC address
  * @param[in] ssid Specifies the value of SSID of Wi-Fi Device
@@ -544,6 +541,7 @@ int geofence_create_bluetooth(int place_id, const char *bssid, const char *ssid,
  * @retval #GEOFENCE_MANAGER_ERROR_NONE Successful
  * @retval #GEOFENCE_MANAGER_ERROR_INVALID_PARAMETER Illegal argument
  * @retval #GEOFENCE_MANAGER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #GEOFENCE_MANAGER_ERROR_PERMISSION_DENIED The application does not have the privilege to call this function
  * @retval #GEOFENCE_MANAGER_ERROR_EXCEPTION Exception occurred
  * @retval #GEOFENCE_MANAGER_ERROR_PLACE_ACCESS_DENIED Access to specified place is denied
  * @see geofence_create_geopoint()
@@ -555,13 +553,13 @@ int geofence_create_wifi(int place_id, const char *bssid, const char *ssid, geof
 /**
  * @brief Releases the geofence.
  * @since_tizen 2.4
- * @privlevel public
- * @privilege %http://tizen.org/privilege/location
+ * @remarks   Since 3.0, http://tizen.org/privilege/location privilege is not required.
  * @param[in] fence The geofence handle
  * @return 0 on success, otherwise a negative error value
  * @retval #GEOFENCE_MANAGER_ERROR_NONE Successful
  * @retval #GEOFENCE_MANAGER_ERROR_INVALID_PARAMETER Illegal argument
  * @retval #GEOFENCE_MANAGER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #GEOFENCE_MANAGER_ERROR_PERMISSION_DENIED The application does not have the privilege to call this function
  * @see geofence_create_geopoint()
  * @see geofence_create_bluetooth()
  * @see geofence_create_wifi()