Rollup merge of #148578 - WaffleLapkin:equal-alignment-atomic-from-mut-slice, r=m-ou-se

core docs: add notes about availability of `Atomic*::from_mut_slice`

See #76314 (comment)

r? libs-api

Author: jhpratt

library/core/src/sync/atomic.rs

@@ -1558,6 +1558,8 @@ impl<T> AtomicPtr<T> {
 
     /// Gets atomic access to a pointer.
     ///
+    /// **Note:** This function is only available on targets where `AtomicPtr<T>` has the same alignment as `*const T`
+    ///
     /// # Examples
     ///
     /// ```
@@ -1625,6 +1627,8 @@ impl<T> AtomicPtr<T> {
 
     /// Gets atomic access to a slice of pointers.
     ///
+    /// **Note:** This function is only available on targets where `AtomicPtr<T>` has the same alignment as `*const T`
+    ///
     /// # Examples
     ///
     /// ```ignore-wasm
@@ -2804,6 +2808,14 @@ macro_rules! atomic_int {
 
             #[doc = concat!("Get atomic access to a `&mut [", stringify!($int_type), "]` slice.")]
             ///
+            #[doc = if_8_bit! {
+                $int_type,
+                no = [
+                    "**Note:** This function is only available on targets where `",
+                    stringify!($atomic_type), "` has the same alignment as `", stringify!($int_type), "`."
+                ],
+            }]
+            ///
             /// # Examples
             ///
             /// ```ignore-wasm