address review feedback

Author: dicej

src/net/udp.rs

@@ -31,15 +31,13 @@ use crate::{event, sys, Interest, Registry, Token};
 ///
 /// # Examples
 ///
-// Temporarily disabled on WASI pending https://github.com/WebAssembly/wasi-libc/pull/740:
-#[cfg_attr(all(feature = "os-poll", not(target_os = "wasi")), doc = "```")]
-#[cfg_attr(
-    not(all(feature = "os-poll", not(target_os = "wasi"))),
-    doc = "```ignore"
-)]
+#[cfg_attr(feature = "os-poll", doc = "```")]
+#[cfg_attr(not(feature = "os-poll"), doc = "```ignore")]
 /// # use std::error::Error;
 /// #
 /// # fn main() -> Result<(), Box<dyn Error>> {
+/// # // Temporarily disabled on WASI pending https://github.com/WebAssembly/wasi-libc/pull/740:
+/// # if cfg!(target_os = "wasi") { return Ok(()) }
 /// // An Echo program:
 /// // SENDER -> sends a message.
 /// // ECHOER -> listens and prints the message received.
@@ -343,15 +341,13 @@ impl UdpSocket {
     ///
     /// # Examples
     ///
-    // WASI does not yet support broacast
-    #[cfg_attr(all(feature = "os-poll", not(target_os = "wasi")), doc = "```")]
-    #[cfg_attr(
-        not(all(feature = "os-poll", not(target_os = "wasi"))),
-        doc = "```ignore"
-    )]
+    #[cfg_attr(feature = "os-poll", doc = "```")]
+    #[cfg_attr(not(feature = "os-poll"), doc = "```ignore")]
     /// # use std::error::Error;
     /// #
     /// # fn main() -> Result<(), Box<dyn Error>> {
+    /// # // WASI does not yet support broacast
+    /// # if cfg!(target_os = "wasi") { return Ok(()) }
     /// use mio::net::UdpSocket;
     ///
     /// let broadcast_socket = UdpSocket::bind("127.0.0.1:0".parse()?)?;
@@ -377,15 +373,13 @@ impl UdpSocket {
     ///
     /// # Examples
     ///
-    // WASI does not yet support broacast
-    #[cfg_attr(all(feature = "os-poll", not(target_os = "wasi")), doc = "```")]
-    #[cfg_attr(
-        not(all(feature = "os-poll", not(target_os = "wasi"))),
-        doc = "```ignore"
-    )]
+    #[cfg_attr(feature = "os-poll", doc = "```")]
+    #[cfg_attr(not(feature = "os-poll"), doc = "```ignore")]
     /// # use std::error::Error;
     /// #
     /// # fn main() -> Result<(), Box<dyn Error>> {
+    /// # // WASI does not yet support broacast
+    /// # if cfg!(target_os = "wasi") { return Ok(()) }
     /// use mio::net::UdpSocket;
     ///
     /// let broadcast_socket = UdpSocket::bind("127.0.0.1:0".parse()?)?;

src/poll.rs

@@ -383,16 +383,12 @@ impl Poll {
     ///
     /// A basic example -- establishing a `TcpStream` connection.
     ///
-    #[cfg_attr(
-        all(feature = "os-poll", feature = "net", not(target_os = "wasi")),
-        doc = "```"
-    )]
-    #[cfg_attr(
-        not(all(feature = "os-poll", feature = "net", not(target_os = "wasi"))),
-        doc = "```ignore"
-    )]
+    #[cfg_attr(all(feature = "os-poll", feature = "net"), doc = "```")]
+    #[cfg_attr(not(all(feature = "os-poll", feature = "net")), doc = "```ignore")]
     /// # use std::error::Error;
     /// # fn main() -> Result<(), Box<dyn Error>> {
+    /// # // WASI does not yet support multithreading:
+    /// # if cfg!(target_os = "wasi") { return Ok(()) }
     /// use mio::{Events, Poll, Interest, Token};
     /// use mio::net::TcpStream;
     ///

src/sys/unix/sourcefd.rs

@@ -72,16 +72,13 @@ use crate::{event, Interest, Registry, Token};
 ///
 /// Implementing [`event::Source`] for a custom type backed by a [`RawFd`].
 ///
-#[cfg_attr(
-    all(feature = "os-poll", feature = "os-ext", not(target_os = "wasi")),
-    doc = "```"
-)]
-#[cfg_attr(
-    not(all(feature = "os-poll", feature = "os-ext", not(target_os = "wasi"))),
-    doc = "```ignore"
-)]
+#[cfg_attr(all(feature = "os-poll", feature = "os-ext"), doc = "```")]
+#[cfg_attr(not(all(feature = "os-poll", feature = "os-ext")), doc = "```ignore")]
 /// use mio::{event, Interest, Registry, Token};
+/// #[cfg(unix)]
 /// use mio::unix::SourceFd;
+/// #[cfg(target_os = "wasi")]
+/// use mio::wasi::SourceFd;
 ///
 /// use std::os::fd::RawFd;
 /// use std::io;