I am developing a python CLI tool (using optparse in python2.6, but hope to switch soon to python2.7) and I am about to write the man page. I have some experience on generat
If you are using click you can use click-man. It can generate man pages from click applications.
click