Skip to content

Rustdoc --enable-index-page should work with --merge=finalize #144146

@TroyKomodo

Description

@TroyKomodo

Reproduction Steps

rustc --crate-type=rlib -o build/rlibs/liba.rlib --edition=2024 -Lbuild/rlibs --crate-name=a a.rs
rustc --crate-type=rlib -o build/rlibs/libb.rlib --edition=2024 -Lbuild/rlibs --crate-name=b b.rs
rustc --crate-type=rlib -o build/rlibs/libc.rlib --edition=2024 -Lbuild/rlibs --crate-name=c c.rs

rustdoc -Zunstable-options --parts-out-dir=build/doc/a/.parts -o build/doc/a --edition=2024 --crate-name=a --crate-version=0.1.0 --extern=a=build/rlibs/liba.rlib -Lbuild/rlibs a.rs
rustdoc -Zunstable-options --parts-out-dir=build/doc/b/.parts -o build/doc/b --edition=2024 --crate-name=b --crate-version=0.1.0 --extern=b=build/rlibs/libb.rlib -Lbuild/rlibs b.rs
rustdoc -Zunstable-options --parts-out-dir=build/doc/c/.parts -o build/doc/c --edition=2024 --crate-name=c --crate-version=0.1.0 --extern=c=build/rlibs/libc.rlib -Lbuild/rlibs c.rs

mkdir -p build/doc/merged
cp -r build/doc/a/* build/doc/merged
cp -r build/doc/b/* build/doc/merged
cp -r build/doc/c/* build/doc/merged

rustdoc -Zunstable-options --merge=finalize \
    -o build/doc/merged \
    --include-parts-dir=build/doc/a/.parts \
    --include-parts-dir=build/doc/b/.parts \
    --include-parts-dir=build/doc/c/.parts \
    --enable-index-page

Expected Outcome

Top level index.html (maybe help.html and settings.html too)

Actual Output

No top level index page.

Version

rustdoc 1.88.0 (6b00bc388 2025-06-23)
binary: rustdoc
commit-hash: 6b00bc3880198600130e1cf62b8f8a93494488cc
commit-date: 2025-06-23
host: x86_64-unknown-linux-gnu
release: 1.88.0
LLVM version: 20.1.5

Additional Details

If we provide a crate do document in the finalize rustdoc command the index page is generated.

Metadata

Metadata

Assignees

No one assigned

    Labels

    C-bugCategory: This is a bug.T-rustdocRelevant to the rustdoc team, which will review and decide on the PR/issue.needs-triageThis issue may need triage. Remove it if it has been sufficiently triaged.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions