[dancer-users] Help with the dancer2 command

[Jason A. Crome]

As best as I can explain it: 
- dancer2 on its own doesn't have enough information to do something, so it shows you a help page to point you in the right direction. This is the equivalent of just asking for help with dancer2 -h

- dancer2 help gen or dancer2 -h gen or dancer2 gen -h are all ways for invoking help on a subcommand (in this case, gen)

This is consistent with other CLI suites that implement subcommands, and how App::Cmd (the framework the CLI is built on) expects to work.

I'm not saying it's perfect, and I am *very* open for suggestions for how we can improve the end user experience. And as I have a few projects involving the CLI coming up, it's a good time to address them. But this in fact how it is expected to operate. 

Hope this helps!
Jason

On Mon, Feb 8, 2021, at 3:54 PM, Gabor Szabo wrote:
> I think running the dancer2 command is quite unclear:
> 
> dancer2 <command> [-?h] [long options...]
> -? -h --help  show help
> Available commands:
>   commands: list the application's commands
>       help: display a command's help screen
>        gen: create new Dancer2 application
> 
> 
> 
> But if I run  "dancer2 -h" as I think everyone would expect to get more help,
> I just get back the same thing.
> 
> 
> Only "dancer2 gen" gives me what I was looking for.
> 
> What do you think?
> 
> Gabor
> _______________________________________________
> dancer-users mailing list
> dancer-users at lists.preshweb.co.uk
> https://lists.preshweb.co.uk/mailman/listinfo/dancer-users
> 

--
Jason A. Crome / CromeDome
CPAN: https://metacpan.org/author/CROMEDOME
GitHub: https://github.com/cromedome
Twitter: https://twitter.com/cromedome
Blog: https://cromedome.net
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.preshweb.co.uk/pipermail/dancer-users/attachments/20210208/595c5374/attachment.htm>