py api: sphinx doc corrections, pep8 cleanup and style edits, also added __all__ to some modules which were missing it.