doc: state that only the latest stable toolchain is supported

This closes #11226. The content seemed to make more sense in the
installation section as opposed to the Troubleshooting section.
This commit is contained in:
Jan Tache 2022-02-21 22:37:19 -08:00
parent c0ee2f23ff
commit 08461cc8f0

View File

@ -40,6 +40,20 @@ To add the sources manually, run the following command:
$ rustup component add rust-src
```
=== Toolchain
Rust Analyzer only officially supports using the latest stable toolchain.
If you are using an older toolchain or have an override set, Rust Analyzer may fail to understand the Rust source.
You will either need to update your toolchain or use an older version of Rust Analyzer that is compatible with your toolchain.
If you are using an override in your project, you can still force Rust Analyzer to use the stable toolchain via the environment variable `RUSTUP_TOOLCHAIN`.
For example, with VS Code or coc-rust-analyzer:
[source,json]
----
{ "rust-analyzer.server.extraEnv": { "RUSTUP_TOOLCHAIN": "stable" } }
----
=== VS Code
This is the best supported editor at the moment.