Documentation is partially missing when a documented re-export is shadowing a glob re-export
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 119k
- Forks
- 16.1k
- PR merge metrics
- PR metrics pending
Description
Reproduction Steps
Create a workspace with two libraries:
foo/src/lib.rs:
pub struct Foo;
bar/src/lib.rs:
/// Documentation here
pub use foo::Foo;
pub use foo::*;
Archive containing the exact configuration I tested: glob-doc-missing.zip
Expected Outcome
"Documentation here" should appear on the documentation page of bar::Foo.
Actual Output
"Documentation here" appears in the item list of bar but not on the documentation page of bar::Foo.
Version
rustdoc 1.92.0 (ded5c06cf 2025-12-08)
Additional Details
@rustbot label +A-cross-crate-reexports
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the issue with foo/src/lib.rs and bar/src/lib.rs using rustdoc, then compare bar's item list with the documentation page for bar::Foo. The work is complete when "Documentation here" appears on bar::Foo's documentation page as well as in bar's item list.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- documentation
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Clearly specified
- Newbie friendliness
- 55/100