Closed
Description
Given a base crate
// bar/src/lib.rs
pub trait Foo {
/// [`Bar`] [`Baz`]
fn foo();
}
pub trait Bar {
}
pub trait Baz {
}
and a crate that uses that and re-exports types from it in a different structure
// foo/src/lib.rs
pub mod bar {
pub use ::bar::Bar;
}
pub use ::bar::{Foo, Baz};
The links in the re-exported types only work when the module structure matches between the two crates (in this case for Baz
but not for Bar
)
Rustdoc correctly warns that it can't resolve the link, but this seems like a primary usecase of the feature to allow facade crates to have correctly linked docs when they rearrange types from underlying crates.
warning: `[Bar]` cannot be resolved, ignoring it...
--> /private/var/folders/0p/5yvmrvhj5w3_vy1y8x7dvk7m0000gn/T/tmp.lUuznfwf/foo/bar/src/lib.rs:2:10
|
2 | /// [`Bar`] [`Baz`]
| ^^^^^ cannot be resolved, ignoring
|
Metadata
Metadata
Assignees
Labels
Type
Projects
Milestone
Relationships
Development
No branches or pull requests
Activity
Nemo157 commentedon May 16, 2019
@rustbot modify labels to A-intra-doc-links T-rustdoc.
Manishearth commentedon Oct 30, 2019
Filed #65983 with more information on this so someone can pick it up if they want to