Rust 1.62 doesn't like the docstring on instrinsics

[9names]

In the new Rust release (1.62.0), cargo doc has a failing test for the code in this docstring, which CI is upset about.

I plan to merge a small PR that comments out the code to get it to work again. This issue is to remind us to investigate and either report or fix (depending on whether this breakage is our fault or cargo doc's)

The code that breaks is here

rp-hal/rp2040-hal/src/intrinsics.rs

Line 61 in b12aecb

/// intrinsics! {

I've quoted it below to make it a bit more accessible.

/// The macro used to define overridden intrinsics.
///
/// This is heavily inspired by the macro used by compiler-builtins.  The idea
/// is to abstract anything special that needs to be done to override an
/// intrinsic function.  Intrinsic generation is disabled for non-ARM targets
/// so things like CI and docs generation do not have problems.  Additionally
/// they can be disabled with the crate feature `disable-intrinsics` for
/// testing or comparing performance.
///
/// Like the compiler-builtins macro, it accepts a series of functions that
/// looks like normal Rust code:
///
///     intrinsics! {
///         extern "C" fn foo(a: i32) -> u32 {
///             // ...
///         }
///
///         #[nonstandard_attribute]
///         extern "C" fn bar(a: i32) -> u32 {
///             // ...
///         }
///     }
///
/// Each function can also be decorated with nonstandard attributes to control
/// additional behaviour:
///
/// * `slower_than_default` - indicates that the override is slower than the
///   default implementation.  Currently this just disables the override
///   entirely.
/// * `bootrom_v2` - indicates that the override is only available
///   on a V2 bootrom or higher.  Only enabled when the feature
///   `rom-v2-intrinsics` is set.
/// * `alias` - accepts a list of names to alias the intrinsic to.
/// * `aeabi` - accepts a list of ARM EABI names to alias to.
///
macro_rules! intrinsics {

[jannic]

Looks like before 1.62, non-expored macros were not doc-tested:
rust-lang/rust#97030
rust-lang/rust#98749