Grouping ArgGroup in help message?

[tobiasvl]

Python's argparse module groups arguments in an argument group together in the --help message; see the documentation for examples.

Can clap do the same with its ArgGroups? If so, how? I can't seem to make it work. All the arguments seem to be lumped together in one alphabetical list.

[epage]

In clap, ArgGroup is meant to create an alias for a group of arguments and may have its own validation rules. One argument can belong to multiple groups.

In argparse, add_argument_group is more visual while add_mutually_exclusive_group is closer to what ArgGroup does but is still less powerful (only handles mutually exclusive, only one group allows).

For creating sections in the help, what you want is Arg::help_heading or Command::next_help_heading.

[tobiasvl]

Thank you!

[alkeryn]

hey, i know it's an old thread, but do you know how you can add a description to a section?

stuff like

Additional Options: these options are used for bla bla bla.

[epage]

We do not support it at this time. See #4589