docs: cleaning up my new section per Trevor's suggestions.

Author: kiseitai3

library/std/src/io/mod.rs

@@ -922,12 +922,14 @@ pub trait Read {
     /// `read_to_end` attempts to read a source until EOF, but many sources are continuous streams
     /// that do not send EOF. In these cases, `read_to_end` will block indefinitely. Standard input
     /// is one such stream which may be finite if piped, but is typically continuous. For example,
-    /// `cat <file> | <my_rust_program>` will correctly terminate with an `EOF` upon closure of cat.
+    /// `cat file | my-rust-program` will correctly terminate with an `EOF` upon closure of cat.
     /// Reading user input or running programs that remain open indefinitely will never terminate
-    /// the stream with `EOF` (e.g. `yes "Data" | pv | <my_rust_program`).
+    /// the stream with `EOF` (e.g. `yes | my-rust-program`).
     ///
     /// Using `.lines()` with a [`BufReader`] or using [`read`] can provide a better solution
     ///
+    ///[`read`]: Read::read
+    ///
     /// [`Vec::try_reserve`]: crate::vec::Vec::try_reserve
     #[stable(feature = "rust1", since = "1.0.0")]
     fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize> {
@@ -975,13 +977,15 @@ pub trait Read {
     ///
     /// `read_to_string` attempts to read a source until EOF, but many sources are continuous streams
     /// that do not send EOF. In these cases, `read_to_string` will block indefinitely. Standard input
-    /// is one such stream which may be finite if piped, but is typically continuous. FFor example,
-    /// `cat <file> | <my_rust_program>` will correctly terminate with an `EOF` upon closure of cat.
+    /// is one such stream which may be finite if piped, but is typically continuous. For example,
+    /// `cat file | my-rust-program` will correctly terminate with an `EOF` upon closure of cat.
     /// Reading user input or running programs that remain open indefinitely will never terminate
-    /// the stream with `EOF` (e.g. `yes "Data" | pv | <my_rust_program`).
+    /// the stream with `EOF` (e.g. `yes | my-rust-program`).
     ///
     /// Using `.lines()` with a [`BufReader`] or using [`read`] can provide a better solution
     ///
+    ///[`read`]: Read::read
+    ///
     /// [`std::fs::read_to_string`]: crate::fs::read_to_string
     #[stable(feature = "rust1", since = "1.0.0")]
     fn read_to_string(&mut self, buf: &mut String) -> Result<usize> {
@@ -1290,11 +1294,14 @@ pub trait Read {
 /// `read_to_string` attempts to read a source until EOF, but many sources are continuous streams
 /// that do not send EOF. In these cases, `read_to_string` will block indefinitely. Standard input
 /// is one such stream which may be finite if piped, but is typically continuous. For example,
-/// `cat <file> | <my_rust_program>` will correctly terminate with an `EOF` upon closure of cat.
+/// `cat file | my-rust-program` will correctly terminate with an `EOF` upon closure of cat.
 /// Reading user input or running programs that remain open indefinitely will never terminate
-/// the stream with `EOF` (e.g. `yes "Data" | pv | <my_rust_program`).
+/// the stream with `EOF` (e.g. `yes | my-rust-program`).
 ///
 /// Using `.lines()` with a [`BufReader`] or using [`read`] can provide a better solution
+///
+///[`read`]: Read::read
+///
 #[stable(feature = "io_read_to_string", since = "1.65.0")]
 pub fn read_to_string<R: Read>(mut reader: R) -> Result<String> {
     let mut buf = String::new();