On Wed, Jun 17, 2026 at 11:13 AM Malte Wechter <[email protected]> wrote:
>
> As of now doc strings are not generated for private items in the macros
> crate. I am moving the `parse_ordered_fields!` macro into
> macros/helpers.rs but this means the doc strings are not generated for
> the macro anymore. The `parse_ordered_fields!` macro is a larger helper
> function, and the doc strings are relevant and helpful for macro
> developers that wants to use it.

If it is private, then it is what it is, don't worry about it --
developers can still read the source code.

But, yes, having a render of the private items is something I have
wanted for a long time, but as a runtime toggle, so that it is easy to
go from one to the other (and without having to have 2 entire copies
of the docs).

Please the entry "Private documentation (perhaps as an extension of
the private items/fields toggle)" I have at:

  https://github.com/Rust-for-Linux/linux/issues/350

Upstream `rustdoc` implemented an MVP of the idea via CSS/JS in this draft PR:

  https://github.com/rust-lang/rust/pull/141299

If you want to help on that, then you could try it and leave some
feedback there! :)

Thanks!

Cheers,
Miguel

Reply via email to