4bea50b82f
* Add clang-format fixer for C/C++ * Document clang-format options * Refer ale-cpp-clangformat to ale-c-clangformat
201 lines
7.9 KiB
Plaintext
201 lines
7.9 KiB
Plaintext
===============================================================================
|
|
ALE C++ Integration *ale-cpp-options*
|
|
|
|
|
|
===============================================================================
|
|
Global Options
|
|
|
|
g:ale_c_build_dir_names *g:ale_c_build_dir_names*
|
|
*b:ale_c_build_dir_names*
|
|
|
|
Type: |List|
|
|
Default: `['build', 'bin']`
|
|
|
|
A list of directory names to be used when searching upwards from cpp
|
|
files to discover compilation databases with. For directory named `'foo'`,
|
|
ALE will search for `'foo/compile_commands.json'` in all directories on and above
|
|
the directory containing the cpp file to find path to compilation database.
|
|
This feature is useful for the clang tools wrapped around LibTooling (namely
|
|
here, clang-tidy)
|
|
|
|
|
|
g:ale_c_build_dir *g:ale_c_build_dir*
|
|
*b:ale_c_build_dir*
|
|
|
|
Type: |String|
|
|
Default: `''`
|
|
|
|
A path to the directory containing the `compile_commands.json` file to use
|
|
with c-family linters. Usually setting this option to a non-empty string
|
|
will override the |g:ale_c_build_dir_names| option to impose a compilation
|
|
database (it can be useful if multiple builds are in multiple build
|
|
subdirectories in the project tree).
|
|
This feature is also most useful for the clang tools linters, wrapped
|
|
aroung LibTooling (namely clang-tidy here)
|
|
|
|
===============================================================================
|
|
clang *ale-cpp-clang*
|
|
|
|
g:ale_cpp_clang_executable *g:ale_cpp_clang_executable*
|
|
*b:ale_cpp_clang_executable*
|
|
Type: |String|
|
|
Default: `'clang++'`
|
|
|
|
This variable can be changed to use a different executable for clang.
|
|
|
|
|
|
g:ale_cpp_clang_options *g:ale_cpp_clang_options*
|
|
*b:ale_cpp_clang_options*
|
|
Type: |String|
|
|
Default: `'-std=c++14 -Wall'`
|
|
|
|
This variable can be changed to modify flags given to clang.
|
|
|
|
|
|
===============================================================================
|
|
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_executable *g:ale_cpp_clangcheck_executable*
|
|
*b:ale_cpp_clangcheck_executable*
|
|
Type: |String|
|
|
Default: `'clang-check'`
|
|
|
|
This variable can be changed to use a different executable for clangcheck.
|
|
|
|
|
|
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
|
|
`compile_commands.json` files can be used. It is recommended to use this
|
|
linter in combination with `compile_commands.json` files.
|
|
Therefore, `clang-tidy` 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_clangtidy_checks *g:ale_cpp_clangtidy_checks*
|
|
*b:ale_cpp_clangtidy_checks*
|
|
Type: |List|
|
|
Default: `['*']`
|
|
|
|
The checks to enable for clang-tidy with the `-checks` argument.
|
|
|
|
All options will be joined with commas, and escaped appropriately for
|
|
the shell. The `-checks` flag can be removed entirely by setting this
|
|
option to an empty List.
|
|
|
|
|
|
g:ale_cpp_clangtidy_executable *g:ale_cpp_clangtidy_executable*
|
|
*b:ale_cpp_clangtidy_executable*
|
|
Type: |String|
|
|
Default: `'clang-tidy'`
|
|
|
|
This variable can be changed to use a different executable for clangtidy.
|
|
|
|
|
|
g:ale_cpp_clangtidy_options *g:ale_cpp_clangtidy_options*
|
|
*b:ale_cpp_clangtidy_options*
|
|
Type: |String|
|
|
Default: `''`
|
|
|
|
This variable can be changed to modify flags given to clang-tidy.
|
|
|
|
- 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.
|
|
|
|
|
|
===============================================================================
|
|
cppcheck *ale-cpp-cppcheck*
|
|
|
|
g:ale_cpp_cppcheck_executable *g:ale_cpp_cppcheck_executable*
|
|
*b:ale_cpp_cppcheck_executable*
|
|
Type: |String|
|
|
Default: `'cppcheck'`
|
|
|
|
This variable can be changed to use a different executable for cppcheck.
|
|
|
|
|
|
g:ale_cpp_cppcheck_options *g:ale_cpp_cppcheck_options*
|
|
*b:ale_cpp_cppcheck_options*
|
|
Type: |String|
|
|
Default: `'--enable=style'`
|
|
|
|
This variable can be changed to modify flags given to cppcheck.
|
|
|
|
|
|
===============================================================================
|
|
cpplint *ale-cpp-cpplint*
|
|
|
|
g:ale_cpp_cpplint_executable *g:ale_cpp_cpplint_executable*
|
|
*b:ale_cpp_cpplint_executable*
|
|
Type: |String|
|
|
Default: `'cpplint'`
|
|
|
|
This variable can be changed to use a different executable for cpplint.
|
|
|
|
|
|
g:ale_cpp_cpplint_options *g:ale_cpp_cpplint_options*
|
|
*b:ale_cpp_cpplint_options*
|
|
Type: |String|
|
|
Default: `''`
|
|
|
|
This variable can be changed to modify flags given to cpplint.
|
|
|
|
|
|
===============================================================================
|
|
gcc *ale-cpp-gcc*
|
|
|
|
g:ale_cpp_gcc_executable *g:ale_cpp_gcc_executable*
|
|
*b:ale_cpp_gcc_executable*
|
|
Type: |String|
|
|
Default: `'gcc'`
|
|
|
|
This variable can be changed to use a different executable for gcc.
|
|
|
|
|
|
g:ale_cpp_gcc_options *g:ale_cpp_gcc_options*
|
|
*b:ale_cpp_gcc_options*
|
|
Type: |String|
|
|
Default: `'-std=c++14 -Wall'`
|
|
|
|
This variable can be changed to modify flags given to gcc.
|
|
|
|
|
|
===============================================================================
|
|
clang-format *ale-cpp-clangformat*
|
|
|
|
See |ale-c-clangformat| for information about the available options.
|
|
Note that the C options are also used for C++.
|
|
|
|
|
|
===============================================================================
|
|
vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl:
|