Documentation: Missing SYNOPSIS in App::Cmd::Subdispatch (rt64299)

[rjbs]

https://rt.cpan.org/Ticket/Display.html?id=64299

I know in principle what A::C::S is supposed to do, but I have no idea
how to use it in my code. Even just a single example would help...

Mark.

Mark Lawrence

[jayallen]

Yeah, I actually pored through the tests to find out and—after a massive number of issues caused, I think, primarily because I was also using a base command class in addition to a nested command—I finally did...but then I ran into #35 and gave up.

It would be great to see:

1. Better docs around this including examples of using a base command class in addition to a subcommand
2. Support in App::Cmd::Setup for subdispatch to keep things consistent
3. Fixing subdispatch commands are promoted to top level commands #35 because the current display of subcommands is too confusing to unleash on users
4. Examples of using subcommands with the same names (e.g. myapp foo list and mysql bar list) which gave me errors because of duplicate command names (though I admit without good documentation I may have been doing it wrong)