Remove redundant braces in ArgGroup synopsis #1572
Labels
theme: arg-group
An issue or change related to argument groups
theme: usagehelp
An issue or change related to the usage help message
type: enhancement ✨
Milestone
Argument groups that are optional (
multiplicity = "0..1"
) are shown in[
and]
square brackets in the synopsis.Argument groups that are required (
multiplicity = "1"
) are shown in(
and)
round brackets in the synopsis.This may result in redundant round braces for groups or subgroups that have only a single option or positional parameter, and do not have subgroups themselves. For example:
Gives a synopsis like this:
It would be more natural if the nested group (that only has one option and no subgroups) was shown without braces:
Optional groups should not be impacted by this: the
[
and]
square brackets are not redundant. (We can look at further improvements in the future.)The text was updated successfully, but these errors were encountered: