From 3e65d8b605ee42d9e412592ca0c360f2833eb645 Mon Sep 17 00:00:00 2001 From: Hilary James Oliver Date: Thu, 13 Feb 2025 11:48:20 +1300 Subject: [PATCH] Clarify task glob help. --- cylc/flow/option_parsers.py | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/cylc/flow/option_parsers.py b/cylc/flow/option_parsers.py index 8a4245a6a94..c51221bc4eb 100644 --- a/cylc/flow/option_parsers.py +++ b/cylc/flow/option_parsers.py @@ -242,19 +242,20 @@ class CylcOptionParser(OptionParser): MULTITASK_USAGE = dedent(''' This command can operate on multiple tasks. Globs and selectors may - be used to match active tasks: + be used to match tasks in the n=0 active window (except in the + `cylc show` command, where globs match in the wider n-window): Multiple Tasks: # Operate on two tasks workflow //cycle-1/task-1 //cycle-2/task-2 - Globs (note: globs should be quoted and only match active tasks): - # Match any active task "foo" in all cycles + Globs (note: quote globs; they only match in the active-window): + # Match any active-window task "foo" in all cycles '//*/foo' # Match the tasks "foo-1" and "foo-2" '//*/foo-[12]' - Selectors (note: selectors only match active tasks): + Selectors (note: selectors only match in the active window too): # match all failed tasks in cycle "1" //1:failed