David:
Actually, that's why I want that trait :)
But in practice, as your command line programs get a little more complex, docopt is not enough, you need normal programming with things like argparse.
So maybe a mix of the two ideas is better, to write most stuff in the docstring, and then refine its semantics below with normal code.
Bye, bearophile
