summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorThayne McCombs <astrothayne@gmail.com>2023-10-22 23:16:40 -0600
committerDavid Peter <sharkdp@users.noreply.github.com>2023-10-23 08:34:15 +0200
commitc6fcdbe000d2ac0161eaba524f020d6ccdbc50d5 (patch)
tree0d150adc2340b284be0e47e649e85b7e5387d572 /src
parent306dacd0b41c52392d49e2a24564c94790168782 (diff)
docs: Explicitly warn against relying on result order for exec
Supersedes: #1230 Fixes: #1228
Diffstat (limited to 'src')
-rw-r--r--src/cli.rs2
1 files changed, 2 insertions, 0 deletions
diff --git a/src/cli.rs b/src/cli.rs
index c2217b7..820249a 100644
--- a/src/cli.rs
+++ b/src/cli.rs
@@ -804,6 +804,7 @@ impl clap::Args for Exec {
.help("Execute a command for each search result")
.long_help(
"Execute a command for each search result in parallel (use --threads=1 for sequential command execution). \
+ There is no guarantee of the order commands are executed in, and the order should not be depended upon. \
All positional arguments following --exec are considered to be arguments to the command - not to fd. \
It is therefore recommended to place the '-x'/'--exec' option last.\n\
The following placeholders are substituted before the command is executed:\n \
@@ -838,6 +839,7 @@ impl clap::Args for Exec {
.help("Execute a command with all search results at once")
.long_help(
"Execute the given command once, with all search results as arguments.\n\
+ The order of the arguments is non-deterministic, and should not be relied upon.\n\
One of the following placeholders is substituted before the command is executed:\n \
'{}': path (of all search results)\n \
'{/}': basename\n \