refactor(gles): document Buffer::map_flags

[ErichDonGubler]

No description provided.

[cwfitzgerald]

This one line got wrecked by CI.

[DJMcNab]

To be consistent with the rest of intra-doc links, this only resolves associated items from traits that are in scope.

from rust-lang/rust#74489

So you might be able to make it work with:

#[cfg(doc)]
#[expect(unused_imports)]
use crate::Device;

in that file, else make the link be to crate::Device::map_buffer.

[ErichDonGubler]

To be consistent with the rest of intra-doc links, this only resolves associated items from traits that are in scope.

from rust-lang/rust#74489

So you might be able to make it work with:

#[cfg(doc)]
#[expect(unused_imports)]
use crate::Device;

in that file, else make the link be to crate::Device::map_buffer.

I really like this suggestion! Since this is the first and only use of the trait, I'm worried about introducing an import that's not easy to detect as actually unused later. I ended up using [`Device::map_buffer`](crate::Device::map_buffer), but I'm going to have to remember this insight for later.