/// This function may perform a DNS query to resolve `addr` and may also inspect
/// system configuration to resolve the specified address. If the address
/// cannot be resolved, it is returned in string format.
+///
+/// # Examples
+///
+/// ```no_run
+/// #![feature(lookup_addr)]
+/// #![feature(ip_addr)]
+///
+/// use std::net::{self, Ipv4Addr, IpAddr};
+///
+/// let ip_addr = "8.8.8.8";
+/// let addr: Ipv4Addr = ip_addr.parse().unwrap();
+/// let hostname = net::lookup_addr(&IpAddr::V4(addr)).unwrap();
+///
+/// println!("{} --> {}", ip_addr, hostname);
+/// // Output: 8.8.8.8 --> google-public-dns-a.google.com
+/// ```
#[unstable(feature = "lookup_addr", reason = "recent addition",
issue = "27705")]
pub fn lookup_addr(addr: &IpAddr) -> io::Result<String> {