Provide a documentation package
It would be nice to provide a python-
Sphinx  seems to be the tool generally used to build nice Python documentation.
A few pointers for anyone wanting to take up this task:
* An example to look at is the python-apt-doc package, which generates these docs .
* I believe the main changes are to add the 'build_sphinx' command to setup.py:
* Then call it from debian/rules, and add the doc/ folder with a Makefile for Sphinx.
* The python-