diff options
author | Thayne McCombs <astrothayne@gmail.com> | 2023-10-22 23:16:40 -0600 |
---|---|---|
committer | David Peter <sharkdp@users.noreply.github.com> | 2023-10-23 08:34:15 +0200 |
commit | c6fcdbe000d2ac0161eaba524f020d6ccdbc50d5 (patch) | |
tree | 0d150adc2340b284be0e47e649e85b7e5387d572 /src | |
parent | 306dacd0b41c52392d49e2a24564c94790168782 (diff) |
docs: Explicitly warn against relying on result order for exec
Supersedes: #1230
Fixes: #1228
Diffstat (limited to 'src')
-rw-r--r-- | src/cli.rs | 2 |
1 files changed, 2 insertions, 0 deletions
@@ -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 \ |