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).
So does this mean excluding the `docs/source` dir from the `flake8` call, then?