Sorry about not being clear. I have been downloading quite a few packages for examples, but have not found a good example of man page building from optparse.
seismic-py - setup.py - seismic - __init.py__ - bulk of the code *.py - scripts - programs that go in bin/the users executable path (no .py extension) -- http://mail.python.org/mailman/listinfo/python-list