From: Yunhee Seo <yuni.seo@samsung.com>
Date: Thu, 10 Oct 2024 06:30:04 +0000 (+0900)
Subject: [Tizen.System.Device] Enhance API description
X-Git-Tag: submit/tizen/20241010.110118~1^2~10
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=88d68516d12a7c51ec93111f2f419c32987f605a;p=platform%2Fcore%2Fcsapi%2Ftizenfx.git

[Tizen.System.Device] Enhance API description

Add more detailed APIs description.

Signed-off-by: Yunhee Seo <yuni.seo@samsung.com>
---

diff --git a/src/Tizen.System/Device/Battery.cs b/src/Tizen.System/Device/Battery.cs
index 79627db05..94bc5bbc5 100755
--- a/src/Tizen.System/Device/Battery.cs
+++ b/src/Tizen.System/Device/Battery.cs
@@ -76,11 +76,20 @@ namespace Tizen.System
     {
         private static readonly object s_lock = new object();
         /// <summary>
-        /// Gets the battery charge percentage.
+        /// Gets the current device's invalid battery charge percentage as an interger value.
         /// </summary>
+        /// <remarks>
+        /// It returns an integer value from 0 to 100 that indicates remaining battery charge as a percentage of the maximum level.
+        /// </remarks>
         /// <since_tizen> 3 </since_tizen>
         /// <value>It returns an integer value from 0 to 100 that indicates the remaining
         /// battery charge as a percentage of the maximum level.</value>
+        /// <example>
+        /// <code>
+        /// Console.WriteLine("battery Percent is: {0}", Tizen.System.Battery.Percent);
+        /// </code>
+        /// </example>
+        /// <seealso cref="BatteryPercentChangedEventArgs"/>
         public static int Percent
         {
             get
@@ -95,9 +104,25 @@ namespace Tizen.System
             }
         }
         /// <summary>
-        /// Gets the current battery level.
+        /// Gets the current device's battery level status as a BatteryLevelStatus.
         /// </summary>
+        /// <remarks>
+        /// Retrieves the current battery level status based on remaining battery capacity.
+        /// </remarks>
         /// <since_tizen> 3 </since_tizen>
+        /// <value>The battery level status.</value>
+        /// <example>
+        /// <code>
+        /// using Tizen.System;
+        /// ...
+        /// BatteryLevelStatus status = Battery.Level;
+        /// if (Battery.Percent == 0 && status == BatteryLevelStatus.Empty)
+        ///     ...
+        /// ...
+        /// </code>
+        /// </example>
+        /// <seealso cref="BatteryLevelStatus"/>
+        /// <seealso cref="BatteryLevelChangedEventArgs"/>
         public static BatteryLevelStatus Level
         {
             get
@@ -112,9 +137,20 @@ namespace Tizen.System
             }
         }
         /// <summary>
-        /// Gets the current charging state.
+        /// Gets the current device's charging state which the battery is charging.
         /// </summary>
+        /// <remarks>
+        /// Checks whether the battery is currently being charged or not.
+        /// </remarks>
         /// <since_tizen> 3 </since_tizen>
+        /// <example>
+        /// <code>
+        /// using Tizen.System;
+        /// bool charging = Battery.IsCharging;
+        /// ...
+        /// </code>
+        /// </example>
+        /// <seealso cref="BatteryChargingStateChangedEventArgs"/>
         public static bool IsCharging
         {
             get
diff --git a/src/Tizen.System/Device/Display.cs b/src/Tizen.System/Device/Display.cs
index 533669d88..3a6962a78 100644
--- a/src/Tizen.System/Device/Display.cs
+++ b/src/Tizen.System/Device/Display.cs
@@ -75,9 +75,21 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// The number of available display devices.
+        /// The number of available display devices connected to current device.
         /// </summary>
+        /// <remarks>
+        /// Retrieves the number of display devices connected to the system.
+        /// </remarks>
         /// <since_tizen> 3 </since_tizen>
+        /// <example>
+        /// <code>
+        /// using Tizen.System;
+        /// ...
+        /// Console.WriteLine("Total number of Displays are: {0}", Display.NumberOfDisplays);
+        /// </code>
+        /// </example>
+        /// <seealso cref="Display.MaxBrightness"/>
+        /// <seealso cref="Display.Brightness"/>
         public static int NumberOfDisplays
         {
             get
@@ -120,6 +132,9 @@ namespace Tizen.System
         /// <summary>
         /// The maximum brightness value that can be set for the specific display.
         /// </summary>
+        /// <remarks>
+        /// Retrieves the maximum brightness level of a specific display device.
+        /// </remarks>
         /// <since_tizen> 3 </since_tizen>
         /// <example>
         /// <code>
@@ -142,7 +157,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// The brightness value of the display.
+        /// The brightness value of the specific display device.
         /// </summary>
         /// <remarks>
         /// The brightness value should be less than or equal to the MaxBrightness value.
@@ -150,12 +165,15 @@ namespace Tizen.System
         /// <since_tizen> 3 </since_tizen>
         /// <exception cref="ArgumentException">When an invalid parameter value is set.</exception>
         /// <exception cref="UnauthorizedAccessException">If the privilege is not set.</exception>
+        /// <exception cref="InvalidOperationException">In case of any system error.</exception>
+        /// <exception cref="NotSupportedException">This exception can be due to device not supported.</exception>
         /// <example>
         /// <code>
         ///     Display display = Display.Displays[0];
         ///     Console.WriteLine("Display current Brightness is: {0}", display.Brightness);
         /// </code>
         /// </example>
+        /// <seealso cref="Display.MaxBrightness"/>
         public int Brightness
         {
             get
@@ -179,9 +197,27 @@ namespace Tizen.System
             }
         }
         /// <summary>
-        /// The current device display state.
+        /// The current device display state, including normal, dim, and off states.
         /// </summary>
+        /// <remarks>
+        /// When the display state is set, it should be checked the profile version and supported display state.
+        /// </remarks>
         /// <since_tizen> 3 </since_tizen>
+        /// <example>
+        /// <code>
+        /// using Tizen.System;
+        /// ...
+        /// DisplayState current = Display.State;
+        /// Console.WriteLine("Display current state is: {0}", current);
+        /// ...
+        /// Display.State = DisplayState.Normal;
+        /// ...
+        /// </code>
+        /// </example>
+        /// <seealso cref="Power.RequestLock"/>
+        /// <seealso cref="Power.ReleaseLock"/>
+        /// <seealso cref="DisplayState"/>
+        /// <seealso cref="DisplayStateChangedEventArgs"/>
         public static DisplayState State
         {
             get
@@ -218,7 +254,7 @@ namespace Tizen.System
         ///     {
         ///          Console.WriteLine("Display State is: {0}", args.State);
         ///     }
-        ///     Battery.StateChanged += handler;
+        ///     Display.StateChanged += handler;
         ///     await Task.Delay(20000);
         /// }
         /// </code>
diff --git a/src/Tizen.System/Device/Haptic.cs b/src/Tizen.System/Device/Haptic.cs
index 42d86cddb..c196445c1 100755
--- a/src/Tizen.System/Device/Haptic.cs
+++ b/src/Tizen.System/Device/Haptic.cs
@@ -73,9 +73,20 @@ namespace Tizen.System
             Dispose(false);
         }
         /// <summary>
-        /// Gets the number of the available vibrators.
+        /// Gets the number of the available vibrators available on the current device.
         /// </summary>
+        /// <remarks>
+        /// Retrieves the total number of vibrators available on the device.
+        /// </remarks>
         /// <since_tizen> 3 </since_tizen>
+        /// <example>
+        /// <code>
+        /// using Tizen.System;
+        /// ...
+        /// Console.WriteLine("Total number of Vibrators are: {0}", Vibrator.NumberOfVibrators);
+        /// ...
+        /// </code>
+        /// </example>
         public static int NumberOfVibrators
         {
             get
@@ -121,6 +132,9 @@ namespace Tizen.System
         /// Vibrates during the specified time with a constant intensity.
         /// This function can be used to start monotonous vibration for the specified time.
         /// </summary>
+        /// <remarks>
+        /// To prevent unexpected sleep (suspend) during vibration, please check and use Power module.
+        /// </remarks>
         /// <since_tizen> 3 </since_tizen>
         /// <param name="duration">The play duration in milliseconds.</param>
         /// <param name="feedback">The amount of the intensity variation (0 ~ 100).</param>
@@ -143,7 +157,8 @@ namespace Tizen.System
         ///     }
         /// </code>
         /// </example>
-
+        /// <seealso cref="Vibrator.Stop()"/>
+        /// <seealso cref="Vibrator.Dispose()"/>
         public void Vibrate(int duration, int feedback)
         {
             IntPtr effect;
@@ -187,6 +202,7 @@ namespace Tizen.System
         ///     }
         /// </code>
         /// </example>
+        /// <seealso cref="Vibrator.Vibrate(int,int)"/>
         public void Stop()
         {
             if (_hapticHandle != IntPtr.Zero)
@@ -202,7 +218,22 @@ namespace Tizen.System
         /// Dispose API for closing the internal resources.
         /// This function can be used to stop all the effects started by Vibrate().
         /// </summary>
+        /// <remarks>
+        /// Internally, it disconnects the connection to the vibrator by Vibrate().
+        /// </remarks>
         /// <since_tizen> 3 </since_tizen>
+        /// <example>
+        /// <code>
+        /// using Tizen.System;
+        /// ...
+        /// Vibrator vibrator = Vibrator.Vibrators[0];
+        /// vibrator.Vibrate(2000, 70);
+        /// ...
+        /// vibrator.Stop();
+        /// vibrator.Dispose(); 
+        /// </code>
+        /// </example>
+        /// <seealso cref="Vibrator.Vibrate(int,int)"/>
         public void Dispose()
         {
             Dispose(true);
diff --git a/src/Tizen.System/Device/IR.cs b/src/Tizen.System/Device/IR.cs
index 67b027462..fd9f59a2a 100755
--- a/src/Tizen.System/Device/IR.cs
+++ b/src/Tizen.System/Device/IR.cs
@@ -38,7 +38,18 @@ namespace Tizen.System
         /// <summary>
         /// Gets the information whether the IR module is available.
         /// </summary>
+        /// <remarks>
+        /// Gets the boolean value whether the IR module is available on the device.
+        /// </remarks>
         /// <since_tizen> 3 </since_tizen>
+        /// <value>true if the IR module is available, otherwise false.</value>
+        /// <example>
+        /// <code>
+        /// using Tizen.System;
+        /// ...
+        /// Console.WriteLine("IR availability for this device is: {0}", IR.IsAvailable);
+        /// </code>
+        /// </example>
         public static bool IsAvailable
         {
             get
@@ -54,7 +65,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Transmits the IR command.
+        /// Transmits IR command with the specified carrier frequency and pattern.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
         /// <param name="carrierFreequency">
@@ -81,6 +92,7 @@ namespace Tizen.System
         ///    }
         /// </code>
         /// </example>
+        /// <seealso cref="IR.IsAvailable"/>
         public static void Transmit(int carrierFreequency, IList<int> pattern)
         {
             int[] patternArray = pattern.ToArray();
diff --git a/src/Tizen.System/Device/Led.cs b/src/Tizen.System/Device/Led.cs
index 5f100e761..f853a891a 100755
--- a/src/Tizen.System/Device/Led.cs
+++ b/src/Tizen.System/Device/Led.cs
@@ -46,10 +46,20 @@ namespace Tizen.System
         /// <summary>
         /// Gets the maximum brightness value of the LED that is located next to the camera.
         /// </summary>
+        /// <remarks>
+        /// Retrieves the maximum brightness level of the back camera flash.
+        /// </remarks>
         /// <since_tizen> 3 </since_tizen>
         /// <exception cref="ArgumentException">When an invalid parameter value is set.</exception>
         /// <exception cref="UnauthorizedAccessException">If the privilege is not set.</exception>
         /// <exception cref="NotSupportedException">In case the device does not support this behavior.</exception>
+        /// <example>
+        /// <code>
+        /// using Tizen.System;
+        /// ...
+        /// Console.WriteLine("Led MaxBrightness is: {0}", Led.MaxBrightness);
+        /// </code>
+        /// </example>
         public static int MaxBrightness
         {
             get
@@ -107,7 +117,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Plays the LED that is located at the front of the device.
+        /// Plays the custom effect of the service LED that is located to the front of a device.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
         /// <param name="on">Turn on time in milliseconds.</param>
@@ -131,6 +141,7 @@ namespace Tizen.System
         ///     }
         /// </code>
         /// </example>
+        /// <seealso cref="Led.Stop()"/>
         public static void Play(int on, int off, Color color)
         {
             //looks like only blink option is supported. So hard coded to default blink option.
@@ -142,8 +153,11 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Stops the LED that is located at the front of the device.
+        /// Stops the custom effect of the service LED that is located to the front of a device.
         /// </summary>
+        /// <remarks>
+        /// The custom effect was started by Led.Play(int,int,Color).
+        /// </remarks>
         /// <since_tizen> 3 </since_tizen>
         /// <exception cref="UnauthorizedAccessException">If the privilege is not set.</exception>
         /// <exception cref="InvalidOperationException">In case of any system error.</exception>
@@ -161,7 +175,7 @@ namespace Tizen.System
         ///     }
         /// </code>
         /// </example>
-
+        /// <seealso cref="Led.Play(int,int,Color)"/>
         public static void Stop()
         {
             DeviceError res = (DeviceError)Interop.Device.DeviceLedStopCustom();
@@ -177,6 +191,20 @@ namespace Tizen.System
         /// StateChanged is raised when the LED state is changed.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        /// <example>
+        /// <code>
+        /// public static async Task LedEventHandler()
+        /// {
+        ///     EventHandler&lt;LedBrightnessChangedEventArgs&gt; handler = null;
+        ///     handler = (object sender, LedBrightnessChangedEventArgs args) =>
+        ///     {
+        ///          Console.WriteLine("battery Level is: {0}", args.Brightness);
+        ///     }
+        ///     Led.BrightnessChanged += handler;
+        ///     await Task.Delay(20000);
+        /// }
+        /// </code>
+        /// </example>
         public static event EventHandler<LedBrightnessChangedEventArgs> BrightnessChanged
         {
             add
diff --git a/src/Tizen.System/Device/PerformanceController.cs b/src/Tizen.System/Device/PerformanceController.cs
index 88206eb5e..684f1f73d 100644
--- a/src/Tizen.System/Device/PerformanceController.cs
+++ b/src/Tizen.System/Device/PerformanceController.cs
@@ -44,6 +44,10 @@ namespace Tizen.System
         /// <summary>
         /// Increase the cpu clock within timeout.
         /// </summary>
+        /// <remarks>
+        /// The timeout parameter specifies the duration of the CPU boost in milliseconds.
+        /// If the timeout value exceeds 3000 milliseconds, it will automatically be set to 3000 milliseconds.
+        /// </remarks>
         /// <param name="type">Performance Control Type</param>
         /// <param name="timeout">Cpu clock increasing duration in milliseconds.</param>
         /// <exception cref="ArgumentException">When an invalid parameter value is set.</exception>
diff --git a/src/Tizen.System/Device/Power.cs b/src/Tizen.System/Device/Power.cs
index 7c194a03f..bb770b139 100644
--- a/src/Tizen.System/Device/Power.cs
+++ b/src/Tizen.System/Device/Power.cs
@@ -362,6 +362,9 @@ namespace Tizen.System
         /// <remarks>
         /// If the process dies, then every lock will be removed.
         /// </remarks>
+        /// <privilege>
+        /// http://tizen.org/privilege/display.state
+        /// </privilege>
         /// <since_tizen> 5 </since_tizen>
         /// <param name="type">
         /// The power type to request lock.
@@ -378,6 +381,8 @@ namespace Tizen.System
         /// Tizen.System.Power.RequestLock(Tizen.System.Power.PowerLock.Cpu, 2000);
         /// </code>
         /// </example>
+        /// <seealso cref="Power.ReleaseLock(PowerLock)"/>
+        /// <seealso cref="PowerLock"/>
         public static void RequestLock(PowerLock type, int timeout)
         {
             DeviceError res = (DeviceError)Interop.Device.DevicePowerRequestLock((Interop.Device.PowerLock)type, timeout);
@@ -387,8 +392,14 @@ namespace Tizen.System
             }
         }
         /// <summary>
-        /// Releases the lock state.
+        /// Releases the given specific power lock type which was locked before.
         /// </summary>
+        /// <remarks>
+        /// Releases the lock of specific power lock type that was previously acquired using Power.RequestLock(PowerLock,int).
+        /// </remarks>
+        /// <privilege>
+        /// http://tizen.org/privilege/display.state
+        /// </privilege>
         /// <since_tizen> 5 </since_tizen>
         /// <param name="type">
         /// The power type to request lock.
@@ -401,6 +412,8 @@ namespace Tizen.System
         /// Tizen.System.Power.ReleaseLock(Tizen.System.Power.PowerLock.Cpu);
         /// </code>
         /// </example>
+        /// <seealso cref="Power.RequestLock(PowerLock,int)"/>
+        /// <seealso cref="PowerLock"/>
         public static void ReleaseLock(PowerLock type)
         {
             DeviceError res = (DeviceError)Interop.Device.DevicePowerReleaseLock((Interop.Device.PowerLock)type);
@@ -410,8 +423,11 @@ namespace Tizen.System
             }
         }
         /// <summary>
-        /// Power off the device.
+        /// Requests the current device's power state change to be changed to powered off.
         /// </summary>
+        /// <remarks>
+        /// It operates synchronously and powers off the current device.
+        /// </remarks>
         /// <privilege>http://tizen.org/privilege/reboot</privilege>
         /// <privlevel>platform</privlevel>
         /// <exception cref="UnauthorizedAccessException">If the privilege is not set.</exception>
@@ -421,6 +437,7 @@ namespace Tizen.System
         /// Tizen.System.Power.PowerOff();
         /// </code>
         /// </example>
+        /// <since_tizen> 9 </since_tizen>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static void PowerOff()
         {
@@ -431,8 +448,11 @@ namespace Tizen.System
             }
         }
         /// <summary>
-        /// Reboot the device.
+        /// Sends a request to the deviced Rebooting the current device.
         /// </summary>
+        /// <remarks>
+        /// It operates asynchronously.
+        /// </remarks>
         /// <privilege>http://tizen.org/privilege/reboot</privilege>
         /// <privlevel>platform</privlevel>
         /// <exception cref="UnauthorizedAccessException">If the privilege is not set.</exception>
@@ -442,6 +462,8 @@ namespace Tizen.System
         /// Tizen.System.Power.Reboot(null);
         /// </code>
         /// </example>
+        /// <seealso cref="Power.CheckRebootAllowed()"/> 
+        /// <since_tizen> 9 </since_tizen>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static void Reboot(string reason)
         {
@@ -472,6 +494,9 @@ namespace Tizen.System
         /// }
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateWaitEventArgs"/>
+        /// <seealso cref="PowerTransientStateWaitEventArgs"/>
+        /// <seealso cref="Power.CancelWaitCallback(UInt64)"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static void ConfirmWaitCallback(UInt64 wait_callback_id)
         {
@@ -508,6 +533,9 @@ namespace Tizen.System
         /// }
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateWaitEventArgs"/>
+        /// <seealso cref="PowerTransientStateWaitEventArgs"/>
+        /// <seealso cref="Power.ConfirmWaitCallback(UInt64)"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static void CancelWaitCallback(UInt64 wait_callback_id)
         {
@@ -555,6 +583,8 @@ namespace Tizen.System
         ///
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateChangeRequestEventArgs"/>
+        /// <seealso cref="PowerState"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static void ChangeState(PowerState state, int timeout_sec)
         {
@@ -590,7 +620,7 @@ namespace Tizen.System
 
         #if !PROFILE_TV
         /// <summary>
-        /// Get wakeup reason.
+        /// Gets the reason for the last device wakeup based on the scenario.
         /// </summary>
         /// <remarks>
         /// This api is not supported at TV profile.
@@ -603,6 +633,7 @@ namespace Tizen.System
         /// PowerTransitionReason transition_reason = Power.GetWakeupReason();
         /// </code>
         /// </example>
+        /// <seealso cref="PowerTransitionReason"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static PowerTransitionReason GetWakeupReason()
         {
@@ -627,8 +658,11 @@ namespace Tizen.System
         #endif
 
         /// <summary>
-        /// Gets the status of power lock.
+        /// Gets the status of power lock is locked or not based on specific power lock type.
         /// </summary>
+        /// <remarks>
+        /// Retrieves the status of a power lock.
+        /// </remarks>
         /// <since_tizen> 10 </since_tizen>
         /// <param name="type"> Type of power lock. </param>
         /// <exception cref="ArgumentException">When an invalid parameter value is set.</exception>
@@ -638,6 +672,8 @@ namespace Tizen.System
         /// PowerLockState lock_state = Power.GetLockState(PowerLock.Cpu);
         /// </code>
         /// </example>
+        /// <seealso cref="PowerLock"/>
+        /// <seealso cref="PowerLockState"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static PowerLockState GetLockState(PowerLock type)
         {
@@ -672,6 +708,7 @@ namespace Tizen.System
         /// Power.StartStateChangeRequestCallback += PowerStateChangeRequestCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateChangeRequestEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerStateChangeRequestEventArgs> StartStateChangeRequestCallback
         {
@@ -738,6 +775,7 @@ namespace Tizen.System
         /// Power.SleepStateChangeRequestCallback += PowerStateChangeRequestCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateChangeRequestEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerStateChangeRequestEventArgs> SleepStateChangeRequestCallback
         {
@@ -772,6 +810,7 @@ namespace Tizen.System
         /// Power.PoweroffStateChangeRequestCallback += PowerStateChangeRequestCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateChangeRequestEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerStateChangeRequestEventArgs> PoweroffStateChangeRequestCallback
         {
@@ -805,6 +844,7 @@ namespace Tizen.System
         /// Power.RebootStateChangeRequestCallback += PowerStateChangeRequestCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateChangeRequestEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerStateChangeRequestEventArgs> RebootStateChangeRequestCallback
         {
@@ -838,6 +878,7 @@ namespace Tizen.System
         /// Power.ExitStateChangeRequestCallback += PowerStateChangeRequestCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateChangeRequestEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerStateChangeRequestEventArgs> ExitStateChangeRequestCallback
         {
@@ -977,6 +1018,7 @@ namespace Tizen.System
         /// Power.StartStateWaitCallback += PowerStateWaitCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateWaitEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerStateWaitEventArgs> StartStateWaitCallback
         {
@@ -1020,6 +1062,7 @@ namespace Tizen.System
         /// Power.NormalStateWaitCallback += PowerStateWaitCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateWaitEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerStateWaitEventArgs> NormalStateWaitCallback
         {
@@ -1063,6 +1106,7 @@ namespace Tizen.System
         /// Power.SleepStateWaitCallback += PowerStateWaitCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateWaitEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerStateWaitEventArgs> SleepStateWaitCallback
         {
@@ -1107,6 +1151,7 @@ namespace Tizen.System
         /// Power.PoweroffStateWaitCallback += PowerStateWaitCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateWaitEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerStateWaitEventArgs> PoweroffStateWaitCallback
         {
@@ -1150,6 +1195,7 @@ namespace Tizen.System
         /// Power.RebootStateWaitCallback += PowerStateWaitCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateWaitEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerStateWaitEventArgs> RebootStateWaitCallback
         {
@@ -1193,6 +1239,7 @@ namespace Tizen.System
         /// Power.ExitStateWaitCallback += PowerStateWaitCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerStateWaitEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerStateWaitEventArgs> ExitStateWaitCallback
         {
@@ -1367,6 +1414,7 @@ namespace Tizen.System
         /// Power.TransientResumingEarlyStateWaitCallback += PowerTransientStateWaitCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerTransientStateWaitEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerTransientStateWaitEventArgs> TransientResumingEarlyStateWaitCallback
         {
@@ -1409,6 +1457,7 @@ namespace Tizen.System
         /// Power.TransientResumingStateWaitCallback += PowerTransientStateWaitCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerTransientStateWaitEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerTransientStateWaitEventArgs> TransientResumingStateWaitCallback
         {
@@ -1451,6 +1500,7 @@ namespace Tizen.System
         /// Power.TransientResumingLateStateWaitCallback += PowerTransientStateWaitCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerTransientStateWaitEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerTransientStateWaitEventArgs> TransientResumingLateStateWaitCallback
         {
@@ -1493,6 +1543,7 @@ namespace Tizen.System
         /// Power.TransientSuspendingEarlyStateWaitCallback += PowerTransientStateWaitCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerTransientStateWaitEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerTransientStateWaitEventArgs> TransientSuspendingEarlyStateWaitCallback
         {
@@ -1535,6 +1586,7 @@ namespace Tizen.System
         /// Power.TransientSuspendingStateWaitCallback += PowerTransientStateWaitCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerTransientStateWaitEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerTransientStateWaitEventArgs> TransientSuspendingStateWaitCallback
         {
@@ -1577,6 +1629,7 @@ namespace Tizen.System
         /// Power.TransientSuspendingLateStateWaitCallback += PowerTransientStateWaitCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerTransientStateWaitEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerTransientStateWaitEventArgs> TransientSuspendingLateStateWaitCallback
         {
@@ -1744,6 +1797,7 @@ namespace Tizen.System
         /// Power.CpuLockStateChangedCallback += PowerLockStateChangeCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerLockStateChangedEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerLockStateChangedEventArgs> CpuLockStateChangedCallback
         {
@@ -1785,6 +1839,7 @@ namespace Tizen.System
         /// Power.DisplayNormalLockStateChangedCallback += PowerLockStateChangeCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerLockStateChangedEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerLockStateChangedEventArgs> DisplayNormalLockStateChangedCallback
         {
@@ -1826,6 +1881,7 @@ namespace Tizen.System
         /// Power.DisplayDimLockStateChangedCallback += PowerLockStateChangeCallback;
         /// </code>
         /// </example>
+        /// <seealso cref="PowerLockStateChangedEventArgs"/>
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static event EventHandler<PowerLockStateChangedEventArgs> DisplayDimLockStateChangedCallback
         {