since this gets asked at the docs at python.org address a lot
- fix some minor style violations and inconsistencies