Amend CLI globbing help text (7.8.x)

[hjoliver]

7.8.x companion of #3302

---

This is a small change with no associated Issue.

Requirements check-list

• I have read CONTRIBUTING.md and added my name as a Code Contributor.
• Contains logically grouped changes (else tidy your branch by rebase).
• Does not contain off-topic changes (use other PRs for other changes).
• Does not need tests (CLI help text only).
• Appropriate change log entry included.
• No documentation update required (is documentation).

[sadielbartholomew]

Just raising a few minor points that we might want to change. One is that I think it might be better to have the warning before the info about task globbing, as that seems more general & important, & the examples at the end mostly concern globbing usage? I.e. from the current form:

<... task info>
To kill one or more tasks, "cylc kill REG TASK_GLOB ..."; to kill all active
tasks: "cylc kill REG".

TASK_GLOB is a pattern to match tasks, or families, or groups of them, in
the task pool:
* [CYCLE-POINT-GLOB/]TASK-NAME-GLOB[:TASK-STATE]
<... other glob examples>

WARNING: this command matches and operates on task proxy instances in the
scheduler task pool, NOT abstract tasks in the workflow. If a task is not
currently represented in the pool you must use "cylc insert" to add it in.

For example, to match:
* all tasks in a cycle: '20200202T0000Z/*' or '*.20200202T0000Z'
<... other examples>

to:

<... task info>
To kill one or more tasks, "cylc kill REG TASK_GLOB ..."; to kill all active
tasks: "cylc kill REG".

WARNING: this command matches and operates on task proxy instances in the
scheduler task pool, NOT abstract tasks in the workflow. If a task is not
currently represented in the pool you must use "cylc insert" to add it in.

TASK_GLOB is a pattern to match tasks, or families, or groups of them, in
the task pool:
* [CYCLE-POINT-GLOB/]TASK-NAME-GLOB[:TASK-STATE]
<... other glob examples>

For example, to match:
* all tasks in a cycle: '20200202T0000Z/*' or '*.20200202T0000Z'
<... other examples>

[hjoliver]

@sadielbartholomew - I agree with changing the order as you suggest; will amend the branch tomorrow.

[hjoliver]

Hopefully good to go now @sadielbartholomew. I ended up trying to fix some additional ambiguities in task-targetting CLI help docs.

[hjoliver]

One genuine test failure, damn it.

[hjoliver]

Fixed.

[hjoliver]

(But the PR has not updated with my last pushed commit ... GitHub reacting slowly 🤔 )

[sadielbartholomew]

GitHub reacting slowly

There's a major outage according to GH status :( I'll wait upon that final commit before reviewing prematurely again!

[hjoliver]

GitHub booted to updated the PR; tests all passed 🎉

[sadielbartholomew]

Testing as displaying new content in the correct manner for the `--help`` output of a sample of the commands influenced by the changes, without any adverse affects., as per the test battery. Great.