Review geofence API cs files

[platform/core/csapi/geofence.git] / Tizen.Location.Geofence / Tizen.Location.Geofence / Fence.cs

diff --git a/Tizen.Location.Geofence/Tizen.Location.Geofence/Fence.cs b/Tizen.Location.Geofence/Tizen.Location.Geofence/Fence.cs
index d17ee7f..7dbe95b 100755 (executable)
--- a/Tizen.Location.Geofence/Tizen.Location.Geofence/Fence.cs
+++ b/Tizen.Location.Geofence/Tizen.Location.Geofence/Fence.cs
@@ -19,17 +19,18 @@ using System;
 namespace Tizen.Location.Geofence
 {
     /// <summary>
-    /// Geo-fence defines a virtual perimeter for a real-world geographic area.
-    /// If you create a geofence, you can trigger some activities when a device enters(or exits) the geofences defined by you.
-    /// You can create a geofence with the information of Geopoint, Wi-Fi, or BT.
+    /// Geofence defines a virtual perimeter for a real-world geographic area.
+    /// If you create a geofence, you can trigger some activities when a device enters (or exits) the geofences defined by you.
+    /// You can create a geofence with the information of the Geopoint, Wi-Fi, or BT.
     /// <list>
-    /// <item>Geopoint: Geofence is specified by coordinates (Latitude and Longitude) and Radius</item>
-    /// <item>WIFI: Geofence is specified by BSSID of Wi-Fi access point</item>
-    /// <item>BT: Geofence is specified by Bluetooth address</item>
+    /// <item>Geopoint: Geofence is specified by the coordinates (Latitude and Longitude) and radius.</item>
+    /// <item>WIFI: Geofence is specified by the BSSID of the Wi-Fi access point.</item>
+    /// <item>BT: Geofence is specified by the Bluetooth address.</item>
     /// </list>
-    /// Basic service set identification(BSSID) The BSSID is the MAC address of the wireless access point(WAP) generated by combining the 24 bit Organization Unique Identifier(the manufacturer's identity)
+    /// The Basic service set identifier (BSSID) is the MAC address of the wireless access point (WAP) generated by combining the 24-bit Organization Unique Identifier (the manufacturer's identity)
     /// and the manufacturer's assigned 24-bit identifier for the radio chipset in the WAP.
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class Fence : IDisposable
     {
         private bool _disposed = false;
@@ -53,6 +54,7 @@ namespace Tizen.Location.Geofence
         /// <summary>
         /// Gets the type of geofence.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public FenceType Type
         {
             get
@@ -69,8 +71,9 @@ namespace Tizen.Location.Geofence
         }
 
         /// <summary>
-        /// Gets the id of place.
+        /// Gets the ID of the place.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public int PlaceId
         {
             get
@@ -89,6 +92,7 @@ namespace Tizen.Location.Geofence
         /// <summary>
         /// Gets the longitude of geofence.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public double Longitude
         {
             get
@@ -108,6 +112,7 @@ namespace Tizen.Location.Geofence
         /// <summary>
         /// Gets the latitude of geofence.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public double Latitude
         {
             get
@@ -126,6 +131,7 @@ namespace Tizen.Location.Geofence
         /// <summary>
         /// Gets the radius of geofence.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public int Radius
         {
             get
@@ -144,6 +150,7 @@ namespace Tizen.Location.Geofence
         /// <summary>
         /// Gets the address of geofence.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string Address
         {
             get
@@ -160,8 +167,9 @@ namespace Tizen.Location.Geofence
         }
 
         /// <summary>
-        /// Gets the bssid of geofence.
+        /// Gets the BSSID of geofence.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string Bssid
         {
             get
@@ -178,8 +186,9 @@ namespace Tizen.Location.Geofence
         }
 
         /// <summary>
-        /// Gets the ssid of geofence.
+        /// Gets the SSID of geofence.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string Ssid
         {
             get
@@ -196,17 +205,18 @@ namespace Tizen.Location.Geofence
         }
 
         /// <summary>
-        /// Creates a geopoint type of new geofence.
+        /// Creates a geopoint type of the new geofence.
         /// </summary>
-        /// <param name="placeId">The current place id.</param>
-        /// <param name="latitude">Specifies the value of latitude of geofence [-90.0 ~ 90.0] (degrees).</param>
-        /// <param name="longitude">Specifies the value of longitude of geofence [-180.0 ~ 180.0] (degrees).</param>
-        /// <param name="radius">Specifies the value of radius of geofence [100 ~ 500](meter).</param>
-        /// <param name="adsress">Specifies the value of address.</param>
-        /// <returns>Newly created geofence instance.</returns>
-        /// <exception cref="ArgumentException">Incase of Invalid parameter.</exception>
-        /// <exception cref="InvalidOperationException">Incase of any System error.</exception>
-        /// <exception cref="NotSupportedException">Incase of Geofence is not supported.</exception>
+        /// <since_tizen> 3 </since_tizen>
+        /// <param name="placeId">The current place ID.</param>
+        /// <param name="latitude">Specifies the value of latitude of the geofence [-90.0 ~ 90.0] (degrees).</param>
+        /// <param name="longitude">Specifies the value of longitude of the geofence [-180.0 ~ 180.0] (degrees).</param>
+        /// <param name="radius">Specifies the value of radius of the geofence [100 ~ 500](meter).</param>
+        /// <param name="address">Specifies the value of the address.</param>
+        /// <returns>The newly created geofence instance.</returns>
+        /// <exception cref="ArgumentException">In case of an invalid parameter.</exception>
+        /// <exception cref="InvalidOperationException">In case of any system error.</exception>
+        /// <exception cref="NotSupportedException">In case the geofence is not supported.</exception>
         public static Fence CreateGPSFence(int placeId, int latitude, int longitude, int radius, string address)
         {
             IntPtr handle = IntPtr.Zero;
@@ -220,15 +230,16 @@ namespace Tizen.Location.Geofence
         }
 
         /// <summary>
-        /// Creates a Wi-Fi type of new geofence.
+        /// Creates a Wi-Fi type of the new geofence.
         /// </summary>
-        /// <param name="placeId">The current place id.</param>
-        /// <param name="bssid">Specifies the value of BSSID of Wi-Fi MAC address.</param>
-        /// <param name="ssid"> Specifies the value of SSID of Wi-Fi Device.</param>
-        /// <returns>Newly created geofence instance.</returns>
-        /// <exception cref="ArgumentException">Incase of Invalid parameter.</exception>
-        /// <exception cref="InvalidOperationException">Incase of any System error.</exception>
-        /// <exception cref="NotSupportedException">Incase of Geofence is not supported.</exception>
+        /// <since_tizen> 3 </since_tizen>
+        /// <param name="placeId">The current place ID.</param>
+        /// <param name="bssid">Specifies the value of BSSID of the Wi-Fi MAC address.</param>
+        /// <param name="ssid"> Specifies the value of SSID of the Wi-Fi device.</param>
+        /// <returns>The newly created geofence instance.</returns>
+        /// <exception cref="ArgumentException">In case of an invalid parameter.</exception>
+        /// <exception cref="InvalidOperationException">In case of any system error.</exception>
+        /// <exception cref="NotSupportedException">In case the geofence is not supported.</exception>
         public static Fence CreateWifiFence(int placeId, string bssid, string ssid)
         {
             IntPtr handle = IntPtr.Zero;
@@ -242,15 +253,16 @@ namespace Tizen.Location.Geofence
         }
 
         /// <summary>
-        /// Creates a bluetooth type of new geofence.
+        /// Creates a Bluetooth type of the new geofence.
         /// </summary>
-        /// <param name="placeId">The current place id.</param>
+        /// <since_tizen> 3 </since_tizen>
+        /// <param name="placeId">The current place ID.</param>
         /// <param name="bssid">Specifies the value of BSSID of BT MAC address.</param>
         /// <param name="ssid"> Specifies the value of SSID of BT Device.</param>
-        /// <returns>Newly created geofence instance.</returns>
-        /// <exception cref="ArgumentException">Incase of Invalid parameter.</exception>
-        /// <exception cref="InvalidOperationException">Incase of any System error.</exception>
-        /// <exception cref="NotSupportedException">Incase of Geofence is not supported.</exception>
+        /// <returns>The newly created geofence instance.</returns>
+        /// <exception cref="ArgumentException">In case of an invalid parameter.</exception>
+        /// <exception cref="InvalidOperationException">In case of any system error.</exception>
+        /// <exception cref="NotSupportedException">In case the geofence is not supported.</exception>
         public static Fence CreateBTFence(int placeId, string bssid, string ssid)
         {
             IntPtr handle = IntPtr.Zero;
@@ -264,8 +276,9 @@ namespace Tizen.Location.Geofence
         }
 
         /// <summary>
-        /// Overloaded Dispose API for destroying the fence Handle.
+        /// The overloaded Dispose API for destroying the fence handle.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public void Dispose()
         {
             Dispose(true);