App-Cmd icon indicating copy to clipboard operation
App-Cmd copied to clipboard

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

Open rjbs opened this issue 12 years ago • 1 comments

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

rjbs avatar Feb 01 '13 03:02 rjbs

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 #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)

jayallen avatar May 18 '16 07:05 jayallen