Enum rustdoc::passes::collect_intra_doc_links::AnchorFailure

pub(in passes::collect_intra_doc_links) enum AnchorFailure {
    MultipleAnchors,
    RustdocAnchorConflict(Res),
}

Variants

MultipleAnchors

User error: [std#x#y] is not valid

RustdocAnchorConflict(Res)

The anchor provided by the user conflicts with Rustdoc's generated anchor.

This is an unfortunate state of affairs. Not every item that can be linked to has its own page; sometimes it is a subheading within a page, like for associated items. In those cases, rustdoc uses an anchor to link to the subheading. Since you can't have two anchors for the same link, Rustdoc disallows having a user-specified anchor.

Most of the time this is fine, because you can just link to the page of the item if you want to provide your own anchor. For primitives, though, rustdoc uses the anchor as a side channel to know which page to link to; it doesn't show up in the generated link. Ideally, rustdoc would remove this limitation, allowing you to link to subheaders on primitives.