improve lib documentation. adapt pydoc standard