Revert remaining comment changes

Author: rjmholt

src/PowerShellEditorServices.Host/EditorServicesHost.cs

@@ -134,7 +134,7 @@ public EditorServicesHost(
         #region Public Methods
 
         /// <summary>
-        /// Starts the ILogger for the specified file path and log level.
+        /// Starts the Logger for the specified file path and log level.
         /// </summary>
         /// <param name="logFilePath">The path of the log file to be written.</param>
         /// <param name="logLevel">The minimum level of log messages to be written.</param>

src/PowerShellEditorServices.Protocol/Server/LanguageServer.cs

@@ -54,7 +54,7 @@ public IEditorOperations EditorOperations
         /// <param name="messageHandlers">An object that manages all of the message handlers</param>
         /// <param name="messageSender">The message sender</param>
         /// <param name="serverCompletedTask">A TaskCompletionSource<bool> that will be completed to stop the running process</param>
-        /// <param name="logger">the ILogger</param>
+        /// <param name="logger">the logger</param>
         public LanguageServer(
             EditorSession editorSession,
             IMessageHandlers messageHandlers,

src/PowerShellEditorServices/Components/FeatureComponentBase.cs

@@ -27,16 +27,16 @@ public abstract class FeatureComponentBase<TProvider>
         public IFeatureProviderCollection<TProvider> Providers { get; private set; }
 
         /// <summary>
-        /// Gets the ILogger to use for writing log
+        /// Gets the ILogger implementation to use for writing log
         /// messages.
         /// </summary>
         protected ILogger Logger { get; private set; }
 
         /// <summary>
         /// Creates an instance of the FeatureComponentBase class with
-        /// the specified ILoggger.
+        /// the specified ILogger.
         /// </summary>
-        /// <param name="logger">the ILogger to use for this instance.</param>
+        /// <param name="logger">The ILogger implementation to use for this instance.</param>
         public FeatureComponentBase(ILogger logger)
         {
             this.Providers = new FeatureProviderCollection<TProvider>();

src/PowerShellEditorServices/Console/InputPromptHandler.cs

@@ -35,7 +35,7 @@ public abstract class InputPromptHandler : PromptHandler
         /// <summary>
         ///
         /// </summary>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public InputPromptHandler(ILogger logger) : base(logger)
         {
         }

src/PowerShellEditorServices/Console/PromptHandler.cs

@@ -14,14 +14,14 @@ namespace Microsoft.PowerShell.EditorServices.Console
     public abstract class PromptHandler
     {
         /// <summary>
-        /// Gets the ILogger used for this instance.
+        /// Gets the ILogger implementation used for this instance.
         /// </summary>
         protected ILogger Logger { get; private set; }
 
         /// <summary>
         ///
         /// </summary>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public PromptHandler(ILogger logger)
         {
             this.Logger = logger;

src/PowerShellEditorServices/Console/TerminalChoicePromptHandler.cs

@@ -34,7 +34,7 @@ internal class TerminalChoicePromptHandler : ConsoleChoicePromptHandler
         /// The IHostOutput implementation to use for writing to the
         /// console.
         /// </param>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public TerminalChoicePromptHandler(
             ConsoleReadLine consoleReadLine,
             IHostOutput hostOutput,

src/PowerShellEditorServices/Console/TerminalInputPromptHandler.cs

@@ -35,7 +35,7 @@ internal class TerminalInputPromptHandler : ConsoleInputPromptHandler
         /// The IHostOutput implementation to use for writing to the
         /// console.
         /// </param>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public TerminalInputPromptHandler(
             ConsoleReadLine consoleReadLine,
             IHostOutput hostOutput,

src/PowerShellEditorServices/Debugging/DebugService.cs

@@ -80,7 +80,7 @@ public class DebugService
         /// <param name="powerShellContext">
         /// The PowerShellContext to use for all debugging operations.
         /// </param>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public DebugService(PowerShellContext powerShellContext, ILogger logger)
             : this(powerShellContext, null, logger)
         {
@@ -96,7 +96,7 @@ public DebugService(PowerShellContext powerShellContext, ILogger logger)
         /// <param name="remoteFileManager">
         /// A RemoteFileManager instance to use for accessing files in remote sessions.
         /// </param>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public DebugService(
             PowerShellContext powerShellContext,
             RemoteFileManager remoteFileManager,

src/PowerShellEditorServices/Language/AstOperations.cs

@@ -39,7 +39,7 @@ internal static class AstOperations
         /// <param name="powerShellContext">
         /// The PowerShellContext to use for gathering completions.
         /// </param>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         /// <param name="cancellationToken">
         /// A CancellationToken to cancel completion requests.
         /// </param>

src/PowerShellEditorServices/Language/LanguageService.cs

@@ -48,7 +48,7 @@ public class LanguageService
         /// <param name="powerShellContext">
         /// The PowerShellContext in which language service operations will be executed.
         /// </param>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public LanguageService(
             PowerShellContext powerShellContext,
             ILogger logger)

src/PowerShellEditorServices/Session/EditorSession.cs

@@ -84,7 +84,7 @@ public class EditorSession
         /// <summary>
         ///
         /// </summary>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public EditorSession(ILogger logger)
         {
             this.logger = logger;

src/PowerShellEditorServices/Session/Host/EditorServicesPSHost.cs

@@ -44,7 +44,7 @@ public class EditorServicesPSHost : PSHost, IHostSupportsInteractiveSession
         /// <param name="hostUserInterface">
         /// The EditorServicesPSHostUserInterface implementation to use for this host.
         /// </param>
-        /// <param name="logger">Logger to use for this host.</param>
+        /// <param name="logger">An ILogger implementation to use for this host.</param>
         public EditorServicesPSHost(
             PowerShellContext powerShellContext,
             HostDetails hostDetails,

src/PowerShellEditorServices/Session/Host/EditorServicesPSHostUserInterface.cs

@@ -79,7 +79,7 @@ public abstract class EditorServicesPSHostUserInterface :
         private bool IsCommandLoopRunning { get; set; }
 
         /// <summary>
-        /// Gets the ILogger used for this host.
+        /// Gets the ILogger implementation used for this host.
         /// </summary>
         protected ILogger Logger { get; private set; }
 
@@ -93,7 +93,7 @@ public abstract class EditorServicesPSHostUserInterface :
         /// </summary>
         /// <param name="powerShellContext">The PowerShellContext to use for executing commands.</param>
         /// <param name="rawUserInterface">The PSHostRawUserInterface implementation to use for this host.</param>
-        /// <param name="logger">Logger to use for this host.</param>
+        /// <param name="logger">An ILogger implementation to use for this host.</param>
         public EditorServicesPSHostUserInterface(
             PowerShellContext powerShellContext,
             PSHostRawUserInterface rawUserInterface,

src/PowerShellEditorServices/Session/Host/SimplePSHostRawUserInterface.cs

@@ -31,7 +31,7 @@ public class SimplePSHostRawUserInterface : PSHostRawUserInterface
         /// Creates a new instance of the SimplePSHostRawUserInterface
         /// class with the given IConsoleHost implementation.
         /// </summary>
-        /// <param name="logger">the ILogger to use for this instance.</param>
+        /// <param name="logger">The ILogger implementation to use for this instance.</param>
         public SimplePSHostRawUserInterface(ILogger logger)
         {
             this.Logger = logger;

src/PowerShellEditorServices/Session/Host/TerminalPSHostRawUserInterface.cs

@@ -31,7 +31,7 @@ internal class TerminalPSHostRawUserInterface : PSHostRawUserInterface
         /// Creates a new instance of the TerminalPSHostRawUserInterface
         /// class with the given IConsoleHost implementation.
         /// </summary>
-        /// <param name="logger">the ILogger to use for this instance.</param>
+        /// <param name="logger">The ILogger implementation to use for this instance.</param>
         public TerminalPSHostRawUserInterface(ILogger logger)
         {
             this.Logger = logger;

src/PowerShellEditorServices/Session/Host/TerminalPSHostUserInterface.cs

@@ -31,7 +31,7 @@ public class TerminalPSHostUserInterface : EditorServicesPSHostUserInterface
         /// class with the given IConsoleHost implementation.
         /// </summary>
         /// <param name="powerShellContext">The PowerShellContext to use for executing commands.</param>
-        /// <param name="logger">Logger to use for this host.</param>
+        /// <param name="logger">An ILogger implementation to use for this host.</param>
         public TerminalPSHostUserInterface(
             PowerShellContext powerShellContext,
             ILogger logger)

src/PowerShellEditorServices/Session/PowerShellContext.cs

@@ -116,7 +116,7 @@ public RunspaceDetails CurrentRunspace
         /// <summary>
         ///
         /// </summary>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public PowerShellContext(ILogger logger)
         {
             this.logger = logger;
@@ -130,7 +130,7 @@ public PowerShellContext(ILogger logger)
         /// <param name="hostUserInterface">
         /// The EditorServicesPSHostUserInterface to use for this instance.
         /// </param>
-        /// <param name="logger">Logger to use for this instance.</param>
+        /// <param name="logger">An ILogger implementation to use for this instance.</param>
         /// <returns></returns>
         public static Runspace CreateRunspace(
             HostDetails hostDetails,

src/PowerShellEditorServices/Session/PowerShellVersionDetails.cs

@@ -90,7 +90,7 @@ public PowerShellVersionDetails(
         /// Gets the PowerShell version details for the given runspace.
         /// </summary>
         /// <param name="runspace">The runspace for which version details will be gathered.</param>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         /// <returns>A new PowerShellVersionDetails instance.</returns>
         public static PowerShellVersionDetails GetVersionDetails(Runspace runspace, ILogger logger)
         {

src/PowerShellEditorServices/Session/RemoteFileManager.cs

@@ -242,7 +242,7 @@ function New-EditorFile {
         /// <param name="editorOperations">
         /// The IEditorOperations instance to use for opening/closing files in the editor.
         /// </param>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public RemoteFileManager(
             PowerShellContext powerShellContext,
             IEditorOperations editorOperations,

src/PowerShellEditorServices/Session/RunspaceDetails.cs

@@ -183,7 +183,7 @@ internal bool HasCapability<TCapability>()
         /// <param name="sessionDetails">
         /// The SessionDetails for the runspace.
         /// </param>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         /// <returns>A new RunspaceDetails instance.</returns>
         internal static RunspaceDetails CreateFromRunspace(
             Runspace runspace,

src/PowerShellEditorServices/Templates/TemplateService.cs

@@ -33,7 +33,7 @@ public class TemplateService
         /// Creates a new instance of the TemplateService class.
         /// </summary>
         /// <param name="powerShellContext">The PowerShellContext to use for this service.</param>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public TemplateService(PowerShellContext powerShellContext, ILogger logger)
         {
             Validate.IsNotNull(nameof(powerShellContext), powerShellContext);

src/PowerShellEditorServices/Utility/AsyncContext.cs

@@ -23,7 +23,7 @@ public static class AsyncContext
         /// The Task-returning Func which represents the "main" function
         /// for the thread.
         /// </param>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public static void Start(Func<Task> asyncMainFunc, ILogger logger)
         {
             // Is there already a synchronization context?

src/PowerShellEditorServices/Utility/AsyncContextThread.cs

@@ -47,7 +47,7 @@ public AsyncContextThread(string threadName)
         /// <param name="taskReturningFunc">
         /// A Func which returns the task to be run on the thread.
         /// </param>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         /// <returns>
         /// A Task which can be used to monitor the thread for completion.
         /// </returns>

src/PowerShellEditorServices/Utility/ThreadSynchronizationContext.cs

@@ -29,7 +29,7 @@ public class ThreadSynchronizationContext : SynchronizationContext
         /// <summary>
         ///
         /// </summary>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public ThreadSynchronizationContext(ILogger logger)
         {
             this.logger = logger;

src/PowerShellEditorServices/Workspace/Workspace.cs

@@ -42,7 +42,7 @@ public class Workspace
         /// Creates a new instance of the Workspace class.
         /// </summary>
         /// <param name="powerShellVersion">The version of PowerShell for which scripts will be parsed.</param>
-        /// <param name="logger">Logger used for writing log messages.</param>
+        /// <param name="logger">An ILogger implementation used for writing log messages.</param>
         public Workspace(Version powerShellVersion, ILogger logger)
         {
             this.powerShellVersion = powerShellVersion;