Should we separate arguments by help_heading in clap_man?

[epage]

Please complete the following tasks

• I have searched the discussions
• I have searched the existing issues

Clap Version

v3.0.6

Describe your use case

If a user splits up args logically, we should probably do the same thing in man pages.

How will it look?

Describe the solution you'd like

Group by help heading

Alternatives, if applicable

No response

Additional Context

Split out of #3174

[oldwomanjosiah]

I like this idea quite a bit, are you thinking that it would use flatten modifier to differentiate sections?

[epage]

are you thinking that it would use flatten modifier to differentiate sections?

Could you clarify what you mean?

[crazyscot]

Closely related, it would be useful if clap_mangen also took display_order() into account.

[0xAdk]

I don't think there is a good reason to throw away information by just grouping all options together. Since the options are given categories it makes sense to show that in the manpages.

[epage]

This was closed by #5854