Skip to content

Commit

Permalink
Add a comment why rustdoc loads crates from the sysroot
Browse files Browse the repository at this point in the history
  • Loading branch information
jyn514 committed Sep 15, 2020
1 parent f7f9a6c commit b93a831
Showing 1 changed file with 5 additions and 1 deletion.
6 changes: 5 additions & 1 deletion src/librustdoc/lib.rs
Expand Up @@ -21,7 +21,11 @@ extern crate tracing;

// N.B. these need `extern crate` even in 2018 edition
// because they're loaded implicitly from the sysroot.
// Dependencies listed in Cargo.toml do not need extern crate.
// The reason they're loaded from the sysroot is because
// the rustdoc artifacts aren't stored in rustc's cargo target directory.
// So if `rustc` was specified in Cargo.toml, this would spuriously rebuild crates.
//
// Dependencies listed in Cargo.toml do not need `extern crate`.
extern crate rustc_ast;
extern crate rustc_ast_pretty;
extern crate rustc_attr;
Expand Down

0 comments on commit b93a831

Please sign in to comment.