From de389d8c8803c3d2fbbf65620695be30fa24754e Mon Sep 17 00:00:00 2001
From: Rob Mensching <rob@firegiant.com>
Date: Sat, 6 Jun 2020 15:24:04 -0700
Subject: Add the argument to command command-line processing and add xmldoc

---
 .../IExtensionCommandLine.cs                       | 25 ++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

(limited to 'src/WixToolset.Extensibility/IExtensionCommandLine.cs')

diff --git a/src/WixToolset.Extensibility/IExtensionCommandLine.cs b/src/WixToolset.Extensibility/IExtensionCommandLine.cs
index 0cbf84d9..45683373 100644
--- a/src/WixToolset.Extensibility/IExtensionCommandLine.cs
+++ b/src/WixToolset.Extensibility/IExtensionCommandLine.cs
@@ -7,7 +7,7 @@ namespace WixToolset.Extensibility
     using WixToolset.Extensibility.Services;
 
     /// <summary>
-    /// Interface extensions implement to be able to parse command-line options.
+    /// Interface extensions implement to be able to parse the command-line.
     /// </summary>
     public interface IExtensionCommandLine
     {
@@ -17,12 +17,33 @@ namespace WixToolset.Extensibility
         /// <value>The supported command line types for this extension.</value>
         IEnumerable<ExtensionCommandLineSwitch> CommandLineSwitches { get; }
 
+        /// <summary>
+        /// Called before the command-line is parsed.
+        /// </summary>
+        /// <param name="context">Information about the command-line to be parsed.</param>
         void PreParse(ICommandLineContext context);
 
+        /// <summary>
+        /// Gives the extension an opportunity pass a command-line argument for another command.
+        /// </summary>
+        /// <param name="parser">Parser to help parse the argument and additional arguments.</param>
+        /// <param name="argument">Argument to parse.</param>
+        /// <returns>True if the argument is recognized; otherwise false to allow another extension to process it.</returns>
         bool TryParseArgument(ICommandLineParser parser, string argument);
 
-        bool TryParseCommand(ICommandLineParser parser, out ICommandLineCommand command);
+        /// <summary>
+        /// Gives the extension an opportunity to provide a command.
+        /// </summary>
+        /// </summary>
+        /// <param name="parser">Parser to help parse the argument and additional arguments.</param>
+        /// <param name="argument">Argument to parse.</param>
+        /// <param name="command"></param>
+        /// <returns>True if the argument is recognized as a commond; otherwise false to allow another extension to process it.</returns>
+        bool TryParseCommand(ICommandLineParser parser, string argument, out ICommandLineCommand command);
 
+        /// <summary>
+        /// Called after the command-line is parsed.
+        /// </summary>
         void PostParse();
     }
 }
-- 
cgit v1.2.3-55-g6feb