From 320e8744f02123838ad40a429f69b599a6fbd444 Mon Sep 17 00:00:00 2001 From: sinikang Date: Tue, 22 Aug 2017 17:44:52 +0900 Subject: [PATCH] Review doxygen of telephony API cs files Change-Id: Ib88f09c18d407393678b37077a534aa74d78ffdd --- src/Tizen.Telephony/Interop/Interop.Call.cs | 4 +- src/Tizen.Telephony/Interop/Interop.Libraries.cs | 4 +- src/Tizen.Telephony/Interop/Interop.Modem.cs | 4 +- src/Tizen.Telephony/Interop/Interop.Network.cs | 4 +- src/Tizen.Telephony/Interop/Interop.Sim.cs | 4 +- src/Tizen.Telephony/Interop/Interop.Telephony.cs | 4 +- src/Tizen.Telephony/Tizen.Telephony/Call.cs | 20 +-- src/Tizen.Telephony/Tizen.Telephony/CallHandle.cs | 52 +++--- .../Tizen.Telephony/ChangeNotificationEventArgs.cs | 124 ++++++------- src/Tizen.Telephony/Tizen.Telephony/Modem.cs | 34 ++-- src/Tizen.Telephony/Tizen.Telephony/Network.cs | 200 ++++++++++----------- src/Tizen.Telephony/Tizen.Telephony/Sim.cs | 116 ++++++------ src/Tizen.Telephony/Tizen.Telephony/SlotHandle.cs | 22 +-- .../Tizen.Telephony/StateEventArgs.cs | 4 +- src/Tizen.Telephony/Tizen.Telephony/Telephony.cs | 46 ++--- 15 files changed, 321 insertions(+), 321 deletions(-) diff --git a/src/Tizen.Telephony/Interop/Interop.Call.cs b/src/Tizen.Telephony/Interop/Interop.Call.cs index c5cf929..f28db6d 100755 --- a/src/Tizen.Telephony/Interop/Interop.Call.cs +++ b/src/Tizen.Telephony/Interop/Interop.Call.cs @@ -20,12 +20,12 @@ using Tizen.Telephony; using static Tizen.Telephony.CallHandle; /// -/// Partial Interop Class +/// The Partial Interop class. /// internal static partial class Interop { /// - /// Call Interop Class + /// The Call Interop class. /// internal static partial class Call { diff --git a/src/Tizen.Telephony/Interop/Interop.Libraries.cs b/src/Tizen.Telephony/Interop/Interop.Libraries.cs index b98e7d0..a346305 100755 --- a/src/Tizen.Telephony/Interop/Interop.Libraries.cs +++ b/src/Tizen.Telephony/Interop/Interop.Libraries.cs @@ -15,12 +15,12 @@ */ /// -/// Partial Interop Class +/// The Partial Interop class. /// internal static partial class Interop { /// - /// Libraries Interop Class + /// The Libraries Interop class. /// internal static partial class Libraries { diff --git a/src/Tizen.Telephony/Interop/Interop.Modem.cs b/src/Tizen.Telephony/Interop/Interop.Modem.cs index 19034b0..6284cfa 100755 --- a/src/Tizen.Telephony/Interop/Interop.Modem.cs +++ b/src/Tizen.Telephony/Interop/Interop.Modem.cs @@ -18,12 +18,12 @@ using System; using System.Runtime.InteropServices; /// -/// Partial Interop Class +/// The Partial Interop class. /// internal static partial class Interop { /// - /// Modem Interop Class + /// The Modem Interop class. /// internal static partial class Modem { diff --git a/src/Tizen.Telephony/Interop/Interop.Network.cs b/src/Tizen.Telephony/Interop/Interop.Network.cs index e8bbaf0..8da8b6b 100755 --- a/src/Tizen.Telephony/Interop/Interop.Network.cs +++ b/src/Tizen.Telephony/Interop/Interop.Network.cs @@ -18,12 +18,12 @@ using System; using System.Runtime.InteropServices; /// -/// Partial Interop Class +/// The Partial Interop class. /// internal static partial class Interop { /// - /// Network Interop Class + /// The Network Interop class. /// internal static partial class Network { diff --git a/src/Tizen.Telephony/Interop/Interop.Sim.cs b/src/Tizen.Telephony/Interop/Interop.Sim.cs index 7e8c9f2..dab6ac4 100755 --- a/src/Tizen.Telephony/Interop/Interop.Sim.cs +++ b/src/Tizen.Telephony/Interop/Interop.Sim.cs @@ -18,12 +18,12 @@ using System; using System.Runtime.InteropServices; /// -/// Partial Interop Class +/// The Partial Interop class. /// internal static partial class Interop { /// - /// Sim Interop Class + /// The SIM Interop class. /// internal static partial class Sim { diff --git a/src/Tizen.Telephony/Interop/Interop.Telephony.cs b/src/Tizen.Telephony/Interop/Interop.Telephony.cs index 446703d..7365758 100755 --- a/src/Tizen.Telephony/Interop/Interop.Telephony.cs +++ b/src/Tizen.Telephony/Interop/Interop.Telephony.cs @@ -19,12 +19,12 @@ using System.Runtime.InteropServices; using Tizen.Telephony; /// -/// Partial Interop Class +/// The Partial Interop class. /// internal static partial class Interop { /// - /// Telephony Interop Class + /// The Telephony Interop class. /// internal static class Telephony { diff --git a/src/Tizen.Telephony/Tizen.Telephony/Call.cs b/src/Tizen.Telephony/Tizen.Telephony/Call.cs index 3171005..2e0f127 100644 --- a/src/Tizen.Telephony/Tizen.Telephony/Call.cs +++ b/src/Tizen.Telephony/Tizen.Telephony/Call.cs @@ -22,8 +22,8 @@ using static Interop.Telephony; namespace Tizen.Telephony { /// - /// The Call API's allows you to get the voice and video call states. - /// It provides the List of CallHandle which can be used to get the information about call related actions. + /// The Call APIs allow you to get the voice and video call states. + /// It provides the list of CallHandle which can be used to get the information about call related actions. /// public class Call { @@ -34,16 +34,16 @@ namespace Tizen.Telephony private Interop.Call.SafeCallList _safeCallList; /// - /// Public Constructor + /// The public constructor. /// /// 3 /// - /// SlotHandle received in the Manager.Init API + /// SlotHandle received in the Manager.Init API. /// /// http://tizen.org/feature/network.telephony /// The required feature is not supported. /// - /// This exception occurs if handle provided is null + /// This exception occurs if the handle provided is null. /// public Call(SlotHandle handle) { @@ -84,15 +84,15 @@ namespace Tizen.Telephony /// /// 3 /// - /// List of CallHandle for existing calls. + /// The list of the CallHandle for existing calls. /// /// http://tizen.org/privilege/telephony /// http://tizen.org/feature/network.telephony /// The required feature is not supported. - /// Incase of Invalid parameter - /// Incase of any System error - /// Incase of Privileges are not defined - /// Incase of Out of Memory + /// In case of an invalid parameter. + /// In case of any system error. + /// In case of privileges not defined. + /// In case of out of memory. public IEnumerable GetCallHandleList() { uint count; diff --git a/src/Tizen.Telephony/Tizen.Telephony/CallHandle.cs b/src/Tizen.Telephony/Tizen.Telephony/CallHandle.cs index 7d6de9c..ca85423 100644 --- a/src/Tizen.Telephony/Tizen.Telephony/CallHandle.cs +++ b/src/Tizen.Telephony/Tizen.Telephony/CallHandle.cs @@ -20,7 +20,7 @@ using static Interop.Telephony; namespace Tizen.Telephony { /// - /// This Class provides API's to get the information about calls. + /// This class provides the APIs to get the information about calls. /// public class CallHandle { @@ -32,31 +32,31 @@ namespace Tizen.Telephony public enum CallStatus { /// - /// Idle status + /// Idle status. /// Idle, /// - /// Active status + /// Active status. /// Active, /// - /// Held status + /// Held status. /// Held, /// - /// Dialing status + /// Dialing status. /// Dialing, /// - /// Alerting status + /// Alerting status. /// Alerting, /// - /// Incoming status + /// Incoming status. /// Incoming, /// - /// Unavailable + /// Unavailable. /// Unavailable }; @@ -67,19 +67,19 @@ namespace Tizen.Telephony public enum CallType { /// - /// Voice call + /// Voice call. /// Voice, /// - /// Video call + /// Video call. /// Video, /// - /// Emergency call + /// Emergency call. /// E911, /// - /// Unavailable + /// Unavailable. /// Unavailable }; @@ -90,15 +90,15 @@ namespace Tizen.Telephony public enum CallDirection { /// - /// MO(Mobile Originated) call + /// MO(Mobile Originated) call. /// Mo, /// - /// MT(Mobile Terminated) call + /// MT(Mobile Terminated) call. /// Mt, /// - /// Unavailable + /// Unavailable. /// Unavailable }; @@ -108,8 +108,8 @@ namespace Tizen.Telephony /// /// 3 /// - /// The id of the call handle - /// 0 if unable to complete the operation + /// The ID of the call handle. + /// 0 if unable to complete the operation. /// public uint HandleId { @@ -132,8 +132,8 @@ namespace Tizen.Telephony /// /// 3 /// - /// The number of the call - /// empty string if unable to complete the operation + /// The number of the call. + /// Empty string if unable to complete the operation. /// public string Number { @@ -156,7 +156,7 @@ namespace Tizen.Telephony /// /// 3 /// - /// The type of the call + /// The type of the call. /// public CallType Type { @@ -179,7 +179,7 @@ namespace Tizen.Telephony /// /// 3 /// - /// The status of the call + /// The status of the call. /// public CallStatus Status { @@ -198,15 +198,15 @@ namespace Tizen.Telephony } /// - /// Gets whether the call is MO(Mobile Originated) call or MT(Mobile Terminated). + /// Gets whether the call is MO(Mobile Originated) call or MT(Mobile Terminated) call. /// /// 3 /// - /// The direction of the call + /// The direction of the call. /// /// /// This Exception can occur due to: - /// 1. Operation Not Supported + /// 1. Operation Not Supported. /// public CallDirection Direction { @@ -226,11 +226,11 @@ namespace Tizen.Telephony } /// - /// Gets whether the call is conference call or not. + /// Gets whether the call is a conference call or not. /// /// 3 /// - /// The value whether the call is conference call or not. (true: Conference call, false: Single call) + /// The value whether the call is a conference call or not (true: Conference call, false: Single call). /// public bool ConferenceStatus { diff --git a/src/Tizen.Telephony/Tizen.Telephony/ChangeNotificationEventArgs.cs b/src/Tizen.Telephony/Tizen.Telephony/ChangeNotificationEventArgs.cs index da04afe..0c4b6de 100644 --- a/src/Tizen.Telephony/Tizen.Telephony/ChangeNotificationEventArgs.cs +++ b/src/Tizen.Telephony/Tizen.Telephony/ChangeNotificationEventArgs.cs @@ -18,7 +18,7 @@ using System; namespace Tizen.Telephony { /// - /// This Class contains the data related to the Notification event + /// This class contains the data related to the Notification event. /// public class ChangeNotificationEventArgs : EventArgs { @@ -29,13 +29,13 @@ namespace Tizen.Telephony } /// - /// Enumeration for Telephony notification. + /// Enumeration for the Telephony Notification. /// public enum Notification { /// - /// Notification to be invoked when the SIM card state changes. - /// SIM.State will be delivered in notification data. + /// The notification to be invoked when the SIM card state changes. + /// SIM.State will be delivered in the notification data. /// /// 3 /// @@ -43,8 +43,8 @@ namespace Tizen.Telephony /// SimStatus = 0x10, /// - /// Notification to be invoked when the SIM call forwarding indicator state changes. - /// 'state(bool)' will be delivered in notification data. + /// The notification to be invoked when the SIM call forwarding indicator state changes. + /// 'state(bool)' will be delivered in the notification data. /// /// 3 /// @@ -52,8 +52,8 @@ namespace Tizen.Telephony /// SimCallForwardingIndicatorState, /// - /// Notification to be invoked when the network service state changes. - /// Network.ServiceState will be delivered in notification data. + /// The notification to be invoked when the network service state changes. + /// Network.ServiceState will be delivered in the notification data. /// /// 3 /// @@ -61,8 +61,8 @@ namespace Tizen.Telephony /// NetworkServiceState = 0x20, /// - /// Notification to be invoked when the cell ID changes. - /// 'cell_id(int)' will be delivered in notification data. + /// The notification to be invoked when the cell ID changes. + /// 'cell_id(int)' will be delivered in the notification data. /// /// 3 /// @@ -70,8 +70,8 @@ namespace Tizen.Telephony /// NetworkCellid, /// - /// Notification to be invoked when the roaming status changes. - /// 'roaming_status(bool)' will be delivered in notification data. + /// The notification to be invoked when the roaming status changes. + /// 'roaming_status(bool)' will be delivered in the notification data. /// /// 3 /// @@ -79,8 +79,8 @@ namespace Tizen.Telephony /// NetworkRoamingStatus, /// - /// Notification to be invoked when the signal strength changes. - /// Network.Rssi will be delivered in notification data. + /// The notification to be invoked when the signal strength changes. + /// Network.Rssi will be delivered in the notification data. /// /// 3 /// @@ -88,8 +88,8 @@ namespace Tizen.Telephony /// NetworkSignalstrengthLevel, /// - /// Notification to be invoked when the network name changes. - /// 'network_name(string)' will be delivered in notification data. + /// The notification to be invoked when the network name changes. + /// 'network_name(string)' will be delivered in the notification data. /// /// 3 /// @@ -97,8 +97,8 @@ namespace Tizen.Telephony /// NetworkNetworkName, /// - /// Notification to be invoked when the ps type changes. - /// Network.PSType will be delivered in notification data. + /// The notification to be invoked when the PS type changes. + /// Network.PSType will be delivered in the notification data. /// /// 3 /// @@ -106,8 +106,8 @@ namespace Tizen.Telephony /// NetworkPsType, /// - /// Notification to be invoked when the default data subscription changes. - /// Network.DefaultDataSubscription will be delivered in notification data. + /// The notification to be invoked when the default data subscription changes. + /// Network.DefaultDataSubscription will be delivered in the notification data. /// /// 3 /// @@ -115,8 +115,8 @@ namespace Tizen.Telephony /// NetworkDefaultDataSubscription, /// - /// Notification to be invoked when the default subscription changes. - /// Network.DefaultSubscription will be delivered in notification data. + /// The notification to be invoked when the default subscription changes. + /// Network.DefaultSubscription will be delivered in the notification data. /// /// 3 /// @@ -124,8 +124,8 @@ namespace Tizen.Telephony /// NetworkDefaultSubscription, /// - /// Notification to be invoked when the LAC (Location Area Code) changes. - /// 'lac(int)' will be delivered in notification data. + /// The notification to be invoked when the LAC (Location Area Code) changes. + /// 'lac(int)' will be delivered in the notification data. /// /// 3 /// @@ -133,8 +133,8 @@ namespace Tizen.Telephony /// NetworkLac, /// - /// Notification to be invoked when the TAC (Tracking Area Code) changes. - /// 'tac(int)' will be delivered in notification data. + /// The notification to be invoked when the TAC (Tracking Area Code) changes. + /// 'tac(int)' will be delivered in the notification data. /// /// 3 /// @@ -142,8 +142,8 @@ namespace Tizen.Telephony /// NetworkTac, /// - /// Notification to be invoked when the system ID changes. - /// 'sid(int)' will be delivered in notification data. + /// The notification to be invoked when the system ID changes. + /// 'sid(int)' will be delivered in the notification data. /// /// 3 /// @@ -151,8 +151,8 @@ namespace Tizen.Telephony /// NetworkSystemId, /// - /// Notification to be invoked when the network ID changes. - /// 'nid(int)' will be delivered in notification data. + /// The notification to be invoked when the network ID changes. + /// 'nid(int)' will be delivered in the notification data. /// /// 3 /// @@ -160,8 +160,8 @@ namespace Tizen.Telephony /// NetworkId, /// - /// Notification to be invoked when the base station ID changes. - /// 'id(int)' will be delivered in notification data. + /// The notification to be invoked when the base station ID changes. + /// 'id(int)' will be delivered in the notification data. /// /// 3 /// @@ -169,8 +169,8 @@ namespace Tizen.Telephony /// NetworkBsId, /// - /// Notification to be invoked when the base station latitude changes. - /// 'latitude(int)' will be delivered in notification data. + /// The notification to be invoked when the base station latitude changes. + /// 'latitude(int)' will be delivered in the notification data. /// /// 3 /// @@ -178,8 +178,8 @@ namespace Tizen.Telephony /// NetworkBsLatitude, /// - /// Notification to be invoked when the base station longitude changes. - /// 'longitue(int)' will be delivered in notification data. + /// The notification to be invoked when the base station longitude changes. + /// 'longitue(int)' will be delivered in the notification data. /// /// 3 /// @@ -187,8 +187,8 @@ namespace Tizen.Telephony /// NetworkBsLongitude, /// - /// Notification to be invoked when a voice call is in idle status. - /// 'handle id(uint)' will be delivered in notification data. + /// The notification to be invoked when a voice call is in the idle status. + /// 'handle id(uint)' will be delivered in the notification data. /// /// 3 /// @@ -196,8 +196,8 @@ namespace Tizen.Telephony /// VoiceCallStatusIdle, /// - /// Notification to be invoked when a voice call is in active status. - /// 'handle id(uint)' will be delivered in notification data. + /// The notification to be invoked when a voice call is in the active status. + /// 'handle id(uint)' will be delivered in the notification data. /// /// 3 /// @@ -205,8 +205,8 @@ namespace Tizen.Telephony /// VoiceCallStatusActive, /// - /// Notification to be invoked when a voice call is in held status. - /// 'handle id(uint)' will be delivered in notification data. + /// The notification to be invoked when a voice call is in the held status. + /// 'handle id(uint)' will be delivered in the notification data. /// /// 3 /// @@ -214,8 +214,8 @@ namespace Tizen.Telephony /// VoiceCallStatusHeld, /// - /// Notification to be invoked when a voice call is in dialing status. - /// 'handle id(uint)' will be delivered in notification data. + /// The notification to be invoked when a voice call is in the dialing status. + /// 'handle id(uint)' will be delivered in the notification data. /// /// 3 /// @@ -223,8 +223,8 @@ namespace Tizen.Telephony /// VoiceCallStatusDialing, /// - /// Notification to be invoked when a voice call is in alertingstatus. - /// 'handle id(uint)' will be delivered in notification data. + /// The notification to be invoked when a voice call is in the alerting status. + /// 'handle id(uint)' will be delivered in the notification data. /// /// 3 /// @@ -232,8 +232,8 @@ namespace Tizen.Telephony /// VoiceCallStatusAlerting, /// - /// Notification to be invoked when a voice call is in incoming status. - /// 'handle id(uint)' will be delivered in notification data. + /// The notification to be invoked when a voice call is in the incoming status. + /// 'handle id(uint)' will be delivered in the notification data. /// /// 3 /// @@ -241,8 +241,8 @@ namespace Tizen.Telephony /// VoiceCallStatusIncoming, /// - /// Notification to be invoked when a video call is in idle status. - /// 'handle id(uint)' will be delivered in notification data. + /// The notification to be invoked when a video call is in the idle status. + /// 'handle id(uint)' will be delivered in the notification data. /// /// 3 /// @@ -250,8 +250,8 @@ namespace Tizen.Telephony /// VideoCallStatusIdle, /// - /// Notification to be invoked when a video call is in active status. - /// 'handle id(uint)' will be delivered in notification data. + /// The notification to be invoked when a video call is in the active status. + /// 'handle id(uint)' will be delivered in the notification data. /// /// 3 /// @@ -259,8 +259,8 @@ namespace Tizen.Telephony /// VideoCallStatusActive, /// - /// Notification to be invoked when a video call is in dialing status. - /// 'handle id(uint)' will be delivered in notification data. + /// The notification to be invoked when a video call is in the dialing status. + /// 'handle id(uint)' will be delivered in the notification data. /// /// 3 /// @@ -268,8 +268,8 @@ namespace Tizen.Telephony /// VideoCallStatusDialing, /// - /// Notification to be invoked when a video call is in alerting status. - /// 'handle id(uint)' will be delivered in notification data + /// The notification to be invoked when a video call is in the alerting status. + /// 'handle id(uint)' will be delivered in the notification data. /// /// 3 /// @@ -277,8 +277,8 @@ namespace Tizen.Telephony /// VideoCallStatusAlerting, /// - /// Notification to be invoked when a video call is in incoming status. - /// 'handle id(uint)' will be delivered in notification data + /// The notification to be invoked when a video call is in the incoming status. + /// 'handle id(uint)' will be delivered in the notification data. /// /// 3 /// @@ -286,8 +286,8 @@ namespace Tizen.Telephony /// VideoCallStatusIncoming, /// - /// Notification to be invoked when the preferred voice subscription changes. - /// CallPreferredVoiceSubscription will be delivered in notification data + /// The notification to be invoked when the preferred voice subscription changes. + /// CallPreferredVoiceSubscription will be delivered in the notification data. /// /// 3 /// @@ -297,7 +297,7 @@ namespace Tizen.Telephony }; /// - /// Telephony notification type + /// The Telephony Notification type. /// /// 3 public Notification NotificationType @@ -307,7 +307,7 @@ namespace Tizen.Telephony } /// - /// Data as per the Notification type + /// The data as per the Notification type. /// /// 3 public object NotificationData diff --git a/src/Tizen.Telephony/Tizen.Telephony/Modem.cs b/src/Tizen.Telephony/Tizen.Telephony/Modem.cs index b689eb9..ea19eeb 100644 --- a/src/Tizen.Telephony/Tizen.Telephony/Modem.cs +++ b/src/Tizen.Telephony/Tizen.Telephony/Modem.cs @@ -19,23 +19,23 @@ using static Interop.Telephony; namespace Tizen.Telephony { /// - /// This Class provides API's to obtain information from the modem. + /// This class provides APIs to obtain information from the modem. /// public class Modem { internal IntPtr _handle; /// - /// Modem Class Constructor + /// The Modem class constructor. /// /// 3 /// - /// SlotHandle received in the Manager.Init API + /// SlotHandle received in the Manager.Init API. /// /// http://tizen.org/feature/network.telephony /// The required feature is not supported. /// - /// This exception occurs if handle provided is null + /// This exception occurs if the handle provided is null. /// public Modem(SlotHandle handle) { @@ -48,41 +48,41 @@ namespace Tizen.Telephony } /// - /// Enumeration for Modem Power Status. + /// Enumeration for the Modem Power Status. /// public enum PowerStatus { /// - /// Unknown + /// Unknown. /// Unknown = -1, /// - /// Modem power ON + /// Modem power ON. /// On, /// - /// Modem power OFF + /// Modem power OFF. /// Off, /// - /// Modem power RESET + /// Modem power RESET. /// Reset, /// - /// Modem power LOW + /// Modem power LOW. /// Low }; /// /// Gets the IMEI (International Mobile Station Equipment Identity) of a mobile phone. - /// The IMEI number is used by a GSM network to identify valid devices and therefore can be used for stopping a stolen phone from accessing that network. + /// The IMEI number is used by a GSM network to identify valid devices and therefore, can be used for stopping a stolen phone from accessing that network. /// /// 3 /// http://tizen.org/privilege/telephony /// - /// The International Mobile Station Equipment Identity - /// empty string if unable to complete the operation + /// The International Mobile Station Equipment Identity. + /// Empty string if unable to complete the operation. /// public string Imei { @@ -106,7 +106,7 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// The Modem power status (0=on,1=off,2=reset,3=low) + /// The Modem power status (0=on,1=off,2=reset,3=low). /// public PowerStatus CurrentPowerStatus { @@ -126,13 +126,13 @@ namespace Tizen.Telephony } /// - /// Gets the MEID (Mobile Equipment Identifier) of a mobile phone. (for CDMA) + /// Gets the MEID (Mobile Equipment Identifier) of a mobile phone (for CDMA). /// /// 3 /// http://tizen.org/privilege/telephony /// - /// The Mobile Equipment Identifier - /// empty string if unable to complete the operation + /// The Mobile Equipment Identifier. + /// Empty string if unable to complete the operation. /// public string Meid { diff --git a/src/Tizen.Telephony/Tizen.Telephony/Network.cs b/src/Tizen.Telephony/Tizen.Telephony/Network.cs index f8e072a..5f078c0 100644 --- a/src/Tizen.Telephony/Tizen.Telephony/Network.cs +++ b/src/Tizen.Telephony/Tizen.Telephony/Network.cs @@ -19,23 +19,23 @@ using static Interop.Telephony; namespace Tizen.Telephony { /// - /// The Network class provides API's to obtain information about the current telephony service network. + /// The Network class provides APIs to obtain information about the current telephony service network. /// public class Network { internal IntPtr _handle; /// - /// Network Class Constructor + /// The Network class constructor. /// /// 3 /// - /// SlotHandle received in the Manager.Init API + /// SlotHandle received in the Manager.Init API. /// /// http://tizen.org/feature/network.telephony /// The required feature is not supported. /// - /// This exception occurs if handle provided is null + /// This exception occurs if the handle provided is null. /// public Network(SlotHandle handle) { @@ -48,238 +48,238 @@ namespace Tizen.Telephony } /// - /// Enumeration for RSSI (Receive Signal Strength Indicator). + /// Enumeration for the RSSI (Receive Signal Strength Indicator). /// Rssi6 indicates the highest strength. /// public enum Rssi { /// - /// Strength 0 + /// Strength 0. /// Rssi0, /// - /// Strength 1 + /// Strength 1. /// Rssi1, /// - /// Strength 2 + /// Strength 2. /// Rssi2, /// - /// Strength 3 + /// Strength 3. /// Rssi3, /// - /// Strength 4 + /// Strength 4. /// Rssi4, /// - /// Strength 5 + /// Strength 5. /// Rssi5, /// - /// Strength 6 + /// Strength 6. /// Rssi6, /// - /// Unavailable + /// Unavailable. /// Unavailable } /// - /// Enumeration for Network Type. + /// Enumeration for the network types. /// public enum Type { /// - /// Unknown + /// Unknown. /// Unknown, /// - /// 2G GSM network type + /// 2G GSM network type. /// Gsm, /// - /// 2.5G GPRS network type + /// 2.5G GPRS network type. /// Gprs, /// - /// 2.5G EDGE network type + /// 2.5G EDGE network type. /// Edge, /// - /// 3G UMTS network type + /// 3G UMTS network type. /// Umts, /// - /// HSDPA network type + /// HSDPA network type. /// Hsdpa, /// - /// LTE network type + /// LTE network type. /// Lte, /// - /// IS95A network type + /// IS95A network type. /// Is95a, /// - /// IS95B network type + /// IS95B network type. /// Is95b, /// - /// CDMA 1x network type + /// CDMA 1x network type. /// Cdma1X, /// - /// EVDO revision 0 network type + /// EVDO revision 0 network type. /// EvdoRev0, /// - /// EVDO revision A network type + /// EVDO revision A network type. /// EvdoRevA, /// - /// EVDO revision B network type + /// EVDO revision B network type. /// EvdoRevB, /// - /// EVDV network type + /// EVDV network type. /// Evdv, /// - /// EHRPD network type + /// EHRPD network type. /// Ehrpd } /// - /// Enumeration for PS Type. + /// Enumeration for the PS types. /// public enum PsType { /// - /// Unknown + /// Unknown. /// Unknown, /// - /// HSDPA ps type + /// HSDPA PS type. /// Hsdpa, /// - /// HSUPA ps type + /// HSUPA PS type. /// Hsupa, /// - /// HSPA ps type + /// HSPA PS type. /// Hspa, /// - /// HSPAP ps type + /// HSPAP PS type. /// Hspap } /// - /// Enumeration for Network Service State. + /// Enumeration for the network service states. /// public enum ServiceState { /// - /// In service + /// In service. /// InService, /// - /// Out of service + /// Out of service. /// OutOfService, /// - /// Only emergency call is allowed + /// Only emergency call is allowed. /// EmergencyOnly, /// - /// Unavailable + /// Unavailable. /// Unavailable } /// - /// Enumeration for Network Name Priority. + /// Enumeration for the network name priority. /// public enum NameOption { /// - /// Unknown + /// Unknown. /// Unknown, /// - /// Network name displayed by SPN + /// The network name displayed by the SPN. /// Spn, /// - /// Network name displayed by Network + /// The network name displayed by the Network. /// Network, /// - /// Network name displayed by SPN or Network + /// The network name displayed by the SPN or the Network. /// Any } /// - /// Enumeration for the possible 'default' Data Subscriptions for Packet Switched(PS). + /// Enumeration for the possible 'default' Data Subscriptions for the Packet Switched(PS). /// public enum DefaultDataSubscription { /// - /// Unknown status + /// Unknown status. /// Unknown = -1, /// - /// SIM 1 + /// SIM 1. /// Sim1, /// - /// SIM 2 + /// SIM 2. /// Sim2 } /// - /// Enumeration defines possible 'default' Subscriptions for Circuit Switched(CS). + /// Enumeration for defining the possible 'default' Subscriptions for the Circuit Switched(CS). /// public enum DefaultSubscription { /// - /// Unknown status + /// Unknown status. /// Unknown = -1, /// - /// SIM 1 network + /// SIM 1 network. /// Sim1, /// - /// SIM 2 network + /// SIM 2 network. /// Sim2 } /// - /// Enumeration for network selection mode. + /// Enumeration for the network selection modes. /// public enum SelectionMode { /// - /// Automatic mode + /// Automatic mode. /// Automatic, /// - /// Manual mode + /// Manual mode. /// Manual, /// - /// Unavailable + /// Unavailable. /// Unavailable } @@ -290,10 +290,10 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/location.coarse /// - /// This API can be used in GSM / WCDMA network. + /// This API can be used in the GSM/WCDMA network. /// /// - /// The Location Area Code, -1 if unknown + /// The Location Area Code, -1 if unknown. /// public int Lac { @@ -319,10 +319,10 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/location.coarse /// - /// This API can be used in GSM / WCDMA / LTE network. + /// This API can be used in the GSM/WCDMA/LTE network. /// /// - /// The cell identification number, -1 if unknown + /// The cell identification number, -1 if unknown. /// public int CellId { @@ -347,7 +347,7 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// The Received Signal Strength Indicator + /// The Received Signal Strength Indicator. /// Higher the received number, the stronger the signal strength. /// public Rssi CurrentRssi @@ -373,7 +373,7 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// true if roaming, otherwise false if not roaming + /// true if roaming, otherwise false if not roaming. /// public bool RoamingStatus { @@ -397,11 +397,11 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// This API can be used in GSM / WCDMA / LTE network. + /// This API can be used in the GSM/WCDMA/LTE network. /// /// - /// The Mobile Country Code (three digits) Mobile Country Code (MCC) identifies the country where the cell is being used. - /// empty string if unknown. + /// The Mobile Country Code (three digits). The Mobile Country Code (MCC) identifies the country where the cell is being used. + /// Empty string if unknown. /// public string Mcc { @@ -425,11 +425,11 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// This API can be used in GSM / WCDMA / LTE network. + /// This API can be used in the GSM/WCDMA/LTE network. /// /// - /// The Mobile Network Code (three digits) The Mobile Network Code (MNC) identifies the mobile phone operator and network provider. - /// empty string if unknown. + /// The Mobile Network Code (three digits). The Mobile Network Code (MNC) identifies the mobile phone operator and the network provider. + /// Empty string if unknown. /// public string Mnc { @@ -453,11 +453,11 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// This API can be used in GSM / WCDMA / LTE network. + /// This API can be used in the GSM/WCDMA/LTE network. /// /// - /// The name of the current registered network - /// empty string if unknown. + /// The name of the current registered network. + /// Empty string if unknown. /// public string NetworkName { @@ -481,10 +481,10 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// This API can be used in case network is in service. + /// This API can be used in case the network is in service. /// /// - /// The network service type + /// The network service type. /// public Type NetworkType { @@ -508,10 +508,10 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// This API can be used in HSDPA network. + /// This API can be used in the HSDPA network. /// /// - /// The type of packet service + /// The type of the packet service. /// public PsType NetworkPsType { @@ -536,7 +536,7 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// The network name display option + /// The network name display option. /// public NameOption NetworkNameOption { @@ -561,7 +561,7 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// The current network state + /// The current network state. /// public ServiceState NetworkServiceState { @@ -581,12 +581,12 @@ namespace Tizen.Telephony } /// - /// Gets the current default subscription for data service (Packet Switched). + /// Gets the current default subscription for the data service (Packet Switched). /// /// 3 /// http://tizen.org/privilege/telephony /// - /// The current default data subscription + /// The current default data subscription. /// public DefaultDataSubscription NetworkDefaultDataSubscription { @@ -606,12 +606,12 @@ namespace Tizen.Telephony } /// - /// Gets the current default subscription for voice service (Circuit Switched). + /// Gets the current default subscription for the voice service (Circuit Switched). /// /// 3 /// http://tizen.org/privilege/telephony /// - /// The current default voice subscription + /// The current default voice subscription. /// public DefaultSubscription NetworkDefaultSubscription { @@ -661,11 +661,11 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/location.coarse /// - /// This API can be used in LTE network. + /// This API can be used in the LTE network. /// /// - /// The Tracking Area Code - /// -1 if unknown + /// The Tracking Area Code. + /// -1 if unknown. /// public int Tac { @@ -690,11 +690,11 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/location.coarse /// - /// This API can be used in CDMA network. + /// This API can be used in the CDMA network. /// /// - /// The system ID - /// -1 if unknown + /// The system ID. + /// -1 if unknown. /// public int SystemId { @@ -719,11 +719,11 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/location.coarse /// - /// This API can be used in CDMA network. + /// This API can be used in the CDMA network. /// /// - /// The network ID - /// -1 if unknown + /// The network ID. + /// -1 if unknown. /// public int NetworkId { @@ -748,11 +748,11 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/location.coarse> /// - /// This API can be used in CDMA network. + /// This API can be used in the CDMA network. /// /// - /// The base station ID - /// -1 if unknown + /// The base station ID. + /// -1 if unknown. /// public int BaseStationId @@ -778,11 +778,11 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/location.coarse /// - /// This API can be used in CDMA network. + /// This API can be used in the CDMA network. /// /// - /// The base station latitude - /// 0x7FFFFFFF if unknown + /// The base station latitude. + /// 0x7FFFFFFF if unknown. /// public int BaseStationLatitude { @@ -806,11 +806,11 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/location.coarse /// - /// This API can be used in CDMA network. + /// This API can be used in the CDMA network. /// /// - /// The base station latitude - /// 0x7FFFFFFF if unknown + /// The base station latitude. + /// 0x7FFFFFFF if unknown. /// public int BaseStationLongitude { diff --git a/src/Tizen.Telephony/Tizen.Telephony/Sim.cs b/src/Tizen.Telephony/Tizen.Telephony/Sim.cs index f00383f..afd6828 100644 --- a/src/Tizen.Telephony/Tizen.Telephony/Sim.cs +++ b/src/Tizen.Telephony/Tizen.Telephony/Sim.cs @@ -20,23 +20,23 @@ using static Interop.Telephony; namespace Tizen.Telephony { /// - /// This Class provides API's that allows you to extract information stored on a SIM card + /// This class provides APIs that allow you to extract the information stored on a SIM card. /// public class Sim { internal IntPtr _handle; /// - /// Sim Class Constructor + /// The SIM class constructor. /// /// 3 /// - /// SlotHandle received in the Manager.Init API + /// SlotHandle received in the Manager.Init API. /// /// http://tizen.org/feature/network.telephony /// The required feature is not supported. /// - /// This exception occurs if handle provided is null + /// This exception occurs if the handle provided is null. /// public Sim(SlotHandle handle) { @@ -49,74 +49,74 @@ namespace Tizen.Telephony } /// - /// Enumeration for the state of SIM card. + /// Enumeration for the state of the SIM card. /// public enum State { /// - /// SIM is not available on this device + /// The SIM is not available on this device. /// Unavailable, /// - /// SIM is locked + /// The SIM is locked. /// Locked, /// - /// SIM is available on this device (SIM is not locked) + /// The SIM is available on this device (SIM is not locked). /// Available, /// - /// SIM is in transition between states + /// The SIM is in transition between states. /// Unknown } /// - /// Enumeration for the lock state of SIM card. + /// Enumeration for the lock state of the SIM card. /// public enum LockState { /// - /// SIM is not in lock + /// The SIM is not in lock. /// Unknown, /// - /// SIM is PIN(Personal Identification Number) locked + /// The SIM is PIN (Personal Identification Number) locked. /// PinRequired, /// - /// SIM is PUK(Personal Unblocking Code) locked + /// The SIM is PUK (Personal Unblocking Code) locked. /// PukRequired, /// - /// SIM is permanently blocked(All the attempts for PIN/PUK failed) + /// The SIM is permanently blocked (All the attempts for PIN/PUK failed). /// PermLocked, /// - /// SIM is NCK(Network Control Key) locked + /// The SIM is NCK (Network Control Key) locked. /// NckRequired } /// - /// Enumeration for the type of SIM card. + /// Enumeration for the type of the SIM card. /// public enum ApplicationType { /// - /// SIM(GSM) Application + /// SIM (GSM) application. /// Sim = 0x01, /// - /// USIM Application + /// USIM application. /// Usim = 0x02, /// - /// CDMA Application + /// CDMA application. /// Csim = 0x04, /// - /// ISIM Application + /// ISIM application. /// Isim = 0x08 } @@ -128,11 +128,11 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// The Integrated Circuit Card Identification - /// empty string if unable to complete the operation + /// The Integrated Circuit Card Identification. + /// Empty string if unable to complete the operation. /// /// - /// The SIM state must be Available + /// The SIM state must be Available. /// public string IccId { @@ -157,11 +157,11 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// The SIM Operator - /// empty string if unable to complete the operation + /// The SIM Operator. + /// Empty string if unable to complete the operation. /// /// - /// The SIM state must be Available + /// The SIM state must be Available. /// public string Operator { @@ -185,11 +185,11 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// The Mobile Subscription Identification Number - /// empty string if unable to complete the operation + /// The Mobile Subscription Identification Number. + /// Empty string if unable to complete the operation. /// /// - /// The SIM state must be Available + /// The SIM state must be Available. /// public string Msin { @@ -209,16 +209,16 @@ namespace Tizen.Telephony /// /// Gets the Service Provider Name (SPN) of the SIM card. - /// Gets Service Provider Name embedded in the SIM card.If this value is not stored in SIM card, empty string will be returned. + /// Gets Service Provider Name embedded in the SIM card. If this value is not stored in the SIM card, an empty string will be returned. /// /// 3 /// http://tizen.org/privilege/telephony /// - /// The Service Provider Name - /// empty string if unable to complete the operation + /// The Service Provider Name. + /// Empty string if unable to complete the operation. /// /// - /// The SIM state must be Available + /// The SIM state must be Available. /// public string Spn { @@ -242,10 +242,10 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// true if the current SIM card is different from the previous SIM card, otherwise false if the SIM card is not changed + /// true if the current SIM card is different from the previous SIM card, otherwise false if the SIM card is not changed. /// /// - /// The SIM state must be Available + /// The SIM state must be Available. /// public bool IsChanged { @@ -275,7 +275,7 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// The current state of the SIM + /// The current state of the SIM. /// public State CurrentState { @@ -294,16 +294,16 @@ namespace Tizen.Telephony } /// - /// Gets the count of application on UICC. + /// Gets the count of an application on the UICC. /// /// 3 /// http://tizen.org/privilege/telephony /// - /// The masking value for below values are provided by the enum ApplicationType - /// 0 if unable to complete the operation + /// The masking value for below values are provided by the enumeration ApplicationType. + /// 0 if unable to complete the operation. /// /// - /// The SIM state must be Available + /// The SIM state must be Available. /// public uint ApplicationList { @@ -322,17 +322,17 @@ namespace Tizen.Telephony } /// - /// Gets subscriber number embedded in the SIM card. This value contains MSISDN related to the subscriber. - /// If this value is not stored in SIM card, empty string will be returned. + /// Gets the subscriber number embedded in the SIM card. This value contains the MSISDN related to the subscriber. + /// If this value is not stored in SIM card, an empty string will be returned. /// /// 3 /// http://tizen.org/privilege/telephony /// - /// The subscriber number in the SIM - /// empty string if unable to complete the operation + /// The subscriber number in the SIM. + /// Empty string if unable to complete the operation. /// /// - /// The SIM state must be Available + /// The SIM state must be Available. /// public string SubscriberNumber { @@ -351,16 +351,16 @@ namespace Tizen.Telephony } /// - /// Gets the Subscriber ID. + /// Gets the subscriber ID. /// /// 3 /// http://tizen.org/privilege/telephony /// - /// The subscriber ID - /// empty string if unable to complete the operation + /// The subscriber ID. + /// Empty string if unable to complete the operation. /// /// - /// The SIM state must be Available + /// The SIM state must be Available. /// public string SubscriberId { @@ -384,10 +384,10 @@ namespace Tizen.Telephony /// 3 /// http://tizen.org/privilege/telephony /// - /// The current lock state of the SIM + /// The current lock state of the SIM. /// /// - /// The SIM state must be Available + /// The SIM state must be Available. /// public LockState CurrentLockState { @@ -407,16 +407,16 @@ namespace Tizen.Telephony /// /// Gets the GID1 (Group Identifier Level 1). - /// Gets Group Identifier Level 1(GID1) embedded in the SIM card.If this value is not stored in SIM card, empty string will be returned. + /// Gets Group Identifier Level 1 (GID1) embedded in the SIM card. If this value is not stored in SIM card, an empty string will be returned. /// /// 3 /// http://tizen.org/privilege/telephony /// - /// The GID1 (Group Identifier Level 1) - /// empty string if unable to complete the operation + /// The GID1 (Group Identifier Level 1). + /// Empty string if unable to complete the operation. /// /// - /// The SIM state must be Available + /// The SIM state must be Available. /// public string GroupId1 { @@ -436,15 +436,15 @@ namespace Tizen.Telephony /// /// Gets the call forwarding indicator state of the SIM. - /// If the state is true, incoming call will be forwarded to the selected number.state indicates the CFU(Call Forwarding Unconditional) indicator status - Voice. (3GPP TS 31.102 4.2.64 EF CFIS) + /// If the state is true, the incoming call will be forwarded to the selected number. State indicates the CFU (Call Forwarding Unconditional) indicator status - Voice (3GPP TS 31.102 4.2.64 EF CFIS). /// /// 3 /// http://tizen.org/privilege/telephony /// - /// The value whether incoming call will be forwarded or not. (true: forwarded, false: not forwarded) + /// The value whether the incoming call will be forwarded or not (true: forwarded, false: not forwarded). /// /// - /// The SIM state must be Available + /// The SIM state must be Available. /// public bool CallForwardingIndicatorState { diff --git a/src/Tizen.Telephony/Tizen.Telephony/SlotHandle.cs b/src/Tizen.Telephony/Tizen.Telephony/SlotHandle.cs index 967f781..613b6e0 100644 --- a/src/Tizen.Telephony/Tizen.Telephony/SlotHandle.cs +++ b/src/Tizen.Telephony/Tizen.Telephony/SlotHandle.cs @@ -21,7 +21,7 @@ using System.Runtime.InteropServices; namespace Tizen.Telephony { /// - /// This Class provides API's that provides functionality related to slot handle. + /// This class provides APIs that provide functionality related to the slot handle. /// public class SlotHandle { @@ -34,8 +34,8 @@ namespace Tizen.Telephony } /// - /// Event Handler for Receiving the Telephony State Changes - /// this event will be triggered for the NotificationId's given in the SetNotificationId API + /// The event handler for receiving the Telephony state changes. + /// This event will be triggered for the NotificationIds given in the SetNotificationId API. /// public event EventHandler ChangeNotification; @@ -48,18 +48,18 @@ namespace Tizen.Telephony } /// - /// The Notification Id's for which the ChangeNotification event will be triggered + /// The notification IDs for which the ChangeNotification event will be triggered. /// /// 3 /// - /// The List of Notification Id's for which the ChangeNotification event will be triggered + /// The list of notification IDs for which the ChangeNotification event will be triggered. /// /// http://tizen.org/feature/network.telephony /// The required feature is not supported. /// /// This Exception can occur due to: - /// 1. Operation Not Supported - /// 2. Operation Failed + /// 1. Operation not supported. + /// 2. Operation failed. /// public void SetNotificationId(IEnumerable list) { @@ -78,18 +78,18 @@ namespace Tizen.Telephony } /// - /// The Notification Id's for which the ChangeNotification event will not be triggered + /// The notification IDs for which the ChangeNotification event will not be triggered. /// /// 3 /// - /// The List of Notification Id's for which the ChangeNotification event will be not be triggered + /// The list of notification IDs for which the ChangeNotification event will be not be triggered. /// /// http://tizen.org/feature/network.telephony /// The required feature is not supported. /// /// This Exception can occur due to: - /// 1. Operation Not Supported - /// 2. Operation Failed + /// 1. Operation not supported. + /// 2. Operation failed. /// public void RemoveNotificationId(IEnumerable list) { diff --git a/src/Tizen.Telephony/Tizen.Telephony/StateEventArgs.cs b/src/Tizen.Telephony/Tizen.Telephony/StateEventArgs.cs index a7b4e4c..44b67f5 100644 --- a/src/Tizen.Telephony/Tizen.Telephony/StateEventArgs.cs +++ b/src/Tizen.Telephony/Tizen.Telephony/StateEventArgs.cs @@ -18,7 +18,7 @@ using System; namespace Tizen.Telephony { /// - /// This class contain the data related to the State changed event + /// This class contains the data related to the State changed event. /// public class StateEventArgs : EventArgs { @@ -28,7 +28,7 @@ namespace Tizen.Telephony } /// - /// The Current State + /// The Current State. /// /// 3 public State CurrentState diff --git a/src/Tizen.Telephony/Tizen.Telephony/Telephony.cs b/src/Tizen.Telephony/Tizen.Telephony/Telephony.cs index 203e2c6..d26b7d5 100644 --- a/src/Tizen.Telephony/Tizen.Telephony/Telephony.cs +++ b/src/Tizen.Telephony/Tizen.Telephony/Telephony.cs @@ -22,20 +22,20 @@ using static Interop.Telephony; namespace Tizen.Telephony { /// - /// Enumeration for the telephony state. + /// Enumeration for the telephony states. /// public enum State { /// - /// Telephony state is not ready + /// The telephony state is not ready. /// NotReady, /// - /// Telephony state is ready + /// The telephony state is ready. /// Ready, /// - /// Unavailable + /// Unavailable. /// Unavailable }; @@ -46,30 +46,30 @@ namespace Tizen.Telephony public enum CallPreferredVoiceSubscription { /// - /// Unknown status + /// Unknown status. /// Unknown = -1, /// - /// Current network + /// Current network. /// CurrentNetwork = 0, /// - /// ASK Always + /// Ask Always. /// AskAlways, /// - /// SIM 1 + /// SIM 1. /// Sim1, /// - /// SIM 2 + /// SIM 2. /// Sim2 }; /// - /// This Class provides API's to Initialize and Deinitialize the framework - /// it also provides API's to get the SlotHandle's which can then be used to get other Network/Sim/Call/Modem Information. + /// This class provides APIs to initialize and deinitialize the framework. + /// It also provides APIs to get the SlotHandles, which can then be used to get other Network/Sim/Call/Modem information. /// public static class Manager { @@ -84,7 +84,7 @@ namespace Tizen.Telephony }; /// - /// Event Handler to be invoked when the telephony state changes. + /// The event handler to be invoked when the telephony state changes. /// /// 3 public static event EventHandler StateChanged @@ -145,21 +145,21 @@ namespace Tizen.Telephony } /// - /// Acquires the Number of available handles to use the telephony API. + /// Acquires the number of available handles to use the telephony API. /// /// 3 /// - /// A List of Telephony handles. - /// You will get 2 SlotHandles in case of dual SIM device. - /// where,SlotHandle at Index '0' represents Primary SIM and Index '1' represents Secondary SIM. + /// A list of telephony handles. + /// You will get 2 SlotHandles in case of the dual SIM device. + /// Where, SlotHandle at Index '0' represents the primary SIM and Index '1' represents the secondary SIM. /// /// http://tizen.org/feature/network.telephony /// The required feature is not supported. /// - /// This Exception can will be generated in the following cases - /// 1. System is out of memory - /// 2. If the operation is not supported on device - /// 3. If the Operation Failed + /// This exception will be generated in the following cases: + /// 1. The system is out of memory. + /// 2. If the operation is not supported on the device. + /// 3. If the operation failed. /// public static IEnumerable Init() { @@ -201,9 +201,9 @@ namespace Tizen.Telephony /// http://tizen.org/feature/network.telephony /// The required feature is not supported. /// - /// This Exception can be generated in the following cases - /// 1. If the operation is not supported on device - /// 2. If the Operation Failed + /// This exception can be generated in the following cases: + /// 1. If the operation is not supported on the device. + /// 2. If the operation failed. /// public static void Deinit() { -- 2.7.4