Repository navigation
Make rustup-init install docs by default #891
Description
Activity
I've had multiple people comment on IRC that the change to no-docs has been a problem for them; at least two were already in a situation where they no longer had the bandwidth to download the docs, but assumed that they'd be there.
@steveklabnik Right, I was not sure if others had faced such a problem, but filed an issue anyway. My point is, if
rustup-initrecommends that I dorustup doc --book, then should docs not already be available? So, we can either point people at some URL (removingrustup-init's recommendation) or make docs bundled with initial install. I think we can safely assume that people opting for nightly or other channels know what they are doing and can install docs separately if they need them.Reacted by Vasili NovikovYes, I'm agreeing with you.
I had the same confusing first experience.
I installrustup, runrustup help, notice the note aboutrustup doc --book, run the command and ... nothing. No error, no fail state, nothing.I also had the same first experience, thinking that the installer must've failed somewhere.
If I hadn't found this thread, I wouldn't know what to do. Perhaps, the suggestion to read the Rust book should include the command to install it?If you are new to Rust consider running 'rustup component add rust-docs' and then 'rustup doc --book' to learn Rust.
Reacted by Sam El-BoraiThis issue is rather aggravated by none of
rustup doc --help rustup toolchain help rustup --help rustup toolchain listmentioning a thing about how to install the docs, or whether they are installed.
Reacted by Vasili NovikovI didn't have the
rust-docscomponent installed, and I tried to runrustup doc --book. Upon running it, immediately returns with a0status.rustup 0.6.5 (88ef618 2016-11-04)After I installed the
rust-doccomponent, it ran as expected. It'd be nice if there was a message indicating I should install that component.Reacted by Chip SenkbeilThis was changed back to make docs required.
Hi,
As a total beginner to rust, I installed
rustupon the recommendation of folks from#rust-beginners. After installing it,rustuprecommends that I runrustup doc --bookif I'm totally new to rust. So, following that I ran into an error and found that docs were not installed. I had to dorustup component add rust-docsand I'm back in business :-)Can we have rustup install docs for initial setup, at least for stable channels?