Review System.Usb API cs files 54/165354/1
authorEditor <TizenEditor.SEL@lionbridge.com>
Thu, 28 Dec 2017 09:35:41 +0000 (15:05 +0530)
committerEditor <TizenEditor.SEL@lionbridge.com>
Thu, 28 Dec 2017 09:35:41 +0000 (15:05 +0530)
Change-Id: I45edd68eebcc4bb075b7669d523bc5bbeefa10d9

17 files changed:
src/Tizen.System.Usb/Interop/Interop.ErrorCode.cs
src/Tizen.System.Usb/Usb/EndpointDirection.cs
src/Tizen.System.Usb/Usb/HotPluggedEventArgs.cs
src/Tizen.System.Usb/Usb/HotplugEventType.cs
src/Tizen.System.Usb/Usb/SynchronizationType.cs
src/Tizen.System.Usb/Usb/UsageType.cs
src/Tizen.System.Usb/Usb/UsbBulkEndpoint.cs
src/Tizen.System.Usb/Usb/UsbConfiguration.cs
src/Tizen.System.Usb/Usb/UsbControlEndpoint.cs
src/Tizen.System.Usb/Usb/UsbDevice.cs
src/Tizen.System.Usb/Usb/UsbDeviceInformation.cs
src/Tizen.System.Usb/Usb/UsbDeviceStrings.cs
src/Tizen.System.Usb/Usb/UsbEndpoint.cs
src/Tizen.System.Usb/Usb/UsbInterface.cs
src/Tizen.System.Usb/Usb/UsbInterruptEndpoint.cs
src/Tizen.System.Usb/Usb/UsbIsochronousEndpoint.cs
src/Tizen.System.Usb/Usb/UsbManager.cs

index 38d9ee2..9d6c8d6 100644 (file)
@@ -56,9 +56,9 @@ internal static class ErrorCodeExtensions
     }
 
     /// <summary>
-    /// Utility method to check for error, returns false if failed and print warning messages
+    /// The Utility method to check for an error, returns false if failed and prints warning messages.
     /// </summary>
-    /// <returns>true in case of no error, false otherwise</returns>
+    /// <returns>true in case of no error, false otherwise.</returns>
     internal static bool WarnIfFailed(this Interop.ErrorCode err, string msg, [CallerFilePath] string file = "", [CallerMemberName] string func = "", [CallerLineNumber] int line = 0)
     {
         if (err.IsFailed())
@@ -70,9 +70,9 @@ internal static class ErrorCodeExtensions
     }
 
     /// <summary>
-    /// Utility method to check for error, returns false if failed and throw exception
+    /// The Utility method checks for an error, returns false if failed and throws an exception.
     /// </summary>
-    /// <returns>true in case of no error</returns>
+    /// <returns>true in case of no error.</returns>
     internal static bool ThrowIfFailed(this Interop.ErrorCode err, string msg, [CallerFilePath] string file = "", [CallerMemberName] string func = "", [CallerLineNumber] int line = 0)
     {
         if (err.IsFailed())
index 597cf39..5c1ea00 100644 (file)
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// Enumeration of transfer direction for Endpoints.
+    /// Enumeration for the transfer directions for endpoints.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public enum EndpointDirection
     {
         /// <summary>
-        /// IN direction
+        /// In direction.
         /// </summary>
         In = Interop.EndpointDirection.In,
         /// <summary>
-        /// OUT direction
+        /// Out direction.
         /// </summary>
         Out = Interop.EndpointDirection.Out,
         /// <summary>
-        /// Bi-directional
+        /// Bidirectional.
         /// </summary>
         InOut = Interop.EndpointDirection.InOut,
     }
index 48e94ea..29ab147 100644 (file)
@@ -19,7 +19,7 @@ using System;
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// Event arguments for Hot Plugged event for USB devices.
+    /// Event arguments for the Hot Plugged event for USB devices.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class HotPluggedEventArgs : EventArgs
@@ -31,13 +31,13 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// USB Device
+        /// USB device.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public UsbDevice Device { get; }
 
         /// <summary>
-        /// Event Type
+        /// Event type.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public HotplugEventType EventType { get; }
index 1f47cf8..66f141d 100644 (file)
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// Enumeration of hot plugged event type for USB devices.
+    /// Enumeration for the Hot Plugged event type for USB devices.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public enum HotplugEventType
     {
         /// <summary>
-        /// USB device is attached
+        /// USB device is attached.
         /// </summary>
         Attach = Interop.HotplugEventType.Attach,
         /// <summary>
-        /// USB device is detached
+        /// USB device is detached.
         /// </summary>
         Detach = Interop.HotplugEventType.Detach,
     }
index 4f2cc86..7c6124e 100644 (file)
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// Enumeration of isochronous endpoint's synchronization type.
+    /// Enumeration for the isochronous endpoints synchronization types.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public enum SynchronizationType
     {
         /// <summary>
-        /// Asynchronous
+        /// Asynchronous.
         /// </summary>
         Asynchronous = Interop.SynchronizationType.Async,
         /// <summary>
-        /// Adaptive
+        /// Adaptive.
         /// </summary>
         Adaptive = Interop.SynchronizationType.Adaptive,
         /// <summary>
-        /// Synchronous
+        /// Synchronous.
         /// </summary>
         Synchronous = Interop.SynchronizationType.Sync,
     }
index e0384e6..a925463 100644 (file)
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// Enumeration of an endpoint's usage type.
+    /// Enumeration for an endpoint's usage types.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public enum UsageType
     {
         /// <summary>
-        /// Data endpoint
+        /// Data endpoint.
         /// </summary>
         Data = Interop.UsageType.Data,
         /// <summary>
-        /// Feedback endpoint
+        /// Feedback endpoint.
         /// </summary>
         Feedback = Interop.UsageType.Feedback,
         /// <summary>
-        /// Implicit feedback Data endpoint
+        /// Implicit feedback data endpoint.
         /// </summary>
         Implicit = Interop.UsageType.Implicit,
     }
index 282509a..9dbfcdb 100644 (file)
@@ -19,7 +19,7 @@ using System;
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// USB Bulk Endpoint class.
+    /// The USB Bulk Endpoint class.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class UsbBulkEndpoint : UsbEndpoint
@@ -29,20 +29,20 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Performs a USB transfer on given endpoint. Direction of transfer is determined by the endpoint.
+        /// Performs a USB transfer on a given endpoint. The direction of transfer is determined by the endpoint.
         /// </summary>
-        /// <param name="buffer">Suitably-sized data buffer for either input or output (depending on endpoint).</param>
+        /// <param name="buffer">Suitably-sized data buffer for either an input or output (depending on the endpoint).</param>
         /// <param name="length">
-        /// For writes, the number of bytes from data to be sent, for reads the maximum number of bytes to receive
+        /// For writes, the number of bytes from the data to be sent. For reads, the maximum number of bytes to receive
         /// into the data buffer.
         /// </param>
         /// <param name="timeout">
-        /// Time (in milliseconds) that this function should wait for before giving up due to no response being
-        /// received(for an unlimited timeout 0 value should be used).
+        /// The time (in milliseconds) that this function should wait for, before giving up due to no response being
+        /// received (for an unlimited timeout, 0 value should be used).
         /// </param>
-        /// <returns>Number of bytes actually transferred.</returns>
-        /// <exception cref="InvalidOperationException">Throws exception if device is disconnected or not opened for operation.</exception>
-        /// <exception cref="TimeoutException">Throws exception if transfer timed-out.</exception>
+        /// <returns>The number of bytes actually transferred.</returns>
+        /// <exception cref="InvalidOperationException">Throws an exception if the device is disconnected or not opened for an operation.</exception>
+        /// <exception cref="TimeoutException">Throws an exception if the transfer is timed out.</exception>
         /// <since_tizen> 4 </since_tizen>
         public int Transfer(byte[] buffer, int length, uint timeout)
         {
index 502d0b2..98262d9 100644 (file)
@@ -21,7 +21,7 @@ using System.Collections.Generic;
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// Class to manage USB Configuration.
+    /// A class to manage the USB configuration.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class UsbConfiguration : IDisposable
@@ -37,7 +37,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Checks if device is self-powered in given configuration.
+        /// Checks if the device is self-powered in a given configuration.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public bool IsSelfPowered
@@ -50,7 +50,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Checks if device in given configuration supports remote wakeup.
+        /// Checks if the device in a given configuration supports remote wakeup.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public bool SupportRemoteWakeup
@@ -63,7 +63,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets maximum power required in given configuration, in mA.
+        /// Gets the maximum power required in a given configuration, in mA.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int MaximumPowerRequired
@@ -76,7 +76,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Dictionary mapping interfaces Ids to interface instances for given configuration.
+        /// A dictionary for mapping the interface IDs to interface instances for a given configuration.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public IReadOnlyDictionary<int, UsbInterface> Interfaces
@@ -101,7 +101,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Configuration string.
+        /// The configuration string.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public string ConfigurationString
@@ -114,10 +114,10 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Set this configuration as active configuration for the device.
+        /// Sets this configuration as an active configuration for the device.
         /// </summary>
         /// <exception cref="InvalidOperationException">
-        /// Throws exception if device is disconnected or not opened for operation or busy as its interfaces are currently claimed.
+        /// Throws an exception if the device is disconnected, or not opened for an operation, or busy as its interfaces are currently claimed.
         /// </exception>
         /// <since_tizen> 4 </since_tizen>
         public void SetAsActive()
@@ -136,8 +136,8 @@ namespace Tizen.System.Usb
         private bool disposedValue = false;
 
         /// <summary>
-        /// Releases all resources used by the ConnectionProfile.
-        /// It should be called after finished using of the object.</summary>
+        /// Releases all the resources used by the ConnectionProfile.
+        /// It should be called after it has finished using the object.</summary>
         /// <since_tizen> 4 </since_tizen>
         protected virtual void Dispose(bool disposing)
         {
@@ -157,8 +157,8 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Releases all resources used by the ConnectionProfile.
-        /// It should be called after finished using of the object.</summary>
+        /// Releases all the resources used by the ConnectionProfile.
+        /// It should be called after it has finished using the object.</summary>
         /// <since_tizen> 4 </since_tizen>
         public void Dispose()
         {
index 959b3b5..5962ea3 100644 (file)
@@ -19,7 +19,7 @@ using System;
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// USB Control Endpoint class.
+    /// The USB Control Endpoint class.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class UsbControlEndpoint : UsbEndpoint
@@ -32,7 +32,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets number of this endpoint.
+        /// Gets the number of this endpoint.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public new int Id
@@ -44,7 +44,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets direction of this endpoint.
+        /// Gets the direction of this endpoint.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public new EndpointDirection Direction
@@ -56,7 +56,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets max packet size of given endpoint.
+        /// Gets the maximum packet size of a given endpoint.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public new int MaxPacketSize
@@ -69,21 +69,21 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Performs a control transaction on endpoint zero for this device.
+        /// Performs a control transaction on the endpoint, zero for this device.
         /// </summary>
         /// <param name="requestType">bmRequestType type field for the setup packet.</param>
         /// <param name="request">bRequest field for the setup packet.</param>
         /// <param name="value">wValue field for the setup packet.</param>
         /// <param name="index">wIndex field for the setup packet.</param>
-        /// <param name="data">Suitably-sized data buffer for either input or output, (depending on direction bits within bmRequestType).</param>
+        /// <param name="data">Suitably-sized data buffer for either an input or output (depending on the direction bits within a bmRequestType).</param>
         /// <param name="length">wLength field for the setup packet. The data buffer should be at least this size.</param>
         /// <param name="timeout">
-        /// Time (in milliseconds) that this function should wait for, before giving up due to no response being received
-        /// (for an unlimited timeout 0 value should be used).
+        /// The time (in milliseconds) that this function should wait for, before giving up due to no response being received
+        /// (for an unlimited timeout, 0 value should be used).
         /// </param>
-        /// <returns>Transferred Number of transferred bytes.</returns>
-        /// <exception cref="InvalidOperationException">Throws exception if device is disconnected or not opened for operation.</exception>
-        /// <exception cref="TimeoutException">Throws exception if transfer timed-out.</exception>
+        /// <returns>Transferred number of the transferred bytes.</returns>
+        /// <exception cref="InvalidOperationException">Throws an exception if the device is disconnected or not opened for an operation.</exception>
+        /// <exception cref="TimeoutException">Throws an exception if the transfer is timed out.</exception>
         /// <since_tizen> 4 </since_tizen>
         public int Transfer(byte requestType, byte request, ushort value, ushort index, byte[] data, ushort length, uint timeout)
         {
index 0730bc8..6aaf73f 100644 (file)
@@ -21,7 +21,7 @@ using System.Linq;
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// Class to manage USB host devices. This class contains operations for enumerating, opening and closing devices.
+    /// A class to manage the USB host devices. This class contains the operations for enumerating, opening, and closing devices.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class UsbDevice : IDisposable
@@ -47,7 +47,7 @@ namespace Tizen.System.Usb
         /// <summary>
         /// Number of the bus, this device is connected to.
         /// </summary>
-        /// <exception cref="UnauthorizedAccessException">Throws exception if user has insufficient permission on device.</exception>
+        /// <exception cref="UnauthorizedAccessException">Throws an exception if the user has insufficient permission on the device.</exception>
         /// <since_tizen> 4 </since_tizen>
         public int BusId {
             get
@@ -58,7 +58,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Address of device on the bus.
+        /// Address of the device on the bus.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int Address
@@ -71,7 +71,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// List of available port numbers from a device.
+        /// List of the available port numbers from the device.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public IEnumerable<int> Ports
@@ -84,7 +84,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Checks if device is opened.
+        /// Checks if the device is opened.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public bool IsOpened
@@ -97,7 +97,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Control endpoint (endpoint 0).
+        /// Controls an endpoint (endpoint 0).
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public UsbControlEndpoint ControlEndpoint
@@ -112,7 +112,7 @@ namespace Tizen.System.Usb
         /// <summary>
         /// Active configuration for the device.
         /// </summary>
-        /// <exception cref="InvalidOperationException">Throws exception if device is disconnected.</exception>
+        /// <exception cref="InvalidOperationException">Throws an exception if the device is disconnected.</exception>
         /// <since_tizen> 4 </since_tizen>
         public UsbConfiguration ActiveConfiguration
         {
@@ -125,7 +125,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Dictionary mapping configuration Ids to configuration instances for this device.
+        /// A dictionary for mapping the configuration IDs to configuration instances for this device.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public IReadOnlyDictionary<int, UsbConfiguration> Configurations
@@ -138,7 +138,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Device information such as version, class, subclass etc.
+        /// Device information such as version, class, subclass, etc.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public UsbDeviceInformation DeviceInformation
@@ -151,7 +151,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// String associated with device.
+        /// String associated with the device.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public UsbDeviceStrings Strings
@@ -164,11 +164,11 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Opens device, which allows performing operations on it.
+        /// Opens the device, which allows performing operations on it.
         /// </summary>
-        /// <exception cref="OutOfMemoryException">Throws exception in case of insufficient memory.</exception>
-        /// <exception cref="InvalidOperationException">Throws exception if device is disconnected.</exception>
-        /// <exception cref="UnauthorizedAccessException">Throws exception if user has insufficient permission on device.</exception>
+        /// <exception cref="OutOfMemoryException">Throws an exception in case of insufficient memory.</exception>
+        /// <exception cref="InvalidOperationException">Throws an exception if the device is disconnected.</exception>
+        /// <exception cref="UnauthorizedAccessException">Throws an exception if the user has insufficient permission on the device.</exception>
         /// <since_tizen> 4 </since_tizen>
         public void Open()
         {
@@ -177,9 +177,9 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Closes device for operations.
+        /// Closes the device for operations.
         /// </summary>
-        /// <exception cref="InvalidOperationException">Throws exception if device is not opened for operation.</exception>
+        /// <exception cref="InvalidOperationException">Throws an exception if the device is not opened for an operation.</exception>
         /// <since_tizen> 4 </since_tizen>
         public void Close()
         {
@@ -199,8 +199,8 @@ namespace Tizen.System.Usb
         private bool disposedValue = false;
 
         /// <summary>
-        /// Releases all resources used by the ConnectionProfile.
-        /// It should be called after finished using of the object.</summary>
+        /// Releases all the resources used by the ConnectionProfile.
+        /// It should be called after it has finished using the object.</summary>
         /// <since_tizen> 4 </since_tizen>
         protected virtual void Dispose(bool disposing)
         {
@@ -228,8 +228,8 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Releases all resources used by the ConnectionProfile.
-        /// It should be called after finished using of the object.</summary>
+        /// Releases all the resources used by the ConnectionProfile.
+        /// It should be called after it has finished using the object.</summary>
         /// <since_tizen> 4 </since_tizen>
         public void Dispose()
         {
index 3761897..01f6eb5 100755 (executable)
@@ -19,7 +19,7 @@ using System;
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// Device information for USB device.
+    /// Device information for the USB device.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class UsbDeviceInformation
@@ -34,7 +34,7 @@ namespace Tizen.System.Usb
         /// <summary>
         /// USB specification release number as binary-coded decimal.
         /// </summary>
-        /// <exception cref="UnauthorizedAccessException">Throws exception if user has insufficient permission on device.</exception>
+        /// <exception cref="UnauthorizedAccessException">Throws an exception if the user has insufficient permission on the device.</exception>
         /// <since_tizen> 4 </since_tizen>
         public int UsbVersion
         {
@@ -46,7 +46,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets device class.
+        /// Gets the device class.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int Class
@@ -59,7 +59,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets device sub class.
+        /// Gets the device subclass.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int Subclass
@@ -72,7 +72,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets device protocol.
+        /// Gets the device protocol.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int Protocol
@@ -85,7 +85,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets vendor id.
+        /// Gets the vendor ID.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int VendorId
@@ -98,7 +98,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets product id.
+        /// Gets the product ID.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int ProductId
@@ -111,7 +111,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets device release number in binary-coded decimal.
+        /// Gets the device release number in binary-coded decimal.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int DeviceVersion
index d5ac067..df1c62c 100755 (executable)
@@ -19,7 +19,7 @@ using System;
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// String information for USB device.
+    /// String information for the USB device.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class UsbDeviceStrings
@@ -34,10 +34,10 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets string describing device manufacturer.
+        /// Gets the string describing the device manufacturer.
         /// </summary>
-        /// <exception cref="InvalidOperationException">Throws exception if device is disconnected or not opened for operation.</exception>
-        /// <exception cref="UnauthorizedAccessException">Throws exception if user has insufficient permission on device.</exception>
+        /// <exception cref="InvalidOperationException">Throws an exception if the device is disconnected or not opened for an operation.</exception>
+        /// <exception cref="UnauthorizedAccessException">Throws an exception if the user has insufficient permission on the device.</exception>
         /// <since_tizen> 4 </since_tizen>
         public string Manufacturer
         {
@@ -49,10 +49,10 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets product string of device
+        /// Gets the product string of a device.
         /// </summary>
-        /// <exception cref="InvalidOperationException">Throws exception if device is not opened for operation.</exception>
-        /// <exception cref="UnauthorizedAccessException">Throws exception if user has insufficient permission on device.</exception>
+        /// <exception cref="InvalidOperationException">Throws an exception if the device is not opened for an operation.</exception>
+        /// <exception cref="UnauthorizedAccessException">Throws an exception if the user has insufficient permission on the device.</exception>
         /// <since_tizen> 4 </since_tizen>
         public string Product
         {
@@ -64,10 +64,10 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets serial number of a device.
+        /// Gets the serial number of a device.
         /// </summary>
-        /// <exception cref="InvalidOperationException">Throws exception if device is not opened for operation.</exception>
-        /// <exception cref="UnauthorizedAccessException">Throws exception if user has insufficient permission on device.</exception>
+        /// <exception cref="InvalidOperationException">Throws an exception if the device is not opened for an operation.</exception>
+        /// <exception cref="UnauthorizedAccessException">Throws an exception if the user has insufficient permission on the device.</exception>
         /// <since_tizen> 4 </since_tizen>
         public string Serial
         {
index 43c51dd..d90e986 100644 (file)
@@ -19,7 +19,7 @@ using System;
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// USB Endpoint class.
+    /// The USB Endpoint class.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class UsbEndpoint
@@ -35,7 +35,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets number of this endpoint.
+        /// Gets the number of this endpoint.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int Id
@@ -48,7 +48,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets direction of this endpoint.
+        /// Gets the direction of this endpoint.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public EndpointDirection Direction
@@ -61,7 +61,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets max packet size of given endpoint.
+        /// Gets the maximum packet size of a given endpoint.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int MaxPacketSize
index a70d7a7..eaba621 100755 (executable)
@@ -20,7 +20,7 @@ using System.Collections.Generic;
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// Class to manage USB Interfaces.
+    /// A class to manage the USB interfaces.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class UsbInterface
@@ -37,7 +37,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets number of given interface.
+        /// Gets the number of a given interface.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int Id
@@ -50,7 +50,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Sets alternative setting. Use index of new alternative setting for given interface.
+        /// Sets an alternative setting. Use the index of a new alternative setting for a given interface.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int AlternateSetting
@@ -63,7 +63,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Dictionary mapping endpoint Ids to endpoint instances for given interface.
+        /// A dictionary for mapping the endpoint IDs to endpoint instances for a given interface.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public IReadOnlyDictionary<int, UsbEndpoint> Endpoints
@@ -89,7 +89,7 @@ namespace Tizen.System.Usb
 
 
         /// <summary>
-        /// Gets string describing an interface.
+        /// Gets the string describing an interface.
         /// </summary>
         /// <returns></returns>
         /// <since_tizen> 4 </since_tizen>
@@ -100,11 +100,11 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Claims interface on a device. Interface must be claimed first to perform I/O operations.
+        /// Claims the interface on a device. The interface must be claimed first to perform I/O operations.
         /// </summary>
-        /// <param name="force">Set to true to auto detach kernel driver, false otherwise.</param>
+        /// <param name="force">Set to true to auto detach the kernel driver, false otherwise.</param>
         /// <exception cref="InvalidOperationException">
-        /// Throws exception if device is disconnected or not opened for operation or another program or driver has claimed the interface.
+        /// Throws an exception if the device is disconnected, or not opened for an operation, or another program or driver has claimed the interface.
         /// </exception>
         /// <since_tizen> 4 </since_tizen>
         public void Claim(bool force)
@@ -117,10 +117,10 @@ namespace Tizen.System.Usb
 
 
         /// <summary>
-        /// Releases previously claimed interface.
+        /// Releases the previously claimed interface.
         /// </summary>
-        /// <exception cref="InvalidOperationException">Throws exception if device is disconnected or not opened for operation.</exception>
-        /// <exception cref="UnauthorizedAccessException">Throws exception if user has insufficient permission on device.</exception>
+        /// <exception cref="InvalidOperationException">Throws an exception if the device is disconnected or not opened for an operation.</exception>
+        /// <exception cref="UnauthorizedAccessException">Throws an exception if the user has insufficient permission on the device.</exception>
         /// <since_tizen> 4 </since_tizen>
         public void Release()
         {
index 4cbd76c..a9e1fc9 100755 (executable)
@@ -19,7 +19,7 @@ using System;
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// USB Interrupt Endpoint class.
+    /// The USB Interrupt Endpoint class.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class UsbInterruptEndpoint : UsbEndpoint
@@ -29,7 +29,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets interval for polling endpoint for data transfers, in frame counts (refer to USB protocol specification).
+        /// Gets an interval for polling the endpoint for data transfers, in frame counts (refer to the USB protocol specification).
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int PollingInterval
@@ -42,20 +42,20 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Performs a USB transfer on given endpoint. Direction of transfer is determined by the endpoint.
+        /// Performs a USB transfer on a given endpoint. The direction of transfer is determined by the endpoint.
         /// </summary>
-        /// <param name="buffer">Suitably-sized data buffer for either input or output (depending on endpoint).</param>
+        /// <param name="buffer">Suitably-sized data buffer for either an input or output (depending on the endpoint).</param>
         /// <param name="length">
-        /// For writes, the number of bytes from data to be sent, for reads the maximum number of bytes to receive
+        /// For writes, the number of bytes from the data to be sent. For reads, the maximum number of bytes to receive
         /// into the data buffer.
         /// </param>
         /// <param name="timeout">
-        /// Time (in milliseconds) that this function should wait for before giving up due to no response being
-        /// received(for an unlimited timeout 0 value should be used).
+        /// The time (in milliseconds) that this function should wait for, before giving up due to no response being
+        /// received (for an unlimited timeout, 0 value should be used).
         /// </param>
-        /// <returns>Number of bytes actually transferred.</returns>
-        /// <exception cref="InvalidOperationException">Throws exception if device is disconnected or not opened for operation.</exception>
-        /// <exception cref="TimeoutException">Throws exception if transfer timed-out.</exception>
+        /// <returns>The number of bytes actually transferred.</returns>
+        /// <exception cref="InvalidOperationException">Throws an exception if the device is disconnected or not opened for an operation.</exception>
+        /// <exception cref="TimeoutException">Throws an exception if the transfer is timed out.</exception>
         /// <since_tizen> 4 </since_tizen>
         public int Transfer(byte[] buffer, int length, uint timeout)
         {
index 6367815..94f259e 100644 (file)
@@ -17,7 +17,7 @@
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// USB Isochronous Endpoint class.
+    /// The USB Isochronous Endpoint class.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class UsbIsochronousEndpoint : UsbEndpoint
@@ -27,7 +27,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets synchronization type of this endpoint.
+        /// Gets the synchronization type of this endpoint.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public SynchronizationType SynchronizationType
@@ -40,7 +40,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Gets usage type of this endpoint.
+        /// Gets the usage type of this endpoint.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public UsageType UsageType
index 00bbb66..b62d1bb 100644 (file)
@@ -21,7 +21,7 @@ using System.Linq;
 namespace Tizen.System.Usb
 {
     /// <summary>
-    /// USB Manager class.
+    /// The USB Manager class.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class UsbManager : IDisposable
@@ -31,7 +31,7 @@ namespace Tizen.System.Usb
         private List<UsbDevice> _devices = new List<UsbDevice>();
 
         /// <summary>
-        /// USB Manager Constructor.
+        /// The USB Manager constructor.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public UsbManager()
@@ -43,11 +43,11 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// This function returns list of USB devices attached to system.
+        /// This function returns a list of USB devices attached to the system.
         /// </summary>
-        /// <exception cref="NotSupportedException">Throws exception if USB host feature is not enabled.</exception>
-        /// <exception cref="OutOfMemoryException">Throws exception in case of insufficient memory.</exception>
-        /// <exception cref="UnauthorizedAccessException">Throws exception if user has insufficient permission on device.</exception>
+        /// <exception cref="NotSupportedException">Throws an exception if the USB host feature is not enabled.</exception>
+        /// <exception cref="OutOfMemoryException">Throws an exception in case of insufficient memory.</exception>
+        /// <exception cref="UnauthorizedAccessException">Throws an exception if the user has insufficient permission on the device.</exception>
         /// <since_tizen> 4 </since_tizen>
         public IEnumerable<UsbDevice> AvailableDevices
         {
@@ -59,7 +59,7 @@ namespace Tizen.System.Usb
         }
 
         /// <summary>
-        /// Event handler for events when a USB device is attached or detached.
+        /// An event handler for events when the USB device is attached or detached.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public event EventHandler<HotPluggedEventArgs> DeviceHotPlugged;