summaryrefslogtreecommitdiffstats
path: root/tokio/src/net/tcp/stream.rs
diff options
context:
space:
mode:
Diffstat (limited to 'tokio/src/net/tcp/stream.rs')
-rw-r--r--tokio/src/net/tcp/stream.rs10
1 files changed, 7 insertions, 3 deletions
diff --git a/tokio/src/net/tcp/stream.rs b/tokio/src/net/tcp/stream.rs
index 99f77d41..f35f8b0c 100644
--- a/tokio/src/net/tcp/stream.rs
+++ b/tokio/src/net/tcp/stream.rs
@@ -192,9 +192,13 @@ impl TcpStream {
Ok(TcpStream { io })
}
- // Connects `TcpStream` asynchronously that may be built with a net2 `TcpBuilder`.
- //
- // This should be removed in favor of some in-crate TcpSocket builder API.
+ /// Connects `TcpStream` asynchronously that may be built with a net2 `TcpBuilder`.
+ ///
+ /// This function is intended to be replaced with some sort of TcpSocket builder.
+ /// See https://github.com/tokio-rs/tokio/issues/2902
+ ///
+ /// Despite being hidden, this function is part of the public API of Tokio v0.3, but
+ /// will be removed in v1.0 in favor of a better design.
#[doc(hidden)]
pub async fn connect_std(stream: net::TcpStream, addr: &SocketAddr) -> io::Result<TcpStream> {
let io = mio::net::TcpStream::connect_stream(stream, addr)?;