Visually grouping arguments in help message

[hoijui]

Some CLIs have a lot of arguments/options, e.g. vlc or yt-dlp.
While vlc --help only shows the essential ones, and shows the rest only with vls --help --advanced, yt-dlp --help shows all of them, but it visually groups them, showing a sub-heading for each group of arguments. Examples of such groups are: "Video Format Options", "Authentication Options", "Post-Processing Options". The most important group of options is shown first.

In my particular case, I do not have that many options, but I have a few that are essential, which will be interesting to most users, and the the rest (3/4) will only be used in very special cases. Thus to de-clutter the help a bit, and make the CLI more user-friendly, I would like users to find the essential options first, so they do not have to scan through all the options with their eyes. I though of visually grouping the options, but it seems like ArgGroup can't do that, and I did not find any other way of doing it.

Is there a way, or how else would you handle this?

[epage]

Some parsers mix validation and visual groups while we keep them as separate concepts. What you are looking for is https://docs.rs/clap/latest/clap/struct.Arg.html#method.help_heading

[hoijui]

wow cool! :-)
thank you @epage !

If I would add a NOTE on the doc comment for ArgGroup at the end, linking to this, do you think it would be accept/a good idea?
It would have helped me.

... and indeed, makes more sense this way (separated).

[epage]

Thanks for the reminder. I was thinking of something similar but forgot by the time I got to a computer to do it.

I've posted #6177.

I also wonder if I should provide a "help concepts" section for https://docs.rs/clap/latest/clap/_concepts/index.html which steps through the help output and what overrides it.

[hoijui]

wow, these changes are perfect, thank you! :-)
... would have been perfect for me.

About the help concepts question... I can't say ... for me, these changes certainly would have been enough.