diff --git a/src/libstd/net/mod.rs b/src/libstd/net/mod.rs
index 6bbbabfc2690a..545302b83931f 100644
--- a/src/libstd/net/mod.rs
+++ b/src/libstd/net/mod.rs
@@ -135,6 +135,22 @@ pub fn lookup_host(host: &str) -> io::Result<LookupHost> {
 /// 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")]
 #[rustc_deprecated(reason = "ipaddr type is being deprecated",