It would be nice if we had special-casing for the disambiguator so that [`field@Foo::bar`] renders as Foo.bar. That would save a lot of doing [`Foo.bar`][field@Foo::bar].

IMHO using [`Foo.bar`] to create a link to the field is much more intuitive than [`Foo.bar`][field@Foo::bar] and generally looks nicer. Fields can’t even be referred with ::, so it’s hard to guess this syntax.

IMHO using [`Foo.bar`] to create a link to the field is much more intuitive than [`Foo.bar`][field@Foo::bar] and generally looks nicer. Fields can’t even be referred with ::, so it’s hard to guess this syntax.

Yeah, I second this. [`Foo::bar`] for unambiguous cases needs to stick around for backwards-compatibility, but I think [`Foo.bar`] is a better disambiguator for fields than [`field@Foo::bar`]. It matches the syntax used to access it better, and also imo it fits cleaner into the pattern of [`Foo::bar()`] and [`Foo::bar!`] disambiguators for methods and macros.

I think I’m willing to contribute this if the idea itself gets accepted. I kinda don’t have the energy to push it, ping relevant people, write justifications and do other social stuff like that right now. I’m not even sure how to make (organisational) progress here, since this issue exists for 3 years and there’s no reaction from the rustdoc team.

You are talking about a different problem than the one mentioned in the issue. We are not planning to add . to the intra doc link syntax for the reasons mentioned in #75437.

That’s kinda sad but fair. How about special-casing [`field@Foo::bar`] to render as Foo.bar that @camelid wrote about?

That should probably have an FCP from the rustdoc team. You can bring it up on Zulip if you want to get initial feedback on whether they think it's a good idea: https://rust-lang.zulipchat.com/#narrow/stream/266220-rustdoc

For anyone that is still looking for a way to link to a struct field, adding #structfield.<FIELDNAME> at the end of the link seems to work as a workaround, where <FIELDNAME> is the struct field you wish to link to (without the angle brackets).

This appears to generate the following URL when I generate the docs with rustdoc: file:///home/myuser/my_project/target/doc/my_sub_module/struct.Foo.html#structfield.bar

Example:

struct Foo {
    bar: i32,
}

impl Foo {
    // THE LINE BELOW ⬇️
    /// Get a reference to [`crate::my_sub_module::Foo#structfield.bar`].
    fn bar(&self) -> i32 {
        self.bar
    }
}