From 0d6ec9c987c8b37f3e23314e64e1c9d4c8d93851 Mon Sep 17 00:00:00 2001 From: Paul Jewell Date: Thu, 4 Jan 2024 21:16:03 +0000 Subject: [PATCH 1/3] Further tuning of the Gentoo installation instructions. based on feedback from the Gentoo repository maintainer, addition of the possibility to install rust-analyzer via rustup. --- docs/user/manual.adoc | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/user/manual.adoc b/docs/user/manual.adoc index 2a65fba7b6b..682770ba065 100644 --- a/docs/user/manual.adoc +++ b/docs/user/manual.adoc @@ -186,10 +186,12 @@ $ pacman -S rust-analyzer ==== Gentoo Linux -`rust-analyzer` is installed when the `rust-analyzer` USE flag is set for `dev-lang/rust` or `dev-lang/rust-bin`. -You also need to set the `rust-src` USE flag. +There are two ways to install `rust-analyzer` under gentoo: -This is similar to using the `rustup` component, so it will install a version that lags behind the official releases on GitHub . +- When installing dev-lang/rust, or dev-lang/rust-bin, set the `rust-analyzer` USE flag, as well as the `rust-src` USE flag. +- Use the rustup component to install `rust-analyzer` (see instructions above). + +In both cases, the version installed lags behind the official releases on GitHub. If you need a newer version of `rust-analyzer`, then consider installing from source. ==== macOS From 443787fe6a807609473c8860561918a86274353f Mon Sep 17 00:00:00 2001 From: Paul Jewell Date: Thu, 4 Jan 2024 21:37:07 +0000 Subject: [PATCH 2/3] Added reference to the binaries available from GitHub. In addition to installing from source. --- docs/user/manual.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/user/manual.adoc b/docs/user/manual.adoc index 682770ba065..f1b6d1ee20e 100644 --- a/docs/user/manual.adoc +++ b/docs/user/manual.adoc @@ -191,7 +191,7 @@ There are two ways to install `rust-analyzer` under gentoo: - When installing dev-lang/rust, or dev-lang/rust-bin, set the `rust-analyzer` USE flag, as well as the `rust-src` USE flag. - Use the rustup component to install `rust-analyzer` (see instructions above). -In both cases, the version installed lags behind the official releases on GitHub. If you need a newer version of `rust-analyzer`, then consider installing from source. +In both cases, the version installed lags behind the official releases on GitHub. If you need a newer version of `rust-analyzer`, then consider installing from source, or one of the binaries made available on the `rust-analyzer` GitHub page with each release. ==== macOS From 03ec0087a0fde665005e6797f056fa754d0329f6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lauren=C8=9Biu=20Nicola?= Date: Fri, 5 Jan 2024 10:19:58 +0200 Subject: [PATCH 3/3] Tweak wording a little more --- docs/user/manual.adoc | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/user/manual.adoc b/docs/user/manual.adoc index f1b6d1ee20e..fa8413c19ae 100644 --- a/docs/user/manual.adoc +++ b/docs/user/manual.adoc @@ -186,12 +186,13 @@ $ pacman -S rust-analyzer ==== Gentoo Linux -There are two ways to install `rust-analyzer` under gentoo: +There are two ways to install `rust-analyzer` under Gentoo: -- When installing dev-lang/rust, or dev-lang/rust-bin, set the `rust-analyzer` USE flag, as well as the `rust-src` USE flag. -- Use the rustup component to install `rust-analyzer` (see instructions above). +- when installing `dev-lang/rust` or `dev-lang/rust-bin`, enable the `rust-analyzer` and `rust-src` USE flags +- use the `rust-analyzer` component in `rustup` (see instructions above) -In both cases, the version installed lags behind the official releases on GitHub. If you need a newer version of `rust-analyzer`, then consider installing from source, or one of the binaries made available on the `rust-analyzer` GitHub page with each release. +Note that in both cases, the version installed lags for a couple of months behind the official releases on GitHub. +To obtain a newer one, you can download a binary from GitHub Releases or building from source. ==== macOS