Re: [PATCH] rust: doc: mark `Io` as notable trait
From: Miguel Ojeda
Date: Mon Oct 19 2026 - 08:38:34 EST
On Mon, Oct 19, 2026 at 2:28 PM Miguel Ojeda
<miguel.ojeda.sandonis@xxxxxxxxx> wrote:
>
> The attribute has been there under that name since 1.53, so it should
> be fine, and we can always rename it or remove it.
>
> Having said that, let's mention it in this week's call with upstream
> Rust. Cc'ing Guillaume so that he is aware too.
>
> Unless they say they really want us to not use it at all:
>
> Acked-by: Miguel Ojeda <ojeda@xxxxxxxxxx>
I added it to our usual live list in the "Nice to have" section:
https://github.com/Rust-for-Linux/linux/issues/2
By the way, for the commit:
Link: https://github.com/rust-lang/rust/issues/45040
Cheers,
Miguel
On Mon, Oct 19, 2026 at 2:28 PM Miguel Ojeda
<miguel.ojeda.sandonis@xxxxxxxxx> wrote:
>
> On Mon, Oct 19, 2026 at 1:48 PM Gary Guo <gary@xxxxxxxxxx> wrote:
> >
> > From: Gary Guo <gary@xxxxxxxxxxx>
> >
> > `Io` trait is the primary way of interacting with a bunch of types, e.g.
> > `Mmio` and `Coherent`. It is hidden in "blanket impl" section which is not
> > very discoverable.
> >
> > Use nightly feature to mark `Io` as a notable trait, so it is highlighted
> > at the top of the rustdoc page.
> >
> > Signed-off-by: Gary Guo <gary@xxxxxxxxxxx>
>
> The attribute has been there under that name since 1.53, so it should
> be fine, and we can always rename it or remove it.
>
> Having said that, let's mention it in this week's call with upstream
> Rust. Cc'ing Guillaume so that he is aware too.
>
> Unless they say they really want us to not use it at all:
>
> Acked-by: Miguel Ojeda <ojeda@xxxxxxxxxx>
>
> Cheers,
> Miguel
--
Cheers,
Miguel