From 41686980fdcc4649a5d70513352c9fc62ec0b2ef Mon Sep 17 00:00:00 2001 From: w0rp Date: Sun, 15 Jan 2017 13:20:23 +0000 Subject: Document the mypy options, and fix spacing issues, largely in the documentation --- doc/ale.txt | 120 +++++++++++++++++++++++++++++++----------------------------- 1 file changed, 63 insertions(+), 57 deletions(-) (limited to 'doc') diff --git a/doc/ale.txt b/doc/ale.txt index 12d6f8fa..fe2b1bf2 100644 --- a/doc/ale.txt +++ b/doc/ale.txt @@ -6,40 +6,41 @@ ALE - Asynchronous Lint Engine =============================================================================== CONTENTS *ale-contents* - 1. Introduction...............................|ale-introduction| - 2. Supported Languages & Tools................|ale-support| - 3. Global Options.............................|ale-options| - 4. Linter Specific Options....................|ale-linter-options| - 4.1. eslint................................|ale-linter-options-eslint| - 4.2. flow..................................|ale-linter-options-flow| - 4.3. jshint................................|ale-linter-options-jshint| - 4.4. phpcs.................................|ale-linter-options-phpcs| - 4.5. html-tidy.............................|ale-linter-options-html-tidy| - 4.6. c-gcc.................................|ale-linter-options-c-gcc| - 4.7. cpp-gcc...............................|ale-linter-options-cpp-gcc| - 4.8. fortran-gcc...........................|ale-linter-options-fortran-gcc| - 4.9. shell.................................|ale-linter-options-shell| - 4.10. shellcheck............................|ale-linter-options-shellcheck| - 4.11. vint..................................|ale-linter-options-vint| - 4.12. luacheck..............................|ale-linter-options-luacheck| - 4.13. c-cppcheck............................|ale-linter-options-c-cppcheck| - 4.14. cpp-cppcheck..........................|ale-linter-options-cpp-cppcheck| - 4.15. htmlhint..............................|ale-linter-options-htmlhint| - 4.16. c-clang...............................|ale-linter-options-c-clang| - 4.17. python-flake8.........................|ale-linter-options-python-flake8| - 4.18. ruby-rubocop..........................|ale-linter-options-ruby-rubocop| - 4.19. chktex................................|ale-linter-options-chktex| - 4.20. lacheck...............................|ale-linter-options-lacheck| - 4.21. stylelint.............................|ale-linter-options-stylelint| - 4.22. rustc.................................|ale-linter-options-rustc| - 4.23. python-pylint.........................|ale-linter-options-python-pylint| - 5. Linter Integration Notes...................|ale-linter-integration| - 5.1. merlin................................|ale-linter-integration-ocaml-merlin| - 5.2. rust...................................|ale-integration-rust| - 6. Commands/Keybinds..........................|ale-commands| - 7. API........................................|ale-api| - 8. Special Thanks.............................|ale-special-thanks| - 9. Contact....................................|ale-contact| + 1. Introduction.........................|ale-introduction| + 2. Supported Languages & Tools..........|ale-support| + 3. Global Options.......................|ale-options| + 4. Linter Specific Options..............|ale-linter-options| + 4.1. eslint..........................|ale-linter-options-eslint| + 4.2. flow............................|ale-linter-options-flow| + 4.3. jshint..........................|ale-linter-options-jshint| + 4.4. phpcs...........................|ale-linter-options-phpcs| + 4.5. html-tidy.......................|ale-linter-options-html-tidy| + 4.6. c-gcc...........................|ale-linter-options-c-gcc| + 4.7. cpp-gcc.........................|ale-linter-options-cpp-gcc| + 4.8. fortran-gcc.....................|ale-linter-options-fortran-gcc| + 4.9. shell...........................|ale-linter-options-shell| + 4.10. shellcheck......................|ale-linter-options-shellcheck| + 4.11. vint............................|ale-linter-options-vint| + 4.12. luacheck........................|ale-linter-options-luacheck| + 4.13. c-cppcheck......................|ale-linter-options-c-cppcheck| + 4.14. cpp-cppcheck....................|ale-linter-options-cpp-cppcheck| + 4.15. htmlhint........................|ale-linter-options-htmlhint| + 4.16. c-clang.........................|ale-linter-options-c-clang| + 4.17. python-flake8...................|ale-linter-options-python-flake8| + 4.18. ruby-rubocop....................|ale-linter-options-ruby-rubocop| + 4.19. chktex..........................|ale-linter-options-chktex| + 4.20. lacheck.........................|ale-linter-options-lacheck| + 4.21. stylelint.......................|ale-linter-options-stylelint| + 4.22. rustc...........................|ale-linter-options-rustc| + 4.23. python-mypy.....................|ale-linter-options-python-mypy| + 4.24. python-pylint...................|ale-linter-options-python-pylint| + 5. Linter Integration Notes.............|ale-linter-integration| + 5.1. merlin..........................|ale-linter-integration-ocaml-merlin| + 5.2. rust.............................|ale-integration-rust| + 6. Commands/Keybinds....................|ale-commands| + 7. API..................................|ale-api| + 8. Special Thanks.......................|ale-special-thanks| + 9. Contact..............................|ale-contact| =============================================================================== 1. Introduction *ale-introduction* @@ -92,7 +93,7 @@ The following languages and tools are supported. * PHP: 'hack', 'php' (-l flag), 'phpcs' * Pug: 'pug-lint' * Puppet: 'puppet', 'puppet-lint' -* Python: 'flake8', 'pylint' +* Python: 'flake8', 'mypy', 'pylint' * Ruby: 'rubocop' * SASS: 'sasslint', 'stylelint' * SCSS: 'sasslint', 'scsslint', 'stylelint' @@ -458,7 +459,6 @@ g:ale_javascript_jshint_use_global *g:ale_javascript_jshint_use_global* global version of jshint, in preference to locally installed versions of jshint in node_modules. - ------------------------------------------------------------------------------- 4.4. phpcs *ale-linter-options-phpcs* @@ -471,7 +471,6 @@ g:ale_php_phpcs_standard *g:ale_php_phpcs_standard* coding standard is specified, phpcs will default to checking against the PEAR coding standard, or the standard you have set as the default. - ------------------------------------------------------------------------------- 4.5. html-tidy *ale-linter-options-html-tidy* @@ -498,7 +497,6 @@ g:ale_html_tidy_args *g:ale_html_tidy_args* cp850 (ibm858), cp932 (shiftjis), iso-2022-jp (iso-2022), latin1, macroman (mac), sjis (shiftjis), utf-16le, utf-16, utf-8 - ------------------------------------------------------------------------------- 4.6. c-gcc *ale-linter-options-c-gcc* @@ -509,7 +507,6 @@ g:ale_c_gcc_options *g:ale_c_gcc_options* This variable can be change to modify flags given to gcc. - ------------------------------------------------------------------------------- 4.7. cpp-gcc *ale-linter-options-cpp-gcc* @@ -520,7 +517,6 @@ g:ale_cpp_gcc_options *g:ale_cpp_gcc_options* This variable can be changed to modify flags given to gcc. - ------------------------------------------------------------------------------- 4.8. fortran-gcc *ale-linter-options-fortran-gcc* @@ -531,7 +527,6 @@ g:ale_fortran_gcc_options *g:ale_fortran_gcc_options* This variable can be changed to modify flags given to gcc. - ------------------------------------------------------------------------------- 4.9. shell *ale-linter-options-shell* @@ -545,7 +540,6 @@ g:ale_linters_sh_shell_default_shell *g:ale_linters_sh_shell_default_shell* determine the shell program to run. When this detection fails, this variable will be used instead. - ------------------------------------------------------------------------------- 4.10. shellcheck *ale-linter-options-shellcheck* @@ -556,7 +550,6 @@ g:ale_linters_sh_shellckeck_exclusions *g:ale_linters_sh_shellckeck_exclusions* Set this variable to exclude test(s) for shellcheck (-e/--exclude option). - ------------------------------------------------------------------------------- 4.11. vint *ale-linter-options-vint* @@ -569,7 +562,6 @@ g:ale_vim_vint_show_style_issues *g:ale_vim_vint_show_style_issues* is disabled, only warnings and errors which are not purely style issues will be reported. - ------------------------------------------------------------------------------- 4.12. luacheck *ale-linter-options-luacheck* @@ -580,7 +572,6 @@ g:ale_lua_luacheck_executable *g:ale_lua_luacheck_executable* This variable can be changed to change the path to luacheck. - ------------------------------------------------------------------------------- 4.13. c-cppcheck *ale-linter-options-c-cppcheck* @@ -591,7 +582,6 @@ g:ale_c_cppcheck_options *g:ale_c_cppcheck_options* This variable can be changed to modify flags given to cppcheck. - ------------------------------------------------------------------------------- 4.14. cpp-cppcheck *ale-linter-options-cpp-cppcheck* @@ -602,7 +592,6 @@ g:ale_cpp_cppcheck_options *g:ale_cpp_cppcheck_options* This variable can be changed to modify flags given to cppcheck. - ------------------------------------------------------------------------------- 4.15. htmlhint *ale-linter-options-htmlhint* @@ -613,6 +602,7 @@ g:ale_html_htmlhint_options *g:ale_html_htmlhint_options* This variable can be changed to modify flags given to HTMLHint. + g:ale_html_htmlhint_executable *g:ale_html_htmlhint_executable* Type: |String| @@ -664,14 +654,14 @@ g:ale_python_flake8_args *g:ale_python_flake8_args* 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 > + 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`). +< + after making sure it's installed for the appropriate Python versions (e.g. + `python3 -m pip install --user flake8`). ------------------------------------------------------------------------------- 4.18. ruby-rubocop *ale-linter-options-ruby-rubocop* @@ -693,6 +683,7 @@ g:ale_tex_chktex_executable *g:ale_tex_chktex_executable* This variable can be changed to change the path to chktex. + g:ale_tex_chktex_options *g:ale_tex_chktex_options* Type: |String| @@ -735,6 +726,7 @@ g:ale_css_stylelint_use_global *g:ale_css_stylelint_use_global global version of stylelint, in preference to locally installed versions of stylelint in node_modules. + g:ale_sass_stylelint_executable *g:ale_sass_stylelint_executable* Type: |String| @@ -757,6 +749,7 @@ g:ale_sass_stylelint_use_global *g:ale_sass_stylelint_use_global global version of stylelint, in preference to locally installed versions of stylelint in node_modules. + g:ale_scss_stylelint_executable *g:ale_scss_stylelint_executable* Type: |String| @@ -792,8 +785,21 @@ g:ale_rust_ignore_error_codes *g:ale_rust_ignore_error_codes* > let g:ale_rust_ignore_error_codes = ['E0432', 'E0433'] + +------------------------------------------------------------------------------- +4.24. python-mypy *ale-linter-options-python-mypy* + +g:ale_python_mypy_options *g:ale_python_mypy_options* + + Type: |String| + Default: `''` + + This variable can be changed to add command-line arguments to the mypy + invocation. + + ------------------------------------------------------------------------------- -4.23. python-pylint *ale-linter-options-python-pylint* +4.24. python-pylint *ale-linter-options-python-pylint* g:ale_python_pylint_executable *g:ale_python_pylint_executable* @@ -811,14 +817,14 @@ g:ale_python_pylint_options *g:ale_python_pylint_options* This variable can be changed to add command-line arguments to the pylint invocation. -For example, to dynamically switch between programs targeting Python 2 and -Python 3, you may want to set > + For example, to dynamically switch between programs targeting Python 2 and + Python 3, you may want to set > let g:ale_python_pylint_executable = 'python3' " or 'python' for Python 2 let g:ale_python_pylint_options = '-rcfile /path/to/pylint.rc' -after making sure it's installed for the appropriate Python versions (e.g. -`python3 -m pip install --user pylint`). + after making sure it's installed for the appropriate Python versions (e.g. + `python3 -m pip install --user pylint`). =============================================================================== 5. Linter Integration Notes *ale-linter-integration* -- cgit v1.2.3