Review Network.Nsd API cs files 92/164892/2
author“Editor <TizenEditor.SEL@lionbridge.com>
Thu, 21 Dec 2017 11:47:34 +0000 (17:17 +0530)
committercheoleun moon <chleun.moon@samsung.com>
Thu, 28 Dec 2017 00:41:27 +0000 (00:41 +0000)
Change-Id: I0adc17d074a939db114d1734e7605f53b9001799

src/Tizen.Network.Nsd/Interop/Interop.Nsd.cs
src/Tizen.Network.Nsd/Tizen.Network.Nsd/DnssdBrowser.cs
src/Tizen.Network.Nsd/Tizen.Network.Nsd/DnssdService.cs
src/Tizen.Network.Nsd/Tizen.Network.Nsd/INsdBrowser.cs
src/Tizen.Network.Nsd/Tizen.Network.Nsd/INsdService.cs
src/Tizen.Network.Nsd/Tizen.Network.Nsd/NsdEnumerations.cs
src/Tizen.Network.Nsd/Tizen.Network.Nsd/NsdEventArgs.cs
src/Tizen.Network.Nsd/Tizen.Network.Nsd/SsdpBrowser.cs
src/Tizen.Network.Nsd/Tizen.Network.Nsd/SsdpService.cs

index 5979c1d..4c78c27 100755 (executable)
@@ -19,12 +19,12 @@ using System.Runtime.InteropServices;
 using Tizen.Network.Nsd;
 
 /// <summary>
-/// Interop class for Nsd
+/// Interop class for NSD.
 /// </summary>
 internal static partial class Interop
 {
     /// <summary>
-    /// Nsd Native Apis
+    /// NSD native APIs.
     /// </summary>
     internal static partial class Nsd
     {
index f4e6b1a..2cb74df 100755 (executable)
@@ -19,7 +19,7 @@ using System;
 namespace Tizen.Network.Nsd
 {
     /// <summary>
-    /// This class is used for managing network service discovery using DNSSD.
+    /// This class is used for managing the network service discovery using DNS-SD.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class DnssdBrowser : INsdBrowser
@@ -30,7 +30,7 @@ namespace Tizen.Network.Nsd
         private Interop.Nsd.Dnssd.ServiceFoundCallback _serviceFoundCallback;
 
         /// <summary>
-        /// This event is raised when a DNSSD service is found during service discovery.
+        /// This event is raised when a DNS-SD service is found during the service discovery.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public event EventHandler<DnssdServiceFoundEventArgs> ServiceFound
@@ -47,13 +47,13 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// A public constructor for DnssdBrowser class to create a DnssdBrowser instance for the given service type.
+        /// A public constructor for the DnssdBrowser class to create a DnssdBrowser instance for the given service type.
         /// </summary>
-        /// <param name="serviceType">The DNSSD service type</param>
+        /// <param name="serviceType">The DNS-SD service type.</param>
         /// <since_tizen> 4 </since_tizen>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
-        /// <exception cref="ArgumentException">Thrown when serviceType is null.</exception>
-        /// <exception cref="NotSupportedException">Thrown when DNSSD is not supported.</exception>
+        /// <exception cref="ArgumentException">Thrown when the serviceType is null.</exception>
+        /// <exception cref="NotSupportedException">Thrown when DNS-SD is not supported.</exception>
         public DnssdBrowser(string serviceType)
         {
             DnssdInitializer dnssdInit = Globals.s_threadDns.Value;
@@ -68,18 +68,18 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// Starts browsing the DNSSD remote service.
+        /// Starts browsing the DNS-SD remote service.
         /// </summary>
         /// <remarks>
-        /// If there are any services available, ServiceFound event will be invoked.
-        /// Application will keep browsing for available/unavailable services until it calls StopDiscovery().
+        /// If there are any services available, the ServiceFound event will be invoked.
+        /// The application will keep browsing for the available or unavailable services until it calls StopDiscovery().
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         /// <privilege>http://tizen.org/privilege/internet</privilege>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
         /// <exception cref="InvalidOperationException">Thrown when any other error occurred.</exception>
-        /// <exception cref="NotSupportedException">Thrown when DNSSD is not supported.</exception>
-        /// <exception cref="UnauthorizedAccessException">Thrown when permission is denied.</exception>
+        /// <exception cref="NotSupportedException">Thrown when DNS-SD is not supported.</exception>
+        /// <exception cref="UnauthorizedAccessException">Thrown when the permission is denied.</exception>
         public void StartDiscovery()
         {
             DnssdInitializer dnssdInit = Globals.s_threadDns.Value;
@@ -104,12 +104,12 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// Stops browsing the DNSSD remote service.
+        /// Stops browsing the DNS-SD remote service.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
         /// <exception cref="InvalidOperationException">Thrown when any other error occurred.</exception>
-        /// <exception cref="NotSupportedException">Thrown when DNSSD is not supported.</exception>
+        /// <exception cref="NotSupportedException">Thrown when DNS-SD is not supported.</exception>
         public void StopDiscovery()
         {
             int ret = Interop.Nsd.Dnssd.StopBrowsing(_browserHandle);
index 3f3536c..1209f28 100755 (executable)
@@ -38,7 +38,7 @@ namespace Tizen.Network.Nsd
         }
     }
     /// <summary>
-    /// This class is used for managing local service registration and its properties using DNSSD.
+    /// This class is used for managing the local service registration and its properties using DNS-SD.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class DnssdService : INsdService
@@ -49,15 +49,15 @@ namespace Tizen.Network.Nsd
         private Interop.Nsd.Dnssd.ServiceRegisteredCallback _serviceRegisteredCallback;
 
         /// <summary>
-        /// Constructor to create DnssdService instance that sets the serviceType to a given value.
+        /// The constructor to create the DnssdService instance that sets the serviceType to a given value.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
-        /// <param name="serviceType">The DNSSD service type. It is expressed as type followed by protocol, separated by a dot(e.g. "_ftp._tcp").
-        /// It must begin with an underscore, followed by 1-15 characters which may be letters, digits or hyphens.
+        /// <param name="serviceType">The DNS-SD service type. It is expressed as a type followed by the protocol, separated by a dot (For example, "_ftp._tcp").
+        /// It must begin with an underscore followed by 1-15 characters, which may be letters, digits, or hyphens.
         /// </param>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
-        /// <exception cref="NotSupportedException">Thrown while setting this property when DNSSD is not supported.</exception>
-        /// <exception cref="ArgumentException">Thrown when serviceType is set to null.</exception>
+        /// <exception cref="NotSupportedException">Thrown while setting this property when DNS-SD is not supported.</exception>
+        /// <exception cref="ArgumentException">Thrown when the serviceType is set to null.</exception>
         public DnssdService(string serviceType)
         {
             _serviceType = serviceType;
@@ -82,17 +82,17 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// Name of DNSSD service.
+        /// Name of the DNS-SD service.
         /// </summary>
         /// <remarks>
-        /// Set Name for only unregistered service created locally.
+        /// Set the name for only an unregistered service created locally.
         /// It may be up to 63 bytes.
-        /// In case of error, null will be returned during get and exception will be thrown during set.
+        /// In case of an error, null will be returned during get and exception will be thrown during set.
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
-        /// <exception cref="NotSupportedException">Thrown while setting this property when DNSSD is not supported.</exception>
-        /// <exception cref="ArgumentException">Thrown when Name value is set to null.</exception>
+        /// <exception cref="NotSupportedException">Thrown while setting this property when DNS-SD is not supported.</exception>
+        /// <exception cref="ArgumentException">Thrown when the name value is set to null.</exception>
         /// <exception cref="InvalidOperationException">Thrown while setting this property when any other error occurred.</exception>
         public string Name
         {
@@ -126,12 +126,12 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// Type of DNSSD local/remote service.
+        /// Type of the DNS-SD local or remote service.
         /// </summary>
         /// <remarks>
-        /// It is expressed as type followed by protocol, separated by a dot(e.g. "_ftp._tcp").
-        /// It must begin with an underscore, followed by 1-15 characters which may be letters, digits or hyphens.
-        /// In case of error, null will be returned.
+        /// It is expressed as a type followed by the protocol, separated by a dot (For example, "_ftp._tcp").
+        /// It must begin with an underscore followed by 1-15 characters, which may be letters, digits, or hyphens.
+        /// In case of an error, null will be returned.
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         public string Type
@@ -151,16 +151,16 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// Port number of DNSSD local/remote service.
+        /// Port number of the DNS-SD local or remote service.
         /// </summary>
         /// <remarks>
-        /// Set Port for only unregistered service created locally. The default value of Port is 0.
-        /// In case of error, -1 will be returned during get and exception will be thrown during set.
+        /// Set the port for only an unregistered service created locally. The default value of the port is 0.
+        /// In case of an error, -1 will be returned during get and exception will be thrown during set.
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
-        /// <exception cref="NotSupportedException">Thrown while setting this property when DNSSD is not supported.</exception>
-        /// <exception cref="ArgumentException">Thrown if value of Port is set to less than 0 or more than 65535.</exception>
+        /// <exception cref="NotSupportedException">Thrown while setting this property when DNS-SD is not supported.</exception>
+        /// <exception cref="ArgumentException">Thrown if the value of port is set to less than 0 or more than 65535.</exception>
         /// <exception cref="InvalidOperationException">Thrown while setting this property when any other error occurred.</exception>
         public int Port
         {
@@ -194,11 +194,11 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// IP address of DNSSD remote service.
+        /// IP address of the DNS-SD remote service.
         /// </summary>
         /// <remarks>
         /// If the remote service has no IPv4 Address, then IPv4Address would contain null and if it has no IPv6 Address, then IPv6Address would contain null.
-        /// In case of error, null object will be returned.
+        /// In case of an error, null object will be returned.
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         public IPAddressInformation IP
@@ -232,14 +232,14 @@ namespace Tizen.Network.Nsd
         /// Adds the TXT record.
         /// </summary>
         /// <remarks>
-        /// TXT record should be added after registering local service using RegisterService().
+        /// TXT record should be added after registering the local service using RegisterService().
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="key">The key of the TXT record. It must be a null-terminated string with 9 characters or fewer excluding null. It is case insensitive.</param>
-        /// <param name="value">The value of the TXT record.If null, then "key" will be added with no value. If non-null but value_length is zero, then "key=" will be added with empty value.</param>
+        /// <param name="value">The value of the TXT record. If null, then "key" will be added with no value. If non-null but the value_length is zero, then "key=" will be added with an empty value.</param>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
-        /// <exception cref="NotSupportedException">Thrown when DNSSD is not supported.</exception>
-        /// <exception cref="ArgumentException">Thrown when value of key is null.</exception>
+        /// <exception cref="NotSupportedException">Thrown when DNS-SD is not supported.</exception>
+        /// <exception cref="ArgumentException">Thrown when the value of the key is null.</exception>
         /// <exception cref="InvalidOperationException">Thrown when any other error occurred.</exception>
         public void AddTXTRecord(string key, string value)
         {
@@ -270,8 +270,8 @@ namespace Tizen.Network.Nsd
         /// <since_tizen> 4 </since_tizen>
         /// <param name="key">The key of the TXT record to be removed.</param>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
-        /// <exception cref="NotSupportedException">Thrown when DNSSD is not supported.</exception>
-        /// <exception cref="ArgumentException">Thrown when value of key is null.</exception>
+        /// <exception cref="NotSupportedException">Thrown when DNS-SD is not supported.</exception>
+        /// <exception cref="ArgumentException">Thrown when the value of the key is null.</exception>
         /// <exception cref="InvalidOperationException">Thrown when any other error occurred.</exception>
         public void RemoveTXTRecord(string key)
         {
@@ -297,15 +297,15 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// Registers the DNSSD local service for publishing.
+        /// Registers the DNS-SD local service for publishing.
         /// </summary>
         /// Name of the service must be set.
         /// <since_tizen> 4 </since_tizen>
         /// <privilege>http://tizen.org/privilege/internet</privilege>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
         /// <exception cref="InvalidOperationException">Thrown when any other error occurred.</exception>
-        /// <exception cref="NotSupportedException">Thrown when DNSSD is not supported.</exception>
-        /// <exception cref="UnauthorizedAccessException">Thrown when permission is denied.</exception>
+        /// <exception cref="NotSupportedException">Thrown when DNS-SD is not supported.</exception>
+        /// <exception cref="UnauthorizedAccessException">Thrown when the permission is denied.</exception>
         public void RegisterService()
         {
             if (!Globals.s_threadDns.IsValueCreated)
@@ -331,7 +331,7 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// Deregisters the DNSSD local service.
+        /// Deregisters the DNS-SD local service.
         /// </summary>
         /// <remarks>
         /// A local service registered using RegisterService() must be passed.
@@ -339,7 +339,7 @@ namespace Tizen.Network.Nsd
         /// <since_tizen> 4 </since_tizen>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
         /// <exception cref="InvalidOperationException">Thrown when any other error occurred.</exception>
-        /// <exception cref="NotSupportedException">Thrown when DNSSD is not supported.</exception>
+        /// <exception cref="NotSupportedException">Thrown when DNS-SD is not supported.</exception>
         public void DeregisterService()
         {
             int ret = Interop.Nsd.Dnssd.DeregisterService(_serviceHandle);
@@ -374,7 +374,7 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// Destroy the DnssdService object
+        /// Destroys the DnssdService object.
         /// </summary>
          ~DnssdService()
         {
@@ -394,7 +394,7 @@ namespace Tizen.Network.Nsd
     }
 
     /// <summary>
-    /// This class manages the IP address properties of DNSSD service.
+    /// This class manages the IP address properties of the DNS-SD service.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class IPAddressInformation
@@ -411,7 +411,7 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// The IP version 4 address of DNSSD service.
+        /// The IP version 4 address of the DNS-SD service.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public IPAddress IPv4Address
@@ -425,7 +425,7 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// The IP version 6 address of DNSSD service.
+        /// The IP version 6 address of the DNS-SD service.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public IPAddress IPv6Address
index e09a20a..189a13c 100755 (executable)
@@ -19,35 +19,35 @@ using System;
 namespace Tizen.Network.Nsd
 {
     /// <summary>
-    /// This interface is used for managing network service discovery using DNSSD/SSDP.
+    /// This interface is used for managing the network service discovery using DNS-SD/SSDP.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public interface INsdBrowser
     {
         /// <summary>
-        /// Starts browsing the DNSSD/SSDP remote service.
+        /// Starts browsing the DNS-SD/SSDP remote service.
         /// </summary>
         /// <remarks>
-        /// If there are any services available, ServiceFound event will be invoked.
-        /// Application will keep browsing for available/unavailable services until it calls StopDiscovery().
+        /// If there are any services available, the ServiceFound event will be invoked.
+        /// The application will keep browsing for the available or unavailable services until it calls StopDiscovery().
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         /// <privilege>http://tizen.org/privilege/internet</privilege>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
         /// <feature>http://tizen.org/feature/network.service_discovery.ssdp</feature>
         /// <exception cref="InvalidOperationException">Thrown when any other error occured.</exception>
-        /// <exception cref="NotSupportedException">Thrown when DNSSD/SSDP is not supported.</exception>
-        /// <exception cref="UnauthorizedAccessException">Thrown when permission is denied.</exception>
+        /// <exception cref="NotSupportedException">Thrown when DNS-SD/SSDP is not supported.</exception>
+        /// <exception cref="UnauthorizedAccessException">Thrown when the permission is denied.</exception>
         void StartDiscovery();
 
         /// <summary>
-        /// Stops browsing the DNSSD/SSDP remote service.
+        /// Stops browsing the DNS-SD/SSDP remote service.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
         /// <feature>http://tizen.org/feature/network.service_discovery.ssdp</feature>
         /// <exception cref="InvalidOperationException">Thrown when any other error occured.</exception>
-        /// <exception cref="NotSupportedException">Thrown when DNSSD/SSDP is not supported.</exception>
+        /// <exception cref="NotSupportedException">Thrown when DNS-SD/SSDP is not supported.</exception>
         void StopDiscovery();
     }
 }
index 13c933e..633f310 100755 (executable)
@@ -19,37 +19,37 @@ using System;
 namespace Tizen.Network.Nsd
 {
     /// <summary>
-    /// This interface is used for managing local service registration using DNSSD/SSDP.
+    /// This interface is used for managing the local service registration using DNS-SD/SSDP.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public interface INsdService : IDisposable
     {
         /// <summary>
-        /// Registers the DNSSD/SSDP local service for publishing.
+        /// Registers the DNS-SD/SSDP local service for publishing.
         /// </summary>
         /// <remarks>
-        /// A service created locally must be passed.
+        /// A service that is created locally must be passed.
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         /// <privilege>http://tizen.org/privilege/internet</privilege>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
         /// <feature>http://tizen.org/feature/network.service_discovery.ssdp</feature>
         /// <exception cref="InvalidOperationException">Thrown when any other error occurred.</exception>
-        /// <exception cref="NotSupportedException">Thrown when DNSSD/SSDP is not supported.</exception>
-        /// <exception cref="UnauthorizedAccessException">Thrown when permission is denied.</exception>
+        /// <exception cref="NotSupportedException">Thrown when DNS-SD/SSDP is not supported.</exception>
+        /// <exception cref="UnauthorizedAccessException">Thrown when the permission is denied.</exception>
         void RegisterService();
 
         /// <summary>
-        /// Deregisters the DNSSD/SSDP local service.
+        /// Deregisters the DNS-SD/SSDP local service.
         /// </summary>
         /// <remarks>
-        /// A local service registered using RegisterService() must be passed.
+        /// A local service that is registered using RegisterService() must be passed.
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         /// <feature>http://tizen.org/feature/network.service_discovery.dnssd</feature>
         /// <feature>http://tizen.org/feature/network.service_discovery.ssdp</feature>
         /// <exception cref="InvalidOperationException">Thrown when any other error occurred.</exception>
-        /// <exception cref="NotSupportedException">Thrown when DNSSD/SSDP is not supported.</exception>
+        /// <exception cref="NotSupportedException">Thrown when DNS-SD/SSDP is not supported.</exception>
         void DeregisterService();
     }
 }
index 30f054c..a36990b 100755 (executable)
@@ -19,7 +19,7 @@ using Tizen.Internals.Errors;
 namespace Tizen.Network.Nsd
 {
     /// <summary>
-    /// Enumeration for DNS-SD service state.
+    /// Enumeration for the DNS-SD service states.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public enum DnssdServiceState
@@ -35,24 +35,24 @@ namespace Tizen.Network.Nsd
         /// <since_tizen> 4 </since_tizen>
         Unavailable,
         /// <summary>
-        /// Lookup failure for service name.
+        /// Lookup failure for the service name.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         ServiceNameLookupFailed,
         /// <summary>
-        /// Lookup failure for host name and port number.
+        /// Lookup failure for the host name and port number.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         HostNameLookupFailed,
         /// <summary>
-        /// Lookup failure for IP address.
+        /// Lookup failure for the IP address.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         AddressLookupFailed
     }
 
     /// <summary>
-    /// Enumeration for SSDP service state.
+    /// Enumeration for the SSDP service states.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public enum SsdpServiceState
index b68edc5..9c19188 100755 (executable)
@@ -19,7 +19,7 @@ using System;
 namespace Tizen.Network.Nsd
 {
     /// <summary>
-    /// An extended EventArgs class which contains changed service state during service discovery using DNSSD.
+    /// An extended EventArgs class, which contains the changed service state during a service discovery using DNS-SD.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class DnssdServiceFoundEventArgs : EventArgs
@@ -34,7 +34,7 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// DNSSD service state.
+        /// The DNS-SD service state.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public DnssdServiceState State
@@ -46,7 +46,7 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// DNSSD service instance.
+        /// The DNS-SD service instance.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public DnssdService Service
@@ -59,7 +59,7 @@ namespace Tizen.Network.Nsd
     }
 
     /// <summary>
-    /// An extended EventArgs class which contains changed service state during service discovery using SSDP.
+    /// An extended EventArgs class, which contains the changed service state during a service discovery using SSDP.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class SsdpServiceFoundEventArgs : EventArgs
@@ -74,7 +74,7 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// SSDP service state.
+        /// The SSDP service state.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public SsdpServiceState State
@@ -86,7 +86,7 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// SSDP service instance.
+        /// The SSDP service instance.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public SsdpService Service
index 69bfd78..ba27765 100755 (executable)
@@ -19,7 +19,7 @@ using System;
 namespace Tizen.Network.Nsd
 {
     /// <summary>
-    /// This class is used for managing network service discovery using SSDP.
+    /// This class is used for managing the network service discovery using SSDP.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class SsdpBrowser : INsdBrowser
@@ -30,7 +30,7 @@ namespace Tizen.Network.Nsd
         private Interop.Nsd.Ssdp.ServiceFoundCallback _serviceFoundCallback;
 
         /// <summary>
-        /// This event is raised when service has become available or unavailable during service discovery using SSDP.
+        /// This event is raised when the service has become available or unavailable during a service discovery using SSDP.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public event EventHandler<SsdpServiceFoundEventArgs> ServiceFound
@@ -47,12 +47,12 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// A public constructor for SsdpBrowser class to create a SsdpBrowser instance for the given target.
+        /// A public constructor for the SsdpBrowser class to create a SsdpBrowser instance for the given target.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="target">The target to browse for the service.</param>
         /// <feature>http://tizen.org/feature/network.service_discovery.ssdp</feature>
-        /// <exception cref="ArgumentException">Thrown when target is null.</exception>
+        /// <exception cref="ArgumentException">Thrown when the target is null.</exception>
         /// <exception cref="NotSupportedException">Thrown when SSDP is not supported.</exception>
         public SsdpBrowser(string target)
         {
@@ -71,8 +71,8 @@ namespace Tizen.Network.Nsd
         /// Starts browsing the SSDP remote service.
         /// </summary>
         /// <remarks>
-        /// If there are any services available, ServiceFound event will be invoked.
-        /// Application will keep browsing for available/unavailable services until it calls StopDiscovery().
+        /// If there are any services available, the ServiceFound event will be invoked.
+        /// The application will keep browsing for the available or unavailable services until it calls StopDiscovery().
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         /// <feature>http://tizen.org/feature/network.service_discovery.ssdp</feature>
@@ -109,7 +109,7 @@ namespace Tizen.Network.Nsd
         /// <feature>http://tizen.org/feature/network.service_discovery.ssdp</feature>
         /// <exception cref="InvalidOperationException">Thrown when any other error occured.</exception>
         /// <exception cref="NotSupportedException">Thrown when SSDP is not supported.</exception>
-        /// <exception cref="UnauthorizedAccessException">Thrown when permission is denied.</exception>
+        /// <exception cref="UnauthorizedAccessException">Thrown when the permission is denied.</exception>
         public void StopDiscovery()
         {
             int ret = Interop.Nsd.Ssdp.StopBrowsing(_browserHandle);
index 2667f71..a811531 100755 (executable)
@@ -37,7 +37,7 @@ namespace Tizen.Network.Nsd
     }
 
     /// <summary>
-    /// This class is used for managing local service registration and its properties using SSDP.
+    /// This class is used for managing the local service registration and its properties using SSDP.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class SsdpService : INsdService
@@ -47,13 +47,13 @@ namespace Tizen.Network.Nsd
         private Interop.Nsd.Ssdp.ServiceRegisteredCallback _serviceRegisteredCallback;
 
         /// <summary>
-        /// Constructor to create SsdpService instance that sets the target to a given value.
+        /// The constructor to create the SsdpService instance that sets the target to a given value.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="target">The SSDP local service's target. It may be a device type or a service type.</param>
         /// <feature>http://tizen.org/feature/network.service_discovery.ssdp</feature>
         /// <exception cref="NotSupportedException">Thrown while setting this property when SSDP is not supported.</exception>
-        /// <exception cref="ArgumentException">Thrown when target is set to null.</exception>
+        /// <exception cref="ArgumentException">Thrown when the target is set to null.</exception>
         public SsdpService(string target)
         {
             _target = target;
@@ -78,16 +78,16 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// Unique Service Name of SSDP service.
+        /// Unique Service Name of the SSDP service.
         /// </summary>
         /// <remarks>
-        /// Set Usn for only unregistered service created locally. If service is already registered, Usn will not be set.
-        /// In case of error, null will be returned during get and exception will be thrown during set.
+        /// Set the USN for only an unregistered service created locally. If the service is already registered, the USN will not be set.
+        /// In case of an error, null will be returned during get and exception will be thrown during set.
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         /// <feature>http://tizen.org/feature/network.service_discovery.ssdp</feature>
         /// <exception cref="NotSupportedException">Thrown while setting this property when SSDP is not supported.</exception>
-        /// <exception cref="ArgumentException">Thrown when Usn value is set to null.</exception>
+        /// <exception cref="ArgumentException">Thrown when USN value is set to null.</exception>
         /// <exception cref="InvalidOperationException">Thrown while setting this property when any other error occurred.</exception>
         public string Usn
         {
@@ -121,11 +121,11 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// Target of SSDP service.
+        /// Target of the SSDP service.
         /// </summary>
         /// <remarks>
-        /// It may be a device type or a service type specified in UPnP forum (http://upnp.org).
-        /// In case of error, null will be returned.
+        /// It may be a device type or a service type specified in the UPnP forum (http://upnp.org).
+        /// In case of an error, null will be returned.
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         public string Target
@@ -145,16 +145,16 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// URL of SSDP service.
+        /// URL of the SSDP service.
         /// </summary>
         /// <remarks>
-        /// Set Url for only unregistered service created locally. If service is already registered, Url will not be set.
-        /// In case of error, null will be returned during get and exception will be thrown during set.
+        /// Set the URL for only an unregistered service created locally. If the service is already registered, the URL will not be set.
+        /// In case of an error, null will be returned during get and exception will be thrown during set.
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         /// <feature>http://tizen.org/feature/network.service_discovery.ssdp</feature>
         /// <exception cref="NotSupportedException">Thrown while setting this property when SSDP is not supported.</exception>
-        /// <exception cref="ArgumentException">Thrown when Url value is set to null.</exception>
+        /// <exception cref="ArgumentException">Thrown when the URL value is set to null.</exception>
         /// <exception cref="InvalidOperationException">Thrown while setting this property when any other error occurred.</exception>
         public string Url
         {
@@ -192,14 +192,14 @@ namespace Tizen.Network.Nsd
         /// </summary>
         /// <remarks>
         /// A service created locally must be passed.
-        /// Url and Usn of the service must be set before RegisterService is called.
+        /// URL and USN of the service must be set before the RegisterService is called.
         /// </remarks>
         /// <since_tizen> 4 </since_tizen>
         /// <privilege>http://tizen.org/privilege/internet</privilege>
         /// <feature>http://tizen.org/feature/network.service_discovery.ssdp</feature>
         /// <exception cref="InvalidOperationException">Thrown when any other error occurred.</exception>
-        /// <exception cref="NotSupportedException">Thrown when SSDP is not supported.</exception>
-        /// <exception cref="UnauthorizedAccessException">Thrown when permission is denied.</exception>
+        /// <exception cref="NotSupportedException">Thrown when the SSDP is not supported.</exception>
+        /// <exception cref="UnauthorizedAccessException">Thrown when the permission is denied.</exception>
         public void RegisterService()
         {
             if (!Globals.s_threadSsd.IsValueCreated)
@@ -228,7 +228,7 @@ namespace Tizen.Network.Nsd
         /// <since_tizen> 4 </since_tizen>
         /// <feature>http://tizen.org/feature/network.service_discovery.ssdp</feature>
         /// <exception cref="InvalidOperationException">Thrown when any other error occurred.</exception>
-        /// <exception cref="NotSupportedException">Thrown when SSDP is not supported.</exception>
+        /// <exception cref="NotSupportedException">Thrown when the SSDP is not supported.</exception>
         public void DeregisterService()
         {
             int ret = Interop.Nsd.Ssdp.DeregisterService(_serviceHandle);
@@ -263,7 +263,7 @@ namespace Tizen.Network.Nsd
         }
 
         /// <summary>
-        /// Destroy the SsdpService object
+        /// Destroys the SsdpService object.
         /// </summary>
         ~SsdpService()
         {