refactoring: doc updates and stable v unstable additions

Author: ricci009

library/core/src/ffi/mod.rs

@@ -49,13 +49,17 @@ macro_rules! type_alias {
     }
 }
 
-// Primitives contains listed types.
-// Contained in seperate file for simple parsing.
 mod primitives;
-#[stable(feature = "core_ffi", since = "1.30.0")]
+#[unstable(feature = "c_ptrdiff_t", issue = "88345")]
+pub use self::primitives::c_ptrdiff_t;
+#[unstable(feature = "c_size_t", issue = "88345")]
+pub use self::primitives::c_size_t;
+#[unstable(feature = "c_ssize_t", issue = "88345")]
+pub use self::primitives::c_ssize_t;
+#[stable(feature = "core_ffi_c", since = "1.64.0")]
 pub use self::primitives::{
-    c_char, c_double, c_float, c_int, c_long, c_longlong, c_ptrdiff_t, c_schar, c_short, c_size_t,
-    c_ssize_t, c_uchar, c_uint, c_ulong, c_ulonglong, c_ushort,
+    c_char, c_double, c_float, c_int, c_long, c_longlong, c_schar, c_short, c_uchar, c_uint,
+    c_ulong, c_ulonglong, c_ushort,
 };
 
 // N.B., for LLVM to recognize the void pointer type and by extension

library/core/src/ffi/primitives.rs

@@ -1,8 +1,4 @@
-//! This module provides primitive types which will
-//! match those defined by C, so that code that interacts with C will
-//! refer to the correct types.
-//!
-//! primitives.rs only contains type definitions for consistent external parsing
+//! Provides C-compatible primitive types to ensure correct type matching when interfacing with C code.
 
 type_alias! { "c_char.md", c_char = c_char_definition::c_char; #[doc(cfg(all()))] }
 

src/tools/tidy/src/pal.rs

@@ -50,7 +50,6 @@ const EXCEPTION_PATHS: &[&str] = &[
     "library/core/src/ffi/va_list.rs",
     // We placed a linkage against Windows libraries here
     "library/core/src/ffi/mod.rs",
-    // Linkage against Windows libraries here
     "library/core/src/ffi/primitives.rs",
     "library/std/src/sys", // Platform-specific code for std lives here.
     "library/std/src/os",  // Platform-specific public interfaces