From f38e4e6d97bf1691858d007afd36b1f356de4774 Mon Sep 17 00:00:00 2001 From: Steve Klabnik Date: Mon, 24 Nov 2014 20:06:06 -0500 Subject: /** -> /// This is considered good convention. --- src/liblibc/lib.rs | 26 ++++++++++++-------------- 1 file changed, 12 insertions(+), 14 deletions(-) (limited to 'src/liblibc') diff --git a/src/liblibc/lib.rs b/src/liblibc/lib.rs index 10610b70584..55f483682b7 100644 --- a/src/liblibc/lib.rs +++ b/src/liblibc/lib.rs @@ -329,20 +329,18 @@ pub mod types { // Standard types that are opaque or common, so are not per-target. pub mod common { pub mod c95 { - /** - Type used to construct void pointers for use with C. - - This type is only useful as a pointer target. Do not use it as a - return type for FFI functions which have the `void` return type in - C. Use the unit type `()` or omit the return type instead. - - For LLVM to recognize the void pointer type and by extension - functions like malloc(), we need to have it represented as i8* in - LLVM bitcode. The enum used here ensures this and prevents misuse - of the "raw" type by only having private variants.. We need two - variants, because the compiler complains about the repr attribute - otherwise. - */ + /// Type used to construct void pointers for use with C. + /// + /// This type is only useful as a pointer target. Do not use it as a + /// return type for FFI functions which have the `void` return type in + /// C. Use the unit type `()` or omit the return type instead. + /// + /// For LLVM to recognize the void pointer type and by extension + /// functions like malloc(), we need to have it represented as i8* in + /// LLVM bitcode. The enum used here ensures this and prevents misuse + /// of the "raw" type by only having private variants.. We need two + /// variants, because the compiler complains about the repr attribute + /// otherwise. #[repr(u8)] pub enum c_void { __variant1, -- cgit 1.4.1-3-g733a5