From d7f8324c3c9b9eb6ea49591fc4fa37948996170d Mon Sep 17 00:00:00 2001 From: w0rp Date: Tue, 28 Mar 2017 23:25:44 +0100 Subject: [PATCH] Move linter documentation into separate files --- doc/ale-asm.txt | 17 + doc/ale-c.txt | 39 ++ doc/ale-cmake.txt | 24 ++ doc/ale-cpp.txt | 50 +++ doc/ale-css.txt | 38 ++ doc/ale-erlang.txt | 18 + doc/ale-fortran.txt | 17 + doc/ale-html.txt | 67 ++++ doc/ale-java.txt | 25 ++ doc/ale-javascript.txt | 133 +++++++ doc/ale-lua.txt | 17 + doc/ale-ocaml.txt | 15 + doc/ale-perl.txt | 26 ++ doc/ale-php.txt | 31 ++ doc/ale-python.txt | 76 ++++ doc/ale-ruby.txt | 17 + doc/ale-rust.txt | 60 ++++ doc/ale-sass.txt | 32 ++ doc/ale-scss.txt | 32 ++ doc/ale-sh.txt | 31 ++ doc/ale-tex.txt | 36 ++ doc/ale-vim.txt | 19 + doc/ale-yaml.txt | 25 ++ doc/ale.txt | 795 ++++------------------------------------- 24 files changed, 919 insertions(+), 721 deletions(-) create mode 100644 doc/ale-asm.txt create mode 100644 doc/ale-c.txt create mode 100644 doc/ale-cmake.txt create mode 100644 doc/ale-cpp.txt create mode 100644 doc/ale-css.txt create mode 100644 doc/ale-erlang.txt create mode 100644 doc/ale-fortran.txt create mode 100644 doc/ale-html.txt create mode 100644 doc/ale-java.txt create mode 100644 doc/ale-javascript.txt create mode 100644 doc/ale-lua.txt create mode 100644 doc/ale-ocaml.txt create mode 100644 doc/ale-perl.txt create mode 100644 doc/ale-php.txt create mode 100644 doc/ale-python.txt create mode 100644 doc/ale-ruby.txt create mode 100644 doc/ale-rust.txt create mode 100644 doc/ale-sass.txt create mode 100644 doc/ale-scss.txt create mode 100644 doc/ale-sh.txt create mode 100644 doc/ale-tex.txt create mode 100644 doc/ale-vim.txt create mode 100644 doc/ale-yaml.txt diff --git a/doc/ale-asm.txt b/doc/ale-asm.txt new file mode 100644 index 00000000..7228762b --- /dev/null +++ b/doc/ale-asm.txt @@ -0,0 +1,17 @@ +=============================================================================== +ALE ASM Integration *ale-asm-options* + + +------------------------------------------------------------------------------- +gcc *ale-asm-gcc* + +g:ale_asm_gcc_options *g:ale_asm_gcc_options* + + Type: |String| + Default: `'-Wall'` + + This variable can be set to pass additional options to gcc. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-c.txt b/doc/ale-c.txt new file mode 100644 index 00000000..08f4abac --- /dev/null +++ b/doc/ale-c.txt @@ -0,0 +1,39 @@ +=============================================================================== +ALE C Integration *ale-c-options* + + +------------------------------------------------------------------------------- +clang *ale-c-clang* + +g:ale_c_clang_options *g:ale_c_clang_options* + + Type: |String| + Default: `'-std=c11 -Wall'` + + This variable can be change to modify flags given to clang. + + +------------------------------------------------------------------------------- +cppcheck *ale-c-cppcheck* + +g:ale_c_cppcheck_options *g:ale_c_cppcheck_options* + + Type: |String| + Default: `'--enable=style'` + + This variable can be changed to modify flags given to cppcheck. + + +------------------------------------------------------------------------------- +gcc *ale-c-gcc* + +g:ale_c_gcc_options *g:ale_c_gcc_options* + + Type: |String| + Default: `'-std=c11 -Wall'` + + This variable can be change to modify flags given to gcc. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-cmake.txt b/doc/ale-cmake.txt new file mode 100644 index 00000000..0e4691c5 --- /dev/null +++ b/doc/ale-cmake.txt @@ -0,0 +1,24 @@ +=============================================================================== +ALE CMake Integration *ale-cmake-options* + + +------------------------------------------------------------------------------- +cmakelint *ale-cmake-cmakelint* + +g:ale_cmake_cmakelint_exectuable *g:ale_cmake_cmakelint_executable* + + Type: |String| + Default: `'cmakelint'` + + This variable can be set to change the path the cmakelint. + +g:ale_cmake_cmakelint_options *g:ale_cmake_cmakelint_options* + + Type: |String| + Default: `''` + + This variable can be set to pass additional options to cmakelint. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-cpp.txt b/doc/ale-cpp.txt new file mode 100644 index 00000000..efe7e080 --- /dev/null +++ b/doc/ale-cpp.txt @@ -0,0 +1,50 @@ +=============================================================================== +ALE C++ Integration *ale-cpp-options* + + +------------------------------------------------------------------------------- +clang *ale-cpp-clang* + +g:ale_cpp_clang_options *g:ale_cpp_clang_options* + + Type: |String| + Default: `'-std=c++14 -Wall'` + + This variable can be changed to modify flags given to clang. + + +------------------------------------------------------------------------------- +clangtidy *ale-cpp-clangtidy* + +g:ale_cpp_clangtidy_options *g:ale_cpp_clangtidy_options* + + Type: |String| + Default: `'-std=c++14 -Wall'` + + This variable can be changed to modify flags given to clangtidy. + + +------------------------------------------------------------------------------- +cppcheck *ale-cpp-cppcheck* + +g:ale_cpp_cppcheck_options *g:ale_cpp_cppcheck_options* + + Type: |String| + Default: `'--enable=style'` + + This variable can be changed to modify flags given to cppcheck. + + +------------------------------------------------------------------------------- +gcc *ale-cpp-gcc* + +g:ale_cpp_gcc_options *g:ale_cpp_gcc_options* + + Type: |String| + Default: `'-std=c++14 -Wall'` + + This variable can be changed to modify flags given to gcc. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-css.txt b/doc/ale-css.txt new file mode 100644 index 00000000..1abb6cd1 --- /dev/null +++ b/doc/ale-css.txt @@ -0,0 +1,38 @@ +=============================================================================== +ALE CSS Integration *ale-css-options* + + +------------------------------------------------------------------------------- +stylelint *ale-css-stylelint* + +g:ale_css_stylelint_executable *g:ale_css_stylelint_executable* + + Type: |String| + Default: `'stylelint'` + + ALE will first discover the stylelint path in an ancestor node_modules + directory. If no such path exists, this variable will be used instead. + + If you wish to use only a globally installed version of stylelint, set + |g:ale_css_stylelint_use_global| to `1`. + +g:ale_css_stylelint_options *g:ale_css_stylelint_options* + + Type: |String| + Default: `''` + + This variable can be set to pass additional options to stylelint. + +g:ale_css_stylelint_use_global *g:ale_css_stylelint_use_global* + + Type: |String| + Default: `0` + + This variable controls whether or not ALE will search for a local path for + stylelint first. If this variable is set to `1`, then ALE will always use the + global version of stylelint, in preference to locally installed versions of + stylelint in node_modules. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-erlang.txt b/doc/ale-erlang.txt new file mode 100644 index 00000000..3d84dfe6 --- /dev/null +++ b/doc/ale-erlang.txt @@ -0,0 +1,18 @@ +=============================================================================== +ALE Erlang Integration *ale-erlang-options* + + +------------------------------------------------------------------------------- +erlc *ale-erlang-erlc* + +g:ale_erlang_erlc_options *g:ale_erlang_erlc_options* + + Type: |String| + Default: '`''`' + + This variable controls additional parameters passed to `erlc`, such as `-I` + or `-pa`. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-fortran.txt b/doc/ale-fortran.txt new file mode 100644 index 00000000..73e21037 --- /dev/null +++ b/doc/ale-fortran.txt @@ -0,0 +1,17 @@ +=============================================================================== +ALE Fortran Integration *ale-fortran-options* + + +------------------------------------------------------------------------------- +gcc *ale-fortran-gcc* + +g:ale_fortran_gcc_options *g:ale_fortran_gcc_options* + + Type: |String| + Default: `'-Wall'` + + This variable can be changed to modify flags given to gcc. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-html.txt b/doc/ale-html.txt new file mode 100644 index 00000000..06ee2df1 --- /dev/null +++ b/doc/ale-html.txt @@ -0,0 +1,67 @@ +=============================================================================== +ALE HTML Integration *ale-html-options* + + +------------------------------------------------------------------------------- +htmlhint *ale-html-htmlhint* + +g:ale_html_htmlhint_options *g:ale_html_htmlhint_options* + + Type: |String| + Default: `'--format=unix'` + + This variable can be changed to modify flags given to HTMLHint. + + +g:ale_html_htmlhint_executable *g:ale_html_htmlhint_executable* + + Type: |String| + Default: `'htmlhint'` + + ALE will first discover the htmlhint path in an ancestor node_modules + directory. If no such path exists, this variable will be used instead. + + If you wish to use only a globally installed version of htmlhint, set + |g:ale_html_htmlhint_use_global| to `1`. + + +g:ale_html_htmlhint_use_global *g:ale_html_htmlhint_use_global* + + Type: |String| + Default: `0` + + This variable controls whether or not ALE will search for a local path for + htmlhint first. If this variable is set to `1`, then ALE will always use the + global version of htmlhint, in preference to locally installed versions of + htmlhint in node_modules. + + +------------------------------------------------------------------------------- +tidy *ale-html-tidy* + +g:ale_html_tidy_executable *g:ale_html_tidy_executable* + + Type: |String| + Default: `'tidy'` + + This variable can be changed to change the path to tidy. + + +g:ale_html_tidy_args *g:ale_html_tidy_args* + + Type: |String| + Default: `'-q -e -language en'` + + This variable can be changed to change the arguments provided to the + executable. + + ALE will attempt to automatically detect the appropriate file encoding to + provide to html-tidy, and fall back to UTF-8 when encoding detection fails. + + The recognized file encodings are as follows: ascii, big5, cp1252 (win1252), + cp850 (ibm858), cp932 (shiftjis), iso-2022-jp (iso-2022), latin1, macroman + (mac), sjis (shiftjis), utf-16le, utf-16, utf-8 + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-java.txt b/doc/ale-java.txt new file mode 100644 index 00000000..c658a234 --- /dev/null +++ b/doc/ale-java.txt @@ -0,0 +1,25 @@ +=============================================================================== +ALE Java Integration *ale-java-options* + + +------------------------------------------------------------------------------- +javac *ale-java-javac* + +g:ale_java_javac_classpath *g:ale_java_javac_classpath* + + Type: |String| + Default: `''` + + This variable can be set to change the global classpath for Java. + + +g:ale_java_javac_options *g:ale_java_javac_options* + + Type: |String| + Default: `''` + + This variable can be set to pass additional options to javac. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-javascript.txt b/doc/ale-javascript.txt new file mode 100644 index 00000000..f311c83a --- /dev/null +++ b/doc/ale-javascript.txt @@ -0,0 +1,133 @@ +=============================================================================== +ALE JavaScript Integration *ale-javascript-options* + + +------------------------------------------------------------------------------- +eslint *ale-javascript-eslint* + +g:ale_javascript_eslint_executable *g:ale_javascript_eslint_executable* + + Type: |String| + Default: `'eslint'` + + ALE will first discover the eslint path in an ancestor node_modules + directory. If no such path exists, this variable will be used instead. + + This variable can be set to change the path to eslint. If you have eslint_d + installed, you can set this option to use eslint_d instead. + + If you wish to use only a globally installed version of eslint, set + |g:ale_javascript_eslint_use_global| to `1`. + + +g:ale_javascript_eslint_options *g:ale_javascript_eslint_options* + + Type: |String| + Default: `''` + + This variable can be set to pass additional options to eslint. + + +g:ale_javascript_eslint_use_global *g:ale_javascript_eslint_use_global* + + Type: |String| + Default: `0` + + This variable controls whether or not ALE will search for a local path for + eslint first. If this variable is set to `1`, then ALE will always use the + global version of eslint, in preference to locally installed versions of + eslint in node_modules. + + +------------------------------------------------------------------------------- +flow *ale-javascript-flow* + +g:ale_javascript_flow_executable *g:ale_javascript_flow_executable* + + Type: |String| + Default: `'flow'` + + ALE will first discover the flow path in an ancestor node_modules + directory. If no such path exists, this variable will be used instead. + + If you wish to use only a globally installed version of flow, set + |g:ale_javascript_flow_use_global| to `1`. + + +g:ale_javascript_flow_use_global *g:ale_javascript_flow_use_global* + + Type: |String| + Default: `0` + + This variable controls whether or not ALE will search for a local path for + flow first. If this variable is set to `1`, then ALE will always use the + global version of flow, in preference to locally installed versions of + flow in node_modules. + + +------------------------------------------------------------------------------- +jshint *ale-javascript-jshint* + +g:ale_javascript_jshint_executable *g:ale_javascript_jshint_executable* + + Type: |String| + Default: `'jshint'` + + ALE will first discover the jshint path in an ancestor node_modules + directory. If no such path exists, this variable will be used instead. + + This variable can be changed to change the path to jshint. + + If you wish to use only a globally installed version of jshint, set + |g:ale_javascript_jshint_use_global| to `1`. + + +g:ale_javascript_jshint_use_global *g:ale_javascript_jshint_use_global* + + Type: |String| + Default: `0` + + This variable controls whether or not ALE will search for a local path for + jshint first. If this variable is set to `1`, then ALE will always use the + global version of jshint, in preference to locally installed versions of + jshint in node_modules. + + +------------------------------------------------------------------------------ +xo *ale-javascript-xo* + +g:ale_javascript_xo_executable *g:ale_javascript_xo_executable* + + Type: |String| + Default: `'xo'` + + ALE will first discover the xo path in an ancestor node_modules + directory. If no such path exists, this variable will be used instead. + + This variable can be set to change the path to xo. + + If you wish to use only a globally installed version of xo, set + |g:ale_javascript_xo_use_global| to `1`. + + +g:ale_javascript_xo_options *g:ale_javascript_xo_options* + + Type: |String| + Default: `''` + + This variable can be set to pass additional options to xo. + + +g:ale_javascript_xo_use_global *g:ale_javascript_xo_use_global* + + Type: |String| + Default: `0` + + This variable controls whether or not ALE will search for a local path for + xo first. If this variable is set to `1`, then ALE will always use the + global version of xo, in preference to locally installed versions of + xo in node_modules. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-lua.txt b/doc/ale-lua.txt new file mode 100644 index 00000000..b87403ee --- /dev/null +++ b/doc/ale-lua.txt @@ -0,0 +1,17 @@ +=============================================================================== +ALE Lua Integration *ale-lua-options* + + +------------------------------------------------------------------------------- +4.12. luacheck *ale-lua-luacheck* + +g:ale_lua_luacheck_executable *g:ale_lua_luacheck_executable* + + Type: |String| + Default: `'luacheck'` + + This variable can be changed to change the path to luacheck. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-ocaml.txt b/doc/ale-ocaml.txt new file mode 100644 index 00000000..3e123741 --- /dev/null +++ b/doc/ale-ocaml.txt @@ -0,0 +1,15 @@ +=============================================================================== +ALE OCaml Integration *ale-ocaml-options* + + +------------------------------------------------------------------------------- +merlin *ale-ocaml-merlin* + + To use merlin linter for OCaml source code you need to make sure Merlin for + Vim is correctly configured. See the corresponding Merlin wiki page for + detailed instructions + (https://github.com/the-lambda-church/merlin/wiki/vim-from-scratch). + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-perl.txt b/doc/ale-perl.txt new file mode 100644 index 00000000..a8e8e7a1 --- /dev/null +++ b/doc/ale-perl.txt @@ -0,0 +1,26 @@ +=============================================================================== +ALE Perl Integration *ale-perl-options* + + +------------------------------------------------------------------------------- +perl *ale-perl-perl* + +g:ale_perl_perl_executable *g:ale_perl_perl_executable* + + Type: |String| + Default: `'perl'` + + This variable can be changed to modify the executable used for linting perl. + + +g:ale_perl_perl_options *g:ale_perl_perl_options* + + Type: |String| + Default: `'-X -c -Mwarnings -Ilib'` + + This variable can be changed to alter the command-line arguments to the perl + invocation. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-php.txt b/doc/ale-php.txt new file mode 100644 index 00000000..99ce1291 --- /dev/null +++ b/doc/ale-php.txt @@ -0,0 +1,31 @@ +=============================================================================== +ALE PHP Integration *ale-php-options* + + +------------------------------------------------------------------------------- +phpcs *ale-php-phpcs* + +g:ale_php_phpcs_standard *g:ale_php_phpcs_standard* + + Type: |String| + Default: `''` + + This variable can be set to specify the coding standard used by phpcs. If no + coding standard is specified, phpcs will default to checking against the + PEAR coding standard, or the standard you have set as the default. + + +------------------------------------------------------------------------------ +phpmd *ale-php-phpmd* + +g:ale_php_phpmd_ruleset *g:ale_php_phpmd_ruleset* + + Type: |String| + Default: `'cleancode,codesize,controversial,design,naming,unusedcode'` + + This variable controls the ruleset used by phpmd. Default is to use all of + the available phpmd rulesets + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-python.txt b/doc/ale-python.txt new file mode 100644 index 00000000..77e9e1b1 --- /dev/null +++ b/doc/ale-python.txt @@ -0,0 +1,76 @@ +=============================================================================== +ALE Python Integration *ale-python-options* + + +------------------------------------------------------------------------------- +flake8 *ale-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`). + + +------------------------------------------------------------------------------- +mypy *ale-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. + + +------------------------------------------------------------------------------- +pylint *ale-python-pylint* + +g:ale_python_pylint_executable *g:ale_python_pylint_executable* + + Type: |String| + Default: `'pylint'` + + This variable can be changed to modify the executable used for pylint. + + +g:ale_python_pylint_options *g:ale_python_pylint_options* + + Type: |String| + Default: `''` + + 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 > + + 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`). + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-ruby.txt b/doc/ale-ruby.txt new file mode 100644 index 00000000..77ea7342 --- /dev/null +++ b/doc/ale-ruby.txt @@ -0,0 +1,17 @@ +=============================================================================== +ALE Ruby Integration *ale-ruby-options* + + +------------------------------------------------------------------------------- +rubocop *ale-ruby-rubocop* + +g:ale_ruby_rubocop_options *g:ale_ruby_rubocop_options* + + Type: |String| + Default: `''` + + This variable can be change to modify flags given to rubocop. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-rust.txt b/doc/ale-rust.txt new file mode 100644 index 00000000..d0d4f707 --- /dev/null +++ b/doc/ale-rust.txt @@ -0,0 +1,60 @@ +=============================================================================== +ALE Rust Integration *ale-rust-options* + *ale-integration-rust* + +------------------------------------------------------------------------------- +Integration Information + + Since Vim does not detect the rust file type out-of-the-box, you need the + runtime files for rust from here: https://github.com/rust-lang/rust.vim + + Note that there are two possible linters for rust files: + + 1. rustc -- The Rust compiler is used to check the currently edited file. + So, if your project consists of multiple files, you will get some errors + when you use e.g. a struct which is defined in another file. You can use + |g:ale_rust_ignore_error_codes| to ignore some of these errors. + 2. cargo -- If your project is managed by Cargo, the whole project is + checked. That means that all errors are properly shown, but cargo can + only operate on the files written on disk. That means it is highly + recommended to turn off |g:ale_lint_on_text_changed| and to turn on + |g:ale_lint_on_save| in your vimrc file. + + Only cargo is enabled by default. To switch to using rustc instead of cargo, + configure |g:ale_linters| appropriately: > + + " See the help text for the option for more information. + let g:ale_linters = {'rust': ['rustc']} +< + + Also note that rustc 1.12. or later is needed. + + +------------------------------------------------------------------------------- +cargo *ale-rust-cargo* + +g:ale_rust_cargo_use_check *g:ale_rust_cargo_use_check* + + Type: |Number| + Default: `1` + + When set to `1`, this option will cause ALE to use "cargo check" instead of + "cargo build". "cargo check" is supported since version 1.16.0 of Rust. + + +------------------------------------------------------------------------------- +rustc *ale-rust-rustc* + +g:ale_rust_ignore_error_codes *g:ale_rust_ignore_error_codes* + + Type: |List| of |String|s + Default: [] + + This variable can contain error codes which will be ignored. For example, to + ignore most errors regarding failed imports, put this in your .vimrc + > + let g:ale_rust_ignore_error_codes = ['E0432', 'E0433'] + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-sass.txt b/doc/ale-sass.txt new file mode 100644 index 00000000..cb5bce5b --- /dev/null +++ b/doc/ale-sass.txt @@ -0,0 +1,32 @@ +=============================================================================== +ALE SASS Integration *ale-sass-options* + + +------------------------------------------------------------------------------- +stylelint *ale-sass-stylelint* + +g:ale_sass_stylelint_executable *g:ale_sass_stylelint_executable* + + Type: |String| + Default: `'stylelint'` + + ALE will first discover the stylelint path in an ancestor node_modules + directory. If no such path exists, this variable will be used instead. + + If you wish to use only a globally installed version of stylelint, set + |g:ale_sass_stylelint_use_global| to `1`. + + +g:ale_sass_stylelint_use_global *g:ale_sass_stylelint_use_global* + + Type: |String| + Default: `0` + + This variable controls whether or not ALE will search for a local path for + stylelint first. If this variable is set to `1`, then ALE will always use the + global version of stylelint, in preference to locally installed versions of + stylelint in node_modules. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-scss.txt b/doc/ale-scss.txt new file mode 100644 index 00000000..fd9733a4 --- /dev/null +++ b/doc/ale-scss.txt @@ -0,0 +1,32 @@ +=============================================================================== +ALE SCSS Integration *ale-scss-options* + + +------------------------------------------------------------------------------- +stylelint *ale-scss-stylelint* + +g:ale_scss_stylelint_executable *g:ale_scss_stylelint_executable* + + Type: |String| + Default: `'stylelint'` + + ALE will first discover the stylelint path in an ancestor node_modules + directory. If no such path exists, this variable will be used instead. + + If you wish to use only a globally installed version of stylelint, set + |g:ale_scss_stylelint_use_global| to `1`. + + +g:ale_scss_stylelint_use_global *g:ale_scss_stylelint_use_global* + + Type: |String| + Default: `0` + + This variable controls whether or not ALE will search for a local path for + stylelint first. If this variable is set to `1`, then ALE will always use the + global version of stylelint, in preference to locally installed versions of + stylelint in node_modules. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-sh.txt b/doc/ale-sh.txt new file mode 100644 index 00000000..aee13912 --- /dev/null +++ b/doc/ale-sh.txt @@ -0,0 +1,31 @@ +=============================================================================== +ALE Shell Integration *ale-sh-options* + + +------------------------------------------------------------------------------- +shell *ale-sh-shell* + +g:ale_linters_sh_shell_default_shell *g:ale_linters_sh_shell_default_shell* + + Type: |String| + Default: The current shell (`$SHELL`) or `'bash'` if that cannot be read. + + When ALE runs the linter for shells with the `-n` flag, it will attempt to + read the shell from the shebang (`#!`) line from the shell script to + determine the shell program to run. When this detection fails, this variable + will be used instead. + + +------------------------------------------------------------------------------- +shellcheck *ale-sh-shellcheck* + +g:ale_linters_sh_shellcheck_exclusions *g:ale_linters_sh_shellcheck_exclusions* + + Type: |String| + Default: `''` + + Set this variable to exclude test(s) for shellcheck (-e/--exclude option). + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-tex.txt b/doc/ale-tex.txt new file mode 100644 index 00000000..4242b07b --- /dev/null +++ b/doc/ale-tex.txt @@ -0,0 +1,36 @@ +=============================================================================== +ALE TeX Integration *ale-tex-options* + + +------------------------------------------------------------------------------- +chktex *ale-tex-chktex* + +g:ale_tex_chktex_executable *g:ale_tex_chktex_executable* + + Type: |String| + Default: `'chktex'` + + This variable can be changed to change the path to chktex. + + +g:ale_tex_chktex_options *g:ale_tex_chktex_options* + + Type: |String| + Default: `'-I'` + + This variable can be changed to modify flags given to chktex. + + +------------------------------------------------------------------------------ +lacheck *ale-tex-lacheck* + +g:ale_lacheck_executable *g:ale_lacheck_executable* + + Type: |String| + Default: '`lacheck`' + + This variable can be changed to change the path to lacheck. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-vim.txt b/doc/ale-vim.txt new file mode 100644 index 00000000..2311449b --- /dev/null +++ b/doc/ale-vim.txt @@ -0,0 +1,19 @@ +=============================================================================== +ALE Vim Integration *ale-vim-options* + + +------------------------------------------------------------------------------- +vint *ale-vim-vint* + +g:ale_vim_vint_show_style_issues *g:ale_vim_vint_show_style_issues* + + Type: |Number| + Default: `1` + + This variable will enable/disable style issues for Vint. When this option + is disabled, only warnings and errors which are not purely style issues + will be reported. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale-yaml.txt b/doc/ale-yaml.txt new file mode 100644 index 00000000..ab31d1f6 --- /dev/null +++ b/doc/ale-yaml.txt @@ -0,0 +1,25 @@ +=============================================================================== +ALE Yaml Integration *ale-yaml-options* + + +------------------------------------------------------------------------------- +yamllint *ale-yaml-yamllint* + +g:ale_yaml_yamllint_executable *g:ale_yaml_yamllint_executable* + + Type: |String| + Default: `'yamllint'` + + This variable can be set to change the path to yamllint. + + +g:ale_yaml_yamllint_options *g:ale_yaml_yamllint_options* + + Type: |String| + Default: `''` + + This variable can be set to pass additional options to yamllint. + + +------------------------------------------------------------------------------- + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: diff --git a/doc/ale.txt b/doc/ale.txt index 8a9ec474..6f64abe0 100644 --- a/doc/ale.txt +++ b/doc/ale.txt @@ -1,4 +1,4 @@ -*ale.txt* For Vim version 8.0. Last change: 2016 October 10 +*ale.txt* For Vim version 8.0. *ale* ALE - Asynchronous Lint Engine @@ -9,49 +9,72 @@ 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. cpp-clang.......................|ale-linter-options-cpp-clang| - 4.18. cpp-clangtidy...................|ale-linter-options-cpp-clangtidy| - 4.19. python-flake8...................|ale-linter-options-python-flake8| - 4.20. ruby-rubocop....................|ale-linter-options-ruby-rubocop| - 4.21. chktex..........................|ale-linter-options-chktex| - 4.22. lacheck.........................|ale-linter-options-lacheck| - 4.23. stylelint.......................|ale-linter-options-stylelint| - 4.24. rustc...........................|ale-linter-options-rustc| - 4.25. python-mypy.....................|ale-linter-options-python-mypy| - 4.26. python-pylint...................|ale-linter-options-python-pylint| - 4.27. erlang..........................|ale-linter-options-erlang| - 4.28. phpmd...........................|ale-linter-options-phpmd| - 4.29. xo..............................|ale-linter-options-xo| - 4.30. javac...........................|ale-linter-options-javac| - 4.31. yamllint........................|ale-linter-options-yamllint| - 4.32. cmakelint.......................|ale-linter-options-cmakelint| - 4.33. perl-perl.......................|ale-linter-options-perl-perl| - 4.34. rust-cargo......................|ale-linter-options-rust-cargo| - 4.35. asm-gcc.........................|ale-linter-options-asm-gcc| - 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| + 4. Linter Options and Recommendations...|ale-linter-options| + asm...................................|ale-asm-options| + gcc.................................|ale-asm-gcc| + c.....................................|ale-c-options| + clang...............................|ale-c-clang| + cppcheck............................|ale-c-cppcheck| + gcc.................................|ale-c-gcc| + cpp...................................|ale-cpp-options| + clang...............................|ale-cpp-clang| + clangtidy...........................|ale-cpp-clangtidy| + cppcheck............................|ale-cpp-cppcheck| + gcc.................................|ale-cpp-gcc| + css...................................|ale-css-options| + stylelint...........................|ale-css-stylelint| + cmake.................................|ale-cmake-options| + cmakelint...........................|ale-cmake-cmakelint| + erlang................................|ale-erlang-options| + erlc................................|ale-erlang-erlc| + fortran...............................|ale-fortran-options| + gcc.................................|ale-fortran-gcc| + html..................................|ale-html-options| + htmlhint............................|ale-html-htmlhint| + tidy................................|ale-html-tidy| + java..................................|ale-java-options| + javac...............................|ale-java-javac| + javascript............................|ale-javascript-options| + eslint..............................|ale-javascript-eslint| + flow................................|ale-javascript-flow| + jshint..............................|ale-javascript-jshint| + xo..................................|ale-javascript-xo| + lua...................................|ale-lua-options| + luacheck............................|ale-lua-luacheck| + ocaml.................................|ale-ocaml-options| + merlin..............................|ale-ocaml-merlin| + perl..................................|ale-perl-options| + perl................................|ale-perl-perl| + php...................................|ale-php-options| + phpcs...............................|ale-php-phpcs| + phpmd...............................|ale-php-phpmd| + python................................|ale-python-options| + flake8..............................|ale-python-flake8| + mypy................................|ale-python-mypy| + pylint..............................|ale-python-pylint| + ruby..................................|ale-ruby-options| + rubocop.............................|ale-ruby-rubocop| + rust..................................|ale-rust-options| + cargo...............................|ale-rust-cargo| + rustc...............................|ale-rust-rustc| + sass..................................|ale-sass-options| + stylelint...........................|ale-sass-stylelint| + scss..................................|ale-scss-options| + stylelint...........................|ale-scss-stylelint| + sh....................................|ale-sh-options| + shell...............................|ale-sh-shell| + shellcheck..........................|ale-sh-shellcheck| + tex...................................|ale-tex-options| + chktex..............................|ale-tex-chktex| + lacheck.............................|ale-tex-lacheck| + vim...................................|ale-vim-options| + vint................................|ale-vim-vint| + yaml..................................|ale-yaml-options| + yamllint............................|ale-yaml-yamllint| + 5. Commands/Keybinds....................|ale-commands| + 6. API..................................|ale-api| + 7. Special Thanks.......................|ale-special-thanks| + 8. Contact..............................|ale-contact| =============================================================================== 1. Introduction *ale-introduction* @@ -519,684 +542,14 @@ g:ale_warn_about_trailing_whitespace *g:ale_warn_about_trailing_whitespace* =============================================================================== -4. Linter Specific Options *ale-linter-options* +4. Linter Options and Recommendations *ale-linter-options* -Some linters have specific options which can be configured for each of them, -for customising their behaviour. +Linter options are documented in individual help files. See the table of +contents at |ale-contents|. -------------------------------------------------------------------------------- -4.1. eslint *ale-linter-options-eslint* - -g:ale_javascript_eslint_executable *g:ale_javascript_eslint_executable* - - Type: |String| - Default: `'eslint'` - - ALE will first discover the eslint path in an ancestor node_modules - directory. If no such path exists, this variable will be used instead. - - This variable can be set to change the path to eslint. If you have eslint_d - installed, you can set this option to use eslint_d instead. - - If you wish to use only a globally installed version of eslint, set - |g:ale_javascript_eslint_use_global| to `1`. - - -g:ale_javascript_eslint_options *g:ale_javascript_eslint_options* - - Type: |String| - Default: `''` - - This variable can be set to pass additional options to eslint. - - -g:ale_javascript_eslint_use_global *g:ale_javascript_eslint_use_global* - - Type: |String| - Default: `0` - - This variable controls whether or not ALE will search for a local path for - eslint first. If this variable is set to `1`, then ALE will always use the - global version of eslint, in preference to locally installed versions of - eslint in node_modules. - -------------------------------------------------------------------------------- -4.2. flow *ale-linter-options-flow* - -g:ale_javascript_flow_executable *g:ale_javascript_flow_executable* - - Type: |String| - Default: `'flow'` - - ALE will first discover the flow path in an ancestor node_modules - directory. If no such path exists, this variable will be used instead. - - If you wish to use only a globally installed version of flow, set - |g:ale_javascript_flow_use_global| to `1`. - - -g:ale_javascript_flow_use_global *g:ale_javascript_flow_use_global* - - Type: |String| - Default: `0` - - This variable controls whether or not ALE will search for a local path for - flow first. If this variable is set to `1`, then ALE will always use the - global version of flow, in preference to locally installed versions of - flow in node_modules. - -------------------------------------------------------------------------------- -4.3. jshint *ale-linter-options-jshint* - -g:ale_javascript_jshint_executable *g:ale_javascript_jshint_executable* - - Type: |String| - Default: `'jshint'` - - ALE will first discover the jshint path in an ancestor node_modules - directory. If no such path exists, this variable will be used instead. - - This variable can be changed to change the path to jshint. - - If you wish to use only a globally installed version of jshint, set - |g:ale_javascript_jshint_use_global| to `1`. - - -g:ale_javascript_jshint_use_global *g:ale_javascript_jshint_use_global* - - Type: |String| - Default: `0` - - This variable controls whether or not ALE will search for a local path for - jshint first. If this variable is set to `1`, then ALE will always use the - global version of jshint, in preference to locally installed versions of - jshint in node_modules. - -------------------------------------------------------------------------------- -4.4. phpcs *ale-linter-options-phpcs* - -g:ale_php_phpcs_standard *g:ale_php_phpcs_standard* - - Type: |String| - Default: `''` - - This variable can be set to specify the coding standard used by phpcs. If no - 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* - -g:ale_html_tidy_executable *g:ale_html_tidy_executable* - - Type: |String| - Default: `'tidy'` - - This variable can be changed to change the path to tidy. - - -g:ale_html_tidy_args *g:ale_html_tidy_args* - - Type: |String| - Default: `'-q -e -language en'` - - This variable can be changed to change the arguments provided to the - executable. - - ALE will attempt to automatically detect the appropriate file encoding to - provide to html-tidy, and fall back to UTF-8 when encoding detection fails. - - The recognized file encodings are as follows: ascii, big5, cp1252 (win1252), - 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* - -g:ale_c_gcc_options *g:ale_c_gcc_options* - - Type: |String| - Default: `'-std=c11 -Wall'` - - This variable can be change to modify flags given to gcc. - -------------------------------------------------------------------------------- -4.7. cpp-gcc *ale-linter-options-cpp-gcc* - -g:ale_cpp_gcc_options *g:ale_cpp_gcc_options* - - Type: |String| - Default: `'-std=c++14 -Wall'` - - This variable can be changed to modify flags given to gcc. - -------------------------------------------------------------------------------- -4.8. fortran-gcc *ale-linter-options-fortran-gcc* - -g:ale_fortran_gcc_options *g:ale_fortran_gcc_options* - - Type: |String| - Default: `'-Wall'` - - This variable can be changed to modify flags given to gcc. - -------------------------------------------------------------------------------- -4.9. shell *ale-linter-options-shell* - -g:ale_linters_sh_shell_default_shell *g:ale_linters_sh_shell_default_shell* - - Type: |String| - Default: The current shell (`$SHELL`) or `'bash'` if that cannot be read. - - When ALE runs the linter for shells with the `-n` flag, it will attempt to - read the shell from the shebang (`#!`) line from the shell script to - determine the shell program to run. When this detection fails, this variable - will be used instead. - -------------------------------------------------------------------------------- -4.10. shellcheck *ale-linter-options-shellcheck* - -g:ale_linters_sh_shellcheck_exclusions *g:ale_linters_sh_shellcheck_exclusions* - - Type: |String| - Default: `''` - - Set this variable to exclude test(s) for shellcheck (-e/--exclude option). - -------------------------------------------------------------------------------- -4.11. vint *ale-linter-options-vint* - -g:ale_vim_vint_show_style_issues *g:ale_vim_vint_show_style_issues* - - Type: |Number| - Default: `1` - - This variable will enable/disable style issues for Vint. When this option - is disabled, only warnings and errors which are not purely style issues - will be reported. - -------------------------------------------------------------------------------- -4.12. luacheck *ale-linter-options-luacheck* - -g:ale_lua_luacheck_executable *g:ale_lua_luacheck_executable* - - Type: |String| - Default: `'luacheck'` - - This variable can be changed to change the path to luacheck. - -------------------------------------------------------------------------------- -4.13. c-cppcheck *ale-linter-options-c-cppcheck* - -g:ale_c_cppcheck_options *g:ale_c_cppcheck_options* - - Type: |String| - Default: `'--enable=style'` - - This variable can be changed to modify flags given to cppcheck. - -------------------------------------------------------------------------------- -4.14. cpp-cppcheck *ale-linter-options-cpp-cppcheck* - -g:ale_cpp_cppcheck_options *g:ale_cpp_cppcheck_options* - - Type: |String| - Default: `'--enable=style'` - - This variable can be changed to modify flags given to cppcheck. - -------------------------------------------------------------------------------- -4.15. htmlhint *ale-linter-options-htmlhint* - -g:ale_html_htmlhint_options *g:ale_html_htmlhint_options* - - Type: |String| - Default: `'--format=unix'` - - This variable can be changed to modify flags given to HTMLHint. - - -g:ale_html_htmlhint_executable *g:ale_html_htmlhint_executable* - - Type: |String| - Default: `'htmlhint'` - - ALE will first discover the htmlhint path in an ancestor node_modules - directory. If no such path exists, this variable will be used instead. - - If you wish to use only a globally installed version of htmlhint, set - |g:ale_html_htmlhint_use_global| to `1`. - - -g:ale_html_htmlhint_use_global *g:ale_html_htmlhint_use_global* - - Type: |String| - Default: `0` - - This variable controls whether or not ALE will search for a local path for - htmlhint first. If this variable is set to `1`, then ALE will always use the - global version of htmlhint, in preference to locally installed versions of - htmlhint in node_modules. - -------------------------------------------------------------------------------- -4.16. c-clang *ale-linter-options-c-clang* - -g:ale_c_clang_options *g:ale_c_clang_options* - - Type: |String| - Default: `'-std=c11 -Wall'` - - This variable can be change to modify flags given to clang. - -------------------------------------------------------------------------------- -4.17. cpp-clang *ale-linter-options-cpp-clang* - -g:ale_cpp_clang_options *g:ale_cpp_clang_options* - - Type: |String| - Default: `'-std=c++14 -Wall'` - - This variable can be changed to modify flags given to clang. - -------------------------------------------------------------------------------- -4.18. cpp-clangtidy *ale-linter-options-cpp-clangtidy* - -g:ale_cpp_clangtidy_options *g:ale_cpp_clangtidy_options* - - Type: |String| - Default: `'-std=c++14 -Wall'` - - This variable can be changed to modify flags given to clangtidy. - -------------------------------------------------------------------------------- -4.19. 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`). - -------------------------------------------------------------------------------- -4.20. ruby-rubocop *ale-linter-options-ruby-rubocop* - -g:ale_ruby_rubocop_options *g:ale_ruby_rubocop_options* - - Type: |String| - Default: `''` - - This variable can be change to modify flags given to rubocop. - -------------------------------------------------------------------------------- -4.21. chktex *ale-linter-options-chktex* - -g:ale_tex_chktex_executable *g:ale_tex_chktex_executable* - - Type: |String| - Default: `'chktex'` - - This variable can be changed to change the path to chktex. - - -g:ale_tex_chktex_options *g:ale_tex_chktex_options* - - Type: |String| - Default: `'-I'` - - This variable can be changed to modify flags given to chktex. - ------------------------------------------------------------------------------- -4.22. lacheck *ale-linter-options-lacheck* - -g:ale_lacheck_executable *g:ale_lacheck_executable* - - Type: |String| - Default: '`lacheck`' - - This variable can be changed to change the path to lacheck. - -------------------------------------------------------------------------------- -4.23. stylelint *ale-linter-options-stylelint* - -g:ale_css_stylelint_executable *g:ale_css_stylelint_executable* - - Type: |String| - Default: `'stylelint'` - - ALE will first discover the stylelint path in an ancestor node_modules - directory. If no such path exists, this variable will be used instead. - - If you wish to use only a globally installed version of stylelint, set - |g:ale_css_stylelint_use_global| to `1`. - -g:ale_css_stylelint_options *g:ale_css_stylelint_options* - - Type: |String| - Default: `''` - - This variable can be set to pass additional options to stylelint. - -g:ale_css_stylelint_use_global *g:ale_css_stylelint_use_global* - - Type: |String| - Default: `0` - - This variable controls whether or not ALE will search for a local path for - stylelint first. If this variable is set to `1`, then ALE will always use the - 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| - Default: `'stylelint'` - - ALE will first discover the stylelint path in an ancestor node_modules - directory. If no such path exists, this variable will be used instead. - - If you wish to use only a globally installed version of stylelint, set - |g:ale_sass_stylelint_use_global| to `1`. - - -g:ale_sass_stylelint_use_global *g:ale_sass_stylelint_use_global* - - Type: |String| - Default: `0` - - This variable controls whether or not ALE will search for a local path for - stylelint first. If this variable is set to `1`, then ALE will always use the - 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| - Default: `'stylelint'` - - ALE will first discover the stylelint path in an ancestor node_modules - directory. If no such path exists, this variable will be used instead. - - If you wish to use only a globally installed version of stylelint, set - |g:ale_scss_stylelint_use_global| to `1`. - - -g:ale_scss_stylelint_use_global *g:ale_scss_stylelint_use_global* - - Type: |String| - Default: `0` - - This variable controls whether or not ALE will search for a local path for - stylelint first. If this variable is set to `1`, then ALE will always use the - global version of stylelint, in preference to locally installed versions of - stylelint in node_modules. - ------------------------------------------------------------------------------- -4.24. rustc *ale-linter-options-rustc* - -g:ale_rust_ignore_error_codes *g:ale_rust_ignore_error_codes* - - Type: |List| of |String|s - Default: [] - - This variable can contain error codes which will be ignored. For example, to - ignore most errors regarding failed imports, put this in your .vimrc - > - let g:ale_rust_ignore_error_codes = ['E0432', 'E0433'] - - -------------------------------------------------------------------------------- -4.25. 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.26. python-pylint *ale-linter-options-python-pylint* - -g:ale_python_pylint_executable *g:ale_python_pylint_executable* - - Type: |String| - Default: `'pylint'` - - This variable can be changed to modify the executable used for pylint. - - -g:ale_python_pylint_options *g:ale_python_pylint_options* - - Type: |String| - Default: `''` - - 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 > - - 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`). - ------------------------------------------------------------------------------- -4.27. erlang *ale-linter-options-erlang* - -g:ale_erlang_erlc_options *g:ale_erlang_erlc_options* - - Type: |String| - Default: '`''`' - - This variable controls additional parameters passed to `erlc`, such as `-I` - or `-pa`. - ------------------------------------------------------------------------------- -4.28. phpmd *ale-linter-options-phpmd* - -g:ale_php_phpmd_ruleset *g:ale_php_phpmd_ruleset* - - Type: |String| - Default: 'cleancode,codesize,controversial,design,naming,unusedcode' - - This variable controls the ruleset used by phpmd. Default is to use all of - the available phpmd rulesets - ------------------------------------------------------------------------------- -4.29. xo *ale-linter-options-xo* - -g:ale_javascript_xo_executable *g:ale_javascript_xo_executable* - - Type: |String| - Default: `'xo'` - - ALE will first discover the xo path in an ancestor node_modules - directory. If no such path exists, this variable will be used instead. - - This variable can be set to change the path to xo. - - If you wish to use only a globally installed version of xo, set - |g:ale_javascript_xo_use_global| to `1`. - - -g:ale_javascript_xo_options *g:ale_javascript_xo_options* - - Type: |String| - Default: `''` - - This variable can be set to pass additional options to xo. - - -g:ale_javascript_xo_use_global *g:ale_javascript_xo_use_global* - - Type: |String| - Default: `0` - - This variable controls whether or not ALE will search for a local path for - xo first. If this variable is set to `1`, then ALE will always use the - global version of xo, in preference to locally installed versions of - xo in node_modules. - ------------------------------------------------------------------------------- -4.30. javac *ale-linter-options-javac* - -g:ale_java_javac_classpath *g:ale_java_javac_classpath* - - Type: |String| - Default: `''` - - This variable can be set to change the global classpath for Java. - - -g:ale_java_javac_options *g:ale_java_javac_options* - - Type: |String| - Default: `''` - - This variable can be set to pass additional options to javac. - ------------------------------------------------------------------------------- -4.31. yamllint *ale-linter-options-yamllint* - -g:ale_yaml_yamllint_executable *g:ale_yaml_yamllint_executable* - - Type: |String| - Default: `'yamllint'` - - This variable can be set to change the path to yamllint. - - -g:ale_yaml_yamllint_options *g:ale_yaml_yamllint_options* - - Type: |String| - Default: `''` - - This variable can be set to pass additional options to yamllint. - ------------------------------------------------------------------------------- -4.32. cmakelint *ale-linter-options-cmakelint* - -g:ale_cmake_cmakelint_exectuable *g:ale_cmake_cmakelint_executable* - - Type: |String| - Default: `'cmakelint'` - - This variable can be set to change the path the cmakelint. - -g:ale_cmake_cmakelint_options *g:ale_cmake_cmakelint_options* - - Type: |String| - Default: `''` - - This variable can be set to pass additional options to cmakelint. - -------------------------------------------------------------------------------- -4.33. perl-perl *ale-linter-options-perl-perl* - -g:ale_perl_perl_executable *g:ale_perl_perl_executable* - - Type: |String| - Default: `'perl'` - - This variable can be changed to modify the executable used for linting perl. - - -g:ale_perl_perl_options *g:ale_perl_perl_options* - - Type: |String| - Default: `'-X -c -Mwarnings -Ilib'` - - This variable can be changed to alter the command-line arguments to the perl - invocation. - -------------------------------------------------------------------------------- -4.34. rust-cargo *ale-linter-options-rust-cargo* - -g:ale_rust_cargo_use_check *g:ale_rust_cargo_use_check* - - Type: |Number| - Default: `1` - - When set to `1`, this option will cause ALE to use "cargo check" instead of - "cargo build". "cargo check" is supported since version 1.16.0 of Rust. - -------------------------------------------------------------------------------- -4.35. asm-gcc *ale-linter-options-asm-gcc* - -g:ale_asm_gcc_options *g:ale_asm_gcc_options* - - Type: |String| - Default: `'-Wall'` - - This variable can be set to pass additional options to gcc. =============================================================================== -5. Linter Integration Notes *ale-linter-integration* - -Some linters may have requirements for some other plugins being installed. - -------------------------------------------------------------------------------- -5.1. ocaml-merlin *ale-integration-ocaml-merlin* - - To use merlin linter for OCaml source code you need to make sure Merlin for - Vim is correctly configured. See the corresponding Merlin wiki page for - detailed instructions - (https://github.com/the-lambda-church/merlin/wiki/vim-from-scratch). - -------------------------------------------------------------------------------- -5.2. rust *ale-integration-rust* - - Since Vim does not detect the rust file type out-of-the-box, you need the - runtime files for rust from here: https://github.com/rust-lang/rust.vim - - Note that there are two possible linters for rust files: - - 1. rustc -- The Rust compiler is used to check the currently edited file. - So, if your project consists of multiple files, you will get some errors - when you use e.g. a struct which is defined in another file. You can use - |g:ale_rust_ignore_error_codes| to ignore some of these errors. - 2. cargo -- If your project is managed by Cargo, the whole project is - checked. That means that all errors are properly shown, but cargo can - only operate on the files written on disk. That means it is highly - recommended to turn off |g:ale_lint_on_text_changed| and to turn on - |g:ale_lint_on_save| in your vimrc file. - - Only cargo is enabled by default. To switch to using rustc instead of cargo, - configure |g:ale_linters| appropriately: > - - " See the help text for the option for more information. - let g:ale_linters = {'rust': ['rustc']} -< - - Also note that rustc 1.12. or later is needed. - -=============================================================================== -6. Commands/Keybinds *ale-commands* +5. Commands/Keybinds *ale-commands* ALELint *ALELint* @@ -1255,7 +608,7 @@ ALEDetail *ALEDetail* A plug mapping `(ale_detail)` is defined for this command. =============================================================================== -7. API *ale-api* +6. API *ale-api* ale#Queue(delay, [linting_flag]) *ale#Queue()* @@ -1538,13 +891,13 @@ ALELint *ALELint-autocmd* < =============================================================================== -8. Special Thanks *ale-special-thanks* +7. Special Thanks *ale-special-thanks* Special thanks to Mark Grealish (https://www.bhalash.com/) for providing ALE's snazzy looking ale glass logo. Cheers, Mark! =============================================================================== -9. Contact *ale-contact* +8. Contact *ale-contact* If you like this plugin, and wish to get in touch, check out the GitHub page for issues and more at https://github.com/w0rp/ale