I think all of the command line examples would fit in best in the part of the Sphinx documentation that is manually written rather than being extracted as code comments. Also a small description, here in the module docstring, that explains how the module works (not how it is used), would be nice.