Add MSBuild targets to projects for XML doc generation

Co-authored-by: omegaleo <5655201+omegaleo@users.noreply.github.com>

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>

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>

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>

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>

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>