Remove unnecessary section on the quickstart doc

[JohnTitor]

Rustdoc is part of rustc component and we don't need an additional one.

Signed-off-by: Yuki Okushi [email protected]

[ksquirrel]

Review of df9158a39b69:

• ✔️ Commit df9158a: Looks fine!

[kloenk]

It is in the rustup default. But for example it is not always default in the NixOS env. So I would like to keep it. As it also has the note that per default it is installed.

[JohnTitor]

@kloenk As bjorn3 mentioned, all the profiles have the rustdoc even if it's minimal.

[ojeda]

LGTM -- I would update https://github.com/rust-lang/rustup/blob/master/doc/src/concepts/components.md to clarify in which component rustdoc is.

[ojeda]

rust-lang/rustup#2801

[ojeda]

What do you mean by:

and we don't need an additional one.

in the commit message?

[JohnTitor]

What do you mean by:

and we don't need an additional one.

in the commit message?

I mean we don't need an additional component (i.e. rust-docs or rustdoc). If it's unclear, I'm open to any suggestions.

[ojeda]

That's fine :)

[kloenk]

@kloenk As bjorn3 mentioned, all the profiles have the rustdoc even if it's minimal.

Yes for rustup. My package manager provides a package for rustc, which only includes rustc and no rustdoc. I already got bitten by this once, as rustc and rustdoc had ben a different version.

[ojeda]

Hmm... That is a good point. I think we should mention it (rustdoc is already in the table in changes.rst, but I think it should be in Quick Start too). On the other hand, we cannot try to cover every single case (e.g. someone could also want instructions to build the Rust toolchain by hand etc.).

Let me think about it.

[JohnTitor]

On the other hand, we cannot try to cover every single case

I agree with this point, we treat Rustup as our recommend way to use Rust. If you want to see the specific instructions for rustdoc, then why not expand clippy and rustfmt sections as well.
That said, it might be a bit unfriendly not to mention rustdoc entirely. I've reworded the section like this: https://github.com/JohnTitor/linux/tree/mention-rustdoc
Does it work for you?

[ojeda]

I agree with this point, we treat Rustup as our recommend way to use Rust.

Side-note: Rustup may not be the recommended way for the kernel later on (e.g. when distributions package the required toolchain to build their kernel).

Does it work for you?

LGTM -- perhaps remove the very last sentence since we do not say it for others:

If you are using another way to use Rust, you may have to install it manually.