Add XML documentation and IConsole.BackgroundColor

Author: natemcmaster

Directory.Build.props

@@ -23,11 +23,13 @@
     <BranchName Condition=" '$(BranchName)' == '' ">$(APPVEYOR_REPO_BRANCH)</BranchName>
     <VersionSuffix Condition="'$(BranchName)' != 'master'">alpha</VersionSuffix>
     <VersionSuffix Condition="'$(BranchName)' == 'master'">beta</VersionSuffix>
+    <VersionSuffix Condition="'$(APPVEYOR_REPO_TAG)' == 'true'">rtm</VersionSuffix>
     <BuildNumber Condition=" '$(BuildNumber)' == '' ">$(APPVEYOR_BUILD_NUMBER)</BuildNumber>
     <BuildNumber Condition=" '$(BuildNumber)' == '' ">0</BuildNumber>
+    <FileVersion>$(VersionPrefix).$(BuildNumber)</FileVersion>
     <VersionSuffix Condition=" '$(VersionSuffix)' != '' ">$(VersionSuffix).$(BuildNumber)</VersionSuffix>
-    <VersionSuffix Condition="'$(APPVEYOR_REPO_TAG)' == 'true'"></VersionSuffix>
     <VersionSuffix Condition=" '$(VersionSuffix)' != '' AND '$(BranchName)' != '' ">$(VersionSuffix)+$(BranchName)</VersionSuffix>
+    <PackageVersion Condition="'$(APPVEYOR_REPO_TAG)' == 'true'">$(VersionPrefix)</PackageVersion>
   </PropertyGroup>
 
 </Project>

src/CommandLineUtils/CommandArgument.cs

@@ -6,24 +6,49 @@
 
 namespace McMaster.Extensions.CommandLineUtils
 {
+    /// <summary>
+    /// Represents one or many positional command line arguments. 
+    /// Arguments are parsed in the order in which <see cref="CommandLineApplication.Arguments"/> lists them.
+    /// Compare to <seealso cref="CommandOption"/>.
+    /// </summary>
     public class CommandArgument
     {
+        /// <summary>
+        /// Initializes a new instance of <see cref="CommandArgument"/>.
+        /// </summary>
         public CommandArgument()
         {
             Values = new List<string>();
         }
 
+        /// <summary>
+        /// The name of the argument.
+        /// </summary>
         public string Name { get; set; }
+
+        /// <summary>
+        /// Determines if the argument appears in the generated help-text.
+        /// </summary>
         public bool ShowInHelpText { get; set; } = true;
+
+        /// <summary>
+        /// A description of the argument.
+        /// </summary>
         public string Description { get; set; }
+
+        /// <summary>
+        /// All values specified, if any.
+        /// </summary>
         public List<string> Values { get; private set; }
+
+        /// <summary>
+        /// Allow multiple values.
+        /// </summary>
         public bool MultipleValues { get; set; }
-        public string Value
-        {
-            get
-            {
-                return Values.FirstOrDefault();
-            }
-        }
+
+        /// <summary>
+        /// The first value from <see cref="Values"/>, if any.
+        /// </summary>
+        public string Value => Values.FirstOrDefault();
     }
 }