Skip to content

Conversation

@dingxiangfei2009
Copy link

Judging from user feedback coming out of Debian
distros, it appears that after installing rustup from the package manager it is not immediately clear which command installs the toolchain.

This patch adds a small text so that after installation of rustup, which normally does not invoke the toolchain installation for the user, the user can still receive guidance on how to set up the local toolchain immediately.

Judging from user feedback coming out of Debian
distros, it appears that after installing `rustup`
from the package manager it is not immediately
clear which command installs the toolchain.
This patch adds a small text so that after
installation of `rustup`, which normally does not
invoke the toolchain installation for the user,
the user can still receive guidance on how to set
up the local toolchain immediately.

Signed-off-by: Xiangfei Ding <dingxiangfei2009@protonmail.ch>
@djc
Copy link
Contributor

djc commented Dec 19, 2025

I think it would be good to try and address this problem, but not sure adding a "common commands" section to the end is the best way to do it. Wonder if we can add this to the top, either as part of Usage: or even before that.

@rami3l
Copy link
Member

rami3l commented Dec 19, 2025

I think it would be good to try and address this problem, but not sure adding a "common commands" section to the end is the best way to do it.

I would like to disagree with @djc on that matter, as when a command is executed, the first thing I see is the last lines of its output, which is different from when reading a normal doc page.


OTOH I do think the case for Debian is still somewhat particular, since installing via APT technically still has quite limited support notably because it explicitly bypasses the rustup-init stage.

We have tried to improve the situation in both our docs and, in my case, its homebrew packaging:

> brew install rustup
[..]
==> Caveats
To initialize `rustup`, set a default toolchain:
  rustup default stable

If you have `rust` installed, ensure you have "$(brew --prefix rustup)/bin"
before "$(brew --prefix)/bin" in your $PATH:
  https://rust-lang.github.io/rustup/installation/already-installed-rust.html

So the policy that I had in the past would be to acknowledge this as the package manager/maintainer's responsibility. Can something similar be done on Debian's side?

Update Rust toolchains and rustup
{LITERAL}$ rustup toolchain install{LITERAL:#}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's $ rustup toolchain install stable since you've mentioned the stable release.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants