Allow grouping of valid options in help message (a-la docopt or getopts style)

[kbknapp]

Instead of breaking up each type of argument into, FLAGS, OPTIONS and ARGS, add an option which combines them all into a single OPTIONS section a-la docopt or getopts style.

Perhaps a App::grouped_help(bool)? Unless someone has a better name :P

[severen]

Isn't naming the method App::grouped_help somewhat arbitrary? Perhaps naming it App::unified_args or App::unified_options would be better?

Or perhaps it should just be the default, only behaviour?

[kbknapp]

I don't want to make the default behavior yet because that'd be too drastic a change without bumping the major version. But I can include the option. I like your naming better of unified.

Whats your opinion in the usage strings? Currently, with a program that has optional flags, options, and args it would read program [FLAGS] [OPTIONS] [ARGS]. When this setting is turned on, should flags and options be collapsed into just [OPTIONS], or should all three be collapsed?

As for precedents, I believe docopt combines what clap calls flags and options, but does separate out args (in usage strings at least).

[kbknapp]

@SShrike This will be implemented via #160 although it's not the default, it should still be more to your liking ;)