Rustup without rust-docs?

Is there a reasonable workflow for using rustup without having rust-docs installed?

Why not have it installed?

  • From my unscientific observations, probably the longest step of using rustup to install rust (or upgrade a toolchain)
    • In my CI, installation takes 40s to 2m, depending on the toolchain and host
  • "large", 290 MB uncompressed
  • Completely unnecessary for CIs (and for development workflows that rely on online documentation)

I looked through the source for installing rustup and the closest option I could find is --default-toolchain none but I then still need to install a toolchain without rust-docs. I tried simulating that by uninstalling rust-docs which gave me

rustup component remove rust-docs
error: component 'rust-docs' for target 'x86_64-unknown-linux-gnu' is required for toolchain 'stable-x86_64-unknown-linux-gnu' and cannot be removed

This makes me assume that the toolchain "stable" has a hard dependency on rust-docs.

1 Like

There is an open issue on this: https://github.com/rust-lang/rustup.rs/issues/998

3 Likes