COH-30705 Generate XML documentation

[git-p4: depot-paths = "//dev/main.net/": change = 110804]

Author: vasac

src/Coherence.SessionStore/Coherence.SessionStore.csproj

@@ -19,12 +19,14 @@
       <OutputPath>bin\Debug/</OutputPath>
       <WarningLevel>4</WarningLevel>
       <NoWarn />
+      <GenerateDocumentationFile>true</GenerateDocumentationFile>
     </PropertyGroup>
 
     <PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
       <OutputPath>bin\Release/</OutputPath>
       <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
       <WarningLevel>4</WarningLevel>
+      <GenerateDocumentationFile>true</GenerateDocumentationFile>
     </PropertyGroup>
 
     <ItemGroup>

src/Coherence.SessionStore/Web/CoherenceSessionOptions.cs

@@ -36,7 +36,8 @@ public class CoherenceSessionOptions
     /// <summary>
     /// Path to the Coherence configuration file.
     /// </summary>
-    public string CoherenceConfig { get; set; } = "assembly://Coherence/Tangosol.Config/coherence.xml";
+    public string CoherenceConfig { get; set; } = "assembly://Coherence/Tangosol.Config/coherence-config.xml";
+
     /// <summary>
     /// Path to the Coherence cache configuration file.
     /// </summary>
@@ -57,7 +58,14 @@ public class CoherenceSessionOptions
     /// </summary>
     public enum SessionModel
     {
+        /// <summary>
+        /// Monolithic session model
+        /// </summary>
         Monolithic,
+
+        /// <summary>
+        /// Split session model
+        /// </summary>
         Split
     }
 }

src/Coherence/Coherence.csproj

@@ -60,12 +60,12 @@
     <DefineConstants>DEBUG;TRACE</DefineConstants>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
     <WarningsAsErrors />
-    <GenerateDocumentationFile>false</GenerateDocumentationFile>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <OutputPath>bin\Debug</OutputPath>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Release|net6.0|AnyCPU'">
     <DefineConstants />
-    <GenerateDocumentationFile>false</GenerateDocumentationFile>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <OutputPath>bin\Release</OutputPath>
   </PropertyGroup>
 
@@ -78,7 +78,7 @@
     <None Remove="Config\cache-config.xsd" />
     <None Remove="Config\coherence-cache-config.xml" />
     <None Remove="Config\pof-config.xsd" />
-    <None Remove="Config\coherence.xml" />
+    <None Remove="Config\coherence-config.xml" />
     <None Remove="Config\coherence-pof-config.xml" />
     <None Remove="Config\coherence.xsd" />
   </ItemGroup>
@@ -87,7 +87,7 @@
     <EmbeddedResource Include="Config\cache-config.xsd" />
     <EmbeddedResource Include="Config\coherence-cache-config.xml" />
     <EmbeddedResource Include="Config\pof-config.xsd" />
-    <EmbeddedResource Include="Config\coherence.xml" />
+    <EmbeddedResource Include="Config\coherence-config.xml" />
     <EmbeddedResource Include="Config\coherence-pof-config.xml" />
     <EmbeddedResource Include="Config\coherence.xsd" />
   </ItemGroup>

src/Coherence/Config/coherence.xml renamed to src/Coherence/Config/coherence-config.xml

@@ -95,7 +95,7 @@
   <xs:complexType name="cluster-config">
     <xs:sequence>
       <xs:element ref="member-identity" minOccurs="0"/>
-      <xs:element ref="filters"/>
+      <xs:element ref="filters" minOccurs="0"/>
       <xs:element ref="serializers" minOccurs="0"/>
       <xs:element ref="address-providers" minOccurs="0"/>
     </xs:sequence>

src/Coherence/Config/coherence.xsd

@@ -716,7 +716,7 @@ public static bool IsLogEnabled(LogLevel level)
 
         /// <summary>
         /// Log a message using Coherence logging facility which is driven by
-        /// the "logging-config" element located in the coherence.xml
+        /// the "logging-config" element located in the coherence-config.xml
         /// configuration file.
         /// </summary>
         /// <param name="message">
@@ -733,7 +733,7 @@ public static void Log(string message, LogLevel severity)
 
         /// <summary>
         /// Log an exception using Coherence logging facility which is driven
-        /// by the "logging-config" element located in the coherence.xml
+        /// by the "logging-config" element located in the coherence-config.xml
         /// configuration file.
         /// </summary>
         /// <param name="exc">
@@ -751,7 +751,7 @@ public static void Log(Exception exc, LogLevel severity)
         /// <summary>
         /// Log a message and exception using Coherence logging facility
         /// which is driven by the "logging-config" element located in the
-        /// coherence.xml configuration file.
+        /// coherence-config.xml configuration file.
         /// </summary>
         /// <param name="message">
         /// A message to log.

src/Coherence/Net/CacheFactory.cs

@@ -88,14 +88,14 @@ public virtual IXmlElement Config
         /// </summary>
         static DefaultOperationalContext()
         {
-            s_configResource = ResourceLoader.GetResource("coherence.xml", true);
+            s_configResource = ResourceLoader.GetResource("coherence-config.xml", true);
 
             // if the user-specific default operaational configuration file
             // doesn't exist, use the one embedded into Coherence.dll
             if (!File.Exists(s_configResource.AbsolutePath))
             {
                 s_configResource = new EmbeddedResource(string.Format(
-                        "assembly://{0}/Tangosol.Config/coherence.xml",
+                        "assembly://{0}/Tangosol.Config/coherence-config.xml",
                         typeof(CacheFactory).Assembly.FullName));
             }
         }