mirror of
https://github.com/amix/vimrc
synced 2025-06-16 09:35:01 +08:00
Removed syntastic and replaced it with ale
Read more here: https://github.com/w0rp/ale
This commit is contained in:
Amir Salihefendic
153
sources_non_forked/ale/doc/ale-rust.txt
Normal file
153
sources_non_forked/ale/doc/ale-rust.txt
Normal file
@ -0,0 +1,153 @@
|
||||
===============================================================================
|
||||
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 three 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, so errors will not be reported
|
||||
while you type.
|
||||
3. rls -- If you have `rls` installed, you might prefer using this linter
|
||||
over cargo. rls implements the Language Server Protocol for incremental
|
||||
compilation of Rust code, and can check Rust files while you type. `rls`
|
||||
requires Rust files to contained in Cargo projects.
|
||||
4. rustfmt -- If you have `rustfmt` installed, you can use it as a fixer to
|
||||
consistently reformat your Rust code.
|
||||
|
||||
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*
|
||||
*b: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.
|
||||
|
||||
ALE will never use `cargo check` when the version of `cargo` is less than
|
||||
0.17.0.
|
||||
|
||||
|
||||
g:ale_rust_cargo_check_all_targets *g:ale_rust_cargo_check_all_targets*
|
||||
*b:ale_rust_cargo_check_all_targets*
|
||||
Type: |Number|
|
||||
Default: `0`
|
||||
|
||||
When set to `1`, ALE will set the `--all-targets` option when `cargo check`
|
||||
is used. See |g:ale_rust_cargo_use_check|,
|
||||
|
||||
|
||||
g:ale_rust_cargo_default_feature_behavior
|
||||
*g:ale_rust_cargo_default_feature_behavior*
|
||||
*b:ale_rust_cargo_default_feature_behavior*
|
||||
Type: |String|
|
||||
Default: `default`
|
||||
|
||||
When set to `none`, ALE will set the `--no-default-features` option when
|
||||
invoking `cargo`. Only the features specified in
|
||||
|g:ale_rust_cargo_include_features| will be included when performing the
|
||||
lint check.
|
||||
|
||||
When set to `default`, ALE will instruct `cargo` to build all default
|
||||
features specified in the project's `Cargo.toml` file, in addition to
|
||||
including any additional features defined in
|
||||
|g:ale_rust_cargo_include_features|.
|
||||
|
||||
When set to `all`, ALE will set the `--all-features` option when
|
||||
invoking `cargo`, which will include all features defined in the project's
|
||||
`Cargo.toml` file when performing the lint check.
|
||||
|
||||
|
||||
g:ale_rust_cargo_include_features *g:ale_rust_cargo_include_features*
|
||||
*b:ale_rust_cargo_include_features*
|
||||
Type: |String|
|
||||
Default: `''`
|
||||
|
||||
When defined, ALE will set the `--features` option when invoking `cargo` to
|
||||
perform the lint check. See |g:ale_rust_cargo_default_feature_behavior|.
|
||||
|
||||
|
||||
===============================================================================
|
||||
rls *ale-rust-rls*
|
||||
|
||||
g:ale_rust_rls_executable *g:ale_rust_rls_executable*
|
||||
*b:ale_rust_rls_executable*
|
||||
Type: |String|
|
||||
Default: `'rls'`
|
||||
|
||||
This variable can be modified to change the executable path for `rls`.
|
||||
|
||||
|
||||
g:ale_rust_rls_toolchain *g:ale_rust_rls_toolchain*
|
||||
*b:ale_rust_rls_toolchain*
|
||||
Type: |String|
|
||||
Default: `'nightly'`
|
||||
|
||||
This option can be set to change the toolchain used for `rls`. Possible
|
||||
values include `'nightly'`, `'beta'`, and `'stable'`.
|
||||
|
||||
The `rls` server will only be started once per executable.
|
||||
|
||||
|
||||
===============================================================================
|
||||
rustc *ale-rust-rustc*
|
||||
|
||||
|
||||
g:ale_rust_rustc_options *g:ale_rust_rustc_options*
|
||||
*b:ale_rust_rustc_options*
|
||||
Type: |String|
|
||||
Default: `'-Z no-trans'`
|
||||
|
||||
The variable can be used to change the options passed to `rustc`.
|
||||
|
||||
`-Z no-trans` should only work with nightly builds of Rust. Be careful when
|
||||
setting the options, as running `rustc` could execute code or generate
|
||||
binary files.
|
||||
|
||||
|
||||
g:ale_rust_ignore_error_codes *g:ale_rust_ignore_error_codes*
|
||||
*b: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']
|
||||
|
||||
|
||||
===============================================================================
|
||||
rustfmt *ale-rust-rustfmt*
|
||||
|
||||
g:ale_rust_rustfmt_options *g:ale_rust_rustfmt_options*
|
||||
*b:ale_rust_rustfmt_options*
|
||||
Type: |String|
|
||||
Default: `''`
|
||||
|
||||
This variable can be set to pass additional options to the rustfmt fixer.
|
||||
|
||||
|
||||
===============================================================================
|
||||
vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl:
|
||||
Reference in New Issue
Block a user