Bug/fix sphinx build

* workaround for sphinx issue described at https://github.com/isislovecruft/python-gnupg/issues/25
* fix sphinx errors/warnings during build (bad indentation)
* some pep8.