Remove duplicate SOS command docs

documentation/sos.md

@@ -19,8 +19,7 @@ Getting a version of lldb that works for your platform can be a problem sometime
 
 ## Using SOS
 
-* [SOS debugging for Linux/MacOS](sos-debugging-extension.md)
-* [SOS debugging for Windows](sos-debugging-extension-windows.md)
+* [SOS debugging](https://learn.microsoft.com/dotnet/core/diagnostics/sos-debugging-extension)
 * [Debugging a core dump](debugging-coredump.md)
 
 ## New SOS Features

src/Microsoft.Diagnostics.ExtensionCommands/DumpConcurrentDictionaryCommand.cs

@@ -8,7 +8,7 @@
 
 namespace Microsoft.Diagnostics.ExtensionCommands
 {
-    [Command(Name = "dumpconcurrentdictionary", Aliases = new string[] { "dcd" }, Help = "Display concurrent dictionary content.")]
+    [Command(Name = "dumpconcurrentdictionary", Aliases = new string[] { "dcd" }, Help = "Displays concurrent dictionary content.")]
     public class DumpConcurrentDictionaryCommand : ExtensionCommandBase
     {
         [Argument(Help = "The address of a ConcurrentDictionary object.")]

src/Microsoft.Diagnostics.ExtensionCommands/DumpConcurrentQueueCommand.cs

@@ -8,7 +8,7 @@
 
 namespace Microsoft.Diagnostics.ExtensionCommands
 {
-    [Command(Name = "dumpconcurrentqueue", Aliases = new string[] { "dcq" }, Help = "Display concurrent queue content.")]
+    [Command(Name = "dumpconcurrentqueue", Aliases = new string[] { "dcq" }, Help = "Displays concurrent queue content.")]
     public class DumpConcurrentQueueCommand : ExtensionCommandBase
     {
         [Argument(Help = "The address of a ConcurrentQueue object.")]

src/Microsoft.Diagnostics.ExtensionCommands/Host/ConsoleLoggingCommand.cs

@@ -6,8 +6,8 @@
 
 namespace Microsoft.Diagnostics.ExtensionCommands
 {
-    [Command(Name = "logopen",  Help = "Enable console file logging", Flags = CommandFlags.Global)]
-    [Command(Name = "logclose", DefaultOptions = "--disable", Help = "Disable console file logging", Flags = CommandFlags.Global)]
+    [Command(Name = "logopen",  Help = "Enables console file logging.", Flags = CommandFlags.Global)]
+    [Command(Name = "logclose", DefaultOptions = "--disable", Help = "Disables console file logging.", Flags = CommandFlags.Global)]
     public class ConsoleLoggingCommand : CommandBase
     {
         public IConsoleFileLoggingService FileLoggingService { get; set; }

src/Microsoft.Diagnostics.ExtensionCommands/Host/LoggingCommand.cs

@@ -10,7 +10,7 @@
 
 namespace Microsoft.Diagnostics.ExtensionCommands
 {
-    [Command(Name = "logging", Help = "Enable/disable internal diagnostic logging", Flags = CommandFlags.Global)]
+    [Command(Name = "logging", Help = "Enables/disables internal diagnostic logging.", Flags = CommandFlags.Global)]
     public class LoggingCommand : CommandBase
     {
         public IDiagnosticLoggingService DiagnosticLoggingService { get; set; }

src/Microsoft.Diagnostics.ExtensionCommands/Host/RuntimesCommand.cs

@@ -4,15 +4,12 @@
 
 using Microsoft.Diagnostics.DebugServices;
 using Microsoft.Diagnostics.Runtime;
-using System;
 using System.Collections.Immutable;
 using System.Linq;
-using System.Runtime.InteropServices;
-using System.Text;
 
 namespace Microsoft.Diagnostics.ExtensionCommands
 {
-    [Command(Name = "runtimes", Help = "List the runtimes in the target or change the default runtime.")]
+    [Command(Name = "runtimes", Help = "Lists the runtimes in the target or changes the default runtime.")]
     public class RuntimesCommand : CommandBase
     {
         public IRuntimeService RuntimeService { get; set; }

src/Microsoft.Diagnostics.ExtensionCommands/Host/SetClrPathCommand.cs

@@ -7,7 +7,7 @@
 
 namespace Microsoft.Diagnostics.ExtensionCommands
 {
-    [Command(Name = "setclrpath", Help = "Set the path to load coreclr DAC/DBI files.")]
+    [Command(Name = "setclrpath", Help = "Sets the path to load coreclr DAC/DBI files.")]
     public class SetClrPath: CommandBase
     {
         public IRuntime Runtime { get; set; }

src/Microsoft.Diagnostics.ExtensionCommands/Host/SetSymbolServerCommand.cs

@@ -9,12 +9,12 @@ namespace Microsoft.Diagnostics.ExtensionCommands
     [Command(
         Name = "setsymbolserver",
         Aliases = new string[] { "SetSymbolServer" },
-        Help = "Enable and set symbol server support for symbols and module download",
+        Help = "Enables and sets symbol server support for symbols and module download.",
         Flags = CommandFlags.Global)]
     [Command(
         Name = "loadsymbols",
         DefaultOptions = "--loadsymbols",
-        Help = "Load symbols for all modules",
+        Help = "Loads symbols for all modules.",
         Flags = CommandFlags.Global)]
     public class SetSymbolServerCommand : CommandBase
     {

src/Microsoft.Diagnostics.ExtensionCommands/Host/StatusCommand.cs

@@ -7,7 +7,7 @@
 
 namespace Microsoft.Diagnostics.ExtensionCommands
 {
-    [Command(Name = "sosstatus", Help = "Display internal status or reset the internal cached state.")]
+    [Command(Name = "sosstatus", Help = "Displays internal status or resets the internal cached state.")]
     public class StatusCommand : CommandBase
     {
         public ITarget Target { get; set; }

src/Microsoft.Diagnostics.ExtensionCommands/ParallelStacksCommand.cs

@@ -9,7 +9,7 @@
 
 namespace Microsoft.Diagnostics.ExtensionCommands
 {
-    [Command(Name = "parallelstacks", Aliases = new string[] { "pstacks" }, Help = "Display merged threads stack a la Visual Studio 'Parallel Stacks' panel.")]
+    [Command(Name = "parallelstacks", Aliases = new string[] { "pstacks" }, Help = "Displays the merged threads stack similarly to the Visual Studio 'Parallel Stacks' panel.")]
     public class ParallelStacksCommand : ExtensionCommandBase
     {
         public ClrRuntime Runtime { get; set; }

src/Microsoft.Diagnostics.ExtensionCommands/TaskStateCommand.cs

@@ -7,7 +7,7 @@
 
 namespace Microsoft.Diagnostics.ExtensionCommands
 {
-    [Command(Name = "taskstate", Aliases = new string[] { "tks" }, Help = "Display a Task state in a human readable format.")]
+    [Command(Name = "taskstate", Aliases = new string[] { "tks" }, Help = "Displays a Task state in a human readable format.")]
     public class TaskStateCommand : ExtensionCommandBase
     {
         [Argument(Help = "The Task instance address.")]

src/Microsoft.Diagnostics.ExtensionCommands/ThreadPoolQueueCommand.cs

@@ -9,7 +9,7 @@
 
 namespace Microsoft.Diagnostics.ExtensionCommands
 {
-    [Command(Name = "threadpoolqueue", Aliases = new string[] { "tpq" }, Help = "Display queued ThreadPool work items.")]
+    [Command(Name = "threadpoolqueue", Aliases = new string[] { "tpq" }, Help = "Displays queued ThreadPool work items.")]
     public class ThreadPoolQueueCommand : ExtensionCommandBase
     {
         public override void ExtensionInvoke()

src/Microsoft.Diagnostics.ExtensionCommands/TimersCommand.cs

@@ -9,7 +9,7 @@
 
 namespace Microsoft.Diagnostics.ExtensionCommands
 {
-    [Command(Name = "timerinfo", Aliases = new string[] { "ti" }, Help = "Display running timers details.")]
+    [Command(Name = "timerinfo", Aliases = new string[] { "ti" }, Help = "Displays information about running timers.")]
     public class TimersCommand : ExtensionCommandBase
     {
         public override void ExtensionInvoke()

src/Microsoft.Diagnostics.Repl/ExitCommand.cs

@@ -7,7 +7,7 @@
 
 namespace Microsoft.Diagnostics.Repl
 {
-    [Command(Name = "exit", Aliases = new string[] { "quit", "q" }, Help = "Exit interactive mode.", Flags = CommandFlags.Global | CommandFlags.Manual)]
+    [Command(Name = "exit", Aliases = new string[] { "quit", "q" }, Help = "Exits interactive mode.", Flags = CommandFlags.Global | CommandFlags.Manual)]
     public class ExitCommand : CommandBase
     {
         private readonly Action _exit;

src/Microsoft.Diagnostics.Repl/HelpCommand.cs

@@ -7,7 +7,7 @@
 
 namespace Microsoft.Diagnostics.Repl
 {
-    [Command(Name = "help", Help = "Display help for a command.", Flags = CommandFlags.Global | CommandFlags.Manual)]
+    [Command(Name = "help", Help = "Displays help for a command.", Flags = CommandFlags.Global | CommandFlags.Manual)]
     public class HelpCommand : CommandBase
     {
         [Argument(Help = "Command to find help.")]

src/SOS/SOS.Hosting/Commands/SOSCommand.cs

@@ -10,16 +10,16 @@
 
 namespace SOS.Hosting
 {
-    [Command(Name = "analyzeoom",       DefaultOptions = "AnalyzeOOM",          Help = "Displays the info of the last OOM occurred on an allocation request to the GC heap.")]
+    [Command(Name = "analyzeoom",       DefaultOptions = "AnalyzeOOM",          Help = "Displays the info of the last OOM that occurred on an allocation request to the GC heap.")]
     [Command(Name = "clrstack",         DefaultOptions = "ClrStack",            Help = "Provides a stack trace of managed code only.")]
-    [Command(Name = "clrthreads",       DefaultOptions = "Threads",             Help = "List the managed threads running.")]
-    [Command(Name = "dbgout",           DefaultOptions = "dbgout",              Help = "Enable/disable (-off) internal SOS logging.")]
+    [Command(Name = "clrthreads",       DefaultOptions = "Threads",             Help = "Lists the managed threads running.")]
+    [Command(Name = "dbgout",           DefaultOptions = "dbgout",              Help = "Enables/disables (-off) internal SOS logging.")]
     [Command(Name = "dumpalc",          DefaultOptions = "DumpALC",             Help = "Displays details about a collectible AssemblyLoadContext into which the specified object is loaded.")]
     [Command(Name = "dumparray",        DefaultOptions = "DumpArray",           Help = "Displays details about a managed array.")]
     [Command(Name = "dumpassembly",     DefaultOptions = "DumpAssembly",        Help = "Displays details about an assembly.")]
     [Command(Name = "dumpclass",        DefaultOptions = "DumpClass",           Help = "Displays information about a EE class structure at the specified address.")]
     [Command(Name = "dumpdelegate",     DefaultOptions = "DumpDelegate",        Help = "Displays information about a delegate.")]
-    [Command(Name = "dumpdomain",       DefaultOptions = "DumpDomain",          Help = "Displays information all the AppDomains and all assemblies within the domains.")]
+    [Command(Name = "dumpdomain",       DefaultOptions = "DumpDomain",          Help = "Displays the Microsoft intermediate language (MSIL) that's associated with a managed method.")]
     [Command(Name = "dumpgcdata",       DefaultOptions = "DumpGCData",          Help = "Displays information about the GC data.")]
     [Command(Name = "dumpheap",         DefaultOptions = "DumpHeap",            Help = "Displays info about the garbage-collected heap and collection statistics about objects.")]
     [Command(Name = "dumpil",           DefaultOptions = "DumpIL",              Help = "Displays the Microsoft intermediate language (MSIL) that is associated with a managed method.")]
@@ -28,30 +28,30 @@ namespace SOS.Hosting
     [Command(Name = "dumpmodule",       DefaultOptions = "DumpModule",          Help = "Displays information about a EE module structure at the specified address.")]
     [Command(Name = "dumpmt",           DefaultOptions = "DumpMT",              Help = "Displays information about a method table at the specified address.")]
     [Command(Name = "dumpobj",          DefaultOptions = "DumpObj",             Aliases = new string[] { "do" }, Help = "Displays info about an object at the specified address.")]
-    [Command(Name = "dumpruntimetypes", DefaultOptions = "DumpRuntimeTypes",    Help = "Finds all System.RuntimeType objects in the gc heap and prints the type name and MethodTable they refer too.")]
-    [Command(Name = "dumpsig",          DefaultOptions = "DumpSig",             Help = "This command dumps the signature of a method or field given by <sigaddr> <moduleaddr>.")]
-    [Command(Name = "dumpsigelem",      DefaultOptions = "DumpSigElem",         Help = "This command dumps a single element of a signature object.")]
+    [Command(Name = "dumpruntimetypes", DefaultOptions = "DumpRuntimeTypes",    Help = "Finds all System.RuntimeType objects in the GC heap and prints the type name and MethodTable they refer too.")]
+    [Command(Name = "dumpsig",          DefaultOptions = "DumpSig",             Help = "Dumps the signature of a method or field specified by <sigaddr> <moduleaddr>.")]
+    [Command(Name = "dumpsigelem",      DefaultOptions = "DumpSigElem",         Help = "Dumps a single element of a signature object.")]
     [Command(Name = "dumpstackobjects", DefaultOptions = "DumpStackObjects",    Aliases = new string[] { "dso" }, Help = "Displays all managed objects found within the bounds of the current stack.")]
     [Command(Name = "dumpvc",           DefaultOptions = "DumpVC",              Help = "Displays info about the fields of a value class.")]
     [Command(Name = "eeheap",           DefaultOptions = "EEHeap",              Help = "Displays info about process memory consumed by internal runtime data structures.")]
     [Command(Name = "eeversion",        DefaultOptions = "EEVersion",           Help = "Displays information about the runtime version.")]
-    [Command(Name = "ehinfo",           DefaultOptions = "EHInfo",              Help = "Displays the exception handling blocks in a jitted method.")]
+    [Command(Name = "ehinfo",           DefaultOptions = "EHInfo",              Help = "Displays the exception handling blocks in a JIT-ed method.")]
     [Command(Name = "enummem",          DefaultOptions = "enummem",             Help = "ICLRDataEnumMemoryRegions.EnumMemoryRegions test command.")]
     [Command(Name = "finalizequeue",    DefaultOptions = "FinalizeQueue",       Help = "Displays all objects registered for finalization.")]
     [Command(Name = "findappdomain",    DefaultOptions = "FindAppDomain",       Help = "Attempts to resolve the AppDomain of a GC object.")]
     [Command(Name = "gchandles",        DefaultOptions = "GCHandles",           Help = "Provides statistics about GCHandles in the process.")]
-    [Command(Name = "gcheapstat",       DefaultOptions = "GCHeapStat",          Help = "Display various GC heap stats.")]
+    [Command(Name = "gcheapstat",       DefaultOptions = "GCHeapStat",          Help = "Displays various GC heap stats.")]
     [Command(Name = "gcroot",           DefaultOptions = "GCRoot",              Help = "Displays info about references (or roots) to an object at the specified address.")]
-    [Command(Name = "gcinfo",           DefaultOptions = "GCInfo",              Help = "Displays info JIT GC encoding for a method.")]
-    [Command(Name = "gcwhere",          DefaultOptions = "GCWhere",             Help = "Displays the location in the GC heap of the argument passed in.")]
+    [Command(Name = "gcinfo",           DefaultOptions = "GCInfo",              Help = "Displays JIT GC encoding for a method.")]
+    [Command(Name = "gcwhere",          DefaultOptions = "GCWhere",             Help = "Displays the location in the GC heap of the specified address.")]
     [Command(Name = "histclear",        DefaultOptions = "HistClear",           Help = "Releases any resources used by the family of Hist commands.")]
     [Command(Name = "histinit",         DefaultOptions = "HistInit",            Help = "Initializes the SOS structures from the stress log saved in the debuggee.")]
     [Command(Name = "histobj",          DefaultOptions = "HistObj",             Help = "Examines all stress log relocation records and displays the chain of garbage collection relocations that may have led to the address passed in as an argument.")]
     [Command(Name = "histobjfind",      DefaultOptions = "HistObjFind",         Help = "Displays all the log entries that reference an object at the specified address.")]
     [Command(Name = "histroot",         DefaultOptions = "HistRoot",            Help = "Displays information related to both promotions and relocations of the specified root.")]
     [Command(Name = "histstats",        DefaultOptions = "HistStats",           Help = "Displays stress log stats.")]
     [Command(Name = "ip2md",            DefaultOptions = "IP2MD",               Help = "Displays the MethodDesc structure at the specified address in code that has been JIT-compiled.")]
-    [Command(Name = "listnearobj",      DefaultOptions = "ListNearObj",         Help = "Displays the object preceding and succeeding the address specified.")]
+    [Command(Name = "listnearobj",      DefaultOptions = "ListNearObj",         Help = "Displays the object preceding and succeeding the specified address.")]
     [Command(Name = "name2ee",          DefaultOptions = "Name2EE",             Help = "Displays the MethodTable structure and EEClass structure for the specified type or method in the specified module.")]
     [Command(Name = "objsize",          DefaultOptions = "ObjSize",             Help = "Lists the sizes of the all the objects found on managed threads.")]
     [Command(Name = "pathto",           DefaultOptions = "PathTo",              Help = "Displays the GC path from <root> to <target>.")]