From f38ca58fb7204ef0a99e211ffd20b4919aeb4f98 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 11 Feb 2026 22:24:45 +0000
Subject: [PATCH] Add MSBuild targets to projects for XML doc generation

Co-authored-by: omegaleo <5655201+omegaleo@users.noreply.github.com>
---
 .../OmegaLeo.HelperLib.Changelog.csproj        | 16 ++++++++++++++++
 .../OmegaLeo.HelperLib.Documentation.csproj    | 16 ++++++++++++++++
 .../OmegaLeo.HelperLib.Game.csproj             | 16 ++++++++++++++++
 .../OmegaLeo.HelperLib.Shared.csproj           | 16 ++++++++++++++++
 OmegaLeo.HelperLib/OmegaLeo.HelperLib.csproj   | 18 ++++++++++++++++++
 5 files changed, 82 insertions(+)

diff --git a/OmegaLeo.HelperLib.Changelog/OmegaLeo.HelperLib.Changelog.csproj b/OmegaLeo.HelperLib.Changelog/OmegaLeo.HelperLib.Changelog.csproj
index 1ae4e34..261bdc0 100755
--- a/OmegaLeo.HelperLib.Changelog/OmegaLeo.HelperLib.Changelog.csproj
+++ b/OmegaLeo.HelperLib.Changelog/OmegaLeo.HelperLib.Changelog.csproj
@@ -38,4 +38,20 @@
       <ProjectReference Include="..\OmegaLeo.HelperLib.Shared\OmegaLeo.HelperLib.Shared.csproj" />
     </ItemGroup>
 
+    <!-- Post-build target to generate XML documentation from DocumentationAttribute -->
+    <Target Name="GenerateXmlDocFromAttributes" AfterTargets="Build">
+        <PropertyGroup>
+            <XmlDocGenExe>$(MSBuildThisFileDirectory)../OmegaLeo.HelperLib.XmlDocGenerator/bin/$(Configuration)/net8.0/OmegaLeo.HelperLib.XmlDocGenerator.dll</XmlDocGenExe>
+            <TargetAssembly>$(TargetDir)$(TargetFileName)</TargetAssembly>
+            <TargetXmlDoc>$(TargetDir)$(TargetName).xml</TargetXmlDoc>
+        </PropertyGroup>
+        
+        <Message Text="[DocumentationAttribute] Augmenting XML documentation for $(TargetName) from DocumentationAttribute" Importance="high" Condition="Exists('$(XmlDocGenExe)') And Exists('$(TargetAssembly)')" />
+        
+        <Exec Command="dotnet &quot;$(XmlDocGenExe)&quot; &quot;$(TargetAssembly)&quot; &quot;$(TargetXmlDoc)&quot;"
+              Condition="Exists('$(XmlDocGenExe)') And Exists('$(TargetAssembly)')"
+              IgnoreExitCode="true"
+              ContinueOnError="true" />
+    </Target>
+
 </Project>
diff --git a/OmegaLeo.HelperLib.Documentation/OmegaLeo.HelperLib.Documentation.csproj b/OmegaLeo.HelperLib.Documentation/OmegaLeo.HelperLib.Documentation.csproj
index 892da6c..5147b2b 100755
--- a/OmegaLeo.HelperLib.Documentation/OmegaLeo.HelperLib.Documentation.csproj
+++ b/OmegaLeo.HelperLib.Documentation/OmegaLeo.HelperLib.Documentation.csproj
@@ -36,4 +36,20 @@
       </None>
     </ItemGroup>
 
+    <!-- Post-build target to generate XML documentation from DocumentationAttribute -->
+    <Target Name="GenerateXmlDocFromAttributes" AfterTargets="Build">
+        <PropertyGroup>
+            <XmlDocGenExe>$(MSBuildThisFileDirectory)../OmegaLeo.HelperLib.XmlDocGenerator/bin/$(Configuration)/net8.0/OmegaLeo.HelperLib.XmlDocGenerator.dll</XmlDocGenExe>
+            <TargetAssembly>$(TargetDir)$(TargetFileName)</TargetAssembly>
+            <TargetXmlDoc>$(TargetDir)$(TargetName).xml</TargetXmlDoc>
+        </PropertyGroup>
+        
+        <Message Text="[DocumentationAttribute] Augmenting XML documentation for $(TargetName) from DocumentationAttribute" Importance="high" Condition="Exists('$(XmlDocGenExe)') And Exists('$(TargetAssembly)')" />
+        
+        <Exec Command="dotnet &quot;$(XmlDocGenExe)&quot; &quot;$(TargetAssembly)&quot; &quot;$(TargetXmlDoc)&quot;"
+              Condition="Exists('$(XmlDocGenExe)') And Exists('$(TargetAssembly)')"
+              IgnoreExitCode="true"
+              ContinueOnError="true" />
+    </Target>
+
 </Project>
diff --git a/OmegaLeo.HelperLib.Game/OmegaLeo.HelperLib.Game.csproj b/OmegaLeo.HelperLib.Game/OmegaLeo.HelperLib.Game.csproj
index b5f7ba9..9eaad6d 100755
--- a/OmegaLeo.HelperLib.Game/OmegaLeo.HelperLib.Game.csproj
+++ b/OmegaLeo.HelperLib.Game/OmegaLeo.HelperLib.Game.csproj
@@ -31,4 +31,20 @@
       </None>
     </ItemGroup>
 
+    <!-- Post-build target to generate XML documentation from DocumentationAttribute -->
+    <Target Name="GenerateXmlDocFromAttributes" AfterTargets="Build">
+        <PropertyGroup>
+            <XmlDocGenExe>$(MSBuildThisFileDirectory)../OmegaLeo.HelperLib.XmlDocGenerator/bin/$(Configuration)/net8.0/OmegaLeo.HelperLib.XmlDocGenerator.dll</XmlDocGenExe>
+            <TargetAssembly>$(TargetDir)$(TargetFileName)</TargetAssembly>
+            <TargetXmlDoc>$(TargetDir)$(TargetName).xml</TargetXmlDoc>
+        </PropertyGroup>
+        
+        <Message Text="[DocumentationAttribute] Augmenting XML documentation for $(TargetName) from DocumentationAttribute" Importance="high" Condition="Exists('$(XmlDocGenExe)') And Exists('$(TargetAssembly)')" />
+        
+        <Exec Command="dotnet &quot;$(XmlDocGenExe)&quot; &quot;$(TargetAssembly)&quot; &quot;$(TargetXmlDoc)&quot;"
+              Condition="Exists('$(XmlDocGenExe)') And Exists('$(TargetAssembly)')"
+              IgnoreExitCode="true"
+              ContinueOnError="true" />
+    </Target>
+
 </Project>
diff --git a/OmegaLeo.HelperLib.Shared/OmegaLeo.HelperLib.Shared.csproj b/OmegaLeo.HelperLib.Shared/OmegaLeo.HelperLib.Shared.csproj
index d452b2d..372065a 100644
--- a/OmegaLeo.HelperLib.Shared/OmegaLeo.HelperLib.Shared.csproj
+++ b/OmegaLeo.HelperLib.Shared/OmegaLeo.HelperLib.Shared.csproj
@@ -30,4 +30,20 @@
             <CopyToOutputDirectory>Never</CopyToOutputDirectory>
         </None>
     </ItemGroup>
+
+    <!-- Post-build target to generate XML documentation from DocumentationAttribute -->
+    <Target Name="GenerateXmlDocFromAttributes" AfterTargets="Build">
+        <PropertyGroup>
+            <XmlDocGenExe>$(MSBuildThisFileDirectory)../OmegaLeo.HelperLib.XmlDocGenerator/bin/$(Configuration)/net8.0/OmegaLeo.HelperLib.XmlDocGenerator.dll</XmlDocGenExe>
+            <TargetAssembly>$(TargetDir)$(TargetFileName)</TargetAssembly>
+            <TargetXmlDoc>$(TargetDir)$(TargetName).xml</TargetXmlDoc>
+        </PropertyGroup>
+        
+        <Message Text="[DocumentationAttribute] Augmenting XML documentation for $(TargetName) from DocumentationAttribute" Importance="high" Condition="Exists('$(XmlDocGenExe)') And Exists('$(TargetAssembly)')" />
+        
+        <Exec Command="dotnet &quot;$(XmlDocGenExe)&quot; &quot;$(TargetAssembly)&quot; &quot;$(TargetXmlDoc)&quot;"
+              Condition="Exists('$(XmlDocGenExe)') And Exists('$(TargetAssembly)')"
+              IgnoreExitCode="true"
+              ContinueOnError="true" />
+    </Target>
 </Project>
diff --git a/OmegaLeo.HelperLib/OmegaLeo.HelperLib.csproj b/OmegaLeo.HelperLib/OmegaLeo.HelperLib.csproj
index ed98a05..af7fe03 100755
--- a/OmegaLeo.HelperLib/OmegaLeo.HelperLib.csproj
+++ b/OmegaLeo.HelperLib/OmegaLeo.HelperLib.csproj
@@ -33,4 +33,22 @@
       <ProjectReference Include="..\OmegaLeo.HelperLib.Shared\OmegaLeo.HelperLib.Shared.csproj" />
     </ItemGroup>
 
+    <!-- Post-build target to generate XML documentation from DocumentationAttribute -->
+    <Target Name="GenerateXmlDocFromAttributes" AfterTargets="Build">
+        <PropertyGroup>
+            <XmlDocGenExe>$(MSBuildThisFileDirectory)../OmegaLeo.HelperLib.XmlDocGenerator/bin/$(Configuration)/net8.0/OmegaLeo.HelperLib.XmlDocGenerator.dll</XmlDocGenExe>
+            <TargetAssembly>$(TargetDir)$(TargetFileName)</TargetAssembly>
+            <TargetXmlDoc>$(TargetDir)$(TargetName).xml</TargetXmlDoc>
+        </PropertyGroup>
+        
+        <Message Text="[DocumentationAttribute] Augmenting XML documentation for $(TargetName) from DocumentationAttribute" Importance="high" Condition="Exists('$(XmlDocGenExe)') And Exists('$(TargetAssembly)')" />
+        <Message Text="[DocumentationAttribute] XmlDocGen tool not found at: $(XmlDocGenExe)" Importance="high" Condition="!Exists('$(XmlDocGenExe)')" />
+        <Message Text="[DocumentationAttribute] Target assembly not found at: $(TargetAssembly)" Importance="high" Condition="!Exists('$(TargetAssembly)')" />
+        
+        <Exec Command="dotnet &quot;$(XmlDocGenExe)&quot; &quot;$(TargetAssembly)&quot; &quot;$(TargetXmlDoc)&quot;"
+              Condition="Exists('$(XmlDocGenExe)') And Exists('$(TargetAssembly)')"
+              IgnoreExitCode="true"
+              ContinueOnError="true" />
+    </Target>
+
 </Project>