Metal: Misc non-unsafe translation fixes

crates/dispatch2/src/object.rs

@@ -44,7 +44,7 @@ enum_with_val! {
 #[allow(missing_docs)] // TODO
 pub const QOS_MIN_RELATIVE_PRIORITY: i32 = -15;
 
-/// Error returned by [DispatchObject::set_qos_class_floor].
+/// Error returned by [`DispatchObject::set_qos_class_floor()`].
 #[derive(Debug, Copy, Clone, PartialEq, Eq, PartialOrd, Ord)]
 #[non_exhaustive]
 pub enum QualityOfServiceClassFloorError {

framework-crates/objc2-metal/src/device.rs

@@ -1,16 +1,19 @@
-use crate::MTLDevice;
 use objc2::rc::Retained;
 use objc2::runtime::ProtocolObject;
 use objc2_foundation::NSArray;
 
+#[cfg(doc)]
+use crate::MTLCreateSystemDefaultDevice;
+use crate::MTLDevice;
+
 /// Returns all Metal devices in the system.
 ///
 /// On macOS and macCatalyst, this API will not cause the system to switch
 /// devices and leaves the decision about which GPU to use up to the
 /// application based on whatever criteria it deems appropriate.
 ///
 /// On iOS, tvOS and visionOS, this API returns an array containing the same
-/// device that MTLCreateSystemDefaultDevice would have returned, or an empty
+/// device that [`MTLCreateSystemDefaultDevice()`] would have returned, or an empty
 /// array if it would have failed.
 #[inline]
 pub extern "C-unwind" fn MTLCopyAllDevices() -> Retained<NSArray<ProtocolObject<dyn MTLDevice>>> {

framework-crates/objc2-metal/src/lib.rs

@@ -11,7 +11,7 @@
 //!
 //! [apple-doc]: https://developer.apple.com/documentation/xcode/validating-your-apps-metal-api-usage/.
 //!
-//! NOTE: To use [`MTLCreateSystemDefaultDevice`] you need to link to
+//! NOTE: To use [`MTLCreateSystemDefaultDevice()`] you need to link to
 //! `CoreGraphics`, this can be done by using `objc2-core-graphics`, or by
 //! doing:
 //! ```rust