Massive pep8/pyflakes cleanup

The pyflakes and pep8 checks should now run automatically when Travis CI builds run. I've documented which flags are ignored in .travis.yml (e.g. line length checks).
This is an auto-generated file by Sphinx (or whatever the documentation tool is). I tend to leave the auto generated files alone in terms of format (just assuming that at some point we might generate them again).