Enable XML doc.

6 files changed, 26 insertions, 10 deletions

diff --git a/src/WixToolset.Core.Burn/Bundles/BurnCommon.cs b/src/WixToolset.Core.Burn/Bundles/BurnCommon.cs
index 01c9f9ca..bca1be72 100644
--- a/src/WixToolset.Core.Burn/Bundles/BurnCommon.cs
+++ b/src/WixToolset.Core.Burn/Bundles/BurnCommon.cs
@@ -9,7 +9,7 @@ namespace WixToolset.Core.Burn.Bundles
     using WixToolset.Extensibility.Services;
 
     /// <summary>
-    /// Common functionality for Burn PE Writer & Reader for the WiX toolset.
+    /// Common functionality for Burn PE Writer &amp; Reader for the WiX toolset.
     /// </summary>
     /// <remarks>This class encapsulates common functionality related to 
     /// bundled/chained setup packages.</remarks>
@@ -107,8 +107,8 @@ namespace WixToolset.Core.Burn.Bundles
         /// <summary>
         /// Creates a BurnCommon for re-writing a PE file.
         /// </summary>
+        /// <param name="messaging"></param>
         /// <param name="fileExe">File to modify in-place.</param>
-        /// <param name="bundleGuid">GUID for the bundle.</param>
         public BurnCommon(IMessaging messaging, string fileExe)
         {
             this.messaging = messaging;
diff --git a/src/WixToolset.Core.Burn/Bundles/BurnReader.cs b/src/WixToolset.Core.Burn/Bundles/BurnReader.cs
index b4e23623..68fdea1c 100644
--- a/src/WixToolset.Core.Burn/Bundles/BurnReader.cs
+++ b/src/WixToolset.Core.Burn/Bundles/BurnReader.cs
@@ -32,6 +32,7 @@ namespace WixToolset.Core.Burn.Bundles
         /// <summary>
         /// Creates a BurnReader for reading a PE file.
         /// </summary>
+        /// <param name="messaging"></param>
         /// <param name="fileExe">File to read.</param>
         private BurnReader(IMessaging messaging, string fileExe)
             : base(messaging, fileExe)
@@ -58,6 +59,7 @@ namespace WixToolset.Core.Burn.Bundles
         /// <summary>
         /// Opens a Burn reader.
         /// </summary>
+        /// <param name="messaging"></param>
         /// <param name="fileExe">Path to file.</param>
         /// <returns>Burn reader.</returns>
         public static BurnReader Open(IMessaging messaging, string fileExe)
@@ -77,6 +79,7 @@ namespace WixToolset.Core.Burn.Bundles
         /// Gets the UX container from the exe and extracts its contents to the output directory.
         /// </summary>
         /// <param name="outputDirectory">Directory to write extracted files to.</param>
+        /// <param name="tempDirectory">Scratch directory.</param>
         /// <returns>True if successful, false otherwise</returns>
         public bool ExtractUXContainer(string outputDirectory, string tempDirectory)
         {
@@ -157,6 +160,7 @@ namespace WixToolset.Core.Burn.Bundles
         /// Gets the attached container from the exe and extracts its contents to the output directory.
         /// </summary>
         /// <param name="outputDirectory">Directory to write extracted files to.</param>
+        /// <param name="tempDirectory">Scratch directory.</param>
         /// <returns>True if successful, false otherwise</returns>
         public bool ExtractAttachedContainer(string outputDirectory, string tempDirectory)
         {
diff --git a/src/WixToolset.Core.Burn/Bundles/BurnWriter.cs b/src/WixToolset.Core.Burn/Bundles/BurnWriter.cs
index 83b73a61..be9b8eaa 100644
--- a/src/WixToolset.Core.Burn/Bundles/BurnWriter.cs
+++ b/src/WixToolset.Core.Burn/Bundles/BurnWriter.cs
@@ -29,8 +29,8 @@ namespace WixToolset.Core.Burn.Bundles
         /// <summary>
         /// Creates a BurnWriter for re-writing a PE file.
         /// </summary>
+        /// <param name="messaging"></param>
         /// <param name="fileExe">File to modify in-place.</param>
-        /// <param name="bundleGuid">GUID for the bundle.</param>
         private BurnWriter(IMessaging messaging, string fileExe)
             : base(messaging, fileExe)
         {
@@ -39,6 +39,7 @@ namespace WixToolset.Core.Burn.Bundles
         /// <summary>
         /// Opens a Burn writer.
         /// </summary>
+        /// <param name="messaging"></param>
         /// <param name="fileExe">Path to file.</param>
         /// <returns>Burn writer.</returns>
         public static BurnWriter Open(IMessaging messaging, string fileExe)
@@ -197,7 +198,9 @@ namespace WixToolset.Core.Burn.Bundles
         /// Appends a container to the exe and updates the ".wixburn" section data to point to it.
         /// </summary>
         /// <param name="containerStream">File stream to append to the current exe.</param>
+        /// <param name="containerSize">Size of the container.</param>
         /// <param name="burnSectionOffsetSize">Offset of size field for this container in ".wixburn" section data.</param>
+        /// <param name="burnSectionCount">Number of Burn sections.</param>
         /// <returns>true if the container data is successfully appended; false otherwise</returns>
         private bool AppendContainer(Stream containerStream, UInt32 containerSize, UInt32 burnSectionOffsetSize, UInt32 burnSectionCount)
         {
diff --git a/src/WixToolset.Core.Burn/RowIndexedList.cs b/src/WixToolset.Core.Burn/RowIndexedList.cs
index 3a4dad38..73172dc2 100644
--- a/src/WixToolset.Core.Burn/RowIndexedList.cs
+++ b/src/WixToolset.Core.Burn/RowIndexedList.cs
@@ -7,18 +7,18 @@ namespace WixToolset.Core.Burn
     using WixToolset.Data.WindowsInstaller;
 
     /// <summary>
-    /// A list of rows indexed by their primary key. Unlike a <see cref="RowDictionary"/>
+    /// A list of rows indexed by their primary key. Unlike a RowDictionary
     /// this indexed list will track rows in their added order and will allow rows with
     /// duplicate keys to be added to the list, although only the first row will be indexed.
     /// </summary>
-    public sealed class RowIndexedList<T> : IList<T> where T : Row
+    internal sealed class RowIndexedList<T> : IList<T> where T : Row
     {
         private Dictionary<string, T> index;
         private List<T> rows;
         private List<T> duplicates;
 
         /// <summary>
-        /// Creates an empty <see cref="RowIndexedList"/>.
+        /// Creates an empty <see cref="RowIndexedList{T}"/>.
         /// </summary>
         public RowIndexedList()
         {
@@ -28,7 +28,7 @@ namespace WixToolset.Core.Burn
         }
 
         /// <summary>
-        /// Creates and populates a <see cref="RowDictionary"/> with the rows from the given enumerator.
+        /// Creates and populates a <see cref="RowIndexedList{T}"/> with the rows from the given enumerator.
         /// </summary>
         /// <param name="rows">Rows to index.</param>
         public RowIndexedList(IEnumerable<T> rows)
@@ -41,7 +41,7 @@ namespace WixToolset.Core.Burn
         }
 
         /// <summary>
-        /// Creates and populates a <see cref="RowDictionary"/> with the rows from the given <see cref="Table"/>.
+        /// Creates and populates a <see cref="RowIndexedList{T}"/> with the rows from the given <see cref="Table"/>.
         /// </summary>
         /// <param name="table">The table to index.</param>
         /// <remarks>
diff --git a/src/WixToolset.Core.Burn/WixToolset.Core.Burn.csproj b/src/WixToolset.Core.Burn/WixToolset.Core.Burn.csproj
index b0be1d3b..8b989569 100644
--- a/src/WixToolset.Core.Burn/WixToolset.Core.Burn.csproj
+++ b/src/WixToolset.Core.Burn/WixToolset.Core.Burn.csproj
@@ -9,6 +9,7 @@
     <Title>WiX Toolset Core Burn</Title>
     <DebugType>embedded</DebugType>
     <PublishRepositoryUrl>true</PublishRepositoryUrl>
+    <CreateDocumentationFile>true</CreateDocumentationFile>
   </PropertyGroup>
 
   <ItemGroup>
@@ -28,8 +29,8 @@
     <PackageReference Include="System.Security.Permissions" Version="4.6.0" />
     <PackageReference Include="WixToolset.Burn" Version="4.0.*" />
     <PackageReference Include="WixToolset.Core.Native" Version="4.0.*" />
-    <PackageReference Include="WixToolset.Dtf.Resources" Version="4.0.*" NoWarn="NU1701" />
-    <PackageReference Include="WixToolset.Dtf.WindowsInstaller" Version="4.0.*" NoWarn="NU1701" />
+    <PackageReference Include="WixToolset.Dtf.Resources" Version="4.0.*" />
+    <PackageReference Include="WixToolset.Dtf.WindowsInstaller" Version="4.0.*" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/WixToolset.Core.Burn/WixToolsetCoreServiceProviderExtensions.cs b/src/WixToolset.Core.Burn/WixToolsetCoreServiceProviderExtensions.cs
index 04fa4daf..5303899f 100644
--- a/src/WixToolset.Core.Burn/WixToolsetCoreServiceProviderExtensions.cs
+++ b/src/WixToolset.Core.Burn/WixToolsetCoreServiceProviderExtensions.cs
@@ -7,8 +7,16 @@ namespace WixToolset.Core.Burn
     using WixToolset.Core.Burn.ExtensibilityServices;
     using WixToolset.Extensibility.Services;
 
+    /// <summary>
+    /// Extensions methods for adding Burn services.
+    /// </summary>
     public static class WixToolsetCoreServiceProviderExtensions
     {
+        /// <summary>
+        /// Adds Burn Services.
+        /// </summary>
+        /// <param name="coreProvider"></param>
+        /// <returns></returns>
         public static IWixToolsetCoreServiceProvider AddBundleBackend(this IWixToolsetCoreServiceProvider coreProvider)
         {
             AddServices(coreProvider);