summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/ale-cpp.txt37
-rw-r--r--doc/ale.txt1
2 files changed, 33 insertions, 5 deletions
diff --git a/doc/ale-cpp.txt b/doc/ale-cpp.txt
index 27e7fe0b..0b9b3ae1 100644
--- a/doc/ale-cpp.txt
+++ b/doc/ale-cpp.txt
@@ -45,6 +45,29 @@ g:ale_cpp_clang_options *g:ale_cpp_clang_options*
-------------------------------------------------------------------------------
+clangcheck *ale-cpp-clangcheck*
+
+`clang-check` will be run only when files are saved to disk, so that
+`compile_commands.json` files can be used. It is recommended to use this
+linter in combination with `compile_commands.json` files.
+Therefore, `clang-check` linter reads the options |g:ale_c_build_dir| and
+|g:ale_c_build_dir_names|. Also, setting |g:ale_c_build_dir| actually
+overrides |g:ale_c_build_dir_names|.
+
+
+g:ale_cpp_clangcheck_options *g:ale_cpp_clangcheck_options*
+ *b:ale_cpp_clangcheck_options*
+ Type: |String|
+ Default: `''`
+
+ This variable can be changed to modify flags given to clang-check.
+
+ This variable should not be set to point to build subdirectory with
+ `-p path/to/build` option, as it is handled by the |g:ale_c_build_dir|
+ option.
+
+
+-------------------------------------------------------------------------------
clangtidy *ale-cpp-clangtidy*
`clang-tidy` will be run only when files are saved to disk, so that
@@ -73,11 +96,15 @@ g:ale_cpp_clangtidy_options *g:ale_cpp_clangtidy_options*
This variable can be changed to modify flags given to clang-tidy.
- Setting this variable to a non-empty string will cause the `--` argument
- to be passed to `clang-tidy`, which will mean that detection of
- `compile_commands.json` files for compile command databases will be
- disabled. Only set this option if you want to control compiler flags
- entirely manually.
+ - Setting this variable to a non-empty string,
+ - and working in a buffer where no compilation database is found using
+ |g:ale_c_build_dir_names| or |g:ale_c_build_dir|,
+ will cause the `--` argument to be passed to `clang-tidy`, which will mean
+ that detection of `compile_commands.json` files for compile command
+ databases will be disabled.
+ Only set this option if you want to control compiler flags
+ entirely manually, and no `compile_commands.json` file is in one
+ of the |g:ale_c_build_dir_names| directories of the project tree.
-------------------------------------------------------------------------------
diff --git a/doc/ale.txt b/doc/ale.txt
index 2a760ba1..351e12cd 100644
--- a/doc/ale.txt
+++ b/doc/ale.txt
@@ -21,6 +21,7 @@ CONTENTS *ale-contents*
foodcritic..........................|ale-chef-foodcritic|
cpp...................................|ale-cpp-options|
clang...............................|ale-cpp-clang|
+ clangcheck..........................|ale-cpp-clangcheck|
clangtidy...........................|ale-cpp-clangtidy|
cppcheck............................|ale-cpp-cppcheck|
cpplint.............................|ale-cpp-cpplint|