fix style in code examples

Signed-off-by: Andreea Florescu <[email protected]>

Author: andreeaflorescu

src/fam.rs

@@ -109,7 +109,6 @@ pub enum Error {
 ///
 /// type MockFamStructWrapper = FamStructWrapper<MockFamStruct>;
 /// ```
-///
 #[allow(clippy::len_without_is_empty)]
 pub unsafe trait FamStruct {
     /// The type of the FAM entries

src/linux/aio.rs

@@ -116,17 +116,14 @@ impl IoContext {
     /// let file = File::open("/dev/zero").unwrap();
     /// let ctx = IoContext::new(128).unwrap();
     /// let mut buf: [u8; 4096] = unsafe { std::mem::uninitialized() };
-    /// let iocbs = [
-    ///     &mut IoControlBlock {
-    ///        aio_fildes: file.as_raw_fd() as u32,
-    ///        aio_lio_opcode: IOCB_CMD_PREAD as u16,
-    ///        aio_buf: buf.as_mut_ptr() as u64,
-    ///        aio_nbytes: buf.len() as u64,
-    ///        ..Default::default()
-    ///    },
-    /// ];
+    /// let iocbs = [&mut IoControlBlock {
+    ///     aio_fildes: file.as_raw_fd() as u32,
+    ///     aio_lio_opcode: IOCB_CMD_PREAD as u16,
+    ///     aio_buf: buf.as_mut_ptr() as u64,
+    ///     aio_nbytes: buf.len() as u64,
+    ///     ..Default::default()
+    /// }];
     /// assert_eq!(ctx.submit(&iocbs[..]).unwrap(), 1);
-    ///
     /// ```
     pub fn submit(&self, iocbs: &[&mut IoControlBlock]) -> Result<usize> {
         let rc = unsafe {

src/linux/ioctl.rs

@@ -223,7 +223,7 @@ type IoctlRequest = c_ulong;
 ///
 /// ```
 /// # extern crate libc;
-/// #[macro_use] extern crate vmm_sys_util;
+/// # #[macro_use] extern crate vmm_sys_util;
 /// #
 /// # use libc::{open, O_CLOEXEC, O_RDWR};
 /// # use std::fs::File;
@@ -265,7 +265,7 @@ pub unsafe fn ioctl<F: AsRawFd>(fd: &F, req: c_ulong) -> c_int {
 ///
 /// ```
 /// # extern crate libc;
-/// #[macro_use] extern crate vmm_sys_util;
+/// # #[macro_use] extern crate vmm_sys_util;
 /// # use libc::{open, O_CLOEXEC, O_RDWR};
 /// # use std::fs::File;
 /// # use std::os::raw::{c_char, c_uint, c_ulong};

src/linux/poll.rs

@@ -438,7 +438,8 @@ impl<T: PollToken> EpollContext<T> {
     ///
     /// let evt = EventFd::new(0).unwrap();
     /// let ctx: EpollContext<u32> = EpollContext::new().unwrap();
-    /// ctx.add_fd_with_events(&evt, WatchingEvents::empty().set_read(), 1).unwrap();
+    /// ctx.add_fd_with_events(&evt, WatchingEvents::empty().set_read(), 1)
+    ///     .unwrap();
     /// ```
     pub fn add_fd_with_events(
         &self,
@@ -486,8 +487,10 @@ impl<T: PollToken> EpollContext<T> {
     ///
     /// let evt = EventFd::new(0).unwrap();
     /// let ctx: EpollContext<u32> = EpollContext::new().unwrap();
-    /// ctx.add_fd_with_events(&evt, WatchingEvents::empty().set_read(), 1).unwrap();
-    /// ctx.modify(&evt, WatchingEvents::empty().set_write(), 2).unwrap();
+    /// ctx.add_fd_with_events(&evt, WatchingEvents::empty().set_read(), 1)
+    ///     .unwrap();
+    /// ctx.modify(&evt, WatchingEvents::empty().set_write(), 2)
+    ///     .unwrap();
     /// ```
     pub fn modify(&self, fd: &dyn AsRawFd, events: WatchingEvents, token: T) -> Result<()> {
         let mut evt = epoll_event {
@@ -600,16 +603,20 @@ impl<T: PollToken> EpollContext<T> {
     /// ```
     /// extern crate vmm_sys_util;
     /// # use std::time::Duration;
-    /// use vmm_sys_util::poll::{EpollContext, EpollEvents};
     /// use vmm_sys_util::eventfd::EventFd;
+    /// use vmm_sys_util::poll::{EpollContext, EpollEvents};
     ///
     /// let evt = EventFd::new(0).unwrap();
     /// let ctx: EpollContext<u32> = EpollContext::new().unwrap();
     /// let events = EpollEvents::new();
     ///
     /// evt.write(1).unwrap();
     /// ctx.add(&evt, 1).unwrap();
-    /// for event in ctx.wait_timeout(&events, Duration::new(100, 0)).unwrap().iter_readable() {
+    /// for event in ctx
+    ///     .wait_timeout(&events, Duration::new(100, 0))
+    ///     .unwrap()
+    ///     .iter_readable()
+    /// {
     ///     assert_eq!(event.token(), 1);
     /// }
     /// ```

src/linux/signal.rs

@@ -202,7 +202,9 @@ pub fn register_signal_handler(num: c_int, handler: SignalHandler) -> errno::Res
 ///
 /// let sigset = create_sigset(&[1]).unwrap();
 ///
-/// unsafe { assert_eq!(sigismember(&sigset, 1), 1); }
+/// unsafe {
+///     assert_eq!(sigismember(&sigset, 1), 1);
+/// }
 /// ```
 pub fn create_sigset(signals: &[c_int]) -> errno::Result<sigset_t> {
     // sigset will actually be initialized by sigemptyset below.
@@ -356,7 +358,9 @@ pub fn unblock_signal(num: c_int) -> SignalResult<()> {
 ///         assert_eq!(sigismember(&chkset, 1), 1);
 ///     }
 /// });
-/// unsafe { pthread_kill(killable.pthread_handle(), 1); }
+/// unsafe {
+///     pthread_kill(killable.pthread_handle(), 1);
+/// }
 /// clear_signal(1).unwrap();
 /// ```
 pub fn clear_signal(num: c_int) -> SignalResult<()> {

src/linux/sock_ctrl_msg.rs

@@ -296,7 +296,7 @@ unsafe fn raw_recvmsg(
 /// ```
 /// # extern crate libc;
 /// extern crate vmm_sys_util;
-/// use vmm_sys_util::sock_ctrl_msg::{ScmSocket};
+/// use vmm_sys_util::sock_ctrl_msg::ScmSocket;
 /// # use vmm_sys_util::eventfd::{EventFd, EFD_NONBLOCK};
 /// # use std::fs::File;
 /// # use std::io::Write;

src/unix/tempdir.rs

@@ -109,7 +109,6 @@ impl TempDir {
     /// # use vmm_sys_util::tempdir::TempDir;
     /// let temp_dir = TempDir::new_with_prefix("/tmp/testdir").unwrap();
     /// temp_dir.remove().unwrap();
-    ///
     pub fn remove(&self) -> Result<()> {
         fs::remove_dir_all(&self.path).map_err(Error::from)
     }
@@ -124,7 +123,6 @@ impl TempDir {
     /// # use vmm_sys_util::tempdir::TempDir;
     /// let temp_dir = TempDir::new_with_prefix("/tmp/testdir").unwrap();
     /// assert!(temp_dir.as_path().exists());
-    ///
     pub fn as_path(&self) -> &Path {
         self.path.as_ref()
     }