From fab68d2cc9f37d504edf7ff043acb840bf03cd61 Mon Sep 17 00:00:00 2001
From: Wootak Jung <wootak.jung@samsung.com>
Date: Mon, 30 Sep 2024 09:13:38 +0900
Subject: [PATCH] [Bluetooth] Reinforce API documents

Signed-off-by: Wootak Jung <wootak.jung@samsung.com>
---
 .../Tizen.Network.Bluetooth/BluetoothDevice.cs              | 4 ++--
 .../Tizen.Network.Bluetooth/BluetoothGatt.cs                | 6 +++---
 .../Tizen.Network.Bluetooth/BluetoothServerSocket.cs        | 2 +-
 .../Tizen.Network.Bluetooth/BluetoothSocket.cs              | 4 ++--
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothDevice.cs b/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothDevice.cs
index c5ae56d77a4..d08694c521e 100644
--- a/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothDevice.cs
+++ b/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothDevice.cs
@@ -694,7 +694,7 @@ public bool IsProfileConnected(BluetoothProfileType profileType)
         }
 
         /// <summary>
-        /// Returns the instance of the Bluetooth profile type.
+        /// It creates an instance of the specified profile and sets the remote address of the profile.
         /// </summary>
         /// <remarks>
         /// The Bluetooth must be enabled.
@@ -717,7 +717,7 @@ public T GetProfile<T>() where T : BluetoothProfile
         }
 
         /// <summary>
-        /// Creates the client socket.
+        /// Creates a new client socket object for connecting to a Bluetooth server using the specified service UUID.
         /// </summary>
         /// <returns>The IBluetoothClientSocket instance.</returns>
         /// <param name="serviceUuid">The UUID of the service.</param>
diff --git a/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothGatt.cs b/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothGatt.cs
index 5eb7b0ab64c..4b2c03294a5 100644
--- a/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothGatt.cs
+++ b/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothGatt.cs
@@ -674,7 +674,7 @@ internal BluetoothGattService(BluetoothGattServiceImpl impl, string uuid)
         public string Uuid { get; }
 
         /// <summary>
-        /// Adds a characteristic to this service.
+        /// Associates a Bluetooth GATT Characteristic with this GATT Service.
         /// </summary>
         /// <param name="characteristic">The characteristic to be added.</param>
         /// <returns>true on success, false otherwise.</returns>
@@ -718,7 +718,7 @@ public IEnumerable<BluetoothGattCharacteristic> GetCharacteristics()
         }
 
         /// <summary>
-        /// Includes a service to this service.
+        /// Registers a Bluetooth GATT Service within this existing GATT Primary Service.
         /// </summary>
         /// <param name="service">The service to be included.</param>
         /// <returns>true on success, false otherwise</returns>
@@ -997,7 +997,7 @@ internal override BluetoothGattAttributeImpl Impl
         }
 
         /// <summary>
-        /// Adds a descriptor to this characteristic.
+        /// Attaches a Bluetooth GATT Descriptor to this GATT Characteristic.
         /// </summary>
         /// <param name="descriptor">The descriptor to be added.</param>
         /// <returns>true on success, false otherwise.</returns>
diff --git a/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothServerSocket.cs b/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothServerSocket.cs
index 4c78defdeae..3a9f3bc74bd 100644
--- a/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothServerSocket.cs
+++ b/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothServerSocket.cs
@@ -134,7 +134,7 @@ private static void UnregisterAcceptStateChangedEvent()
         }
 
         /// <summary>
-        /// Starts listening on the passed RFCOMM socket and accepts connection requests.
+        /// Initiates the process of accepting incoming connections on a previously created RFCOMM server socket.
         /// </summary>
         /// <remarks>
         /// The socket must be created with CreateServerSocket(). This API invokes the ConnectionStateChanged event.
diff --git a/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothSocket.cs b/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothSocket.cs
index 44d7ba3cc8b..2228d47b5dc 100644
--- a/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothSocket.cs
+++ b/src/Tizen.Network.Bluetooth/Tizen.Network.Bluetooth/BluetoothSocket.cs
@@ -208,7 +208,7 @@ private void UnregisterConnectionStateChangedEvent()
         }
 
         /// <summary>
-        /// Connects to a specific RFCOMM based service on a remote Bluetooth device UUID.
+        /// Establishes a point-to-point communication link with a remote Bluetooth device via an RFCOMM channel identified by the specified UUID.
         /// </summary>
         /// <remarks>
         /// The bluetooth must be enabled, discoverable with StartDiscovery(), and bonded with the remote device using CreateBond(). The ConnectionStateChanged event is raised once this API is called.
@@ -266,7 +266,7 @@ public int SendData(string data)
         }
 
         /// <summary>
-        /// Sends data to the connected device.
+        /// Sends raw binary data to the currently connected Bluetooth device over the established connection.
         /// </summary>
         /// <returns>The number of bytes written (zero indicates nothing was written).</returns>
         /// <remarks>