The #[doc(alias = "...")] attribute became stable in Rust 1.48, and an interesting usecase for the feature was presented in this blog post. Libraries that wrap over an FFI interface (like nvml-wrapper does) can use the attribute to make it easier for developers used to working with the C library to transition to the Rust wrapper by enabling them to search for the C function names directly.

As an example, the following wrapper function in nvml-wrapper:

pub fn are_devices_on_same_board(
    &self,
    device1: &Device,
    device2: &Device,
) -> Result<bool, NvmlError> {
    let sym = nvml_sym(self.lib.nvmlDeviceOnSameBoard.as_ref())?;

    unsafe {
        let mut bool_int: c_int = mem::zeroed();

        nvml_try(sym(device1.handle(), device2.handle(), &mut bool_int))?;

        match bool_int {
            0 => Ok(false),
            _ => Ok(true),
        }
    }
}

should be annotated with the following attribute:

#[doc(alias = "nvmlDeviceOnSameBoard")]

So that it's possible to search for the C function name and find the equivalent method in the Rust wrapper.

I'd be happy to accept a PR adding usages of this attribute around the wrapper!