Skip to content

Commit

Permalink
Let docs pass through with custom toolchains
Browse files Browse the repository at this point in the history
Following rust-lang#2116, custom toolchains started to fail `rustup doc`, since
they can't list components to check if `rust-docs` is installed.

    error: toolchain 'system' does not support components
    error: caused by: invalid toolchain name: 'system'

Now custom toolchains just skip that component check, and it's up to the
user to have installed the documentation in their own way.
  • Loading branch information
cuviper committed Feb 21, 2020
1 parent 72bea7b commit fc94bf3
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 11 deletions.
24 changes: 13 additions & 11 deletions src/cli/rustup_mode.rs
Original file line number Diff line number Diff line change
Expand Up @@ -1312,17 +1312,19 @@ const DOCS_DATA: &[(&str, &str, &str,)] = &[

fn doc(cfg: &Cfg, m: &ArgMatches<'_>) -> Result<()> {
let toolchain = explicit_or_dir_toolchain(cfg, m)?;
for cstatus in &toolchain.list_components()? {
if cstatus.component.short_name_in_manifest() == "rust-docs" && !cstatus.installed {
info!(
"`rust-docs` not installed in toolchain `{}`",
toolchain.name()
);
info!(
"To install, try `rustup component add --toolchain {} rust-docs`",
toolchain.name()
);
return Err("unable to view documentation which is not installed".into());
if !toolchain.is_custom() {
for cstatus in &toolchain.list_components()? {
if cstatus.component.short_name_in_manifest() == "rust-docs" && !cstatus.installed {
info!(
"`rust-docs` not installed in toolchain `{}`",
toolchain.name()
);
info!(
"To install, try `rustup component add --toolchain {} rust-docs`",
toolchain.name()
);
return Err("unable to view documentation which is not installed".into());
}
}
}
let topical_path: PathBuf;
Expand Down
11 changes: 11 additions & 0 deletions tests/cli-rustup.rs
Original file line number Diff line number Diff line change
Expand Up @@ -1654,6 +1654,17 @@ fn docs_missing() {
});
}

#[test]
fn docs_custom() {
setup(&|config| {
let path = config.customdir.join("custom-1");
let path = path.to_string_lossy();
expect_ok(config, &["rustup", "toolchain", "link", "custom", &path]);
expect_ok(config, &["rustup", "default", "custom"]);
expect_stdout_ok(config, &["rustup", "doc", "--path"], "custom");
});
}

#[cfg(unix)]
#[test]
fn non_utf8_arg() {
Expand Down

0 comments on commit fc94bf3

Please sign in to comment.