From 08461cc8f03e3f1f462970331fa74233b9b62ba6 Mon Sep 17 00:00:00 2001 From: Jan Tache Date: Mon, 21 Feb 2022 22:37:19 -0800 Subject: [PATCH 1/2] 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. --- docs/user/manual.adoc | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/user/manual.adoc b/docs/user/manual.adoc index 2b1eae1e2a4..dfaa34fc9aa 100644 --- a/docs/user/manual.adoc +++ b/docs/user/manual.adoc @@ -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. From 90916b726ec92c3473c4402c104c311b4269aeea Mon Sep 17 00:00:00 2001 From: Jan Tache Date: Mon, 21 Feb 2022 23:01:05 -0800 Subject: [PATCH 2/2] Change Rust Analyzer->rust-analyzer to match style --- docs/user/manual.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/user/manual.adoc b/docs/user/manual.adoc index dfaa34fc9aa..0fc28466200 100644 --- a/docs/user/manual.adoc +++ b/docs/user/manual.adoc @@ -42,11 +42,11 @@ $ 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. +Only the latest stable standard library source is officially supported for use with rust-analyzer. +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`. +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]