Sphinx and argparse - autodocumenting command line scripts?

Use sphinx-argparse extension:

http://sphinx-argparse.readthedocs.org/en/latest/

You can use sphinxcontrib.programoutput to include the help messages from the command line in your documentation.

This is not specific to argparse but can be used to document any script printing help messages to the command line.