Upgrading pyflakes meant the number of violations jumped above the
failure threshold.

Also added a few more warnings to the ignore list.

Document the lint file more.

This is to ensure that pull requests fail when they don't obey pep8
enough.