docs and cleanups
pep8 fixes
notes about compatibility on the various distros