rust-lang/rust
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Add a comment why rustdoc loads crates from the sysroot

Browse Source
This commit is contained in:
Joshua Nelson
2020-09-15 08:40:10 -04:00
parent f7f9a6c135
commit b93a8315f2
1 changed files with 5 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
src/librustdoc/lib.rs
View File

@@ -21,7 +21,11 @@ extern crate tracing;
// N.B. these need `extern crate` even in 2018 edition // N.B. these need `extern crate` even in 2018 edition
// because they're loaded implicitly from the sysroot. // 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;
extern crate rustc_ast_pretty; extern crate rustc_ast_pretty;
extern crate rustc_attr; extern crate rustc_attr;