Skip to content
This repository was archived by the owner on Dec 29, 2022. It is now read-only.

Commit 5f18294

Browse files
authored
Merge pull request #1243 from alexheretic/readme-missing-nightly
Readme: Improve missing nightly info
2 parents f296e6b + 82db806 commit 5f18294

File tree

1 file changed

+10
-4
lines changed

1 file changed

+10
-4
lines changed

README.md

+10-4
Original file line numberDiff line numberDiff line change
@@ -54,11 +54,17 @@ Once you have rustup installed, run the following commands:
5454
rustup component add rls rust-analysis rust-src
5555
```
5656

57-
#### Note (nightly only)
58-
Sometimes the `rls` component is not included in a nightly build due to
59-
certain issues. To see if the component is included in a particular build and
60-
what to do if it's not, check [#641](https://github.com/rust-lang/rls/issues/641).
57+
### error: component 'rls' is unavailable for download (nightly)
58+
The development of rustc's internals is quite fast paced. Downstream projects that rely on nightly internals, particularly clippy, can break fairly often because of this.
6159

60+
When such breakages occur the nightly release will be missing rls. This is a trade-off compared with the other option of just not publishing the night's release, but does avoid blocking the rust nightly releases for people that don't need clippy/rls.
61+
62+
To mitigate the issues we have:
63+
* rustup will warn if the update is missing any components you currently have. This means you can no longer accidentally update to a no-rls release. Once rls is available again it'll update.
64+
* rls, clippy are available on the stable channel. Meaning most developers installing for the first time should use stable.
65+
* However, if you need latest nightly rls you can use https://mexus.github.io/rustup-components-history/ to find and install a dated nightly release ie `rustup install nightly-2018-12-06`.
66+
67+
Also see [#641](https://github.com/rust-lang/rls/issues/641).
6268

6369
## Running
6470

0 commit comments

Comments
 (0)