docs(src): add missing XML docs and strip tracking-ID comments

Sweep of 203 source files resolving CommentChecker findings: add
<summary>/<param>/<returns>/<inheritdoc> where missing, and remove
resolved task/issue tracking markers (Tests-NNN, Worker-NNN, Server-NNN,
Task N) from code comments. Comment/doc-only — no logic changes.
Server+Tests build clean under TreatWarningsAsErrors.
This commit is contained in:
Joseph Doherty
2026-07-07 14:09:49 -04:00
parent 8914472706
commit fca978de07
203 changed files with 1834 additions and 1383 deletions
@@ -555,6 +555,13 @@ public sealed class AlarmSubtagLiveSmokeTests
internal int ptY;
}
/// <summary>Checks the thread message queue for a message, optionally removing it.</summary>
/// <param name="lpMsg">Receives the retrieved message.</param>
/// <param name="hWnd">Window handle to filter messages for, or <see cref="IntPtr.Zero"/> for any window owned by the calling thread.</param>
/// <param name="wMsgFilterMin">Lowest message value to examine.</param>
/// <param name="wMsgFilterMax">Highest message value to examine.</param>
/// <param name="wRemoveMsg">Specifies how the message is handled (e.g. <see cref="PM_REMOVE"/>).</param>
/// <returns><see langword="true"/> if a message is available; otherwise <see langword="false"/>.</returns>
[DllImport("user32.dll")]
[return: MarshalAs(UnmanagedType.Bool)]
internal static extern bool PeekMessage(
@@ -564,10 +571,16 @@ public sealed class AlarmSubtagLiveSmokeTests
uint wMsgFilterMax,
uint wRemoveMsg);
/// <summary>Translates virtual-key messages into character messages.</summary>
/// <param name="lpMsg">The message to translate.</param>
/// <returns><see langword="true"/> if the message was translated; otherwise <see langword="false"/>.</returns>
[DllImport("user32.dll")]
[return: MarshalAs(UnmanagedType.Bool)]
internal static extern bool TranslateMessage(ref MSG lpMsg);
/// <summary>Dispatches a message to the window procedure.</summary>
/// <param name="lpmsg">The message to dispatch.</param>
/// <returns>The value returned by the window procedure.</returns>
[DllImport("user32.dll")]
internal static extern IntPtr DispatchMessage(ref MSG lpmsg);
}
@@ -27,7 +27,7 @@ public sealed class WnWrapConsumerProbeTests
private static readonly string SubscriptionExpression =
$@"\\{MachineName}\Galaxy!DEV";
// XML query form — per WIN-911 / ArchestrA reference. NODE is the
// XML query form — per ArchestrA reference. NODE is the
// machine, PROVIDER is the literal "Galaxy", GROUP is the area.
private static readonly string XmlAlarmQuery =
"<QUERIES FROM_PRIORITY=\"1\" TO_PRIORITY=\"999\" ALARM_STATE=\"ALL\" DISPLAY_MODE=\"Summary\">" +