How do I format positional argument help using Python's optparse?

Question

As mentioned in the docs the optparse.OptionParser uses an IndentedHelpFormatter to output the formatted option help, for which which I found some API

Answer 1

Most help text for positional arguments resembles the format frequently used in man pages for *NIX boxes. Take a look at how the 'cp' command is documented. Your help text should resemble that.

Otherwise as long as you fill out the "help" argument while using the parser, the documentation should produce itself.