Expand docs of multi-address behavior of some UDP/TCP APIs.

[frewsxcv]

Fixes#22569.

[rust-highfive]

r? @alexcrichton

(rust_highfive has picked a reviewer for you, use r? to override)

[kennytm]

The doc tests failed, SocketAddr needs to be imported first.

Details

[00:57:39] failures:
[00:57:39] [00:57:39] ---- net/tcp.rs - net::tcp::TcpListener::bind (line 602) stdout ----
[00:57:39] error[E0433]: failed to resolve. Use of undeclared type or module `SocketAddr`
[00:57:39] --> net/tcp.rs:7:5
[00:57:39] |
[00:57:39] 7 | SocketAddr::from(([127, 0, 0, 1], 80)),
[00:57:39] | ^^^^^^^^^^ Use of undeclared type or module `SocketAddr`
[00:57:39] [00:57:39] error[E0433]: failed to resolve. Use of undeclared type or module `SocketAddr`
[00:57:39] --> net/tcp.rs:8:5
[00:57:39] |
[00:57:39] 8 | SocketAddr::from(([127, 0, 0, 1], 443)),
[00:57:39] | ^^^^^^^^^^ Use of undeclared type or module `SocketAddr`
[00:57:39] [00:57:39] thread 'rustc' panicked at 'couldn't compile the test', /checkout/src/librustdoc/test.rs:280:12
[00:57:39] note: Run with `RUST_BACKTRACE=1` for a backtrace.
[00:57:39] [00:57:39] ---- net/tcp.rs - net::tcp::TcpStream::connect (line 140) stdout ----
[00:57:39] error[E0433]: failed to resolve. Use of undeclared type or module `SocketAddr`
[00:57:39] --> net/tcp.rs:7:5
[00:57:39] |
[00:57:39] 7 | SocketAddr::from(([127, 0, 0, 1], 8080)),
[00:57:39] | ^^^^^^^^^^ Use of undeclared type or module `SocketAddr`
[00:57:39] [00:57:39] error[E0433]: failed to resolve. Use of undeclared type or module `SocketAddr`
[00:57:39] --> net/tcp.rs:8:5
[00:57:39] |
[00:57:39] 8 | SocketAddr::from(([127, 0, 0, 1], 8081)),
[00:57:39] | ^^^^^^^^^^ Use of undeclared type or module `SocketAddr`
[00:57:39] [00:57:39] thread 'rustc' panicked at 'couldn't compile the test', /checkout/src/librustdoc/test.rs:280:12
[00:57:39] [00:57:39] [00:57:39] failures:
[00:57:39] net/tcp.rs - net::tcp::TcpListener::bind (line 602)
[00:57:39] net/tcp.rs - net::tcp::TcpStream::connect (line 140)

[kennytm]

ditto.

[frewsxcv]

Imports fixed in the latest force push.

[alexcrichton]

@bors: r+

[bors]

📌 Commit c548e51 has been approved by alexcrichton

[frewsxcv]

@bors rollup

[frewsxcv]

fixed another import issue

@bors r=alexcrichton

diff --git a/src/libstd/net/tcp.rs b/src/libstd/net/tcp.rs
index 2fb5d2b0ac..5467eff202 100644
--- a/src/libstd/net/tcp.rs+++ b/src/libstd/net/tcp.rs@@ -599,7 +599,7 @@ impl TcpListener {
/// TCP listener bound to `127.0.0.1:443`:
///
/// ```no_run
- /// use std::net::{SocketAddr, TcpStream};+ /// use std::net::{SocketAddr, TcpListener};
///
/// let addrs = [
/// SocketAddr::from(([127, 0, 0, 1], 80)),

[bors]

📌 Commit 0a716fd has been approved by alexcrichton

[bors]

☔ The latest upstream changes (presumably #44233) made this pull request unmergeable. Please resolve the merge conflicts.