print --no-[arg] in usage text #176
Description
Describe the feature
When defining a boolean argument (e.g. --arg) that is enabled by default we currently print --no-arg usage.
I have some suggestions on this:
Only print --no-arg usage if negativeDescription is defined
While making changes to nuxt/cli I found it confusing that --no-arg is printed while the description described what happens if true is passed.
This can be made more explicit by only printing the --no-arg when a negativeDescription is defined, I realize this property was a later addition.
Always print both --arg and --no-arg
Printing both the normal usage and the negative usage (perhaps indented/nested) communicates to the end user that this is the same argument, it will be easier to find in the source code as well.
Only print aliases for the defined command (no negative aliases)
Not sure if intentional but the printed usage also applies the negative prefixes to defined aliases, this can look odd if an alias is a single character (e.g. -p, --production becomes --no-p, --no-production).
Personally I view the negative arguments as a kind of alias already, having negative versions of the aliases seems to go beyond convenience.
Removed last point, should be separate issue (out of scope for this issue)
Maybe the current behavior is as intended/desired, let me know! If not, I would be happy to help make implement the suggestions.
Additional information
- Would you be willing to help implement this feature?