Take a look at docopt. It is a formal standard for documenting (and automatically parsing) command line arguments.
For example...
Usage:
my_program command --option
my_program []
my_program --another-option=
my_program (--either-that-option | )
my_program ...