//@aux-build:proc_macros.rs #![allow(clippy::let_unit_value)] extern crate proc_macros; use proc_macros::external; /// This is not sufficiently documented pub unsafe fn destroy_the_planet() { unimplemented!(); } /// This one is /// /// # Safety /// /// This function shouldn't be called unless the horsemen are ready pub unsafe fn apocalypse(universe: &mut ()) { unimplemented!(); } /// This is a private function, so docs aren't necessary unsafe fn you_dont_see_me() { unimplemented!(); } mod private_mod { pub unsafe fn only_crate_wide_accessible() { unimplemented!(); } pub unsafe fn republished() { unimplemented!(); } } pub use private_mod::republished; pub trait SafeTraitUnsafeMethods { unsafe fn woefully_underdocumented(self); /// # Safety unsafe fn at_least_somewhat_documented(self); } pub unsafe trait UnsafeTrait { fn method(); } /// # Safety pub unsafe trait DocumentedUnsafeTrait { fn method2(); } pub struct Struct; impl SafeTraitUnsafeMethods for Struct { unsafe fn woefully_underdocumented(self) { // all is well } unsafe fn at_least_somewhat_documented(self) { // all is still well } } unsafe impl UnsafeTrait for Struct { fn method() {} } unsafe impl DocumentedUnsafeTrait for Struct { fn method2() {} } impl Struct { pub unsafe fn more_undocumented_unsafe() -> Self { unimplemented!(); } /// # Safety pub unsafe fn somewhat_documented(&self) { unimplemented!(); } unsafe fn private(&self) { unimplemented!(); } } macro_rules! very_unsafe { () => { pub unsafe fn whee() { unimplemented!() } /// # Safety /// /// Please keep the seat belt fastened pub unsafe fn drive() { whee() } }; } very_unsafe!(); // we don't lint code from external macros external! { pub unsafe fn oy_vey() { unimplemented!(); } } fn main() { unsafe { you_dont_see_me(); destroy_the_planet(); let mut universe = (); apocalypse(&mut universe); private_mod::only_crate_wide_accessible(); drive(); } } // do not lint if any parent has `#[doc(hidden)]` attribute // see #7347 #[doc(hidden)] pub mod __macro { pub struct T; impl T { pub unsafe fn f() {} } } /// # Implementation safety pub unsafe trait DocumentedUnsafeTraitWithImplementationHeader { fn method(); }