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@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