From e96ba28879287b6b4ca6d02d36812e6a97430979 Mon Sep 17 00:00:00 2001 From: hxperl <16929288+hxperl@users.noreply.github.com> Date: Fri, 11 Sep 2026 13:36:06 +0900 Subject: [PATCH] Unbacktick the `target` parameter name so DocC recognises it `FileDescriptor.duplicate(as:retryOnInterrupt:)` writes its first parameter entry as ``- `target`:`` rather than `- target:`. DocC matches parameter documentation by the bare identifier, so the backticked entry is not associated with the parameter: the description is dropped from the rendered parameter list and DocC reports the parameter as undocumented. The `duplicate(as:options:retryOnInterrupt:)` overload twenty lines below documents the same parameter without backticks, which is what this changes the first overload to match. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01MDv2d3fEYCVWGpu7AgD4qq --- Sources/System/FileOperations.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/System/FileOperations.swift b/Sources/System/FileOperations.swift index 1c7af68..746e6ae 100644 --- a/Sources/System/FileOperations.swift +++ b/Sources/System/FileOperations.swift @@ -381,7 +381,7 @@ extension FileDescriptor { /// Duplicates this file descriptor and returns the newly created copy. /// /// - Parameters: - /// - `target`: The desired target file descriptor, or `nil`, in which case + /// - target: The desired target file descriptor, or `nil`, in which case /// the copy is assigned to the file descriptor with the lowest raw value /// that is not currently in use by the process. /// - retryOnInterrupt: Whether to retry the duplicate operation