Less hidden aliases

[joshtriplett]

.alias creates a hidden subcommand. For user convenience, I'd like to create an un-hidden subcommand, shown in help (with a help string like "alias for othercmd").

[kbknapp]

Interesting, I hadn't thought about that, but I like it. It'd be an easy addition. What would you call it? synonym, visible_alias? I'm open to ideas.

[joshtriplett]

I don't think synonym accurately conveys the distinction; if I saw functions for both alias and synonym, I couldn't guess at a glance about the distinction between them.

I'd suggest something explicit, like visible_alias.

[kbknapp]

This is implemented with #525

From the commit message:

This commit adds support for visible aliases, which function exactly like aliases except that they
also appear in the help message, using the help string of the aliased subcommand.

i.e.

App::new("myprog")
    .subcommand(SubCommand::with_name("test")
        .about("does testy things")
        .alias("invisible")
        .visible_alias("visible"));

When run with myprog --help, the output is:

myprog

USAGE:
    myprog [FLAGS] [SUBCOMMAND]

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

SUBCOMMANDS:
    help            Prints this message or the help of the given subcommand(s)
    test|visible    does testy things

[kbknapp]

Once #451 is implemented I'll update to 2.6.0 and upload to crates.io. So I'm hoping by tomorrow 😉