Group options

Is it possible to add a feature for dynamically grouping options, like:

Naval Fate.

Usage:
  naval_fate.py ship new <name>...
  naval_fate.py ship <name> move <x> <y> [ship_options]
  naval_fate.py ship shoot <x> <y>
  naval_fate.py mine (set|remove) <x> <y> [mine_options]
  naval_fate.py [options]

Options:
  -h --help     Show this screen.
  --version     Show version.

Mine Options:
  --moored      Moored (anchored) mine.
  --drifting    Drifting mine.

Ship Options:
  --speed=<kn>  Speed in knots [default: 10].

[feluxe]

Docopt syntax is based on POSIX, and we allow extensions only if their syntax is widely used. Do you have any alternatives to [-ship_options-] syntax that are more widely recognized? You are trying to solve this particular problem, that other CLI likely encountered before. How did they solve it? What syntax did they use?

@frnhr @keleshev

I don’t understand why we need an additional syntax for it. It works for options:

Usage:
naval_fate.py [options]

Options:
  -h --help     Show this screen.
  --version     Show version.

Just let it work for more_options the same way:

Usage:
naval_fate.py one [options]
naval_fate.py two [more_options]

Options:
    -h --help     Show this screen.
    --version     Show version.

More_options:
    -f, --foo     Foo

?

[SeeSpotRun]

@conqp probably quicker if you close it yourself…