[System.Information] Elaborate API description
authorYoungjae Cho <y0.cho@samsung.com>
Tue, 24 Sep 2024 08:42:55 +0000 (17:42 +0900)
committerChanwoo Choi <chanwoo@kernel.org>
Fri, 27 Sep 2024 07:44:08 +0000 (16:44 +0900)
Signed-off-by: Youngjae Cho <y0.cho@samsung.com>
src/Tizen.System.Information/Common/Information.cs
src/Tizen.System.Information/Usage/ProcessCpuUsage.cs
src/Tizen.System.Information/Usage/ProcessMemoryUsage.cs
src/Tizen.System.Information/Usage/SystemCpuUsage.cs
src/Tizen.System.Information/Usage/SystemMemoryUsage.cs

index 62a01aaea06ee64da752fdefda3c91f9833a93a4..8ae73edfa6c1766db609789e0593238a55e0914a 100644 (file)
@@ -124,7 +124,7 @@ namespace Tizen.System
 #pragma warning restore CS0618 // Type or member is obsolete
 
         /// <summary>
-        /// Gets the value of the feature.
+        /// Gets the value of the feature. It accepts both system and runtime feature key.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <typeparam name="T">The type of <paramref name="value"/>.</typeparam>
index f42fee9d2ae120a8757ff89f02359f106eeef3f6..53a387772d7b00f3779b56a26ee3a7f16493a00d 100755 (executable)
@@ -23,7 +23,7 @@ using System.Runtime.InteropServices;
 namespace Tizen.System
 {
     /// <summary>
-    /// The class for CPU usage per process.
+    /// The class for CPU usage per given list of process.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
     public class ProcessCpuUsage
@@ -32,7 +32,7 @@ namespace Tizen.System
         private Interop.RuntimeInfo.ProcessCpuUsage[] Usages;
 
         /// <summary>
-        /// The constructor of ProcessCpuUsage class.
+        /// The constructor of ProcessCpuUsage class of the given list of process. It internally call Update() on constructing an instance.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="pid">List of unique process ids.</param>
@@ -47,13 +47,13 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// The number of usage entries.
+        /// The number of processes being tracked by the instance.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int Count { get; internal set; }
 
         /// <summary>
-        /// Gets the amount of time this process has been scheduled in user mode.
+        /// Gets the amount of time this process has been scheduled in user mode. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="pid">The process id.</param>
@@ -71,7 +71,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Gets the amount of time this process has been scheduled in kernel mode.
+        /// Gets the amount of time this process has been scheduled in kernel mode. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="pid">The process id.</param>
@@ -89,7 +89,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Update the process CPU usage to the latest.
+        /// Update CPU usage of the given processes to the latest.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="pid">List of unique process ids.</param>
index 0c4a2a393fecb42594646ba553899a5ff8b533d0..8b1bbeee02f22cad5a75ea7182fb8ed18c8e1462 100755 (executable)
@@ -36,7 +36,7 @@ namespace Tizen.System
         private int[] Gems;
 
         /// <summary>
-        /// The constructor of ProcessMemoryInformation class.
+        /// The constructor of ProcessMemoryInformation class of the given list of process. It internally call Update() on constructing an instance.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="pid">List of unique process ids.</param>
@@ -51,13 +51,13 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// The number of usage entries.
+        /// The number of processes being tracked by the instance.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int Count => Pids.Length;
 
         /// <summary>
-        /// Gets the virtual memory size of a process.
+        /// Gets the virtual memory size of the given process. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="pid">The process id.</param>
@@ -75,7 +75,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Gets the resident set size of a process.
+        /// Gets the resident set size of the given process. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="pid">The process id.</param>
@@ -93,7 +93,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Gets the proportional set size of a process.
+        /// Gets the proportional set size of the given process. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="pid">The process id.</param>
@@ -111,7 +111,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Gets the size not modified and mapped by other processes of a process.
+        /// Gets the memory size of the given process that is not modified and mapped by other processes. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="pid">The process id.</param>
@@ -129,7 +129,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Gets the size modified and mapped by other processes of a process.
+        /// Gets the memory size of the given process that is modified and mapped by other processes. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="pid">The process id.</param>
@@ -147,7 +147,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Gets the size not modified and available only to that process of a process.
+        /// Gets the memory size of the given process that is not modified and available only to it. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="pid">The process id.</param>
@@ -165,7 +165,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Gets the size modified and available only to that process of a process.
+        /// Gets the memory size of the given process that is modified and available only to it. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="pid">The process id.</param>
@@ -183,7 +183,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Gets the GPU memory size of a process.
+        /// Gets the GPU memory size of the given process. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <param name="pid">The process id.</param>
         /// <returns>The GPU memory size <paramref name="pid"/> is using (KiB).</returns>
@@ -208,7 +208,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Gets the resident set size in graphic execution manager of a process.
+        /// Gets the resident set size in graphic execution manager of a process. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <param name="pid">The process id.</param>
         /// <returns>The resident set size <paramref name="pid"/> is using (KiB).</returns>
@@ -233,7 +233,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Gets the SWAP memory size of a process.
+        /// Gets the SWAP memory size of the given process. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <param name="pid">The process id.</param>
         /// <returns>The SWAP memory size <paramref name="pid"/> is using (KiB).</returns>
index a248275ee4ef5fd7764593751139fa99cf515077..76eee812d08db2dd2714d2e38a7ad6bdcd686410 100755 (executable)
@@ -20,7 +20,7 @@ using System.IO;
 namespace Tizen.System
 {
     /// <summary>
-    /// The class for system CPU usage.
+    /// The class for CPU usage information of the system.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class SystemCpuUsage
@@ -30,7 +30,7 @@ namespace Tizen.System
         private int[] MaxFrequencies;
 
         /// <summary>
-        /// The constructor of SystemCpuUsage class.
+        /// The constructor of SystemCpuUsage class. It internally call Update() on constructing an instance.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <exception cref="IOException">Thrown when an I/O error occurs while reading from the system.</exception>
@@ -41,7 +41,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Running time of un-niced user processes (Percent).
+        /// Running time of un-niced user processes (Percent). To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public double User
@@ -53,7 +53,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Running time of kernel processes (Percent).
+        /// Running time of kernel processes (Percent). To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public double System
@@ -65,7 +65,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Running time of niced user processes (Percent).
+        /// Running time of niced user processes (Percent). To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public double Nice
@@ -77,7 +77,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Time waiting for I/O completion (Percent).
+        /// Time waiting for I/O completion (Percent). To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public double IoWait
@@ -95,7 +95,7 @@ namespace Tizen.System
         public int ProcessorCount { get; internal set; }
 
         /// <summary>
-        /// Gets the current frequency of the processor.
+        /// Gets the current frequency of the processor. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="coreId">The index (from 0) of the CPU core that you want to know the frequency of.</param>
@@ -113,7 +113,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Gets the max frequency of the processor.
+        /// Gets the max frequency of the processor. To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <param name="coreId">The index (from 0) of CPU core that you want to know the frequency of.</param>
@@ -131,7 +131,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Update the system CPU usage to the latest.
+        /// Update the system CPU usage information to the latest.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <exception cref="IOException">Thrown when an I/O error occurs while reading from the system.</exception>
index 4819afa8109b08c7f45e2bc30595982168e89f5f..e0c7e715a97cac1cdb3a993f0f231eb275c660bd 100755 (executable)
@@ -19,7 +19,7 @@ using System.IO;
 namespace Tizen.System
 {
     /// <summary>
-    /// The class for system memory information.
+    /// The class for memory usage information of the system.
     /// </summary>
     /// <since_tizen> 4 </since_tizen>
     public class SystemMemoryUsage
@@ -27,7 +27,7 @@ namespace Tizen.System
         private Interop.RuntimeInfo.MemoryInfo Info;
 
         /// <summary>
-        /// The constructor of MemoryInformation class.
+        /// The constructor of MemoryInformation class. It internally call Update() on constructing an instance.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         /// <exception cref="IOException">Thrown when an I/O error occurs while reading from the system.</exception>
@@ -37,7 +37,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Total memory (KiB).
+        /// Total memory (KiB). To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int Total
@@ -49,7 +49,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Used memory (KiB).
+        /// Used memory (KiB). To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int Used
@@ -61,7 +61,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Free memory (KiB).
+        /// Free memory (KiB). To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int Free
@@ -73,7 +73,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Cache memory (KiB).
+        /// Cache memory (KiB). To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int Cache
@@ -85,7 +85,7 @@ namespace Tizen.System
         }
 
         /// <summary>
-        /// Swap memory (KiB).
+        /// Swap memory (KiB). To get the latest value, it is recommended to call Update() before it.
         /// </summary>
         /// <since_tizen> 4 </since_tizen>
         public int Swap