From 2fe192d600b4028dc9e9068ac05a320e746df641 Mon Sep 17 00:00:00 2001
From: Rolf Bjarne Kvinge <rolf@xamarin.com>
Date: Fri, 31 Oct 2025 10:40:39 +0100
Subject: [PATCH 1/2] Improve the docs for
 ObjectiveCMarshal.CreateReferenceTrackingHandle slightly.

---
 .../ObjectiveC/ObjectiveCMarshal.PlatformNotSupported.cs      | 4 ++--
 .../Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.cs   | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.PlatformNotSupported.cs b/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.PlatformNotSupported.cs
index 3215cdb9ffffdd..0deec4271e256f 100644
--- a/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.PlatformNotSupported.cs
+++ b/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.PlatformNotSupported.cs
@@ -70,9 +70,9 @@ public static unsafe void Initialize(
         /// <returns>Reference tracking GC handle.</returns>
         /// <exception cref="InvalidOperationException">Thrown if the ObjectiveCMarshal API has not been initialized.</exception>
         /// <remarks>
-        /// The Initialize() must be called prior to calling this function.
+        /// The <cref="Initialize" /> function must be called prior to calling this function.
         ///
-        /// The <paramref name="obj"/> must have a type in its hierarchy marked with
+        /// The <paramref name="obj"/> parameter must have a type in its hierarchy marked with
         /// <see cref="ObjectiveCTrackedTypeAttribute"/>.
         ///
         /// The "Is Referenced" callback passed to Initialize()
diff --git a/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.cs b/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.cs
index 1f84eb52fd9b11..b3ad3a41a0e2a9 100644
--- a/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.cs
+++ b/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.cs
@@ -84,9 +84,9 @@ public static unsafe void Initialize(
         /// <returns>Reference tracking GC handle.</returns>
         /// <exception cref="InvalidOperationException">Thrown if the ObjectiveCMarshal API has not been initialized.</exception>
         /// <remarks>
-        /// The Initialize() must be called prior to calling this function.
+        /// The <cref="Initialize" /> function must be called prior to calling this function.
         ///
-        /// The <paramref name="obj"/> must have a type in its hierarchy marked with
+        /// The <paramref name="obj"/> parameter must have a type in its hierarchy marked with
         /// <see cref="ObjectiveCTrackedTypeAttribute"/>.
         ///
         /// The "Is Referenced" callback passed to Initialize()

From 939c4d2ec54261bb7f0de80357a053be1bc2ae41 Mon Sep 17 00:00:00 2001
From: Rolf Bjarne Kvinge <rolf@xamarin.com>
Date: Fri, 31 Oct 2025 10:46:09 +0100
Subject: [PATCH 2/2] Fix xml syntax

---
 .../ObjectiveC/ObjectiveCMarshal.PlatformNotSupported.cs        | 2 +-
 .../Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.cs     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.PlatformNotSupported.cs b/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.PlatformNotSupported.cs
index 0deec4271e256f..598be904337a94 100644
--- a/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.PlatformNotSupported.cs
+++ b/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.PlatformNotSupported.cs
@@ -70,7 +70,7 @@ public static unsafe void Initialize(
         /// <returns>Reference tracking GC handle.</returns>
         /// <exception cref="InvalidOperationException">Thrown if the ObjectiveCMarshal API has not been initialized.</exception>
         /// <remarks>
-        /// The <cref="Initialize" /> function must be called prior to calling this function.
+        /// The <see cref="Initialize" /> function must be called prior to calling this function.
         ///
         /// The <paramref name="obj"/> parameter must have a type in its hierarchy marked with
         /// <see cref="ObjectiveCTrackedTypeAttribute"/>.
diff --git a/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.cs b/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.cs
index b3ad3a41a0e2a9..b3b3755014c1b5 100644
--- a/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.cs
+++ b/src/libraries/System.Private.CoreLib/src/System/Runtime/InteropServices/ObjectiveC/ObjectiveCMarshal.cs
@@ -84,7 +84,7 @@ public static unsafe void Initialize(
         /// <returns>Reference tracking GC handle.</returns>
         /// <exception cref="InvalidOperationException">Thrown if the ObjectiveCMarshal API has not been initialized.</exception>
         /// <remarks>
-        /// The <cref="Initialize" /> function must be called prior to calling this function.
+        /// The <see cref="Initialize" /> function must be called prior to calling this function.
         ///
         /// The <paramref name="obj"/> parameter must have a type in its hierarchy marked with
         /// <see cref="ObjectiveCTrackedTypeAttribute"/>.