From bf33602c3e0a4ae490ce0cd2d7890422bb31ef2b Mon Sep 17 00:00:00 2001
From: Rui Marinho <me@ruimarinho.net>
Date: Mon, 18 May 2026 13:01:37 +0200
Subject: [PATCH 1/2] Enable GenerateDocumentationFile for XML IntelliSense
 docs

Add GenerateDocumentationFile to the main PropertyGroup so the NuGet
package ships Xamarin.Apple.Tools.MaciOS.xml alongside the assembly.
This unlocks IntelliSense for all ~20 already-documented public types.

Suppress CS1591 (missing XML comment) and CS1574 (broken cref) to avoid
build failures for legacy undocumented files and PlatformAvailability.cs
references.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 Xamarin.MacDev/Xamarin.MacDev.csproj | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Xamarin.MacDev/Xamarin.MacDev.csproj b/Xamarin.MacDev/Xamarin.MacDev.csproj
index 30f6fb0..46dd311 100644
--- a/Xamarin.MacDev/Xamarin.MacDev.csproj
+++ b/Xamarin.MacDev/Xamarin.MacDev.csproj
@@ -7,6 +7,8 @@
     <LangVersion>latest</LangVersion>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
     <Nullable>enable</Nullable>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);CS1591;CS1574</NoWarn>
     <IsPackable>true</IsPackable>
   </PropertyGroup>
 

From 474ffde66f28e0a46bfa5eff5eeddd94a3f44561 Mon Sep 17 00:00:00 2001
From: Rui Marinho <me@ruimarinho.net>
Date: Tue, 2 Jun 2026 00:51:34 +0100
Subject: [PATCH 2/2] Fix broken cref references instead of suppressing CS1574

Replace broken <see cref> references to non-existent types
(MonoDevelop.MacDev.PlatformVersion, ObjCRuntime.Platform) with
<c> inline code tags. This removes the CS1574 suppression so
future broken doc references are caught at build time.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 Xamarin.MacDev/PlatformAvailability.cs | 4 ++--
 Xamarin.MacDev/Xamarin.MacDev.csproj   | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Xamarin.MacDev/PlatformAvailability.cs b/Xamarin.MacDev/PlatformAvailability.cs
index a41c743..85b68dc 100644
--- a/Xamarin.MacDev/PlatformAvailability.cs
+++ b/Xamarin.MacDev/PlatformAvailability.cs
@@ -207,8 +207,8 @@ public PlatformSet ()
 		}
 
 		/// <summary>
-		/// Initialize a <see cref="MonoDevelop.MacDev.PlatformVersion"/> struct with
-		/// version information encoded as a value of <see cref="ObjCRuntime.Platform"/>
+		/// Initialize a <c>PlatformVersion</c> struct with
+		/// version information encoded as a value of the <c>ObjCRuntime.Platform</c>
 		/// enum. For example (ulong)(Platform.iOS_8_0 | Platform.Mac_10_10).
 		/// </summary>
 		/// <param name="platformEncoding">Should have the bit format AAJJNNSSAAJJNNSS, where
diff --git a/Xamarin.MacDev/Xamarin.MacDev.csproj b/Xamarin.MacDev/Xamarin.MacDev.csproj
index 46dd311..a558eac 100644
--- a/Xamarin.MacDev/Xamarin.MacDev.csproj
+++ b/Xamarin.MacDev/Xamarin.MacDev.csproj
@@ -8,7 +8,7 @@
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
     <Nullable>enable</Nullable>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
-    <NoWarn>$(NoWarn);CS1591;CS1574</NoWarn>
+    <NoWarn>$(NoWarn);CS1591</NoWarn>
     <IsPackable>true</IsPackable>
   </PropertyGroup>