@@ -923,8 +923,8 @@ pub trait Read {
923
923
/// that do not send EOF. In these cases, `read_to_end` will block indefinitely. Standard input
924
924
/// is one such stream which may be finite if piped, but is typically continuous. For example,
925
925
/// `cat <file> | <my_rust_program>` will correctly terminate with an `EOF` upon closure of cat.
926
- /// `yes "Data" | pv | <my_rust_program` or `tail -f <file> | <my_rust_program>` may not close
927
- /// the stream or insert an `EOF` termination character .
926
+ /// Reading user input or running programs that remain open indefinitely will never terminate
927
+ /// the stream with `EOF` (e.g. `yes "Data" | pv | <my_rust_program`) .
928
928
///
929
929
/// Using `.lines()` with a [`BufReader`] or using [`read`] can provide a better solution
930
930
///
@@ -975,10 +975,10 @@ pub trait Read {
975
975
///
976
976
/// `read_to_string` attempts to read a source until EOF, but many sources are continuous streams
977
977
/// that do not send EOF. In these cases, `read_to_string` will block indefinitely. Standard input
978
- /// is one such stream which may be finite if piped, but is typically continuous. For example,
978
+ /// is one such stream which may be finite if piped, but is typically continuous. FFor example,
979
979
/// `cat <file> | <my_rust_program>` will correctly terminate with an `EOF` upon closure of cat.
980
- /// `yes "Data" | pv | <my_rust_program` or `tail -f <file> | <my_rust_program>` may not close
981
- /// the stream or insert an `EOF` termination character .
980
+ /// Reading user input or running programs that remain open indefinitely will never terminate
981
+ /// the stream with `EOF` (e.g. `yes "Data" | pv | <my_rust_program`) .
982
982
///
983
983
/// Using `.lines()` with a [`BufReader`] or using [`read`] can provide a better solution
984
984
///
@@ -1291,8 +1291,8 @@ pub trait Read {
1291
1291
/// that do not send EOF. In these cases, `read_to_string` will block indefinitely. Standard input
1292
1292
/// is one such stream which may be finite if piped, but is typically continuous. For example,
1293
1293
/// `cat <file> | <my_rust_program>` will correctly terminate with an `EOF` upon closure of cat.
1294
- /// `yes "Data" | pv | <my_rust_program` or `tail -f <file> | <my_rust_program>` may not close
1295
- /// the stream or insert an `EOF` termination character .
1294
+ /// Reading user input or running programs that remain open indefinitely will never terminate
1295
+ /// the stream with `EOF` (e.g. `yes "Data" | pv | <my_rust_program`) .
1296
1296
///
1297
1297
/// Using `.lines()` with a [`BufReader`] or using [`read`] can provide a better solution
1298
1298
#[ stable( feature = "io_read_to_string" , since = "1.65.0" ) ]
0 commit comments