From 7b933d0cc3daea2167aabb39b940c16f3ecfe4a0 Mon Sep 17 00:00:00 2001
From: Al Idian <al.idian@me.com>
Date: Tue, 15 Jun 2021 09:05:21 -0700
Subject: [PATCH] Correct and improve XML comments (#15568)

---
 .../engine/hostifaces/PSCommand.cs            | 29 ++++++++++---------
 1 file changed, 16 insertions(+), 13 deletions(-)

diff --git a/src/System.Management.Automation/engine/hostifaces/PSCommand.cs b/src/System.Management.Automation/engine/hostifaces/PSCommand.cs
index 77bf704f38..702bd6ab88 100644
--- a/src/System.Management.Automation/engine/hostifaces/PSCommand.cs
+++ b/src/System.Management.Automation/engine/hostifaces/PSCommand.cs
@@ -77,7 +77,7 @@ namespace System.Management.Automation
         /// current state.
         /// </exception>
         /// <returns>
-        /// A PSCommand instance with <paramref name="cmdlet"/> added.
+        /// A PSCommand instance with <paramref name="command"/> added.
         /// </returns>
         /// <remarks>
         /// This method is not thread safe.
@@ -151,15 +151,15 @@ namespace System.Management.Automation
         /// Add a piece of script to construct a command pipeline.
         /// For example, to construct a command string "get-process | foreach { $_.Name }"
         ///     <code>
-        ///         PSCommand command = new PSCommand("get-process").
-        ///                                     AddCommand("foreach { $_.Name }", true);
+        ///         PSCommand command = new PSCommand("get-process")
+        ///             .AddScript("foreach { $_.Name }", true);
         ///     </code>
         /// </summary>
         /// <param name="script">
         /// A string representing the script.
         /// </param>
         /// <returns>
-        /// A PSCommand instance with <paramref name="command"/> added.
+        /// A PSCommand instance with <paramref name="script"/> added.
         /// </returns>
         /// <remarks>
         /// This method is not thread-safe.
@@ -193,8 +193,8 @@ namespace System.Management.Automation
         /// Add a piece of script to construct a command pipeline.
         /// For example, to construct a command string "get-process | foreach { $_.Name }"
         ///     <code>
-        ///         PSCommand command = new PSCommand("get-process").
-        ///                                     AddCommand("foreach { $_.Name }", true);
+        ///         PSCommand command = new PSCommand("get-process")
+        ///             .AddScript("foreach { $_.Name }", true);
         ///     </code>
         /// </summary>
         /// <param name="script">
@@ -204,7 +204,7 @@ namespace System.Management.Automation
         /// if true local scope is used to run the script command.
         /// </param>
         /// <returns>
-        /// A PSCommand instance with <paramref name="command"/> added.
+        /// A PSCommand instance with <paramref name="script"/> added.
         /// </returns>
         /// <remarks>
         /// This method is not thread-safe.
@@ -276,8 +276,9 @@ namespace System.Management.Automation
         /// Add a parameter to the last added command.
         /// For example, to construct a command string "get-process | select-object -property name"
         ///     <code>
-        ///         PSCommand command = new PSCommand("get-process").
-        ///                                     AddCommand("select-object").AddParameter("property","name");
+        ///         PSCommand command = new PSCommand("get-process")
+        ///             .AddCommand("select-object")
+        ///             .AddParameter("property", "name");
         ///     </code>
         /// </summary>
         /// <param name="parameterName">
@@ -321,8 +322,9 @@ namespace System.Management.Automation
         /// Adds a switch parameter to the last added command.
         /// For example, to construct a command string "get-process | sort-object -descending"
         ///     <code>
-        ///         PSCommand command = new PSCommand("get-process").
-        ///                                     AddCommand("sort-object").AddParameter("descending");
+        ///         PSCommand command = new PSCommand("get-process")
+        ///             .AddCommand("sort-object")
+        ///             .AddParameter("descending");
         ///     </code>
         /// </summary>
         /// <param name="parameterName">
@@ -383,8 +385,9 @@ namespace System.Management.Automation
         /// Adds an argument to the last added command.
         /// For example, to construct a command string "get-process | select-object name"
         ///     <code>
-        ///         PSCommand command = new PSCommand("get-process").
-        ///                                     AddCommand("select-object").AddParameter("name");
+        ///         PSCommand command = new PSCommand("get-process")
+        ///             .AddCommand("select-object")
+        ///             .AddArgument("name");
         ///     </code>
         /// This will add the value "name" to the positional parameter list of "select-object"
         /// cmdlet. When the command is invoked, this value will get bound to positional parameter 0