Skip to content

Rustdoc does not combine documentation in re-exports of extern functions #135092

@cuttestkittensrule

Description

@cuttestkittensrule

With the code

mod native {
    extern "C" {
        /// bar.
        pub fn bar();
    }
}

/// foo
pub use native::bar;

I expected to have the documentation in the private module and the re-export to be combined

Instead, only the documentation in the private module in shown

Image

Meta

rustdoc --version --verbose:

rustdoc 1.86.0-nightly (3f43b1a63 2025-01-03)
binary: rustdoc
commit-hash: 3f43b1a636738f41c48df073c5bcb97a97bf8459
commit-date: 2025-01-03
host: x86_64-unknown-linux-gnu
release: 1.86.0-nightly
LLVM version: 19.1.6

Activity

added
needs-triageThis issue may need triage. Remove it if it has been sufficiently triaged.
on Jan 4, 2025
added
T-rustdocRelevant to the rustdoc team, which will review and decide on the PR/issue.
T-rustdoc-frontendRelevant to the rustdoc-frontend team, which will review and decide on the web UI/UX output.
and removed
needs-triageThis issue may need triage. Remove it if it has been sufficiently triaged.
on Jan 6, 2025
added
A-local-reexportsArea: Documentation that has been locally re-exported (i.e., non-cross-crate)
on May 29, 2025
self-assigned this
on May 29, 2025
added
C-bugCategory: This is a bug.
and removed
C-bugCategory: This is a bug.
T-rustdoc-frontendRelevant to the rustdoc-frontend team, which will review and decide on the web UI/UX output.
on May 29, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

A-local-reexportsArea: Documentation that has been locally re-exported (i.e., non-cross-crate)C-bugCategory: This is a bug.T-rustdocRelevant to the rustdoc team, which will review and decide on the PR/issue.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

    Development

    Participants

    @GuillaumeGomez@lolbinarycat@jieyouxu@rustbot@cuttestkittensrule

    Issue actions

      Rustdoc does not combine documentation in re-exports of extern functions · Issue #135092 · rust-lang/rust