docs(xml): fill missing XML doc comments + strip task-tracking refs across src (fixdocs)
Add missing <summary>/<param>/<returns>/<typeparam> tags and switch interface implementations to <inheritdoc/> across 106 files; strip project bookkeeping identifiers (Task NN, #05-TNN, PLAN-04, StoreAndForward-0NN) from shipped code comments while preserving the descriptive rationale. Comment-only: zero code-logic lines changed; solution builds 0/0. Claude-Session: https://claude.ai/code/session_01MtdgwpEeCUn6cUA5f1LMPj
This commit is contained in:
@@ -192,6 +192,12 @@ internal static class AddressSpaceSearch
|
||||
/// <see cref="IBrowsableDataConnection.BrowseChildrenAsync"/>
|
||||
/// (parentNodeId, continuationToken, ct) → page of children.
|
||||
/// </summary>
|
||||
/// <param name="browse">Delegate that pages the children of a node: (parentNodeId, continuationToken, ct) → page of children.</param>
|
||||
/// <param name="query">Case-insensitive substring matched against each node's DisplayName and root-relative path; empty/whitespace matches nothing.</param>
|
||||
/// <param name="maxDepth">Maximum number of levels below the root to descend.</param>
|
||||
/// <param name="maxResults">Maximum matches to return; when reached the walk stops early and the result's CapReached flag is set.</param>
|
||||
/// <param name="cancellationToken">A cancellation token that can be used to cancel the operation.</param>
|
||||
/// <returns>A task that completes with the matches found and a flag indicating whether a bound cut the walk short.</returns>
|
||||
internal static async Task<AddressSpaceSearchResult> SearchAsync(
|
||||
Func<string?, string?, CancellationToken, Task<BrowseChildrenResult>> browse,
|
||||
string query,
|
||||
|
||||
@@ -75,6 +75,8 @@ public static class MxGatewayAlarmMapper
|
||||
/// so numeric values always use '.' as the decimal separator. Null or unset
|
||||
/// values produce an empty string.
|
||||
/// </summary>
|
||||
/// <param name="mxVal">The gateway value union to convert, or null.</param>
|
||||
/// <returns>The value formatted as an invariant-culture string, or an empty string if null or unset.</returns>
|
||||
internal static string MxValueToString(MxValue? mxVal)
|
||||
{
|
||||
if (mxVal is null) return "";
|
||||
|
||||
@@ -1008,7 +1008,7 @@ public class RealOpcUaClient : IOpcUaClient
|
||||
{
|
||||
// Fail fast with the typed exception when the link is down — mirrors the
|
||||
// BrowseChildrenAsync guard. (BrowseChildrenAsync would also throw on the
|
||||
// first page, but guarding here keeps the empty-query / cap-0 short-circuit
|
||||
// first page, but guarding here keeps the empty-query / zero-cap short-circuit
|
||||
// from masking a disconnected session.)
|
||||
var session = _session;
|
||||
if (session is null || !session.Connected)
|
||||
|
||||
Reference in New Issue
Block a user