Rustdoc displays macros as macro_rules!s

[camelid]

See for std::marker::Copy:

But when you click on [src]:

pub macro Copy($item:item) {
    /* compiler built-in */
}

---

Or for proc_macro::quote!:

With source:

pub macro quote($($t:tt)*) {
    /* compiler built-in */
}

---

Or for core::ready!, which is not a built-in:

pub macro ready($e:expr) {
    match $e {
        $crate::task::Poll::Ready(t) => t,
        $crate::task::Poll::Pending => {
            return $crate::task::Poll::Pending;
        }
    }
}

---

@rustbot modify labels: T-rustdoc C-bug

[jyn514]

Related: #74355

[camelid]

I have a hunch that macro_rules! and macro are both represented as rustdoc::doctree::Macro, and then serialized to macro_rules! in rustdoc::clean and/or rustdoc::clean::inline.

[RalfJung]

Cc @GuillaumeGomez

[camelid]

I would experiment to see if that is what's causing it, but I'm waiting on a build for something else 😄

[jyn514]

I would experiment to see if that is what's causing it, but I'm waiting on a build for something else 😄

https://rustc-dev-guide.rust-lang.org/building/suggested.html#working-on-multiple-branches-at-the-same-time

[camelid]

Wow, I never noticed that! That's so cool :)

[camelid]

Indeed, changing rustdoc::clean changed the output. See if you can notice my experimental change ;)

And for a built-in: