Apply suggestions from code review

Co-authored-by: Marijn Schouten <hkBst@users.noreply.github.com>

Author: gonzalobg

library/core/src/ptr/mod.rs

@@ -2166,10 +2166,9 @@ pub unsafe fn write_volatile<T>(dst: *mut T, src: T) {
     }
 }
 
-/// Calculate an offset to pointer `p` that aligns it up to alignment `a`.
+/// Calculate an element-offset that increases a pointer's alignment.
 ///
-/// Calculate offset (in terms of elements of `size_of::<T>()` stride) that has to be added
-/// to pointer `p` so that pointer `p` would get aligned up to `a`.
+/// Calculate an element-offset (not byte-offset) that when added to a given pointer `p`, increases `p`'s alignment to at least the given alignment `a`.
 ///
 /// # Safety
 /// `a` must be a power of two.