Specify different help_templates for about and long_about with derive?

[sdruskat]

First-time clap user here, thanks for creating a very useful crate!

I'm wondering if it is possible (or perhaps a useful feature) to be able to define separate help_templates for about and long_about?

E.g., in my case I'd like to be able to include author and version information in --help output, but not in -h output.

This is currently what I have:

#[derive(Parser)]
#[command(
    author = "My Name <[email protected]>", 
    version = "0.1.0", 
    about = "Brief description", 
    long_about = None,
    help_template = "\
{before-help}{name} {version}

{about-with-newline}
{usage-heading} {usage}

{all-args}

Author: {author-with-newline}{after-help}
"
)]

Displaying author could be hacked using after-long-help, but I can't see how displaying version would work.

Is this possible already, or am I asking for pub fn long_help_template(self, s: impl IntoResettable<StyledStr>) -> Command?

[epage]

Could you use before_help / before_long_help for this?

What I'm hoping to do is to decouple the help logic from the Command to allow for

• avoid the cost of the renderer if the user pre-formats help
• a hard coded renderer which would hopefully have a smaller code size
• custom renderers

So with that in mind and with the existing extension points the template supports, i would be inclined to not have a long vs short template.

[sdruskat]

Yes, sure, I'll use before_long_help for this, and completely understand your reasoning.
Thanks for getting back to me, and even more thanks for creating such a great crate! 🦀 🚀