help text does not include --debug as an option

[Nick Veitch]

The help text output for juju doesn't list the --debug option along with the other ooptions available for a command.

[Anastasia (anastasia-macmood)]

From a conversation elsewhere...

From howbazaar:

I feel that what we really want is a section in the help that lists all the inherited flags from the supercommand.
--debug
--show-log
--logging-config
--verbose
--quiet

There is a reason we don't have these on every single command, but if we could have them grouped, it would be more palatable. Although this probably needs to be fixed at the github.com/juju/cmd package level.

From @anastasiamac:

Agreed, I feel like we should have all these options available through 'help' on every command. I am happy to group them after all the command options, although I do not see why we cannot just mix supercommand options among command-specific options and order all alphabetically. I'll add this to the bug.

[Peter Matulis (petermatulis)]

Please also see `juju help global-options`.

[Anastasia (anastasia-macmood)]

Personally, I do not like the idea of 'juju help global-options' because you need to know that those exist, you need to know how to look for them, etc.

All options that a command can use should be listed as part of the help for that command.

[Anastasia (anastasia-macmood)]

PR for 2.5: https://github.com/juju/juju/pull/9563

[Anastasia (anastasia-macmood)]

There is the desire to have Global Options grouped separately from the command-specific options. To achieve this, the initial work needs to happen in juju/cmd. I will close the PR I've proposed in juju/juju and will circle back to it when ready.

[Anastasia (anastasia-macmood)]

As it was decided that global options are best grouped, I have written a new PR for juju/cmd - https://github.com/juju/cmd/pull/60

Once this lands, it will be a one line production code change to enable Juju to display gloabl options on command help.

[Anastasia (anastasia-macmood)]

Juju PR against develop (heading into 2.6): https://github.com/juju/juju/pull/9633

[Anastasia (anastasia-macmood)]

PR for 2.5: https://github.com/juju/juju/pull/9649