Add g:ale_python_flake8_executable (#174)

* Add g:ale_python_flake8_executable

Closes #172.

* Add g:ale_python_flake8_args

* Always add - to flake8 invocations

1 files changed, 28 insertions, 0 deletions

diff --git a/doc/ale.txt b/doc/ale.txt
index 52aa796c..137d433d 100644
--- a/doc/ale.txt
+++ b/doc/ale.txt
@@ -598,6 +598,34 @@ g:ale_c_clang_options                                   *g:ale_c_clang_options*
 
   This variable can be change to modify flags given to clang.
 
+-------------------------------------------------------------------------------
+4.17. python-flake8                          *ale-linter-options-python-flake8*
+
+g:ale_python_flake8_executable                 *g:ale_python_flake8_executable*
+
+  Type: |String|
+  Default: `'flake8'`
+
+  This variable can be changed to modify the executable used for flake8.
+
+
+g:ale_python_flake8_args                             *g:ale_python_flake8_args*
+
+  Type: |String|
+  Default: `''`
+
+  This variable can be changed to add command-line arguments to the flake8
+  invocation.
+
+For example, to dynamically switch between programs targeting Python 2 and
+Python 3, you may want to set >
+
+  let g:ale_python_flake8_executable = 'python3'   " or 'python' for Python 2
+  let g:ale_python_flake8_args = '-m flake8'
+
+after making sure it's installed for the appropriate Python versions (e.g.
+`python3 -m pip install --user flake8`).
+
 
 ===============================================================================
 5. Commands/Keybinds                                             *ale-commands*