I'm also a fan of idea of using function-docstrings for separate subcommand help...

halst on June 17, 2012 | parent | context | favorite | on: Challenge: Implement CLI interface like that?

I'm also a fan of idea of using function-docstrings for separate subcommand help-screens. Problems: (1) exact API, (2) how to do that in non-python implementations. You (and everyone) is very welcome to suggest APIs for that in issues: https://github.com/docopt/docopt/issues