From c7b0914b3fffc9fd648003c950cfff596c75edbf Mon Sep 17 00:00:00 2001 From: Joshua Nelson Date: Mon, 8 Mar 2021 16:56:42 -0500 Subject: Add more documentation for rustc_private --- crates/rust-analyzer/src/config.rs | 10 +++++++--- docs/user/generated_config.adoc | 2 +- editors/code/package.json | 2 +- 3 files changed, 9 insertions(+), 5 deletions(-) diff --git a/crates/rust-analyzer/src/config.rs b/crates/rust-analyzer/src/config.rs index 078c83f75..28e221271 100644 --- a/crates/rust-analyzer/src/config.rs +++ b/crates/rust-analyzer/src/config.rs @@ -180,10 +180,14 @@ config_data! { /// tests or binaries.\nFor example, it may be `--release`. runnables_cargoExtraArgs: Vec = "[]", - /// Path to the rust compiler sources, for usage in rustc_private projects, or "discover" - /// to try to automatically find it. Any project which uses rust-analyzer with the rustcPrivate + /// Path to the Cargo.toml of the rust compiler workspace, for usage in rustc_private + /// projects, or "discover" to try to automatically find it. + /// + /// Any project which uses rust-analyzer with the rustcPrivate /// crates must set `[package.metadata.rust-analyzer] rustc_private=true` to use it. - rustcSource : Option = "null", + /// + /// This option is not reloaded automatically; you must restart rust-analyzer for it to take effect. + rustcSource: Option = "null", /// Additional arguments to `rustfmt`. rustfmt_extraArgs: Vec = "[]", diff --git a/docs/user/generated_config.adoc b/docs/user/generated_config.adoc index 5243bcbf6..e0ffcc484 100644 --- a/docs/user/generated_config.adoc +++ b/docs/user/generated_config.adoc @@ -107,7 +107,7 @@ [[rust-analyzer.runnables.cargoExtraArgs]]rust-analyzer.runnables.cargoExtraArgs (default: `[]`):: Additional arguments to be passed to cargo for runnables such as tests or binaries.\nFor example, it may be `--release`. [[rust-analyzer.rustcSource]]rust-analyzer.rustcSource (default: `null`):: - Path to the rust compiler sources, for usage in rustc_private projects, or "discover" to try to automatically find it. Any project which uses rust-analyzer with the rustcPrivate crates must set `[package.metadata.rust-analyzer] rustc_private=true` to use it. + Path to the Cargo.toml of the rust compiler workspace, for usage in rustc_private projects, or "discover" to try to automatically find it. Any project which uses rust-analyzer with the rustcPrivate crates must set `[package.metadata.rust-analyzer] rustc_private=true` to use it. This option is not reloaded automatically; you must restart rust-analyzer for it to take effect. [[rust-analyzer.rustfmt.extraArgs]]rust-analyzer.rustfmt.extraArgs (default: `[]`):: Additional arguments to `rustfmt`. [[rust-analyzer.rustfmt.overrideCommand]]rust-analyzer.rustfmt.overrideCommand (default: `null`):: diff --git a/editors/code/package.json b/editors/code/package.json index 856f1c94e..e15e7875b 100644 --- a/editors/code/package.json +++ b/editors/code/package.json @@ -713,7 +713,7 @@ } }, "rust-analyzer.rustcSource": { - "markdownDescription": "Path to the rust compiler sources, for usage in rustc_private projects, or \"discover\" to try to automatically find it. Any project which uses rust-analyzer with the rustcPrivate crates must set `[package.metadata.rust-analyzer] rustc_private=true` to use it.", + "markdownDescription": "Path to the Cargo.toml of the rust compiler workspace, for usage in rustc_private projects, or \"discover\" to try to automatically find it. Any project which uses rust-analyzer with the rustcPrivate crates must set `[package.metadata.rust-analyzer] rustc_private=true` to use it. This option is not reloaded automatically; you must restart rust-analyzer for it to take effect.", "default": null, "type": [ "null", -- cgit v1.2.3