Revised doctring (for Sphinx)
Altered README

... but it is still incomplete