From 5f12b5cfd8ac27b6846ade6ab742815b168e0543 Mon Sep 17 00:00:00 2001
From: Rolf Bjarne Kvinge <rolf@xamarin.com>
Date: Mon, 21 Apr 2025 16:40:05 +0200
Subject: [PATCH] [CoreBluetooth] Fix nullability in a few
 CBCentralManager.ScanForPeripherals overloads. Fixes #22610.

Also improve documentation a little bit.

Fixes https://github.com/dotnet/macios/issues/22610.
---
 src/CoreBluetooth/GuidWrapper.cs | 35 ++++++++++++++------------------
 1 file changed, 15 insertions(+), 20 deletions(-)

diff --git a/src/CoreBluetooth/GuidWrapper.cs b/src/CoreBluetooth/GuidWrapper.cs
index 8d65d582b6a6..6cc60f6c6399 100644
--- a/src/CoreBluetooth/GuidWrapper.cs
+++ b/src/CoreBluetooth/GuidWrapper.cs
@@ -32,10 +32,9 @@ public void ConnectPeripheral (CBPeripheral peripheral, PeripheralConnectionOpti
 			ConnectPeripheral (peripheral, options?.Dictionary);
 		}
 
-		/// <param name="peripheralUuids">To be added.</param>
-		///         <param name="options">To be added.</param>
-		///         <summary>Scans for peripherals that are advertising any of the specified <paramref name="peripheralUuids" /> with the specified  <paramref name="options" />.</summary>
-		///         <remarks>To be added.</remarks>
+		/// <summary>Scans for peripherals that are advertising any of the specified <paramref name="peripheralUuids" /> with the specified <paramref name="options" />.</summary>
+		/// <param name="peripheralUuids">An array of advertised UUIDs to scan for.</param>
+		/// <param name="options">Any custom options for the scan.</param>
 		public void ScanForPeripherals (CBUUID []? peripheralUuids, NSDictionary? options)
 		{
 			if (peripheralUuids is null)
@@ -44,35 +43,31 @@ public void ScanForPeripherals (CBUUID []? peripheralUuids, NSDictionary? option
 				ScanForPeripherals (NSArray.FromObjects (peripheralUuids), options);
 		}
 
-		/// <param name="peripheralUuids">To be added.</param>
-		///         <param name="options">To be added.</param>
-		///         <summary>Scans for peripherals that are advertising any of the specified <paramref name="peripheralUuids" /> with the specified  <paramref name="options" />.</summary>
-		///         <remarks>To be added.</remarks>
-		public void ScanForPeripherals (CBUUID [] peripheralUuids, PeripheralScanningOptions? options = null)
+		/// <summary>Scans for peripherals that are advertising any of the specified <paramref name="peripheralUuids" /> with the specified <paramref name="options" />.</summary>
+		/// <param name="peripheralUuids">An array of advertised UUIDs to scan for.</param>
+		/// <param name="options">Any custom options for the scan.</param>
+		public void ScanForPeripherals (CBUUID []? peripheralUuids, PeripheralScanningOptions? options = null)
 		{
 			ScanForPeripherals (peripheralUuids, options?.Dictionary);
 		}
 
-		/// <param name="peripheralUuids">To be added.</param>
-		///         <summary>Scans for peripherals that are advertising any of the specified <paramref name="peripheralUuids" />.</summary>
-		///         <remarks>To be added.</remarks>
-		public void ScanForPeripherals (CBUUID [] peripheralUuids)
+		/// <summary>Scans for peripherals that are advertising any of the specified <paramref name="peripheralUuids" />.</summary>
+		/// <param name="peripheralUuids">An array of advertised UUIDs to scan for.</param>
+		public void ScanForPeripherals (CBUUID []? peripheralUuids)
 		{
 			ScanForPeripherals (peripheralUuids, null as NSDictionary);
 		}
 
-		/// <param name="serviceUuid">To be added.</param>
-		///         <param name="options">To be added.</param>
-		///         <summary>Scans for peripherals that are advertising the specified <paramref name="serviceUuid" /> with the specified  <paramref name="options" />.</summary>
-		///         <remarks>To be added.</remarks>
+		/// <summary>Scans for peripherals that are advertising the specified <paramref name="serviceUuid" /> with the specified <paramref name="options" />.</summary>
+		/// <param name="serviceUuid">The advertised UUID to scan for.</param>
+		/// <param name="options">Any custom options for the scan.</param>
 		public void ScanForPeripherals (CBUUID serviceUuid, NSDictionary? options)
 		{
 			ScanForPeripherals (new [] { serviceUuid }, options);
 		}
 
-		/// <param name="serviceUuid">To be added.</param>
-		///         <summary>Scans for peripherals that are advertising the specified <paramref name="serviceUuid" />.</summary>
-		///         <remarks>To be added.</remarks>
+		/// <summary>Scans for peripherals that are advertising the specified <paramref name="serviceUuid" />.</summary>
+		/// <param name="serviceUuid">The advertised UUID to scan for.</param>
 		public void ScanForPeripherals (CBUUID serviceUuid)
 		{
 			ScanForPeripherals (new [] { serviceUuid }, null as NSDictionary);