From 8296f237c69743d3e6cbdc58fc07e8470562b92e Mon Sep 17 00:00:00 2001
From: Sean Hall <r.sean.hall@gmail.com>
Date: Fri, 18 Dec 2020 18:12:45 -0600
Subject: Enable XML doc.

---
 src/WixToolset.Core.Native/CabInterop.cs                 |  4 +++-
 src/WixToolset.Core.Native/Cabinet.cs                    | 10 ++++++++--
 src/WixToolset.Core.Native/MSIFILEHASHINFO.cs            | 15 +++++++++++++++
 src/WixToolset.Core.Native/MsmInterop.cs                 |  3 +++
 src/WixToolset.Core.Native/WixToolset.Core.Native.csproj |  6 +++++-
 src/WixToolset.Core.Native/WixToolset.Core.Native.nuspec |  1 +
 6 files changed, 35 insertions(+), 4 deletions(-)

(limited to 'src/WixToolset.Core.Native')

diff --git a/src/WixToolset.Core.Native/CabInterop.cs b/src/WixToolset.Core.Native/CabInterop.cs
index 4c1eb93d..69781047 100644
--- a/src/WixToolset.Core.Native/CabInterop.cs
+++ b/src/WixToolset.Core.Native/CabInterop.cs
@@ -29,6 +29,7 @@ namespace WixToolset.Core.Native
         /// </summary>
         /// <param name="file">Full path to file to add to cabinet.</param>
         /// <param name="token">Name of file in cabinet.</param>
+        /// <param name="fileHash"></param>
         /// <param name="contextHandle">Handle to open cabinet.</param>
         [DllImport("winterop.dll", EntryPoint = "CreateCabAddFile", CharSet = CharSet.Unicode, ExactSpelling = true, PreserveSig = false)]
         public static extern void CreateCabAddFile(string file, string token, MSIFILEHASHINFO fileHash, IntPtr contextHandle);
@@ -101,7 +102,8 @@ namespace WixToolset.Core.Native
         /// to be exposed by .NET Frameowkr.
         /// </summary>
         /// <param name="certContext">Pointer to a CERT_CONTEXT struct with public key information to hash.</param>
-        /// <param name="fileCount">Number of file paths in array.</param>
+        /// <param name="publicKeyInfoHashed"></param>
+        /// <param name="sizePublicKeyInfoHashed"></param>
         [DllImport("winterop.dll", EntryPoint = "HashPublicKeyInfo", CharSet = CharSet.Unicode, ExactSpelling = true, PreserveSig = false)]
         public static extern void HashPublicKeyInfo(IntPtr certContext, byte[] publicKeyInfoHashed, ref uint sizePublicKeyInfoHashed);
 
diff --git a/src/WixToolset.Core.Native/Cabinet.cs b/src/WixToolset.Core.Native/Cabinet.cs
index 2d624658..7e04cbc5 100644
--- a/src/WixToolset.Core.Native/Cabinet.cs
+++ b/src/WixToolset.Core.Native/Cabinet.cs
@@ -15,19 +15,25 @@ namespace WixToolset.Core.Native
         private const string CompressionLevelVariable = "WIX_COMPRESSION_LEVEL";
         private static readonly char[] TextLineSplitter = new[] { '\t' };
 
+        /// <summary>
+        /// 
+        /// </summary>
+        /// <param name="path">Path of cabinet</param>
         public Cabinet(string path)
         {
             this.Path = path;
         }
 
+        /// <summary>
+        /// Cabinet path.
+        /// </summary>
         public string Path { get; }
 
         /// <summary>
         /// Creates a cabinet.
         /// </summary>
-        /// <param name="cabPath">Path of cabinet to create.</param>
+        /// <param name="files">Files to compress.</param>
         /// <param name="compressionLevel">Level of compression to apply.</param>
-        /// <param name="maxFiles">Maximum number of files that will be added to cabinet.</param>
         /// <param name="maxSize">Maximum size of cabinet.</param>
         /// <param name="maxThresh">Maximum threshold for each cabinet.</param>
         public void Compress(IEnumerable<CabinetCompressFile> files, CompressionLevel compressionLevel, int maxSize = 0, int maxThresh = 0)
diff --git a/src/WixToolset.Core.Native/MSIFILEHASHINFO.cs b/src/WixToolset.Core.Native/MSIFILEHASHINFO.cs
index c11b44ea..d5ac1bc0 100644
--- a/src/WixToolset.Core.Native/MSIFILEHASHINFO.cs
+++ b/src/WixToolset.Core.Native/MSIFILEHASHINFO.cs
@@ -10,10 +10,25 @@ namespace WixToolset.Core.Native
     [StructLayout(LayoutKind.Explicit)]
     public class MSIFILEHASHINFO
     {
+        /// <summary>
+        /// 
+        /// </summary>
         [FieldOffset(0)] public uint FileHashInfoSize;
+        /// <summary>
+        /// 
+        /// </summary>
         [FieldOffset(4)] public int Data0;
+        /// <summary>
+        /// 
+        /// </summary>
         [FieldOffset(8)] public int Data1;
+        /// <summary>
+        /// 
+        /// </summary>
         [FieldOffset(12)] public int Data2;
+        /// <summary>
+        /// 
+        /// </summary>
         [FieldOffset(16)] public int Data3;
     }
 }
diff --git a/src/WixToolset.Core.Native/MsmInterop.cs b/src/WixToolset.Core.Native/MsmInterop.cs
index 6b1ad141..87ed6f02 100644
--- a/src/WixToolset.Core.Native/MsmInterop.cs
+++ b/src/WixToolset.Core.Native/MsmInterop.cs
@@ -481,6 +481,9 @@ namespace WixToolset.Core.Native
     [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
     public interface IClassFactory
     {
+        /// <summary>
+        /// 
+        /// </summary>
         [return: MarshalAs(UnmanagedType.IUnknown)]
         object CreateInstance(IntPtr unkOuter, [MarshalAs(UnmanagedType.LPStruct)] Guid iid);
     }
diff --git a/src/WixToolset.Core.Native/WixToolset.Core.Native.csproj b/src/WixToolset.Core.Native/WixToolset.Core.Native.csproj
index f12d674c..2c118d51 100644
--- a/src/WixToolset.Core.Native/WixToolset.Core.Native.csproj
+++ b/src/WixToolset.Core.Native/WixToolset.Core.Native.csproj
@@ -1,3 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. -->
+
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
@@ -6,6 +9,7 @@
     <Description>Core Native</Description>
     <DebugType>embedded</DebugType>
     <IncludeSymbols>true</IncludeSymbols>
+    <CreateDocumentationFile>true</CreateDocumentationFile>
   </PropertyGroup>
 
   <ItemGroup>
@@ -29,7 +33,7 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.0.0" PrivateAssets="All" />
-    <PackageReference Include="Nerdbank.GitVersioning" Version="3.1.91" PrivateAssets="all" />
+    <PackageReference Include="Nerdbank.GitVersioning" Version="3.3.37" PrivateAssets="all" />
   </ItemGroup>
 
   <PropertyGroup>
diff --git a/src/WixToolset.Core.Native/WixToolset.Core.Native.nuspec b/src/WixToolset.Core.Native/WixToolset.Core.Native.nuspec
index 0ec4747d..33b19bc1 100644
--- a/src/WixToolset.Core.Native/WixToolset.Core.Native.nuspec
+++ b/src/WixToolset.Core.Native/WixToolset.Core.Native.nuspec
@@ -18,6 +18,7 @@
 
   <files>
     <file src="netstandard2.0\$id$.dll" target="lib\netstandard2.0" />
+    <file src="netstandard2.0\$id$.xml" target="lib\netstandard2.0" />
 
     <file src="$mergemoddir$ARM64\mergemod.dll" target="runtimes\win-arm64\native" />
     <file src="ARM64\wixnative.exe" target="runtimes\win-arm64\native" />
-- 
cgit v1.2.3-55-g6feb