Adjust unnamed pipe examples

Author: kotauskas

examples/unnamed_pipe/sync/side_a.rs

@@ -32,6 +32,6 @@ pub(crate) fn emain(handle_sender: mpsc::SyncSender<Handle>) -> io::Result<()> {
 	assert_eq!(buf.trim(), "Hello from side B!");
 	//{
 	Ok(())
-} //}
+}
 #[allow(dead_code)]
-fn main() {}
+fn main() {} //}

examples/unnamed_pipe/sync/side_b.rs

@@ -19,6 +19,6 @@ pub(crate) fn emain(handle: Handle) -> io::Result<()> {
 	tx.write_all(b"Hello from side B!\n")?;
 	//{
 	Ok(())
-} //}
+}
 #[allow(dead_code)]
-fn main() {}
+fn main() {} //}

examples/unnamed_pipe/tokio/side_a.rs

@@ -33,6 +33,6 @@ pub(crate) async fn emain(handle_sender: oneshot::Sender<Handle>) -> io::Result<
 	assert_eq!(buf.trim(), "Hello from side B!");
 	//{
 	Ok(())
-} //}
+}
 #[allow(dead_code)]
-fn main() {}
+fn main() {} //}

examples/unnamed_pipe/tokio/side_b.rs

@@ -20,6 +20,6 @@ pub(crate) async fn emain(handle: Handle) -> io::Result<()> {
 	tx.write_all(b"Hello from side B!\n").await?;
 	//{
 	Ok(())
-} //}
+}
 #[allow(dead_code)]
-fn main() {}
+fn main() {} //}

src/unnamed_pipe/tokio.rs

@@ -1,6 +1,9 @@
 //! Tokio-based asynchronous unnamed pipes.
 //!
 //! See the [parent-level documentation](super) for more.
+//!
+//! # Examples
+//! See [`pipe()`].
 
 impmod! {unnamed_pipe::tokio,
 	Recver as RecverImpl,
@@ -14,6 +17,17 @@ use std::io;
 ///
 /// The platform-specific builders in the `os` module of the crate might be more helpful if extra
 /// configuration for the pipe is needed.
+///
+/// # Examples
+/// ## Basic communication
+/// In a parent process, within a Tokio runtime:
+/// ```no_run
+#[doc = doctest_file::include_doctest!("examples/unnamed_pipe/sync/side_a.rs")]
+/// ```
+/// In a child process, within a Tokio runtime:
+/// ```no_run
+#[doc = doctest_file::include_doctest!("examples/unnamed_pipe/sync/side_b.rs")]
+/// ```
 #[inline]
 pub fn pipe() -> io::Result<(Sender, Recver)> {
 	pipe_impl()