From 9d0fb12a8f377fea9e5496e48b5741fe7d2d1a97 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Thu, 17 Sep 2026 20:18:59 -0700 Subject: [PATCH] std.Build.Step.Option: clarify addOptionPathUntracked in particular, that it may be a file or directory --- lib/std/Build/Step/Options.zig | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/lib/std/Build/Step/Options.zig b/lib/std/Build/Step/Options.zig index b616306dbe755cce5855295aead29935e4ff31cd..5f5b2a41cfd19e97667525014678315dc9bbcbf1 100644 --- a/lib/std/Build/Step/Options.zig +++ b/lib/std/Build/Step/Options.zig @@ -439,10 +439,9 @@ pub fn addOptionPath(options: *Options, name: []const u8, path: LazyPath) void { path.addStepDependencies(&options.step); } -/// The added option has type `[]const u8` and value of the provided path. -/// This interface treats the resolved path string as pure data, meaning it -/// does not track anything about the meaning or contents of this path, and -/// therefore also does not create any related dependencies. +/// The added option has type `[]const u8` and value of the provided path. The resolved path is interpreted as +/// a string without tracking anything about the meaning or contents, and therefore may be a file, directory, +/// not exist, or even be an invalid path, and likewise does not create any file system or `Step` dependencies. /// /// See also: /// * `addOptionPath` -- 2.54.0