1 files changed, 23 insertions, 22 deletions

diff --git a/src/WixToolset.Extensibility/IBurnBackendExtension.cs b/src/WixToolset.Extensibility/IBurnBackendExtension.cs
index 769c2457..07f5cd1b 100644
--- a/src/WixToolset.Extensibility/IBurnBackendExtension.cs
+++ b/src/WixToolset.Extensibility/IBurnBackendExtension.cs
@@ -16,30 +16,36 @@ namespace WixToolset.Extensibility
         void PreBackendBind(IBindContext context);
 
         /// <summary>
-        /// 
+        /// Called to find a file related to another source in the authoring. For example, most often used
+        /// to find cabinets and uncompressed files for an MSI package.
         /// </summary>
-        /// <param name="source"></param>
-        /// <param name="relatedSource"></param>
-        /// <param name="type"></param>
-        /// <param name="sourceLineNumbers"></param>
-        /// <param name="bindStage"></param>
-        /// <returns></returns>
-        IResolveFileResult ResolveRelatedFile(string source, string relatedSource, string type, SourceLineNumber sourceLineNumbers, BindStage bindStage);
+        /// <param name="source">Path to the source package.</param>
+        /// <param name="relatedSource">Expected path to the related file.</param>
+        /// <param name="type">Type of related file, such as "File" or "Cabinet"</param>
+        /// <param name="sourceLineNumbers">Source line number of source package.</param>
+        /// <returns><c>IResolveFileResult</c> if the related file was found, or null for default handling.</returns>
+        IResolveFileResult ResolveRelatedFile(string source, string relatedSource, string type, SourceLineNumber sourceLineNumbers);
 
         /// <summary>
-        /// 
+        /// Called right before the output is bound into its final format.
         /// </summary>
-        /// <param name="url"></param>
-        /// <param name="fallbackUrl"></param>
-        /// <param name="packageId"></param>
-        /// <param name="payloadId"></param>
-        /// <param name="fileName"></param>
-        /// <returns></returns>
+        /// <param name="section">The finalized intermediate section.</param>
+        void SymbolsFinalized(IntermediateSection section);
+
+        /// <summary>
+        /// Called to customize the DownloadUrl provided in source cde.
+        /// </summary>
+        /// <param name="url">The value from the source code. May not actually be a URL.</param>
+        /// <param name="fallbackUrl">The default URL if the extension does not return a value.</param>
+        /// <param name="packageId">Identifier of the package.</param>
+        /// <param name="payloadId">Identifier of the payload.</param>
+        /// <param name="fileName">Filename of the payload.</param>
+        /// <returns>Url to override, or null to use default value.</returns>
         string ResolveUrl(string url, string fallbackUrl, string packageId, string payloadId, string fileName);
 
         /// <summary>
         /// Called for each extension symbol that hasn't been handled yet.
-        /// Use IBurnBackendHelper to add data to the appropriate data manifest.
+        /// Use IBurnBackendHelper to add data.
         /// </summary>
         /// <param name="section">The linked section.</param>
         /// <param name="symbol">The current symbol.</param>
@@ -47,12 +53,7 @@ namespace WixToolset.Extensibility
         /// True if the extension handled the symbol, false otherwise.
         /// The Burn backend will warn on all unhandled symbols.
         /// </returns>
-        bool TryAddSymbolToDataManifest(IntermediateSection section, IntermediateSymbol symbol);
-
-        /// <summary>
-        /// Called after all output changes occur and right before the output is bound into its final format.
-        /// </summary>
-        void BundleFinalize();
+        bool TryProcessSymbol(IntermediateSection section, IntermediateSymbol symbol);
 
         /// <summary>
         /// Called after output is bound into its final format.