Enforce undocumented_unsafe_blocks clippy warning

heimlig/Cargo.toml

@@ -43,4 +43,7 @@ hex = { version = "0.4.3", default-features = false, features = ["alloc"] }
 ed25519-dalek = { version = "2.0.0", default-features = false, features = ["zeroize", "rand_core"] }
 
 [build-dependencies]
-cbindgen = { version = "0.26.0", default-features = false }
+cbindgen = { version = "0.26.0", default-features = false }
+
+[lints.clippy]
+undocumented_unsafe_blocks = "warn"

heimlig/src/integration/raw_jobs.rs

@@ -543,15 +543,15 @@ impl RequestRaw {
     /// valid `RequestRaw` instance.  
     ///
     pub unsafe fn from_raw(ptr: *const u8) -> Result<Self, ValidationError> {
-        // Unsafe: Pointer and size must be checked by integrator
+        // SAFETY: Pointer and size must be checked by integrator
         let tag: u8 = unsafe { *ptr };
 
         // Validate tag value. Invalid tag values cause UB when transmuted into an enum.
         if tag >= RequestRaw::COUNT as u8 {
             return Err(ValidationError::InvalidTagValue);
         }
 
-        // Safety: All members of RequestRaw are valid for all possible values found in memory
+        // SAFETY: All members of RequestRaw are valid for all possible values found in memory
         Ok(*ptr.cast::<RequestRaw>())
     }
 
@@ -1695,15 +1695,15 @@ impl ResponseRaw {
     /// valid `ResponseRaw` instance.  
     ///
     pub unsafe fn from_raw(ptr: *const u8) -> Result<Self, ValidationError> {
-        // Unsafe: Pointer and size must be checked by integrator
+        // SAFETY: Pointer and size must be checked by integrator
         let tag: u8 = unsafe { *ptr };
 
         // Validate tag value. Invalid tag values cause UB when transmuted into an enum.
         if tag >= ResponseRaw::COUNT as u8 {
             return Err(ValidationError::InvalidTagValue);
         }
 
-        // Safety: All members of RequestRaw are valid for all possible values found in memory
+        // SAFETY: All members of RequestRaw are valid for all possible values found in memory
         Ok(*ptr.cast::<ResponseRaw>())
     }
 }
@@ -1965,6 +1965,7 @@ fn check_pointer_and_size<'a>(
     if !validator(data, size) {
         return Err(ValidationError::InvalidPointer);
     }
+    // SAFETY: Checked by integrator-provided validator
     Ok(unsafe { slice::from_raw_parts(data, size as usize) })
 }
 
@@ -1980,6 +1981,7 @@ fn check_mut_pointer_and_size<'a>(
     if !validator(data, size) {
         return Err(ValidationError::InvalidPointer);
     }
+    // SAFETY: Checked by integrator-provided validator
     Ok(unsafe { slice::from_raw_parts_mut(data, size as usize) })
 }